GroIMP wiki - 02_user_tutorials

Installation

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:13+00:00

Installation GroIMP is a pure Java application, therefore a Java Virtual Machine should be installed before installing GroIMP. GroIMP releases consist the compiled executable and a pre-packaged versions for each Windows x64, Mac, and Linux (containing not just the GroIMP executable, but also its dependencies).

Run

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T14:34:31+00:00

Run How to run models/ projects in GroIMP. Running GroIMP Because `core.jar` is an executable java archive, it is possible to start GroIMP just by (double-)clicking on the file in your system's file browser as you would do with a usual executable file. This requires a suitable setup of your file browser, see the documentation of the browser and your Java installation if it does not already work.

Plugins

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T14:34:48+00:00

Plugins GroIMP is designed around a Plugin architecture. The plugins can be added and removed from the software to fit the features wanted. Java plugins Installation of Plugins for the Java Image I/O Framework. GroIMP requires only a Java runtime environment in order to run. However, the capabilities of some parts of the Java runtime environment can be extended by the installation of additional plugins. GroIMP makes use of the Java Image I/O Framework which provides features such a pluggab…

Basic GUI

Anonymous (anonymous@undisclosed.example.com) — 2026-03-12T09:09:27+00:00

Basic GUI Presentation of the commons panels and some basic GUI manipulations. Additionally: Use the GroIMP software (video tutorials) Running your first RGG model → Read more... GUI introduction GroIMP is equipped with a modern, configurable graphical user interface. It supports user-defined layouts of panels, including arrangement of panels in tab groups and floating windows. Figure 2.1,

Project

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T14:35:24+00:00

Project How to manage projects. Project handling The main entity you work on in GroIMP is the project. A project may consist of various parts, e.g., files, source code, a scene (2D, 3D, or other), resource objects like data sets, 3D materials or the like. Several projects can be open at the same time, each in its own main window.

I/O

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T14:35:32+00:00

I/O How to import/ export data in/from a project. Export Object The results of a simulation can be exported to different formats (including 3D and taxonomical). If we want for example export the new RGG tree as an obj (a simple 3d format), we just need to start a new rgg project and run it a couple of times (so there is actually anything to export).

RGG coding

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T14:35:43+00:00

RGG coding How to code in RGG. RGG Code structure introduction The RGG programming language repents the core of almost all GroIMP models. This language extends java and implements the XL-language specification (), to enable rule based graph manipulation.

Rules & queries

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:13+00:00

Rules & queries How to use rules and queries XL queries and operators → Read more... From simple to advanced XL queries This tutorial is more of a quiz than a tutorial, for the different type of queries a graph and a set of quests are provided. For each quest, the answer and an explanation is provided. Yet it is important to mention that there can be several solutions, for most of this problems.

FSP Modeling

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:13+00:00

FSP Modeling FSP Modeling tutorials. Growth models step by step In this tutorial we will create a growth model for a crown architecture. The model considers only the branch structure, without leaves, to provide an easy entry point. It may be helpful to understand the basic RGG code structure first, a tutorial is provided

Light

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:13+00:00

Light Learn about the different aspects of light modeling in GroIMP First steps Getting started with light simulation in GroIMP. Some of this content should be moved to the wiki part and linked here. --> This content should be moved to “FSP Modelling

Exercices

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T15:19:59+00:00

Exercices Implement 'plant like structures' Implement the 'plant like structures' as described in the book “The Algorithmic Beauty of Plants” by Prusinkiewicz and Lindenmayer (1990) on page 25 in Figure 1.24. → Read more... From 3D binary tree to 2D binary tree Change the default 3d binary tree to a 2d version, growing planar in one plane.

ODE

Anonymous (anonymous@undisclosed.example.com) — 2026-03-20T16:28:19+00:00

ODE How to work with ordinary differential equations in GroIMP using the integrated solver. How to use the ODE framework Since GroIMP 1.0 a new ODE framework is available to modellers. This allows easy specification and solution of differential equations, which are used in many FSPMs. The key component of this framework is a new operator :'= called the deferred rate assignment operator.

Geometry & transformation

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:13+00:00

Geometry & transformation How to use transformation, volumes, ... Leaf triangulation Triangulation is the process where a (ordered) set of triangles is generated out of a (unordered) set of points. The result is a set of triangles, now called faces, that can be directly drawn.

