From f3eb450aee471768e460bab0edcaa6ce5f098755 Mon Sep 17 00:00:00 2001
From: Per Olav Eide Svendsen <peesv@equinor.com>
Date: Mon, 4 Jul 2022 10:49:05 +0200
Subject: [PATCH 1/6] Cleaning

---
 .../examples/aggregated_surface_depth.yml     | 72 +++++++++----------
 schema/definitions/0.8.0/examples/case.yml    | 34 +++------
 .../0.8.0/examples/polygons_field_outline.yml | 36 +++++-----
 .../0.8.0/examples/surface_depth.yml          | 48 +++++--------
 .../0.8.0/examples/surface_fluid_contact.yml  | 28 ++++----
 .../examples/surface_seismic_amplitude.yml    | 41 +++++------
 6 files changed, 114 insertions(+), 145 deletions(-)

diff --git a/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml b/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml
index 01771c6f1..61746b63d 100644
--- a/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml
+++ b/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml
@@ -1,6 +1,6 @@
 $schema: https://main-fmu-schemas-dev.radix.equinor.com/schemas/0.8.0/fmu_results.json
-version: "0.8.0" # including for REP and others to build logic on.
-source: fmu  # always included, and always this value if FMU made it. For quick identification for external consumers.
+version: "0.8.0"
+source: fmu
 
 tracklog:
   - datetime: 2020-10-28T14:28:02
@@ -12,12 +12,9 @@ tracklog:
       id: peesv
     event: updated
 
-class: surface
+class: surface # class is the main identifier of the data type.
 
-# fmu:
-# The fmu block in data objects have more sub-elements compared to ensemble objects.
-
-fmu:
+fmu: # the fmu-block contains information directly related to the FMU context
   model:
     name: ff
     revision: 21.0.0.dev
@@ -28,10 +25,24 @@ fmu:
   workflow:
     reference: rms/structural_model
 
+  case:
+    name: MyCaseName
+    uuid: 8bb56d60-8758-481a-89a4-6bac8561d38e
+    user:
+      id: jriv # $USER from ERT
+    description:
+      - yet other detailed description
+      - optional
+    restart_from: 15ce3b84-766f-4c93-9050-b154861f9100   # fmu.iteration.uuid for another iteration/case
+
+  iteration:
+    id: 0 # always an int, will be 0 for e.g. "pred"
+    uuid: 4b939310-34b1-4179-802c-49460bc0f799 # hash of case.uuid + iteration.id
+    name: "iter-0" # /"pred"
 
-  aggregation: # similar to "realization" for aggregated data
-    operation: mean  # Avoiding "type"
-    realization_ids:  # Avoiding just "realization" to avoid confusion with the "realization" definition above
+  aggregation:
+    operation: mean
+    realization_ids: # a list of realization IDs used for this aggregation
       - 0
       - 1
       - 2
@@ -43,29 +54,17 @@ fmu:
       SENSNAME: faultseal
       SENSCASE: low
       RMS_SEED: 1006
+      INIT_FILES:
+        PERM_FLUVCHAN_E1_NORM: 0.748433
+        PERM_FLUVCHAN_E21_NORM: 0.782068
       KVKH_CHANNEL: 0.6
-      KVKH_CREVASSE: 0.3
-      KVKH_LS: 0.7
       KVKH_US: 0.6
       FAULT_SEAL_SCALING: 0.1
       FWL_CENTRAL: 1677
 
-    id: 15ce3b84-766f-4c93-9050-b154861f9100  # Identifier for identifying common aggregation source
-
-  case:
-    name: MyCaseName
-    uuid: 8bb56d60-8758-481a-89a4-6bac8561d38e # (pseudo-)random valid uuid4
-    user:
-      id: jriv # $USER from ERT
-    description:
-      - yet other detailed description
-      - optional
-    restart_from: 15ce3b84-766f-4c93-9050-b154861f9100   # fmu.iteration.uuid for another iteration/case
-
-  iteration:
-    id: 0 # always an int, will be 0 for e.g. "pred"
-    uuid: 4b939310-34b1-4179-802c-49460bc0f799 # hash of case.uuid + iteration.id
-    name: "iter-0" # /"pred"
+    # the aggregation ID is an identifier for a specific distribution
+    # E.g. "min" and "max" for the same set of input realizations.
+    id: 15ce3b84-766f-4c93-9050-b154861f9100
 
 file:
   relative_path: iter-0/share/results/maps/volantis_gp_base--amplitude--mean.gri # case-relative
@@ -74,6 +73,8 @@ file:
 
 data: # The data block describes the actual data (e.g. surface). Only present in data objects
 
+  content: depth   # white-listed and standardized
+
   # if stratigraphic, name must match the strat column. This is the official name of this surface.
   name: volantis_top-volantis_base
   stratigraphic: false  # if true, this is a stratigraphic surface found in the strat column
@@ -88,17 +89,12 @@ data: # The data block describes the actual data (e.g. surface). Only present in
     stratigraphic: true
     offset: 8.3
 
-  stratigraphic_alias: # other stratigraphic entities this corresponds to in the strat column, e.g. Top Viking vs Top Draupne. Ref issue.
+  stratigraphic_alias: # other stratigraphic entities this corresponds to in the strat column, e.g. Top Viking vs Top Draupne.
     - SomeName Fm. 1 Top
   alias: # other known-as names, such as name used inside RMS etc
     - somename_fm_1_top
     - top_somename
 
