OneAquaHealth Project, published by OneAquaHealth Project. This guide is not an authorized publication; it is the continuous build for version 0.1.0-ci-build built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-eu/oah/ and changes regularly. See the Directory of published versions
Logical Models
This page summarizes the logical models defined in input/fsh/model-maps. Each entry lists the intent of the model and the main data elements captured for interoperability across the Implementation Guide.
DataSet (OAH Data Set Model)
DataSet logical model
Captures the metadata for a OneAquaHealth data set, including stewardship and access details.
- Identifiers and naming: globally unique persistent identifier (
pid), title, description, version, type.
- Stewardship:
contact, publisher, author, date, dateOfApproval, dateOfReview, plus licence and copyright.
- Size and composition: overall
size, numberOfRecords, and repeating record entries with title, format, link, and size.
IndicatorsOah (OAH Indicators)
IndicatorsOah logical model
Organizes the collections of indicators used across the project, grouped by theme.
- Biological quality: macroinvertebrates, diatoms, fish, macrophytes, riparian vegetation, microbiomes, microbial diversity, pathogens, and antibiotic resistance genes (ARGs).
- Microbial diversity: richness, Shannon and Simpson diversity, Pielou evenness, and beta diversity of microbial communities, derived from environmental DNA (16S/18S rRNA marker genes or shotgun metagenomics).
- Pathogens: presence/absence or abundance of specific pathogens (culture, qPCR, metagenomics/metabarcoding), relative abundance of pathogenic taxa, and an infectious health risk index (0 to 1) combining pathogen richness, abundance, and severity.
- Antibiotic resistance genes: resistance genes quantified by qPCR or metagenomics, expressed as gene copies per volume of water or as relative abundance.
- Hydromorphological quality: morphology, hydrology, and land use aspects that influence habitat and connectivity.
- Water quality: nutrients, pH, dissolved oxygen, temperature, dissolved/suspended solids, conductivity, pharmaceuticals, foam/colour/smell, and coliforms.
- Biological indicators of health risks: diptera, ticks, invasive organisms, birds, diatom teratology, fish, and amphibians.
- Remote sensing indices: chlorophyll and vegetation/water indices for aquatic/riparian assessment (e.g., NDCI, MCI, NDVI/mNDVI, NDWI/MNDWI/ANDWI, SAVI/TSAVI), moisture/temperature measures (LWCI, GVMI, LST), and urban/built-up indices (BLFEI, BRBA, NBAI, IBI, EBBI, PISI, UI, VIBI).
HealthIndicators (OAH Health Indicators)
HealthIndicators logical model
Captures health and wellness prevalence indicators for a population.
- Disease prevalence grouping with individual indicators recorded as percentages per district.
- Cardiometabolic indicators: high blood pressure, hypertension treatment, obesity, high cholesterol (>=190/240 mg/dl), diabetes and treatment, CVD.
- Lifestyle and wellbeing indicators: no physical activity, long-term disease presence/absence, BMI bands, mental health issues.
- Infectious disease prevalence examples: Borrelia burgdorferi, Campylobacter, Chlamydia psittaci, Cryptosporidium, Entamoeba histolytica, Escherichia coli, Giardia, Salmonella, Yersinia enterocolitica.
Sample (SampleOah)
Sample logical model
Describes the sampling site and event supporting an indicator.
- Site context: one or more
identifier and name values, optional gps, free-text characteristics, and formReference to supporting documentation.
- Sampling event: mandatory
dateOfSampling and optional performer (organization or practitioner role) information.
SimpleIndicator (SimpleIndicatorOah)
SimpleIndicator logical model
Represents an indicator with a single value.
- Links to the associated
sampleDetails.
- Captures
type of measurement, one or more date values, performer, and a single result (codeable concept or quantity).
StructuredIndicator (StructuredIndicatorOah)
StructuredIndicator logical model
Represents an indicator composed of multiple components.
- Links to the associated
sampleDetails.
- Captures
type of measurement, one or more date values, and performer.
- Includes repeating
component entries, each with its own type and result (codeable concept, quantity, or string).
HealthMeasure (OAH Health Measure)
HealthMeasure logical model
Defines a single health and wellness measurement with shared context.
- Site details: identifiers, name, optional GPS, and site characteristics.
- Measurement timing: required
dateOrPeriod[x].
- Who performed it: optional
performer[x] (practitioner role or organization).
- What is measured and the result:
type and result[x] (codeable concept or quantity).
- Cohort: required group describing the population measured.