Skip to content

Main content

Urban Plot Usable Area Gap Tool

Audit explicitly disjoint excluded plot areas without parcel or access-right inference.

Loading tool…

Description

Audit explicitly disjoint excluded plot areas without parcel or access-right inference.

A farm or garden budget depends on a common area, quantity, observation period, and system boundary. Recovery, exclusions, overlap, and allocation change how a share is calculated. Supplied accounting or geometry terms remain separate from measured crop performance and verified environmental outcomes.

Audit explicitly disjoint excluded plot areas without parcel or access-right inference.

When to use this tool

Use Urban Plot Usable Area Gap when you need a clearly bounded area, material, resource, energy, or allocation term for supplied garden or farm records.

How to use the tool and how it works

  1. Enter grossArea, excludedAreas, reportedUsable. 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 calculatedUsable, residual. Use the output convention below.

Subtract nonnegative excludedAreas from grossArea for calculatedUsable, then return residual=reportedUsable-calculatedUsable. Require nonnegative reported area and exclusions totaling no more than gross.1

Input fieldMeaning and unitsAccepted input
grossAreaGross AreaRequired. Finite number; minimum 0.
excludedAreasExcluded AreasRequired. Array of finite number; minimum 0; maximum items 256.
reportedUsableReported UsableRequired. Finite number; minimum 0.
Output fieldInterpretationReturned shape
calculatedUsableCalculated UsableRequired. Finite number.
residualSigned discrepancy under the formula stated above.Required. Finite number.
json
{
  "input": {
    "grossArea": 100,
    "excludedAreas": [
      10,
      20
    ],
    "reportedUsable": 65
  },
  "output": {
    "calculatedUsable": 70,
    "residual": -5
  }
}

Limitations and assumptions

  • Exclusions must not double count overlapping areas. The tool does not measure a plot, validate a reporting standard, or determine which exclusions should apply.
  • The field tables state structural bounds; the mechanics also specify cross-field constraints. Malformed inputs and unsupported domains cause errors. A successful false flag, empty branch value, or zero placeholder has the meaning stated above and is distinct from an input error.
  • 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. Signed zero is exported as zero.

Alternative or Complementary methods

Verify the system boundary, units, and source records before combining this term into a resource or environmental report. Physical design and crop-performance questions require appropriate measurements and a broader model.

References

  1. Calculation and input contract: urban-agriculture/urban-plot-usable-area-gap — tool.io

Similar or alternative tools