-  # content is flexible more than standardized for now.
-  content: depth
-
-  # no content-specific attribute for "depth" but can come in the future
-
   properties: # what the values actually show. List, only one for IRAP Binary surfaces. Multiple for 3d grid or multi-parameter surfaces. First is geometry.
     - name: PropertyName
       attribute: mean
@@ -176,14 +172,14 @@ masterdata:
         uuid: ad214d85-8a1d-19da-e053-c918a4889309
     discovery:
       - short_identifier: DROGON
-        uuid: ad214d85-8a1d-19da-e053-c918a4889309
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
     field:
       - identifier: DROGON
-        uuid: 00000000-0000-0000-0000-000000000000
-    coordinate_system:  # changing from "coordinates" to clarify this is not content
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
+    coordinate_system:
       identifier: ST_WGS84_UTM37N_P32637
       uuid: ad214d85-dac7-19da-e053-c918a4889309
     stratigraphic_column:
       identifier: DROGON_2020
-      uuid: 12345678-1234-1234-1234-123456789012
+      uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
 
diff --git a/schema/definitions/0.8.0/examples/case.yml b/schema/definitions/0.8.0/examples/case.yml
index 49fcdf812..04f004485 100644
--- a/schema/definitions/0.8.0/examples/case.yml
+++ b/schema/definitions/0.8.0/examples/case.yml
@@ -1,9 +1,6 @@
-# example YAML file for ensembles (a parent object in Sumo)
-
 $schema: https://main-fmu-schemas-dev.radix.equinor.com/schemas/0.8.0/fmu_results.json
-version: "0.8.0" # including for REP and others to build logic on.
-source: fmu  # always included, and always this value if FMU made it. For quick identification for external consumers.
-
+version: "0.8.0"
+source: fmu
 tracklog:
   - datetime: 2020-10-28T14:28:02
     user:
@@ -14,12 +11,9 @@ tracklog:
       id: peesv
     event: updated
 
-class: case
+class: case # class is the main identifier of the data type.
 
-# no "data" block in ensemble objects
-
-# the "fmu" block in ensembles only have "model" and "ensemble" sub-elements
-fmu:
+fmu: # the fmu-block contains information directly related to the FMU context
   model:
     name: ff
     revision: 21.0.0.dev
@@ -29,7 +23,7 @@ fmu:
 
   case:
     name: MyCaseName
-    uuid: 8bb56d60-8758-481a-89a4-6bac8561d38e # (pseudo-)random valid uuid4
+    uuid: 8bb56d60-8758-481a-89a4-6bac8561d38e
     user:
       id: jriv # $USER from ERT
     description:
@@ -37,19 +31,9 @@ fmu:
       - optional
     restart_from: 15ce3b84-766f-4c93-9050-b154861f9100   # fmu.iteration.uuid for another iteration/case
 
-# access:
-# Level containing properties used for access control
-
 access:
   asset:
-    name: Drogon  # adding level to make room for unique ID in the future
-
-# ensemble objects have no ssdl details
-
-# masterdata:
-# These are static data read from external config YAML file (fmuconfig or similar).
-# Some of these static data are used while processing to populate some non-required
-# fields in data block (for example names alias, color-tables)
+    name: Drogon
 
 masterdata:
   smda:
@@ -58,13 +42,13 @@ masterdata:
         uuid: ad214d85-8a1d-19da-e053-c918a4889309
     discovery:
       - short_identifier: DROGON
-        uuid: ad214d85-8a1d-19da-e053-c918a4889309
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
     field:
       - identifier: DROGON
-        uuid: 00000000-0000-0000-0000-000000000000
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
     coordinate_system:
       identifier: ST_WGS84_UTM37N_P32637
       uuid: ad214d85-dac7-19da-e053-c918a4889309
     stratigraphic_column:
       identifier: DROGON_2020
-      uuid: 12345678-1234-1234-1234-123456789012
+      uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
diff --git a/schema/definitions/0.8.0/examples/polygons_field_outline.yml b/schema/definitions/0.8.0/examples/polygons_field_outline.yml
index d8f5bbe75..aa7253e11 100644
--- a/schema/definitions/0.8.0/examples/polygons_field_outline.yml
+++ b/schema/definitions/0.8.0/examples/polygons_field_outline.yml
@@ -1,6 +1,6 @@
 $schema: https://main-fmu-schemas-dev.radix.equinor.com/schemas/0.8.0/fmu_results.json
-version: "0.8.0" # including for REP and others to build logic on.
-source: fmu  # always included, and always this value if FMU made it. For quick identification for external consumers.
+version: "0.8.0"
+source: fmu
 
 tracklog:
   - datetime: 2020-10-28T14:28:02
@@ -12,12 +12,12 @@ tracklog:
       id: peesv
     event: updated
 
-class: polygons
+class: polygons # class is the main identifier of the data type.
 
 # fmu:
 # The fmu block in data objects have more sub-elements compared to ensemble objects.
 
-fmu:
+fmu: # the fmu-block contains information directly related to the FMU context
   model:
     name: ff
     revision: 21.0.0.dev
@@ -25,12 +25,12 @@ fmu:
       - detailed description
       - optional
 
-  workflow: # not sure, but a reference to the workflow / job that made this. Making it expandable.
+  workflow:
     reference: rms/structural_model
 
   case:
     name: MyCaseName
-    uuid: 8bb56d60-8758-481a-89a4-6bac8561d38e # (pseudo-)random valid uuid4
+    uuid: 8bb56d60-8758-481a-89a4-6bac8561d38e
     user:
       id: jriv # $USER from ERT
     description:
