CSV/Table Array
Updated: 13 Dec 2024
Generate an Array using a CSV file as a source.
CSV/Table Array
Method #
This reads an array of transforms from a table resource. The array is used to instance the child subtree of the node - so the subtree / children are re-rendered for every transform in the array. The number of elements in the array will match the number of rows (Table) or items (Flat list) in the table.
See the Array Sources node to see how this node is used in the nodegraph to multi-instance child nodes.
Each transform channel (position, rotation, scale) can be:
- attached to a column of the table (in Table mode)
- step offset for each item
- be kept constant
Large CSV tables can be slow to update. Consider using the “Static Data - No Dynamic Updates” option if the CSV and channel data is static.
The output transform array may be used directly with a Array Cloner, or to clone other nodes within a Field System or Particle System.
Parameters
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
Parameter Details Position X The objects position along the local x-axis.
Position Y The objects position along the local y-axis.
Position Z The objects position along the local z-axis.
Rotation Heading The objects rotation around the local y-axis.
Rotation Pitch The objects rotation around the local x-axis.
Rotation Bank The objects rotation around the local z-axis.
Scale X The objects scale along the local x-axis.
Scale Y The objects scale along the local y-axis.
Scale Z The objects scale along the local z-axis.
Control the inheritance of the transforms from the parent.
Parameter Details Position Toggle inheritance of the Position from the parent.
Rotation Toggle inheritance of the Rotation from the parent.
Scale Toggle inheritance of the Scale from the parent.
World Position Only Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit Time Toggle inheritance of time from the parent.
These properties control the core behaviours of the node.
Parameter Details CSV File The table resource.
Table Layout
- Flat List : A row of separated values.
- Table : Row per point: The more traditional 2D table layout
- Verity Drones : Loads the positional data from a verity drone system.
CSV Entries Per Transform Used for 1D/Flat List setups, where you need to specify the number of CSV instances per transform instance
Apply Node Transforms To Array Elements Only When Enabled, transform changes applied to this nodes transform properties will also be applied to the array elements, and carried onto any nodes this data is used.
Position Conversion Conversion type:
- None : No conversion
- LatLon To Cartesian : Convert from latitude/longitude to cartesian coordinates.
Rotation Conversion Conversion type:
- None : No conversion
- Degrees To Radians : Convert from degrees to radians.
Static Data - No Dynamic Updates The array data is only processed once, not per frame.
These properties control how the csv data is used to generate the array.
Parameter Details Channel Source - Position/Rotation/Scale X/Y/Z
- Constant : Set all the values for this attribute as a single constant value.
- Stepped : Step the position by the Channel Offset for each entry.
CSV Index - Position X/Y/Z Behavior depends on Table Layout:
- Table : The column that holds the data (First column = 0)
- Flat List : The index of the item in the separated values (First item = 0)
Channel Offset - Position X/Y/Z Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Position X/Y/Z Behavior depends on Channel Source:
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Inputs
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
| Parameter | Details |
|---|---|
| Position X | The objects position along the local x-axis. |
| Position Y | The objects position along the local y-axis. |
| Position Z | The objects position along the local z-axis. |
| Rotation Heading | The objects rotation around the local y-axis. |
| Rotation Pitch | The objects rotation around the local x-axis. |
| Rotation Bank | The objects rotation around the local z-axis. |
| Scale X | The objects scale along the local x-axis. |
| Scale Y | The objects scale along the local y-axis. |
| Scale Z | The objects scale along the local z-axis. |
Control the inheritance of the transforms from the parent.
| Parameter | Details |
|---|---|
| Position | Toggle inheritance of the Position from the parent. |
| Rotation | Toggle inheritance of the Rotation from the parent. |
| Scale | Toggle inheritance of the Scale from the parent. |
| World Position Only | Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties. |
| Inherit Time | Toggle inheritance of time from the parent. |
These properties control the core behaviours of the node.
| Parameter | Details |
|---|---|
| CSV File | The table resource. |
| Table Layout |
|
| CSV Entries Per Transform | Used for 1D/Flat List setups, where you need to specify the number of CSV instances per transform instance |
| Apply Node Transforms To Array Elements Only | When Enabled, transform changes applied to this nodes transform properties will also be applied to the array elements, and carried onto any nodes this data is used. |
| Position Conversion | Conversion type:
|
| Rotation Conversion | Conversion type:
|
| Static Data - No Dynamic Updates | The array data is only processed once, not per frame. |
These properties control how the csv data is used to generate the array.
| Parameter | Details |
|---|---|
| Channel Source - Position/Rotation/Scale X/Y/Z |
|
| CSV Index - Position X/Y/Z | Behavior depends on Table Layout:
|
| Channel Offset - Position X/Y/Z | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Position X/Y/Z | Behavior depends on Channel Source:
|
| Name | Description | Typical Input |
|---|---|---|
| Transform Modifiers | Apply the transforms of another node to this node. | Null |
| Target Node | Modifiy the rotations of the node to always direct the z axis towards the input. | Null |
| Local Transform Override | Apply the transforms of another node to this node, relative to its parent. | Null |
