[ENH] Schema changes related to BEP032

src/schema/objects/columns.yaml

@@ -42,13 +42,29 @@ age:
     for privacy purposes.
   type: number
   unit: year
+age_category:
+  name: age_category
+  display_name: Age category
+  description: |
+    For non-numeric description of the age (e.g. developmental stage) a string can be provided.
+    We RECOMMEND to use the [UBERON life cycle stage](http://purl.obolibrary.org/obo/UBERON_0000105) to specify it.
+  type: string
+age_type:
+  name: age_type
+  display_name: Age type
+  description: |
+    Type of age measurement (e.g. `postnatal`, `fetal`, `gestational`). If not specified, `postnatal` is assumed.
+  type: string
+  enum:
+    - $ref: objects.enums.postnatal.value
+    - $ref: objects.enums.fetal.value
+    - $ref: objects.enums.gestational.value
 alpha_rotation:
   name: alpha_rotation
   display_name: Alpha rotation
   description: |
     Euler angle to match probe extension dimensions (width, height, depth) to global x, y, z coordinates.
-  unit:
-    degree
+  unit: degree
 associated_brain_region:
   name: associated_brain_region
   display_name: Associated brain region
@@ -67,16 +83,22 @@ associated_brain_region_quality_type:
   name: associated_brain_region_quality_type
   display_name: Associated brain region quality type
   description: |
-     The method used to identify the associated brain region (estimated|proof)
-     depending on anatomical pictures proofing the location or indirect estimation of the location.
+    The method used to identify the associated brain region (estimated|proof)
+    depending on anatomical pictures proofing the location or indirect estimation of the location.
   type: string
+birthdate:
+  name: birthdate
+  display_name: Birthdate
+  description: |
+    Day of birth of the participant. Datetime format and their anonymization are described in [Units](SPEC_ROOT/common-principles.md#units).
+  type: string
+  format: datetime
 beta_rotation:
   name: beta_rotation
   display_name: Beta rotation
   description: |
     Euler angle to match probe extension dimensions (width, height, depth) to global x, y, z coordinates.
-  unit:
-    degree
+  unit: degree
 cardiac:
   name: cardiac
   display_name: Cardiac measurement
@@ -231,8 +253,7 @@ gamma_rotation:
   display_name: Gamma rotation
   description: |
     Euler angle to match probe extension dimensions (width, height, depth) to global x, y, z coordinates.
-  unit:
-    degree
+  unit: degree
 group__channel:
   name: group
   display_name: Channel group
@@ -699,6 +720,14 @@ strain_rrid:
     of the strain of the species, for example: `RRID:IMSR_JAX:000664`.
   type: string
   format: rrid
+# TODO: Clarify if column values can be arrays.
+surgery_date:
+  name: surgery_date
+  display_name: Surgery date
+  description: |
+    Date(s) of surgery. Datetime format and their anonymization are described in [Units](SPEC_ROOT/common-principles.md#units). The details of the surgery should be described in the sidecar json file.
+  type: string
+  format: datetime
 time:
   name: time
   display_name: Time

src/schema/objects/enums.yaml

@@ -1405,3 +1405,24 @@ microvascular:
   display_name: microvascular
   description: |
     The origin of a tissue: microvascular
+postnatal:
+  value: postnatal
+  display_name: postnatal
+  description: |
+    This is the actual time that has passed since a subject's birth,
+    also known as “chronological age”.
+    If age_type is omitted, age is assumed to be this type.
+fetal:
+  value: fetal
+  display_name: fetal
+  description: |
+    Also known as "embryonic age," this measures the age of a
+    fetus or embryo from the time of conception. It's typically about two weeks
+    less than the gestational age.
+gestational:
+  value: gestational
+  display_name: gestational
+  description: |
+    This measures the duration of pregnancy from the first day of the
+    mother's last menstrual period to the current date. This should be included
+    for experiments where some subjects have not been born.