@@ -40,10 +40,10 @@ fmu:
 
   iteration:
     id: 0 # always an int, will be 0 for e.g. "pred"
-    uuid: 4b939310-34b1-4179-802c-49460bc0f799 # hash of case.uuid + iteration.id
+    uuid: 4b939310-34b1-4179-802c-49460bc0f799
     name: "iter-0" # /"pred"
 
-  realization:  # could be expanded in the future?
+  realization:
     id: 33
     uuid: 29a15b21-ce13-471b-9a4a-0f791552aa51 # hash of case.uuid + iteration.uuid + realization.id
     name: "realization-33"
@@ -51,9 +51,10 @@ fmu:
       SENSNAME: faultseal
       SENSCASE: low
       RMS_SEED: 1006
+      INIT_FILES:
+        PERM_FLUVCHAN_E1_NORM: 0.748433
+        PERM_FLUVCHAN_E21_NORM: 0.782068
       KVKH_CHANNEL: 0.6
-      KVKH_CREVASSE: 0.3
-      KVKH_LS: 0.7
       KVKH_US: 0.6
       FAULT_SEAL_SCALING: 0.1
       FWL_CENTRAL: 1677
@@ -76,14 +77,13 @@ file:
 
 data: # The data block describes the actual data (e.g. surface). Only present in data objects
 
+  content: field_outline  # white-listed and standardized
+
   # if stratigraphic, name must match the strat column. This is the official name of this surface.
   name: field_outline--goc
   stratigraphic: false  # if true, this is a stratigraphic surface found in the strat column
 
-  # content is flexible more than standardized for now.
-  content: field_outline
-
-  # 
+  # content-specific tag: When content == "field_outline", expect the 'field_outline' tag
   field_outline:
     contact: goc
 
@@ -141,14 +141,14 @@ masterdata:
         uuid: ad214d85-8a1d-19da-e053-c918a4889309
     discovery:
       - short_identifier: DROGON
-        uuid: ad214d85-8a1d-19da-e053-c918a4889309
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
     field:
       - identifier: DROGON
-        uuid: 00000000-0000-0000-0000-000000000000
-    coordinate_system:  # changing from "coordinates" to clarify this is not content
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
+    coordinate_system:
       identifier: ST_WGS84_UTM37N_P32637
       uuid: ad214d85-dac7-19da-e053-c918a4889309
     stratigraphic_column:
       identifier: DROGON_2020
-      uuid: 12345678-1234-1234-1234-123456789012
+      uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
 
diff --git a/schema/definitions/0.8.0/examples/surface_depth.yml b/schema/definitions/0.8.0/examples/surface_depth.yml
index 91f3337bb..4c3969801 100644
--- a/schema/definitions/0.8.0/examples/surface_depth.yml
+++ b/schema/definitions/0.8.0/examples/surface_depth.yml
@@ -12,12 +12,9 @@ tracklog:
       id: peesv
     event: updated
 
-class: surface
+class: surface # class is the main identifier of the data type.
 
-# fmu:
-# The fmu block in data objects have more sub-elements compared to ensemble objects.
-
-fmu:
+fmu: # the fmu-block contains information directly related to the FMU context
   model:
     name: ff
     revision: 21.0.0.dev
@@ -25,12 +22,12 @@ fmu:
       - detailed description
       - optional
 
-  workflow: # not sure, but a reference to the workflow / job that made this. Making it expandable.
+  workflow:
     reference: rms/structural_model
 
   case:
     name: MyCaseName
-    uuid: 8bb56d60-8758-481a-89a4-6bac8561d38e # (pseudo-)random valid uuid4
+    uuid: 8bb56d60-8758-481a-89a4-6bac8561d38e
     user:
       id: jriv # $USER from ERT
     description:
@@ -43,39 +40,31 @@ fmu:
     uuid: 4b939310-34b1-4179-802c-49460bc0f799 # hash of case.uuid + iteration.id
     name: "iter-0" # /"pred"
 
-  realization:  # could be expanded in the future?
+  realization:
     id: 33
-    uuid: 29a15b21-ce13-471b-9a4a-0f791552aa51 # hash of case.uuid + iteration.uuid + realization.id
+    uuid: 29a15b21-ce13-471b-9a4a-0f791552aa51
     name: "realization-33"
     parameters: # directly pass parameters.txt. This is potentially a lot of content, only a stub is included here.
       SENSNAME: faultseal
       SENSCASE: low
       RMS_SEED: 1006
+      INIT_FILES:
+        PERM_FLUVCHAN_E1_NORM: 0.748433
+        PERM_FLUVCHAN_E21_NORM: 0.782068
       KVKH_CHANNEL: 0.6
-      KVKH_CREVASSE: 0.3
-      KVKH_LS: 0.7
       KVKH_US: 0.6
       FAULT_SEAL_SCALING: 0.1
       FWL_CENTRAL: 1677
-    jobs: # directly pass jobs.json. This is a lot of content, only a stub is included here.
-      umask: '0002'
-      DATA_ROOT: /some/path/20.4.0_20201106/ert/model
-      anything: something
-      something:
-        anything: something
-      global_update_path: {}
-      jobList:
-      - name: MAKE_DIRECTORY
-        min_arg: 1
-        anything: something
 
 file:
   relative_path: realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri # case-relative
-  absolute_path: /some/absolute/path//realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri
+  absolute_path: /some/absolute/path/realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri
   checksum_md5: kjhsdfvsdlfk23knerknvk23  # checksum of the file, not the data.
 
 data: # The data block describes the actual data (e.g. surface). Only present in data objects
 
