CSV Array
Updated: 24 Oct 2025
Generate an Array using a CSV file as a source.
CSV Array
Method #
This reads an array of transforms from a table resource. The array is used to create instances of any nodes attached to the subtree of this 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.
The transform properties for each instance can be:
- Set by the data read from a column in the CSV (in Table mode). You can define which column this is by index.
- Stepped per instance. So each instance’s value will be incremented by a specified number.
- Be kept at a constant value. All instances will be the same value.
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.
Where the data for each property is read from in the CSV file is defined in the node, so the CSV file does not need column names or to be arranged in any pre defined way. "Table mode" will create an instance per row. "Flat Mode" will create an instance per value in the CSV file.
A simple CSV file layout could be:
1,1,1
2,2,2
3,3,3You can then define which column sets which transform property in the node’s properties.
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 X
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Position X
Select the location of the data for position X in the CSV file.
Channel Offset - Position X
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Position X
Scale values for position X.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Position Y
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Position Y
Select the location of the data for position Y in the CSV file.
Channel Offset - Position Y
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Position Y
Scale values for position Y.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Position Z
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Position Z
Select the location of the data for position Z in the CSV file.
Channel Offset - Position Z
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Position Z
Scale values for position Z.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Rotation Heading
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Rotation Heading
Select the location of the data for the Rotation Heading in the CSV file.
Channel Offset - Rotation Heading
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Rotation Heading
Scale values for Rotation Heading.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Rotation Heading
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Rotation Heading
Select the location of the data for the Rotation Heading in the CSV file.
Channel Offset - Rotation Heading
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Rotation Heading
Scale values for Rotation Heading.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Rotation Pitch
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Rotation Pitch
Select the location of the data for the Rotation Pitch in the CSV file.
Channel Offset - Rotation Pitch
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Rotation Pitch
Scale values for Rotation Pitch.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Rotation Bank
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Rotation Bank
Select the location of the data for the Rotation Bank in the CSV file.
Channel Offset - Rotation Bank
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Rotation Bank
Scale values for Rotation Bank.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Scale X
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Scale X
Select the location of the data for the Scale X in the CSV file.
Channel Offset - Scale X
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Scale X
Scale values for Scale X.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Scale Y
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Scale Y
Select the location of the data for the Scale Y in the CSV file.
Channel Offset - Scale Y
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Scale Y
Scale values for Scale Y.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Scale Z
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Scale Z
Select the location of the data for the Scale Z in the CSV file.
Channel Offset - Scale Z
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Scale Z
Scale values for Scale Z.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Colour R
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Colour R
Select the location of the data for the Colour R in the CSV file.
Channel Offset - Colour R
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Colour R
Scale values for Colour R.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Colour G
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Colour G
Select the location of the data for the Colour G in the CSV file.
Channel Offset - Colour G
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Colour G
Scale values for Colour G.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Colour B
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Colour B
Select the location of the data for the Colour B in the CSV file.
Channel Offset - Colour B
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Colour B
Scale values for Colour B.
- CSV Data : Scales the table value by this amount
- Constant : No effect
- Stepped : Step increases the value for every instance by this value
Channel Source - Colour A
Set how the data from the CSV file is applied to the array for this property.
- CSV Data : For each instance, set this property to the value read from the CSV file at the index defined by “CSV Index”. This is the only option that reads data from the CSV file
- Constant : For each instance, set this property to a single constant value defined by “Channel Offset”.
- Stepped : For each instance, set this property by incrementally adding the value of “Channel Scale” to each instance.
CSV Index - Colour A
Select the location of the data for the Colour A in the CSV file.
Channel Offset - Colour A
Offsets by the given amount (regardless of CSV Data, Constant, Stepped)
Channel Scale - Colour A
Scale values for Colour A.
- 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 X |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Position X | Select the location of the data for position X in the CSV file. |
| Channel Offset - Position X | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Position X |
Scale values for position X.
|
| Channel Source - Position Y |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Position Y | Select the location of the data for position Y in the CSV file. |
| Channel Offset - Position Y | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Position Y |
Scale values for position Y.
|
| Channel Source - Position Z |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Position Z | Select the location of the data for position Z in the CSV file. |
| Channel Offset - Position Z | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Position Z |
Scale values for position Z.
|
| Channel Source - Rotation Heading |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Rotation Heading | Select the location of the data for the Rotation Heading in the CSV file. |
| Channel Offset - Rotation Heading | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Rotation Heading |
Scale values for Rotation Heading.
|
| Channel Source - Rotation Heading |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Rotation Heading | Select the location of the data for the Rotation Heading in the CSV file. |
| Channel Offset - Rotation Heading | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Rotation Heading |
Scale values for Rotation Heading.
|
| Channel Source - Rotation Pitch |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Rotation Pitch | Select the location of the data for the Rotation Pitch in the CSV file. |
| Channel Offset - Rotation Pitch | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Rotation Pitch |
Scale values for Rotation Pitch.
|
| Channel Source - Rotation Bank |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Rotation Bank | Select the location of the data for the Rotation Bank in the CSV file. |
| Channel Offset - Rotation Bank | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Rotation Bank |
Scale values for Rotation Bank.
|
| Channel Source - Scale X |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Scale X | Select the location of the data for the Scale X in the CSV file. |
| Channel Offset - Scale X | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Scale X |
Scale values for Scale X.
|
| Channel Source - Scale Y |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Scale Y | Select the location of the data for the Scale Y in the CSV file. |
| Channel Offset - Scale Y | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Scale Y |
Scale values for Scale Y.
|
| Channel Source - Scale Z |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Scale Z | Select the location of the data for the Scale Z in the CSV file. |
| Channel Offset - Scale Z | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Scale Z |
Scale values for Scale Z.
|
| Channel Source - Colour R |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Colour R | Select the location of the data for the Colour R in the CSV file. |
| Channel Offset - Colour R | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Colour R |
Scale values for Colour R.
|
| Channel Source - Colour G |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Colour G | Select the location of the data for the Colour G in the CSV file. |
| Channel Offset - Colour G | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Colour G |
Scale values for Colour G.
|
| Channel Source - Colour B |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Colour B | Select the location of the data for the Colour B in the CSV file. |
| Channel Offset - Colour B | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Colour B |
Scale values for Colour B.
|
| Channel Source - Colour A |
Set how the data from the CSV file is applied to the array for this property.
|
| CSV Index - Colour A | Select the location of the data for the Colour A in the CSV file. |
| Channel Offset - Colour A | Offsets by the given amount (regardless of CSV Data, Constant, Stepped) |
| Channel Scale - Colour A |
Scale values for Colour A.
|
| 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 |
