Differences

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

--- tutorials:grogra-functions [2024/05/28 17:07] – [Stem analysis] thomas
+++ tutorials:grogra-functions [2024/05/28 17:35] (current) – [GROGRA Functions for structural analysis] thomas
@@ Line 4: / Line 4: @@
 {{:tutorials:grogra_panel.png?400|}}
-Some of these functions are also explained in this {{ :tutorials:grogra_reference_guide.pdf | initial GROGRA documentation }} (page 98f.) and some further expansions in this {{ :tutorials:dzierzon_et_al_2003.pdf | paper}} (https://doi.org/10.14214/sf.510). This wiki provides a compressed form of the information in these sources, which are outdated. Not all the functions mentioned in the GROGRA documentation are 1:1 available in GroIMP. Also some of the the features of the different functions appear to be broken or they don't work at all (at least with the basic RGG model tree). This is because they were designed for some specific purpose that was lost over time. So use them at your own discretion. You can also check out the source code of the functions [[https://gitlab.com/grogra/groimp-plugins/RGG/-/blob/master/src/main/java/de/grogra/grogra/Analysis.java?ref_type=heads | here]].
+Some of these functions are also explained in this {{ :tutorials:grogra_reference_guide.pdf | initial GROGRA documentation }} (page 98f.) and some further expansions in this {{ :tutorials:dzierzon_et_al_2003.pdf | paper}} (https://doi.org/10.14214/sf.510) and also {{ :tutorials:oppelt_kurth_godbold_2001.pdf | here}} (only topological analysis). This wiki provides a compressed form of the information in these sources, which are partially outdated. For example, not all the functions mentioned in the GROGRA documentation are 1:1 available in GroIMP. Also some of the the features of the different functions appear to be broken or they don't work at all (at least with the basic RGG model tree). This is because they were designed for some specific purpose that was lost over time. So use them at your own discretion. If you are really interested in one specific function, I recommend to check out the source code of the functions [[https://gitlab.com/grogra/groimp-plugins/RGG/-/blob/master/src/main/java/de/grogra/grogra/Analysis.java?ref_type=heads | here]] to learn what it actually does. If you find information that is not covered already by this wiki, please add it!
 ===== Available functions, their purpose and output =====
@@ Line 78: / Line 78: @@
 ==== Stem analysis ====
-This function provides a table with a discretized description of the main stem which was intended to be further processed with a software called GROBOL (growth of boles engine). This software appears to have disappeared, let me know if you can find it somewhere.
+This function provides a table with a discretized description of the main stem (= segments of branching order 0) with diameter information for different heights (= Stem taper table). In the 90s, there was a program for the Silicon Graphics workstation called GROBOL (growth of boles engine), which could display and analyze the stem using this table (I am only mentioning this here because this software pops up in the sources occasionally, but don't bother searching for it).
 ==== Distribution analysis ====
+Frequency tables: elementary units, compound units, axes, el. units per compound unit etc., in total and for each branching order. <color #ed1c24>Appears to be a bit broken, can produce some unexpected results!</color>
 ==== Topological analysis ====
+Number of components, number of (graph-theoretical) links, maximal and average topological depth and other topological parameters, see {{ :tutorials:oppelt_kurth_godbold_2001.pdf | Oppelt et al. (2001)}}
 ==== Axes analysis ====
+<color #ed1c24>Extremely broken, crashes my GroIMP every time.</color> Is supposed to give parameters for each axis, including average interbranch distance and its standard deviation.