How do I create a custom theme?

Overview:

Custom Themes allow a user to create a theme in the legend that suits the users needs.  Making a custom theme can allow a user to see data in a different way to present to a customer, or just to see the data in a different way.

Requirements:

• Fields setup in AgStudio
• Layers with Attributes

Process:

Themes are a resource, much like many other resources that are Domain Specific, but not year-specific.  Meaning they can be setup for a certain grower, but they will persist year after year until they are removed.

1. Go to Setup > Themes, a list of themes will be displayed in the Theme Editor.
2. To create a new them click "Add"
3. You will then be asked to create a new theme name.  This must be exactly how the attribute appears in the layer to work properly.
4. Select the Type of Theme:
   • Range - Themes related to values and numbers
   • Value - Themes that relate to textual names of a group
   • Default - Themes related to the domain tree (Grower, Farm, Field, Cropzone)
5. User will then set the domain for the desired Theme.  Then click "OK"
6. In the next box, you can set the decimals (how precise) you want the theme, and whether you want it Fixed or Dynamic.  Fixed is a constant across all the maps in the grower.  Dynamic will adjust the theme for each layer.  Click Next.
7. In the next box, you will define how you want the data to be split up.  Gradient, Equal Range or Count, and Custom Breaks.  
   • Gradient will slowly grade the values from low to high with a desired color pallet. 
   • Equal Range - will take the Min and the Max and then take the average by the number of defined ranges. 
   • Equal Count - will take the number of ranges, and divides the items equally into each range.
   • Custom Breaks (Fixed) - create a legend from scratch, defining the source, style, and label.
8. Below are the options for each Range:
   • Range (Fixed) - define the Min and the Max for the range.  Anything beyond those will be included in those values.
   • Equal Ranges (Fixed) - define the number of ranges, the Minimum value, and the size of the interval
   • Custom (Fixed) - to create a legend from scratch, with Source values, style (color), and a Label (if desired).
   • Gradient (Dynamic) - choose a color pallet from low to high, will adjust from layer to layer.
   • Equal Range (Dynamic) - will take the Min and Max and average the range by the number of Ranges (min and max ranges will also be added.  Ranges are set to a percent (0 to 100).
   • Equal Count (Dynamic) - will take the number of "items" and divide them equally among the number of defined ranges.  Ranges are set to a percent (0 to 100).
9. Click Next to define the ranges.
   • Gradient (Fixed and Dynamic) - select on of the standard color pallets, or one of the two custom color schemes.
   • Equal Ranges and Counts (Fixed and Dynamic) - Range list will be defined, and you may select a color/style for each range.  You may also may name the range to be displayed.
   • Custom Breaks - It is suggested to keep overwriting the "Max" value to keep defining your breaks.  Then select your color/style and a different label if desired.
10. Click Next.
11. If you want to further style your theme, you may do that in this next menu.  This is normally left alone and click "Finish"

Value Theme:

These are used when you have Nominal or Group type attributes.  Since they aren't numbers that fall in a range, you can specify colors for each value.

1. Enter a Theme Name (attribute) and Select Value Theme and set the Domain this theme is available
2. To use a random color pallet, uncheck the fixed set box.
3. To define what color/style you want for each value, check  the fixed set box and click "Insert"
4. Then you can define what the attribute label is and the color you want for that value, and if you want to label it something different on the map, type that in the label box, to leave as-is, leave blank.
5. Click Insert and repeat process until all values are defined for this attribute and click OK.

Default Theme:

These Themes are used on the map to define the areas on the map when their domain is selected on the resource tree

There are 4 default themes, to use them you need to use the defined theme name.  DefaultGrower, DefaultFarm, DefaultField, and DefaultCropZone.

1. Insert one of those names in the Theme Name and select Default.
2. In the following box, you can define the color and style of that "domain." Click OK when finished