Tree
Documentation of the tree components.
Introduction
The Tree cluster provides a series of components that generate parametric diagrams of multi-phased tree systems, both Unitary and Non-Unitary, based on the groundbreaking research in the stages of tree development. These components offer a powerful tool for understanding and visualizing the complex structures of trees, which have been the subject of extensive study in the field of arboriculture.
The study of the stages of the tree development has its roots in the pioneering work of Pierre Raimbault, who published a series of two seminal papers titled The management of ornamental trees Part 1 Raimbault et al. (1993), Part 2 Raimbault et al. (1995). These two papers laid the foundation for the analysis and diagnosis of the aerial parts of trees. Raimbault's work provided a framework for understanding the growth patterns and structural organization of trees, which has since been refined and expanded by subsequent researchers.
Building upon Raimbault's foundation, the most recent advances in the study of stages of tree development have been made by Christophe Drénou, whose research Drénou et al. (2015), Larrieu et al. (2022) represents the state-of-the-art in this field. Drénou's work has further developed the concept of different stages during tree's development and has provided new insights into the complex processes that shape tree growth and form.
This cluster incorporate the findings of both Raimbault and Drénou, allowing users to generate parametric diagrams based on two different architectural models: the Raimbault Model (10 phases) and the Drénou Model (4 key stages: young, adult, mature, senescent). These models provide a means of understanding and representing the multi-phased nature of tree growth, which involves the iterative development of new structural units over time.
Component Usage
Please refer to the following sections for each component from this cluster. While the information is not needed to generate the tree diagrams, information from the Soil, and Root clusters are required to complete the full diagram illustration.
Raimbault Model
This component is used to generate sectional tree diagrams based on the given plane, height and phase.
Unitary
Non-Unitary
Param. | Abbr. | I/O | Optional | Description |
---|---|---|---|---|
Plane | P | Yes | Base plane or planes in which the tree is drawn, the default value is World-XY unless specified. | |
Height | H | No | Input parameter that controls the height of the drawn tree diagrams. | |
Phase | phase | No | The growth phase ( 1, 12 ) of the tree, allowing adjustment of the maturity of the tree. | |
Circumfrence | C | Circumfrence ellipses that control the boundary of the tree. | ||
Trunk | T | Curves that define the trunk of the tree. | ||
Canopy | C | The upper limit of the drawn branches of the tree. | ||
SideBranch | SB | A list of curves that include branches that grow horizontally in respect to the tree trunk. | ||
TopBranch | TB | A list of curves that grow from the upper portion of the trunk at different phases of tree growth. | ||
BabyBranch | BB | A list of curves that are drawn to show the development of smaller branches in different phases of growth. | ||
TreeInfo | Tinfo | Information about the growth of the tree that is used for tree root diagram generation. |
Context Menu: This component provides an additional option in the context menu choose between unitary or Non Unitary, due to the different tree forms. The selection will trigger different algorithm inside the component for drawing the corresponding diagram.
Tree Growth Phases Diagram
Forest 2D
The forest 2d section is an extension of the Raimbault model component, which allows for the automatic adjustment of each tree's width based on its proximity to neighboring trees. By modifying the spacing between trees within the Grasshopper file (.gh file), users can generate a diagram featuring a series of trees that are precisely adapted to their spatial relationships with one another. This extension leverages the capabilities of the tree component to create a more realistic and dynamic representation of a forest ecosystem.
Raimbault Model
component to create 2D forest. Note that the examples uses component from the add-on Human to define the width of curves. Users can install this package via the PackageManager
in Rhino.
Drénou Model
This component is used to generate 3-dimension tree diagrams of the Drénou Model based on the given plane
and other control parameters such as size
, branch angle
, and phase
. Specifically, the phase
parameter signifies the tree's growth stage and influences its overall shape. The components include 13 distinct phases, as detailed below.
Param. | Abbr. | I/O | Optional | Description |
---|---|---|---|---|
Plane | P | Yes | Base plane(s) where the tree(s) is drawn. | |
GlobalScale | globalS | Yes | Global scale of the tree. | |
TrunkScale | trunkS | Yes | Trunk scale of the tree. | |
SpreadAngleMain | angMain | Yes | Spread angle of the primary tree branches. | |
SpreadAngleTop | angTop | Yes | Spread angle of the secontary tree branches (the top part). | |
Phase | phase | No | Phase of the tree's growth. Range: [1,13]. Typical Phase: 2, 8, 10, and 13. | |
Seed | seed | Yes | Seed for random number to varify the tree shape. | |
BranchRotation | brRot | Yes | Whether to rotate the branches sequentially. | |
DuplicateNumber | dupNum | Yes | Number of top side branches for duplicate branching. Range: [0,3]. | |
Trunk | T | Tree trunk curves. | ||
SingleBranch | SB | Tree side branch curves (non-split). | ||
SplitBranch | TB | Tree top branch and duplicated branch curves (splitted). | ||
TreeInfo | TInfo | Information about the tree. |
Branch rotation
The BranchRotation (brRots)
parameter on the input side determines if side branches at varying heights rotate sequentially. Setting this parameter to True
can enhance the tree's appearance in 3D views by giving it a more natural look. Conversely, setting it to False
could be beneficial in 2D representations, as it helps maintain a cleaner, more organized appearance.
Duplicate Number
The DuplicateNumber (dupNum)
parameter on the input side determines the number of top branches that will undergo duplicate branching. If the value is set to 0, the top branch will include only a single main branch. If the value is set to 1, in addition to the main top branch, one extra branch will undergo duplicate branching, as shown below.
Data structure of branches
The SideBranch (SB)
and TopBranch (TB)
parametes on the output side includes all the generated branch curves, which are organized into two levels. The first level stands for the tree index, while the second level stands for the branch layer of the generated 3D tree.
For a single tree case, users can use the component Explode Tree
distinguish between branch curves. For multiple trees, these branches should be combined (use components Path Mapper
and Trim Tree
) before the distinguishment, as shown below. These branches, originating from different trees, can be organized either by branch layers for tree visualization or by individual trees for canopy generation.
Different Growth Phases Diagram
Phase | |||||
---|---|---|---|---|---|
Young | |||||
Adult | |||||
Mature | |||||
Senescent |
Visibility of Branch: Here, we only display side branches (output SingleBranch
) from phase 1 to phase 4 (young phase). In other phases, only split branches (output SplitBranch
) are shown. Users can toggle the visibility of the corresponding branches as needed.
Typical Growth Phases
Forest 3D
This section is an extension of the Drénou Model component. The component is capable of processing multiple inputs simultaneously, enabling the generation of 3D trees in diverse phases and locations and the creation of 3D forest. It can automatically adjust the shape of each tree according to its distance from neighbouring trees.
Tree Energy Canopy
This component uses the trunk and the branches of the 3D version of the Drénou Model to genereate the energy canopy that can be used for energy analaysis. It simply output a mesh-type water-tight volume that can be used as a "shade" for energy analysis software.
Param. | Abbr. | I/O | Optional | Description |
---|---|---|---|---|
Trunk | T | No | Tree trunk curves. | |
TrunkRadius | T-r | Yes | Tree trunk radius, for creating different sizes of trunks. | |
Branches | B | No | Tree branch curves. | |
EnergyVolume | E | Energy volume for energy analysis. |
Transmittance
In energy analysis, tree crown density and foliage play key roles in blocking sunlight and heat from reaching the ground. To integrate this feature into the energy analysis, we rely on the control of the transmittance
parameter of the canopy mesh in the anlysis software.
Figure: A horse chestnut tree, shown with and without leaves. Adapted from Krause (2021).
A guidance for setting the transmittance
value for direct solar radiation is given below Konarska et al. (2014):
Tree Crown State | Recommended Transsmittance Value | Mean of Deciduous Trees |
---|---|---|
Foliated | 1.3% - 5.3% | 2.9% |
Defoliated | 40.2% - 51.9% | 47.9% |
Users can refer to the Showcase section to see its application.