[SCHEMA] Add MeasurementToolMetadata and Derivative metadata fields (#…

…899)

* Add MeasurementToolMetadata and Derivative fields.

Both fields are described in the Phenotypic data section of the spec.

* Move "Derivative" from tabular files table to phenotype table.

src/03-modality-agnostic-files.md

@@ -363,12 +363,15 @@ in the BIDS dataset and `participants.tsv` file.
 As with all other tabular data, the additional phenotypic information files
 MAY be accompanied by a JSON file describing the columns in detail
 (see [Tabular files](02-common-principles.md#tabular-files)).
-In addition to the column description, a section describing the measurement tool
-(as a whole) MAY be added under the name `MeasurementToolMetadata`.
-This section consists of two keys:
 
--   `Description`: A free text description of the measurement tool
--   `TermURL`: A URL to an entity in an ontology corresponding to this tool.
+In addition to the column descriptions, the JSON file MAY contain the following fields:
+
+{{ MACROS___make_metadata_table(
+   {
+      "MeasurementToolMetadata": "OPTIONAL",
+      "Derivative": "OPTIONAL",
+   }
+) }}
 
 As an example, consider the contents of a file called
 `phenotype/acds_adult.json`:

src/schema/objects/metadata.yaml

@@ -452,6 +452,13 @@ Density:
   - type: object
     additionalProperties:
       type: string
+Derivative:
+  name: Derivative
+  description: |
+    Indicates that values in the corresponding column are transformations of values
+    from other columns (for example a summary score based on a subset of items in a
+    questionnaire).
+  type: boolean
 Description:
   name: Description
   description: |
@@ -1549,6 +1556,20 @@ MaxMovement:
     as measured by the head localisation coils (for example, 4.8).
   type: number
   unit: mm
+MeasurementToolMetadata:
+  name: MeasurementToolMetadata
+  description: |
+    A description of the measurement tool as a whole.
+    Contains two fields: `"Description"` and `"TermURL"`.
+    `"Description"` is a free text description of the measurement tool.
+    `"TermURL"` is a URL to an entity in an ontology corresponding to this tool.
+  type: object
+  properties:
+    TermURL:
+      type: string
+      format: uri
+    Description:
+      type: string
 MetaboliteAvail:
   name: MetaboliteAvail
   description: |