+  content: depth   # white-listed and standardized
+
   # if stratigraphic, name must match the strat column. This is the official name of this surface.
   name: volantis_top-volantis_base
   stratigraphic: false  # if true, this is a stratigraphic surface found in the strat column
@@ -96,9 +85,6 @@ data: # The data block describes the actual data (e.g. surface). Only present in
     - somename_fm_1_top
     - top_somename
 
-  # content is white-listed and standardized
-  content: depth
-
   # tagname is flexible. The tag is intended primarily for providing uniqueness. The tagname will also be part of the outgoing file name on disk.
   tagname: ds_extract_geogrid
 
@@ -114,7 +100,7 @@ data: # The data block describes the actual data (e.g. surface). Only present in
   layout: regular # / cornerpoint / structured / etc
   unit: m
   vertical_domain: depth # / time / null
-  depth_reference: msl # / seabed / etc # mandatory when vertical_domain is depth?
+  depth_reference: msl # / seabed / etc
   grid_model: # Making this an object to allow for expanding in the future
     name: MyGrid # important for data identification, also important for other data types
   spec: # class/layout dependent, optional? Can spec be expanded to work for all data types?
@@ -181,14 +167,14 @@ masterdata:
         uuid: ad214d85-8a1d-19da-e053-c918a4889309
     discovery:
       - short_identifier: DROGON
-        uuid: ad214d85-8a1d-19da-e053-c918a4889309
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
     field:
       - identifier: DROGON
-        uuid: 00000000-0000-0000-0000-000000000000
-    coordinate_system:  # changing from "coordinates" to clarify this is not content
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
+    coordinate_system:
       identifier: ST_WGS84_UTM37N_P32637
       uuid: ad214d85-dac7-19da-e053-c918a4889309
     stratigraphic_column:
       identifier: DROGON_2020
-      uuid: 12345678-1234-1234-1234-123456789012
+      uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
 
diff --git a/schema/definitions/0.8.0/examples/surface_fluid_contact.yml b/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
index b71332e0b..bd4d9cd1a 100644
--- a/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
+++ b/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
@@ -46,7 +46,7 @@ fmu:
     uuid: 4b939310-34b1-4179-802c-49460bc0f799 # hash of case.uuid + iteration.id
     name: "iter-0" # /"pred"
 
-  realization: # could be expanded in the future?
+  realization:
     id: 33
     uuid: 29a15b21-ce13-471b-9a4a-0f791552aa51 # hash of case.uuid + iteration.uuid + realization.id
     name: "realization-33"
@@ -54,9 +54,10 @@ fmu:
       SENSNAME: faultseal
       SENSCASE: low
       RMS_SEED: 1006
+      INIT_FILES:
+        PERM_FLUVCHAN_E1_NORM: 0.748433
+        PERM_FLUVCHAN_E21_NORM: 0.782068
       KVKH_CHANNEL: 0.6
-      KVKH_CREVASSE: 0.3
-      KVKH_LS: 0.7
       KVKH_US: 0.6
       FAULT_SEAL_SCALING: 0.1
       FWL_CENTRAL: 1677
@@ -78,6 +79,13 @@ file:
   checksum_md5: kjhsdfvsdlfk23knerknvk23 # checksum of the file, not the data.
 
 data: # The data block describes the actual data (e.g. surface).Only present in data objects
+
+  content: fluid_contact   # white-listed and standardized
+
+  fluid_contact: # When content == fluid_contact, include this
+    contact: owc # / fwl / goc / fgl /etc
+    truncated: true # is the contact surface truncated to the stratigraphy?
+
   # if stratigraphic, name must match the strat column. This is the official name of this surface.
   name: volantis_top-volantis_base
   stratigraphic: false # if true, this is a stratigraphic surface found in the strat column
@@ -98,12 +106,6 @@ data: # The data block describes the actual data (e.g. surface).Only present in
     - somename_fm_1_top
     - top_somename
 
-  # content is flexible more than standardized for now.
-  content: fluid_contact
-
-  fluid_contact: # When content == fluid_contact, include this
-    contact: owc # / fwl / goc / fgl /etc - trying to avoid "type"
-    truncated: true # is the contact surface truncated to the stratigraphy?
   properties: # what the values actually show. List, only one for IRAP Binary surfaces. Multiple for 3d grid or multi-parameter surfaces. First is geometry.
     - name: PropertyName
       attribute: owc
@@ -181,13 +183,13 @@ masterdata:
         uuid: ad214d85-8a1d-19da-e053-c918a4889309
     discovery:
       - short_identifier: DROGON
-        uuid: ad214d85-8a1d-19da-e053-c918a4889309
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
     field:
       - identifier: DROGON
-        uuid: 00000000-0000-0000-0000-000000000000
-    coordinate_system: # changing from "coordinates" to clarify this is not content
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
+    coordinate_system:
       identifier: ST_WGS84_UTM37N_P32637
       uuid: ad214d85-dac7-19da-e053-c918a4889309
     stratigraphic_column:
       identifier: DROGON_2020
-      uuid: 12345678-1234-1234-1234-123456789012
+      uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
\ No newline at end of file
diff --git a/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml b/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
index 55a48d4fc..0d91790d7 100644
--- a/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
+++ b/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
@@ -45,7 +45,7 @@ fmu:
     uuid: 4b939310-34b1-4179-802c-49460bc0f799 # hash of case.uuid + iteration.id
     name: "iter-0" # /"pred"
 
