{ "model": { "rank": 3024, "code": "thing-q161598", "model_id": "vr.tr.groundwater", "name": "groundwater", "purpose": "Enable an AI agent to recognise groundwater, assess its quantity and quality, and judge proposed abstraction, recharge, protection or remediation against evidence and constraints.", "family": "Thing Registry", "category": "Physical world and living systems", "status": "research-draft", "kind": "thing", "plane": "PHY", "domain": "PHY.MAT", "industry": "", "version": "", "url": "/models/thing/q161598/", "tier": 2, "score": 92, "payload": { "layer": "wikidata", "aliases": [ "alluvial groundwater", "European groundwater", "coastal groundwater", "deep-seated fluid", "deep-seated water", "groundwater under the direct influence of surface water", "unconfined groundwater", "Offshore freshened groundwater", "artesian groundwater", "artificial groundwater", "free water", "confined ground water", "Muan Danmul", "aggressive groundwater", "connate fluids", "phreatic groundwater", "seep", "meteoric water", "Groundwater on Mars", "groundwater depletion" ], "aliasCount": 20, "merged": 20, "knownIn": 92, "facets": null, "markers": [], "lexicalClass": "", "senseRank": null, "alsoRegisteredAs": null, "source": { "dataset": "wikidata", "item": "Q161598", "url": "https://www.wikidata.org/wiki/Q161598", "license": "CC0 1.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-07T14:15:25Z", "providers": [ "Codex", "Grok" ], "missingProviders": [], "pass": 2, "cost": { "grok": { "usd": 0.00218178, "turns": 1, "seconds": 17.9, "error": null }, "codex": { "seconds": 72.1, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.3\n--------\nworkdir: R:\\02_PROJECTS\\02_Meta_Models_Platforms\\Ver.cy\\current\\thing-registry-backlog\nmodel: gpt-6-astra\nprovider: openai\napproval: never\nsandbox: read-only\nreasoning effort: none\nreasoning summaries: none\nsession id: 01a07c38-3457-7bf0-94a4-5ede76b4d0e9\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: groundwater\nRegistry id: vr.tr.groundwater\nPlane / domain: PHY / PHY.MAT\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\nA" } } }, "metaModel": { "id": "THING-Q161598", "registryId": "vr.tr.groundwater", "name": "groundwater", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.MAT" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q161598/", "model": { "registry_id": "vr.tr.groundwater", "name": "groundwater", "purpose": "Enable an AI agent to recognise groundwater, assess its quantity and quality, and judge proposed abstraction, recharge, protection or remediation against evidence and constraints.", "definition": "Groundwater is subsurface water occupying the saturated zone of soil and rock, where all voids are filled and the water is under pressure equal to or greater than atmospheric, and from which wells and springs can be supplied.", "scope_statement": "This model owns water present in saturated subsurface pores and fractures, including its delineation, storage, movement, composition, condition and availability for particular actions; it records relationships to aquifers, surface waters, ecosystems and infrastructure without owning those neighbouring things.", "in_scope": [ "Groundwater occurrence, saturated extent and the basis for delineating a particular body or volume.", "Groundwater levels, hydraulic pressure, storage estimates and changes through time.", "Recharge, discharge and subsurface movement across identified boundaries.", "Groundwater composition, contamination and suitability for specified uses.", "Consequences and constraints of abstraction, managed recharge and remediation." ], "out_of_scope": [ "Aquifer geology and mechanical properties as an independently modelled geological formation.", "Unsaturated soil moisture and subsurface water vapour.", "Rivers, lakes, wetlands and springs as independently modelled surface features.", "Wells, pumps, pipelines and treatment plants as engineered assets.", "Water rights, permits and allocation agreements as legal instruments.", "Dependent organisms and ecosystems as biological entities." ], "distinguishing_features": [ "Determine whether the water occupies saturated subsurface pores or fractures; below-ground location alone does not distinguish groundwater from unsaturated soil moisture.", "Determine whether the subject is the water or its geological host: groundwater can move through an aquifer, while the aquifer denotes the water-bearing formation.", "Distinguish groundwater occurrence from water collected inside a well or pipe; a well observation requires an intake interval and measurement context before it can characterise surrounding groundwater.", "Identify where subsurface water emerges into a spring, stream or other surface feature, and record that interface rather than treating all connected water as groundwater.", "Check for saturation above a local unsaturated interval before assigning perched groundwater to the deeper regional groundwater system." ], "characteristics": [ { "name": "Delineated groundwater extent", "kind": "relation", "unit_or_values": "Three-dimensional extent linked to a coordinate reference system, delineation method, date and uncertainty.", "why_it_matters": "Establishes which water observations and proposed actions belong to the modelled subject." }, { "name": "Groundwater occurrence", "kind": "category", "unit_or_values": "Unconfined, confined, semiconfined, perched, mixed or unresolved, with spatial context.", "why_it_matters": "Supports interpretation of water levels, recharge pathways and responses to pumping." }, { "name": "Hydraulic head", "kind": "measurement", "unit_or_values": "Metres relative to a stated vertical datum, with observation time, intake interval and relevant density correction.", "why_it_matters": "Provides evidence for pressure conditions, hydraulic gradients and temporal change." }, { "name": "Depth to water", "kind": "measurement", "unit_or_values": "Metres below a specified measuring point or land surface, with time and pumping status.", "why_it_matters": "Supports access and trend assessment while distinguishing observed well levels from the water table." }, { "name": "Stored groundwater volume", "kind": "measurement", "unit_or_values": "Cubic metres within a defined extent, distinguishing total storage, storage change and estimated recoverable volume.", "why_it_matters": "Prevents total water present from being equated with water that can responsibly be abstracted." }, { "name": "Recharge and discharge flux", "kind": "measurement", "unit_or_values": "Cubic metres per day or millimetres per year over a specified area, with boundary, period and estimation method.", "why_it_matters": "Supports a water balance and evaluation of changing inputs and losses." }, { "name": "Hydraulic connectivity", "kind": "relation", "unit_or_values": "Connections to other groundwater zones, surface waters or the sea, with direction, timing and evidence.", "why_it_matters": "Identifies where pumping, recharge or contamination may have effects beyond the immediate location." }, { "name": "Water composition", "kind": "measurement", "unit_or_values": "Named analytes with appropriate units, detection limits, sampling depth, date and method; include field parameters where relevant.", "why_it_matters": "Supports identification of chemical condition, contamination and use-specific suitability." }, { "name": "Groundwater condition trend", "kind": "state", "unit_or_values": "Rising, falling, stable, seasonally variable or unresolved for head; improving, deteriorating, stable or unresolved for specified quality indicators.", "why_it_matters": "Distinguishes a single observation from sustained depletion, recovery or quality change." }, { "name": "Use-specific availability", "kind": "state", "unit_or_values": "Supported, conditional, unsupported or undetermined for a named use, location, rate and period.", "why_it_matters": "Separates physical presence from quality, access, ecological and permission constraints." } ], "affordances": [ "Plan and interpret groundwater sampling and level monitoring at specified depths and times.", "Estimate groundwater movement, storage change and water-balance uncertainty.", "Evaluate a proposed abstraction rate and schedule against drawdown, connected-water and quality consequences.", "Assess a managed recharge proposal for hydraulic compatibility, water quality and recoverability.", "Identify protection or remediation actions for a suspected contaminant pathway.", "Define monitoring thresholds that trigger review, reduced pumping or further investigation." ] }, "sources": [ { "id": "usgs-gw", "title": "Groundwater: What is Groundwater?", "url": "https://www.usgs.gov/special-topics/water-science-school/science/groundwater-what-groundwater", "what_it_supports": "Core definition, saturated zone vs soil moisture, unconfined vs confined aquifers", "url_status": "live" } ], "structure": { "bundles": [ { "id": "groundwater-identity-and-extent", "name": "Groundwater identity and extent", "description": "Establishes which saturated subsurface water is being represented and how its boundaries are justified.", "rationale": "An agent must distinguish the water from its host formation and avoid combining hydraulically distinct groundwater occurrences.", "layers": [ { "id": "saturated-occurrence", "name": "Saturated occurrence", "description": "Records the evidence that water occurs in a saturated subsurface zone.", "findings": [ { "id": "occurrence-and-host", "name": "Occurrence and geological host", "description": "Identify the water-bearing interval, host relationship and evidence for confinement or perched conditions.", "questions": [ { "text": "What observations establish saturation in the represented pores or fractures, and over which depth interval?", "kind": "definition", "id": "occurrence-and-host-q01" }, { "text": "What evidence distinguishes unconfined, confined, semiconfined or perched groundwater at this location?", "kind": "provenance", "id": "occurrence-and-host-q02" } ] } ] }, { "id": "groundwater-boundaries", "name": "Groundwater boundaries", "description": "Defines spatial limits and distinguishes physical boundaries from reporting conventions.", "findings": [ { "id": "delineation-and-continuity", "name": "Delineation and hydraulic continuity", "description": "Record the rationale for treating the represented groundwater as one subject and the uncertainty at its edges.", "questions": [ { "text": "Which lateral and vertical limits are supported by hydraulic evidence, and which are administrative or modelling boundaries?", "kind": "boundary", "id": "delineation-and-continuity-q01" }, { "text": "Where might seasonal change or pumping connect, disconnect or shift the represented groundwater extent?", "kind": "boundary", "id": "delineation-and-continuity-q02" } ] } ] } ] }, { "id": "head-storage-and-change", "name": "Head, storage and change", "description": "Represents groundwater pressure, saturated thickness and changes in stored water.", "rationale": "Water levels and storage are related but cannot be treated as interchangeable evidence of available groundwater.", "layers": [ { "id": "level-and-pressure-observations", "name": "Level and pressure observations", "description": "Makes groundwater level measurements interpretable across wells, depths and dates.", "findings": [ { "id": "comparable-head-record", "name": "Comparable hydraulic head record", "description": "Record observation conditions needed to compare groundwater heads and distinguish water-table elevation from pressure head.", "questions": [ { "text": "What head was observed, using which datum, intake interval and time, and was the well pumping or recovering?", "kind": "measurement", "id": "comparable-head-record-q01" }, { "text": "Does the observation represent a water table, confined pressure or a mixed response, and are density effects relevant?", "kind": "definition", "id": "comparable-head-record-q02" } ] } ] }, { "id": "storage-response", "name": "Storage response", "description": "Links observed changes to estimates of groundwater storage and depletion.", "findings": [ { "id": "storage-change-and-recoverability", "name": "Storage change and recoverability", "description": "Distinguish water in storage, inferred changes and water recoverable under explicit constraints.", "questions": [ { "text": "What storage change is inferred over the stated extent and period, using which saturated thickness and host storage properties?", "kind": "measurement", "id": "storage-change-and-recoverability-q01" }, { "text": "What evidence separates seasonal fluctuation from persistent depletion or recovery, and how uncertain is that interpretation?", "kind": "provenance", "id": "storage-change-and-recoverability-q02" } ] } ] } ] }, { "id": "recharge-flow-and-discharge", "name": "Recharge, flow and discharge", "description": "Tracks how groundwater is replenished, moves and leaves the represented extent.", "rationale": "Actions depend on replenishment times, flow pathways and exchanges with connected waters, not merely the presence of water underground.", "layers": [ { "id": "groundwater-water-balance", "name": "Groundwater water balance", "description": "Records inputs, outputs and the degree to which they explain storage change.", "findings": [ { "id": "replenishment-and-losses", "name": "Replenishment and losses", "description": "Account for recharge, boundary flows, abstraction and natural discharge without double counting.", "questions": [ { "text": "What recharge, lateral inflow, discharge and abstraction estimates apply to the same boundary and accounting period?", "kind": "measurement", "id": "replenishment-and-losses-q01" }, { "text": "How well do those estimates explain storage change, and which unmeasured flows or time lags could explain the residual?", "kind": "provenance", "id": "replenishment-and-losses-q02" } ] } ] }, { "id": "flow-paths-and-exchanges", "name": "Flow paths and exchanges", "description": "Represents movement within groundwater and across interfaces with other waters.", "findings": [ { "id": "connectivity-direction-and-travel-time", "name": "Connectivity, direction and travel time", "description": "Identify supported flow connections and distinguish inferred pathways from observed exchanges.", "questions": [ { "text": "Which head gradients, tracer observations or other evidence support the inferred flow directions and travel times?", "kind": "provenance", "id": "connectivity-direction-and-travel-time-q01" }, { "text": "Where does groundwater exchange with streams, wetlands, adjacent groundwater or the sea, and can exchange direction reverse?", "kind": "boundary", "id": "connectivity-direction-and-travel-time-q02" } ] } ] } ] }, { "id": "groundwater-quality-and-transport", "name": "Groundwater quality and transport", "description": "Characterises groundwater composition and the movement or transformation of undesirable constituents.", "rationale": "Groundwater quantity alone cannot establish usability, and a sample from one depth or location may not represent the water affected by an action.", "layers": [ { "id": "composition-and-sampling", "name": "Composition and sampling", "description": "Connects chemical and biological observations to their sampling context.", "findings": [ { "id": "representative-quality-evidence", "name": "Representative quality evidence", "description": "Record measured constituents, analytical limitations and the groundwater interval represented by each sample.", "questions": [ { "text": "Which constituents and field parameters were measured, at what depth and time, with which units and detection limits?", "kind": "measurement", "id": "representative-quality-evidence-q01" }, { "text": "How do well construction, purging, preservation and quality controls affect whether the sample represents the target groundwater?", "kind": "provenance", "id": "representative-quality-evidence-q02" } ] } ] }, { "id": "contaminant-and-salinity-dynamics", "name": "Contaminant and salinity dynamics", "description": "Records the extent, causes and potential evolution of groundwater quality problems.", "findings": [ { "id": "quality-change-pathways", "name": "Quality change pathways", "description": "Distinguish observed quality patterns from hypotheses about sources, transport and transformation.", "questions": [ { "text": "What evidence delineates a contaminant plume or salinity front and distinguishes background composition from introduced contamination?", "kind": "boundary", "id": "quality-change-pathways-q01" }, { "text": "How could pumping, recharge or altered geochemical conditions change contaminant movement, mobilisation or persistence?", "kind": "action", "id": "quality-change-pathways-q02" } ] } ] } ] }, { "id": "groundwater-actions-and-limits", "name": "Groundwater actions and limits", "description": "Connects proposed uses and interventions to their consequences, permissions and operating limits.", "rationale": "An agent needs an explicit basis for deciding whether a particular groundwater action is supported and when that decision must be revisited.", "layers": [ { "id": "use-and-intervention-feasibility", "name": "Use and intervention feasibility", "description": "Evaluates a defined abstraction, recharge or remediation proposal.", "findings": [ { "id": "proposal-specific-availability", "name": "Proposal-specific availability", "description": "Assess water availability for a stated action using hydraulic evidence, quality requirements and linked permissions.", "questions": [ { "text": "What location, intake or injection interval, rate, duration and intended use define the proposal, and what evidence supports its feasibility?", "kind": "action", "id": "proposal-specific-availability-q01" }, { "text": "Which use-specific quality criteria, treatment needs, access rights and permissions constrain the proposal, and where are those requirements recorded?", "kind": "action", "id": "proposal-specific-availability-q02" } ] } ] }, { "id": "connected-effects-and-operating-triggers", "name": "Connected effects and operating triggers", "description": "Evaluates consequences beyond the abstraction or recharge point and defines responses to observed change.", "findings": [ { "id": "impact-limits-and-response", "name": "Impact limits and response", "description": "Link potential groundwater changes to affected receptors and evidence-based operating triggers.", "questions": [ { "text": "What effects are supported or plausible for neighbouring wells, spring or stream discharge, groundwater-dependent ecosystems, subsidence and saline intrusion?", "kind": "action", "id": "impact-limits-and-response-q01" }, { "text": "Which monitored thresholds, observation locations and review periods trigger reduced abstraction, stopped recharge or revised remediation, and who can act?", "kind": "action", "id": "impact-limits-and-response-q02" } ] } ] } ] }, { "id": "evidence-and-external-alignment", "name": "Evidence and external alignment", "description": "What the world already says about this thing, gathered so the model can be checked against it.", "rationale": "A model that cannot be lined up against existing standards, identifiers and practice cannot be adopted by anyone who already uses them.", "layers": [ { "id": "reported-evidence", "name": "Reported evidence", "description": "Findings from the breadth pass, kept separate from the structural claims.", "findings": [ { "id": "evidence-kinds", "name": "Kinds and varieties", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "unconfined (phreatic) aquifer water", "confined (artesian) aquifer water", "perched groundwater", "fossil / paleowater", "brackish and saline groundwater", "karst groundwater", "alluvial / unconsolidated-aquifer groundwater", "thermal / geothermal groundwater" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of groundwater this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-identifiers", "name": "Identifiers and schemes", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "scheme": "Wikidata", "value_or_pattern": "Q161598", "note": "item for groundwater" } ], "questions": [ { "id": "evidence-identifiers-q01", "text": "Which of these identifiers and schemes hold for the sense of groundwater this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-standards-and-regulation", "name": "Standards and regulation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "ISO 6107 (water quality vocabulary, ISO)", "EU Water Framework Directive 2000/60/EC and Groundwater Directive 2006/118/EC" ], "questions": [ { "id": "evidence-standards-and-regulation-q01", "text": "Which of these standards and regulation hold for the sense of groundwater this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-real-world-use", "name": "Real-world use", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "drinking-water supply from wells and springs", "irrigation", "industrial process water", "baseflow to rivers and wetlands" ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of groundwater this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-measurements", "name": "Typical measurements", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "quantity": "water-table / potentiometric head", "typical_range": "0-200 m below ground (highly site-specific)", "unit": "m" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of groundwater this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-failure-modes-and-hazards", "name": "Failure modes and hazards", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "over-abstraction and declining water tables", "saltwater intrusion in coastal aquifers", "nitrate and other contaminant plumes", "land subsidence from compaction of aquifers" ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of groundwater this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-regional-variation", "name": "Regional variation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "US/UK 'groundwater' vs some engineering usage of 'ground water' as two words", "arid regions treat fossil groundwater as a non-renewable stock" ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of groundwater this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-neighbours", "name": "Neighbouring kinds and how to tell them apart", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "name": "soil moisture / vadose-zone water", "difference": "vadose-zone water occupies unsaturated pores above the water table; groundwater occupies the saturated zone" } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of groundwater this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Does an existing Vercy world model already own groundwater or subsurface water, requiring this registry entry to link to it?", "What instance granularity should be authoritative: a hydraulically delineated groundwater body, a management unit or a bounded water volume?", "How should the model represent saturated capillary-fringe water and transitions between perched, seasonal and regional saturation?", "What minimum spatial coverage, monitoring duration and uncertainty evidence are needed before groundwater state or action feasibility can be judged?", "Which local uses, connected receptors and jurisdiction-specific requirements must be researched before action limits can be established?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 18, "questions": 28 } }, "draft": { "generator": "vr.draft.v3", "status": "draft-generated", "researched": false, "archetype": "chemical substance or material", "method": "Written from the archetype playbook - what this kind of thing needs beyond identity and provenance - and from the structure that recurred across 6,333 models already researched by two engines. Applied to this entry by rule. No source was read for this thing and no claim here is researched. This entry carries no facets of its own, so they were inferred from its domain - a guess about a whole domain applied to one thing.", "facetsInferred": true, "nextPass": "A researcher replaces this draft with a sourced specification. Treat every sentence below as a proposal to argue with.", "purpose": "Give an agent a durable, checkable way to recognise a groundwater, record what state it is in, and decide what may be done with it.", "whatItIs": "Enable an AI agent to recognise groundwater, assess its quantity and quality, and judge proposed abstraction, recharge, protection or remediation against evidence and constraints.", "characteristics": { "substance": "material", "origin": "natural", "agency": "inert", "mobility": "varies" }, "whatYouCanDoWithIt": [ "observed and measured", "consumed or used up" ], "distinguishingFeatures": [ "Names folded into this entry, which a task may need to split apart again: alluvial groundwater, European groundwater, coastal groundwater, deep-seated fluid, deep-seated water, groundwater under the direct influence of surface water, unconfined groundwater, Offshore freshened groundwater, artesian groundwater, artificial groundwater, free water, confined ground water.", "20 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it.", "Described in 92 Wikipedia languages, which is a measure of how widely the thing is known, not of how important it is." ], "openQuestionsForResearch": [ "Which of the bundles below does a real task actually need, and which are ceremony?", "What does this thing have that the facets do not capture at all?", "Which neighbouring kind is most often confused with a groundwater, and on what evidence are they told apart?" ], "whatItIsMadeOf": "matter you can touch", "physicalCharacter": [ "Mobility varies between examples.", "Does nothing on its own; everything it does, something else did to it.", "These come from the domain this entry sits in rather than from the entry itself, so treat them as a first guess about the whole domain applied to one thing." ], "whatCanBeDoneWithIt": [ "observe it, measure it, record its state", "use it up, and then need more of it" ], "howItIsRecognised": [ "Not recognisable by sight in any reliable way. Appearance varies with grade, form and additives; identification is by label, by documentation, or by assay." ], "relatedModels": [ { "relation": "covers", "note": "Finer kinds folded into this entry because telling them apart needs a task that asks for it. Each is a model waiting to be split out when one does.", "targets": [ "alluvial groundwater", "European groundwater", "coastal groundwater", "deep-seated fluid", "deep-seated water", "groundwater under the direct influence of surface water", "unconfined groundwater", "Offshore freshened groundwater", "artesian groundwater", "artificial groundwater", "free water", "confined ground water" ] } ], "standing": "Described in 92 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is. 20 finer distinctions are held inside this entry as names rather than as separate models.", "structure": { "bundles": [ { "id": "identity-and-classification", "name": "Identity, naming and classification", "description": "How an agent tells one groundwater from another, and a groundwater from things that resemble it.", "rationale": "Recognition comes before every other claim. Without stable identity nothing else in the model can be trusted to be about the same thing twice.", "layers": [ { "id": "naming-and-identifiers", "name": "Names and identifiers", "description": "The names this thing goes by and the identifiers that survive translation and time.", "findings": [ { "id": "preferred-name-and-aliases", "name": "Preferred name, aliases and local names", "description": "Which name to use, which names mean the same thing, and which merely sound similar.", "questions": [ { "id": "preferred-name-and-aliases-q01", "text": "What identifies and describes the name of a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "preferred-name-and-aliases-q02", "text": "Who or what asserted this about the name of a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "preferred-name-and-aliases-q03", "text": "What may an agent decide or do once the name of a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] }, { "id": "stable-identifiers", "name": "Stable identifiers and external keys", "description": "Identifiers that keep pointing at this kind of thing across systems and languages.", "questions": [ { "id": "stable-identifiers-q01", "text": "What identifies and describes an identifier for a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "stable-identifiers-q02", "text": "Who or what asserted this about an identifier for a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "stable-identifiers-q03", "text": "What may an agent decide or do once an identifier for a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "classification-and-granularity", "name": "Classification and granularity", "description": "Where a groundwater sits among kinds, and how finely a task needs to cut it.", "findings": [ { "id": "kind-and-parents", "name": "Kind, parents and neighbouring kinds", "description": "The classes this thing belongs to and the ones it is next to.", "questions": [ { "id": "kind-and-parents-q01", "text": "What identifies and describes the kind of a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "kind-and-parents-q02", "text": "Who or what asserted this about the kind of a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "kind-and-parents-q03", "text": "What may an agent decide or do once the kind of a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] }, { "id": "distinguishing-features", "name": "Distinguishing features", "description": "What separates a groundwater from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "distinguishing-features-q02", "text": "Who or what asserted this about what distinguishes a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "distinguishing-features-q03", "text": "What may an agent decide or do once what distinguishes a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "form-and-composition", "name": "Form, composition and condition", "description": "What a groundwater is made of, what shape and size it takes, and what state it is in.", "rationale": "A physical thing can be measured, and a model that cannot record its measurements cannot support any decision that depends on them.", "layers": [ { "id": "form-and-dimensions", "name": "Form and dimensions", "description": "Shape, size, mass and the ranges these take across examples.", "findings": [ { "id": "measurable-dimensions", "name": "Measurable dimensions and their units", "description": "The quantities worth recording and the units they are recorded in.", "questions": [ { "id": "measurable-dimensions-q01", "text": "What identifies and describes the dimensions of a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "measurable-dimensions-q02", "text": "Who or what asserted this about the dimensions of a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "measurable-dimensions-q03", "text": "What may an agent decide or do once the dimensions of a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "material-and-composition", "name": "Material and composition", "description": "Materials, parts and how they are put together.", "findings": [ { "id": "parts-and-materials", "name": "Parts and materials", "description": "What a groundwater is built from and which parts are replaceable.", "questions": [ { "id": "parts-and-materials-q01", "text": "What identifies and describes the composition of a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "parts-and-materials-q02", "text": "Who or what asserted this about the composition of a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "parts-and-materials-q03", "text": "What may an agent decide or do once the composition of a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "condition-and-integrity", "name": "Condition and integrity", "description": "Wear, damage, health and the difference between working and broken.", "findings": [ { "id": "condition-assessment", "name": "Condition, damage and health", "description": "How the condition of a groundwater is judged and by whom.", "questions": [ { "id": "condition-assessment-q01", "text": "What identifies and describes the condition of a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "condition-assessment-q02", "text": "Who or what asserted this about the condition of a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "condition-assessment-q03", "text": "What may an agent decide or do once the condition of a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "place-and-movement", "name": "Place and movement", "description": "Where a groundwater is, how it got there and where it may go (varies).", "rationale": "A thing that can move needs its position recorded with a time, or every later claim about it is about a place it has left.", "layers": [ { "id": "location-and-placement", "name": "Location and placement", "description": "Position, containment and the reference frame the position is given in.", "findings": [ { "id": "position-and-frame", "name": "Position, container and reference frame", "description": "Where a groundwater is, and what that position is measured against.", "questions": [ { "id": "position-and-frame-q01", "text": "What identifies and describes the location of a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "position-and-frame-q02", "text": "Who or what asserted this about the location of a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "position-and-frame-q03", "text": "What may an agent decide or do once the location of a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "movement-and-transfer", "name": "Movement and transfer", "description": "How a groundwater is carried, installed or relocated.", "findings": [ { "id": "movement-events", "name": "Movement events and constraints", "description": "What counts as a movement, what records it and what limits it.", "questions": [ { "id": "movement-events-q01", "text": "What identifies and describes the movement of a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "movement-events-q02", "text": "Who or what asserted this about the movement of a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "movement-events-q03", "text": "What may an agent decide or do once the movement of a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "state-and-lifecycle", "name": "State and lifecycle", "description": "The states a groundwater passes through and the events that move it between them.", "rationale": "Most decisions about a thing depend on what state it is in now, which is a claim with a time on it, not a property.", "layers": [ { "id": "lifecycle-stages", "name": "Lifecycle stages", "description": "From coming into existence to ceasing to be one of these.", "findings": [ { "id": "stages-and-transitions", "name": "Stages and transitions", "description": "The stages worth naming and what moves a groundwater between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "stages-and-transitions-q02", "text": "Who or what asserted this about the lifecycle of a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "stages-and-transitions-q03", "text": "What may an agent decide or do once the lifecycle of a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "observations-and-status", "name": "Observations and current status", "description": "What is observed about a groundwater, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a groundwater is recorded so that it can be superseded rather than overwritten.", "questions": [ { "id": "observation-record-q01", "text": "What identifies and describes an observation of a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "observation-record-q02", "text": "Who or what asserted this about an observation of a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "observation-record-q03", "text": "What may an agent decide or do once an observation of a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "use-and-operation", "name": "Use and operation", "description": "What can be done with a groundwater and what it takes to do it.", "rationale": "An agent that can recognise a thing but not act on it has only half a model.", "layers": [ { "id": "intended-use", "name": "Intended use and function", "description": "What a groundwater is for, and what it is used for anyway.", "findings": [ { "id": "function-and-purpose", "name": "Function, purpose and misuse", "description": "The function a groundwater performs and the uses that fall outside it.", "questions": [ { "id": "function-and-purpose-q01", "text": "What identifies and describes the use of a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "function-and-purpose-q02", "text": "Who or what asserted this about the use of a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "function-and-purpose-q03", "text": "What may an agent decide or do once the use of a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "handling-and-procedure", "name": "Handling and procedure", "description": "The steps, skills and tools involved in using a groundwater.", "findings": [ { "id": "procedures-and-skills", "name": "Procedures, skills and required tools", "description": "What an agent needs before it can act on a groundwater at all.", "questions": [ { "id": "procedures-and-skills-q01", "text": "What identifies and describes handling a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "procedures-and-skills-q02", "text": "Who or what asserted this about handling a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "procedures-and-skills-q03", "text": "What may an agent decide or do once handling a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "supply-and-consumption", "name": "Supply and consumption", "description": "Quantities, rates and what running out means.", "findings": [ { "id": "consumption-and-stock", "name": "Consumption, stock and replenishment", "description": "How much of a groundwater there is and how fast it goes.", "questions": [ { "id": "consumption-and-stock-q01", "text": "What identifies and describes the supply of a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "consumption-and-stock-q02", "text": "Who or what asserted this about the supply of a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "consumption-and-stock-q03", "text": "What may an agent decide or do once the supply of a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "composition-and-identity", "name": "Composition, grade and chemical identity", "description": "What groundwater is made of and how pure the thing in hand is.", "rationale": "Grade decides what a substance may be used for, so a model that records only the name cannot support any decision about use.", "layers": [ { "id": "chemical-identity", "name": "Chemical identity", "description": "Formula, structure and the registry numbers that name it unambiguously.", "findings": [ { "id": "identity-record", "name": "Identity and registry numbers", "description": "What identifies this substance across suppliers and regulators.", "questions": [ { "id": "identity-record-q01", "text": "What formula, structure and registry identifiers name groundwater unambiguously?", "kind": "definition" }, { "id": "identity-record-q02", "text": "Which related substances share a name in common use but not an identifier?", "kind": "boundary" } ] } ] }, { "id": "grade-and-impurities", "name": "Grade, purity and impurities", "description": "The specification a batch meets and what else is in it.", "findings": [ { "id": "specification", "name": "Specification and assay", "description": "How purity is stated and measured, and which impurities matter.", "questions": [ { "id": "specification-q01", "text": "What grades of groundwater exist, how is purity assayed, and which impurities are limited?", "kind": "measurement" }, { "id": "specification-q02", "text": "Which use requires which grade, and what happens when a lower grade is substituted?", "kind": "action" } ] } ] } ] }, { "id": "properties-and-behaviour", "name": "Properties and behaviour", "description": "How groundwater behaves under conditions an agent can measure or change.", "rationale": "Physical constants are the part of a substance model that transfers between contexts, and each needs its unit and its conditions.", "layers": [ { "id": "physical-constants", "name": "Physical constants", "description": "Values that hold for the pure substance, with their conditions.", "findings": [ { "id": "constants-record", "name": "Constants and conditions", "description": "The quantities worth recording and the state they apply in.", "questions": [ { "id": "constants-record-q01", "text": "What are the defining physical constants of groundwater, in what units and under what conditions?", "kind": "measurement" }, { "id": "constants-record-q02", "text": "Which of these values change with grade or form rather than being fixed?", "kind": "boundary" } ] } ] }, { "id": "stability-and-reactivity", "name": "Stability and reactivity", "description": "What it reacts with, degrades into, and how it is stored.", "findings": [ { "id": "incompatibilities", "name": "Incompatibilities and degradation", "description": "What must not meet it, and what it becomes over time.", "questions": [ { "id": "incompatibilities-q01", "text": "What is groundwater incompatible with, and what does it degrade into under storage?", "kind": "definition" }, { "id": "incompatibilities-q02", "text": "What storage and handling does that require, and who is competent to do it?", "kind": "action" } ] } ] } ] }, { "id": "hazard-and-regulation", "name": "Hazard classification and regulation", "description": "How groundwater can harm, and what the law says about holding and moving it.", "rationale": "A substance model without its hazard class and its regulatory identity is unusable in exactly the situations that matter.", "layers": [ { "id": "hazard-class", "name": "Hazard classification", "description": "Classified hazards, exposure limits and protective measures.", "findings": [ { "id": "classified-hazards", "name": "Classified hazards and limits", "description": "The classification, the scheme it belongs to, and the limits set.", "questions": [ { "id": "classified-hazards-q01", "text": "How is groundwater classified for hazard, under which scheme, and what exposure limits apply?", "kind": "definition" }, { "id": "classified-hazards-q02", "text": "What protection does handling require, and what must an agent refuse to do without it?", "kind": "action" } ] } ] }, { "id": "regulatory-identity", "name": "Regulatory identity and control", "description": "Registration, restriction and transport rules by jurisdiction.", "findings": [ { "id": "controls", "name": "Controls and jurisdiction", "description": "Where it is restricted and what the restriction attaches to.", "questions": [ { "id": "controls-q01", "text": "Which registrations, restrictions or transport rules cover groundwater, and where?", "kind": "provenance" }, { "id": "controls-q02", "text": "Does the control attach to the substance, its concentration, or its intended use?", "kind": "boundary" } ] } ] } ] }, { "id": "provenance-and-evidence", "name": "Provenance, evidence and time", "description": "Where every claim about a groundwater came from and when it held.", "rationale": "A claim without a source and a time cannot be superseded, only overwritten, and an agent that overwrites loses the ability to explain itself.", "layers": [ { "id": "source-and-authority", "name": "Source and authority", "description": "Who said it, on what evidence, and how strongly.", "findings": [ { "id": "claim-provenance", "name": "Claim provenance and confidence", "description": "The authority behind each claim about a groundwater and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "claim-provenance-q02", "text": "Who or what asserted this about a claim about a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "claim-provenance-q03", "text": "What may an agent decide or do once a claim about a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "time-and-versions", "name": "Time, versions and supersession", "description": "When a claim was true, when it was learnt, and what replaced it.", "findings": [ { "id": "validity-and-supersession", "name": "Validity period and supersession", "description": "How an old claim about a groundwater is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a groundwater, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "validity-and-supersession-q02", "text": "Who or what asserted this about the validity of a claim about a groundwater, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "validity-and-supersession-q03", "text": "What may an agent decide or do once the validity of a claim about a groundwater is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] } ] }, "statistics": { "bundles": 9, "layers": 20, "findings": 22, "questions": 60 } } } }