Differences

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

--- tutorials:analyse-structure [2025/06/27 16:51] – t
+++ tutorials:analyse-structure [2025/06/27 18:19] (current) – [Requirements] t
@@ Line 6: / Line 6: @@
 Note that there are also the [[tutorials:grogra-functions|GROGRA Functions for structural analysis]]. These work directly in GroIMP and can provide similar outputs like rTwig, but they are not documented as well. Nonetheless, their wiki article here may give you some ideas on the types of analysis you can conduct, irrespective of the tools you use.
-There are two typical data origins for structures that people want to analyze: Manually measured FASTRAK data and plants generated in GroIMP. This article covers both of these sources. There is also a third possible data source, which are QSMs. These can also be imported and analyzed in GroIMP. For example, GroIMP could be used to interactively correct QSM topologies.
+There are three typical data origins for structures that people want to analyze: Manually measured FASTRAK or [[groimp-platform:dtd-format|.DTD]] data and plants generated in GroIMP. This article covers all of these sources. There is also a fourth possible data source, which are QSMs. These can also be imported and analyzed in GroIMP. For example, GroIMP could be used to interactively correct QSM topologies.
 ===== Requirements =====
-  * GroIMP "qsm" plugin
+  * GroIMP "qsm" [[user-guide:pluginmanager|plugin]]
   * GroIMP "fastrakReader" plugin when working with FASTRAK data (use version 0.8 with GroIMP version 2.2)
   * Some recent version of R
@@ Line 15: / Line 15: @@
 ===== GroIMP import & export=====
+As always in GroIMP, you can import your file using Object -> Insert File / Insert File to RGG. The difference is that if you insert to RGG, the file will be imported under the RGG Root instead of under Node.0. For our example here, both are equivalent.
 ==== Import: FASTRAK ====
+Importing FASTRAK data in .xml format requires the fastrakReader plugin.
-When using FASTRAK data, you can open a new RGG project and simply import your file using Object -> Insert File / Insert File to RGG. This requires the fastrakReader plugin. The difference is that if you insert to RGG, the file will be imported under the RGG Root instead of under Node.0. For our example here, both are equivalent. Note that your data might be scaled in an unexpected way relative to your GroIMP project. In the picture below is an example of FASTRAK data inserted in a New RGG project, note the size of the FASTRAK tree relative to the "A" of New RGG.
+Note that your data might be scaled in an unexpected way relative to your GroIMP project. In the picture below is an example of FASTRAK data inserted in a New RGG project, note the size of the FASTRAK tree relative to the "A" of New RGG.
 {{:tutorials:fastrak-imported-new-rgg.png?400|}}
@@ Line 40: / Line 41: @@
 ]}
 </code>
+==== Import: DTD ====
+DTD files can be imported in exactly the same way as FASTRAK files, but no special plugin is required.
 ==== Import: QSM ====
@@ Line 85: / Line 89: @@
 {{:tutorials:stem_taper_231_5.png?400|}}
-<code sas>
+tree_metrics() provides some useful aggregations that are similar to GroIMP queries, like for example the aggregation of individual cylinder segments into branches.
-metrics <- tree_metrics(qsm)
+The actual analysis to perform will however heavily depend on the type of your data source and how the data was collected (e.g. biologically meaningful shoot-based data vs. pure geometry acquisitions)
-plot(metrics$stem_taper$height_m, metrics$stem_taper$diameter_cm,
-     xlab = "Height [m]",
-     ylab = "Diameters [cm]")
-lines(metrics$stem_taper$height_m, metrics$stem_taper$diameter_cm)
-</code>