Skip to content

Main content

Design Zone Reference Gap Tool

Calculate design zone reference gap from explicit caller-supplied inputs.

Loading tool…

Description

Return zoneGaps=assigned-reference and mismatches as the number of nonzero gaps.

Garden and resource-design calculations combine measured lengths, areas, water volumes, material fractions, travel, and evidence records. A useful budget needs consistent units and clear overlap, exclusion, and denominator rules. Supplied geometry and efficiencies describe a model rather than verified site performance.

Return zoneGaps=assigned-reference and mismatches as the number of nonzero gaps.

When to use this tool

Use Design Zone Reference Gap when you have supplied site dimensions or resource records and need the stated geometry, budget, or coverage measure.

How to use the tool and how it works

  1. Enter elementIds, assignedZones, suppliedReferenceZones. Keep parallel arrays aligned. 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 zoneGaps, mismatches. Use the output convention below.

Require aligned elementIds, nonnegative integer assignedZones, and nonnegative integer suppliedReferenceZones. Return zoneGaps=assigned-reference and mismatches as the number of nonzero gaps.1

Input fieldMeaning and unitsAccepted input
elementIdsElement IdsRequired. Array of text; maximum UTF-16 length 8192; maximum items 256.
assignedZonesAssigned ZonesRequired. Array of safe integer; maximum items 256.
suppliedReferenceZonesSupplied Reference ZonesRequired. Array of safe integer; maximum items 256.
Output fieldInterpretationReturned shape
zoneGapsZone GapsRequired. Array of safe integer; maximum items 256.
mismatchesMismatchesRequired. Safe integer.
json
{
  "input": {
    "elementIds": [
      "a",
      "b"
    ],
    "assignedZones": [
      1,
      3
    ],
    "suppliedReferenceZones": [
      1,
      2
    ]
  },
  "output": {
    "zoneGaps": [
      0,
      1
    ],
    "mismatches": 1
  }
}

Limitations and assumptions

  • Zone numbers are supplied ordinal codes; subtracting them does not establish a physical distance or a meaningful interval scale. No zoning scheme, access pattern, or ecological suitability is validated.
  • 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.

Alternative or Complementary methods

Use verified site measurements and suitable physical or resource models for a complete design. Check units, overlap, losses, capacity, and whether an accounting share represents the intended quantity.

References

  1. Calculation and input contract: permaculture/design-zone-reference-gap — tool.io

Similar or alternative tools