Skip to content

Commit b8f2488

Browse files
committed
Update documentation
1 parent a8433ee commit b8f2488

File tree

3 files changed

+28
-15
lines changed

3 files changed

+28
-15
lines changed

README.md

Lines changed: 28 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,12 @@ The data can then be processed with geometry nodes to be visualized.
77
## Content
88
* [Installation](#installation)
99
* [Usage](#usage)
10+
* [Example Node Setup](#example-node-setup)
11+
* * [Sample a single value](#sample-a-single-value)
12+
* * [Bar Chart](#bar-chart)
1013
* [Example Import Settings](#example-import-settings)
1114
* * [CSV](#sample-csv-import-settings)
1215
* * [JSON](#sample-import-settings-for-json)
13-
* [Example Node Setup](#example-node-setup)
14-
* * [Bar Chart](#bar-chart)
1516

1617

1718
## Installation
@@ -29,9 +30,33 @@ The data can then be processed with geometry nodes to be visualized.
2930
5. When importing JSON, specify the array name where the data is in your JSON File. It must be in the root JSON object, and it must contain an array.
3031
6. When importing CSV, check if the delimiter is correct
3132
7. When importing CSV with lines before the header row, discard these by setting the Discard leading lines value
33+
8. Press the Import Spreadsheet button in the bottom right. The Importer will create a new Object named after the imported file. The Object wil have Mesh Data attached to it called csv_data or json_data depending on the imported file type.
34+
9. Check the Spreadsheet viewer in Blender to see if the data has been imported correctly.
35+
36+
![](documentation_images/imported_csv_example.png)
37+
38+
## Example Node Setup
39+
40+
To use the imported data in any geometry nodes tree, add an Object Info node and select the object containing the imported data in the object field.
41+
42+
If later you want to replace the data, you can do this in the object data properties of the selected object: Link another mesh data block to the object, and the values will update. If used column names still exist in the newly linked data block, everything should update as expected.
43+
44+
45+
### Sample a single value
46+
47+
![](documentation_images/sample_value_example.png)
48+
49+
### Bar chart
50+
A single float value named "field_name" is used to scale some cubes.
51+
The Domain Size node is used to find the amounts of bars needed (the size of the imported dataset), and a duplicate of the bar geometry is created for each row of data. The duplicates are then ofset along the X axis according to the duplicate index, and scaled along the Z axis according to the data sampled from the "field_name" comumn where the row matches the duplicate index.
52+
53+
![](documentation_images/nodes_bar_chart.png)
54+
55+
![](documentation_images/bar_chart.png)
3256

3357

3458
## Example import settings
59+
3560
### Sample CSV Import settings
3661

3762
![](documentation_images/import_options_csv_example.png)
@@ -64,7 +89,7 @@ Sample CSV Data:
6489

6590
The imported Data viewed in the spreadsheet editor:
6691

67-
![](documentation_images/imported_csv_example.png)
92+
![](documentation_images/imported_csv_example.png)
6893

6994
### Sample import settings for JSON
7095

@@ -215,15 +240,3 @@ Similar JSON Data
215240
Importing the above JSON file will produce this spreadsheet:
216241
![](documentation_images/imported_json_example.png)
217242

218-
219-
## Example Node Setup
220-
221-
### Bar chart
222-
A single float value named "Speicherwasser" is used to scale some cubes:
223-
224-
![](documentation_images/nodes_bar_chart.png)
225-
226-
![](documentation_images/nodes_float_value_and_normalized.png)
227-
228-
![](documentation_images/bar_chart.png)
229-
418 KB
Loading
106 KB
Loading

0 commit comments

Comments
 (0)