Viz Artist User Guide

Version 3.13 | Published March 28, 2019 ©

Data Label

images/download/attachments/50614635/viz_icons_datalabel.png
This plug-in enables graph labeling for all Financial plug-ins. All containers beneath the current container get labeled with the values from your Shared Memory variables.

Note: This plug-in is located in: Built Ins -> Container plug-ins -> VisualDataTools

This page contains the following topics and procedures:

Data Label Properties

images/download/attachments/50614635/plugins_container_datalabel_editor_r.png

  • Shared Mem.: Changes between Scene, Global and Distributed Shared Memory. Use Inactive memory to not forward any values via Shared Memory.

  • Key Data: Determines Shared Memory key name.

  • Data: Input Parameter for data.

  • Transfer Mode: Sets string- or array-based data transfer.

  • Data Delim.: Defines the value separator sign(s).

  • Label Type: Sets the label type to numeric values (default) or alphabetic labels (to show weekdays, months, etc.).

  • Data Fit: Enables data normalization.

    • Data Threshold: Adds a definable offset to the detected limit.

  • Data Scale: Scales input by the selected factor.

  • Data Offset: Adds an offset to the incoming data.

  • Data Auto Scale: Enables automatic data normalization.

  • Data Detect Limits: Detects minimum and maximum of all values and scales them to adjusted Start and Stop.

  • Data Start: Lower Auto Scale edge.

  • Data Stop: Upper Auto Scale edge.

  • Nice Numbers: Rounds to the best fitting next number.

  • Remove Multiples: Removes multiple values.

  • Sort: Sorts data items in ascending or descending order.

  • Draw Zero: Shows or hides zero values.

  • Decimals: Adjusts decimal digits of all labels.

  • Custom Decimal Symbol: Enables a custom decimal symbol to be set.

    • Decimal Symbol: Specifies the decimal symbol.

  • Prefix: Adds a label prefix.

  • Unit: Defines a custom unit for your data values.

  • PosX, Y, Z: Positions container along the adjusted distance or uses numeric data value input to translate the label containers.

  • OffsetX, Y, Z: Translates the label container on the current axis.

  • DistanceX, Y, Z: Sets whole positioning distance for the containers on the current axis.

  • Copy Container: Adds new containers if there are fewer containers than values.

  • Use Alpha: Uses input data for alpha scaling.

  • Use Scaling: Uses input data for alpha scaling.

  • Animate Values: Lets the current number run from 0 to the defined end value.

  • Relative Length: If activated, each label has its own 100% (e.g. seven labels equal 700%).

  • Const. Speed: Sets the same animation duration for each label.

  • Total Length%: Sets the accumulated value of all labels in percent.

  • Alpha max.: Limits maximum alpha value.

  • Copy Container: Limits maximum scaling value.

To Create a Scene with Data Label

images/download/attachments/50614635/plugins_container_dataimport_scenetree.png

  1. Add an empty container to the scene.

  2. Start with an empty scene and drag and drop a DataLabel and a DataStorage plug-in on a container in the scene-tree.

  3. Add a Text child container

  4. Go to the DataLabel plug-in, set Shared Mem. to Scene and KeyData to MyData.

  5. In DataStorage also set Shared Mem. to Scene, Key Data1 to “MyData” and Data1 to e.g.: 80,40,50,70,80,60,80.

  6. Go back to the DataLabel plug-in and activate Copy Container to create multiple instances of the text containers automatically. You see all labels located on the same position now. In the previous examples always the chart plug-in was responsible for the label positioning. In this example, we want to move that responsibility to the DataLabel plug-in itself.

  7. Switch PosX to Range, DistanceX to 500.0 and OffsetX to -250.0. We want to position the labels over a certain X, Y or Z range in space.

  8. Set PosY to Range, OffsetY to -75.0 and DistanceY to 150.0.

  9. You can also do a value dependent translation by setting PosX, Y, or Z to Data

    images/download/attachments/50614635/plugins_container_datalabel_scene_example.png
  10. Set Sort to Ascending to sort the labels. You see that there are labels with the same values. We want to get rid of them and activate Remove Multiples for that. You can also try the Nice Numbers option now which searches for the next logarithmic style labels. But we continue with deactivated Nice Numbers parameter now.

  11. Activate Animate Values and turn down Total Length[%] to 0.0. Create a Key Frame, set Total Length[%] back to 100.0 and create another Key Frame.

    • This creates an animation where the label values should count up to their final value.

    • Start the animation and see the labels counting and distributing over the specified XY range.