Summarise structure-factorial trajectories by stand composition

Each cell is one (cohort structure, parameter combination) pair, so several cells share a composition and differ in parameters and cohort ages. The spread across them is therefore real variation in what the parameter set does to that mixture, not noise, and is reported as a band rather than averaged away.

Usage

growth_structure_summary(cells, min_cells = 25L, start_age_breaks = NULL)

Arguments

cells

A tibble from growth_structure_cell_curves().

min_cells

Integer. Drop compositions represented by fewer cells than this, which are too thin to read a band from. Applied per class when start_age_breaks is given, so a stratified call needs more cells overall.

start_age_breaks

Numeric or NULL. Breaks passed to cut() to bin each cell's start_age, adding a start_class column and summarising within it. NULL (the default) pools over starting age, which is the historical behaviour. Requires cells to carry start_age.

Value

A tibble, one row per composition and age (and start_class when stratified).

Details

Pooling over starting age is usually the wrong default for reading a band. A composition's cells differ in two ways at once: the parameter combination, and the ages the map gave their cohorts. The second dominates, so a band taken over the pool is mostly stand age wearing the parameters' name. Supply start_age_breaks to summarise WITHIN starting-age classes instead, which leaves the remaining spread attributable to the parameters.

See also

Other growth calibration helpers: extract_landscape_cohort_structures(), growth_add_objective(), growth_auto_window(), growth_best_candidates(), growth_bin_observations(), growth_calibration_design(), growth_calibration_partition(), growth_calibration_work_root(), growth_climatic_distance(), growth_climatic_weight(), growth_expand_over_pseudo_species(), growth_factorial_ratio_grid(), growth_fitting_windows(), growth_identifiability(), growth_inflation_factor(), growth_mortality_onset_frac(), growth_plot_palette(), growth_pseudo_species_name(), growth_reference_curves(), growth_reference_inflection(), growth_score_fit(), growth_scoring_for(), growth_smooth_observations(), growth_structure_cell_curves(), growth_structure_cohort_table(), growth_structure_design(), growth_window_for(), plot_growth_calibration(), plot_growth_candidate(), plot_growth_factorial_sensitivity(), plot_growth_structures(), read_growth_scoring(), read_landscape_cohort_structures(), scale_linetype_growth_reference(), write_growth_review_bundle()