-  realization:  # could be expanded in the future?
+  realization:
     id: 33
     uuid: 29a15b21-ce13-471b-9a4a-0f791552aa51 # hash of case.uuid + iteration.uuid + realization.id
     name: "realization-33"
@@ -53,9 +53,10 @@ fmu:
       SENSNAME: faultseal
       SENSCASE: low
       RMS_SEED: 1006
+      INIT_FILES:
+        PERM_FLUVCHAN_E1_NORM: 0.748433
+        PERM_FLUVCHAN_E21_NORM: 0.782068
       KVKH_CHANNEL: 0.6
-      KVKH_CREVASSE: 0.3
-      KVKH_LS: 0.7
       KVKH_US: 0.6
       FAULT_SEAL_SCALING: 0.1
       FWL_CENTRAL: 1677
@@ -78,6 +79,19 @@ file:
 
 data: # The data block describes the actual data (e.g. surface). Only present in data objects
 
+  content: seismic    # white-listed and standardized
+
+  seismic:
+    attribute: amplitude_timeshifted
+    zrange: 12.0
+    filter_size: 1.0
+    scaling_factor: 1.0
+    is_timelapse: True # possibly covered by having both time1 and time2
+    acquisition_start_date: 2021-04-21
+    acquisition_end_date: 2021-04-30
+    acquisition_reference_date: 2021-04-25
+    offset: 0-15  # near/mid/far/0-15/15-25/etc <-- Probably not to be indexed
+
   # if stratigraphic, name must match the strat column. This is the official name of this surface.
   name: volantis_top-volantis_base
   stratigraphic: false  # if true, this is a stratigraphic surface found in the strat column
@@ -98,19 +112,6 @@ data: # The data block describes the actual data (e.g. surface). Only present in
     - somename_fm_1_top
     - top_somename
 
-  # content is flexible more than standardized for now.
-  content: seismic
-  seismic:
-    attribute: amplitude_timeshifted
-    zrange: 12.0
-    filter_size: 1.0
-    scaling_factor: 1.0
-    is_timelapse: True # possibly covered by having both time1 and time2
-    acquisition_start_date: 2021-04-21
-    acquisition_end_date: 2021-04-30
-    acquisition_reference_date: 2021-04-25
-    offset: 0-15  # near/mid/far/0-15/15-25/etc <-- Probably not to be indexed
-
   properties: # what the values actually show. List, only one for IRAP Binary surfaces. Multiple for 3d grid or multi-parameter surfaces. First is geometry.
     - name: PropertyName
       attribute: amplitude
@@ -188,14 +189,14 @@ masterdata:
         uuid: ad214d85-8a1d-19da-e053-c918a4889309
     discovery:
       - short_identifier: DROGON
-        uuid: ad214d85-8a1d-19da-e053-c918a4889309
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
     field:
       - identifier: DROGON
-        uuid: 00000000-0000-0000-0000-000000000000
-    coordinate_system:  # changing from "coordinates" to clarify this is not content
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
+    coordinate_system:
       identifier: ST_WGS84_UTM37N_P32637
       uuid: ad214d85-dac7-19da-e053-c918a4889309
     stratigraphic_column:
       identifier: DROGON_2020
-      uuid: 12345678-1234-1234-1234-123456789012
+      uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
 

From 757c45401735a0c771c9a023fa5fa6e22751fb02 Mon Sep 17 00:00:00 2001
From: Per Olav Eide Svendsen <peesv@equinor.com>
Date: Mon, 4 Jul 2022 10:53:40 +0200
Subject: [PATCH 2/6] Add headers

---
 .../0.8.0/examples/aggregated_surface_depth.yml            | 7 +++++++
 schema/definitions/0.8.0/examples/case.yml                 | 2 ++
 .../definitions/0.8.0/examples/polygons_field_outline.yml  | 2 ++
 schema/definitions/0.8.0/examples/surface_depth.yml        | 2 ++
 .../definitions/0.8.0/examples/surface_fluid_contact.yml   | 4 ++++
 .../0.8.0/examples/surface_seismic_amplitude.yml           | 2 +-
 6 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml b/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml
index 61746b63d..9466eefa1 100644
--- a/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml
+++ b/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml
@@ -1,3 +1,10 @@
+# Example metadata for an aggregated surface.
+
+# An aggregated surface is a statistical representation of a distribution of surfaces.
+# E.g. 200 realizations produce a surface representing the same horizon. This is now a
+# distribution representing this surface with n=200. An aggregated surface is a
+# statistical representation of this distribution, e.g. "mean", "min", "max", "p10", etc.
+
 $schema: https://main-fmu-schemas-dev.radix.equinor.com/schemas/0.8.0/fmu_results.json
 version: "0.8.0"
 source: fmu
diff --git a/schema/definitions/0.8.0/examples/case.yml b/schema/definitions/0.8.0/examples/case.yml
index 04f004485..136e6b3a9 100644
--- a/schema/definitions/0.8.0/examples/case.yml
+++ b/schema/definitions/0.8.0/examples/case.yml
@@ -1,3 +1,5 @@
+# Example metadata for an FMU case. In the parent/child system, this is a parent object.
+
 $schema: https://main-fmu-schemas-dev.radix.equinor.com/schemas/0.8.0/fmu_results.json
 version: "0.8.0"
 source: fmu
diff --git a/schema/definitions/0.8.0/examples/polygons_field_outline.yml b/schema/definitions/0.8.0/examples/polygons_field_outline.yml
index aa7253e11..3dcb912dc 100644
--- a/schema/definitions/0.8.0/examples/polygons_field_outline.yml
+++ b/schema/definitions/0.8.0/examples/polygons_field_outline.yml
@@ -1,3 +1,5 @@
+# Example metadata for a polygon(s)
+
 $schema: https://main-fmu-schemas-dev.radix.equinor.com/schemas/0.8.0/fmu_results.json
 version: "0.8.0"
 source: fmu
