Site Forage Capacity Colonies

Screen seasonal colony capacity from supplied habitat nectar access and competing/ecological reserves; negative forage budget is retained and forage timing or pollination adequacy is not inferred.

Description

Seasonal forage capacity depends on accessible nectar and material reserved for competing or ecological demands.

Seasonal forage capacity depends on accessible nectar and material reserved for competing or ecological demands. A negative remaining budget is useful information even when modeled colony capacity is zero.^[1]

Screen seasonal colony capacity from supplied habitat nectar access and competing/ecological reserves; negative forage budget is retained and forage timing or pollination adequacy is not inferred.

When to use Site Forage Capacity Colonies

Use this tool to screen seasonal colony capacity from supplied habitat nectar access and competing/ecological reserves; negative forage budget is retained and forage timing or pollination adequacy is not inferred.

Prepare the hive, sample or operating measurements and any supplied target values. Confirm units, timing and whether counts or masses refer to the same population or batch.

How to use Site Forage Capacity Colonies and understand its results

Prepare the hive, sample or operating measurements and any supplied target values. Confirm units, timing and whether counts or masses refer to the same population or batch.
Enter habitatSeasonalNectarKg, accessibleFractions, competingAndEcologicalReserveKg, seasonalForageNeedKgPerColony using the field table and calculation rules, then run the tool.
Read netAllocatableForageKg, modelWholeColonyCapacity. 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
habitatSeasonalNectarKg	Habitat seasonal nectar kg	list of number	Required
accessibleFractions	Accessible fractions	list of number	Required
competingAndEcologicalReserveKg	Competing and ecological reserve kg	number	Required
seasonalForageNeedKgPerColony	Seasonal forage need kg per colony	number	Required

Pair nonnegative seasonal habitat nectar in kg with accessibility fractions in [0,1]. Supply nonnegative reserve and positive seasonal need per colony. Return signed allocatable forage and rounded-down nonnegative whole-colony capacity.

Paired lists must be nonempty and have equal lengths.

netForage = Σ(nectar_i accessFraction_i)−reserve; wholeCapacity = floor(max(0,netForage)/needPerColony)

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

Output field	Meaning	Value type
netAllocatableForageKg	Net allocatable forage kg	number
modelWholeColonyCapacity	Model whole colony capacity	number

json

{
  "input": {
    "habitatSeasonalNectarKg": [
      100,
      200
    ],
    "accessibleFractions": [
      0.5,
      0.5
    ],
    "competingAndEcologicalReserveKg": 50,
    "seasonalForageNeedKgPerColony": 20
  },
  "output": {
    "netAllocatableForageKg": 100,
    "modelWholeColonyCapacity": 5
  }
}

Limitations and assumptions

Supply and demand must share a season and mass basis. Forage timing, colony behavior, competition and uncertainty are not modeled; a capacity result does not guarantee nutrition or pollination adequacy.

Numeric inputs must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. 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 Forage Radius KM Range Estimate: Invert a measured trip/handling time budget to one-way reach with distinct outbound/return speeds; no universal foraging radius, energy reserve or landscape accessibility claim. For a complementary task, use Stores Depletion Rate Per Week: Fit net store trend after explicit cumulative feed additions; assumes store mass has already been corrected for hive/brood tare and does not attribute all loss to consumption.

References

Site Forage Capacity Colonies — tool.io

Similar or alternative tools

Forage Radius KM Range Estimate
Invert a measured trip/handling time budget to one-way reach with distinct outbound/return speeds; no universal foraging radius, energy reserve or landscape accessibility claim.
Stores Depletion Rate Per Week
Fit net store trend after explicit cumulative feed additions; assumes store mass has already been corrected for hive/brood tare and does not attribute all loss to consumption.