EcoSpecies

from acron.vegetation import EcoSpecies
class EcoSpecies

Bases:

Bases: TypedReferenceCount

What an Ecosystem needs to know about a plant species: its size and life, how it takes shade, which ground it wants, and how it spreads. Plain values (metres, years, degrees); no geometry – the name is what a renderer maps to its tree species.

max_height: the height (m) a tree reaches on an ideal site crown_ratio: crown radius over height growth_rate: the fraction of its remaining height it gains a year at full vigour max_age: the age (years) by which senescence has it maturity_age: the age (years) it starts to seed at shade_tolerance: 0 needs full sun (pioneers) .. 1 thrives in deep shade moisture_pref: the moisture (0 dry .. 1 wet) it does best at moisture_width: how far from that it still does well (a Gaussian’s sigma) slope_max: the steepest ground (degrees) it establishes on altitude_min: the lowest altitude (m, EcoTerrain.get_altitude) it establishes at altitude_max: the highest altitude (m) it establishes at seed_radius: how far (m) its seeds fall (at most the engine’s reach) seed_rate: seedlings a healthy mature plant sends out per year (before germination) density: seed rain from outside: establishments per hectare per year on a good site crown_opacity: how much light its crown stops (0..1) patchiness: 0 even seed rain .. 1 strongly patchy (species stands) patch_scale: the size (m) of those patches understory: a shrub-layer plant (under the trees’ crowns, beside a tree in the same cell); by default anything under 5 m tall

A NaN (or, but for the altitude limits, an infinite) value is rejected with an error, the setting unchanged.

Inheritance diagram

digraph inheritancef017643656 { bgcolor=transparent; rankdir=BT; size="8.0, 12.0"; "DTOOL_SUPER_BASE" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style=""]; "EcoSpecies" [URL="acron.vegetation.EcoSpecies.html#acron.vegetation.EcoSpecies",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "TypedReferenceCount" -> "EcoSpecies" [arrowsize=0.75,style=""]; "ReferenceCount" [URL="acron.core.ReferenceCount.html#acron.core.ReferenceCount",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "DTOOL_SUPER_BASE" -> "ReferenceCount" [arrowsize=0.75,style=""]; "TypedObject" [URL="acron.core.TypedObject.html#acron.core.TypedObject",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "DTOOL_SUPER_BASE" -> "TypedObject" [arrowsize=0.75,style=""]; "TypedReferenceCount" [URL="acron.core.TypedReferenceCount.html#acron.core.TypedReferenceCount",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "TypedObject" -> "TypedReferenceCount" [arrowsize=0.75,style=""]; "ReferenceCount" -> "TypedReferenceCount" [arrowsize=0.75,style=""]; }
__init__()

A species with middling defaults (a 20 m tree of half shade tolerance).

property altitude_max → float
property altitude_min → float
clear_understory()
property crown_opacity → float
property crown_ratio → float
property density → float
get_altitude_max()
get_altitude_min()
static get_class_type()
get_crown_opacity()
get_crown_ratio()
get_density()
get_growth_rate()
get_maturity_age()
get_max_age()
get_max_crown_radius()
get_max_height()
get_moisture_pref()
get_moisture_width()
get_name()
get_patch_scale()
get_patchiness()
get_seed_radius()
get_seed_rate()
get_shade_tolerance()
get_slope_max()
property growth_rate → float
is_understory()
light_response()

Vigour 0..1 from the light reaching the plant (0..1 of open sky): a species needs 0.1 (shade tolerant) .. 0.7 (pioneer) of full light to grow at its best; below that its vigour falls as (light / need) to a power from 0.65 (tolerant: a sapling in deep shade still grows, slowly) to 2 (a pioneer starves).

property maturity_age → float
property max_age → float
property max_height → float
property moisture_pref → float
property moisture_width → float
property name → string
property patch_scale → float
property patchiness → float
property seed_radius → float
property seed_rate → float
set_altitude_max()
set_altitude_min()
set_crown_opacity()
set_crown_ratio()
set_density()
set_growth_rate()
set_maturity_age()
set_max_age()
set_max_height()
set_moisture_pref()
set_moisture_width()
set_name()
set_patch_scale()
set_patchiness()
set_seed_radius()
set_seed_rate()
set_shade_tolerance()
set_slope_max()
set_understory()
property shade_tolerance → float
property slope_max → float
property understory → bool