diff --git a/schema/definitions/0.8.0/examples/surface_depth.yml b/schema/definitions/0.8.0/examples/surface_depth.yml
index 4c3969801..97f37d2a5 100644
--- a/schema/definitions/0.8.0/examples/surface_depth.yml
+++ b/schema/definitions/0.8.0/examples/surface_depth.yml
@@ -1,3 +1,5 @@
+# Example metadata for a depth surface.
+
 $schema: https://main-fmu-schemas-dev.radix.equinor.com/schemas/0.8.0/fmu_results.json
 version: "0.8.0" # including for REP and others to build logic on.
 source: fmu  # always included, and always this value if FMU made it. For quick identification for external consumers.
diff --git a/schema/definitions/0.8.0/examples/surface_fluid_contact.yml b/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
index bd4d9cd1a..7682f3775 100644
--- a/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
+++ b/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
@@ -1,3 +1,7 @@
+# Example metadata for a fluid_contact surface.
+
+# A fluid contact surface is a surface representing a fluid contact, e.g. FWL, OWC, etc.
+
 $schema: https://main-fmu-schemas-dev.radix.equinor.com/schemas/0.8.0/fmu_results.json
 version: "0.8.0" # including for REP and others to build logic on.
 source: fmu # always included, and always this value if FMU made it. For quick identification for external consumers.
diff --git a/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml b/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
index 0d91790d7..7b80e8555 100644
--- a/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
+++ b/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
@@ -1,4 +1,4 @@
-# example YAML file for surfaces (a child object in Sumo)
+# Example metadata for a seismic amplitude surface.
 
 $schema: https://main-fmu-schemas-dev.radix.equinor.com/schemas/0.8.0/fmu_results.json
 version: "0.8.0" # including for REP and others to build logic on.

From db0132cfea974c8d7aaa154d0c4f1b7df6db84f6 Mon Sep 17 00:00:00 2001
From: Per Olav Eide Svendsen <peesv@equinor.com>
Date: Mon, 4 Jul 2022 10:56:00 +0200
Subject: [PATCH 3/6] Add file.size_bytes to all examples

---
 schema/definitions/0.8.0/examples/aggregated_surface_depth.yml  | 1 +
 schema/definitions/0.8.0/examples/polygons_field_outline.yml    | 1 +
 schema/definitions/0.8.0/examples/surface_depth.yml             | 1 +
 schema/definitions/0.8.0/examples/surface_fluid_contact.yml     | 1 +
 schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml | 1 +
 5 files changed, 5 insertions(+)

diff --git a/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml b/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml
index 9466eefa1..f7bc9857b 100644
--- a/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml
+++ b/schema/definitions/0.8.0/examples/aggregated_surface_depth.yml
@@ -77,6 +77,7 @@ file:
   relative_path: iter-0/share/results/maps/volantis_gp_base--amplitude--mean.gri # case-relative
   absolute_path: /some/absolute/path/iter-0/share/results/maps/volantis_gp_base--amplitude--mean.gri
   checksum_md5: kjhsdfvsdlfk23knerknvk23  # checksum of the file, not the data.
+  size_bytes: 5010144
 
 data: # The data block describes the actual data (e.g. surface). Only present in data objects
 
diff --git a/schema/definitions/0.8.0/examples/polygons_field_outline.yml b/schema/definitions/0.8.0/examples/polygons_field_outline.yml
index 3dcb912dc..ae450b6f5 100644
--- a/schema/definitions/0.8.0/examples/polygons_field_outline.yml
+++ b/schema/definitions/0.8.0/examples/polygons_field_outline.yml
@@ -76,6 +76,7 @@ file:
   relative_path: realization-33/iter-0/share/results/polygons/field_outline--goc.gri # case-relative
   absolute_path: /some/absolute/path//realization-33/iter-0/share/results/polygons/field_outline--goc.gri
   checksum_md5: kjhsdfvsdlfk23knerknvk23  # checksum of the file, not the data.
+  size_bytes: 5010144
 
 data: # The data block describes the actual data (e.g. surface). Only present in data objects
 
diff --git a/schema/definitions/0.8.0/examples/surface_depth.yml b/schema/definitions/0.8.0/examples/surface_depth.yml
index 97f37d2a5..decc0b998 100644
--- a/schema/definitions/0.8.0/examples/surface_depth.yml
+++ b/schema/definitions/0.8.0/examples/surface_depth.yml
@@ -62,6 +62,7 @@ file:
   relative_path: realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri # case-relative
   absolute_path: /some/absolute/path/realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri
   checksum_md5: kjhsdfvsdlfk23knerknvk23  # checksum of the file, not the data.
+  size_bytes: 5010144
 
 data: # The data block describes the actual data (e.g. surface). Only present in data objects
 
diff --git a/schema/definitions/0.8.0/examples/surface_fluid_contact.yml b/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
index 7682f3775..5bcd66c1c 100644
--- a/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
+++ b/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
@@ -81,6 +81,7 @@ file:
   relative_path: realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri # case-relative
   absolute_path: /some/absolute/path//realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri
   checksum_md5: kjhsdfvsdlfk23knerknvk23 # checksum of the file, not the data.
+  size_bytes: 5010144
 
 data: # The data block describes the actual data (e.g. surface).Only present in data objects
 
