complexType RangeThemeProperties

diagram
namespace	http://www.mapinfo.com/midev/service/theme/v1
children	tns:CustomLowerBound tns:CustomUpperBound tns:NumericNull
used by	elements  RangeTheme/RangeThemeProperties LabelRangeTheme/RangeThemeProperties
attributes	Name   Type   Use   Default   Fixed   Annotation rangeType   tns:RangeThemeType   required         documentation Defines the algorithm that will be used to calculate the ranges.  For example, "EqualCount". expression   xsd:string   required         documentation The column in the layer used to create the thematic groupings of your data. quantileExpression   xsd:string   optional         documentation Defines the second quantile column in the layer used to calculate the biquantile theme.  Note that this expression is only relevant when rangeType is set to "biQuantile" (and is required in this case). numRanges   xsd:int   required         documentation The number of ranges to create. roundBy   xsd:double   optional         documentation Rounds the calculated ranges up or down to the the nearest clean break. For example, if you were shading a map with values that ranged from 101 to 397, the range bounds would be cleaner if the range was from 100 to 400. This can be achieved by rounding to the nearest 100. The default roundBy value is 0 which means that no rounding should occur. If you would like to round to the nearest 100 (i.e., 100, 200, 300, etc.) then specify 100. spreadBy   tns:SpreadBy      Color      documentation Determines which properties of the StartStyle and EndStyle will be changed or "spread", when calculating the intermediate styles. The default behavior is to spread only colors. spreadBySizeMethod   tns:SpreadBySizeMethod      SquareRoot      documentation When spreading point or line styles by size (ie. spreadBy="size"), this determines which graduation method is used to calculate the new sizes. noEmptyRanges   xsd:boolean   optional   false      documentation Determines whether empty ranges are allowed. Empty ranges are ranges in your theme (e.g., 100 to 200) that do not have any features. If empty ranges are not allowed (set to true), the ranges that contain no records are removed at computation time. By default, emplty ranges are allowed (false). applyStylePart   tns:ApplyStylePart   optional   All      documentation Determines how much of the style to use in the theme.
annotation	documentation Modifies the style in proportion to a column value in the table broken up into discrete values called bins. Range themes are more formally known as choropleths.

attribute RangeThemeProperties/@rangeType

type	tns:RangeThemeType
properties	use  required
facets	Kind  Value  Annotation enumeration  EqualCount documentation Has the same number of records in each Interval. For example, a table has 100 records and the user wants 4 Intervals. There will be approximately 25 records in each Interval, depending on the rounding factor. When the Styles are not specified, an internal style generator will be used to create up to 36 unique color fill styles. enumeration  EqualRange documentation It divides records across ranges of equal size. For example, you have a field in your table with data values ranging from 1 to 100. You want to create a thematic map with four equal size ranges. The EqualRangesBuilder produces ranges 1-25.75, 25.75-50.5, 50.5-75.25, and 75.25-100. And if roundBy is set to 1 the EqualRangesBuilder produces ranges 1-26, 26-51, 51-76, and 76-100. When the Styles are not specified, an internal style generator will be used to create up to 36 unique color fill styles. enumeration  NaturalBreak documentation Divides records according to an algorithm that uses the average of each range to distribute the data more evenly across the ranges. It distributes the values so that the average of each range is as close as possible to each of the range values in that range. This ensures that the ranges are well represented by their averages, and that data values within each of the ranges are fairly close together. When the Styles are not specified, an internal style generator will be used to create up to 36 unique color fill styles. enumeration  StandardDeviation documentation Creates ranges such that the middle range breaks at the mean of the values, and the ranges above and below the middle range are one standard deviation above or below the mean. When the Styles are not specified, an internal style generator will be used to create up to 36 unique color fill styles. enumeration  BiQuantile documentation Divides records containing a and b across ranges so that each range of a's contains approximately the same number of b's. For example, you may want to do a ranged theme based on buying power, where you quantile on state population. The states would be arranged in buying power order, and buying power ranges would be decided so that each range contains approximately the same total population. When the Styles are not specified, an internal style generator will be used to create up to 36 unique color fill styles.
annotation	documentation Defines the algorithm that will be used to calculate the ranges.  For example, "EqualCount".