Additional interfaces

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:14+00:00

Additional interfaces Besides the Graphical user interface that is used in GroIMP by default, it is possible to execute models in other ways. The different User interface are described in the user-guide This can be useful for specific scenarios such as larger pipelines or remote execution. On this page you can find a collection of tutorials to get started with the different additional users interfaces.

2D Visualization

Anonymous (anonymous@undisclosed.example.com) — 2026-03-20T15:49:25+00:00

2D Visualization Working with the 2D representation of the model.(e.g. the 2d Graph) Use the 2D graph view In this tutorial we will see how to visualize the project graph. → Read more...

Dataset

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:14+00:00

Dataset GroIMP internal dataset structures Datasets inside GroIMP GroIMP comes with an included management of dataset, in the following only a small introduction is given. → Read more...

Errors to avoid

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T16:28:04+00:00

Errors to avoid Some common practices that can lead to issues. Mistake: Storing Nodes outside of the graph When developing a complex model in GroIMP, it happens that you want to “store” nodes in an “easy” to access data structure (list, array, map,

Fitting algorithms

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:14+00:00

Fitting algorithms Integrated parameter fitting algorithms.

GroGRA - Shoot analyses

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T14:36:47+00:00

GroGRA - Shoot analyses Analyzing models and imported plants using GroIMP features with the set of GroGrA functions. GROGRA Functions for structural analysis GroIMP contains some of the functions from its predecessor GROGRA which can be used to statistically analyze the current structure (e.g. with regard to lengths, angles, ect.).

MTG

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:13+00:00

MTG How to interact with MTGs (from OpenAlea) in GroIMP. MTG - Multiscale Tree Graph in some cases this helps: [a:de.grogra.mtg.MTGRoot ::> a.plantFrame(3,400);] EXAMPLE - Importing and Using MTG data in GroIMP ---------- → Read more...

Multiscale

Anonymous (anonymous@undisclosed.example.com) — 2026-02-07T13:08:22+00:00

Multiscale Multi scale examples wow A list of examples Some examples of multi scale usage (mostly syntax and prof of concept): Well it is a copy of their content because I cannot upload rgg files. deal with it. They are not ordered, they mostly come from Ong PhD.

Parameter manager

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:13+00:00

Parameter manager How to use them Parameter Manager This tutorial will go through how to get started with parameter managers. It will start with an overly simple project to highlight some key features, then, apply the same parameter management to a more advanced project.

Plotting data

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:13+00:00

Plotting data How to use plots. Color bars and measuring sticks → Read more... Plots inside GroIMP GroIMP has the ability to visualize datasets in different plots. → Read more...

Point clouds management

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:13+00:00

Point clouds management How to manage point clouds in GroIMP I/O Point Cloud The import formats both for files and object representation in GroIMP presented in this tutorial are mostly coming from the plugin Pointcloud. See here to see how install plugins in GroIMP. The wiki is up to date with the version 1.7 of the plugin.

QSM

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:14+00:00

QSM Use QSM in GroIMP. Post processing a QSM with GUI tools This tutorial explains the workflow of the GUI tools provided by the QSM plugin, based on some example actions. All this functionalities work not only on imported QSM but on DTD or fastrak xml files.

Video Generator

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T14:37:22+00:00

Video Generator Learn how to create videos of your project :O Creating a video of a simulation GroIMP comes with a video plugin that can create an animation from a series of pictures taken from the 3D model. This includes automatically running RGG functions while taking pictures.

Virtual data aquisition

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T12:14:13+00:00

Virtual data aquisition Capture data from the project. Virtual Laser Scanner → Read more...

Virtual Skeletonization

Anonymous (anonymous@undisclosed.example.com) — 2025-12-10T15:29:49+00:00

Virtual Skeletonization Amazing tool: VR Skeletonization The plugin VRSkeletonization enables to build a graph that follow the branch/ successor pattern from 3d coordinates. The VRSkeletonizations are composed of any Node under the RGGRoot, linked by BRANCH and SUCCESSOR edges. The knowledge of the skeletonization is kept by VRSPoint. The VRSPoints define the start and end of the VRS structure.