Description
One-dimensional mature canopy extents along the street axis.
Planning indicators combine supplied counts, time intervals, distances, and area definitions. The denominator, geometric envelope, and category boundaries affect a reported density or share. A scenario calculation follows those assumptions while the governing rules and actual site conditions require separate verification.
One-dimensional mature canopy extents along the street axis.
When to use this tool
Use Street Tree Canopy Gap At Maturity when you need an explicit scenario indicator from supplied site dimensions, service records, or policy assumptions.
How to use the tool and how it works
- Enter spacing, firstDiameter, secondDiameter. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read clearGap, overlap. Use the output convention below.
Compare spacing with the sum of half firstDiameter and half secondDiameter. Return clearGap=max(0,spacing-radiiSum) and overlap=max(0,radiiSum-spacing), requiring nonnegative inputs.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| spacing | Center-to-center spacing in the same length unit as canopy diameters. | Required. Finite number; minimum 0. |
| firstDiameter | First Diameter | Required. Finite number; minimum 0. |
| secondDiameter | Second Diameter | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| clearGap | Clear Gap | Required. Finite number. |
| overlap | Overlap | Required. Finite number. |
{
"input": {
"spacing": 10,
"firstDiameter": 6,
"secondDiameter": 8
},
"output": {
"clearGap": 3,
"overlap": 0
}
}Limitations and assumptions
- Spacing is center-to-center distance and overlap is a linear penetration measure, not an overlap area. Canopy sizes are supplied rather than predicted from species, growth conditions, or pruning.
- The field tables state structural bounds; the mechanics also specify cross-field constraints. Malformed inputs and unsupported domains cause errors. A successful false flag, empty branch value, or zero placeholder has the meaning stated above and is distinct from an input error.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Signed zero is exported as zero.
Alternative or Complementary methods
Check measured site data and the applicable authoritative definitions before using a scenario in a planning decision. Geographic analysis, transport modeling, or a complete design review may be needed beyond the stated term.
References
Similar or alternative tools
- Setback Plane Height At Distance
Explicit piecewise plane starts rising beyond the supplied setback; no zoning rule is selected.
- Street Frontage Build To Gap
Calculate actualFraction=occupiedFrontage/frontage, requiredLength=frontage*requiredFraction, and gap=occupiedFrontage-requiredLength.