attribute RangeThemeProperties/@expression

type	xsd:string
properties	use  required
annotation	documentation The column in the layer used to create the thematic groupings of your data.

attribute RangeThemeProperties/@quantileExpression

type	xsd:string
properties	use  optional
annotation	documentation Defines the second quantile column in the layer used to calculate the biquantile theme.  Note that this expression is only relevant when rangeType is set to "biQuantile" (and is required in this case).

attribute RangeThemeProperties/@numRanges

type	xsd:int
properties	use  required
annotation	documentation The number of ranges to create.

attribute RangeThemeProperties/@roundBy

type	xsd:double
properties	use  optional
annotation	documentation Rounds the calculated ranges up or down to the the nearest clean break. For example, if you were shading a map with values that ranged from 101 to 397, the range bounds would be cleaner if the range was from 100 to 400. This can be achieved by rounding to the nearest 100. The default roundBy value is 0 which means that no rounding should occur. If you would like to round to the nearest 100 (i.e., 100, 200, 300, etc.) then specify 100.

attribute RangeThemeProperties/@spreadBy

type	tns:SpreadBy
properties	default  Color
facets	Kind  Value  Annotation enumeration  Color documentation Spread only the color values. enumeration  Size documentation Spread only the point sizes or line widths. enumeration  None documentation Do not spread either color or size values.
annotation	documentation Determines which properties of the StartStyle and EndStyle will be changed or "spread", when calculating the intermediate styles. The default behavior is to spread only colors.

attribute RangeThemeProperties/@spreadBySizeMethod

type	tns:SpreadBySizeMethod
properties	default  SquareRoot
facets	Kind  Value  Annotation enumeration  SquareRoot documentation With this method, a symbol that is 40 pixels high at value 100 will be about 12 pixels high at value 10. enumeration  Logarithm documentation With this method, a symbol that is 40 pixels high at value 100 will be 20 pixels high at value 10. enumeration  Constant documentation With this method, a symbol that is 40 pixels high at value 100 will be 4 pixels high at value 10.
annotation	documentation When spreading point or line styles by size (ie. spreadBy="size"), this determines which graduation method is used to calculate the new sizes.

attribute RangeThemeProperties/@noEmptyRanges

type	xsd:boolean
properties	use  optional default  false
annotation	documentation Determines whether empty ranges are allowed. Empty ranges are ranges in your theme (e.g., 100 to 200) that do not have any features. If empty ranges are not allowed (set to true), the ranges that contain no records are removed at computation time. By default, emplty ranges are allowed (false).

attribute RangeThemeProperties/@applyStylePart

type	tns:ApplyStylePart
properties	use  optional default  All
facets	Kind  Value  Annotation enumeration  Color documentation Only use components that affect the color. enumeration  Size documentation Only use components that affect the size. enumeration  All documentation Use everything.
annotation	documentation Determines how much of the style to use in the theme.

element RangeThemeProperties/CustomLowerBound

diagram
namespace	http://www.mapinfo.com/midev/service/theme/v1
type	fc:AttributeValue
properties	minOcc  0 maxOcc  1 content  complex
annotation	documentation The lower boundary in your data to start the bin calculation for the theme. Any features that fall below this lower bound will not be included in the theme.

element RangeThemeProperties/CustomUpperBound

diagram
namespace	http://www.mapinfo.com/midev/service/theme/v1
type	fc:AttributeValue
properties	minOcc  0 maxOcc  1 content  complex
annotation	documentation The upper boundary in your data to end the bin calculation for the theme. Any features that fall above this upper bound will not be included in the theme.

element RangeThemeProperties/NumericNull

diagram
namespace	http://www.mapinfo.com/midev/service/theme/v1
type	fc:AttributeValue
properties	minOcc  0 maxOcc  1 content  complex
annotation	documentation Specify a numeric value that should be considered null by the theme. This is useful for data sources that do not allow null numeric values.

© 2007, 2020 Precisely. All rights reserved.

support.precisely.com