This section contains a list of all settings available for the Radar & Polar chart.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| data_type | xml/csv | xml | The format of the data. This tells the software how to interpret the data it finds. |
| type | line/stacked/100% stacked | line | The type of graph that will be shown. Line means that graphs will be drawn independently of each other. Stacked means that graphs will be shown on top of each other: one graph's data point will be used as the 0 value for the next graph. 100% stacked means that all the values for one axis will be recalculated to percent, with their sum as 100%. (The order of graphs from center to outside is determined by each graph's GID.) See the examples that are included with the download package to see how this works. |
| csv_separator | one character | ; | The character that will separate columns in a CSV file. |
| skip_rows | number | 0 | If you are using a CSV file, this setting allows you to skip the first several rows of the file (for example, if it contains metadata). |
| font | font name | Arial | The font of the text that will be displayed in the chart. Make sure to use common device font names. |
| text_size | number | 11 | The size of the text that will be displayed in the chart. |
| text_color | hex color code | #000000 | The color of the text that will be displayed in the chart. You can find more about these codes here. |
| decimals_separator | one character | , | The character that will separate the whole digits from the decimal digits in a number. |
| thousands_separator | one character | Empty space | The character that will separate each three whole digits in a number (counting right-to-left from the decimal). |
| scientific_min | number | 0.000001 | If absolute value of your number is equal or less then scientific_min, this number will be formatted using scientific notation, for example: 0.0000023 → 2.3e-6 |
| scientific_max | number | 1000000000000000 | If absolute value of your number is equal or bigger then scientific_max, this number will be formatted using scientific notation, for example: 15000000000000000 → 1.5e16 |
| digits_after_decimal | number | 0 | If a value has less digits after the decimal separator than this number, zeroes will be added to the end. For example, if this is set to 2 and you have a value of 15.6, then the viewer will see it as 15.60. This is useful for charts showing prices, etc. |
| reload_data_interval | number, in seconds | 0 | How often the chart will reload the data. This is useful if your data is updated very often, and you want to show the change in data without reloading the page. |
| preloader_on_reload | true/false | false | If this is set to true, progress bar will be shown while data is being reloaded. |
| redraw | true/false | false | If your chart’s width and height is set in percent, and this is set to true, the chart will be resized proportionally when the browser window is resized. |
| add_time_stamp | true/false | false | If this is set to true, a timestamp will be added to the data file name every time data is loaded. This is useful if you are using dynamic data and the reload_data_interval setting. It is also useful if your data file changes frequently and you want the data to be reloaded every time the viewer reloads the page – otherwise the data might be cached in their browser. |
| precision | Number | 2 | How many decimal places will be shown for values that are calculated by the software (percent values). This does not affect the contents of the data file. |
| colors | hex color codes | #FF6600, #FCD202, #B0DE09, #0D8ECF, #2A0CD0, #CD0D74, #CC0000, #00CC00, #0000CC, #DDDDDD, #999999,#333333,#990000 | These colors will be used if the graph's color is not set. |
This section contains settings that control the look of the radar field. The radar field is the plot area for this type of chart.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| x | number, in pixels, percent, or reversed | 50% | The horizontal position of the radar field's center (and 0 for all axes). The coordinate is counted from the left. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted from the right to left (such as !20). |
| y | number, in pixels, percent, or reversed | 50% | The vertical position of the radar field's center (and 0 for all axes). The coordinate is counted from the top. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted upwards from the bottom (such as !20). |
| radius | number, in pixels or percent | 30% | The radius of the radar field (distance from the center to the edge). You can set the value in percent (such as 20%). |
| grow_time | number, in seconds | 0 | The length of the growth animation when the chart is first loaded. Leave at 0 to have the chart load with the radar field already shown. |
| grow_effect | elastic / regular /strong | elastic | The effect of the growth animation when the chart is first loaded. Elastic – the graphs will stretch and retract when they hit the final position. Regular – the graphs will move slowly. Strong – the graphs will move quickly. |
| sequenced_grow | true/false | false | If this is set to true, the growth animation will have the graphs grow one after another. If this is set to false, all the graphs will grow at the same time. |
This section contains settings that control the look of the axes.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| width | number | 0 | The width of the axis lines. 0 means hairline. If you want an invisible axis, set alpha to 0. |
| color | hex color code | #000000 | The color of the axis lines. |
| alpha | number, in percent | 25 | The opacity of the axis lines. |
| tick_length | number | 5 | The length of the tick extending from the axis at a grid or data point. |
This section contains settings that control the axis names (labels).
| Setting | Available values | Default value | Description |
|---|---|---|---|
| enabled | true/false | True | If this is set to true, the name of each axis will be displayed at its end. |
| text_color | hex color code | Same as general settings | The color of the axis name text. |
| text_size | number | Same as general settings | The size of the axis name text. |
| distance | number, in pixels | 10 | The distance from the end of the axis to its name. |
| width | number, in pixels | 150 | The maximum width of the axis name. If the text does not fit, it will be wrapped. |
This section contains settings that control the chart's grid.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| type | lines/circles | lines | |
| color | hex color code | #000000 | The color of the grid lines. |
| alpha | number, in percent | 10 | The opacity of the grid lines. |
| approx_count | number | 8 | The approximate number of grid lines. |
| fill_color | hex color code | #FFFFFF | Every other area between grid lines will be filled with this color. This allows you to have alternating grid belts. If you don't want to have them, set fill_alpha to 0. |
| fill_alpha | number, in percent | 0 | The opacity of the alternating grid belts. |
| dashed | true/false | false | If this is set to true, the grid lines will not be continuous. They will look like a line of dashes (– – – –). |
| dash_length | number, in pixels | 5 | The length of each dash. |
This section contains settings that control the way that values are displayed on the chart.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| enabled | True/false | true | If this is set to true, values are displayed next to data points. |
| position | Left/right | left | Whether the value will be shown to the left or to the right of the axis. |
| min | number | none – calculated automatically | The minimum value of the axis. The axis will always start from this value, even if there is no data point mapped that far. |
| max | number | none – calculated automatically | The maximum value of the axis. The axis will always end at this value, even if there is no data point mapped that far. |
| strict_min_max | true/false | false | If this is set to true, the axis will stay between Min and Max values even if there are data points beyond those values. The parts of the chart that do not fit will be cropped. If this is set to false, the Min and Max values will be extended to fit the chart. |
| frequency | Number | 1 | The ratio of shown values to grid lines. 1 means a value will be shown at every grid line; 2 means a value will be shown at every second grid line, etc. The higher the number, the fewer values will be shown. |
| skip_first | True/false | true | If this is set to true, the first value will be skipped. |
| skip_last | True/false | false | If this is set to true, the last value will be skipped. |
| color | hex color code | Same as <text_color> in general settings | The color of the text. |
| text_size | number | Same as <text_size> in general settings | The size of the text. |
| integers_only | True/false | false | If this is set to true, only whole values will be shown. Values with decimals will be hidden. |
| unit | text | none | A short text indicating the units of the values. This can be something like “USD” or “km/h”. |
| unit_position | left/right | right | Whether the units will be shown to the left of the value or to the right. |
This section lists the settings that control the chart's background.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| color | hex color code | #FFFFFF | The color of the chart background. You can use multiple color codes, separated with commas - this will produce a gradient. |
| alpha | number (0-100) | 0 | Background opacity. This applies to the background color. Set this to 0 if you are using a custom SWF (Flash object) or JPG image as a background. Set it to a higher number if you are using a background color. If this is set to 0, the background color defined in the HTML code snippet is used. |
| border_color | hex color code | #000000 | The color of the chart’s outer border. |
| border_alpha | number (0-100) | 0 | The opacity of the chart’s outer border. |
| file | filename | none | The name of the SWF or JPG file that will be used as the background image. The file must be placed in the "path" folder. |
This section lists the settings that control the balloon. The balloon is a piece of text that appears when the viewer rolls the mouse cursor over a data point.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| enabled | true/false | true | If this is set to true, the balloons are available. |
| color | hex color code | Slightly darker than the graph color | The color of the balloon background. |
| alpha | number (0-100) | 100 | The opacity of the balloon background. |
| text_color | hex color code | #FFFFFF | The color of the balloon text. |
| text_size | number | Same as <text_size> in general settings | The size of the balloon text. |
| show | text | none | The format of the text in the balloon. Tags in curly brackets {} will be replaced with the information taken from the data file. The following tags are available: {title}, {value}, {description}, {percents}, {axis}. Please note: if you want to use HTML tags, you must use the format <![CDATA[text]]> |
| max_width | number | 220 | The maximum width of a balloon. If there is too much text to fit in this width, the text will be wrapped. |
| corner_radius | number | 0 | The corner radius of a balloon. If it is bigger than 0, the balloon pointer will not be shown. |
| border_width | number | 0 | Balloon border width. 0 means hairline. |
| border_alpha | number | Same as <balloon><alpha> | Balloon border opacity. |
| border_color | hex color code | Same as <balloon><color> | Balloon border color. |
This section lists the settings that control the chart's legend.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| enabled | true/false | true | If this is set to true, the legend is shown on the chart. |
| x | number, in pixels, percent, or reversed | 5% | The horizontal position of the legend’s left edge. The coordinate is counted from the left. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted from the right to left (such as !20). |
| y | number, in pixels, percent, or reversed | right below the radar field | The vertical position of the legend’s top edge. The coordinate is counted from the top. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted upwards from the bottom (such as !20). If you want the legend to auto-fit the flash object, do not set this setting. |
| width | number, in pixels or percent | 90% | The width of the legend. If the legend doesn't fit, try adjusting the margins. You can set the value in percent (such as 20%). |
| color | hex color code | #FFFFFF | The color of the legend’s background. You can use multiple color codes, separated with commas - this will produce a gradient. |
| max_columns | number | none | The maximum number of columns in the legend. (All data will be represented, but in several rows if necessary.) |
| alpha | number (0-100) | 0 | The opacity of the legend’s background. |
| border_color | hex color code | #000000 | The color of the legend’s borders. |
| border_alpha | number (0-100) | 0 | The opacity of the legend’s borders. |
| text_color | hex color code | Same as <text_color> in general settings | The color of the legend’s text. |
| text_size | number | Same as <text_size> in general settings | The size of the legend’s text. |
| spacing | number, in pixels | 10 | The space between the rows and columns of the legend. |
| margins | number, in pixels | 0 | The space between the borders and the contents of the legend. This is useful if the borders are visible, or the legend’s background color is different from the chart’s background color. |
| reverse_order | true/false | false | If this is set to true, the legend entries will be in a reversed order. |
| align | left/center/right | left | The alignment of the legend entries. |
These are the settings for the legend's key.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| size | number | 16 | The size of the key. The key is displayed in the legend next to the graph title, and is filled with the graph color. |
| border_color | hex color code | None – no border | The color of the key border. |
This section lists the settings that control the function of saving the chart as an image file.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| file | filename | None – disabled | If you provide a filename, the viewer will be able to save the chart as an image. The option will be available in the right-click menu. |
| target | _blank, _top… | none – file opens in the same window | The target parameter for opening the image file in the browser. Use "_blank" to open the URL in a new browser window. |
| x | number, in pixels, percent, or reversed | left-aligned | The horizontal position of the "Collecting data" text. This text will appear while the chart is being exported. The coordinate is counted from the left. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted from the right (such as !20). |
| y | number, in pixels, percent, or reversed | bottom-aligned | The vertical position of the "Collecting data" text. This text will appear while the chart is being exported. The coordinate is counted from the top. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted upwards from the bottom (such as !20). |
| color | hex color code | #BBBB00 | The color of the "Collecting data" text background. |
| alpha | number (0-100) | 0 | The opacity of the "Collecting data" text background. |
| text_color | hex color code | same as <text_color> in general settings | The color of the "Collecting data" text. |
| text_size | number | same as <text_size> in general settings | The size of the "Collecting data" text. |
This section lists the settings that control error messages in the chart.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| enabled | true/false | true | If this is set to true, the error messages will be displayed. |
| x | number, in pixels, percent, or reversed | centered | The horizontal position of the error message. The coordinate is counted from the left. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted from the right (such as !20). |
| y | number, in pixels, percent, or reversed | centered | The vertical position of the error message. The coordinate is counted from the top. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted upwards from the bottom (such as !20). |
| color | hex color code | #BBBB00 | The color of the error message background. You can use multiple color codes, separated with commas - this will produce a gradient. |
| alpha | number (0-100) | 100 | The opacity of the error message background. |
| text_color | hex color code | #FFFFFF | The color of the error message text. |
| text_size | number | Same as <text_size> in general settings | The size of the error message text. |
This section contains settings that determine the texts of various messages displayed by the chart.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| no_data | text | No data for selected period | The text that will be displayed if the data is missing from the data file. |
| export_as_image | text | Export as image | The text of the image export option in the right-click menu. |
| collecting_data | text | Collecting data | The text that will be displayed while the chart is being exported to an image file. |
This section contains settings for the context menu that will appear when the viewer right-clicks on your chart. See adding custom commands to right click menu for more information.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| zoom | true/false | false | If this is set to true, the Flash player's zoom controls are included in the right-click menu. |
| true/false | true | If this is set to true, the Flash player's print controls are included in the right-click menu. |
This section lists the settings of labels - free bits of text not attached to anything. You can add multiple labels, each nested inside a <label></label> tag. Use labels for naming data points, the chart title, etc.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| x | number, in pixels, percent, or reversed | 0 | The horizontal position of the label. The coordinate is counted from the left. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted from the right (such as !20). |
| y | number, in pixels, percent, or reversed | 0 | The vertical position of the label. The coordinate is counted from the top. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted upwards from the bottom (such as !20). |
| rotate | true/false | false | If this is set to true, the label is rotated by 90 degrees. |
| width | number, in pixels or percent | Fit to contents | The maximum width of the label. (If the contents exceed the width, the label will have multiple lines.) You can set the value in percent (such as 20%). |
| align | left/center/right | left | The alignment of the text in the label. |
| text_color | hex color code | As per general settings | The color of the text in the label. |
| text_size | number | Same as <text_size> in general settings | The size of the text in the label. |
| text | text | none | The text of the label. Please note: if you want to use HTML tags, you must use the format <![CDATA[text]]>. |
This section lists settings that control the graph. You can also set these settings in the data file.
This section controls each individual graph. You will need a separate graph subsection for each graph you want to control. The GID parameter of the tag must match the same parameter in the data file (if you are using XML data): <graph gid="1">
| Setting | Available values | Default value | Description |
|---|---|---|---|
| title | plaintext | none | The title of the graph. It is shown in the legend. |
| color | hex color code | #FF0000, #0000FF, #00FF00, #FF9900, #CC00CC, #00CCCC, #33FF00, #990000, #000066 | The graph color. If there is no value for the parameter, then the software will choose the next unused color from the default array. |
| line_alpha | number (0-100) | 100 | The opacity of the graph line. |
| line_width | number, in pixels | 0 | The width of the graph line. 0 means hairline, but still visible. |
| fill_alpha | number (0-100) | 0 | The opacity of the area fill. If you want to have an area chart, not just a graph, then set this parameter to higher than 0. The area below the graph line will be filled with a color. |
| fill_color | hex color code | Same as <graph><color> | The color of the filled area. You can use multiple color codes, separated with commas - this will produce a gradient. |
| balloon_color | hex color code | Same as <graph><color> | The color of the data point balloon. |
| balloon_alpha | number (0-100) | 100 | The opacity of the data point balloon. |
| balloon_text_color | hex color code | #FFFFFF | The color of the text in the graph point balloon. |
| bullet | square / round / square_outlined / round_outlined / square_outline / round_outline / filename.swf | none (no bullets) | The shape of the bullet that marks each data point. The filename.swf is the name of a Flash file – you can use a custom Flash file as a bullet. It must be placed in the folder specified as "path" in the HTML code snippet. Outlined bullets use the radar field color for the outline. |
| bullet_size | number, in pixels | 6 | The size of the bullet. This only affects predefined bullet shapes, not custom Flash bullets. |
| bullet_color | hex color code | same as <graph><color> | The color of the bullet. This only affects predefined bullet shapes, not custom Flash bullets. |
| bullet_alpha | number (0-100) | Same as <graph><line_alpha> | The opacity of the bullet. This only affects predefined bullet shapes, not custom Flash bullets. |
| balloon_text | text | <b>{value}</b><br>{description} | The text in the balloon. Tags in curly brackets { } will be replaced with the information taken from the data file. The following tags are available: {title}, {value}, {series}, {description}, {percents}. Please note: if you want to use HTML tags, you must use the format <! [CDATA[text]]> |
| visible_in_legend | true/false | true | If this is set to true, the graph will be represented in the legend. |
This section contains settings that let you create fills - belts of a single color that go all the way around a chart.
Each fill belt is controlled by settings placed inside a separate <fill></fill> tag.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| start_value | Number | none | The fill will start above this value. |
| end_value | Number | none | The fill will end below this value. |
| color | Hex color code | none | The color of the fill. |
| fill | Number, in percent | 100 | The opacity of the fill. |
| © Antanas Marcelionis Contact and feedback: info@amcharts.com | Subscribe to amCharts news |