Description
Return clearAlley=spacing-left-right, required=implement+2*margin and their signed difference.
Agroforestry geometry separates row widths, root-zone intervals, canopy projections and repeated-strip area bases. Optical shade, optical porosity and a clear machinery corridor are different quantities. Ideal dimensions and supplied overlaps can support bookkeeping without establishing light conditions, aerodynamic shelter or safe access.
Return clearAlley=spacing-left-right, required=implement+2*margin and their signed difference.
When to use this tool
Use Alley Operation Clearance Gap when checking the stated ideal tree-row, shade, buffer or area convention.
How to use the tool and how it works
- Enter rowSpacing, leftCanopyRadius, rightCanopyRadius, implementWidth, sideMargin. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read clearAlley, totalRequiredWidth, clearanceGap. Use the output convention below.
Require nonnegative widths, canopy radii and side margin. Return clearAlley=spacing-left-right, required=implement+2*margin and their signed difference.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| rowSpacing | Row Spacing | Required. Finite number; minimum 0. |
| leftCanopyRadius | Left Canopy Radius | Required. Finite number; minimum 0. |
| rightCanopyRadius | Right Canopy Radius | Required. Finite number; minimum 0. |
| implementWidth | Implement Width | Required. Finite number; minimum 0. |
| sideMargin | Side Margin | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| clearAlley | Clear Alley | Required. Finite number. |
| totalRequiredWidth | Total Required Width | Required. Finite number. |
| clearanceGap | Clearance Gap | Required. Finite number. |
{
"input": {
"rowSpacing": 12,
"leftCanopyRadius": 2,
"rightCanopyRadius": 3,
"implementWidth": 4,
"sideMargin": 1
},
"output": {
"clearAlley": 7,
"totalRequiredWidth": 6,
"clearanceGap": 1
}
}Limitations and assumptions
- Negative clearances are retained; this is a supplied geometry check, not a safe operating-width recommendation.
- 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
Use measured terrain and canopy geometry, appropriate light/flow models and qualified agricultural/engineering assessment for actual layouts and operations.
References
Similar or alternative tools
- Crop Alley Usable Width
Return rowSpacing-firstEncroachment-secondEncroachment without clamping.
- Agroforestry Space Row Replant Budget
Count floor((rowLength-2*allowance)/spacing)+1 endpoint-inclusive positions; replant gap is max(0,target-surviving).