Skip to content

Main content

Alley Width Sun Angle Shadow Gap Tool

Calculate alley width sun angle shadow gap from explicit caller-supplied inputs.

Loading tool…

Description

Return height/tan(altitude) and max(0,alleyWidth-shadowLength).

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 height/tan(altitude) and max(0,alleyWidth-shadowLength).

When to use this tool

Use Alley Width Sun Angle Shadow Gap when checking the stated ideal tree-row, shade, buffer or area convention.

How to use the tool and how it works

  1. Enter alleyWidth, treeHeight, sunAltitude. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read shadowLength, unshadowedWidth. Use the output convention below.

Require nonnegative alley width/tree height and sunAltitude strictly between 0 and π/2 radians. Return height/tan(altitude) and max(0,alleyWidth-shadowLength).1

Input fieldMeaning and unitsAccepted input
alleyWidthAlley WidthRequired. Finite number; minimum 0.
treeHeightTree HeightRequired. Finite number; minimum 0.
sunAltitudeSun AltitudeRequired. Finite number; strictly above 0.
Output fieldInterpretationReturned shape
shadowLengthShadow LengthRequired. Finite number.
unshadowedWidthUnshadowed WidthRequired. Finite number.
json
{
  "input": {
    "alleyWidth": 10,
    "treeHeight": 4,
    "sunAltitude": 0.7853981633974483
  },
  "output": {
    "shadowLength": 4.000000000000001,
    "unshadowedWidth": 5.999999999999999
  }
}

Limitations and assumptions

  • Assumes an aligned ideal shadow on a level cross-section; azimuth, terrain and diffuse light are omitted.
  • 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

  1. Calculation and input contract: agroforestry/alley-width-sun-angle-shadow-gap — tool.io

Similar or alternative tools