Panel: Map Data

The Map Data panel imports the csv data from the Panel: CSV File. It will create several collections with chart objects.

The Map Data Panel with no data mapped.

Panel Components

Dropdown: Select Field

The Map Data Panel selecting a field.

Select a field from the loaded CSV File. This is used by the Map Data button to create an object for each record in the CSV File. Use a unique field for this such as the Name field.

Tip

To sort your data when mapping, choose the field you want it sorted by.

For example, choosing the index field will sort the rows as it is in the csv file.

Choosing the Name field will sort the data alphabetically.

Choosing the Main Value will sort the data by value, placing the smallest value first.

Button: Map Data

The Map Data Panel selected field.

The Map Data button creates several collections with chart objects. It also creates the necessary node groups and materials.

Button: Update Data

The Map Data Panel with data mapped.

Update values from a second csv file. See Preparing multiple CSV files for animation.

Button: Clear All

This will clear all created collections, objects, and imported node groups.

Created objects in outliner

Outliner showing created collections.

The Map Data function will create several collections listed below:

1. CSV Master

   The main collection containing all objects relating to CSV Charts.

2. CSV_ValueObjects

   

   Contains objects that get instanced by CSV_Instances.

   Default state: Hidden

3. CSV_Instances

   

   Contains an object for each row in the csv file. The objects are named as per the Selected Field Dropdown when Mapping Data.

   Default state: Hidden

4. CSV_ChartObjects

   

   Contains the chart shape instanced by Area_Object. The objects are named as per the Selected Field Dropdown when Mapping Data.

   Default state: Hidden

5. CSV_Chart_Area

   

   Contains the Area_Object. This is the main chart object, all objects in other collections get instanced here.

   Default state: Visible

Usage

Mapping and clearing data to the scene

The below example shows how to map data and how to clear it.

Important

Do not clear the csv data unless you want to permanently remove all created CSV objects from your scene. If you want to update data, use the Update Data function.

Mapping and clearing data.