Description
Convert aligned nonnegative energyInputs with positive sourceFactors, sum commonEnergy, subtract creditedExports for netEnergy, and return referenceGap=netEnergy-referenceEnergy.
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.
Convert aligned nonnegative energyInputs with positive sourceFactors, sum commonEnergy, subtract creditedExports for netEnergy, and return referenceGap=netEnergy-referenceEnergy.
When to use this tool
Use Farm Energy Reference 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
- Enter energyInputs, sourceFactors, referenceEnergy, creditedExports. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read commonEnergy, netEnergy, referenceGap. Use the output convention below.
Convert aligned nonnegative energyInputs with positive sourceFactors, sum commonEnergy, subtract creditedExports for netEnergy, and return referenceGap=netEnergy-referenceEnergy.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| energyInputs | Energy Inputs | Required. Array of finite number; minimum 0; maximum items 256. |
| sourceFactors | Source Factors | Required. Array of finite number; maximum items 256. |
| referenceEnergy | Reference Energy | Required. Finite number. |
| creditedExports | Credited Exports | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| commonEnergy | Common Energy | Required. Finite number. |
| netEnergy | Net Energy | Required. Finite number. |
| referenceGap | Reference Gap | Required. Finite number. |
{
"input": {
"energyInputs": [
2,
3
],
"sourceFactors": [
4,
2
],
"referenceEnergy": 10,
"creditedExports": 1
},
"output": {
"commonEnergy": 14,
"netEnergy": 13,
"referenceGap": 3
}
}Limitations and assumptions
- Factors must convert every input into one target energy unit. Export credits and reference are supplied; negative net energy is allowed and does not establish energy autonomy or environmental benefit.
- 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
Similar or alternative tools
- Farm Biomass Energy Moisturebasis Gap
Calculate dryEnergy=wetMass*(1-moisture)*dryEnergyPerMass and netEnergy=wetMass*((1-moisture)*dryEnergyPerMass-moisture*suppliedEvaporationPenalty).
- Farm Energy Boundary Term
Sum supplied energy ledger terms under explicit boundaries and signed flow conventions.