Cluster Zone Height Percent Canopy

Locate measured fruit-zone midpoints and spans within independent canopy bottom/top envelope, not ground-height percentage or light microclimate inference.

Description

Fruit-zone position should be measured relative to canopy bottom and top.

Fruit-zone position should be measured relative to canopy bottom and top. Ground height alone does not locate the zone within the canopy.

Locate measured fruit-zone midpoints and spans within independent canopy bottom/top envelope, not ground-height percentage or light microclimate inference.

When to use Cluster Zone Height Percent Canopy

Use this tool to locate measured fruit-zone midpoints and spans within independent canopy bottom/top envelope, not ground-height percentage or light microclimate inference.

Prepare vineyard measurements, dates or block records for the intended growing period. Keep weights, counts and weather observations in the stated units.

How to use Cluster Zone Height Percent Canopy and understand its results

Prepare vineyard measurements, dates or block records for the intended growing period. Keep weights, counts and weather observations in the stated units.
Enter canopyBottomHeightsM, canopyTopHeightsM, clusterZoneBottomHeightsM, clusterZoneTopHeightsM using the field table and calculation rules, then run the tool.
Read clusterZoneMidpointPercentOfCanopyHeight, clusterZoneHeightFractions. The explanation below defines the units, signs, ordering and any flags or placeholder values.
If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.

Input field	Meaning	Value type; see rules below	Requirement
canopyBottomHeightsM	Canopy bottom heights m	list of number	Required
canopyTopHeightsM	Canopy top heights m	list of number	Required
clusterZoneBottomHeightsM	Cluster zone bottom heights m	list of number	Required
clusterZoneTopHeightsM	Cluster zone top heights m	list of number	Required

Align heights, require positive canopy span and an ordered cluster zone wholly inside it. Return midpoint percentage and zone-height fraction.^[1]

Paired lists must be nonempty and have equal lengths.

midpoint percent = 100 × (zone midpoint − canopy bottom)/canopy span

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output field	Meaning	Value type
clusterZoneMidpointPercentOfCanopyHeight	Cluster zone midpoint percent of canopy height	list of number
clusterZoneHeightFractions	Cluster zone height fractions	list of number

json

{
  "input": {
    "canopyBottomHeightsM": [
      0.5,
      1
    ],
    "canopyTopHeightsM": [
      2.5,
      3
    ],
    "clusterZoneBottomHeightsM": [
      1,
      1.5
    ],
    "clusterZoneTopHeightsM": [
      2,
      2
    ]
  },
  "output": {
    "clusterZoneMidpointPercentOfCanopyHeight": [
      50,
      37.5
    ],
    "clusterZoneHeightFractions": [
      0.5,
      0.25
    ]
  }
}

Limitations and assumptions

Geometric placement does not infer light exposure or fruit microclimate.

Numbers and computed results must be finite; overflow produces an error. Numeric lists are limited to 100,000 entries; the rules above may require smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.

Alternative or Complementary methods

Use Row Shadow Width North South: Project ideal vertical north–south row canopy shadow onto east–west row normal using supplied sun angles/dimensions; no coordinates, terrain, irradiance loss, vine suitability or geodesy. For a complementary task, use Hedging Top Height Trimming: Account measured canopy envelope above caller hedge-height scenario across unequal row lengths/widths; rectangular envelope is not actual foliage biomass or a growth-control recommendation.

References

Cluster Zone Height Percent Canopy — tool.io

Similar or alternative tools

Row Shadow Width North South
Project ideal vertical north–south row canopy shadow onto east–west row normal using supplied sun angles/dimensions; no coordinates, terrain, irradiance loss, vine suitability or geodesy.
Hedging Top Height Trimming
Account measured canopy envelope above caller hedge-height scenario across unequal row lengths/widths; rectangular envelope is not actual foliage biomass or a growth-control recommendation.