Differences

This shows you the differences between two versions of the page.

--- 01_user_documentation:05_object:04_data:01_dataset [2025/08/15 11:25] – Tim
+++ 01_user_documentation:05_object:04_data:01_dataset [2025/12/10 13:14] (current) – ↷ Links adapted because of a move operation gaetan
@@ Line 6: / Line 6: @@
-Datasets are accessible in both the GUI (via the [[01_user_documentation:03_interacting_with_groimp:02_panels:02_explorers:03_datasets|Datasets Explorer]]) and in RGG code using the DatasetRef class. Titles for columns can be set, and data can be visualized using the ''chart()'' function with plot types like ''XY_PLOT''.
+Datasets are accessible in both the GUI (via the [[01_user_documentation:03_interacting_with_groimp:02_panels:02_explorers:03_datasets|Datasets Explorer]]) and in RGG code using the DatasetRef class.
-Datasets can be exported to external files and are persistent across simulation runs unless explicitly cleared.
+Titles for columns can be set, and data can be [[01_user_documentation:03_interacting_with_groimp:15_visualization:04_plotting|plotted]].
-For code examples see the [[02_user_tutorials:data_plots|datasets tutorial]].
+Datasets are persistent across simulation runs unless explicitly cleared.
+===== Export =====
+Using the [[01_user_documentation:03_interacting_with_groimp:02_panels:02_explorers:03_datasets| explorer]] datasets can be exported to:
+  * txt
+  * csv
+  * html
+  * xls
+  * pdf
+Using rgg code datasets can be exported to csv with the [[ 01_user_documentation:05_object:06_references:03_datasets#exporting | export function]].
+For code examples see the [[02_user_tutorials:plotting:data_plots|datasets tutorial]].
+===== Cleaning =====
+Since datasets are persistent across simulation runs old data is kept inside. A dataset can be clean using the  datasetRef function [[01_user_documentation:05_object:06_references:03_datasets#cleaning|''clear()'']] or by simply deleting the object form the dataset explorer.
+===== Adding data =====
+The only way to add values to a dataset is through RGG code executed either in the model or in the xl console, using the [[01_user_documentation:05_object:06_references:03_datasets#adding_data | datasetRef functions]].
+==== adding multipe values for one cell ====
+In order to use the [[01_user_documentation:03_interacting_with_groimp:15_visualization:04_plotting:07_xy_plot]] or the [[01_user_documentation:03_interacting_with_groimp:15_visualization:04_plotting:06_scatter_plot]] more than one value per cell is needed. Therefore the datasetRef has [[01_user_documentation:05_object:06_references:03_datasets#add_several_values_to_one_cell |additional functions]] for that and in the table view this is displayed with white spaces.