Map Series Data

Converts between X and Y coordinates that are relative to a DGLux5 space and X and Y coordinates that are relative to a chart series.

In the context of this block:

• "Point coordinates" are relative to a DGLux5 space, such as a component. The X point coordinate is the number of pixels from the left edge of the space, and the Y point coordinate is a number of pixels from the top edge.
• "Data coordinates" are relative to a chart series. They are locations on the series' X and Y axes.

In order for this block to work, the parent of this block must be the series whose data is part of the conversion.

For information on using dataflow blocks, see Dataflow.

These properties can take input and give output.

• invoke (trigger)
• enabled (boolean)
• type (enum)
• space (enum)
• mode (enum)
• x (number or string)
• y (number or string)

invoke causes the values to be converted. Only works if enabled is set to TRUE. The values are also converted when x, y, type or space changes.

enabled specifies whether the values will be converted. The default is TRUE.

• TRUE: The values are converted when invoke is triggered.
• FALSE: The values are not converted.

type specifies the direction of the conversion that this block performs. The default is PointToData.

• PointToData: The input values are point coordinates. The output values are data coordinates.
• DataToPoint: The input values are data coordinates. The output values are point coordinates.

space specifies the coordinate space of the point coordinates: Page, Document, Chart (default) or Series.

mode specifies how a point is mapped to data in a PointToData conversion. It is not used for DataToPoint.

• Raw (default): The raw value at the point, in the data coordinate space.
• Min Distance: The data point at the minimum distance from the point.
• Closest: The closest value from the series data, taking the main axis into consideration.
• Datatip: The data point found by the datatip algorithm.

x and y are the coordinates before conversion. If this is a PointToData conversion, they are point coordinates. If this is a DataToPoint conversion, they are data coordinates.

These properties can give output. They cannot take input.

• outX (number or string)
• outY (number or string)

outX and outY are the coordinates after conversion. If this is a PointToData conversion, they are data coordinates. If this is a DataToPoint conversion, they are point coordinates. If the conversion fails (for example, the parent is not a chart series, or an input is missing), both outputs are null. In a DataToPoint conversion, the outputs are updated automatically when the chart is redrawn.

These are some basic uses of the block.

Dataflow Model	Description
	The top and left edges of the text components will always appear at the same chart coordinates, even if the group is resized. In this example: The text components are grouped together with the chart. DataToPoint is selected for type. Chart is selected for space. Raw is selected for mode. The output point coordinates are bound to each shape's position properties.
	When the user clicks the chart, the data coordinates for the nearest data point in the series are displayed. In this example: The onClick Advanced property for the chart component is the input for the Mouse Event block. The x and y properties from the Mouse Event block are the inputs for the Map Series Data block PointToData is selected for type. Chart is selected for space. Closest is selected for mode. The outX and outY properties from the Map Series Data block are concatenated into a string that is bound to the Text property of a text component.