Skip to content

Commit d6907e1

Browse files
sappelhoffsappelhoff
committed
enh tables in common data types
1 parent 66fd804 commit d6907e1

File tree

1 file changed

+11
-8
lines changed

1 file changed

+11
-8
lines changed

‎src/05-derivatives/02-common-data-types.md‎

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,11 @@ JSON file is also REQUIRED.
1010
Each derivative type defines their own set of fields, but all of them
1111
share the following (non-required) ones:
1212

13-
| **Key name** | **Description** |
14-
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
15-
| Description | RECOMMENDED. Free-form natural language description of the nature of the file. |
16-
| Sources | OPTIONAL. A list of files with the paths specified relative to dataset root; these files were directly used in the creation of this derivative data file. For example, if a derivative A is used in the creation of another derivative B, which is in turn used to generate C in a chain of A->B->C, C should only list B in `Sources`, and B should only list A in `Sources`. However, in case both X and Y are directly used in the creation of Z, then Z should list X and Y in `Sources`, regardless of whether X was used to generate Y. |
17-
| RawSources | OPTIONAL. A list of paths relative to dataset root pointing to the BIDS-Raw file(s) that were used in the creation of this derivative. |
13+
| **Key name** | **Requirement level** | **Data type** | **Description** |
14+
| ------------ | --------------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
15+
| Description | RECOMMENDED | [string][] | Free-form natural language description of the nature of the file. |
16+
| Sources | OPTIONAL | [array][] of [strings][] | A list of files with the paths specified relative to dataset root; these files were directly used in the creation of this derivative data file. For example, if a derivative A is used in the creation of another derivative B, which is in turn used to generate C in a chain of A->B->C, C should only list B in `Sources`, and B should only list A in `Sources`. However, in case both X and Y are directly used in the creation of Z, then Z should list X and Y in `Sources`, regardless of whether X was used to generate Y. |
17+
| RawSources | OPTIONAL | [array][] of [strings][] | A list of paths relative to dataset root pointing to the BIDS-Raw file(s) that were used in the creation of this derivative. |
1818

1919
### Examples
2020

@@ -71,9 +71,9 @@ The `space` entity may take any value in [Image-Based Coordinate Systems][coords
7171
If the `space` entity is omitted, or the space is not in the [Standard template
7272
identifiers][templates] table, then the `SpatialReference` metadata is REQUIRED.
7373

74-
| **Key name** | **Description** |
75-
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
76-
| SpatialReference | RECOMMENDED if the derivative is aligned to a standard template listed in [Standard template identifiers][templates]. REQUIRED otherwise. For images with a single reference, the value MUST be a single string. For images with multiple references, such as surface and volume references, a JSON object MUST be used. |
74+
| **Key name** | **Requirement level** | **Data type** | **Description** | |
75+
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------------| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
76+
| SpatialReference | RECOMMENDED if the derivative is aligned to a standard template listed in [Standard template identifiers][templates]. REQUIRED otherwise. | [string][] or [object][] | For images with a single reference, the value MUST be a single string. For images with multiple references, such as surface and volume references, a JSON object MUST be used. See examples below. |
7777

7878
### SpatialReference key allowed values
7979

@@ -188,3 +188,6 @@ static volume, a `RepetitionTime` property would no longer be relevant).
188188
[coordsys]: ../99-appendices/08-coordinate-systems.md#image-based-coordinate-systems
189189
[templates]: ../99-appendices/08-coordinate-systems.md#standard-template-identifiers
190190
[object]: https://www.json.org/json-en.html
191+
[string]: https://www.w3schools.com/js/js_json_syntax.asp
192+
[strings]: https://www.w3schools.com/js/js_json_syntax.asp
193+
[array]: https://www.w3schools.com/js/js_json_arrays.asp

0 commit comments

Comments
 (0)