Skip to main content
Version: 7.9

Report Component - XY Chart

Component Palette Icon:

Description


The XY Chart, while similar to the Timeseries Chart, uses a numerical value for the Domain Axis instead of a Datetime. The XY chart is ideal when trying to detail the relationship between two keys.

Properties

Chart Options

Property/SymbolDescription
Data KeyUnique identifier or placeholder to the data source that will populate the chart.
Domain KeyThe data key that should represent the X axis on the chart. The Timeseries Chart expects a timestamp, while the XY chart can use any numeric value as the domain key.
PensPens represent a series of data. There are several properties for each pen exposed on the Chart Options tab:
Range Key: The key the pen should retrieve data from.
Pen Name: The name of the pen that should appear on the chart.
Preview: Visual representation of how the pen will be rendered. The trend is simply a preview, and does not take the data from the range key into account.
Add Pen Adds a pen.
Edit Pen Opens Pen Configuration area for editing.
Remove Pen Deletes a pen.
AxesThere are several properties for each axis exposed on the Chart Options tab:
Name: The name of the axis.
Label: Text next to the axis. Commonly used to describe what the values of each pen represent.
Auto?: Determines if the axis should automatically adjust the upper and lower bound of the axis to include all data from each pen. When enabled, the High and Low properties are ignored. When disabled, High and Low will be used.
Low: The low range value the axis will use when 'Auto?' is disabled.
High: The high range value the axis will use when 'Auto?' is disabled.
Add Axis Add an axis.
Edit Axis Opens Axis Configuration area for editing.
Remove Axis Deletes an axis.
Edit ScriptAllows the chart to be modified via Python scripting before the report is rendered.

Properties Tab

PropertyDescriptionCategory
Data KeyData key of the dataset that drives this chart.Chart Options
Axis Label FontFont to use for axis labels.Chart Options
Axis Tick FontFont to use for axis tick marks.Chart Options
Bar WidthThe width of any bar datapoints.Chart Options
Domain KeyKey name of the column inside the dataset that contains the domain (x) value.Chart Options
Gap ThresholdMultiplier for the average space between data points to be considered a data gap for the "line with gaps" render style.Chart Options
No Data MsgMessage to show when no data is available.Chart Options
Plot BackgroundColor to use for chart background.Chart Options
Show LegendIf true, show a legend for the chart.Chart Options
Auto RangeIf true, automatically determine range of X-axis.X-Axis
Axis HighIf autorange is turned off, the high value to use for the axis.X-Axis
Axis LowIf autorange is turned off, the low value to use for the axis.X-Axis
MarginMargin for the x-axis edges.X-Axis
Number FormatA optional number format string to override the automatic formatting on the x-axis.X-Axis
Show X-AxisIf true, show the x-axis.X-Axis
X-Axis LabelLabel text for the x-axis.X-Axis
OpacityHow opaque the fill color is, between 0 and 1.Stroke and Fill
Stroke StyleWhat style of stroke or border to use: Hidden, Shape Outline, Border, or Double. To learn more about stroke styles, refer to Stroke and Fill Properties.Stroke and Fill
StrokeDetails for the chosen stroke. Each Stroke has its own properties depending on the Stroke Style chosen.Stroke and Fill
RollNumber of degrees this shape is rotated clockwise.Basic Properties
Scale XAmount to scale the width of this shape. 1 is scale to 100%.Basic Properties
Scale YAmount to scale the height of this shape. 1 is scale to 100%.Basic Properties
VisibleIf true, the shape will be visible.Basic Properties
WidthWidth of this shape in pixels.Basic Properties
HeightHeight of this shape in pixels.Basic Properties
XHorizontal distance in pixels between the left edge of this shape and the left edge of the page.Basic Properties
YVertical distance in pixels between the upper edge of this shape and the top edge of the page.Basic Properties

Example

XY Chart Sample CSV Data - uncanny_valley
Familiarity, Human_Similarity
0, 0
22, 24
28, 33
42, 43
65, 60
0, 72
-20, 80
50, 90
90, 95