Description
Subtract canopyRadius from centerDistance for canopyEdgeDistance and subtract requiredSetback for margin.
A site clearance is a signed difference between available space and an object or allowance. A supplied setback and assumed future envelope are separate from actual legal or environmental requirements.
Subtract canopyRadius from centerDistance for canopyEdgeDistance and subtract requiredSetback for margin.
When to use this tool
Use Canopy Projection Setback Gap when you need one explicit landscape clearance margin.
How to use the tool and how it works
- Enter centerDistance, canopyRadius, requiredSetback. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read canopyEdgeDistance, margin. Use the output convention below.
Subtract canopyRadius from centerDistance for canopyEdgeDistance and subtract requiredSetback for margin.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| centerDistance | Center Distance | Required. Finite number; minimum 0. |
| canopyRadius | Canopy Radius | Required. Finite number; minimum 0. |
| requiredSetback | Required Setback | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| canopyEdgeDistance | Canopy Edge Distance | Required. Finite number. |
| margin | Signed allowance remaining under the calculation above. | Required. Finite number. |
{
"input": {
"centerDistance": 8,
"canopyRadius": 3,
"requiredSetback": 2
},
"output": {
"canopyEdgeDistance": 5,
"margin": 3
}
}Limitations and assumptions
- All distances share a unit; supplied canopy and setback values do not establish legal clearance or future growth.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- 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. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Verify current measurements, future growth, survey datums, and applicable design requirements for the site.
References
Similar or alternative tools
- Tree Grid Boundary Clearance
Subtract canopyRadius from centerDistance for clearance and subtract suppliedSetback for slack.
- Tree Grille Corner Radius Clearance
Subtract trunkRadius, growthAllowance, and abs(placementError) from openingRadius for radialMargin.