diff --git a/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml b/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
index 7b80e8555..610b688c0 100644
--- a/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
+++ b/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
@@ -76,6 +76,7 @@ file:
   relative_path: realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri # case-relative
   absolute_path: /some/absolute/path//realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri
   checksum_md5: kjhsdfvsdlfk23knerknvk23  # checksum of the file, not the data.
+  size_bytes: 5010144
 
 data: # The data block describes the actual data (e.g. surface). Only present in data objects
 

From 28a5dbe42d55916b5ab3ccbe86b6e8084d140632 Mon Sep 17 00:00:00 2001
From: Per Olav Eide Svendsen <peesv@equinor.com>
Date: Mon, 4 Jul 2022 10:58:12 +0200
Subject: [PATCH 4/6] Remove fmu.realization.jobs from all examples

---
 .../0.8.0/examples/polygons_field_outline.yml         | 11 -----------
 .../0.8.0/examples/surface_fluid_contact.yml          | 11 -----------
 .../0.8.0/examples/surface_seismic_amplitude.yml      | 11 -----------
 3 files changed, 33 deletions(-)

diff --git a/schema/definitions/0.8.0/examples/polygons_field_outline.yml b/schema/definitions/0.8.0/examples/polygons_field_outline.yml
index ae450b6f5..8f3475886 100644
--- a/schema/definitions/0.8.0/examples/polygons_field_outline.yml
+++ b/schema/definitions/0.8.0/examples/polygons_field_outline.yml
@@ -60,17 +60,6 @@ fmu: # the fmu-block contains information directly related to the FMU context
       KVKH_US: 0.6
       FAULT_SEAL_SCALING: 0.1
       FWL_CENTRAL: 1677
-    jobs: # directly pass jobs.json. This is a lot of content, only a stub is included here.
-      umask: '0002'
-      DATA_ROOT: /some/path/20.4.0_20201106/ert/model
-      anything: something
-      something:
-        anything: something
-      global_update_path: {}
-      jobList:
-      - name: MAKE_DIRECTORY
-        min_arg: 1
-        anything: something
 
 file:
   relative_path: realization-33/iter-0/share/results/polygons/field_outline--goc.gri # case-relative
diff --git a/schema/definitions/0.8.0/examples/surface_fluid_contact.yml b/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
index 5bcd66c1c..dcf478d21 100644
--- a/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
+++ b/schema/definitions/0.8.0/examples/surface_fluid_contact.yml
@@ -65,17 +65,6 @@ fmu:
       KVKH_US: 0.6
       FAULT_SEAL_SCALING: 0.1
       FWL_CENTRAL: 1677
-    jobs: # directly pass jobs.json. This is a lot of content, only a stub is included here.
-      umask: "0002"
-      DATA_ROOT: /some/path/20.4.0_20201106/ert/model
-      anything: something
-      something:
-        anything: something
-      global_update_path: {}
-      jobList:
-        - name: MAKE_DIRECTORY
-          min_arg: 1
-          anything: something
 
 file:
   relative_path: realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri # case-relative
diff --git a/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml b/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
index 610b688c0..72f21d54c 100644
--- a/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
+++ b/schema/definitions/0.8.0/examples/surface_seismic_amplitude.yml
@@ -60,17 +60,6 @@ fmu:
       KVKH_US: 0.6
       FAULT_SEAL_SCALING: 0.1
       FWL_CENTRAL: 1677
-    jobs: # directly pass jobs.json. This is a lot of content, only a stub is included here.
-      umask: '0002'
-      DATA_ROOT: /some/path/20.4.0_20201106/ert/model
-      anything: something
-      something:
-        anything: something
-      global_update_path: {}
-      jobList:
-      - name: MAKE_DIRECTORY
-        min_arg: 1
-        anything: something
 
 file:
   relative_path: realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri # case-relative

From e5addc9df63d12a172d813c547fca701c10320e5 Mon Sep 17 00:00:00 2001
From: Per Olav Eide Svendsen <peesv@equinor.com>
Date: Mon, 4 Jul 2022 11:24:56 +0200
Subject: [PATCH 5/6] Add table example

---
 .../0.8.0/examples/table_inplace.yml          | 141 ++++++++++++++++++
 1 file changed, 141 insertions(+)
 create mode 100644 schema/definitions/0.8.0/examples/table_inplace.yml

