Geometry Nodetree: CSV_Data

The CSV_Data Geometry node tree creates a connection to the CSV data, it creates an object instance for each row of data.

Note

When Mapping Data, the addon creates an object for each of the rows in the csv file. Each created object (CSV_Instances Collection) has the CSV_Data node tree assigned.

../_images/csv_nodes_csv_data.jpg

The CSV_Data Geometry Node.

Components

Inputs

../_images/csv_nodes_csv_data_01.jpg

These are controlled by the Chart Setup Panel in the Addon.

Value_Range

../_images/csv_nodes_csv_data_02.jpg

When Assigning a Main Value in the Chart Setup Panel the min, max and sum is calculated. This happens automatically. Do not adjust these, rather use Value_Range_Scale below for adjustments.

Value_Range_Scale

../_images/csv_nodes_csv_data_03.jpg

Scale csv values to a more managable size.

Checkbox: Value_Scale_Bypass

Bypass scaled range values and use real values instead. 1 unit = 1 blender unit. Only recommended to use this for smaller values.

Checkbox: Value_Scale_Min/Max

Scale down or up the chart values without affecting the Value Label.

Value_Obj_Main

../_images/csv_nodes_csv_data_04.jpg

Checkbox: Bypass_Object

Bypass the Value Object showing only the labels.

Object: Value_Object

Select an object to instance as a Value Object. Custom Objects supported.

Tip

Make sure to hide your custom object in the Outliner otherwise it will show twice as this instances the original object.

Alternatively drag your object in the Outliner into the CSV_Chart_Area Collection.

Checkbox: Stack_Value_Object

Stack the value object.

Tip

Use the Value_Range_Scale parameters to adjust stack amounts.

Vector: Stack_Offset

Set the direction and distance of stacked objects.

Rotation: Stack_Random_Rotation

Rotate instances randomly around an axis for a more realistic stack.

Integer: Stack_Random_Seed

Set the random seed for the Stack_Random_Rotation parameter.

Value_Obj_Coordinates

../_images/csv_nodes_csv_data_05.jpg

Checkbox: CSV_Coordinates

Use Coordinates from the CSV file. Do not use manually, rather use the CSV Coords button in Chart Setup on the addon panel.

Checkbox: Multi XYZ Transforms

These can be used to lock the Main Value to one or all of the below XYZ Transform parameters.

Tip

The figure above illustrates a classic bar chart. Where the value is locked to the Z Scale of the Value Object.

Value_Obj_Transform

../_images/csv_nodes_csv_data_06.jpg

These are Transform override parameters. They are not affected by the Value_Obj_Coordinates. Changing one value will affect all Value Objects equally.

Value and Name Label

../_images/csv_nodes_csv_data_07.jpg

The Value and Name Label has been grouped together in this documentation as the parameter descriptions remain the same for both. The value label has some extra parameters that will be highlighted in the list below.

  • The Value Label displays the assigned Main Value field for each Value Object.

    The Value Label supports integer and float values.

  • The Name Label displays the assigned Name Label field for each Value Object.

    The Name Label supports string (text) values.

A short description of each parameter follows below:

  • Label_Bypass

    Bypass the label.

  • Label_Material

    Set the Material for the label.

  • Label_Alignment

    Paragraph alignment of label.

  • Label_Show_Bbox

    Show the bounding box around the Value Object to assist in Alignment.

  • Label_Size

    Scale the label.

  • Label_Character_Spacing

    Space between characters.

  • Label_Word_Spacing

    Space between words.

  • Label_Align_To

    Align the label to the bounding box elements.

    Available options:

    • Point

    • Edge

    • Face

    • Face Corner

    • Spline

    • Instance

  • Label_Align_Index

    Choose the index of the element chosen in Label_Align_To to align the label to.

  • Label_Align_Bypass

    Bypass bounding box alignment and align to the Value Objects origin instead.

  • Label_Transform

    Override Label XYZ Translate, Rotate and Scale.

  • Label_Instance_Transform_Lock

    Lock Label Transform to the Main Value Value Object.

  • Label_Extrude

    Exctrude the Label text. Make it 3D.

  • Label_Extrude_Amount

    Set the amount of extrusion.

  • Label_Extrude_Individual

    Instead of extruding the area of the object, rather extrude individual faces. Makes little difference.

  • Label_Camera_Rotate_Lock

    Lock Label rotation to always face the active camera in the scene.

    Warning

    Can make the scene sluggish as many calculations need to happen everytime the camera moves.

    Tick this option at render time.

  • Label_Camera_Scale_Lock

    Lock Label size to always be the same regardless of zoom, uses the active camera in the scene.

Value Label only

  • Label_Percentage

    Display percentage instead of the real value.

  • Label_Decimals

    Add decimal places to the value label.

  • Label_Prefix

    Use a custom prefix.

  • Label_Prefix_Break

    Create a new line between the prefix and the value.

  • Label_Prefix_String

    Type your prefix here. Add a space if you need it to have a space between the prefix and the value. For example, “$ “.

  • Label_Suffix

    Use a custom suffix.

  • Label_Suffix_Break

    Create a new line between the value and the suffix.

  • Label_Suffix_String

    Type your suffix here. Add a space before if you need it to have a space between the value and the suffix. For example, “ %”.