{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.acre-foot","code":"thing-acre-foot","url":"https://ver.cy/models/thing/acre-foot/","name":"acre-foot","alternateNames":[],"kind":"thing","status":"published","version":"0.2.0-wave.3","language":"en","classifiers":{"family":"Thing Registry","category":"Cross-cutting context","entryKind":"noun.quantity","plane":"XCT","domain":["XCT.QTY"],"industry":[],"navPath":"","tags":[],"facets":{"substance":"abstract","origin":"conceptual","agency":"inert","mobility":"not-applicable","scale":"not-applicable","affordances":["observable"]}},"whatItIs":"A unit of volume equal to the volume of water that would cover one acre to a depth of one foot, 43560 cubic feet, about 1233.5 cubic metres or 325851 US gallons, used in the United States for reservoir storage, river flows, water rights and municipal and agricultural water supply, often stated as roughly the annual water use of one or two households.","purpose":"Let an agent explain the acre-foot and its definition, relay conversions and uses in water management and water rights from hydrology references, and distinguish it from the acre-inch, cubic metre, megalitre and flow units.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Depth over area","Water management unit","US usage","Household scale reference"],"structure":{"bundles":[{"id":"understand","name":"Understand","description":"What an acre-foot is.","layers":[{"id":"definition","name":"Definition","description":"Definition.","findings":[{"id":"definition-finding","name":"Definition","description":"Definition.","questions":[{"text":"What is an acre-foot, and how much water is it in everyday terms?","kind":"definition"},{"text":"Is the question about the acre-foot, the acre-inch or a metric unit?","kind":"boundary"}]}]},{"id":"conversion","name":"Conversion","description":"Conversion.","findings":[{"id":"conversion-finding","name":"Conversion","description":"Conversion.","questions":[{"text":"How does the acre-foot convert to cubic metres, gallons and megalitres?","kind":"measurement"},{"text":"Which entry fits cubic metre?","kind":"action"}]}]}]},{"id":"use","name":"Use","description":"Use.","layers":[{"id":"reservoirs","name":"Reservoirs","description":"Reservoirs and rivers.","findings":[{"id":"reservoirs-finding","name":"Reservoirs","description":"Reservoirs.","questions":[{"text":"How are reservoir storage and river flows reported in acre-feet?","kind":"provenance"},{"text":"Which references are standard?","kind":"provenance"}]}]},{"id":"rights","name":"Rights","description":"Water rights.","findings":[{"id":"rights-finding","name":"Rights","description":"Rights.","questions":[{"text":"How are water rights and allocations expressed in acre-feet per year, such as under the Colorado River Compact?","kind":"provenance"},{"text":"Which sources are cited?","kind":"provenance"}]}]}]},{"id":"calculate","name":"Calculate","description":"Calculation.","layers":[{"id":"flow","name":"Flow","description":"Flow and time.","findings":[{"id":"flow-finding","name":"Flow","description":"Flow.","questions":[{"text":"How do acre-feet relate to cubic feet per second over a day or year?","kind":"measurement"},{"text":"Which entry fits cubic foot per second?","kind":"action"}]}]},{"id":"households","name":"Households","description":"Household equivalents.","findings":[{"id":"households-finding","name":"Households","description":"Households.","questions":[{"text":"How many households does an acre-foot supply, and why do estimates vary?","kind":"provenance"},{"text":"Which entry fits water use?","kind":"action"}]}]}]},{"id":"context","name":"Context","description":"Context.","layers":[{"id":"metric","name":"Metric","description":"Metric equivalents.","findings":[{"id":"metric-finding","name":"Metric","description":"Metric.","questions":[{"text":"What metric units serve the same purpose elsewhere?","kind":"provenance"},{"text":"Which entry fits megalitre?","kind":"action"}]}]},{"id":"history","name":"History","description":"History.","findings":[{"id":"history-finding","name":"History","description":"History.","questions":[{"text":"How did the acre-foot become standard in US water management?","kind":"provenance"},{"text":"Which entry fits the history of water management in the United States?","kind":"action"}]}]}]}]},"agentConduct":{"may":["Convert acre feet to cubic metres or gallons with stated factors.","Report reservoir storage and water rights in acre feet from official data."],"mustNot":["Misstate water rights or allocations through unit errors.","Present reservoir volumes without the date and source of the measurement.","Use acre-foot figures to mislead the public about water supply."],"requiresHuman":["Transferring or changing a water right expressed in acre feet."]},"ethics":{"considerations":["Water rights decide who can farm and live in dry regions.","Shortages affect communities and ecosystems unequally."],"affectedParties":["Water rights holders","Municipal water users","River ecosystems"]},"owners":{"steward":"Nobody owns the unit; water rights registers record allocations in it.","roles":[],"masterSystems":["Water rights registers"]},"relations":[{"target":"oewn-13622065-n","type":"parent","note":"registry parent class"},{"target":"unit of volume","type":"related","note":"in general terms"},{"target":"acre-inch","type":"related","note":"times twelve"},{"target":"acre","type":"related","note":"and the foot"},{"target":"water rights","type":"related","note":"in the western United States"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.acre-foot","Open English WordNet: oewn-13638749-n","WordNet: oewn-13622065-n the volume of water that would cover 1 acre to a depth of 1 foot"]},"properties":{"applicability":"not-applicable","items":["value: 43560 cubic feet - exact","value: about 1233.48 cubic metres","value: about 325851 US gallons","Lake Mead capacity: about 26 million acre-feet - full pool"]},"recognition":{"applicability":"optional","items":["One foot of water over one acre","Reservoir storage, water rights, river flows in acre-feet","The acre-inch is one twelfth; the megalitre and cubic metre are metric equivalents","Not a visible object; a unit of volume."]},"capabilities":{"applicability":"required","items":["explain the definition","relay conversions","describe uses in water management","distinguish related units"]},"hazards":{"applicability":"required","items":["Confusing acre-foot with acre-inch","Misstating household equivalents","Non-metric unit unfamiliar outside the US"]},"interfaces":{"applicability":"required","items":["US Bureau of Reclamation and USGS conventions","State water rights law","Interstate compacts such as the Colorado River Compact"]},"context":{"applicability":"required","items":["Measuring large water volumes.","acre-foot in reservoir storage","acre-foot per year in water rights and supply","thousand and million acre-feet for basins","related units acre-inch and megalitre"]}},"sources":[{"title":"Open English WordNet 2024, synset oewn-13638749-n","url":"https://en-word.net/id/oewn-13638749-n","note":"sense and gloss of the concept"},{"title":"Wiktionary: acre-foot","url":"https://en.wiktionary.org/wiki/acre-foot","note":"word senses and usage"}],"openQuestions":["Should water rights be linked as a primary entry?","How should hydrology references be linked?","How should metric equivalents be recorded?"],"resources":{"spec":"/models/things/publications/thing-acre-foot/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-acre-foot/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-13T05:02:28Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"not-applicable","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T12:16:27+00:00: completeness 1.00; sense: WordNet gloss; 2 live sources; review by codex: pass","interaction.properties":"Plane XCT: no invented physical properties."},"score":1.0}}