diff --git a/schema/definitions/0.8.0/examples/table_inplace.yml b/schema/definitions/0.8.0/examples/table_inplace.yml
new file mode 100644
index 000000000..09c91db81
--- /dev/null
+++ b/schema/definitions/0.8.0/examples/table_inplace.yml
@@ -0,0 +1,141 @@
+# Example metadata for an inplace volume table.
+
+$schema: https://main-fmu-schemas-dev.radix.equinor.com/schemas/0.8.0/fmu_results.json
+version: "0.8.0"
+source: fmu
+
+tracklog:
+  - datetime: 2020-10-28T14:28:02
+    user:
+      id: peesv
+    event: created
+  - datetime: 2020-10-28T14:46:14
+    user: 
+      id: peesv
+    event: updated
+
+class: surface # class is the main identifier of the data type.
+
+fmu: # the fmu-block contains information directly related to the FMU context
+  model:
+    name: ff
+    revision: 21.0.0.dev
+    description:
+      - detailed description
+      - optional
+
+  workflow:
+    reference: rms/structural_model
+
+  case:
+    name: MyCaseName
+    uuid: 8bb56d60-8758-481a-89a4-6bac8561d38e
+    user:
+      id: jriv # $USER from ERT
+    description:
+      - yet other detailed description
+      - optional
+    restart_from: 15ce3b84-766f-4c93-9050-b154861f9100   # fmu.iteration.uuid for another iteration/case
+
+  iteration:
+    id: 0 # always an int, will be 0 for e.g. "pred"
+    uuid: 4b939310-34b1-4179-802c-49460bc0f799 # hash of case.uuid + iteration.id
+    name: "iter-0" # /"pred"
+
+  realization:
+    id: 33
+    uuid: 29a15b21-ce13-471b-9a4a-0f791552aa51
+    name: "realization-33"
+    parameters: # directly pass parameters.txt. This is potentially a lot of content, only a stub is included here.
+      SENSNAME: faultseal
+      SENSCASE: low
+      RMS_SEED: 1006
+      INIT_FILES:
+        PERM_FLUVCHAN_E1_NORM: 0.748433
+        PERM_FLUVCHAN_E21_NORM: 0.782068
+      KVKH_CHANNEL: 0.6
+      KVKH_US: 0.6
+      FAULT_SEAL_SCALING: 0.1
+      FWL_CENTRAL: 1677
+
+file:
+  relative_path: realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri # case-relative
+  absolute_path: /some/absolute/path/realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri
+  checksum_md5: kjhsdfvsdlfk23knerknvk23  # checksum of the file, not the data.
+  size_bytes: 5010144
+
+data: # The data block describes the actual data (e.g. surface). Only present in data objects
+
+  content: inplace_volumes   # white-listed and standardized
+
+  # if stratigraphic, name must match the strat column. This is the official name of this surface.
+  name: inplace_mygrid
+  stratigraphic: false
+
+  properties: 
+    - name: BULK_OIL
+      unit: m3
+      is_discrete: false
+    - name: NET_OIL
+      unit: m3
+      is_discrete: false
+    - name: PORE_OIL
+      unit: m3
+      is_discrete: false
+    - name: HCPV_OIL
+      unit: m3
+      is_discrete: false
+    - name: STOIIP_OIL
+      unit: sm3
+      is_discrete: false
+    - name: ZONE
+      is_discrete: true
+    - name: REGION
+      is_discrete: true
+    - name: FACIES
+      is_discrete: true
+    - name: LICENSE
+      is_discrete: true
+
+  format: csv
+  vertical_domain: depth # / time / null
+  depth_reference: msl # / seabed / etc
+  grid_model: # Making this an object to allow for expanding in the future
+    name: MyGrid # important for data identification, also important for other data types
+  spec: # class/layout dependent, optional? Can spec be expanded to work for all data types?
+    ncol: 281
+    nrow: 441
+    undef: -999.25  # Allow both number and string
+  is_prediction: true # A mechanism for separating pure QC output from actual predictions
+  is_observation: false
+  description:
+    - Inplace volumes calculated on MyGrid
+
+display:
+  name: Inplace, MyGrid
+
+access:
+  asset:
+    name: Drogon
+  ssdl:
+    access_level: asset
+    rep_include: false
+
+masterdata:
+  smda:
+    country:
+      - identifier: Norway
+        uuid: ad214d85-8a1d-19da-e053-c918a4889309
+    discovery:
+      - short_identifier: DROGON
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
+    field:
+      - identifier: DROGON
+        uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
+    coordinate_system:
+      identifier: ST_WGS84_UTM37N_P32637
+      uuid: ad214d85-dac7-19da-e053-c918a4889309
+    stratigraphic_column:
+      identifier: DROGON_2020
+      uuid: 00000000-0000-0000-0000-000000000000 # mock uuid for Drogon
+

From 8022d8f223640b39928e620ae437546074c0eac8 Mon Sep 17 00:00:00 2001
From: Per Olav Eide Svendsen <peesv@equinor.com>
Date: Mon, 11 Jul 2022 10:26:54 +0200
Subject: [PATCH 6/6] Fix-ups on the inplace example

---
 schema/definitions/0.8.0/examples/table_inplace.yml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/schema/definitions/0.8.0/examples/table_inplace.yml b/schema/definitions/0.8.0/examples/table_inplace.yml
index 09c91db81..824b7a064 100644
--- a/schema/definitions/0.8.0/examples/table_inplace.yml
+++ b/schema/definitions/0.8.0/examples/table_inplace.yml
@@ -14,7 +14,7 @@ tracklog:
       id: peesv
     event: updated
 
-class: surface # class is the main identifier of the data type.
+class: table # class is the main identifier of the data type.
 
 fmu: # the fmu-block contains information directly related to the FMU context
   model:
@@ -25,7 +25,7 @@ fmu: # the fmu-block contains information directly related to the FMU context
       - optional
 
   workflow:
-    reference: rms/structural_model
+    reference: rms/volumetrics
 
   case:
     name: MyCaseName
@@ -59,8 +59,8 @@ fmu: # the fmu-block contains information directly related to the FMU context
       FWL_CENTRAL: 1677
 
 file:
-  relative_path: realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri # case-relative
-  absolute_path: /some/absolute/path/realization-33/iter-0/share/results/maps/volantis_gp_base--amplitude.gri
+  relative_path: realization-33/iter-0/share/results/tables/inplace_mygrid.csv # case-relative
+  absolute_path: /some/absolute/path/realization-33/iter-0/share/results/inplace_mygrid.csv
   checksum_md5: kjhsdfvsdlfk23knerknvk23  # checksum of the file, not the data.
   size_bytes: 5010144