Skip to content

Projects & Experiments

Projects

A Project is an OAE field trial, modeling effort or research initiative: who is doing the work, where and when. A metadata file has exactly one project, and every experiment and dataset in it carries that project's project_id.

Experiments

An Experiment is one activity within a project, such as a baseline monitoring phase followed by an intervention. Each dataset names the experiment it came from with experiment_id.

Experiment Types

graph TD
    E[Experiment] --> ISE[InSituExperiment]
    E --> M[Model]
    ISE --> I[Intervention]
    ISE --> T[Tracer]
    ISE --> IWT[InterventionWithTracer]

    style E fill:#e8f4f8
    style M fill:#f0e8f8
    style I fill:#e8f8e8
    style T fill:#e8f8e8
    style IWT fill:#e8f8e8
Type Schema Class When to Use
Baseline InSituExperiment Pre-intervention monitoring
Control InSituExperiment Reference measurements without intervention
Intervention Intervention Active alkalinity addition
Tracer Study Tracer Dye or gas tracer deployment
Intervention + Tracer InterventionWithTracer Combined intervention with tracer (same dosing mechanism)
Model Model Computational simulation
Other InSituExperiment Experiment type not covered above

When to use Intervention + Tracer

Only use the combined type when the alkalinity dosing and tracer dosing share the same underlying dosing mechanism or regimen. If they use separate delivery systems or schedules, create two separate experiments — one Intervention and one Tracer Study.

Combining Types

experiment_types can hold several values, and the combination decides which class describes the experiment:

  • Intervention and Tracer Study together use InterventionWithTracer, which has the fields of both. See the note above on when to combine them.
  • Model experiments use Model, which has none of the in-situ fields. Describe field work and modeling as separate experiments.
  • Baseline, Control and Other on their own use InSituExperiment.