Corda Builder™ lets you customize a graph's scale formatting as desired. However, to accommodate live data, you typically designate scale formatting preferences that allows Corda Server™ to dynamically format a graph's scales to best support the data. This helps keep scales and scale labels meaningful and visually appealing.
For more information about scales, see Scales and Grids in the Corda Builder User Guide.
Important: When you adjust the formatting of a value scale in PCScript, use the graph.setScale() method. The first parameter of this method is always the name of the scale that you want to adjust dynamically. These names are pre-set, and are as follows: value (main value scale); svalue (secondary value scale); x (x-scale); y (y-scale); y2 (secondary y-scale); and time (time scale).
Automatic scaling is a convenient feature that is turned on by default in most Image Template files. When a scale range is set to automatic, Corda Server looks for the highest and lowest data item and makes sure that the scale is at least n percent higher and n percent lower than those data items (the value of n is set in the Image Template file. The default value is 10.) By default, most graphs set the scale base is zero, unless there is a negative data item.
Corda Server attempts to adjust the starting and ending points, and scale labels, so that they are round numbers such as multiples of ten or twenty or one hundred. The exact numbers it chooses depends on the overall range of the dynamic data.
Tell Corda Server to automatically define scale ranges using either ITXML or PCScript.
To change these settings in ITXML, override a graph's ValueScale property. More information about this property is available in the Corda® 7 Object Reference in Corda Builder.
To change these settings in PCScript, use the graph.setScale() method, which provides Corda Server options for modifying the graph scales, including: maximum and minimum scale range values; and a limit to how many tick marks should be shown.
Corda Server sets the scale so that it is no smaller than the range provided with the maximum and minimum values. It attempts to distribute ranges so that the scale labels are round numbers. It ignores the maximum or minimum value if the size of the scale would be larger without the specified maximum or minimum value. Corda Server also makes sure there are no more tick marks than the number specified, although there may be less.
When manually setting scale ranges, Corda Server does not make accommodations for data variation. The values specified for maximum, minimum, and number of ticks are exactly what Corda Server uses.
Specify manual scale range characteristics using either ITXML or PCScript.
To change these settings in ITXML, modify a graph's ValueScale property. More information about this property is available in the Corda 7 Object Reference in Corda Builder.
To set range properties with PCScript, use the graph.setScale() method.
Logarithmic scales allow you to better graph large ranges of data values. For more information, see Logarithmic Scales in the Corda Builder User Guide.
Enable logarithmic scales dynamically using ITXML.
To change these settings in ITXML, modify a graph's use-log-scale property. More information about this property is available in the Corda 7 Object Reference in Corda Builder.