Cluster Thinning To Target Yield

Audit whole-cluster retention consistent with caller fruit-mass ceilings and independently forecast mature cluster masses; no validated optimum/thinning advice and forecast uncertainty is not silently measured yield.

Description

A mass ceiling permits only a whole number of forecast clusters.

A mass ceiling permits only a whole number of forecast clusters. Retained-cluster budgets depend on the assumed mature mass.

When to use Cluster Thinning To Target Yield

Use this tool to audit whole-cluster retention consistent with caller fruit-mass ceilings and independently forecast mature cluster masses; no validated optimum/thinning advice and forecast uncertainty is not silently measured yield.

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 Thinning To Target Yield 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 observedClustersPerVine, forecastMatureClusterMassesKg, callerMaximumFruitMassKgPerVine using the field table and calculation rules, then run the tool.
Read maximumWholeRetainedClustersByVine, minimumClusterCountReductionUnderBudget, modeledRetainedFruitMassesKg. 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
observedClustersPerVine	Observed clusters per vine	list of number	Required
forecastMatureClusterMassesKg	Forecast mature cluster masses kg	list of number	Required
callerMaximumFruitMassKgPerVine	Caller maximum fruit mass kg per vine	list of number	Required

Align nonnegative integer observed clusters, positive forecast masses and nonnegative per-vine ceilings. Return maximum whole retained counts, reductions and modeled retained masses.^[1]

Paired lists must be nonempty and have equal lengths.

retained clusters = min(observed,floor(mass ceiling/forecast cluster mass))

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

Output field	Meaning	Value type
maximumWholeRetainedClustersByVine	Maximum whole retained clusters by vine	list of number
minimumClusterCountReductionUnderBudget	Minimum cluster count reduction under budget	list of number
modeledRetainedFruitMassesKg	Modeled retained fruit masses kg	list of number

json

{
  "input": {
    "observedClustersPerVine": [
      10,
      20
    ],
    "forecastMatureClusterMassesKg": [
      0.2,
      0.1
    ],
    "callerMaximumFruitMassKgPerVine": [
      1,
      1
    ]
  },
  "output": {
    "maximumWholeRetainedClustersByVine": [
      5,
      10
    ],
    "minimumClusterCountReductionUnderBudget": [
      5,
      10
    ],
    "modeledRetainedFruitMassesKg": [
      1,
      1
    ]
  }
}

Limitations and assumptions

The forecast is not measured yield, and the ceiling does not establish an optimal thinning target.

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 Lag Phase Weight Yield Forecast: Forecast heterogeneous lag-phase cluster masses using supplied calibrated maturity growth factors and represented cluster inventories; unlike count-only yield expansion, weight growth is explicit and not guaranteed. For a complementary task, use Crop Estimate Cluster Count Method: Expand equal-probability sampled vine cluster counts to block yield with caller mature-cluster mass and count-sampling error only; no weight/selection uncertainty, harvest guarantee or optimum crop load.

References

Cluster Thinning To Target Yield — tool.io

Similar or alternative tools

Lag Phase Weight Yield Forecast
Forecast heterogeneous lag-phase cluster masses using supplied calibrated maturity growth factors and represented cluster inventories; unlike count-only yield expansion, weight growth is explicit and not guaranteed.
Crop Estimate Cluster Count Method
Expand equal-probability sampled vine cluster counts to block yield with caller mature-cluster mass and count-sampling error only; no weight/selection uncertainty, harvest guarantee or optimum crop load.