diff --git a/CHANGELOG.md b/CHANGELOG.md index f5dd98c..e982c62 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,15 @@ # CHANGELOG for HED specification +## Changes for HED specification 3.2.0 +- The `Inset` tag was introduced to mark intermediate points in events of temporal extent. +- Partnered schemas were introduced using the `withStandard` schema header attribute +and the `rooted` schema attribute. +- The curly brace annotation for sidecars was introduced. + +## Changes for HED specification 3.1.1 +This release is added additional minor corrections and +clarifications in the specification document and does not include any enhancements from version 3.0.0. + ## Changes for HED specification 3.1.0 This release is focused on corrections and clarifications in the specification document and does not include any enhancements. diff --git a/README.md b/README.md index b84530a..547f265 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,5 @@ +[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7869149.svg)](https://doi.org/10.5281/zenodo.7869149) + # HED specification **Note** This repository is primarily for managing the HED ecosystem specification, diff --git a/docs/source/03_HED_formats.md b/docs/source/03_HED_formats.md index 1255976..ad3bde5 100644 --- a/docs/source/03_HED_formats.md +++ b/docs/source/03_HED_formats.md @@ -3,7 +3,7 @@ This chapter describes the requirements and formats for HED schema and HED annotations. -## 3.1. HED schema format +## 3.1. Schema formats A **HED schema** is a formal specification of a HED vocabulary and annotation format rules. A HED schema vocabulary is organized hierarchically so that similar concepts and terms appear @@ -19,7 +19,14 @@ A key requirement for third generation HED (versions >=8.0.0) is that all node n the HED schema (except for `#` placeholders) **must be unique**. Additional details about HED schema format can be found in appendix -[**A. Schema format details**](./Appendix_A.md) +[**A. Schema format details**](./Appendix_A.md). +[**7. Library schemas**](./07_Library_schemas.md#7-library-schemas) +discusses the additional requirements and restrictions on library schemas. + +[**B.2. Schema validation errors**](./Appendix_B.md#b2-schema-validation-errors) +gives the errors +Library specific schema issues usually generate [**SCHEMA_LIBRARY_INVALID**](./Appendix_B.md#schema_library_invalid) errors. + ### 3.1.1. Official schema releases @@ -91,10 +98,6 @@ See [**Appendix A. Schema format details**](./Appendix_A.md) for additional deta The schema header line specifies the version, which must satisfy semantic versioning. See [**SCHEMA_VERSION_INVALID**](./Appendix_B.md#schema_version_invalid). -If the schema is a library schema rather than the standard schema, the library name must be included. -Library names should be lowercase and may only contain alphabetic characters. -Library names must contain only alphabetic lowercase characters and should be short and descriptive. -See [**LIBRARY_NAME_INVALID**](./Appendix_B.md#library_name_invalid). A schema's library name or lack there of is used to locate the schema in the HED schema repository located in the @@ -496,7 +499,7 @@ The following is a translation of the `.mediawiki` example from the previous sec Additional details and rules can be found in appendix [**A.3 XML file format**](./Appendix_A.md#a3-xml-file-format) -## 3.2. HED annotation format +## 3.2. Annotation formats **HED annotations** are comma-separated strings of HED tags drawn from a HED schema vocabulary. @@ -846,10 +849,11 @@ for details on the types of errors that occur with `Def` and `Def-expand`. See also [**Using definitions**](./05_Advanced_annotation.md#52-using-definitions) for more details and examples. -#### 3.2.8.3. `Onset` and `Offset` tags +#### 3.2.8.3. `Onset`, `Offset`, and `Inset` The `Onset` and `Offset` tags are used to represent the temporal extent of events that have non-zero duration. + Each of these tags must appear in a top level tag group with a `Def` or `Def-expand-group` anchor. @@ -870,9 +874,17 @@ in their tag group with the `topLevelTagGroup` attribute. This implies, for example, that HED definition's contents may not include `Onset` or `Offset` tags. -See [**ONSET_OFFSET_ERROR**](./Appendix_B.md#onset_offset_error) and +An `Inset` tag designates an intermediate time point in an event of temporal extent. +Like `Onset` and `Offset`, the `Inset` tag has the `topLevelTagGroup` attribute +and must be anchored by a `Def` or `Def-expand`. +The anchor must be the same name as that of an ongoing `Onset`. +In addition to its anchor, the `Inset` tag group may contain a single additional +tag group with additional information about that marked point. +An event of temporal extent may contain several of these intermediate points. + +See [**ONSET_OFFSET_INSET_ERROR**](./Appendix_B.md#onset_offset_inset_error) and [**TAG_GROUP_ERROR**](./Appendix_B.md#tag_group_error) and -for a listing of specific errors associated with onsets and offsets. +for a listing of specific errors associated with onsets, and offsets, and insets. [**Chapter 5.3.1 Using Onset and Offset**](./05_Advanced_annotation.md#531-using-onset-and-offset) in Chapter 5 gives examples of usage and additional details. @@ -897,85 +909,177 @@ Additional details and examples for `Event-context` can be found in ### 3.2.9. Sidecars -A sidecar is a dictionary that can be used to associate tabular file columns -and their values with HED annotations. -The rows of tabular event files represent time markers on the experimental timeline, -and the assembled annotations for each row describe what happened at that time marker. -A sidecar containing annotations associated with the columns of such an event file -allows HED tools to assemble HED annotations for each row in the file. +JSON sidecars are an integral part of the [**BIDS**](https://bids.neuroimaging.io/) +(Brain Imaging Data Structure) neuroimaging standard and are used to associate +metadata with data files. -The rows of tabular files representing other types of information -can also be annotated in the same way. +The JSON sidecars that are relevant to HED are associated with tabular data files. +For example, the rows of tabular event files represent time markers on the experimental timeline, +and the assembled HED annotations for each row describe what happened at that time marker. +A sidecar containing annotations associated with the columns of such an event file +allows HED tools to assemble HED annotations for each row of the file. -The "HED" key, which may only appear at the second level in the JSON dictionary, -designates an entry that contains HED annotations. -"HED" keys that appear at other levels of the JSON sidecar are considered to be -in error. +In addition to sidecars, HED annotations can also be given in the `HED` column of tabular files. +At validation or analysis time the HED information from both the `HED` column of a tabular file +and its associated sidecar are assembled to provide the annotation. -HED sidecar validation assumes that the dictionary is saved in JSON format and complies with the +HED validators assume that the annotation dictionary is saved in JSON format and +that they comply with the [**BIDS sidecar**](https://bids-specification.readthedocs.io/en/stable/appendices/hed.html) format. #### 3.2.9.1. Sidecar entries -A BIDS sidecar is dictionary with many possible types of entries, three of which are relevant to HED. -These entries all have `"HED"` as a key in one or more second-level dictionaries. +A BIDS sidecar is a JSON dictionary with several types of entries, three of which are relevant to HED: -````{Admonition} Three types of JSON sidecar entries of interest to HED tools -- **Categorical entries**: are associated with a particular event file column and provide -individual annotations for each column value. -The dictionary is not required to provide annotations for every possible -value a categorical column, although tools may choose to issue a warning if appropriate. -The dictionary may also include annotations for values that do not appear in the associated event file column. -

-- **Value entries**: are associated with a particular event file column and provide -an annotation that applies to any entry in the column. -The HED annotation must contain a single `#` placeholder, -and each individual column value is substituted for the `#` in the annotation -when the annotation for the entire row is assembled. +````{Admonition} Three types of JSON sidecar HED-related entries. +**Categorical entries** +- The top-level JSON key corresponds to a column name in the event file. +- The value associated with the HED key is a dictionary of HED annotations. +- The keys of the annotation dictionary are the unique column values. +- The entry is not required to have annotations for every possible unique column value. +- Tools may choose to issue a warning if a column value does not have an annotation. +- The annotation dictionary may include annotations for values that do not appear in a particular event file. -

- -- **Dummy entries**: are similar in format to categorical entries, -but are not associated with any event file columns. -Rather these annotations are mainly used to gather HED definitions. + +**Value entries**: +- The top-level JSON key corresponds to a column name in the event file. +- The value associated with the HED key is a HED string. +- The entry's annotation is applicable to all values in its associated event file column. +- The HED annotation must contain a single `#` placeholder. +- Each row's column value is substituted for the `#` in the annotation +when the row annotation is assembled. + +**Dummy entries**: +- The top-level JSON key must not correspond to a column name in the event file. +- The value associated with the HED key is a dictionary of HED annotations. +- The keys are dummy entries. +- Used to gather HED definitions. ```` -HED definitions are required to be separated into -dummy sidecar column entries. -They may not appear in sidecar entries containing tags other than definitions. +The other types of sidecar entries include categorical and value +entries with no `"HED"` key, as well as arbitrary entries +whose keys do not correspond to column names in an associated tabular file. + +When annotations are assembled, sidecar entries with no `"HED"` key are ignored +as are entries in the corresponding tabular data file that have `n/a` or blank values. + +See [**3.2.9.4. A sidecar example**](./03_HED_formats.md/#3294-a-sidecar-example) +for an elaborated example of these different types of entries and +[**3.2.10.2 Event-level processing**](./03_HED_formats.md/#32102-event-level-processing) +for an example of how the resulting HED annotations are assembled. + +#### 3.2.9.2. Sidecar validation + +All HED-related entries in a JSON sidecar must +have `"HED"` as a key in a second-level dictionary. +`"HED"` cannot appear as a sidecar key that is not at the second level. +Further, a sidecar is not permitted to provide a HED annotation for `n/a`. +Both of these generate a [**SIDECAR_INVALID**](./Appendix_B.md#sidecar_invalid) error. + +HED definitions are required to be separated into dummy sidecar column entries +and cannot appear in sidecar entries containing tags other than definitions. +A HED definition appearing in a categorical or value sidecar entry +generates a [**DEFINITION_INVALID**](./Appendix_B.md#definition_invalid) error. The sidecar does not have to provide a HED-relevant entry for every event file column. -Columns with no corresponding sidecar entry are skipped during assembly of the HED annotation -for an event file row. +Columns with no corresponding sidecar entry are skipped during assembly of the +HED annotation for an event file row. +However, if a value is encountered in a tabular file column that is +annotated as a categorical column but does not have a HED annotation, +a [**SIDECAR_KEY_MISSING**](./Appendix_B.md#sidecar_key_missing) warning is generated. + +HED value sidecar entries must contain exactly one `#` placeholder in +the HED string annotation associated with the entry. +The `#` placeholder should correspond to a `#` in the HED schema, +indicating that the parent tag (also included in the annotation) expects a value. +These issues generate a [**PLACEHOLDER_INVALID**](./Appendix_B.md#placeholder_invalid) error. + +If the placeholder is followed by a unit designator, the validator checks that +these units are consistent with the unit class of the +corresponding `#` in the schema. The units are not mandatory. + +#### 3.2.9.3. Sidecar curly braces -For compatibility with [**BIDS**](https://bids.neuroimaging.io/), -tabular file column entries containing `n/a` are ignored. -The sidecar is not permitted to provide an annotation for `n/a`. -Further, `"HED"` can only appear as a second-level dictionary key. +The curly brace notation is new with HED specification version 3.2.0 and is +supported by all versions of the HED schema ≥ 8.0.0. +The notation was introduced to +facilitate proper nesting of HED tags associated with different event file +columns when the complete HED annotation for an event marker is assembled. -The following example illustrates the three types of JSON sidecar entries that are relevant to HED. -Entries without a `"HED"` key in the second level entry dictionaries are ignored. +When a column name appears in curly braces within a HED annotation in +a JSON sidecar, the corresponding HED annotation for that row is substituted +for the curly braces and their contents when the HED annotation is assembled. + + +``````{admonition} Rules for curly braces notation in sidecars. +:class: tip + +1. The item within the curly braces must either be the word `HED` or +the name of another HED-annotated column within the sidecar. +2. The HED annotation for the column in curly braces directly replaces the curly braces and their contents in the target annotation. +3. During assembly of a HED annoation for an event, if the 'n/a' value appears in a curly brace column, +the curly brace expression including the curly braces as well as any extra parentheses or commas are removed. +4. A sidecar column name cannot both appear in a curly braces and have +an annotation that uses curly braces (to prevent circular references). +5. The curly braces cannot be used within a `Definition`. + +`````` + +If curly braces appear in the HED column of a tabular file, +a [**CHARACTER_INVALID**](./Appendix_B.md#character_invalid) error is generated. + +If curly braces appear in a `Definition`, +a [**DEFINITION_INVALID**](./Appendix_B.md#definition_invalid) error is generated. + +If the curly brace notation is used improperly in a sidecar or elsewhere, a +[**SIDECAR_BRACES_INVALID**](./Appendix_B.md#sidecar_braces_invalid) is generated. + + +#### 3.2.9.4. A sidecar example + +The following example illustrates the different types of JSON sidecar entries. (example-sidecar-anchor)= -````{Admonition} Examples of the three types of sidecar annotation entries relevant to HED +````{Admonition} Different types of sidecar annotation entries that might appear in :class: tip ```json { - "trial_type": { + "event_type": { "LongName": "Event category", - "Description": "Indicator of type of action that is expected", + "Description": "Indicator of type of event.", + "Levels": { + "show": "Show a face to a participant.", + "press": "Participant presses key to indicate symmetry." + }, "HED": { - "go": "Sensory-event, Visual-presentation, (Square, Blue)", - "stop": "Sensory-event, Visual-presentation, (Square, Red)" + "show": "Sensory-event, Visual-presentation, {stim_file}", + "press": "Agent-action, (Experiment-participant, (Press, {key}))" } }, - "response_time": { - "LongName": "Response time after stimulus", + "stim_file": { + "LongName": "Stimulus image file", "Description": "Time from stimulus presentation until subject presses button", - "HED": "(Delay/# ms, Agent-action, (Experiment-participant, (Press, Mouse-button)))" + "HED": "(Image, Face, Pathname/#)" + }, + "key": { + "LongName": "Indicates which key is pressed.", + "Description": "Indicator of participant evaluation.", + "HED": { + "left-arrow": "((Leftward, Arrow), Keypad-key)", + "right-arrow": "((Rightward, Arrow), Keypad-key)" + } + }, + "symmetry": { + "LongName": "Indicates symmetrical or asymmetrical.", + "Description": "Indicates the participant's judgement of symmetry.", + "HED": { + "symmetric": "(Judge, Asymmetrical)", + "asymmetric": "(Judge, Symmetrical)" + } }, + "dummy_defs": { "HED": { "MyDef1": "(Definition/Cue1, (Buzz))", @@ -986,23 +1090,32 @@ Entries without a `"HED"` key in the second level entry dictionaries are ignored ``` ```` -In the example, the `trial_type` key references a **categorical** entry. -Categorical entries have keys corresponding to the event file column names. -The value of a categorical entry is a dictionary which has a `"HED"` key. -In the above example, the keys of this second dictionary are the values (`go` and `stop`) that -appear in the `trial_type` column of the event file. -The values are the HED annotations associated with those values. -Thus, the `"Sensory-event, Visual-presentation, (Square, Blue)"` is the HED annotation -associated with a `go` value in the `trial_type` column of the associated event file. - -The `response_time` key references a **value annotation**. -Value entries have keys, one of which is `"HED"`. -Associated with the `"HED"` key is a HED annotation value. -There must be exactly one `#` placeholder in the annotation. -The actual value in the `response_time` column is substituted for the -`#` when the annotation is needed. - -The `dummy_defs` is an example of a **dummy annotation**. +In the example, `"event_type"` is the name of a column that is annotated using the +**categorical** strategy. +Its top-level dictionary has `"LongName"`, `"Description"`, `"Levels"`, and `"HED"` keys. + +The value of `"Levels"` is a dictionary with the unique values in the `"event_type"` +column keyed to full text descriptions of these unique values. + +The value of `"HED"` is a dictionary with the unique values in `"event_type"` +keyed to the corresponding HED annotations of these unique values. +In the above example, the unique values are `"show"` and `"press"`. +The HED annotation for `show` is `"Sensory-event, Visual-presentation, {stim_file}"`. + +Notice use of curly braces in the notation. Here `"stim_file"` must +correspond to another HED-annotated column in the sidecar. +The `"stim_file"` column is an example of a value column. +Its top level dictionary keys are `"LongName"`, `"Description"`, and `"HED"`. +and its annotation entry: +`"(Image, Face, Pathname/#)"`. +This annotation has a single `#`. +The filename in the `stim_file` column replaces this `#` when the + +Since `"stim_file` and `"key"` appear within curly braces in annotations +for `"event_type"`, their HED annotations can not use curly braces. + + +The `"dummy_defs"` is an example of a **dummy annotation**. The value of this entry is a dictionary with a `"HED"` key pointing to a dictionary. A dummy annotation is similar in form to a **categorical annotation**, @@ -1015,27 +1128,6 @@ while `Definition/Image/#` is a definition whose name `Image` is modified by a p Notice that `Image` is both a definition name and an actual tag in the schema in this example. This is permitted. -#### 3.2.9.2. Sidecar validation - -As with other entities definitions should be removed from sidecars and validated separately, -although validation error messages for such definitions should be associated with -the locations of the definitions in the sidecars. - -HED categorical sidecar entries contain HED strings and should be validated in the same way. - -HED value sidecar entries must contain exactly one `#` placeholder in the HED string annotation associated -with the entry. The `#` placeholder should correspond to a `#` in the HED schema, -indicating that the parent tag (also included in the annotation) expects a value. - -If the placeholder is followed by a unit designator, the validator checks that -these units are consistent with the unit class of the -corresponding `#` in the schema. The units are not mandatory. - -Errors that are particularly relevant to sidecars include [**PLACEHOLDER_INVALID**](./Appendix_B.md#placeholder_invalid) and [**SIDECAR_INVALID**](./Appendix_B.md#sidecar_invalid). - -If the sidecar is missing an annotation for a categorical column value, -the [**SIDECAR_KEY_MISSING**](./Appendix_B.md#sidecar_key_missing) warning is generated. - ### 3.2.10. Tabular files @@ -1077,35 +1169,64 @@ the HED strings associated with each row of the tabular file must be assembled t annotation for the row. We refer to this as *event-level* or *row* processing. -````{Admonition} General procedure for event-level (row) processing. - -1. Start with an empty list. -2. For each categorical column, the column value for the row is looked up in the sidecar. -If an annotation for that column value is available it is concatenated to the list. -3. For each value column, if a column an associated value entry in the sidecar, -the row value is substituted for `#` placeholder in the annotation and the result concatenated to the list. -4. If a `HED` column annotation exists for that row, it is concatenated to the list. -5. Finally, all the entries of the list are joined using a comma (`,`) separator. - -In all cases `n/a` column values are skipped. -```` - -For an example, see [**How HED works in BIDS**](https://www.hed-resources.org/en/latest/BidsAnnotationQuickstart.html#how-hed-works-in-bids) tutorial. - If the HED schema used for processing contains a schema node that has the `required` attribute, then the assembled HED annotations for each row must include that tag. -Currently, HED schema versions >= 8.0.0 do not contain any nodes with the `required` +Currently, HED schema versions ≥ 8.0.0 do not contain any nodes with the `required` attribute, and this attribute may be deprecated in future versions of the schema. If the HED schema used for processing contains a schema node that has the `unique` attribute, then the assembled HED annotations for each row must contain no more than one occurrence of that tag. -Currently, only `Event-context` has the `unique` attribute for HED schema versions >= 8.0.0. +Currently, only `Event-context` has the `unique` attribute for HED schema versions ≥ 8.0.0. See [**REQUIRED_TAG_MISSING**](./Appendix_B.md#required_tag_missing) and [**TAG_NOT_UNIQUE**](./Appendix_B.md#tag_not_unique) for information on the validation errors that may occur with tags that have the `required` or `unique` schema attributes, respectively. +````{Admonition} General procedure for event-level (row) assembly. + +1. Create an empty result list. +2. Create an assembly list of columns that contain HED annotations +and whose names do not appear in the curly braces of other HED annotations. +3. For each the column in the assembly list look up the annotation in the sidecar, replacing all curly braces and place holder values appropriately. +Append to the result list. +4. If a `HED` column annotation exists for that row and `HED` did not appear +in curly braces in the sidecar, concatentate the annotation to the result list. +5. Finally, join all the entries of the result list using a comma (`,`) separator. + +In all cases `n/a` column values are skipped. +```` + +To illustrate the assembly process, consider the following excerpt from an event file: + + +````{Admonition} General procedure for event-level (row) assembly. + +| onset | duration | event_type | stim_file | key | symmetry | HED | +| ----- | -------- | ---------- | --------- | --- | -------- | --- | +| 3.42 | n/a | show | h234.bmp | n/a | n/a | "(Recording, Label/Setup)" | +| 3.86 | n/a | press | n/a | left-arrow | asymmetric | n/a | +| 7.42 | n/a | show | h734.bmp | n/a | n/a | n/a | +```` + +Using the [**example sidecar**](example-sidecar-anchor) +results in the following assembled HED annotation for the first row of the event file: + +````{Admonition} A result for event-level (row) assembly of the sample file. +:class: tip + +```shell +"Sensory-event, Visual-presentation, (Image, Face, Pathname/h234.bmp), (Recording, Label/Setup)" +``` +```` + +The specific annotation `(Image, Face, Pathname/h234.bmp)` has been substituted for +`{stim_file}` and the annotation for in the `HED` column of the `events.tsv` file +has been included. The entries with `n/a` have been ignored. + +For more examples of event assembly, see [**How HED works in BIDS**](https://www.hed-resources.org/en/latest/BidsAnnotationQuickstart.html#how-hed-works-in-bids) tutorial. + + #### 3.2.10.3 File-level processing HED versions >= 8.0.0 allow annotation of relationships among rows in a tabular file. @@ -1118,5 +1239,40 @@ The validator must also check to make sure that `Onset` and `Offset` tags are properly matched within the data recording. In particular every `Offset` tag group must correspond to a preceding `Onset` tag group. -See [**ONSET_OFFSET_ERROR**](./Appendix_B.md#onset_offset_error) for details on the +See [**ONSET_OFFSET_INSET_ERROR**](./Appendix_B.md#onset_offset_inset_error) for details on the type of errors that are generated due to `Onset` and `Offset` errors. + + +## 3.3. Semantic versioning + +HED schema use the following rules for +changing the *major.minor.patch* semantic version. +These rules are based on the assumption that the [**HED tag**](https://hed-specification.readthedocs.io/en/latest/02_Terminology.html#hed-tag) +short form will not require data annotators to retag their data for patch-level or minor-version changes of the schema. +That is, a dataset tagged using schema version *X.Y.Z* will also validate for *X.Y+.Z+*. +However, the reverse is not necessarily true. +In addition, validation errors might occur +during for patch-level or minor-version changes for changes or +corrections in tag values or units. + +Here is a summary of the types of changes that correspond to different +levels of changes in the semantic version: + +| Change | Semantic-level | +| ---------------------------------- | -------------- | +| Major addition to HED functionality | Major | +| Tag deleted from schema. | Major | +| Unit or unit class removed from node. | Major | +| New tag added to the schema. | Minor | +| New attribute added to schema. | Minor | +| New unit class or unit added to schema. | Minor | +| New unit class added to node. | Minor | +| Node moved in schema without change in meaning. | Minor | +| Revision of description field in schema. | Patch | +| Correction of suggestedTag or relatedTag. | Patch | +| Correction of wiki syntax such as closing tags. | Patch | + +**Note:** It is an official policy that once in a schema, a node will not be removed. +If a node becomes out-of-date, a `deprecated` attribute will be added to the tag in the schema. +Suggested replacement tags should be included in the node description. +A suggested replacement should be added to the tag patch table. diff --git a/docs/source/05_Advanced_annotation.md b/docs/source/05_Advanced_annotation.md index dd79b42..43e66aa 100644 --- a/docs/source/05_Advanced_annotation.md +++ b/docs/source/05_Advanced_annotation.md @@ -228,7 +228,12 @@ Using this method, an event with temporal scope actually corresponds to two poin The initiation event is tagged by a `(Def/xxx, Onset)` where `xxx` is a defined name. The end of the event’s temporal scope is marked either by a `(Def/xxx, Offset)` or by -another `(Def/xxx, Onset)`. The `Def/xxx` is said to **anchor** the definition. +another `(Def/xxx, Onset)`. The `Def/xxx` is said to **anchor** the `Onset` +(and similarly for `Offset`). +By anchor, we mean that tools use the anchor to determine +where each event of temporal extent begins and ends. +A `Def-expand` tag group can also anchor the `Onset` and `Offset` groups. + The `Onset` tag group may contain an additional internal tag group in addition to the anchor `Def` tag. This internal tag group usually contains annotations specific to this instance of the event. As with all HED tags and groups, order does not matter. @@ -255,18 +260,20 @@ interchangeably with the `Def/xxx`. **Long forms:** ~ *(Property/Organizational-property/Def/xxx,* - *Property/Data-property/Data-marker/Temporal-marker/Onset, (tag-group)* + *Property/Data-property/Data-marker/Temporal-marker/Onset, (tag-group))* ~ *(Property/Organizational-property/Def/xxx/#,* - *Property/Data-property/Data-marker/Temporal-marker/Onset, (tag-group)* - ~ *(Property/Organizational-property/Def/xxx, Property/Data-property/Data-marker/Temporal-marker/Offset)* - ~ *(Property/Organizational-property/Def/xxx/#, Property/Data-property/Data-marker/Temporal-marker/Offset)* + *Property/Data-property/Data-marker/Temporal-marker/Onset, (tag-group))* + ~ *(Property/Organizational-property/Def/xxx,* + *Property/Data-property/Data-marker/Temporal-marker/Offset)* + ~ *(Property/Organizational-property/Def/xxx/#,* + *Property/Data-property/Data-marker/Temporal-marker/Offset)* ````{admonition} Notes: :class: tip 1. *xxx* is the name of the definition anchoring the scoped event. 2. *yyy* is the value substituted for a definition's placeholder if it has one. -3. The *(tag-group)* contains optional tags specific to that temporal event. -This tag group is not the tag group specifying the contents of the definition.. +3. The *(tag-group)*, which is optional, contains tags specific to that temporal event. +This tag group is not the tag group specifying the contents of the definition. 4. The additional tag-group is only in effect for that particular scoped event and not for all events anchored by *Def/xxx*. 5. If the *Def/xxx/#* form is used, the `#` must be replaced by an actual value. @@ -295,9 +302,9 @@ playing of different clips. **Long form:** > [event 1] > *Event/Sensory-event,* -> *(Attribute/Informational/Def/PlayMovie,* +> *(Property/Organizational-property/Def/PlayMovie,* > *Data-property/Data-marker/Temporal-marker/Onset,* -> *(Attribute/Informational/Label/StarWars,* +> *(Property/Informational-property/Label/StarWars,* > *(Item/Object/Man-made-object/Media/Media-clip,* > *Properity/Informational-property/ID/3284)))* @@ -305,7 +312,7 @@ playing of different clips. > [event n] > *Event/Sensory-event,* -> *(Attribute/Informational/Def/PlayMovie,* +> *(Property/Organizational-property/Def/PlayMovie,* > *Data-property/Data-marker/Temporal-marker/Offset)* ```` @@ -351,6 +358,45 @@ Library functions in Python, Matlab, and JavaScript are available to support gathering of definitions and the expansion. These definitions may be given in JSON sidecars or provided externally. +### 5.3.2. Using `Inset` + +The `Inset` tag group marks an intermediate point in an event of temporal extent +defined by `Onset` and `Offset`. +Like the `Offset`, the `Inset` tag is anchored by a `Def` tag or `Def-expand` tag group +that is the anchor of its enclosing `Onset`. + +The `Inset` tag group may contain an additional internal tag group in addition to the +anchor `Def` tag. This internal tag group usually contains annotations specific +to this instance of the event. As with all HED tags and groups, order does not matter. + +The following table summarizes `Inset` usage. +**Note**: A `Def-expand/xxx` tag group can be used +interchangeably with the `Def/xxx`. + + +``````{admonition} **Syntax summary for Inset.** +**Short forms:** + ~ *(Def/xxx, Inset, (tag-group))* + ~ *(Def/xxx/yyy, Inset, (tag-group))* + +**Long forms:** + ~ *(Property/Organizational-property/Def/xxx,* + *Property/Data-property/Data-marker/Temporal-marker/Inset, (tag-group))* + ~ *(Property/Organizational-property/Def/xxx/#,* + *Property/Data-property/Data-marker/Temporal-marker/Inset, (tag-group))* + +````{admonition} Notes: +:class: tip +1. *xxx* is the name of the definition anchoring the scoped event. +2. *yyy* is the value substituted for a definition's placeholder if it has one. +3. The *(tag-group)*, which is optional, contains information specific to that intermediate. +point in the ongoing event. This tag group is not the tag group specifying the contents of the definition.. +4. The additional tag-group is only in effect at that particular point. +5. If the *Def/xxx/#* form is used, the `#` must be replaced by an actual value that is +the same as the value used for its `Onset`. +```` +`````` + ### 5.3.2. Using `Duration` diff --git a/docs/source/06_Infrastructure_and_tools.md b/docs/source/06_Infrastructure_and_tools.md index c18c6c8..a134ffd 100644 --- a/docs/source/06_Infrastructure_and_tools.md +++ b/docs/source/06_Infrastructure_and_tools.md @@ -9,7 +9,7 @@ In general, tools should either explicitly call HED validation to assure that th tag strings are valid or should make explicit that they assume the HED has already been validated. Most tools will use the later approach. -See [**3.2. HED annotation format**](./03_HED_formats.md#32-hed-annotation-format) +See [**3.2. Annotation formats**](./03_HED_formats.md#32-annotation-formats) for more detailed specifications of HED formats. See [**4. Basic annotation**](./04_Basic_annotation.md) and @@ -53,7 +53,8 @@ on tag forms. Tools may assume that validated HED strings have no duplicates, empty tags, empty groups (parentheses enclosing only whitespace), or mismatched parentheses. -Grouping with parentheses in HED means that the tags are associated. +Grouping with parentheses in HED indicates that the tags are associated. +Where possible, parentheses should be preserved. ````{warning} HED-compliant tools should be able to handle arbitrary correctly **nested parentheses** diff --git a/docs/source/07_Library_schemas.md b/docs/source/07_Library_schemas.md index 0cac1b0..5d79371 100644 --- a/docs/source/07_Library_schemas.md +++ b/docs/source/07_Library_schemas.md @@ -1,11 +1,13 @@ -# 7. Library schema +# 7. Library schemas -The variety and complexity of events in electrophysiological experiments makes full +## 7.1. Why library schemas? + +The variety and complexity of events in electrophysiological experiments make full documentation challenging. As more experiments move out of controlled laboratory environments and into less controlled virtual and real-world settings, the terminology required to adequately describe events has the potential to grow exponentially. -In addition, experiments in any given subfield can contribute to pressure to add +In addition, experiments in any given subfield can create pressures to add overly-specific terms and jargon to the schema hierarchy—for example, adding musical terms to tag events in music-based experiments, video markup terms for experiments involving movie viewing, traffic terms for experiments involving @@ -16,104 +18,363 @@ vocabularies for describing data features of clinical interest (e.g., seizure, s Including these discipline-specific terms quickly makes the standard HED schema unwieldy and less usable by the broader user community. -Third generation HED instead introduces the concept of the **HED library schema**. -To use a programming analogy, when programmers write a Python module, the resulting code -does not become part of the Python language or core libraries. Instead, the module becomes -part of a library used in conjunction with core modules of the programming language. +Third generation HED addressed the problem of vocabulary bloat by introducing +**HED library schemas** to organize discipline-specific terminology. +To use a programming analogy, when programmers write a Python module, +the resulting code does not become part of the Python language or core libraries. +Instead, the module becomes part of a library used in conjunction with +core modules of the programming language. + +A HED library schema contains the specialized vocabulary terms needed +for event annotation in a specialized area. +An example of such a library is the [**HED SCORE schema**](https://hed-schemas.readthedocs.io/en/latest/hed_score_schema.html) for annotation of EEG by clinicians. + +## 7.2. Partnered schemas + +HED library schemas were originally assumed to be **standalone** vocabularies, +complete with all the needed schema attributes and properties. +These standalone library schemas were usually used in conjunction with the +HED standard schema, and the tags from the two different vocabularies +were distinguished by prefixing the tags from one of the vocabularies with `xx:`. +Here `xx:` is called the **namespace** for that schema within the annotation +and is chosen by the annotator. + +**Partnered library schemas** were introduced in HED specification version 3.2.0 +and are supported by HED standard schema versions ≥ 8.2.0. + +A partnered library schema version is tied to a specific version of the HED standard schema +as specified in its header. +A given library schema version is either **partnered** or **standalone**. + +### 7.2.1. Partnered files + +The XML file corresponding to a partnered library schema is a single, unified schema +containing the information from both the library and its standard schema partner +and validated as an integrated whole. + +This XML merged schema file is downloaded and used by tools. +Downstream tools see a single schema and can process it with no special handling. +The following example shows the XML header for merged SCORE library version 1.1.0. + +````{admonition} XML header for SCORE library 1.1.0 partnered with 8.2.0 (merged). +```xml + + + +``` +```` +The canonical filename for this `.xml` file is `HED_score_1.1.0.xml`. +This file is always stored in the `hedxml` directory +for the respective library schema in the +[**hed-schemas**](https://github.com/hed-standard/hed-schemas) GitHub repository. + +As with any HED schema, schema builders develop and maintain their schema in +MediaWiki mark-down format and use tools to convert to XML. +The schema developer's version is unmerged, +containing only the information specific to the library schema. +The following example shows the header for the `.mediawiki` developer's version +of a partnered library schema. + +````{admonition} Mediawiki header for SCORE library 1.1.0 partnered with 8.2.0 (unmerged). +```html +HED library="score" version="1.1.0" withStandard="8.2.0" unmerged="true" +``` +```` + +The canonical filename for this `.mediawiki` file is +`HED_score_1.1.0_unmerged.mediawiki`. + +Tools also support an alternative form of the `.mediawiki` library schema +containing all the information in the merged schema (a mirror to the XML), +which may be useful for debugging, but is usually not explicitly created. + +The following table summarizes the different partnered library schema formats +and their uses. File names and link examples are specifically for the SCORE +library. For other libraries, substitue the library name for the word *score*. + +| Format | Merged
status | Canonical filename | Handling | +| ------ | ------------- | ------------------ | -------- | +| XML | merged | `HED_score_1.1.0.xml` | Stored in library [**hedxml**](https://github.com/hed-standard/hed-schemas/tree/main/library_schemas/score/hedxml).
Used by tools. | +| XML | unmerged | `HED_score_1.1.0_unmerged.xml` | Can be generated but is never
stored on [**hed-schemas**](https://github.com/hed-standard/hed-schemas).
Not used, but available for completeness. | +| MediaWiki | merged | `HED_score_1.1.0.mediawiki` | Usually not stored in [**hedwiki**](https://github.com/hed-standard/hed-schemas/tree/main/library_schemas/score/hedwiki).
Possibly used during schema development. | +| MediaWiki | unmerged | `HED_score_1.1.0_unmerged.xml` | Working format for developers
Should be stored in [**hedwiki**](https://github.com/hed-standard/hed-schemas/tree/main/library_schemas/score/hedwiki). | + +### 7.2.2. Partnered formats + +There are four significant differences between merged and unmerged MediaWiki formats: +1. The unmerged version has the `unmerged="true"` attribute in its header line. +
 
+2. The unmerged version should only include the auxiliary sections (e.g., unit classes, +unit modifiers, value classes, schema attributes, and schema properties) +that it explicitly extends. +
 
+3. Nodes with the `rooted` property must be top-level tags in the schema +in the unmerged schema. In the merged schema, the subtrees under these `rooted` +nodes are placed directly under the respective nodes of the same name +in the standard schema. +
 
+4. Nodes in the unmerged version cannot have the `inLibrary` attribute. +In contrast, nodes from the library schema are given the `inLibrary` +attribute during the merging process. + +Similar differences occur between the merged and unmerged XML formats, +but only the merged XML format is useful. + +### 7.2.3. Auxiliary sections + +The unmerged version of a partnered library schema **must** have +prologue and epilogue sections that appropriately explain the +purpose of the library schema. +The contents of these prologue and +epilogue sections become the prologue and epilogue, respectively, +in the merged schema. + +All the other auxiliary sections of the corresponding partner standard schema +are inherited by the merged schema. +Most unmerged partnered library schemas will not contain any additional +auxiliary sections. + +**Auxiliary section items that do not appear in a standard schema +are unlikely to be supported by the HED infrastructure if +they require special handling.** +Thus, adding items to the auxiliary library schema sections is discouraged. + +Library schema developers who need to add an item, such as +a unit class to an auxiliary section, +should first contact the HED Working Group to determine whether +this item could be appropriately added to the standard schema. +If a new item must be added, only that item and its corresponding +auxiliary section should appear in the unmerged schema. + +Library schema additions of units, unit classes, unit modifiers, value classes, +and schema attributes are permitted, though not encouraged. +**Library schemas cannot add information to the property definitions +section of the schema.** + +### 7.2.4. Partnered attributes + +To support partnered library schema the following items were introduced in +HED standard schema 8.2.0: + +| Name | Type | Role | +| --------- | ----- | ---- | +| `withStandard` | Header attribute | | +| `unmerged` | Header attribute | | +| `inLibrary` | Element attribute | | +| `rooted` | Node attribute | | +| `reserved` | Node attribute | . | + + +### 7.2.5. Motivation for partners +Starting with HED specification version 3.2.0 and HED standard schema version 8.2.0, +**partnered library schemas** have become the recommended form for library schemas. +This section describes the motivation for this preference. + +#### 7.2.5.1. Auxiliary consistency + +A standalone library schema must duplicate the +[**auxiliary schema sections**](https://hed-specification.readthedocs.io/en/latest/Appendix_A.html#a-1-auxiliary-schema-sections) appearing in standard schemas, +introducing the possibility of inconsistency in usage or definition +between the library schema and standard schemas. + +Partnered library schema automatically inherit the partner standard schema's auxiliary attributes, +this assuring consistent handling by tools and preventing the introduction of inconsistently +handled attributes. + +Although standalone library schemas may add additional items to the auxiliary sections, +HED tools only guarantee support of standard schema auxiliary items requiring special handling. +**Thus, addition of items in the auxiliary sections of a library schema is discouraged.** + + +#### 7.2.5.2. Reserved tag handling + +Several tags in the standard schema such as `Definition`, `Onset`, and `Offset` +define the structure of events and the data. +By partnering with a standard schema, a library schema is assured of having +HED support for key features such as events of temporal extent and definitions. + +Developers of partnered library schemas should release new versions +whenever HED updates its standard schema. +This ensures that the partnered library schema benefits from the latest updates to HED features and tools. + +If the update can be done without conflict, +this update may be initiated as part of the release mechanism +by the maintainers of the HED repositories. + +#### 7.2.5.3. Annotation conciseness + +The most common use case for library schemas in annotation requires tags from both +a standard schema and a library schema, thus requiring that a `xx:` be assigned to tags from +one of the schemas when standalone library schemas are used. + +Because a partnered library schema is merged with a standard schema to form a single, unified schema, +users can annotate data without the `xx:` prefix. +The `xx:` is still needed if more than one library schema is used. + +#### 7.2.5.4. Library searches + +The subtrees appearing in the library schemas are often elaborations of a particular term +in the standard schema. +However, if the library schema terms are not in appropriate standard schema hierarchy, +HED search can not be leveraged to find these elaborations by searching for a more +general standard schema term. + +#### 7.2.5.5. Suggested tags + +Standalone library schemas cannot use the `suggestedTag` or `relatedTag` attributes to +suggest using particular tags from the standard schema, +since the values of the tags must be in the schemas themselves. +However, with partnered library schemas, validation is only performed on +the merged versions of the schema, so tags from the standard schema can be used +as `suggestTag` or `relatedTag` values. + + +## 7.3. Library schema design + +Library schema should be developed and maintained in MediaWiki format for readability. +Developers should always validate the schema before converting to XML. +Only validated versions of the schema should be uploaded to the GitHub +[**hed-schemas**](https://github.com/) repository. +More information about the development process is contained in the +[**HED schema developers guide**](https://www.hed-resources.org/en/latest/HedSchemaDevelopersGuide.html). + + +### 7.3.1. General design rules -Similar to the design principles imposed on function names and subclass organization in -software development, HED library schemas must conform to some basic rules: +This section summarizes the general design rules for all library schema. -``````{admonition} Rules for HED library schema design. +``````{admonition} General design rules for HED library schema. :class: tip -1. A library schema must be given a name containing only alphabetic chararacters. +1. **Follow naming conventions**:
+A library schema must be given a name containing only alphabetic chararacters. This name must appear in the schema header line in the required format. -2. A library library must use semantic versioning and follow the versioning update rules used by -the HED standard schema. -3. Every term must be unique within the library schema and must conform to the rules for -HED schema terms. -4. Schema terms should be readily understood by most users. The terms should not be ambiguous and +
 
+2. **Use semantic versioning**:
+A library library must use semantic versioning and follow the versioning update rules used by +the HED standard schema as specified in [**Semantic versioning**](./03_HED_formats.md#33-semantic-versioning). +
 
+3. **Tag uniqueness**:
+Every term must be unique within the library schema and must +conform to the rules for HED schema terms. +
 
+4. **Have a meaningful prologue**:
+The schema should include a prologue section giving an overview, purpose and scope +of the library schema. +
 
+5. **Have a meaningful epilogue**:
+The schema should include an epilogue section containing reference, citation, and license information. +
 
+6. **Be understandable**:
+Schema terms should be readily understood by most users. The terms should not be ambiguous and should be meaningful in themselves without reference to their position in the schema hierarchy. -5. If possible, no schema sub-tree should have more than 7 direct subordinate sub-trees. -6. Terms that are used independently of one another should be in different sub-trees (orthogonality). -7. The schema should include the schema attributes, unit classes, unit modifiers, value classes, -and schema properties present in the HED standard schema. +
 
+7. **Be well-organized**:
+If possible, no schema sub-tree should have more than 7 direct subordinate sub-trees. +
 
+8. **Maintain subtree orthogonality**:
+Terms that are used independently of one another should be in different sub-trees (orthogonality). +
 
+9. **Enforce is-a relationship between child nodes and their parents**:
+Every node in a HED hierarchy must be a subclass of its parent node. +This is required for HED search generalizability. `````` +Rules 1 through 5 are enforced by validators, while rules 6 through 9 are +the responsibility of the schema designers and review committees. -As in Python programming, we anticipate that many HED schema libraries may be defined -and used, in addition to the standard HED schema. Libraries allow individual research -communities to annotate details of events in experiments designed to answer questions -of interest to particular research or clinical communities. Since it would be impossible -to avoid naming conflicts across schema libraries that may be built in parallel by different -user communities, HED supports schema library namespaces -(the prefix notation described in the previous section). -Users will be able to add library tags qualified with namespace designators. -All HED schemas, including library schemas, -adhere to [**semantic versioning**](https://semver.org/). - -In general, library schema developers should include the auxiliary schema classes from -the standard HED schema: the schema attributes, unit classes, unit modifiers, -value classes, and schema properties. The HED tools support these auxiliary -classes but in general would not support special handling of added classes beyond basic -verification. +In general, library schema developers should avoid adding schema terms that +duplicate those found in the latest HED standard schema at the time of release. +Library schema developers should also try to avoid overlap of terms found +in other schema libraries. + +All HED schemas, including library schemas, must use [**semantic versions**](https://semver.org/) and +adhere to the rules specified [**3.3 Semantic versioning**](./03_HED_formats.md/#33-semantic-versioning). + +Standalone library schema developers must include the auxiliary schema classes from +the standard HED schema including the schema attributes, unit classes, unit modifiers, +value classes, and schema properties. +No changes should be made to these sections since HED tools support the special auxiliary +classes from the standard schema, +but in general do not support special handling of added classes beyond basic verification. If your application requires schema classes that are not available in the standard HED schema and would like these classes to be supported, -please make a request using the [**HED examples issues**](https://github.com/hed-standard/hed-examples/issues) forum. +please make a request using the [**issues**](https://github.com/hed-standard/hed-schemas/issues) +forum of the [**hed-schemas**](https://github.com/hed-standard/hed-schemas) GitHub repository. -A schema should not duplicate tags found in the standard schema. -## 7.1. Defining a schema +### 7.3.2. Standalone design rules -A HED library schema is defined in the same way as the standard HED schema -except that it has an additional attribute name-value pair `library="xxx"` -in the schema header. -We will use as a library schema for driving as an illustration. -Syntax details for a library schema are similar to those for the standard HED schema. +The following design rules are specifically meant for standalone library schemas. +``````{admonition} Design rules specific to standalone HED library schemas. +:class: tip -````{admonition} **Example:** Driving library schema (MEDIAWIKI template). +1. **Avoid tag duplication**:
+The terms in the library schema should not overlap terms present in the latest +version of the HED schema at the time of its release. +
 
+2. **Do not modify the special auxiliary sections**:
+The standalone library schema should exactly duplicate of special auxiliary sections +of the HED standard schema that was the latest version when this schema version was released. +The special sections include: schema attributes, unit classes, +unit modifiers, value classes, and schema properties. +
 
+3. **Avoid adding special auxiliary items**:
+A library schema may not modify any of the items in the special sections +of the HED standard schema. +
 
+4. **Obtain the appropriate reviews early**:
+Any additions to the special sections must be reviewed by the HED Working Group to +determine what requirements the additions would impose on downstream tools. +This should be done as early in the process as possible. -```moin -HED library="driving" version="1.0.0" -!# start schema - [... contents of the HED driving schema ...] -!# end schema - [... required sections specifying schema attribute definitions ...] -!# end hed -``` -```` +`````` -The required sections specifying the schema attributes are *unit-class-specification*, -*unit-modifier-specification*, *value-class-specification*, *schema-attribute-specification*, -and *property-specification*. +Standalone library schemas are no longer recommended because of the difficulty +in enforcing conflict rules with HED standard schemas. -````{admonition} **Example:** Driving library schema (XML template). +### 7.3.3. Partnered design rules -```xml - - - [... contents of the HED_DRIVE schema ... ] - -``` -```` +Partnered library schemas are now the recommended format for the reasons +listed in [**Motivation for partners**](./07_Library_schemas.md#725-motivation-for-partners). +The following design rules are specifically meant for partnered library schemas. -During annotation tags from different library schemas can -be intermixed with those of the standard schema. -Since the node names within a library must be -unique, annotators can use short form as well as fully expanded tag paths for library schema -tags as well as those from the standard HED schema. +``````{admonition} Design rules specific to partnered HED library schemas. +:class: tip -The schema XML file should be saved as `HED_driving_1.0.0.xml` so that tools can locate them. -The official location of HED standard and library schemas is the -[**hed-schemas**](https://github.com/hed-standard/hed-schemas) GitHub repository. +1. **Check for overlap**:
+The terms in the partnered library schema must not overlap with terms present in its partnered +standard schema. +
 
+2. **Use the latest released version of the standard schema**:
+A partnered library schema should always use the latest version of the HED schema +available at the time of its release. +
 
+3. **Do not put any auxiliary sections**:
+A partnered library schema should not contain the special auxiliary sections (e.g., schema attributes, unit classes, unit modifiers, value classes, and schema properties), +unless a new item is added to the section, in which only that item should appear. +
 
+4. **Seek reviews early in the process**:
+Any additions to the special sections must be reviewed by the HED Working Group to +determine what requirements the additions would impose on downstream tools. + +`````` +It is recognized that HED standard and library schemas will both evolve and +that additions or tag reorganizations may cause conflicts. +These conflicts must be resolved as they occur. +In general the standard schema takes precedence over any library schema in +resolving these conflicts. -## 7.2. Schema namespaces +### 7.3.4. Schema namespaces As part of the HED annotation process, users must associate one or more HED schemas with their datasets. +Since it would be impossible to avoid naming conflicts across schema libraries built in parallel by different user communities, +HED supports schema library namespaces to facilitate the use of multiple schemas in +annotating a datasets.. + If multiple schemas are used, users must define a local prefix for each additional schema and prefix the tags from each of these additional schemas by their respective prefix in annotations. @@ -134,89 +395,13 @@ dp:Change-lanes A colon (`:`) is used to separate the qualifying local name from the remainder of the tag. -## 7.3. Library schema layout - -In addition to the specification of tags in the main part of a schema, a HED schema has -sections that specify unit classes, unit modifiers, value classes, schema attributes, -and properties. The rules for the handling of these sections for a library schema are -as follows: - -### 7.3.1. Required sections - -The required sections of a library schema are the same as those for the -standard schema. -These sections are listed in -[**3.1.2. Schema layout overview**](./03_HED_formats.md#312-schema-layout-overview). -The library schema must include all required -schema sections even if the content of these sections is empty. - -### 7.3.2. Relation to standard HED schema - -Any schema attribute, unit class, unit modifier, value class, or property used in the -library schema must be specified in the appropriate section of the library schema -regardless of whether these appear in the standard HED schema. Validators check the library -schema strictly on the basis of its own specification without reference to another -schema. - -### 7.3.3. Schema properties - -HED only supports the schema properties listed in -[**A.1.5. Schema properties**](./Appendix_A.md#a15-schema-properties). -If the library schema uses one of these in the library schema specification, -then its specification must appear in the *property-specification* section of the library schema. - -### 7.3.4. Unit classes - -The library schema may define unit classes and units as desired or include unit classes or -units from the standard HED schema. Similarly, library schema may define unit modifiers or -reuse unit modifiers from the standard HED schema. HED validation and basic analysis tools -validate these based strictly on the schema specification and do not use any outside -information for these. - -### 7.3.5. Value classes - -The standard value classes listed in [**A.1.3. Value classes**](./Appendix_A.md#(a-13-value-classes) -are the only value classes that should be used in designing library schemas as -these are the only ones that general tools will support. -If additional value classes are needed, they should be proposed on `hed-schemas` repository -[**issue forum**](https://github.com/hed-standard/hed-schemas/issues). - -Library schema may define additional value classes and -specify their allowed characters, but no additional hard-coded behavior will be -available in the standard toolset. This does not preclude special-purpose tools -from incorporating their own behavior. - -### 7.3.6. Schema attributes - -The standard schema attributes listed in -[**A.1.4. Schema attributes**](./Appendix_A.md#(*allowedCharacter*, *defaultUnits*, *extensionAllowed*, -*recommended*, *relatedTag*, *requireChild*, *required*, *SIUnit*, *SIUnitModifier*, -*SIUnitSymbolModifier*, *suggestedTag*, *tagGroup*, *takesValue*, *topLevelTagGroup*, -*unique*, *unitClass*, *unitPrefix*, *unitSymbol*, *valueClass*) should have the same -meaning as in the standard HED schema. The hard-coded behavior associated with the schema -attributes will be the same. Library schema may define additional schema attributes. -They will be checked for syntax, but no additional hard-coded behavior will be available -in the standard toolset. This does not preclude special-purpose tools from incorporating -their own behavior. - -### 7.3.7. Syntax checking - -Regardless of whether an entity is in the standard HED schema or a library schema, -HED schema validation tools perform basic syntax checking. - -````{admonition} Basic syntax checking for HED schemas. -:class: tip - -1. All attributes used in the schema proper must be defined in the schema attribute section of the schema. -2. Undefined attributes cause an error in schema validation. -3. Similar rules apply to unit classes, unit modifiers, value classes, and properties. -4. Actual handling of the semantics by HED tools only occurs for entities appearing in the standard HED schema. -```` +The introduction of partnered library schemas has greatly reduced the need for namespaces, +since the most common use case is a library schema used with a standard schema. ## 7.4. Library schemas in BIDS The most common use case (for 99.9% of the HED users) is to tag events using -a standard HED schemas (preferably the latest one) available in the +a standard HED schema (preferably the latest one) available in the `standard_schema/hedxml` directory of the `hed-schemas` repository of the `hed-standard` organization on GitHub. The standard schemas are available at: @@ -225,83 +410,71 @@ The standard schemas are available at: The **official library schemas** are available at [**https://github.com/hed-standard/hed-schemas/tree/main/library_schemas**](https://github.com/hed-standard/hed-schemas/tree/main/library_schemas). -Standard schemas are referenced by their version number (e.g., `8.0.0`), +Standard schemas are referenced by their version number (e.g., `8.1.0`), while library schema are referenced by a combination of library name and version number (e.g., `score_1.0.0`). -The following example specifies that version 8.0.0 of the standard HED schema is -to be used in addition to two library schemas: -the `score` library version `1.0.0` and the `testlib` library version `1.0.2`. +For BIDS datasets, the versions of the HED schema are specified by +the `HEDVersion` field of the BIDS `dataset_description.json` file. +The following example specifies that version 8.1.0 of the standard HED schema is +to be used in addition to `score` library schema version `1.0.0`. +````{admonition} Illustration of using the namespace prefix for tagging. +:class: tip -````{admonition} **Example:** An example specification with multiple schemas. +The `dataset_description.json` file contains: ```json { - "Name": "A wonderful experiment", - "BIDSVersion": "1.8.0", - "HEDVersion": ["8.0.0", "sc:score_1.0.0", "ts:testlib_1.0.2"] + "Name": "A great experiment", + "BIDSVersion": "1.8.0", + "HEDVersion": ["8.1.0", "sc:score_1.0.0"] } +``` +A typical annotation is: + +```text +"Data-feature, sc:Photomyogenic-response, sc:Wicket-spikes" ``` ```` + + Based on the above description tools will download: 1. The standard HED schema: -[https://raw.githubusercontent.com/hed-standard/hed-schemas/main/standard_schema/hedxml/HED8.0.0.xml](https://raw.githubusercontent.com/hed-standard/hed-schemas/main/standard_schema/hedxml/HED8.0.0.xml). +[https://raw.githubusercontent.com/hed-standard/hed-schemas/main/standard_schema/hedxml/HED8.1.0.xml](https://raw.githubusercontent.com/hed-standard/hed-schemas/main/standard_schema/hedxml/HED8.1.0.xml). 2. The HED `score` library schema version 1.0.0: [https://raw.githubusercontent.com/hed-standard/hed-schemas/main/library_schemas/score/hedxml/HED_score_1.0.0.xml](https://raw.githubusercontent.com/hed-standard/hed-schemas/main/library_schemas/score/hedxml/HED_score_0.0.1.xml). -3. The HED `testlib` library schema version 1.0.2: -[https://raw.githubusercontent.com/hed-standard/hed-schemas/main/library_schemas/testlib/hedxml/HED_testlib_1.0.2.xml](https://raw.githubusercontent.com/hed-standard/hed-schemas/main/library_schemas/testlib/hedxml/HED_testlib_1.0.2.xml). - -A schema browser is available for each library. -For example the schema browser for the `score` library schema is available at -[https://www.hedtags.org/display_hed_score.html](https://www.hedtags.org/display_hed_score.html). -Given the `HEDVersion` specification from the previous example, annotators -can use any combination of tags from the three indicated schemas. -In this example the standard HED schema version appears without a prefix in the version -specification, so tags from this schema may appear directly in the annotation. - -The `sc` and `ts` are local names used to distinguish +In the dataset annotations for the above example, tags drawn from the score schema would +be prefixed with `sc:`, where `sc` is a local name used to distinguish tags from the additional schema. -Tags from the `score` library schema are of the form `sc:xxx` where `xxx` -is a tag from the `score` schema. -Similarly, tags from the `testlib` library schema are of the form `ts:yyy` -where `yyy` is a tag from the `testlib` schema. -The array specification of the schema versions can have at most one version +The array specification of the schema versions in BIDS can have at most one version appearing without a colon prefix. +SCORE version 1.0.0 is not partnered, so the HED version specification had to include +both the library and standard schema versions. +In contrast, SCORE version 1.1.0 is partnered with HED standard schema 8.2.0, +so no namespace prefixes are needed as shown in the following example: -### 7.1. Using library schema in BIDS - -The following `datset_description.json` of a BIDS dataset -indicates that HED standard schema version 8.1.0 should be used -alone with SCORE library schema 1.0.0. -The tags are.... -````{admonition} Illustration of using the namespace prefix for tagging. +````{admonition} **Example:** An example specification of HED version for a partnered schema. :class: tip - +The `dataset_description.json` file contains: ```json { "Name": "A great experiment", "BIDSVersion": "1.8.0", - "HEDVersion": ["8.1.0", "sc:score_1.0.0"] + "HEDVersion": "score_1.1.0" } ``` +A typical annotation is: + ```text -"Data-feature, sc:Photomyogenic-response, sc:Wicket-spikes" +"Data-feature, Photomyogenic-response, Wicket-spikes" ``` ```` - - -Additional information can be found in [**HED schema format**](./03_HED_formats.md#31-hed-schema-format) of Chapter 3 -and [**Appendix A: Schema format details**](Appendix_A.md) for additional information. - -Schema developers should also consult the -[**HED schema development guide**](https://www.hed-resources.org/en/latest/HedSchemaDevelopmentGuide.html). - diff --git a/docs/source/Appendix_B.md b/docs/source/Appendix_B.md index 9c0c8be..2a4aa27 100644 --- a/docs/source/Appendix_B.md +++ b/docs/source/Appendix_B.md @@ -25,9 +25,9 @@ of errors keyed to the HED specification. A HED string contains an invalid character. -**a.** The HED string contains a UTF-8 character. +**a.** The HED string contains a UTF-8 character. +**b.** Curly braces appear in a HED string not in a sidecar. -**b.** An extension or a value substituted for a `#` is not allowed by its value class. **Notes:** - HED uses ANSI encoding and does not support UTF-8. @@ -90,13 +90,14 @@ the definition's contents. **a.** A `Definition` tag does not appear in a tag group at the top level in an annotation. **b.** A definition's enclosing tag group is missing the inner tag group (.i.e., the definition's contents). **c.** A definition's enclosing tag group contains more than a `Definition` tag and an inner group. -**d.** A definition's inner tag group contains `Definition`, `Def` or `Def-expand` tags. -**e.** A definition that includes a placeholder (`#`) does not have exactly two `#` characters. -**f.** A definition has placeholders (`#`) in incorrect positions. -**g.** Definitions of the same name appear with and without a `#`. -**h.** Multiple `Definition` tags with same name are encountered. -**i.** A tag with a `required` or `unique` attribute appears in a definition. -**j.** A definition appears in an unexpected place such as an events file. +**d.** A definition's inner tag group contains `Definition`, `Def` or `Def-expand` tags. +**e.** A definition uses curly braces. +**f.** A definition that includes a placeholder (`#`) does not have exactly two `#` characters. +**g.** A definition has placeholders (`#`) in incorrect positions. +**h.** Definitions of the same name appear with and without a `#`. +**i.** Multiple `Definition` tags with same name are encountered. +**j.** A tag with a `required` or `unique` attribute appears in a definition. +**k.** A definition appears in an unexpected place such as an events file. See [**3.2.8.1. The Definition tag**](./03_HED_formats.md#3281-the-definition-tag) for an explanation of the rules for definitions. @@ -111,7 +112,7 @@ for more details and examples of definition syntax. See [**3.2.3 Tag forms**](./03_HED_formats.md#322-tag-forms) for more information. -### ONSET_OFFSET_ERROR +### ONSET_OFFSET_INSET_ERROR Note: For the purpose of `Onset`/`Offset` matching, `Def` or `Def-expand` tags with different placeholder substitutions are considered to be different. @@ -126,15 +127,17 @@ different placeholder substitutions are considered to be different. without the appearance of an intervening `Onset` of the same name. **h.** An `Onset` tag group with has tags besides the anchor `Def` or `Def-expand-group` that are not in a tag group. -**i.** An `Onset` or an `Offset` with a given `Def` or `Def-expand-group` anchor appears in the same -event marker with another `Onset` or `Offset` that uses the same anchor. - +**i.** An `Onset`, `Inset` or `Offset` with a given `Def` or `Def-expand-group` anchor +appears in an event marker with the same time as with another `Onset`, `Inset`, or `Offset` +that uses the same anchor. +**j.** An `Inset` tag is not grouped with a `Def` or `Def-expand` of an ongoing `Onset`. +**k.** An `Inset` group has more than a single tag group in addition to its defining `Def` or `Def-expand`. **Note:** if the `Onset` tag group's definition is in expanded form, the `Def-expand` will be an additional internal tag group. -See [**3.2.8.3 Onset and Offset tags**](./03_HED_formats.md#3283-onset-and-offset-tags) -for a specification of the required behavior of `Onset` and `Offset`. +See [**3.2.8.3 Onset, Offset, and Inset**](./03_HED_formats.md#3283-onset-offset-and-inset) +for a specification of the required behavior of the `Onset`, `Offset`, and `Inset` tags. [**5.3.1. Using Onset and Offset**](./05_Advanced_annotation.md#531-using-onset-and-offset) in Chapter 5 gives examples of usage and additional details. @@ -170,12 +173,21 @@ An assembled event string must include all tags having the *required* schema att See [**3.2.10.2. Event-level processing**](./03_HED_formats.md#32102-event-level-processing) for additional information on the `required` tag. +### SIDECAR_BRACES_INVALID + +**a.** A name appearing in curly braces in a sidecar HED annotation is not the word `HED` or the name of a HED-annotated column in the sidecar. +**b.** A column name entry in a sidecar has a HED annotation with curly braces, but this name also appears in curly braces in another HED annotation. +**c.** The curly braces in a sidecar are nested or unmatched. + +See [**3.2.9. Sidecars**](./03_HED_formats.md#329-sidecars) for information +on the requirements for using sidecars. + ### SIDECAR_INVALID -**a.** The `"HED"` key is not a second-level dictionary key. -**b.** An annotation entry is provided for `n/a`. +**a.** The `"HED"` key is not a second-level dictionary key. +**b.** An annotation entry is provided for `n/a`. -See [**3.2.9.2. Sidecar validation**](./03_HED_formats.md#3292-sidecar-validation) for a +See [**3.2.9. Sidecars**](./03_HED_formats.md#329-sidecars) for a general explanation of sidecar requirements. ### SIDECAR_KEY_MISSING* @@ -341,9 +353,6 @@ when the planned XSD validation is implemented start with HED_XML. ### B.2.1. General validation errors -#### LIBRARY_NAME_INVALID - -**a.** The specified library name is not alphabetic or lowercase. #### SCHEMA_ATTRIBUTE_INVALID @@ -369,6 +378,21 @@ under an appropriate unit class). **a.** The schema header has invalid characters or format. **b.** The schema header has unrecognized attributes. +#### SCHEMA_LIBRARY_INVALID + +Library schema errors are specific to library schema. Library schema may also raise any of the other schema errors. +**a.** The specified library name is not alphabetic or lowercase. +**b.** The `withStandard` attribute is used in a header that does not also have the `library` attribute. +**c.** The `withStandard` attribute value does not correspond to a valid standard schema version. +**d.** The `rooted` attribute appears in a schema whose header does not have `unmerged="true"` as well as appropriate `library` and `withStandard` header values. +**e.** A node with the `rooted` attribute is not at the top level. +**f.** A node with the `rooted` attribute does not correspond to a node in its partnered standard schema. +**g.** A library schema with the `unmerged="true"` header attribute has an `inLibrary` attribute in some element. +**h.** A library schema with the `unmerged="true"` duplicates special section items found in its partnered standard schema. + + + + #### SCHEMA_SECTION_MISSING **a.** A required schema section is missing. diff --git a/docs/source/conf.py b/docs/source/conf.py index fe57894..3078645 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -25,8 +25,8 @@ author = 'HED Working Group' # The full version, including alpha/beta/rc tags -release = '3.1.1' -version = '3.1.1' +release = '3.2.0' +version = '3.2.0' currentdir = os.path.abspath(os.path.dirname(__file__)) diff --git a/docs/source/index.rst b/docs/source/index.rst index 42052d2..775f4c9 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -7,9 +7,9 @@ HED specification .. sidebar:: **Links** - * `PDF released version (V3.1.1) `_ + * `PDF released version (V3.2.0) `_ - * `PDF working version `_ + * `PDF working version `_ * `Specification source `_ diff --git a/hedspec/HEDSpecification_3_2_0.pdf b/hedspec/HEDSpecification_3_2_0.pdf new file mode 100644 index 0000000..e589b5f Binary files /dev/null and b/hedspec/HEDSpecification_3_2_0.pdf differ diff --git a/hedwiki/HED8.2.0.mediawiki b/hedwiki/HED8.2.0.mediawiki new file mode 100644 index 0000000..26d775d --- /dev/null +++ b/hedwiki/HED8.2.0.mediawiki @@ -0,0 +1,1304 @@ +HED version="8.2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://github.com/hed-standard/hed-specification/raw/master/hedxml/HED8.0.0.xsd" + +'''Prologue''' +The HED standard schema is a hierarchically-organized vocabulary for annotating events and experimental structure. HED annotations consist of comma-separated tags drawn from this vocabulary. This vocabulary can be augmented by terms drawn from specialized library schema. + +Each term in this vocabulary has a human-readable description and may include additional attributes that give additional properties or that specify how tools should treat the tag during analysis. The meaning of these attributes is described in the Additional schema properties section. + +!# start schema + +'''Event''' {suggestedTag=Task-property}[Something that happens at a given time and (typically) place. Elements of this tag subtree designate the general category in which an event falls.] +* Sensory-event {suggestedTag=Task-event-role, suggestedTag=Sensory-presentation}[Something perceivable by the participant. An event meant to be an experimental stimulus should include the tag Task-property/Task-event-role/Experimental-stimulus.] +* Agent-action {suggestedTag=Task-event-role, suggestedTag=Agent}[Any action engaged in by an agent (see the Agent subtree for agent categories). A participant response to an experiment stimulus should include the tag Agent-property/Agent-task-role/Experiment-participant.] +* Data-feature {suggestedTag=Data-property}[An event marking the occurrence of a data feature such as an interictal spike or alpha burst that is often added post hoc to the data record.] +* Experiment-control [An event pertaining to the physical control of the experiment during its operation.] +* Experiment-procedure [An event indicating an experimental procedure, as in performing a saliva swab during the experiment or administering a survey.] +* Experiment-structure [An event specifying a change-point of the structure of experiment. This event is typically used to indicate a change in experimental conditions or tasks.] +* Measurement-event {suggestedTag=Data-property}[A discrete measure returned by an instrument.] + +'''Agent''' {suggestedTag=Agent-property}[Someone or something that takes an active role or produces a specified effect.The role or effect may be implicit. Being alive or performing an activity such as a computation may qualify something to be an agent. An agent may also be something that simulates something else.] +* Animal-agent [An agent that is an animal.] +* Avatar-agent [An agent associated with an icon or avatar representing another agent.] +* Controller-agent [An agent experiment control software or hardware.] +* Human-agent [A person who takes an active role or produces a specified effect.] +* Robotic-agent [An agent mechanical device capable of performing a variety of often complex tasks on command or by being programmed in advance.] +* Software-agent [An agent computer program.] + +'''Action''' {extensionAllowed}[Do something.] +* Communicate [Convey knowledge of or information about something.] +** Communicate-gesturally {relatedTag=Move-face, relatedTag=Move-upper-extremity}[Communicate nonverbally using visible bodily actions, either in place of speech or together and in parallel with spoken words. Gestures include movement of the hands, face, or other parts of the body.] +*** Clap-hands [Strike the palms of against one another resoundingly, and usually repeatedly, especially to express approval.] +*** Clear-throat {relatedTag=Move-face, relatedTag=Move-head}[Cough slightly so as to speak more clearly, attract attention, or to express hesitancy before saying something awkward.] +*** Frown {relatedTag=Move-face}[Express disapproval, displeasure, or concentration, typically by turning down the corners of the mouth.] +*** Grimace {relatedTag=Move-face}[Make a twisted expression, typically expressing disgust, pain, or wry amusement.] +*** Nod-head {relatedTag=Move-head}[Tilt head in alternating up and down arcs along the sagittal plane. It is most commonly, but not universally, used to indicate agreement, acceptance, or acknowledgement.] +*** Pump-fist {relatedTag=Move-upper-extremity}[Raise with fist clenched in triumph or affirmation.] +*** Raise-eyebrows {relatedTag=Move-face, relatedTag=Move-eyes}[Move eyebrows upward.] +*** Shake-fist {relatedTag=Move-upper-extremity}[Clench hand into a fist and shake to demonstrate anger.] +*** Shake-head {relatedTag=Move-head}[Turn head from side to side as a way of showing disagreement or refusal.] +*** Shhh {relatedTag=Move-upper-extremity}[Place finger over lips and possibly uttering the syllable shhh to indicate the need to be quiet.] +*** Shrug {relatedTag=Move-upper-extremity, relatedTag=Move-torso}[Lift shoulders up towards head to indicate a lack of knowledge about a particular topic.] +*** Smile {relatedTag=Move-face}[Form facial features into a pleased, kind, or amused expression, typically with the corners of the mouth turned up and the front teeth exposed.] +*** Spread-hands {relatedTag=Move-upper-extremity}[Spread hands apart to indicate ignorance.] +*** Thumbs-down {relatedTag=Move-upper-extremity}[Extend the thumb downward to indicate disapproval.] +*** Thumb-up {relatedTag=Move-upper-extremity}[Extend the thumb upward to indicate approval.] +*** Wave {relatedTag=Move-upper-extremity}[Raise hand and move left and right, as a greeting or sign of departure.] +*** Widen-eyes {relatedTag=Move-face, relatedTag=Move-eyes}[Open eyes and possibly with eyebrows lifted especially to express surprise or fear.] +*** Wink {relatedTag=Move-face, relatedTag=Move-eyes}[Close and open one eye quickly, typically to indicate that something is a joke or a secret or as a signal of affection or greeting.] +** Communicate-musically [Communicate using music.] +*** Hum [Make a low, steady continuous sound like that of a bee. Sing with the lips closed and without uttering speech.] +*** Play-instrument [Make musical sounds using an instrument.] +*** Sing [Produce musical tones by means of the voice.] +*** Vocalize [Utter vocal sounds.] +*** Whistle [Produce a shrill clear sound by forcing breath out or air in through the puckered lips.] +** Communicate-vocally [Communicate using mouth or vocal cords.] +*** Cry [Shed tears associated with emotions, usually sadness but also joy or frustration.] +*** Groan [Make a deep inarticulate sound in response to pain or despair.] +*** Laugh [Make the spontaneous sounds and movements of the face and body that are the instinctive expressions of lively amusement and sometimes also of contempt or derision.] +*** Scream [Make loud, vociferous cries or yells to express pain, excitement, or fear.] +*** Shout [Say something very loudly.] +*** Sigh [Emit a long, deep, audible breath expressing sadness, relief, tiredness, or a similar feeling.] +*** Speak [Communicate using spoken language.] +*** Whisper [Speak very softly using breath without vocal cords.] +* Move [Move in a specified direction or manner. Change position or posture.] +** Breathe [Inhale or exhale during respiration.] +*** Blow [Expel air through pursed lips.] +*** Cough [Suddenly and audibly expel air from the lungs through a partially closed glottis, preceded by inhalation.] +*** Exhale [Blow out or expel breath.] +*** Hiccup [Involuntarily spasm the diaphragm and respiratory organs, with a sudden closure of the glottis and a characteristic sound like that of a cough.] +*** Hold-breath [Interrupt normal breathing by ceasing to inhale or exhale.] +*** Inhale [Draw in with the breath through the nose or mouth.] +*** Sneeze [Suddenly and violently expel breath through the nose and mouth.] +*** Sniff [Draw in air audibly through the nose to detect a smell, to stop it from running, or to express contempt.] +** Move-body [Move entire body.] +*** Bend [Move body in a bowed or curved manner.] +*** Dance [Perform a purposefully selected sequences of human movement often with aesthetic or symbolic value. Move rhythmically to music, typically following a set sequence of steps.] +*** Fall-down [Lose balance and collapse.] +*** Flex [Cause a muscle to stand out by contracting or tensing it. Bend a limb or joint.] +*** Jerk [Make a quick, sharp, sudden movement.] +*** Lie-down [Move to a horizontal or resting position.] +*** Recover-balance [Return to a stable, upright body position.] +*** Sit-down [Move from a standing to a sitting position.] +*** Sit-up [Move from lying down to a sitting position.] +*** Stand-up [Move from a sitting to a standing position.] +*** Stretch [Straighten or extend body or a part of body to its full length, typically so as to tighten muscles or in order to reach something.] +*** Shudder [Tremble convulsively, sometimes as a result of fear or revulsion.] +*** Stumble [Trip or momentarily lose balance and almost fall.] +*** Turn [Change or cause to change direction.] +** Move-body-part [Move one part of a body.] +*** Move-eyes [Move eyes.] +**** Blink [Shut and open the eyes quickly.] +**** Close-eyes [Lower and keep eyelids in a closed position.] +**** Fixate [Direct eyes to a specific point or target.] +**** Inhibit-blinks [Purposely prevent blinking.] +**** Open-eyes [Raise eyelids to expose pupil.] +**** Saccade [Move eyes rapidly between fixation points.] +**** Squint [Squeeze one or both eyes partly closed in an attempt to see more clearly or as a reaction to strong light.] +**** Stare [Look fixedly or vacantly at someone or something with eyes wide open.] +*** Move-face [Move the face or jaw.] +**** Bite [Seize with teeth or jaws an object or organism so as to grip or break the surface covering.] +**** Burp [Noisily release air from the stomach through the mouth. Belch.] +**** Chew [Repeatedly grinding, tearing, and or crushing with teeth or jaws.] +**** Gurgle [Make a hollow bubbling sound like that made by water running out of a bottle.] +**** Swallow [Cause or allow something, especially food or drink to pass down the throat.] +***** Gulp [Swallow quickly or in large mouthfuls, often audibly, sometimes to indicate apprehension.] +**** Yawn [Take a deep involuntary inhalation with the mouth open often as a sign of drowsiness or boredom.] +*** Move-head [Move head.] +**** Lift-head [Tilt head back lifting chin.] +**** Lower-head [Move head downward so that eyes are in a lower position.] +**** Turn-head [Rotate head horizontally to look in a different direction.] +*** Move-lower-extremity [Move leg and/or foot.] +**** Curl-toes [Bend toes sometimes to grip.] +**** Hop [Jump on one foot.] +**** Jog [Run at a trot to exercise.] +**** Jump [Move off the ground or other surface through sudden muscular effort in the legs.] +**** Kick [Strike out or flail with the foot or feet. Strike using the leg, in unison usually with an area of the knee or lower using the foot.] +**** Pedal [Move by working the pedals of a bicycle or other machine.] +**** Press-foot [Move by pressing foot.] +**** Run [Travel on foot at a fast pace.] +**** Step [Put one leg in front of the other and shift weight onto it.] +***** Heel-strike [Strike the ground with the heel during a step.] +***** Toe-off [Push with toe as part of a stride.] +**** Trot [Run at a moderate pace, typically with short steps.] +**** Walk [Move at a regular pace by lifting and setting down each foot in turn never having both feet off the ground at once.] +*** Move-torso [Move body trunk.] +*** Move-upper-extremity [Move arm, shoulder, and/or hand.] +**** Drop [Let or cause to fall vertically.] +**** Grab [Seize suddenly or quickly. Snatch or clutch.] +**** Grasp [Seize and hold firmly.] +**** Hold-down [Prevent someone or something from moving by holding them firmly.] +**** Lift [Raising something to higher position.] +**** Make-fist [Close hand tightly with the fingers bent against the palm.] +**** Point [Draw attention to something by extending a finger or arm.] +**** Press {relatedTag=Push}[Apply pressure to something to flatten, shape, smooth or depress it. This action tag should be used to indicate key presses and mouse clicks.] +**** Push {relatedTag=Press}[Apply force in order to move something away. Use Press to indicate a key press or mouse click.] +**** Reach [Stretch out your arm in order to get or touch something.] +**** Release [Make available or set free.] +**** Retract [Draw or pull back.] +**** Scratch [Drag claws or nails over a surface or on skin.] +**** Snap-fingers [Make a noise by pushing second finger hard against thumb and then releasing it suddenly so that it hits the base of the thumb.] +**** Touch [Come into or be in contact with.] +* Perceive [Produce an internal, conscious image through stimulating a sensory system.] +** Hear [Give attention to a sound.] +** See [Direct gaze toward someone or something or in a specified direction.] +** Smell [Inhale in order to ascertain an odor or scent.] +** Taste [Sense a flavor in the mouth and throat on contact with a substance.] +** Sense-by-touch [Sense something through receptors in the skin.] +* Perform [Carry out or accomplish an action, task, or function.] +** Close [Act as to blocked against entry or passage.] +** Collide-with [Hit with force when moving.] +** Halt [Bring or come to an abrupt stop.] +** Modify [Change something.] +** Open [Widen an aperture, door, or gap, especially one allowing access to something.] +** Operate [Control the functioning of a machine, process, or system.] +** Play [Engage in activity for enjoyment and recreation rather than a serious or practical purpose.] +** Read [Interpret something that is written or printed.] +** Repeat [Make do or perform again.] +** Rest [Be inactive in order to regain strength, health, or energy.] +** Write [Communicate or express by means of letters or symbols written or imprinted on a surface.] +* Think [Direct the mind toward someone or something or use the mind actively to form connected ideas.] +** Allow [Allow access to something such as allowing a car to pass.] +** Attend-to [Focus mental experience on specific targets.] +** Count [Tally items either silently or aloud.] +** Deny [Refuse to give or grant something requested or desired by someone.] +** Detect [Discover or identify the presence or existence of something.] +** Discriminate [Recognize a distinction.] +** Encode [Convert information or an instruction into a particular form.] +** Evade [Escape or avoid, especially by cleverness or trickery.] +** Generate [Cause something, especially an emotion or situation to arise or come about.] +** Identify [Establish or indicate who or what someone or something is.] +** Imagine [Form a mental image or concept of something.] +** Judge [Evaluate evidence to make a decision or form a belief.] +** Learn [Adaptively change behavior as the result of experience.] +** Memorize [Adaptively change behavior as the result of experience.] +** Plan [Think about the activities required to achieve a desired goal. ] +** Predict [Say or estimate that something will happen or will be a consequence of something without having exact informaton.] +** Recognize [Identify someone or something from having encountered them before.] +** Respond [React to something such as a treatment or a stimulus.] +** Recall [Remember information by mental effort.] +** Switch-attention [Transfer attention from one focus to another.] +** Track [Follow a person, animal, or object through space or time.] + +'''Item''' {extensionAllowed}[An independently existing thing (living or nonliving).] +* Biological-item [An entity that is biological, that is related to living organisms.] +** Anatomical-item [A biological structure, system, fluid or other substance excluding single molecular entities.] +*** Body [The biological structure representing an organism.] +*** Body-part [Any part of an organism.] +**** Head [The upper part of the human body, or the front or upper part of the body of an animal, typically separated from the rest of the body by a neck, and containing the brain, mouth, and sense organs.] +***** Hair [The filamentous outgrowth of the epidermis.] +***** Ear [A sense organ needed for the detection of sound and for establishing balance.] +***** Face [The anterior portion of the head extending from the forehead to the chin and ear to ear. The facial structures contain the eyes, nose and mouth, cheeks and jaws.] +****** Cheek [The fleshy part of the face bounded by the eyes, nose, ear, and jaw line.] +****** Chin [The part of the face below the lower lip and including the protruding part of the lower jaw.] +****** Eye [The organ of sight or vision.] +****** Eyebrow [The arched strip of hair on the bony ridge above each eye socket.] +****** Forehead [The part of the face between the eyebrows and the normal hairline.] +****** Lip [Fleshy fold which surrounds the opening of the mouth.] +****** Nose [A structure of special sense serving as an organ of the sense of smell and as an entrance to the respiratory tract.] +****** Mouth [The proximal portion of the digestive tract, containing the oral cavity and bounded by the oral opening.] +****** Teeth [The hard bonelike structures in the jaws. A collection of teeth arranged in some pattern in the mouth or other part of the body.] +**** Lower-extremity [Refers to the whole inferior limb (leg and/or foot).] +***** Ankle [A gliding joint between the distal ends of the tibia and fibula and the proximal end of the talus.] +***** Calf [The fleshy part at the back of the leg below the knee.] +***** Foot [The structure found below the ankle joint required for locomotion.] +****** Big-toe [The largest toe on the inner side of the foot.] +****** Heel [The back of the foot below the ankle.] +****** Instep [The part of the foot between the ball and the heel on the inner side.] +****** Little-toe [The smallest toe located on the outer side of the foot.] +****** Toes [The terminal digits of the foot.] +***** Knee [A joint connecting the lower part of the femur with the upper part of the tibia.] +***** Shin [Front part of the leg below the knee.] +***** Thigh [Upper part of the leg between hip and knee.] +**** Torso [The body excluding the head and neck and limbs.] +***** Torso-back [The rear surface of the human body from the shoulders to the hips.] +***** Buttocks [The round fleshy parts that form the lower rear area of a human trunk.] +***** Torso-chest [The anterior side of the thorax from the neck to the abdomen.] +***** Gentalia {deprecatedFrom=8.1.0}[The external organs of reproduction.] +***** Hip [The lateral prominence of the pelvis from the waist to the thigh.] +***** Waist [The abdominal circumference at the navel.] +**** Upper-extremity [Refers to the whole superior limb (shoulder, arm, elbow, wrist, hand).] +***** Elbow [A type of hinge joint located between the forearm and upper arm.] +***** Forearm [Lower part of the arm between the elbow and wrist.] +***** Hand [The distal portion of the upper extremity. It consists of the carpus, metacarpus, and digits.] +****** Finger [Any of the digits of the hand.] +******* Index-finger [The second finger from the radial side of the hand, next to the thumb.] +******* Little-finger [The fifth and smallest finger from the radial side of the hand.] +******* Middle-finger [The middle or third finger from the radial side of the hand.] +******* Ring-finger [The fourth finger from the radial side of the hand.] +******* Thumb [The thick and short hand digit which is next to the index finger in humans.] +****** Palm [The part of the inner surface of the hand that extends from the wrist to the bases of the fingers.] +****** Knuckles [A part of a finger at a joint where the bone is near the surface, especially where the finger joins the hand.] +***** Shoulder [Joint attaching upper arm to trunk.] +***** Upper-arm [Portion of arm between shoulder and elbow.] +***** Wrist [A joint between the distal end of the radius and the proximal row of carpal bones.] +** Organism [A living entity, more specifically a biological entity that consists of one or more cells and is capable of genomic replication (independently or not).] +*** Animal [A living organism that has membranous cell walls, requires oxygen and organic foods, and is capable of voluntary movement.] +*** Human [The bipedal primate mammal Homo sapiens.] +*** Plant [Any living organism that typically synthesizes its food from inorganic substances and possesses cellulose cell walls.] +* Language-item {suggestedTag=Sensory-presentation}[An entity related to a systematic means of communicating by the use of sounds, symbols, or gestures.] +** Character [A mark or symbol used in writing.] +** Clause [A unit of grammatical organization next below the sentence in rank, usually consisting of a subject and predicate.] +** Glyph [A hieroglyphic character, symbol, or pictograph.] +** Nonword [A group of letters or speech sounds that looks or sounds like a word but that is not accepted as such by native speakers.] +** Paragraph [A distinct section of a piece of writing, usually dealing with a single theme.] +** Phoneme [A speech sound that is distinguished by the speakers of a particular language.] +** Phrase [A phrase is a group of words functioning as a single unit in the syntax of a sentence.] +** Sentence [A set of words that is complete in itself, conveying a statement, question, exclamation, or command and typically containing an explicit or implied subject and a predicate containing a finite verb.] +** Syllable [A unit of spoken language larger than a phoneme.] +** Textblock [A block of text.] +** Word [A word is the smallest free form (an item that may be expressed in isolation with semantic or pragmatic content) in a language.] +* Object {suggestedTag=Sensory-presentation}[Something perceptible by one or more of the senses, especially by vision or touch. A material thing.] +** Geometric-object [An object or a representation that has structure and topology in space.] +*** Pattern [An arrangement of objects, facts, behaviors, or other things which have scientific, mathematical, geometric, statistical, or other meaning.] +**** Dots [A small round mark or spot.] +**** LED-pattern [A pattern created by lighting selected members of a fixed light emitting diode array.] +*** 2D-shape [A planar, two-dimensional shape.] +**** Arrow [A shape with a pointed end indicating direction.]. +**** Clockface [The dial face of a clock. A location identifier based on clockface numbering or anatomic subregion.] +**** Cross [A figure or mark formed by two intersecting lines crossing at their midpoints.] +**** Dash [A horizontal stroke in writing or printing to mark a pause or break in sense or to represent omitted letters or words.] +**** Ellipse [A closed plane curve resulting from the intersection of a circular cone and a plane cutting completely through it, especially a plane not parallel to the base.] +***** Circle [A ring-shaped structure with every point equidistant from the center.] +**** Rectangle [A parallelogram with four right angles.] +***** Square [A square is a special rectangle with four equal sides.] +**** Single-point [A point is a geometric entity that is located in a zero-dimensional spatial region and whose position is defined by its coordinates in some coordinate system.] +**** Star [A conventional or stylized representation of a star, typically one having five or more points.] +**** Triangle [A three-sided polygon.] +*** 3D-shape [A geometric three-dimensional shape.] +**** Box [A square or rectangular vessel, usually made of cardboard or plastic.] +***** Cube [A solid or semi-solid in the shape of a three dimensional square.] +**** Cone [A shape whose base is a circle and whose sides taper up to a point.] +**** Cylinder [A surface formed by circles of a given radius that are contained in a plane perpendicular to a given axis, whose centers align on the axis.] +**** Ellipsoid [A closed plane curve resulting from the intersection of a circular cone and a plane cutting completely through it, especially a plane not parallel to the base. ] +***** Sphere [A solid or hollow three-dimensional object bounded by a closed surface such that every point on the surface is equidistant from the center.] +**** Pyramid [A polyhedron of which one face is a polygon of any number of sides, and the other faces are triangles with a common vertex.] +** Ingestible-object [Something that can be taken into the body by the mouth for digestion or absorption.] +** Man-made-object [Something constructed by human means.] +*** Building [A structure that has a roof and walls and stands more or less permanently in one place.] +**** Room [An area within a building enclosed by walls and floor and ceiling.] +**** Roof [A roof is the covering on the uppermost part of a building which provides protection from animals and weather, notably rain, but also heat, wind and sunlight.] +**** Entrance [The means or place of entry.] +**** Attic [A room or a space immediately below the roof of a building.] +**** Basement [The part of a building that is wholly or partly below ground level.] +*** Clothing [A covering designed to be worn on the body.] +*** Device [An object contrived for a specific purpose.] +**** Assistive-device [A device that help an individual accomplish a task.] +***** Glasses [Frames with lenses worn in front of the eye for vision correction, eye protection, or protection from UV rays.] +***** Writing-device [A device used for writing.] +****** Pen [A common writing instrument used to apply ink to a surface for writing or drawing.] +****** Pencil [An implement for writing or drawing that is constructed of a narrow solid pigment core in a protective casing that prevents the core from being broken or marking the hand.] +**** Computing-device [An electronic device which take inputs and processes results from the inputs.] +***** Cellphone [A telephone with access to a cellular radio system so it can be used over a wide area, without a physical connection to a network.] +***** Desktop-computer [A computer suitable for use at an ordinary desk.] +***** Laptop-computer [A computer that is portable and suitable for use while traveling.] +***** Tablet-computer [A small portable computer that accepts input directly on to its screen rather than via a keyboard or mouse.] +**** Engine [A motor is a machine designed to convert one or more forms of energy into mechanical energy.] +**** IO-device [Hardware used by a human (or other system) to communicate with a computer.] +***** Input-device [A piece of equipment used to provide data and control signals to an information processing system such as a computer or information appliance.] +****** Computer-mouse [A hand-held pointing device that detects two-dimensional motion relative to a surface.] +******* Mouse-button [An electric switch on a computer mouse which can be pressed or clicked to select or interact with an element of a graphical user interface.] +******* Scroll-wheel [A scroll wheel or mouse wheel is a wheel used for scrolling made of hard plastic with a rubbery surface usually located between the left and right mouse buttons and is positioned perpendicular to the mouse surface.] +****** Joystick [A control device that uses a movable handle to create two-axis input for a computer device.] +****** Keyboard [A device consisting of mechanical keys that are pressed to create input to a computer.] +******* Keyboard-key [A button on a keyboard usually representing letters, numbers, functions, or symbols.] +******** # {takesValue}[Value of a keyboard key.] +****** Keypad [A device consisting of keys, usually in a block arrangement, that provides limited input to a system.] +******* Keypad-key [A key on a separate section of a computer keyboard that groups together numeric keys and those for mathematical or other special functions in an arrangement like that of a calculator.] +******** # {takesValue}[Value of keypad key.] +****** Microphone [A device designed to convert sound to an electrical signal.] +****** Push-button [A switch designed to be operated by pressing a button.] +***** Output-device [Any piece of computer hardware equipment which converts information into human understandable form.] +****** Display-device [An output device for presentation of information in visual or tactile form the latter used for example in tactile electronic displays for blind people.] +******* Head-mounted-display [An instrument that functions as a display device, worn on the head or as part of a helmet, that has a small display optic in front of one (monocular HMD) or each eye (binocular HMD).] +******* LED-display [A LED display is a flat panel display that uses an array of light-emitting diodes as pixels for a video display.] +******* Computer-screen [An electronic device designed as a display or a physical device designed to be a protective meshwork.] +******** Screen-window [A part of a computer screen that contains a display different from the rest of the screen. A window is a graphical control element consisting of a visual area containing some of the graphical user interface of the program it belongs to and is framed by a window decoration.] +****** Auditory-device [A device designed to produce sound.] +******* Headphones [An instrument that consists of a pair of small loudspeakers, or less commonly a single speaker, held close to ears and connected to a signal source such as an audio amplifier, radio, CD player or portable media player.] +******* Loudspeaker [A device designed to convert electrical signals to sounds that can be heard.] +***** Recording-device [A device that copies information in a signal into a persistent information bearer.] +****** EEG-recorder [A device for recording electric currents in the brain using electrodes applied to the scalp, to the surface of the brain, or placed within the substance of the brain.] +****** File-storage [A device for recording digital information to a permanent media.] +****** MEG-recorder [A device for measuring the magnetic fields produced by electrical activity in the brain, usually conducted externally.] +****** Motion-capture [A device for recording the movement of objects or people.] +****** Tape-recorder [A device for recording and reproduction usually using magnetic tape for storage that can be saved and played back.] +***** Touchscreen [A control component that operates an electronic device by pressing the display on the screen.] +**** Machine [A human-made device that uses power to apply forces and control movement to perform an action.] +**** Measurement-device [A device in which a measure function inheres.] +***** Clock [A device designed to indicate the time of day or to measure the time duration of an event or action.] +****** Clock-face [A location identifier based on clockface numbering or anatomic subregion.] +**** Robot [A mechanical device that sometimes resembles a living animal and is capable of performing a variety of often complex human tasks on command or by being programmed in advance.] +**** Tool [A component that is not part of a device but is designed to support its assemby or operation.] +*** Document [A physical object, or electronic counterpart, that is characterized by containing writing which is meant to be human-readable.] +**** Letter [A written message addressed to a person or organization.] +**** Note [A brief written record.] +**** Book [A volume made up of pages fastened along one edge and enclosed between protective covers.] +**** Notebook [A book for notes or memoranda.] +**** Questionnaire [A document consisting of questions and possibly responses, depending on whether it has been filled out.] +*** Furnishing [Furniture, fittings, and other decorative accessories, such as curtains and carpets, for a house or room.] +*** Manufactured-material [Substances created or extracted from raw materials.] +**** Ceramic [A hard, brittle, heat-resistant and corrosion-resistant material made by shaping and then firing a nonmetallic mineral, such as clay, at a high temperature.] +**** Glass [A brittle transparent solid with irregular atomic structure.] +**** Paper [A thin sheet material produced by mechanically or chemically processing cellulose fibres derived from wood, rags, grasses or other vegetable sources in water.] +**** Plastic [Various high-molecular-weight thermoplastic or thermosetting polymers that are capable of being molded, extruded, drawn, or otherwise shaped and then hardened into a form.] +**** Steel [An alloy made up of iron with typically a few tenths of a percent of carbon to improve its strength and fracture resistance compared to iron.] +*** Media [Media are audo/visual/audiovisual modes of communicating information for mass consumption.] +**** Media-clip [A short segment of media.] +***** Audio-clip [A short segment of audio.] +***** Audiovisual-clip [A short media segment containing both audio and video.] +***** Video-clip [A short segment of video.] +**** Visualization [An planned process that creates images, diagrams or animations from the input data.] +***** Animation [A form of graphical illustration that changes with time to give a sense of motion or represent dynamic changes in the portrayal.] +***** Art-installation [A large-scale, mixed-media constructions, often designed for a specific place or for a temporary period of time.] +***** Braille [A display using a system of raised dots that can be read with the fingers by people who are blind.] +***** Image [Any record of an imaging event whether physical or electronic.] +****** Cartoon [A type of illustration, sometimes animated, typically in a non-realistic or semi-realistic style. The specific meaning has evolved over time, but the modern usage usually refers to either an image or series of images intended for satire, caricature, or humor. A motion picture that relies on a sequence of illustrations for its animation.] +****** Drawing [A representation of an object or outlining a figure, plan, or sketch by means of lines.] +****** Icon [A sign (such as a word or graphic symbol) whose form suggests its meaning.] +****** Painting [A work produced through the art of painting.] +****** Photograph [An image recorded by a camera.] +***** Movie [A sequence of images displayed in succession giving the illusion of continuous movement.] +***** Outline-visualization [A visualization consisting of a line or set of lines enclosing or indicating the shape of an object in a sketch or diagram.] +***** Point-light-visualization [A display in which action is depicted using a few points of light, often generated from discrete sensors in motion capture.] +***** Sculpture [A two- or three-dimensional representative or abstract forms, especially by carving stone or wood or by casting metal or plaster.] +***** Stick-figure-visualization [A drawing showing the head of a human being or animal as a circle and all other parts as straight lines.] +*** Navigational-object [An object whose purpose is to assist directed movement from one location to another.] +**** Path [A trodden way. A way or track laid down for walking or made by continual treading.] +**** Road [An open way for the passage of vehicles, persons, or animals on land.] +***** Lane [A defined path with physical dimensions through which an object or substance may traverse.] +**** Runway [A paved strip of ground on a landing field for the landing and takeoff of aircraft.] +*** Vehicle [A mobile machine which transports people or cargo.] +**** Aircraft [A vehicle which is able to travel through air in an atmosphere.] +**** Bicycle [A human-powered, pedal-driven, single-track vehicle, having two wheels attached to a frame, one behind the other.] +**** Boat [A watercraft of any size which is able to float or plane on water.] +**** Car [A wheeled motor vehicle used primarily for the transportation of human passengers.] +**** Cart [A cart is a vehicle which has two wheels and is designed to transport human passengers or cargo.] +**** Tractor [A mobile machine specifically designed to deliver a high tractive effort at slow speeds, and mainly used for the purposes of hauling a trailer or machinery used in agriculture or construction.] +**** Train [A connected line of railroad cars with or without a locomotive.] +**** Truck [A motor vehicle which, as its primary funcion, transports cargo rather than human passangers.] +** Natural-object [Something that exists in or is produced by nature, and is not artificial or man-made.] +*** Mineral [A solid, homogeneous, inorganic substance occurring in nature and having a definite chemical composition.] +*** Natural-feature [A feature that occurs in nature. A prominent or identifiable aspect, region, or site of interest.] +**** Field [An unbroken expanse as of ice or grassland.] +**** Hill [A rounded elevation of limited extent rising above the surrounding land with local relief of less than 300m.] +**** Mountain [A landform that extends above the surrounding terrain in a limited area.] +**** River [A natural freshwater surface stream of considerable volume and a permanent or seasonal flow, moving in a definite channel toward a sea, lake, or another river.] +**** Waterfall [A sudden descent of water over a step or ledge in the bed of a river.] +* Sound [Mechanical vibrations transmitted by an elastic medium. Something that can be heard.] +** Environmental-sound[Sounds occuring in the environment. An accumulation of noise pollution that occurs outside. This noise can be caused by transport, industrial, and recreational activities.] +*** Crowd-sound [Noise produced by a mixture of sounds from a large group of people.] +*** Signal-noise [Any part of a signal that is not the true or original signal but is introduced by the communication mechanism.] +** Musical-sound [Sound produced by continuous and regular vibrations, as opposed to noise.] +*** Tone [A musical note, warble, or other sound used as a particular signal on a telephone or answering machine.] +*** Instrument-sound [Sound produced by a musical instrument.] +*** Vocalized-sound [Musical sound produced by vocal cords in a biological agent.] +** Named-animal-sound [A sound recognizable as being associated with particular animals.] +*** Barking [Sharp explosive cries like sounds made by certain animals, especially a dog, fox, or seal.] +*** Bleating [Wavering cries like sounds made by a sheep, goat, or calf.] +*** Crowing [Loud shrill sounds characteristic of roosters.] +*** Chirping [Short, sharp, high-pitched noises like sounds made by small birds or an insects.] +*** Growling [Low guttural sounds like those that made in the throat by a hostile dog or other animal.] +*** Meowing [Vocalizations like those made by as those cats. These sounds have diverse tones and are sometimes chattered, murmured or whispered. The purpose can be assertive.] +*** Mooing [Deep vocal sounds like those made by a cow.] +*** Purring [Low continuous vibratory sound such as those made by cats. The sound expresses contentment.] +*** Roaring [Loud, deep, or harsh prolonged sounds such as those made by big cats and bears for long-distance communication and intimidation.] +*** Squawking [Loud, harsh noises such as those made by geese.] +** Named-object-sound [A sound identifiable as coming from a particular type of object.] +*** Alarm-sound [A loud signal often loud continuous ringing to alert people to a problem or condition that requires urgent attention.] +*** Beep [A short, single tone, that is typically high-pitched and generally made by a computer or other machine. ] +*** Buzz [A persistent vibratory sound often made by a buzzer device and used to indicate something incorrect.] +*** Ka-ching [The sound made by a mechanical cash register, often to designate a reward.] +*** Click [The sound made by a mechanical cash register, often to designate a reward.] +*** Ding [A short ringing sound such as that made by a bell, often to indicate a correct response or the expiration of time.] +*** Horn-blow [A loud sound made by forcing air through a sound device that funnels air to create the sound, often used to sound an alert.] +*** Siren [A loud, continuous sound often varying in frequency designed to indicate an emergency.] + +'''Property''' {extensionAllowed}[Something that pertains to a thing. A characteristic of some entity. A quality or feature regarded as a characteristic or inherent part of someone or something. HED attributes are adjectives or adverbs.] +* Agent-property {extensionAllowed}[Something that pertains to an agent.] +** Agent-state [The state of the agent.] +*** Agent-cognitive-state [The state of the cognitive processes or state of mind of the agent.] +**** Alert [Condition of heightened watchfulness or preparation for action.] +**** Anesthetized [Having lost sensation to pain or having senses dulled due to the effects of an anesthetic.] +**** Asleep [Having entered a periodic, readily reversible state of reduced awareness and metabolic activity, usually accompanied by physical relaxation and brain activity.] +**** Attentive [Concentrating and focusing mental energy on the task or surroundings.] +**** Distracted [Lacking in concentration because of being preoccupied.] +**** Awake [In a non sleeping state.] +**** Brain-dead [Characterized by the irreversible absence of cortical and brain stem functioning.] +**** Comatose [In a state of profound unconsciousness associated with markedly depressed cerebral activity.] +**** Drowsy [In a state of near-sleep, a strong desire for sleep, or sleeping for unusually long periods.] +**** Intoxicated [In a state with disturbed psychophysiological functions and responses as a result of administration or ingestion of a psychoactive substance.] +**** Locked-in [In a state of complete paralysis of all voluntary muscles except for the ones that control the movements of the eyes.] +**** Passive [Not responding or initiating an action in response to a stimulus.] +**** Resting [A state in which the agent is not exhibiting any physical exertion.] +**** Vegetative [A state of wakefulness and conscience, but (in contrast to coma) with involuntary opening of the eyes and movements (such as teeth grinding, yawning, or thrashing of the extremities).] +*** Agent-emotional-state [The status of the general temperament and outlook of an agent.] +**** Angry [Experiencing emotions characterized by marked annoyance or hostility.] +**** Aroused [In a state reactive to stimuli leading to increased heart rate and blood pressure, sensory alertness, mobility and readiness to respond.] +**** Awed [Filled with wonder. Feeling grand, sublime or powerful emotions characterized by a combination of joy, fear, admiration, reverence, and/or respect.] +**** Compassionate [Feeling or showing sympathy and concern for others often evoked for a person who is in distress and associated with altruistic motivation.] +**** Content [Feeling satisfaction with things as they are.] +**** Disgusted [Feeling revulsion or profound disapproval aroused by something unpleasant or offensive.] +**** Emotionally-neutral [Feeling neither satisfied nor dissatisfied.] +**** Empathetic [Understanding and sharing the feelings of another. Being aware of, being sensitive to, and vicariously experiencing the feelings, thoughts, and experience of another.] +**** Excited [Feeling great enthusiasm and eagerness.] +**** Fearful [Feeling apprehension that one may be in danger.] +**** Frustrated [Feeling annoyed as a result of being blocked, thwarted, disappointed or defeated.] +**** Grieving [Feeling sorrow in response to loss, whether physical or abstract.] +**** Happy [Feeling pleased and content.] +**** Jealous [Feeling threatened by a rival in a relationship with another individual, in particular an intimate partner, usually involves feelings of threat, fear, suspicion, distrust, anxiety, anger, betrayal, and rejection.] +**** Joyful [Feeling delight or intense happiness.] +**** Loving [Feeling a strong positive emotion of affection and attraction.] +**** Relieved [No longer feeling pain, distress, anxiety, or reassured.] +**** Sad [Feeling grief or unhappiness.] +**** Stressed [Experiencing mental or emotional strain or tension.] +*** Agent-physiological-state [Having to do with the mechanical, physical, or biochemical function of an agent.] +**** Healthy {relatedTag=Sick}[Having no significant health-related issues.] +**** Hungry {relatedTag=Sated, relatedTag=Thirsty}[Being in a state of craving or desiring food.] +**** Rested {relatedTag=Tired}[Feeling refreshed and relaxed.] +**** Sated {relatedTag=Hungry}[Feeling full.] +**** Sick {relatedTag=Healthy}[Being in a state of ill health, bodily malfunction, or discomfort.] +**** Thirsty {relatedTag=Hungry}[Feeling a need to drink.] +**** Tired {relatedTag=Rested}[Feeling in need of sleep or rest.] +*** Agent-postural-state [Pertaining to the position in which agent holds their body.] +**** Crouching [Adopting a position where the knees are bent and the upper body is brought forward and down, sometimes to avoid detection or to defend oneself.] +**** Eyes-closed [Keeping eyes closed with no blinking.] +**** Eyes-open [Keeping eyes open with occasional blinking.] +**** Kneeling [Positioned where one or both knees are on the ground.] +**** On-treadmill [Ambulation on an exercise apparatus with an endless moving belt to support moving in place.] +**** Prone [Positioned in a recumbent body position whereby the person lies on its stomach and faces downward.] +**** Sitting [In a seated position.] +**** Standing [Assuming or maintaining an erect upright position.] +**** Seated-with-chin-rest [Using a device that supports the chin and head.] +** Agent-task-role [The function or part that is ascribed to an agent in performing the task.] +*** Experiment-actor [An agent who plays a predetermined role to create the experiment scenario.] +*** Experiment-controller [An agent exerting control over some aspect of the experiment.] +*** Experiment-participant [Someone who takes part in an activity related to an experiment.] +*** Experimenter [Person who is the owner of the experiment and has its responsibility.] +** Agent-trait [A genetically, environmentally, or socially determined characteristic of an agent.] +*** Age [Length of time elapsed time since birth of the agent.] +**** # {takesValue, valueClass=numericClass} +*** Agent-experience-level [Amount of skill or knowledge that the agent has as pertains to the task.] +**** Expert-level {relatedTag=Intermediate-experience-level, relatedTag=Novice-level}[Having comprehensive and authoritative knowledge of or skill in a particular area related to the task.] +**** Intermediate-experience-level {relatedTag=Expert-level, relatedTag=Novice-level}[Having a moderate amount of knowledge or skill related to the task.] +**** Novice-level {relatedTag=Expert-level, relatedTag=Intermediate-experience-level} [Being inexperienced in a field or situation related to the task.] +*** Gender [Characteristics that are socially constructed, including norms, behaviors, and roles based on sex.] +*** Sex [Physical properties or qualities by which male is distinguished from female.] +**** Female [Biological sex of an individual with female sexual organs such ova.] +**** Male [Biological sex of an individual with male sexual organs producing sperm.] +**** Intersex [Having genitalia and/or secondary sexual characteristics of indeterminate sex.] +*** Ethnicity [Belong to a social group that has a common national or cultural tradition. Use with Label to avoid extension.] +*** Handedness [Individual preference for use of a hand, known as the dominant hand.] +**** Left-handed [Preference for using the left hand or foot for tasks requiring the use of a single hand or foot.] +**** Right-handed [Preference for using the right hand or foot for tasks requiring the use of a single hand or foot.] +**** Ambidextrous [Having no overall dominance in the use of right or left hand or foot in the performance of tasks that require one hand or foot.] +*** Race [Belonging to a group sharing physical or social qualities as defined within a specified society. Use with Label to avoid extension.] +* Data-property {extensionAllowed}[Something that pertains to data or information.] +** Data-marker [An indicator placed to mark something.] +*** Data-break-marker [An indicator place to indicate a gap in the data.] +*** Temporal-marker[An indicator placed at a particular time in the data.] +**** Inset {topLevelTagGroup,reserved,relatedTag=Onset,relatedTag=Offset}[Marks an intermediate point in an ongoing event of temporal extent.] +**** Onset {topLevelTagGroup,reserved,relatedTag=Inset,relatedTag=Offset}[Marks the start of an ongoing event of temporal extent.] +**** Offset {topLevelTagGroup,reserved,relatedTag=Onset, relatedTag=Inset}[Marks the end of an event of temporal extent.] +**** Pause [Indicates the temporary interruption of the operation a process and subsequently wait for a signal to continue.] +**** Time-out [A cancellation or cessation that automatically occurs when a predefined interval of time has passed without a certain event occurring.] +**** Time-sync [A synchronization signal whose purpose to help synchronize different signals or processes. Often used to indicate a marker inserted into the recorded data to allow post hoc synchronization of concurrently recorded data streams.] +** Data-resolution [Smallest change in a quality being measured by an sensor that causes a perceptible change.] +*** Printer-resolution [Resolution of a printer, usually expressed as the number of dots-per-inch for a printer.] +**** # {takesValue, valueClass=numericClass} +*** Screen-resolution [Resolution of a screen, usually expressed as the of pixels in a dimension for a digital display device.] +**** # {takesValue, valueClass=numericClass} +*** Sensory-resolution [Resolution of measurements by a sensing device.] +**** # {takesValue, valueClass=numericClass} +*** Spatial-resolution [Linear spacing of a spatial measurement.] +**** # {takesValue, valueClass=numericClass} +*** Spectral-resolution [Measures the ability of a sensor to resolve features in the electromagnetic spectrum.] +**** # {takesValue, valueClass=numericClass} +*** Temporal-resolution [Measures the ability of a sensor to resolve features in time.] +**** # {takesValue, valueClass=numericClass} +** Data-source-type [The type of place, person, or thing from which the data comes or can be obtained.] +*** Computed-feature[A feature computed from the data by a tool. This tag should be grouped with a label of the form Toolname_propertyName.] +*** Computed-prediction [A computed extrapolation of known data.] +*** Expert-annotation [An explanatory or critical comment or other in-context information provided by an authority.] +*** Instrument-measurement [Information obtained from a device that is used to measure material properties or make other observations.] +*** Observation [Active acquisition of information from a primary source. Should be grouped with a label of the form AgentID_featureName.] +** Data-value [Designation of the type of a data item.] +*** Categorical-value [Indicates that something can take on a limited and usually fixed number of possible values.] +**** Categorical-class-value [Categorical values that fall into discrete classes such as true or false. The grouping is absolute in the sense that it is the same for all participants.] +***** All {relatedTag=Some, relatedTag=None}[To a complete degree or to the full or entire extent.] +***** Correct {relatedTag=Wrong}[Free from error. Especially conforming to fact or truth.] +***** Explicit {relatedTag=Implicit}[Stated clearly and in detail, leaving no room for confusion or doubt.] +***** False {relatedTag=True}[Not in accordance with facts, reality or definitive criteria.] +***** Implicit {relatedTag=Explicit}[Implied though not plainly expressed.] +***** Invalid {relatedTag=Valid}[Not allowed or not conforming to the correct format or specifications.] +***** None {relatedTag=All, relatedTag=Some}[No person or thing, nobody, not any.] +***** Some {relatedTag=All, relatedTag=None}[At least a small amount or number of, but not a large amount of, or often.] +***** True {relatedTag=False}[Conforming to facts, reality or definitive criteria.] +***** Valid {relatedTag=Invalid}[Allowable, usable, or acceptable.] +***** Wrong {relatedTag=Correct}[Inaccurate or not correct.] +**** Categorical-judgment-value [Categorical values that are based on the judgment or perception of the participant such familiar and famous.] +***** Abnormal {relatedTag=Normal}[Deviating in any way from the state, position, structure, condition, behavior, or rule which is considered a norm.] +***** Asymmetrical {relatedTag=Symmetrical}[Lacking symmetry or having parts that fail to correspond to one another in shape, size, or arrangement.] +***** Audible {relatedTag=Inaudible}[A sound that can be perceived by the participant.] +***** Congruent {relatedTag=Incongruent}[Concordance of multiple evidence lines. In agreement or harmony.] +***** Complex {relatedTag=Simple}[Hard, involved or complicated, elaborate, having many parts.] +***** Constrained {relatedTag=Unconstrained}[Keeping something within particular limits or bounds.] +***** Disordered {relatedTag=Ordered}[Not neatly arranged. Confused and untidy. A structural quality in which the parts of an object are non-rigid.] +***** Familiar {relatedTag=Unfamiliar, relatedTag=Famous}[Recognized, familiar, or within the scope of knowledge.] +***** Famous {relatedTag=Familiar, relatedTag=Unfamiliar}[A person who has a high degree of recognition by the general population for his or her success or accomplishments. A famous person.] +***** Inaudible {relatedTag=Audible}[A sound below the threshold of perception of the participant.] +***** Incongruent {relatedTag=Congruent}[Not in agreement or harmony.] +***** Involuntary {relatedTag=Voluntary}[An action that is not made by choice. In the body, involuntary actions (such as blushing) occur automatically, and cannot be controlled by choice.] +***** Masked {relatedTag=Unmasked}[Information exists but is not provided or is partially obscured due to security, privacy, or other concerns.] +***** Normal {relatedTag=Abnormal}[Being approximately average or within certain limits. Conforming with or constituting a norm or standard or level or type or social norm.] +***** Ordered {relatedTag=Disordered}[Conforming to a logical or comprehensible arrangement of separate elements.] +***** Simple {relatedTag=Complex}[Easily understood or presenting no difficulties.] +***** Symmetrical {relatedTag=Asymmetrical}[Made up of exactly similar parts facing each other or around an axis. Showing aspects of symmetry.] +***** Unconstrained {relatedTag=Constrained}[Moving without restriction.] +***** Unfamiliar {relatedTag=Familiar,relatedTag=Famous}[Not having knowledge or experience of.] +***** Unmasked {relatedTag=Masked}[Information is revealed.] +***** Voluntary {relatedTag=Involuntary}[Using free will or design; not forced or compelled; controlled by individual volition.] +**** Categorical-level-value [Categorical values based on dividing a continuous variable into levels such as high and low.] +***** Cold {relatedTag=Hot}[Having an absence of heat.] +***** Deep {relatedTag=Shallow}[Extending relatively far inward or downward.] +***** High {relatedTag=Low, relatedTag=Medium}[Having a greater than normal degree, intensity, or amount.] +***** Hot {relatedTag=Cold}[Having an excess of heat.] +***** Large {relatedTag=Small}[Having a great extent such as in physical dimensions, period of time, amplitude or frequency.] +***** Liminal {relatedTag=Subliminal, relatedTag=Supraliminal}[Situated at a sensory threshold that is barely perceptible or capable of eliciting a response.] +***** Loud {relatedTag=Quiet}[Having a perceived high intensity of sound.] +***** Low {relatedTag=High}[Less than normal in degree, intensity or amount.] +***** Medium {relatedTag=Low, relatedTag=High}[Mid-way between small and large in number, quantity, magnitude or extent.] +***** Negative {relatedTag=Positive}[Involving disadvantage or harm.] +***** Positive {relatedTag=Negative}[Involving advantage or good.] +***** Quiet {relatedTag=Loud}[Characterizing a perceived low intensity of sound.] +***** Rough {relatedTag=Smooth}[Having a surface with perceptible bumps, ridges, or irregularities.] +***** Shallow {relatedTag=Deep}[Having a depth which is relatively low.] +***** Small {relatedTag=Large}[Having a small extent such as in physical dimensions, period of time, amplitude or frequency.] +***** Smooth {relatedTag=Rough}[Having a surface free from bumps, ridges, or irregularities.] +***** Subliminal {relatedTag=Liminal, relatedTag=Supraliminal}[Situated below a sensory threshold that is imperceptible or not capable of eliciting a response.] +***** Supraliminal {relatedTag=Liminal, relatedTag=Subliminal}[Situated above a sensory threshold that is perceptible or capable of eliciting a response.] +***** Thick {relatedTag=Thin}[Wide in width, extent or cross-section.] +***** Thin {relatedTag=Thick}[Narrow in width, extent or cross-section.] +**** Categorical-orientation-value [Value indicating the orientation or direction of something.] +***** Backward {relatedTag=Forward}[Directed behind or to the rear.] +***** Downward {relatedTag=Leftward,relatedTag=Rightward,relatedTag=Upward}[Moving or leading toward a lower place or level.] +***** Forward {relatedTag=Backward}[At or near or directed toward the front.] +***** Horizontally-oriented {relatedTag=Vertically-oriented}[Oriented parallel to or in the plane of the horizon.] +***** Leftward {relatedTag=Downward, relatedTag=Rightward,relatedTag=Upward}[Going toward or facing the left.] +***** Oblique {relatedTag=Rotated}[Slanting or inclined in direction, course, or position that is neither parallel nor perpendicular nor right-angular.] +***** Rightward {relatedTag=Downward, relatedTag=Leftward,relatedTag=Upward}[Going toward or situated on the right.] +***** Rotated [Positioned offset around an axis or center.] +***** Upward {relatedTag=Downward,relatedTag=Leftward,relatedTag=Rightward}[Moving, pointing, or leading to a higher place, point, or level.] +***** Vertically-oriented {relatedTag=Horizontally-oriented}[Oriented perpendicular to the plane of the horizon.] +*** Physical-value [The value of some physical property of something.] +**** Weight [The relative mass or the quantity of matter contained by something.] +***** # {takesValue, valueClass=numericClass, unitClass=weightUnits} +**** Temperature [A measure of hot or cold based on the average kinetic energy of the atoms or molecules in the system.] +***** # {takesValue, valueClass=numericClass, unitClass=temperatureUnits} +*** Quantitative-value [Something capable of being estimated or expressed with numeric values.] +**** Fraction [A numerical value between 0 and 1.] +***** # {takesValue, valueClass=numericClass} +**** Item-count [The integer count of something which is usually grouped with the entity it is counting. (Item-count/3, A) indicates that 3 of A have occurred up to this point.] +***** # {takesValue, valueClass=numericClass} +**** Item-index [The index of an item in a collection, sequence or other structure. (A (Item-index/3, B)) means that A is item number 3 in B.] +***** # {takesValue, valueClass=numericClass} +**** Item-interval [An integer indicating how many items or entities have passed since the last one of these. An item interval of 0 indicates the current item.] +***** # {takesValue, valueClass=numericClass} +**** Percentage [A fraction or ratio with 100 understood as the denominator.] +***** # {takesValue, valueClass=numericClass} +**** Ratio [A quotient of quantities of the same kind for different components within the same system.] +***** # {takesValue, valueClass=numericClass} +*** Statistical-value {extensionAllowed}[A value based on or employing the principles of statistics.] +**** Data-maximum [The largest possible quantity or degree.] +***** # {takesValue, valueClass=numericClass}[] +**** Data-mean [The sum of a set of values divided by the number of values in the set.] +***** # {takesValue, valueClass=numericClass} +**** Data-median [The value which has an equal number of values greater and less than it.] +***** # {takesValue, valueClass=numericClass} +**** Data-minimum [The smallest possible quantity.] +***** # {takesValue, valueClass=numericClass} +**** Probability [A measure of the expectation of the occurrence of a particular event.] +***** # {takesValue, valueClass=numericClass} +**** Standard-deviation [A measure of the range of values in a set of numbers. Standard deviation is a statistic used as a measure of the dispersion or variation in a distribution, equal to the square root of the arithmetic mean of the squares of the deviations from the arithmetic mean.] +***** # {takesValue, valueClass=numericClass} +**** Statistical-accuracy [A measure of closeness to true value expressed as a number between 0 and 1.] +***** # {takesValue, valueClass=numericClass} +**** Statistical-precision [A quantitative representation of the degree of accuracy necessary for or associated with a particular action.] +***** # {takesValue, valueClass=numericClass} +**** Statistical-recall [Sensitivity is a measurement datum qualifying a binary classification test and is computed by substracting the false negative rate to the integral numeral 1.] +***** # {takesValue, valueClass=numericClass} +**** Statistical-uncertainty [A measure of the inherent variability of repeated observation measurements of a quantity including quantities evaluated by statistical methods and by other means.] +***** # {takesValue, valueClass=numericClass} +*** Spatiotemporal-value [A property relating to space and/or time.] +**** Rate-of-change [The amount of change accumulated per unit time.] +***** Acceleration [Magnitude of the rate of change in either speed or direction. The direction of change should be given separately.] +****** # {takesValue, valueClass=numericClass, unitClass=accelerationUnits} +***** Frequency [Frequency is the number of occurrences of a repeating event per unit time.] +****** # {takesValue, valueClass=numericClass, unitClass=frequencyUnits} +***** Jerk-rate [Magnitude of the rate at which the acceleration of an object changes with respect to time. The direction of change should be given separately.] +****** # {takesValue, valueClass=numericClass, unitClass=jerkUnits} +***** Sampling-rate [The number of digital samples taken or recorded per unit of time.] +****** # {takesValue, unitClass=frequencyUnits} +***** Refresh-rate [The frequency with which the image on a computer monitor or similar electronic display screen is refreshed, usually expressed in hertz.] +****** # {takesValue, valueClass=numericClass} +***** Speed [A scalar measure of the rate of movement of the object expressed either as the distance travelled divided by the time taken (average speed) or the rate of change of position with respect to time at a particular point (instantaneous speed). The direction of change should be given separately.] +****** # {takesValue, valueClass=numericClass, unitClass=speedUnits} +***** Temporal-rate [The number of items per unit of time.] +****** # {takesValue, valueClass=numericClass, unitClass=frequencyUnits} +**** Spatial-value [Value of an item involving space.] +***** Angle[The amount of inclination of one line to another or the plane of one object to another.] +****** # {takesValue, unitClass=angleUnits, valueClass=numericClass} +***** Distance [A measure of the space separating two objects or points.] +****** # {takesValue, valueClass=numericClass, unitClass=physicalLengthUnits} +***** Position [A reference to the alignment of an object, a particular situation or view of a situation, or the location of an object. Coordinates with respect a specified frame of reference or the default Screen-frame if no frame is given.] +****** X-position [The position along the x-axis of the frame of reference.] +******* # {takesValue, valueClass=numericClass, unitClass=physicalLengthUnits} +****** Y-position [The position along the y-axis of the frame of reference.] +******* # {takesValue, valueClass=numericClass, unitClass=physicalLengthUnits} +****** Z-position [The position along the z-axis of the frame of reference.] +******* # {takesValue, valueClass=numericClass, unitClass=physicalLengthUnits} +***** Size [The physical magnitude of something.] +****** Area [The extent of a 2-dimensional surface enclosed within a boundary.] +******* # {takesValue, valueClass=numericClass, unitClass=areaUnits} +****** Depth [The distance from the surface of something especially from the perspective of looking from the front.] +******* # {takesValue, valueClass=numericClass, unitClass=physicalLengthUnits} +****** Length [The linear extent in space from one end of something to the other end, or the extent of something from beginning to end.] +******* # {takesValue, valueClass=numericClass, unitClass=physicalLengthUnits} +****** Width [The extent or measurement of something from side to side.] +******* # {takesValue, valueClass=numericClass, unitClass=physicalLengthUnits} +****** Height [The vertical measurement or distance from the base to the top of an object.] +******* # {takesValue, valueClass=numericClass, unitClass=physicalLengthUnits} +****** Volume [The amount of three dimensional space occupied by an object or the capacity of a space or container.] +******* # {takesValue, valueClass=numericClass, unitClass=volumeUnits} +**** Temporal-value [A characteristic of or relating to time or limited by time.] +***** Delay {topLevelTagGroup, reserved, relatedTag=Duration}[The time at which an event start time is delayed from the current onset time. This tag defines the start time of an event of temporal extent and may be used with the Duration tag.] +****** # {takesValue, valueClass=numericClass, unitClass=timeUnits} +***** Duration {topLevelTagGroup, reserved, relatedTag=Delay}[The period of time during which an event occurs. This tag defines the end time of an event of temporal extent and may be used with the Delay tag.] +****** # {takesValue, valueClass=numericClass, unitClass=timeUnits} +***** Time-interval [The period of time separating two instances, events, or occurrences.] +****** # {takesValue, valueClass=numericClass, unitClass=timeUnits} +***** Time-value [A value with units of time. Usually grouped with tags identifying what the value represents.] +****** # {takesValue, valueClass=numericClass, unitClass=timeUnits} +** Data-variability-attribute[An attribute describing how something changes or varies.] +*** Abrupt [Marked by sudden change.] +*** Constant [Continually recurring or continuing without interruption. Not changing in time or space.] +*** Continuous {relatedTag=Discrete,relatedTag=Discontinuous}[Uninterrupted in time, sequence, substance, or extent.] +*** Decreasing {relatedTag=Increasing}[Becoming smaller or fewer in size, amount, intensity, or degree.] +*** Deterministic {relatedTag=Random,relatedTag=Stochastic}[No randomness is involved in the development of the future states of the element.] +*** Discontinuous {relatedTag=Continuous}[Having a gap in time, sequence, substance, or extent.] +*** Discrete {relatedTag=Continuous,relatedTag=Discontinuous}[Constituting a separate entities or parts.] +*** Flickering [Moving irregularly or unsteadily or burning or shining fitfully or with a fluctuating light.] +*** Estimated-value [Something that has been calculated or measured approximately.] +*** Exact-value [A value that is viewed to the true value according to some standard.] +*** Fractal [Having extremely irregular curves or shapes for which any suitably chosen part is similar in shape to a given larger or smaller part when magnified or reduced to the same size.] +*** Increasing {relatedTag=Decreasing}[Becoming greater in size, amount, or degree.] +*** Random {relatedTag=Deterministic,relatedTag=Stochastic}[Governed by or depending on chance. Lacking any definite plan or order or purpose.] +*** Repetitive [A recurring action that is often non-purposeful.] +*** Stochastic {relatedTag=Deterministic,relatedTag=Random}[Uses a random probability distribution or pattern that may be analysed statistically but may not be predicted precisely to determine future states.] +*** Varying [Differing in size, amount, degree, or nature.] +* Environmental-property [Relating to or arising from the surroundings of an agent.] +** Indoors [Located inside a building or enclosure.] +** Outdoors [Any area outside a building or shelter.] +** Real-world [Located in a place that exists in real space and time under realistic conditions.] +** Virtual-world [Using technology that creates immersive, computer-generated experiences that a person can interact with and navigate through. The digital content is generally delivered to the user through some type of headset and responds to changes in head position or through interaction with other types of sensors. Existing in a virtual setting such as a simulation or game environment.] +** Augmented-reality [Using technology that enhances real-world experiences with computer-derived digital overlays to change some aspects of perception of the natural environment. The digital content is shown to the user through a smart device or glasses and responds to changes in the environment.] +** Motion-platform [A mechanism that creates the feelings of being in a real motion environment.] +** Urban [Relating to, located in, or characteristic of a city or densely populated area.] +** Rural [Of or pertaining to the country as opposed to the city.] +** Terrain [Characterization of the physical features of a tract of land.] +*** Composite-terrain [Tracts of land characterized by a mixure of physical features.] +*** Dirt-terrain [Tracts of land characterized by a soil surface and lack of vegetation.] +*** Grassy-terrain [Tracts of land covered by grass.] +*** Gravel-terrain [Tracts of land covered by a surface consisting a loose aggregation of small water-worn or pounded stones.] +*** Leaf-covered-terrain [Tracts of land covered by leaves and composited organic material.] +*** Muddy-terrain [Tracts of land covered by a liquid or semi-liquid mixture of water and some combination of soil, silt, and clay.] +*** Paved-terrain [Tracts of land covered with concrete, asphalt, stones, or bricks.] +*** Rocky-terrain [Tracts of land consisting or full of rock or rocks.] +*** Sloped-terrain [Tracts of land arranged in a sloping or inclined position.] +*** Uneven-terrain [Tracts of land that are not level, smooth, or regular.] +* Informational-property{extensionAllowed}[Something that pertains to a task.] +** Description {requireChild} [An explanation of what the tag group it is in means. If the description is at the top-level of an event string, the description applies to the event.] +*** # {takesValue, valueClass=textClass} +** ID {requireChild} [An alphanumeric name that identifies either a unique object or a unique class of objects. Here the object or class may be an idea, physical countable object (or class), or physical uncountable substance (or class).] +*** # {takesValue, valueClass=textClass} +** Label {requireChild} [A string of 20 or fewer characters identifying something. Labels usually refer to general classes of things while IDs refer to specific instances. A term that is associated with some entity. A brief description given for purposes of identification. An identifying or descriptive marker that is attached to an object.] +*** # {takesValue, valueClass=nameClass} +** Metadata [Data about data. Information that describes another set of data.] +*** CogAtlas [The Cognitive Atlas ID number of something.] +**** # {takesValue} +*** CogPo [The CogPO ID number of something.] +**** # {takesValue} +*** Creation-date {requireChild}[The date on which data creation of this element began.] +**** # {takesValue, valueClass=dateTimeClass} +*** Experimental-note [A brief written record about the experiment.] +**** # {takesValue, valueClass=textClass} +*** Library-name [Official name of a HED library.] +**** # {takesValue, valueClass=nameClass} +*** OBO-identifier [The identifier of a term in some Open Biology Ontology (OBO) ontology.] +**** # {takesValue, valueClass=nameClass} +*** Pathname [The specification of a node (file or directory) in a hierarchical file system, usually specified by listing the nodes top-down.] +**** # {takesValue} +*** Subject-identifier [A sequence of characters used to identify, name, or characterize a trial or study subject.] +**** # {takesValue} +*** Version-identifier [An alphanumeric character string that identifies a form or variant of a type or original.] +**** # {takesValue}[Usually is a semantic version.] +** Parameter [Something user-defined for this experiment.] +*** Parameter-label [The name of the parameter.] +**** # {takesValue, valueClass=nameClass} +*** Parameter-value [The value of the parameter.] +**** # {takesValue, valueClass=textClass} +* Organizational-property [Relating to an organization or the action of organizing something.] +** Collection [A tag designating a grouping of items such as in a set or list.] +*** # {takesValue, valueClass=nameClass}[Name of the collection.] +** Condition-variable [An aspect of the experiment or task that is to be varied during the experiment. Task-conditions are sometimes called independent variables or contrasts.] +*** # {takesValue, valueClass=nameClass}[Name of the condition variable.] +** Control-variable [An aspect of the experiment that is fixed throughout the study and usually is explicitly controlled.] +*** # {takesValue, valueClass=nameClass}[Name of the control variable.] +** Def {requireChild,reserved} [A HED-specific utility tag used with a defined name to represent the tags associated with that definition.] +*** # {takesValue, valueClass=nameClass}[Name of the definition.] +** Def-expand {requireChild,reserved,tagGroup} [A HED specific utility tag that is grouped with an expanded definition. The child value of the Def-expand is the name of the expanded definition.] +*** # {takesValue, valueClass=nameClass} +** Definition {requireChild,reserved,topLevelTagGroup}[A HED-specific utility tag whose child value is the name of the concept and the tag group associated with the tag is an English language explanation of a concept.] +*** # {takesValue, valueClass=nameClass}[Name of the definition.] +** Event-context {reserved,topLevelTagGroup,unique}[A special HED tag inserted as part of a top-level tag group to contain information about the interrelated conditions under which the event occurs. The event context includes information about other events that are ongoing when this event happens.] +** Event-stream [A special HED tag indicating that this event is a member of an ordered succession of events.] +*** # {takesValue, valueClass=nameClass}[Name of the event stream.] +** Experimental-intertrial [A tag used to indicate a part of the experiment between trials usually where nothing is happening.] +*** # {takesValue, valueClass=nameClass}[Optional label for the intertrial block.] +** Experimental-trial [Designates a run or execution of an activity, for example, one execution of a script. A tag used to indicate a particular organizational part in the experimental design often containing a stimulus-response pair or stimulus-response-feedback triad.] +*** # {takesValue, valueClass=nameClass}[Optional label for the trial (often a numerical string).] +** Indicator-variable [An aspect of the experiment or task that is measured as task conditions are varied during the experiment. Experiment indicators are sometimes called dependent variables.] +*** # {takesValue, valueClass=nameClass}[Name of the indicator variable.] +** Recording [A tag designating the data recording. Recording tags are usually have temporal scope which is the entire recording.] +*** # {takesValue, valueClass=nameClass}[Optional label for the recording.] +** Task [An assigned piece of work, usually with a time allotment. A tag used to indicate a linkage the structured activities performed as part of the experiment.] +*** # {takesValue, valueClass=nameClass}[Optional label for the task block.] +** Time-block [A tag used to indicate a contiguous time block in the experiment during which something is fixed or noted.] +*** # {takesValue, valueClass=nameClass}[Optional label for the task block.] +* Sensory-property [Relating to sensation or the physical senses.] +** Sensory-attribute [A sensory characteristic associated with another entity.] +*** Auditory-attribute [Pertaining to the sense of hearing.] +**** Loudness [Perceived intensity of a sound.] +***** # {takesValue, valueClass=numericClass, valueClass=nameClass} +**** Pitch [A perceptual property that allows the user to order sounds on a frequency scale.] +***** # {takesValue, valueClass=numericClass, unitClass=frequencyUnits} +**** Sound-envelope [Description of how a sound changes over time.] +***** Sound-envelope-attack [The time taken for initial run-up of level from nil to peak usually beginning when the key on a musical instrument is pressed.] +****** # {takesValue, valueClass=numericClass, unitClass=timeUnits} +***** Sound-envelope-decay [The time taken for the subsequent run down from the attack level to the designated sustain level.] +****** # {takesValue, valueClass=numericClass, unitClass=timeUnits} +***** Sound-envelope-release [The time taken for the level to decay from the sustain level to zero after the key is released.] +****** # {takesValue, valueClass=numericClass, unitClass=timeUnits} +***** Sound-envelope-sustain [The time taken for the main sequence of the sound duration, until the key is released.] +****** # {takesValue, valueClass=numericClass, unitClass=timeUnits} +**** Timbre [The perceived sound quality of a singing voice or musical instrument.] +***** # {takesValue, valueClass=nameClass} +**** Sound-volume [The sound pressure level (SPL) usually the ratio to a reference signal estimated as the lower bound of hearing.] +***** # {takesValue, valueClass=numericClass, unitClass=intensityUnits} +*** Gustatory-attribute [Pertaining to the sense of taste.] +**** Bitter [Having a sharp, pungent taste.] +**** Salty [Tasting of or like salt.] +**** Savory [Belonging to a taste that is salty or spicy rather than sweet.] +**** Sour [Having a sharp, acidic taste.] +**** Sweet [Having or resembling the taste of sugar.] +*** Olfactory-attribute [Having a smell.] +*** Somatic-attribute [Pertaining to the feelings in the body or of the nervous system.] +**** Pain [The sensation of discomfort, distress, or agony, resulting from the stimulation of specialized nerve endings.] +**** Stress [The negative mental, emotional, and physical reactions that occur when environmental stressors are perceived as exceeding the adaptive capacities of the individual.] +*** Tactile-attribute [Pertaining to the sense of touch.] +**** Tactile-pressure [Having a feeling of heaviness.] +**** Tactile-temperature [Having a feeling of hotness or coldness.] +**** Tactile-texture [Having a feeling of roughness.] +**** Tactile-vibration [Having a feeling of mechanical oscillation.] +*** Vestibular-attribute [Pertaining to the sense of balance or body position.] +*** Visual-attribute [Pertaining to the sense of sight.] +**** Color [The appearance of objects (or light sources) described in terms of perception of their hue and lightness (or brightness) and saturation.] +***** CSS-color [One of 140 colors supported by all browsers. For more details such as the color RGB or HEX values, check: https://www.w3schools.com/colors/colors_groups.asp.] +****** Blue-color [CSS color group.] +******* CadetBlue [CSS-color 0x5F9EA0.] +******* SteelBlue [CSS-color 0x4682B4.] +******* LightSteelBlue [CSS-color 0xB0C4DE.] +******* LightBlue [CSS-color 0xADD8E6.] +******* PowderBlue [CSS-color 0xB0E0E6.] +******* LightSkyBlue [CSS-color 0x87CEFA.] +******* SkyBlue [CSS-color 0x87CEEB.] +******* CornflowerBlue [CSS-color 0x6495ED.] +******* DeepSkyBlue [CSS-color 0x00BFFF.] +******* DodgerBlue [CSS-color 0x1E90FF.] +******* RoyalBlue [CSS-color 0x4169E1.] +******* Blue [CSS-color 0x0000FF.] +******* MediumBlue [CSS-color 0x0000CD.] +******* DarkBlue [CSS-color 0x00008B.] +******* Navy [CSS-color 0x000080.] +******* MidnightBlue [CSS-color 0x191970.] +****** Brown-color [CSS color group.] +******* Cornsilk [CSS-color 0xFFF8DC.] +******* BlanchedAlmond [CSS-color 0xFFEBCD.] +******* Bisque [CSS-color 0xFFE4C4.] +******* NavajoWhite [CSS-color 0xFFDEAD.] +******* Wheat [CSS-color 0xF5DEB3.] +******* BurlyWood [CSS-color 0xDEB887.] +******* Tan [CSS-color 0xD2B48C.] +******* RosyBrown [CSS-color 0xBC8F8F.] +******* SandyBrown [CSS-color 0xF4A460.] +******* GoldenRod [CSS-color 0xDAA520.] +******* DarkGoldenRod [CSS-color 0xB8860B.] +******* Peru [CSS-color 0xCD853F.] +******* Chocolate [CSS-color 0xD2691E.] +******* Olive [CSS-color 0x808000.] +******* SaddleBrown [CSS-color 0x8B4513.] +******* Sienna [CSS-color 0xA0522D.] +******* Brown [CSS-color 0xA52A2A.] +******* Maroon [CSS-color 0x800000.] +****** Cyan-color [CSS color group.] +******* Aqua [CSS-color 0x00FFFF.] +******* Cyan [CSS-color 0x00FFFF.] +******* LightCyan [CSS-color 0xE0FFFF.] +******* PaleTurquoise [CSS-color 0xAFEEEE.] +******* Aquamarine [CSS-color 0x7FFFD4.] +******* Turquoise [CSS-color 0x40E0D0.] +******* MediumTurquoise [CSS-color 0x48D1CC.] +******* DarkTurquoise [CSS-color 0x00CED1.] +****** Green-color [CSS color group.] +******* GreenYellow [CSS-color 0xADFF2F.] +******* Chartreuse [CSS-color 0x7FFF00.] +******* LawnGreen [CSS-color 0x7CFC00.] +******* Lime [CSS-color 0x00FF00.] +******* LimeGreen [CSS-color 0x32CD32.] +******* PaleGreen [CSS-color 0x98FB98.] +******* LightGreen [CSS-color 0x90EE90.] +******* MediumSpringGreen [CSS-color 0x00FA9A.] +******* SpringGreen [CSS-color 0x00FF7F.] +******* MediumSeaGreen [CSS-color 0x3CB371.] +******* SeaGreen [CSS-color 0x2E8B57.] +******* ForestGreen [CSS-color 0x228B22.] +******* Green [CSS-color 0x008000.] +******* DarkGreen [CSS-color 0x006400.] +******* YellowGreen [CSS-color 0x9ACD32.] +******* OliveDrab [CSS-color 0x6B8E23.] +******* DarkOliveGreen [CSS-color 0x556B2F.] +******* MediumAquaMarine [CSS-color 0x66CDAA.] +******* DarkSeaGreen [CSS-color 0x8FBC8F.] +******* LightSeaGreen [CSS-color 0x20B2AA.] +******* DarkCyan [CSS-color 0x008B8B.] +******* Teal [CSS-color 0x008080.] +****** Gray-color [CSS color group.] +******* Gainsboro [CSS-color 0xDCDCDC.] +******* LightGray [CSS-color 0xD3D3D3.] +******* Silver [CSS-color 0xC0C0C0.] +******* DarkGray [CSS-color 0xA9A9A9.] +******* DimGray [CSS-color 0x696969.] +******* Gray [CSS-color 0x808080.] +******* LightSlateGray [CSS-color 0x778899.] +******* SlateGray [CSS-color 0x708090.] +******* DarkSlateGray [CSS-color 0x2F4F4F.] +******* Black [CSS-color 0x000000.] +****** Orange-color [CSS color group.] +******* Orange [CSS-color 0xFFA500.] +******* DarkOrange [CSS-color 0xFF8C00.] +******* Coral [CSS-color 0xFF7F50.] +******* Tomato [CSS-color 0xFF6347.] +******* OrangeRed [CSS-color 0xFF4500.] +****** Pink-color [CSS color group.] +******* Pink [CSS-color 0xFFC0CB.] +******* LightPink [CSS-color 0xFFB6C1.] +******* HotPink [CSS-color 0xFF69B4.] +******* DeepPink [CSS-color 0xFF1493.] +******* PaleVioletRed [CSS-color 0xDB7093.] +******* MediumVioletRed [CSS-color 0xC71585.] +****** Purple-color [CSS color group.] +******* Lavender [CSS-color 0xE6E6FA.] +******* Thistle [CSS-color 0xD8BFD8.] +******* Plum [CSS-color 0xDDA0DD.] +******* Orchid [CSS-color 0xDA70D6.] +******* Violet [CSS-color 0xEE82EE.] +******* Fuchsia [CSS-color 0xFF00FF.] +******* Magenta [CSS-color 0xFF00FF.] +******* MediumOrchid [CSS-color 0xBA55D3.] +******* DarkOrchid [CSS-color 0x9932CC.] +******* DarkViolet [CSS-color 0x9400D3.] +******* BlueViolet [CSS-color 0x8A2BE2.] +******* DarkMagenta [CSS-color 0x8B008B.] +******* Purple [CSS-color 0x800080.] +******* MediumPurple [CSS-color 0x9370DB.] +******* MediumSlateBlue [CSS-color 0x7B68EE.] +******* SlateBlue [CSS-color 0x6A5ACD.] +******* DarkSlateBlue [CSS-color 0x483D8B.] +******* RebeccaPurple [CSS-color 0x663399.] +******* Indigo [CSS-color 0x4B0082.] +****** Red-color [CSS color group.] +******* LightSalmon [CSS-color 0xFFA07A.] +******* Salmon [CSS-color 0xFA8072.] +******* DarkSalmon [CSS-color 0xE9967A.] +******* LightCoral [CSS-color 0xF08080.] +******* IndianRed [CSS-color 0xCD5C5C.] +******* Crimson [CSS-color 0xDC143C.] +******* Red [CSS-color 0xFF0000.] +******* FireBrick [CSS-color 0xB22222.] +******* DarkRed [CSS-color 0x8B0000.] +****** Yellow-color [CSS color group.] +******* Gold [CSS-color 0xFFD700.] +******* Yellow [CSS-color 0xFFFF00.] +******* LightYellow [CSS-color 0xFFFFE0.] +******* LemonChiffon [CSS-color 0xFFFACD.] +******* LightGoldenRodYellow [CSS-color 0xFAFAD2.] +******* PapayaWhip [CSS-color 0xFFEFD5.] +******* Moccasin [CSS-color 0xFFE4B5.] +******* PeachPuff [CSS-color 0xFFDAB9.] +******* PaleGoldenRod [CSS-color 0xEEE8AA.] +******* Khaki [CSS-color 0xF0E68C.] +******* DarkKhaki [CSS-color 0xBDB76B.] +****** White-color [CSS color group.] +******* White [CSS-color 0xFFFFFF.] +******* Snow [CSS-color 0xFFFAFA.] +******* HoneyDew [CSS-color 0xF0FFF0.] +******* MintCream [CSS-color 0xF5FFFA.] +******* Azure [CSS-color 0xF0FFFF.] +******* AliceBlue [CSS-color 0xF0F8FF.] +******* GhostWhite [CSS-color 0xF8F8FF.] +******* WhiteSmoke [CSS-color 0xF5F5F5.] +******* SeaShell [CSS-color 0xFFF5EE.] +******* Beige [CSS-color 0xF5F5DC.] +******* OldLace [CSS-color 0xFDF5E6.] +******* FloralWhite [CSS-color 0xFFFAF0.] +******* Ivory [CSS-color 0xFFFFF0.] +******* AntiqueWhite [CSS-color 0xFAEBD7.] +******* Linen [CSS-color 0xFAF0E6.] +******* LavenderBlush [CSS-color 0xFFF0F5.] +******* MistyRose [CSS-color 0xFFE4E1.] +***** Color-shade [A slight degree of difference between colors, especially with regard to how light or dark it is or as distinguished from one nearly like it.] +****** Dark-shade [A color tone not reflecting much light.] +****** Light-shade [A color tone reflecting more light.] +***** Grayscale [Using a color map composed of shades of gray, varying from black at the weakest intensity to white at the strongest.] +****** # {takesValue, valueClass=numericClass} [White intensity between 0 and 1.] +***** HSV-color [A color representation that models how colors appear under light.] +****** Hue [Attribute of a visual sensation according to which an area appears to be similar to one of the perceived colors.] +******* # {takesValue, valueClass=numericClass} [Angular value between 0 and 360.] +****** Saturation [Colorfulness of a stimulus relative to its own brightness.] +******* # {takesValue, valueClass=numericClass} [B value of RGB between 0 and 1.] +****** HSV-value [An attribute of a visual sensation according to which an area appears to emit more or less light.] +******* # {takesValue, valueClass=numericClass} +***** RGB-color [A color from the RGB schema.] +****** RGB-red [The red component.] +******* # {takesValue, valueClass=numericClass} [R value of RGB between 0 and 1.] +****** RGB-blue [The blue component.] +******* # {takesValue, valueClass=numericClass} [B value of RGB between 0 and 1.] +****** RGB-green [The green component.] +******* # {takesValue, valueClass=numericClass} [G value of RGB between 0 and 1.] +**** Luminance [A quality that exists by virtue of the luminous intensity per unit area projected in a given direction.] +**** Opacity [A measure of impenetrability to light.] +** Sensory-presentation [The entity has a sensory manifestation.] +*** Auditory-presentation [The sense of hearing is used in the presentation to the user.] +**** Loudspeaker-separation {suggestedTag=Distance}[The distance between two loudspeakers. Grouped with the Distance tag.] +**** Monophonic [Relating to sound transmission, recording, or reproduction involving a single transmission path.] +**** Silent [The absence of ambient audible sound or the state of having ceased to produce sounds.] +**** Stereophonic [Relating to, or constituting sound reproduction involving the use of separated microphones and two transmission channels to achieve the sound separation of a live hearing.] +*** Gustatory-presentation [The sense of taste used in the presentation to the user.] +*** Olfactory-presentation [The sense of smell used in the presentation to the user.] +*** Somatic-presentation [The nervous system is used in the presentation to the user.] +*** Tactile-presentation [The sense of touch used in the presentation to the user.] +*** Vestibular-presentation [The sense balance used in the presentation to the user.] +*** Visual-presentation [The sense of sight used in the presentation to the user.] +**** 2D-view [A view showing only two dimensions.] +**** 3D-view [A view showing three dimensions.] +**** Background-view [Parts of the view that are farthest from the viewer and usually the not part of the visual focus.] +**** Bistable-view [Something having two stable visual forms that have two distinguishable stable forms as in optical illusions.] +**** Foreground-view [Parts of the view that are closest to the viewer and usually the most important part of the visual focus.] +**** Foveal-view [Visual presentation directly on the fovea. A view projected on the small depression in the retina containing only cones and where vision is most acute.] +**** Map-view [A diagrammatic representation of an area of land or sea showing physical features, cities, roads.] +***** Aerial-view [Elevated view of an object from above, with a perspective as though the observer were a bird.] +***** Satellite-view [A representation as captured by technology such as a satellite.] +***** Street-view [A 360-degrees panoramic view from a position on the ground.] +**** Peripheral-view [Indirect vision as it occurs outside the point of fixation.] +* Task-property {extensionAllowed}[Something that pertains to a task.] +** Task-attentional-demand [Strategy for allocating attention toward goal-relevant information.] +*** Bottom-up-attention {relatedTag=Top-down-attention}[Attentional guidance purely by externally driven factors to stimuli that are salient because of their inherent properties relative to the background. Sometimes this is referred to as stimulus driven.] +*** Covert-attention {relatedTag=Overt-attention}[Paying attention without moving the eyes.] +*** Divided-attention {relatedTag=Focused-attention}[Integrating parallel multiple stimuli. Behavior involving responding simultaneously to multiple tasks or multiple task demands.] +*** Focused-attention {relatedTag=Divided-attention}[Responding discretely to specific visual, auditory, or tactile stimuli.] +*** Orienting-attention [Directing attention to a target stimulus.] +*** Overt-attention {relatedTag=Covert-attention}[Selectively processing one location over others by moving the eyes to point at that location.] +*** Selective-attention [Maintaining a behavioral or cognitive set in the face of distracting or competing stimuli. Ability to pay attention to a limited array of all available sensory information.] +*** Sustained-attention [Maintaining a consistent behavioral response during continuous and repetitive activity.] +*** Switched-attention [Having to switch attention between two or more modalities of presentation.] +*** Top-down-attention {relatedTag=Bottom-up-attention}[Voluntary allocation of attention to certain features. Sometimes this is referred to goal-oriented attention.] +** Task-effect-evidence [The evidence supporting the conclusion that the event had the specified effect.] +*** Computational-evidence [A type of evidence in which data are produced, and/or generated, and/or analyzed on a computer.] +*** External-evidence [A phenomenon that follows and is caused by some previous phenomenon.] +*** Intended-effect [A phenomenon that is intended to follow and be caused by some previous phenomenon.] +*** Behavioral-evidence [An indication or conclusion based on the behavior of an agent.] +** Task-event-role [The purpose of an event with respect to the task.] +*** Experimental-stimulus [Part of something designed to elicit a response in the experiment.] +*** Incidental [A sensory or other type of event that is unrelated to the task or experiment.] +*** Instructional [Usually associated with a sensory event intended to give instructions to the participant about the task or behavior.] +*** Mishap [Unplanned disruption such as an equipment or experiment control abnormality or experimenter error.] +*** Participant-response [Something related to a participant actions in performing the task.] +*** Task-activity [Something that is part of the overall task or is necessary to the overall experiment but is not directly part of a stimulus-response cycle. Examples would be taking a survey or provided providing a silva sample.] +*** Warning [Something that should warn the participant that the parameters of the task have been or are about to be exceeded such as a warning message about getting too close to the shoulder of the road in a driving task.] +** Task-action-type [How an agent action should be interpreted in terms of the task specification.] +*** Appropriate-action {relatedTag=Inappropriate-action}[An action suitable or proper in the circumstances.] +*** Correct-action {relatedTag=Incorrect-action, relatedTag=Indeterminate-action}[An action that was a correct response in the context of the task.] +*** Correction [An action offering an improvement to replace a mistake or error.] +*** Done-indication {relatedTag=Ready-indication}[An action that indicates that the participant has completed this step in the task.] +*** Incorrect-action {relatedTag=Correct-action, relatedTag=Indeterminate-action}[An action considered wrong or incorrect in the context of the task.] +*** Imagined-action [Form a mental image or concept of something. This is used to identity something that only happened in the imagination of the participant as in imagined movements in motor imagery paradigms.] +*** Inappropriate-action {relatedTag=Appropriate-action}[An action not in keeping with what is correct or proper for the task.] +*** Indeterminate-action {relatedTag=Correct-action,relatedTag=Incorrect-action, relatedTag=Miss, relatedTag=Near-miss}[An action that cannot be distinguished between two or more possibibities in the current context. This tag might be applied when an outside evaluator or a classification algorithm cannot determine a definitive result.] +*** Omitted-action [An expected response was skipped.] +*** Miss {relatedTag=Near-miss}[An action considered to be a failure in the context of the task. For example, if the agent is supposed to try to hit a target and misses.] +*** Near-miss {relatedTag=Miss}[An action barely satisfied the requirements of the task. In a driving experiment for example this could pertain to a narrowly avoided collision or other accident.] +*** Ready-indication {relatedTag=Done-indication}[An action that indicates that the participant is ready to perform the next step in the task.] +** Task-relationship [Specifying organizational importance of sub-tasks.] +*** Background-subtask [A part of the task which should be performed in the background as for example inhibiting blinks due to instruction while performing the primary task.] +*** Primary-subtask [A part of the task which should be the primary focus of the participant.] +** Task-stimulus-role [The role the stimulus plays in the task.] +*** Cue [A signal for an action, a pattern of stimuli indicating a particular response.] +*** Distractor [A person or thing that distracts or a plausible but incorrect option in a multiple-choice question. In pyschological studies this is sometimes referred to as a foil.] +*** Expected {relatedTag=Unexpected, suggestedTag=Target}[Considered likely, probable or anticipated. Something of low information value as in frequent non-targets in an RSVP paradigm.] +*** Extraneous [Irrelevant or unrelated to the subject being dealt with.] +*** Feedback [An evaluative response to an inquiry, process, event, or activity.] +*** Go-signal {relatedTag=Stop-signal}[An indicator to proceed with a planned action.] +*** Meaningful [Conveying significant or relevant information.] +*** Newly-learned [Representing recently acquired information or understanding.] +*** Non-informative [Something that is not useful in forming an opinion or judging an outcome.] +*** Non-target {relatedTag=Target}[Something other than that done or looked for. Also tag Expected if the Non-target is frequent.] +*** Not-meaningful [Not having a serious, important, or useful quality or purpose.] +*** Novel [Having no previous example or precedent or parallel.] +*** Oddball {relatedTag=Unexpected, suggestedTag=Target}[Something unusual, or infrequent.] +*** Planned {relatedTag=Unplanned}[Something that was decided on or arranged in advance.] +*** Penalty [A disadvantage, loss, or hardship due to some action.] +*** Priming [An implicit memory effect in which exposure to a stimulus influences response to a later stimulus.] +*** Query [A sentence of inquiry that asks for a reply.] +*** Reward [A positive reinforcement for a desired action, behavior or response.] +*** Stop-signal {relatedTag=Go-signal}[An indicator that the agent should stop the current activity.] +*** Target [Something fixed as a goal, destination, or point of examination.] +*** Threat [An indicator that signifies hostility and predicts an increased probability of attack.] +*** Timed [Something planned or scheduled to be done at a particular time or lasting for a specified amount of time.] +*** Unexpected {relatedTag=Expected}[Something that is not anticipated.] +*** Unplanned {relatedTag=Planned}[Something that has not been planned as part of the task.] + +'''Relation''' {extensionAllowed}[Concerns the way in which two or more people or things are connected.] +* Comparative-relation [Something considered in comparison to something else. The first entity is the focus.] +** Approximately-equal-to [(A, (Approximately-equal-to, B)) indicates that A and B have almost the same value. Here A and B could refer to sizes, orders, positions or other quantities.] +** Less-than [(A, (Less-than, B)) indicates that A is smaller than B. Here A and B could refer to sizes, orders, positions or other quantities.] +** Less-than-or-equal-to [(A, (Less-than-or-equal-to, B)) indicates that the relative size or order of A is smaller than or equal to B.] +** Greater-than [(A, (Greater-than, B)) indicates that the relative size or order of A is bigger than that of B.] +** Greater-than-or-equal-to [(A, (Greater-than-or-equal-to, B)) indicates that the relative size or order of A is bigger than or the same as that of B.] +** Equal-to [(A, (Equal-to, B)) indicates that the size or order of A is the same as that of B.] +** Not-equal-to [(A, (Not-equal-to, B)) indicates that the size or order of A is not the same as that of B.] +* Connective-relation [Indicates two entities are related in some way. The first entity is the focus.] +** Belongs-to [(A, (Belongs-to, B)) indicates that A is a member of B.] +** Connected-to [(A, (Connected-to, B)) indicates that A is related to B in some respect, usually through a direct link.] +** Contained-in [(A, (Contained-in, B)) indicates that A is completely inside of B.] +** Described-by [(A, (Described-by, B)) indicates that B provides information about A.] +** From-to [(A, (From-to, B)) indicates a directional relation from A to B. A is considered the source.] +** Group-of [(A, (Group-of, B)) indicates A is a group of items of type B.] +** Implied-by [(A, (Implied-by, B)) indicates B is suggested by A.] +** Includes [(A, (Includes, B)) indicates that A has B as a member or part.] +** Interacts-with [(A, (Interacts-with, B)) indicates A and B interact, possibly reciprocally.] +** Member-of [(A, (Member-of, B)) indicates A is a member of group B.] +** Part-of [(A, (Part-of, B)) indicates A is a part of the whole B.] +** Performed-by [(A, (Performed-by, B)) indicates that the action or procedure A was carried out by agent B.] +** Performed-using [(A, (Performed-using, B)) indicates that the action or procedure A was accomplished using B.] +** Related-to [(A, (Related-to, B)) indicates A has some relationship to B.] +** Unrelated-to [(A, (Unrelated-to, B)) indicates that A is not related to B. For example, A is not related to Task.] +* Directional-relation [A relationship indicating direction of change of one entity relative to another. The first entity is the focus.] +** Away-from [(A, (Away-from, B)) indicates that A is going or has moved away from B. The meaning depends on A and B.] +** Towards [(A, (Towards, B)) indicates that A is going to or has moved to B. The meaning depends on A and B.] +* Logical-relation [Indicating a logical relationship between entities. The first entity is usually the focus.] +** And [(A, (And, B)) means A and B are both in effect.] +** Or [(A, (Or, B)) means at least one of A and B are in effect.] +* Spatial-relation [Indicating a relationship about position between entities.] +** Above [(A, (Above, B)) means A is in a place or position that is higher than B.] +** Across-from [(A, (Across-from, B)) means A is on the opposite side of something from B.] +** Adjacent-to [(A, (Adjacent-to, B)) indicates that A is next to B in time or space.] +** Ahead-of [(A, (Ahead-of, B)) indicates that A is further forward in time or space in B.] +** Around [(A, (Around, B)) means A is in or near the present place or situation of B.] +** Behind [(A, (Behind, B)) means A is at or to the far side of B, typically so as to be hidden by it.] +** Below [(A, (Below, B)) means A is in a place or position that is lower than the position of B.] +** Between [(A, (Between, (B, C))) means A is in the space or interval separating B and C.] +** Bilateral-to [(A, (Bilateral, B)) means A is on both sides of B or affects both sides of B.] +** Bottom-edge-of {relatedTag=Left-edge-of,relatedTag=Right-edge-of,relatedTag=Top-edge-of}[(A, (Bottom-edge-of, B)) means A is on the bottom most part or or near the boundary of B.] +** Boundary-of [(A, (Boundary-of, B)) means A is on or part of the edge or boundary of B.] +** Center-of [(A, (Center-of, B)) means A is at a point or or in an area that is approximately central within B.] +** Close-to [(A, (Close-to, B)) means A is at a small distance from or is located near in space to B.] +** Far-from [(A, (Far-from, B)) means A is at a large distance from or is not located near in space to B.] +** In-front-of [(A, (In-front-of, B)) means A is in a position just ahead or at the front part of B, potentially partially blocking B from view.] +** Left-edge-of {relatedTag=Bottom-edge-of,relatedTag=Right-edge-of,relatedTag=Top-edge-of}[(A, (Left-edge-of, B)) means A is located on the left side of B on or near the boundary of B.] +** Left-side-of {relatedTag=Right-side-of}[(A, (Left-side-of, B)) means A is located on the left side of B usually as part of B.] +** Lower-center-of {relatedTag=Center-of,relatedTag=Lower-left-of,relatedTag=Lower-right-of,relatedTag=Upper-center-of,relatedTag=Upper-right-of}[(A, (Lower-center-of, B)) means A is situated on the lower center part of B (due south). This relation is often used to specify qualitative information about screen position.] +** Lower-left-of {relatedTag=Center-of,relatedTag=Lower-center-of,relatedTag=Lower-right-of,relatedTag=Upper-center-of,relatedTag=Upper-left-of,relatedTag=Upper-right-of}[(A, (Lower-left-of, B)) means A is situated on the lower left part of B. This relation is often used to specify qualitative information about screen position.] +** Lower-right-of {relatedTag=Center-of,relatedTag=Lower-center-of,relatedTag=Lower-left-of,relatedTag=Upper-left-of,relatedTag=Upper-center-of,relatedTag=Upper-left-of,relatedTag=Lower-right-of}[(A, (Lower-right-of, B)) means A is situated on the lower right part of B. This relation is often used to specify qualitative information about screen position.] +** Outside-of [(A, (Outside-of, B)) means A is located in the space around but not including B.] +** Over [(A, (Over, B)) means A above is above B so as to cover or protect or A extends over the a general area as from a from a vantage point.] +** Right-edge-of {relatedTag=Bottom-edge-of,relatedTag=Left-edge-of,relatedTag=Top-edge-of}[(A, (Right-edge-of, B)) means A is located on the right side of B on or near the boundary of B.] +** Right-side-of {relatedTag=Left-side-of}[(A, (Right-side-of, B)) means A is located on the right side of B usually as part of B.] +** To-left-of [(A, (To-left-of, B)) means A is located on or directed toward the side to the west of B when B is facing north. This term is used when A is not part of B.] +** To-right-of [(A, (To-right-of, B)) means A is located on or directed toward the side to the east of B when B is facing north. This term is used when A is not part of B.] +** Top-edge-of {relatedTag=Left-edge-of,relatedTag=Right-edge-of,relatedTag=Bottom-edge-of}[(A, (Top-edge-of, B)) means A is on the uppermost part or or near the boundary of B.] +** Top-of [(A, (Top-of, B)) means A is on the uppermost part, side, or surface of B.] +** Upper-center-of {relatedTag=Center-of,relatedTag=Lower-center-of,relatedTag=Lower-left-of,relatedTag=Lower-right-of,relatedTag=Upper-center-of,relatedTag=Upper-right-of}[(A, (Upper-center-of, B)) means A is situated on the upper center part of B (due north). This relation is often used to specify qualitative information about screen position.] +** Upper-left-of {relatedTag=Center-of,relatedTag=Lower-center-of,relatedTag=Lower-left-of,relatedTag=Lower-right-of,relatedTag=Upper-center-of,relatedTag=Upper-right-of}[(A, (Upper-left-of, B)) means A is situated on the upper left part of B. This relation is often used to specify qualitative information about screen position.] +** Upper-right-of {relatedTag=Center-of,relatedTag=Lower-center-of,relatedTag=Lower-left-of,relatedTag=Upper-left-of,relatedTag=Upper-center-of,relatedTag=Lower-right-of}[(A, (Upper-right-of, B)) means A is situated on the upper right part of B. This relation is often used to specify qualitative information about screen position.] +** Underneath [(A, (Underneath, B)) means A is situated directly below and may be concealed by B.] +** Within [(A, (Within, B)) means A is on the inside of or contained in B.] +* Temporal-relation [A relationship that includes a temporal or time-based component.] +** After [(A, (After B)) means A happens at a time subsequent to a reference time related to B.] +** Asynchronous-with [(A, (Asynchronous-with, B)) means A happens at times not occurring at the same time or having the same period or phase as B.] +** Before [(A, (Before B)) means A happens at a time earlier in time or order than B.] +** During [(A, (During, B)) means A happens at some point in a given period of time in which B is ongoing.] +** Synchronous-with [(A, (Synchronous-with, B)) means A happens at occurs at the same time or rate as B.] +** Waiting-for [(A, (Waiting-for, B)) means A pauses for something to happen in B.] + +!# end schema + +'''Unit classes''' [Unit classes and the units for the nodes.] +* accelerationUnits {defaultUnits=m-per-s^2} +** m-per-s^2 {SIUnit, unitSymbol, conversionFactor=1.0} +* angleUnits {defaultUnits=radian} +** radian {SIUnit, conversionFactor=1.0} +** rad {SIUnit, unitSymbol, conversionFactor=1.0} +** degree {conversionFactor=0.0174533} +* areaUnits {defaultUnits=m^2} +** m^2 {SIUnit, unitSymbol, conversionFactor=1.0} +* currencyUnits {defaultUnits=$}[Units indicating the worth of something.] +** dollar {conversionFactor=1.0} +** $ {unitPrefix, unitSymbol, conversionFactor=1.0} +** euro +** point +* electricPotentialUnits {defaultUnits=uv} +** v {SIUnit, unitSymbol, conversionFactor=0.000001} +** Volt {SIUnit, conversionFactor=0.000001} +* frequencyUnits {defaultUnits=Hz} +** hertz {SIUnit, conversionFactor=1.0} +** Hz {SIUnit, unitSymbol, conversionFactor=1.0} +* intensityUnits {defaultUnits=dB} +** dB {unitSymbol, conversionFactor=1.0}[Intensity expressed as ratio to a threshold. May be used for sound intensity.] +** candela {SIUnit}[Units used to express light intensity.] +** cd {SIUnit, unitSymbol}[Units used to express light intensity.] +* jerkUnits {defaultUnits=m-per-s^3} +** m-per-s^3 {unitSymbol, conversionFactor=1.0} +* magneticFieldUnits {defaultUnits=fT}[Units used to magnetic field intensity.] +** tesla {SIUnit, conversionFactor=10^-15} +** T {SIUnit, unitSymbol, conversionFactor=10^-15} +* memorySizeUnits {defaultUnits=B} +** byte {SIUnit, conversionFactor=1.0} +** B {SIUnit, unitSymbol, conversionFactor=1.0} +* physicalLengthUnits {defaultUnits=m} +** foot {conversionFactor=0.3048} +** inch {conversionFactor=0.0254} +** meter {SIUnit, conversionFactor=1.0} +** metre {SIUnit, conversionFactor=1.0} +** m {SIUnit, unitSymbol, conversionFactor=1.0} +** mile {conversionFactor=1609.34} +* speedUnits {defaultUnits=m-per-s} +** m-per-s {SIUnit, unitSymbol, conversionFactor=1.0} +** mph {unitSymbol, conversionFactor=0.44704} +** kph {unitSymbol, conversionFactor=0.277778} +* temperatureUnits {defaultUnits=degree Celsius} +** degree Celsius {SIUnit, conversionFactor=1.0} +** oC {SIUnit, unitSymbol, conversionFactor=1.0} +* timeUnits {defaultUnits=s} +** second {SIUnit, conversionFactor=1.0} +** s {SIUnit, unitSymbol, conversionFactor=1.0} +** day {conversionFactor=86400} +** minute {conversionFactor=60} +** hour {conversionFactor=3600}[Should be in 24-hour format.] +* volumeUnits {defaultUnits=m^3} +** m^3 {SIUnit, unitSymbol, conversionFactor=1.0} +* weightUnits {defaultUnits=g} +** g {SIUnit, unitSymbol, conversionFactor=1.0} +** gram {SIUnit, conversionFactor=1.0} +** pound {conversionFactor=453.592} +** lb {conversionFactor=453.592} + + +'''Unit modifiers''' [Unit multiples and submultiples.] +* deca {SIUnitModifier, conversionFactor=10.0} [SI unit multiple representing 10^1.] +* da {SIUnitSymbolModifier, conversionFactor=10.0} [SI unit multiple representing 10^1.] +* hecto {SIUnitModifier, conversionFactor=100.0} [SI unit multiple representing 10^2.] +* h {SIUnitSymbolModifier, conversionFactor=100.0} [SI unit multiple representing 10^2.] +* kilo {SIUnitModifier, conversionFactor=1000.0} [SI unit multiple representing 10^3.] +* k {SIUnitSymbolModifier, conversionFactor=1000.0} [SI unit multiple representing 10^3.] +* mega {SIUnitModifier, conversionFactor=10^6} [SI unit multiple representing 10^6.] +* M {SIUnitSymbolModifier, conversionFactor=10^6} [SI unit multiple representing 10^6.] +* giga {SIUnitModifier, conversionFactor=10^9} [SI unit multiple representing 10^9.] +* G {SIUnitSymbolModifier, conversionFactor=10^9} [SI unit multiple representing 10^9.] +* tera {SIUnitModifier, conversionFactor=10^12} [SI unit multiple representing 10^12.] +* T {SIUnitSymbolModifier, conversionFactor=10^12} [SI unit multiple representing 10^12.] +* peta {SIUnitModifier, conversionFactor=10^15} [SI unit multiple representing 10^15.] +* P {SIUnitSymbolModifier, conversionFactor=10^15} [SI unit multiple representing 10^15.] +* exa {SIUnitModifier, conversionFactor=10^18} [SI unit multiple representing 10^18.] +* E {SIUnitSymbolModifier, conversionFactor=10^18} [SI unit multiple representing 10^18.] +* zetta {SIUnitModifier, conversionFactor=10^21} [SI unit multiple representing 10^21.] +* Z {SIUnitSymbolModifier, conversionFactor=10^21} [SI unit multiple representing 10^21.] +* yotta {SIUnitModifier, conversionFactor=10^24} [SI unit multiple representing 10^24.] +* Y {SIUnitSymbolModifier, conversionFactor=10^24} [SI unit multiple representing 10^24.] +* deci {SIUnitModifier, conversionFactor=0.1}[SI unit submultiple representing 10^-1.] +* d {SIUnitSymbolModifier, conversionFactor=0.1} [SI unit submultiple representing 10^-1.] +* centi {SIUnitModifier, conversionFactor=0.01} [SI unit submultiple representing 10^-2.] +* c {SIUnitSymbolModifier, conversionFactor=0.01} [SI unit submultiple representing 10^-2.] +* milli {SIUnitModifier, conversionFactor=0.001} [SI unit submultiple representing 10^-3.] +* m {SIUnitSymbolModifier, conversionFactor=0.001} [SI unit submultiple representing 10^-3.] +* micro {SIUnitModifier, conversionFactor=10^-6} [SI unit submultiple representing 10^-6.] +* u {SIUnitSymbolModifier, conversionFactor=10^-6} [SI unit submultiple representing 10^-6.] +* nano {SIUnitModifier, conversionFactor=10^-9} [SI unit submultiple representing 10^-9.] +* n {SIUnitSymbolModifier, conversionFactor=10^-9} [SI unit submultiple representing 10^-9.] +* pico {SIUnitModifier, conversionFactor=10^-12} [SI unit submultiple representing 10^-12.] +* p {SIUnitSymbolModifier, conversionFactor=10^-12} [SI unit submultiple representing 10^-12.] +* femto {SIUnitModifier, conversionFactor=10^-15} [SI unit submultiple representing 10^-15.] +* f {SIUnitSymbolModifier, conversionFactor=10^-15} [SI unit submultiple representing 10^-15.] +* atto {SIUnitModifier, conversionFactor=10^-18} [SI unit submultiple representing 10^-18.] +* a {SIUnitSymbolModifier, conversionFactor=10^-18} [SI unit submultiple representing 10^-18.] +* zepto {SIUnitModifier, conversionFactor=10^-21} [SI unit submultiple representing 10^-21.] +* z {SIUnitSymbolModifier, conversionFactor=10^-21} [SI unit submultiple representing 10^-21.] +* yocto {SIUnitModifier, conversionFactor=10^-24} [SI unit submultiple representing 10^-24.] +* y {SIUnitSymbolModifier, conversionFactor=10^-24} [SI unit submultiple representing 10^-24.] + + +'''Value classes''' [Specification of the rules for the values provided by users.] +* dateTimeClass {allowedCharacter=digits,allowedCharacter=T,allowedCharacter=-,allowedCharacter=:}[Date-times should conform to ISO8601 date-time format YYYY-MM-DDThh:mm:ss. Any variation on the full form is allowed.] +* nameClass {allowedCharacter=letters,allowedCharacter=digits,allowedCharacter=_,allowedCharacter=-}[Value class designating values that have the characteristics of node names. The allowed characters are alphanumeric, hyphen, and underbar.] +* numericClass {allowedCharacter=digits,allowedCharacter=E,allowedCharacter=e,allowedCharacter=+,allowedCharacter=-,allowedCharacter=.}[Value must be a valid numerical value.] +* posixPath {allowedCharacter=digits,allowedCharacter=letters,allowedCharacter=/,allowedCharacter=:}[Posix path specification.] +* textClass {allowedCharacter=letters, allowedCharacter=digits, allowedCharacter=blank, allowedCharacter=+, allowedCharacter=-, allowedCharacter=:, allowedCharacter=;, allowedCharacter=., allowedCharacter=/, allowedCharacter=(, allowedCharacter=), allowedCharacter=?, allowedCharacter=*, allowedCharacter=%, allowedCharacter=$, allowedCharacter=@}[Value class designating values that have the characteristics of text such as in descriptions.] + + +'''Schema attributes''' [Allowed attribute modifiers of other sections of the schema.] +* allowedCharacter {valueClassProperty}[A schema attribute of value classes specifying a special character that is allowed in expressing the value of a placeholder. Normally the allowed characters are listed individually. However, the word letters designates the upper and lower case alphabetic characters and the word digits designates the digits 0-9. The word blank designates the blank character.] +* conversionFactor {unitProperty, unitModifierProperty}[The multiplicative factor to multiply these units to convert to default units.] +* deprecatedFrom {elementProperty}[Indicates that this element is deprecated. The value of the attribute is the latest schema version in which the element appeared in undeprecated form.] +* defaultUnits {unitClassProperty}[A schema attribute of unit classes specifying the default units to use if the placeholder has a unit class but the substituted value has no units.] +* extensionAllowed {boolProperty, nodeProperty, isInheritedProperty}[A schema attribute indicating that users can add unlimited levels of child nodes under this tag. This tag is propagated to child nodes with the exception of the hashtag placeholders.] +* inLibrary {elementProperty} [Indicates this schema element came from the named library schema, not the standard schema. This attribute is added by tools when a library schema is merged into its partnered standard schema.] +* recommended {boolProperty, nodeProperty}[A schema attribute indicating that the event-level HED string should include this tag.] +* relatedTag {nodeProperty, isInheritedProperty}[A schema attribute suggesting HED tags that are closely related to this tag. This attribute is used by tagging tools.] +* requireChild {boolProperty, nodeProperty}[A schema attribute indicating that one of the node elements descendants must be included when using this tag.] +* required {boolProperty, nodeProperty}[A schema attribute indicating that every event-level HED string should include this tag.] +* reserved {boolProperty, nodeProperty}[A schema attribute indicating that this tag has special meaning and requires special handling by tools.] +* rooted {nodeProperty}[Indicates a top-level library schema node is identical to a node of the same name in the partnered standard schema. This attribute can only appear in nodes that have the inLibrary schema attribute.] +* SIUnit {boolProperty, unitProperty}[A schema attribute indicating that this unit element is an SI unit and can be modified by multiple and submultiple names. Note that some units such as byte are designated as SI units although they are not part of the standard.] +* SIUnitModifier {boolProperty, unitModifierProperty}[A schema attribute indicating that this SI unit modifier represents a multiple or submultiple of a base unit rather than a unit symbol.] +* SIUnitSymbolModifier {boolProperty, unitModifierProperty}[A schema attribute indicating that this SI unit modifier represents a multiple or submultiple of a unit symbol rather than a base symbol.] +* suggestedTag {nodeProperty, isInheritedProperty}[A schema attribute that indicates another tag that is often associated with this tag. This attribute is used by tagging tools to provide tagging suggestions.] +* tagGroup {boolProperty, nodeProperty}[A schema attribute indicating the tag can only appear inside a tag group.] +* takesValue {boolProperty, nodeProperty}[A schema attribute indicating the tag is a hashtag placeholder that is expected to be replaced with a user-defined value.] +* topLevelTagGroup {boolProperty, nodeProperty}[A schema attribute indicating that this tag (or its descendants) can only appear in a top-level tag group. A tag group can have at most one tag with this attribute.] +* unique {boolProperty, nodeProperty}[A schema attribute indicating that only one of this tag or its descendants can be used in the event-level HED string.] +* unitClass {nodeProperty}[A schema attribute specifying which unit class this value tag belongs to.] +* unitPrefix {boolProperty, unitProperty}[A schema attribute applied specifically to unit elements to designate that the unit indicator is a prefix (e.g., dollar sign in the currency units).] +* unitSymbol {boolProperty, unitProperty}[A schema attribute indicating this tag is an abbreviation or symbol representing a type of unit. Unit symbols represent both the singular and the plural and thus cannot be pluralized.] +* valueClass {nodeProperty}[A schema attribute specifying which value class this value tag belongs to.] + +'''Properties''' [Properties of the schema attributes themselves. These are used for schema handling and verification.] +* boolProperty [Indicates that the schema attribute represents something that is either true or false and does not have a value. Attributes without this value are assumed to have string values.] +* elementProperty [Indicates this schema attribute can apply to any type of element(tag term, unit class, etc).] +* isInheritedProperty [Indicates that this attribute is inherited by child nodes. This property only applies to schema attributes for nodes.] +* nodeProperty [Indicates this schema attribute applies to node (tag-term) elements. This was added to allow for an attribute to apply to multiple elements.] +* unitClassProperty [Indicates that the schema attribute is meant to be applied to unit classes.] +* unitModifierProperty [Indicates that the schema attribute is meant to be applied to unit modifier classes.] +* unitProperty [Indicates that the schema attribute is meant to be applied to units within a unit class.] +* valueClassProperty [Indicates that the schema attribute is meant to be applied to value classes.] + +'''Epilogue''' +This schema is released under the Creative Commons Attribution 4.0 International and is a product of the HED Working Group. The DOI for the latest version of the HED standard schema is 10.5281/zenodo.7876037. +!# end hed \ No newline at end of file diff --git a/hedxml/HED8.2.0.xml b/hedxml/HED8.2.0.xml new file mode 100644 index 0000000..1f55c7a --- /dev/null +++ b/hedxml/HED8.2.0.xml @@ -0,0 +1,7296 @@ + + + The HED standard schema is a hierarchically-organized vocabulary for annotating events and experimental structure. HED annotations consist of comma-separated tags drawn from this vocabulary. This vocabulary can be augmented by terms drawn from specialized library schema. + +Each term in this vocabulary has a human-readable description and may include additional attributes that give additional properties or that specify how tools should treat the tag during analysis. The meaning of these attributes is described in the Additional schema properties section. + + + + + Event + Something that happens at a given time and (typically) place. Elements of this tag subtree designate the general category in which an event falls. + + suggestedTag + Task-property + + + Sensory-event + Something perceivable by the participant. An event meant to be an experimental stimulus should include the tag Task-property/Task-event-role/Experimental-stimulus. + + suggestedTag + Task-event-role + Sensory-presentation + + + + Agent-action + Any action engaged in by an agent (see the Agent subtree for agent categories). A participant response to an experiment stimulus should include the tag Agent-property/Agent-task-role/Experiment-participant. + + suggestedTag + Task-event-role + Agent + + + + Data-feature + An event marking the occurrence of a data feature such as an interictal spike or alpha burst that is often added post hoc to the data record. + + suggestedTag + Data-property + + + + Experiment-control + An event pertaining to the physical control of the experiment during its operation. + + + Experiment-procedure + An event indicating an experimental procedure, as in performing a saliva swab during the experiment or administering a survey. + + + Experiment-structure + An event specifying a change-point of the structure of experiment. This event is typically used to indicate a change in experimental conditions or tasks. + + + Measurement-event + A discrete measure returned by an instrument. + + suggestedTag + Data-property + + + + + Agent + Someone or something that takes an active role or produces a specified effect.The role or effect may be implicit. Being alive or performing an activity such as a computation may qualify something to be an agent. An agent may also be something that simulates something else. + + suggestedTag + Agent-property + + + Animal-agent + An agent that is an animal. + + + Avatar-agent + An agent associated with an icon or avatar representing another agent. + + + Controller-agent + An agent experiment control software or hardware. + + + Human-agent + A person who takes an active role or produces a specified effect. + + + Robotic-agent + An agent mechanical device capable of performing a variety of often complex tasks on command or by being programmed in advance. + + + Software-agent + An agent computer program. + + + + Action + Do something. + + extensionAllowed + + + Communicate + Convey knowledge of or information about something. + + Communicate-gesturally + Communicate nonverbally using visible bodily actions, either in place of speech or together and in parallel with spoken words. Gestures include movement of the hands, face, or other parts of the body. + + relatedTag + Move-face + Move-upper-extremity + + + Clap-hands + Strike the palms of against one another resoundingly, and usually repeatedly, especially to express approval. + + + Clear-throat + Cough slightly so as to speak more clearly, attract attention, or to express hesitancy before saying something awkward. + + relatedTag + Move-face + Move-head + + + + Frown + Express disapproval, displeasure, or concentration, typically by turning down the corners of the mouth. + + relatedTag + Move-face + + + + Grimace + Make a twisted expression, typically expressing disgust, pain, or wry amusement. + + relatedTag + Move-face + + + + Nod-head + Tilt head in alternating up and down arcs along the sagittal plane. It is most commonly, but not universally, used to indicate agreement, acceptance, or acknowledgement. + + relatedTag + Move-head + + + + Pump-fist + Raise with fist clenched in triumph or affirmation. + + relatedTag + Move-upper-extremity + + + + Raise-eyebrows + Move eyebrows upward. + + relatedTag + Move-face + Move-eyes + + + + Shake-fist + Clench hand into a fist and shake to demonstrate anger. + + relatedTag + Move-upper-extremity + + + + Shake-head + Turn head from side to side as a way of showing disagreement or refusal. + + relatedTag + Move-head + + + + Shhh + Place finger over lips and possibly uttering the syllable shhh to indicate the need to be quiet. + + relatedTag + Move-upper-extremity + + + + Shrug + Lift shoulders up towards head to indicate a lack of knowledge about a particular topic. + + relatedTag + Move-upper-extremity + Move-torso + + + + Smile + Form facial features into a pleased, kind, or amused expression, typically with the corners of the mouth turned up and the front teeth exposed. + + relatedTag + Move-face + + + + Spread-hands + Spread hands apart to indicate ignorance. + + relatedTag + Move-upper-extremity + + + + Thumbs-down + Extend the thumb downward to indicate disapproval. + + relatedTag + Move-upper-extremity + + + + Thumb-up + Extend the thumb upward to indicate approval. + + relatedTag + Move-upper-extremity + + + + Wave + Raise hand and move left and right, as a greeting or sign of departure. + + relatedTag + Move-upper-extremity + + + + Widen-eyes + Open eyes and possibly with eyebrows lifted especially to express surprise or fear. + + relatedTag + Move-face + Move-eyes + + + + Wink + Close and open one eye quickly, typically to indicate that something is a joke or a secret or as a signal of affection or greeting. + + relatedTag + Move-face + Move-eyes + + + + + Communicate-musically + Communicate using music. + + Hum + Make a low, steady continuous sound like that of a bee. Sing with the lips closed and without uttering speech. + + + Play-instrument + Make musical sounds using an instrument. + + + Sing + Produce musical tones by means of the voice. + + + Vocalize + Utter vocal sounds. + + + Whistle + Produce a shrill clear sound by forcing breath out or air in through the puckered lips. + + + + Communicate-vocally + Communicate using mouth or vocal cords. + + Cry + Shed tears associated with emotions, usually sadness but also joy or frustration. + + + Groan + Make a deep inarticulate sound in response to pain or despair. + + + Laugh + Make the spontaneous sounds and movements of the face and body that are the instinctive expressions of lively amusement and sometimes also of contempt or derision. + + + Scream + Make loud, vociferous cries or yells to express pain, excitement, or fear. + + + Shout + Say something very loudly. + + + Sigh + Emit a long, deep, audible breath expressing sadness, relief, tiredness, or a similar feeling. + + + Speak + Communicate using spoken language. + + + Whisper + Speak very softly using breath without vocal cords. + + + + + Move + Move in a specified direction or manner. Change position or posture. + + Breathe + Inhale or exhale during respiration. + + Blow + Expel air through pursed lips. + + + Cough + Suddenly and audibly expel air from the lungs through a partially closed glottis, preceded by inhalation. + + + Exhale + Blow out or expel breath. + + + Hiccup + Involuntarily spasm the diaphragm and respiratory organs, with a sudden closure of the glottis and a characteristic sound like that of a cough. + + + Hold-breath + Interrupt normal breathing by ceasing to inhale or exhale. + + + Inhale + Draw in with the breath through the nose or mouth. + + + Sneeze + Suddenly and violently expel breath through the nose and mouth. + + + Sniff + Draw in air audibly through the nose to detect a smell, to stop it from running, or to express contempt. + + + + Move-body + Move entire body. + + Bend + Move body in a bowed or curved manner. + + + Dance + Perform a purposefully selected sequences of human movement often with aesthetic or symbolic value. Move rhythmically to music, typically following a set sequence of steps. + + + Fall-down + Lose balance and collapse. + + + Flex + Cause a muscle to stand out by contracting or tensing it. Bend a limb or joint. + + + Jerk + Make a quick, sharp, sudden movement. + + + Lie-down + Move to a horizontal or resting position. + + + Recover-balance + Return to a stable, upright body position. + + + Sit-down + Move from a standing to a sitting position. + + + Sit-up + Move from lying down to a sitting position. + + + Stand-up + Move from a sitting to a standing position. + + + Stretch + Straighten or extend body or a part of body to its full length, typically so as to tighten muscles or in order to reach something. + + + Shudder + Tremble convulsively, sometimes as a result of fear or revulsion. + + + Stumble + Trip or momentarily lose balance and almost fall. + + + Turn + Change or cause to change direction. + + + + Move-body-part + Move one part of a body. + + Move-eyes + Move eyes. + + Blink + Shut and open the eyes quickly. + + + Close-eyes + Lower and keep eyelids in a closed position. + + + Fixate + Direct eyes to a specific point or target. + + + Inhibit-blinks + Purposely prevent blinking. + + + Open-eyes + Raise eyelids to expose pupil. + + + Saccade + Move eyes rapidly between fixation points. + + + Squint + Squeeze one or both eyes partly closed in an attempt to see more clearly or as a reaction to strong light. + + + Stare + Look fixedly or vacantly at someone or something with eyes wide open. + + + + Move-face + Move the face or jaw. + + Bite + Seize with teeth or jaws an object or organism so as to grip or break the surface covering. + + + Burp + Noisily release air from the stomach through the mouth. Belch. + + + Chew + Repeatedly grinding, tearing, and or crushing with teeth or jaws. + + + Gurgle + Make a hollow bubbling sound like that made by water running out of a bottle. + + + Swallow + Cause or allow something, especially food or drink to pass down the throat. + + Gulp + Swallow quickly or in large mouthfuls, often audibly, sometimes to indicate apprehension. + + + + Yawn + Take a deep involuntary inhalation with the mouth open often as a sign of drowsiness or boredom. + + + + Move-head + Move head. + + Lift-head + Tilt head back lifting chin. + + + Lower-head + Move head downward so that eyes are in a lower position. + + + Turn-head + Rotate head horizontally to look in a different direction. + + + + Move-lower-extremity + Move leg and/or foot. + + Curl-toes + Bend toes sometimes to grip. + + + Hop + Jump on one foot. + + + Jog + Run at a trot to exercise. + + + Jump + Move off the ground or other surface through sudden muscular effort in the legs. + + + Kick + Strike out or flail with the foot or feet. Strike using the leg, in unison usually with an area of the knee or lower using the foot. + + + Pedal + Move by working the pedals of a bicycle or other machine. + + + Press-foot + Move by pressing foot. + + + Run + Travel on foot at a fast pace. + + + Step + Put one leg in front of the other and shift weight onto it. + + Heel-strike + Strike the ground with the heel during a step. + + + Toe-off + Push with toe as part of a stride. + + + + Trot + Run at a moderate pace, typically with short steps. + + + Walk + Move at a regular pace by lifting and setting down each foot in turn never having both feet off the ground at once. + + + + Move-torso + Move body trunk. + + + Move-upper-extremity + Move arm, shoulder, and/or hand. + + Drop + Let or cause to fall vertically. + + + Grab + Seize suddenly or quickly. Snatch or clutch. + + + Grasp + Seize and hold firmly. + + + Hold-down + Prevent someone or something from moving by holding them firmly. + + + Lift + Raising something to higher position. + + + Make-fist + Close hand tightly with the fingers bent against the palm. + + + Point + Draw attention to something by extending a finger or arm. + + + Press + Apply pressure to something to flatten, shape, smooth or depress it. This action tag should be used to indicate key presses and mouse clicks. + + relatedTag + Push + + + + Push + Apply force in order to move something away. Use Press to indicate a key press or mouse click. + + relatedTag + Press + + + + Reach + Stretch out your arm in order to get or touch something. + + + Release + Make available or set free. + + + Retract + Draw or pull back. + + + Scratch + Drag claws or nails over a surface or on skin. + + + Snap-fingers + Make a noise by pushing second finger hard against thumb and then releasing it suddenly so that it hits the base of the thumb. + + + Touch + Come into or be in contact with. + + + + + + Perceive + Produce an internal, conscious image through stimulating a sensory system. + + Hear + Give attention to a sound. + + + See + Direct gaze toward someone or something or in a specified direction. + + + Smell + Inhale in order to ascertain an odor or scent. + + + Taste + Sense a flavor in the mouth and throat on contact with a substance. + + + Sense-by-touch + Sense something through receptors in the skin. + + + + Perform + Carry out or accomplish an action, task, or function. + + Close + Act as to blocked against entry or passage. + + + Collide-with + Hit with force when moving. + + + Halt + Bring or come to an abrupt stop. + + + Modify + Change something. + + + Open + Widen an aperture, door, or gap, especially one allowing access to something. + + + Operate + Control the functioning of a machine, process, or system. + + + Play + Engage in activity for enjoyment and recreation rather than a serious or practical purpose. + + + Read + Interpret something that is written or printed. + + + Repeat + Make do or perform again. + + + Rest + Be inactive in order to regain strength, health, or energy. + + + Write + Communicate or express by means of letters or symbols written or imprinted on a surface. + + + + Think + Direct the mind toward someone or something or use the mind actively to form connected ideas. + + Allow + Allow access to something such as allowing a car to pass. + + + Attend-to + Focus mental experience on specific targets. + + + Count + Tally items either silently or aloud. + + + Deny + Refuse to give or grant something requested or desired by someone. + + + Detect + Discover or identify the presence or existence of something. + + + Discriminate + Recognize a distinction. + + + Encode + Convert information or an instruction into a particular form. + + + Evade + Escape or avoid, especially by cleverness or trickery. + + + Generate + Cause something, especially an emotion or situation to arise or come about. + + + Identify + Establish or indicate who or what someone or something is. + + + Imagine + Form a mental image or concept of something. + + + Judge + Evaluate evidence to make a decision or form a belief. + + + Learn + Adaptively change behavior as the result of experience. + + + Memorize + Adaptively change behavior as the result of experience. + + + Plan + Think about the activities required to achieve a desired goal. + + + Predict + Say or estimate that something will happen or will be a consequence of something without having exact informaton. + + + Recognize + Identify someone or something from having encountered them before. + + + Respond + React to something such as a treatment or a stimulus. + + + Recall + Remember information by mental effort. + + + Switch-attention + Transfer attention from one focus to another. + + + Track + Follow a person, animal, or object through space or time. + + + + + Item + An independently existing thing (living or nonliving). + + extensionAllowed + + + Biological-item + An entity that is biological, that is related to living organisms. + + Anatomical-item + A biological structure, system, fluid or other substance excluding single molecular entities. + + Body + The biological structure representing an organism. + + + Body-part + Any part of an organism. + + Head + The upper part of the human body, or the front or upper part of the body of an animal, typically separated from the rest of the body by a neck, and containing the brain, mouth, and sense organs. + + Hair + The filamentous outgrowth of the epidermis. + + + Ear + A sense organ needed for the detection of sound and for establishing balance. + + + Face + The anterior portion of the head extending from the forehead to the chin and ear to ear. The facial structures contain the eyes, nose and mouth, cheeks and jaws. + + Cheek + The fleshy part of the face bounded by the eyes, nose, ear, and jaw line. + + + Chin + The part of the face below the lower lip and including the protruding part of the lower jaw. + + + Eye + The organ of sight or vision. + + + Eyebrow + The arched strip of hair on the bony ridge above each eye socket. + + + Forehead + The part of the face between the eyebrows and the normal hairline. + + + Lip + Fleshy fold which surrounds the opening of the mouth. + + + Nose + A structure of special sense serving as an organ of the sense of smell and as an entrance to the respiratory tract. + + + Mouth + The proximal portion of the digestive tract, containing the oral cavity and bounded by the oral opening. + + + Teeth + The hard bonelike structures in the jaws. A collection of teeth arranged in some pattern in the mouth or other part of the body. + + + + + Lower-extremity + Refers to the whole inferior limb (leg and/or foot). + + Ankle + A gliding joint between the distal ends of the tibia and fibula and the proximal end of the talus. + + + Calf + The fleshy part at the back of the leg below the knee. + + + Foot + The structure found below the ankle joint required for locomotion. + + Big-toe + The largest toe on the inner side of the foot. + + + Heel + The back of the foot below the ankle. + + + Instep + The part of the foot between the ball and the heel on the inner side. + + + Little-toe + The smallest toe located on the outer side of the foot. + + + Toes + The terminal digits of the foot. + + + + Knee + A joint connecting the lower part of the femur with the upper part of the tibia. + + + Shin + Front part of the leg below the knee. + + + Thigh + Upper part of the leg between hip and knee. + + + + Torso + The body excluding the head and neck and limbs. + + Torso-back + The rear surface of the human body from the shoulders to the hips. + + + Buttocks + The round fleshy parts that form the lower rear area of a human trunk. + + + Torso-chest + The anterior side of the thorax from the neck to the abdomen. + + + Gentalia + The external organs of reproduction. + + deprecatedFrom + 8.1.0 + + + + Hip + The lateral prominence of the pelvis from the waist to the thigh. + + + Waist + The abdominal circumference at the navel. + + + + Upper-extremity + Refers to the whole superior limb (shoulder, arm, elbow, wrist, hand). + + Elbow + A type of hinge joint located between the forearm and upper arm. + + + Forearm + Lower part of the arm between the elbow and wrist. + + + Hand + The distal portion of the upper extremity. It consists of the carpus, metacarpus, and digits. + + Finger + Any of the digits of the hand. + + Index-finger + The second finger from the radial side of the hand, next to the thumb. + + + Little-finger + The fifth and smallest finger from the radial side of the hand. + + + Middle-finger + The middle or third finger from the radial side of the hand. + + + Ring-finger + The fourth finger from the radial side of the hand. + + + Thumb + The thick and short hand digit which is next to the index finger in humans. + + + + Palm + The part of the inner surface of the hand that extends from the wrist to the bases of the fingers. + + + Knuckles + A part of a finger at a joint where the bone is near the surface, especially where the finger joins the hand. + + + + Shoulder + Joint attaching upper arm to trunk. + + + Upper-arm + Portion of arm between shoulder and elbow. + + + Wrist + A joint between the distal end of the radius and the proximal row of carpal bones. + + + + + + Organism + A living entity, more specifically a biological entity that consists of one or more cells and is capable of genomic replication (independently or not). + + Animal + A living organism that has membranous cell walls, requires oxygen and organic foods, and is capable of voluntary movement. + + + Human + The bipedal primate mammal Homo sapiens. + + + Plant + Any living organism that typically synthesizes its food from inorganic substances and possesses cellulose cell walls. + + + + + Language-item + An entity related to a systematic means of communicating by the use of sounds, symbols, or gestures. + + suggestedTag + Sensory-presentation + + + Character + A mark or symbol used in writing. + + + Clause + A unit of grammatical organization next below the sentence in rank, usually consisting of a subject and predicate. + + + Glyph + A hieroglyphic character, symbol, or pictograph. + + + Nonword + A group of letters or speech sounds that looks or sounds like a word but that is not accepted as such by native speakers. + + + Paragraph + A distinct section of a piece of writing, usually dealing with a single theme. + + + Phoneme + A speech sound that is distinguished by the speakers of a particular language. + + + Phrase + A phrase is a group of words functioning as a single unit in the syntax of a sentence. + + + Sentence + A set of words that is complete in itself, conveying a statement, question, exclamation, or command and typically containing an explicit or implied subject and a predicate containing a finite verb. + + + Syllable + A unit of spoken language larger than a phoneme. + + + Textblock + A block of text. + + + Word + A word is the smallest free form (an item that may be expressed in isolation with semantic or pragmatic content) in a language. + + + + Object + Something perceptible by one or more of the senses, especially by vision or touch. A material thing. + + suggestedTag + Sensory-presentation + + + Geometric-object + An object or a representation that has structure and topology in space. + + Pattern + An arrangement of objects, facts, behaviors, or other things which have scientific, mathematical, geometric, statistical, or other meaning. + + Dots + A small round mark or spot. + + + LED-pattern + A pattern created by lighting selected members of a fixed light emitting diode array. + + + + 2D-shape + A planar, two-dimensional shape. + + Arrow + A shape with a pointed end indicating direction. + + + Clockface + The dial face of a clock. A location identifier based on clockface numbering or anatomic subregion. + + + Cross + A figure or mark formed by two intersecting lines crossing at their midpoints. + + + Dash + A horizontal stroke in writing or printing to mark a pause or break in sense or to represent omitted letters or words. + + + Ellipse + A closed plane curve resulting from the intersection of a circular cone and a plane cutting completely through it, especially a plane not parallel to the base. + + Circle + A ring-shaped structure with every point equidistant from the center. + + + + Rectangle + A parallelogram with four right angles. + + Square + A square is a special rectangle with four equal sides. + + + + Single-point + A point is a geometric entity that is located in a zero-dimensional spatial region and whose position is defined by its coordinates in some coordinate system. + + + Star + A conventional or stylized representation of a star, typically one having five or more points. + + + Triangle + A three-sided polygon. + + + + 3D-shape + A geometric three-dimensional shape. + + Box + A square or rectangular vessel, usually made of cardboard or plastic. + + Cube + A solid or semi-solid in the shape of a three dimensional square. + + + + Cone + A shape whose base is a circle and whose sides taper up to a point. + + + Cylinder + A surface formed by circles of a given radius that are contained in a plane perpendicular to a given axis, whose centers align on the axis. + + + Ellipsoid + A closed plane curve resulting from the intersection of a circular cone and a plane cutting completely through it, especially a plane not parallel to the base. + + Sphere + A solid or hollow three-dimensional object bounded by a closed surface such that every point on the surface is equidistant from the center. + + + + Pyramid + A polyhedron of which one face is a polygon of any number of sides, and the other faces are triangles with a common vertex. + + + + + Ingestible-object + Something that can be taken into the body by the mouth for digestion or absorption. + + + Man-made-object + Something constructed by human means. + + Building + A structure that has a roof and walls and stands more or less permanently in one place. + + Room + An area within a building enclosed by walls and floor and ceiling. + + + Roof + A roof is the covering on the uppermost part of a building which provides protection from animals and weather, notably rain, but also heat, wind and sunlight. + + + Entrance + The means or place of entry. + + + Attic + A room or a space immediately below the roof of a building. + + + Basement + The part of a building that is wholly or partly below ground level. + + + + Clothing + A covering designed to be worn on the body. + + + Device + An object contrived for a specific purpose. + + Assistive-device + A device that help an individual accomplish a task. + + Glasses + Frames with lenses worn in front of the eye for vision correction, eye protection, or protection from UV rays. + + + Writing-device + A device used for writing. + + Pen + A common writing instrument used to apply ink to a surface for writing or drawing. + + + Pencil + An implement for writing or drawing that is constructed of a narrow solid pigment core in a protective casing that prevents the core from being broken or marking the hand. + + + + + Computing-device + An electronic device which take inputs and processes results from the inputs. + + Cellphone + A telephone with access to a cellular radio system so it can be used over a wide area, without a physical connection to a network. + + + Desktop-computer + A computer suitable for use at an ordinary desk. + + + Laptop-computer + A computer that is portable and suitable for use while traveling. + + + Tablet-computer + A small portable computer that accepts input directly on to its screen rather than via a keyboard or mouse. + + + + Engine + A motor is a machine designed to convert one or more forms of energy into mechanical energy. + + + IO-device + Hardware used by a human (or other system) to communicate with a computer. + + Input-device + A piece of equipment used to provide data and control signals to an information processing system such as a computer or information appliance. + + Computer-mouse + A hand-held pointing device that detects two-dimensional motion relative to a surface. + + Mouse-button + An electric switch on a computer mouse which can be pressed or clicked to select or interact with an element of a graphical user interface. + + + Scroll-wheel + A scroll wheel or mouse wheel is a wheel used for scrolling made of hard plastic with a rubbery surface usually located between the left and right mouse buttons and is positioned perpendicular to the mouse surface. + + + + Joystick + A control device that uses a movable handle to create two-axis input for a computer device. + + + Keyboard + A device consisting of mechanical keys that are pressed to create input to a computer. + + Keyboard-key + A button on a keyboard usually representing letters, numbers, functions, or symbols. + + # + Value of a keyboard key. + + takesValue + + + + + + Keypad + A device consisting of keys, usually in a block arrangement, that provides limited input to a system. + + Keypad-key + A key on a separate section of a computer keyboard that groups together numeric keys and those for mathematical or other special functions in an arrangement like that of a calculator. + + # + Value of keypad key. + + takesValue + + + + + + Microphone + A device designed to convert sound to an electrical signal. + + + Push-button + A switch designed to be operated by pressing a button. + + + + Output-device + Any piece of computer hardware equipment which converts information into human understandable form. + + Display-device + An output device for presentation of information in visual or tactile form the latter used for example in tactile electronic displays for blind people. + + Head-mounted-display + An instrument that functions as a display device, worn on the head or as part of a helmet, that has a small display optic in front of one (monocular HMD) or each eye (binocular HMD). + + + LED-display + A LED display is a flat panel display that uses an array of light-emitting diodes as pixels for a video display. + + + Computer-screen + An electronic device designed as a display or a physical device designed to be a protective meshwork. + + Screen-window + A part of a computer screen that contains a display different from the rest of the screen. A window is a graphical control element consisting of a visual area containing some of the graphical user interface of the program it belongs to and is framed by a window decoration. + + + + + Auditory-device + A device designed to produce sound. + + Headphones + An instrument that consists of a pair of small loudspeakers, or less commonly a single speaker, held close to ears and connected to a signal source such as an audio amplifier, radio, CD player or portable media player. + + + Loudspeaker + A device designed to convert electrical signals to sounds that can be heard. + + + + + Recording-device + A device that copies information in a signal into a persistent information bearer. + + EEG-recorder + A device for recording electric currents in the brain using electrodes applied to the scalp, to the surface of the brain, or placed within the substance of the brain. + + + File-storage + A device for recording digital information to a permanent media. + + + MEG-recorder + A device for measuring the magnetic fields produced by electrical activity in the brain, usually conducted externally. + + + Motion-capture + A device for recording the movement of objects or people. + + + Tape-recorder + A device for recording and reproduction usually using magnetic tape for storage that can be saved and played back. + + + + Touchscreen + A control component that operates an electronic device by pressing the display on the screen. + + + + Machine + A human-made device that uses power to apply forces and control movement to perform an action. + + + Measurement-device + A device in which a measure function inheres. + + Clock + A device designed to indicate the time of day or to measure the time duration of an event or action. + + Clock-face + A location identifier based on clockface numbering or anatomic subregion. + + + + + Robot + A mechanical device that sometimes resembles a living animal and is capable of performing a variety of often complex human tasks on command or by being programmed in advance. + + + Tool + A component that is not part of a device but is designed to support its assemby or operation. + + + + Document + A physical object, or electronic counterpart, that is characterized by containing writing which is meant to be human-readable. + + Letter + A written message addressed to a person or organization. + + + Note + A brief written record. + + + Book + A volume made up of pages fastened along one edge and enclosed between protective covers. + + + Notebook + A book for notes or memoranda. + + + Questionnaire + A document consisting of questions and possibly responses, depending on whether it has been filled out. + + + + Furnishing + Furniture, fittings, and other decorative accessories, such as curtains and carpets, for a house or room. + + + Manufactured-material + Substances created or extracted from raw materials. + + Ceramic + A hard, brittle, heat-resistant and corrosion-resistant material made by shaping and then firing a nonmetallic mineral, such as clay, at a high temperature. + + + Glass + A brittle transparent solid with irregular atomic structure. + + + Paper + A thin sheet material produced by mechanically or chemically processing cellulose fibres derived from wood, rags, grasses or other vegetable sources in water. + + + Plastic + Various high-molecular-weight thermoplastic or thermosetting polymers that are capable of being molded, extruded, drawn, or otherwise shaped and then hardened into a form. + + + Steel + An alloy made up of iron with typically a few tenths of a percent of carbon to improve its strength and fracture resistance compared to iron. + + + + Media + Media are audo/visual/audiovisual modes of communicating information for mass consumption. + + Media-clip + A short segment of media. + + Audio-clip + A short segment of audio. + + + Audiovisual-clip + A short media segment containing both audio and video. + + + Video-clip + A short segment of video. + + + + Visualization + An planned process that creates images, diagrams or animations from the input data. + + Animation + A form of graphical illustration that changes with time to give a sense of motion or represent dynamic changes in the portrayal. + + + Art-installation + A large-scale, mixed-media constructions, often designed for a specific place or for a temporary period of time. + + + Braille + A display using a system of raised dots that can be read with the fingers by people who are blind. + + + Image + Any record of an imaging event whether physical or electronic. + + Cartoon + A type of illustration, sometimes animated, typically in a non-realistic or semi-realistic style. The specific meaning has evolved over time, but the modern usage usually refers to either an image or series of images intended for satire, caricature, or humor. A motion picture that relies on a sequence of illustrations for its animation. + + + Drawing + A representation of an object or outlining a figure, plan, or sketch by means of lines. + + + Icon + A sign (such as a word or graphic symbol) whose form suggests its meaning. + + + Painting + A work produced through the art of painting. + + + Photograph + An image recorded by a camera. + + + + Movie + A sequence of images displayed in succession giving the illusion of continuous movement. + + + Outline-visualization + A visualization consisting of a line or set of lines enclosing or indicating the shape of an object in a sketch or diagram. + + + Point-light-visualization + A display in which action is depicted using a few points of light, often generated from discrete sensors in motion capture. + + + Sculpture + A two- or three-dimensional representative or abstract forms, especially by carving stone or wood or by casting metal or plaster. + + + Stick-figure-visualization + A drawing showing the head of a human being or animal as a circle and all other parts as straight lines. + + + + + Navigational-object + An object whose purpose is to assist directed movement from one location to another. + + Path + A trodden way. A way or track laid down for walking or made by continual treading. + + + Road + An open way for the passage of vehicles, persons, or animals on land. + + Lane + A defined path with physical dimensions through which an object or substance may traverse. + + + + Runway + A paved strip of ground on a landing field for the landing and takeoff of aircraft. + + + + Vehicle + A mobile machine which transports people or cargo. + + Aircraft + A vehicle which is able to travel through air in an atmosphere. + + + Bicycle + A human-powered, pedal-driven, single-track vehicle, having two wheels attached to a frame, one behind the other. + + + Boat + A watercraft of any size which is able to float or plane on water. + + + Car + A wheeled motor vehicle used primarily for the transportation of human passengers. + + + Cart + A cart is a vehicle which has two wheels and is designed to transport human passengers or cargo. + + + Tractor + A mobile machine specifically designed to deliver a high tractive effort at slow speeds, and mainly used for the purposes of hauling a trailer or machinery used in agriculture or construction. + + + Train + A connected line of railroad cars with or without a locomotive. + + + Truck + A motor vehicle which, as its primary funcion, transports cargo rather than human passangers. + + + + + Natural-object + Something that exists in or is produced by nature, and is not artificial or man-made. + + Mineral + A solid, homogeneous, inorganic substance occurring in nature and having a definite chemical composition. + + + Natural-feature + A feature that occurs in nature. A prominent or identifiable aspect, region, or site of interest. + + Field + An unbroken expanse as of ice or grassland. + + + Hill + A rounded elevation of limited extent rising above the surrounding land with local relief of less than 300m. + + + Mountain + A landform that extends above the surrounding terrain in a limited area. + + + River + A natural freshwater surface stream of considerable volume and a permanent or seasonal flow, moving in a definite channel toward a sea, lake, or another river. + + + Waterfall + A sudden descent of water over a step or ledge in the bed of a river. + + + + + + Sound + Mechanical vibrations transmitted by an elastic medium. Something that can be heard. + + Environmental-sound + Sounds occuring in the environment. An accumulation of noise pollution that occurs outside. This noise can be caused by transport, industrial, and recreational activities. + + Crowd-sound + Noise produced by a mixture of sounds from a large group of people. + + + Signal-noise + Any part of a signal that is not the true or original signal but is introduced by the communication mechanism. + + + + Musical-sound + Sound produced by continuous and regular vibrations, as opposed to noise. + + Tone + A musical note, warble, or other sound used as a particular signal on a telephone or answering machine. + + + Instrument-sound + Sound produced by a musical instrument. + + + Vocalized-sound + Musical sound produced by vocal cords in a biological agent. + + + + Named-animal-sound + A sound recognizable as being associated with particular animals. + + Barking + Sharp explosive cries like sounds made by certain animals, especially a dog, fox, or seal. + + + Bleating + Wavering cries like sounds made by a sheep, goat, or calf. + + + Crowing + Loud shrill sounds characteristic of roosters. + + + Chirping + Short, sharp, high-pitched noises like sounds made by small birds or an insects. + + + Growling + Low guttural sounds like those that made in the throat by a hostile dog or other animal. + + + Meowing + Vocalizations like those made by as those cats. These sounds have diverse tones and are sometimes chattered, murmured or whispered. The purpose can be assertive. + + + Mooing + Deep vocal sounds like those made by a cow. + + + Purring + Low continuous vibratory sound such as those made by cats. The sound expresses contentment. + + + Roaring + Loud, deep, or harsh prolonged sounds such as those made by big cats and bears for long-distance communication and intimidation. + + + Squawking + Loud, harsh noises such as those made by geese. + + + + Named-object-sound + A sound identifiable as coming from a particular type of object. + + Alarm-sound + A loud signal often loud continuous ringing to alert people to a problem or condition that requires urgent attention. + + + Beep + A short, single tone, that is typically high-pitched and generally made by a computer or other machine. + + + Buzz + A persistent vibratory sound often made by a buzzer device and used to indicate something incorrect. + + + Ka-ching + The sound made by a mechanical cash register, often to designate a reward. + + + Click + The sound made by a mechanical cash register, often to designate a reward. + + + Ding + A short ringing sound such as that made by a bell, often to indicate a correct response or the expiration of time. + + + Horn-blow + A loud sound made by forcing air through a sound device that funnels air to create the sound, often used to sound an alert. + + + Siren + A loud, continuous sound often varying in frequency designed to indicate an emergency. + + + + + + Property + Something that pertains to a thing. A characteristic of some entity. A quality or feature regarded as a characteristic or inherent part of someone or something. HED attributes are adjectives or adverbs. + + extensionAllowed + + + Agent-property + Something that pertains to an agent. + + extensionAllowed + + + Agent-state + The state of the agent. + + Agent-cognitive-state + The state of the cognitive processes or state of mind of the agent. + + Alert + Condition of heightened watchfulness or preparation for action. + + + Anesthetized + Having lost sensation to pain or having senses dulled due to the effects of an anesthetic. + + + Asleep + Having entered a periodic, readily reversible state of reduced awareness and metabolic activity, usually accompanied by physical relaxation and brain activity. + + + Attentive + Concentrating and focusing mental energy on the task or surroundings. + + + Distracted + Lacking in concentration because of being preoccupied. + + + Awake + In a non sleeping state. + + + Brain-dead + Characterized by the irreversible absence of cortical and brain stem functioning. + + + Comatose + In a state of profound unconsciousness associated with markedly depressed cerebral activity. + + + Drowsy + In a state of near-sleep, a strong desire for sleep, or sleeping for unusually long periods. + + + Intoxicated + In a state with disturbed psychophysiological functions and responses as a result of administration or ingestion of a psychoactive substance. + + + Locked-in + In a state of complete paralysis of all voluntary muscles except for the ones that control the movements of the eyes. + + + Passive + Not responding or initiating an action in response to a stimulus. + + + Resting + A state in which the agent is not exhibiting any physical exertion. + + + Vegetative + A state of wakefulness and conscience, but (in contrast to coma) with involuntary opening of the eyes and movements (such as teeth grinding, yawning, or thrashing of the extremities). + + + + Agent-emotional-state + The status of the general temperament and outlook of an agent. + + Angry + Experiencing emotions characterized by marked annoyance or hostility. + + + Aroused + In a state reactive to stimuli leading to increased heart rate and blood pressure, sensory alertness, mobility and readiness to respond. + + + Awed + Filled with wonder. Feeling grand, sublime or powerful emotions characterized by a combination of joy, fear, admiration, reverence, and/or respect. + + + Compassionate + Feeling or showing sympathy and concern for others often evoked for a person who is in distress and associated with altruistic motivation. + + + Content + Feeling satisfaction with things as they are. + + + Disgusted + Feeling revulsion or profound disapproval aroused by something unpleasant or offensive. + + + Emotionally-neutral + Feeling neither satisfied nor dissatisfied. + + + Empathetic + Understanding and sharing the feelings of another. Being aware of, being sensitive to, and vicariously experiencing the feelings, thoughts, and experience of another. + + + Excited + Feeling great enthusiasm and eagerness. + + + Fearful + Feeling apprehension that one may be in danger. + + + Frustrated + Feeling annoyed as a result of being blocked, thwarted, disappointed or defeated. + + + Grieving + Feeling sorrow in response to loss, whether physical or abstract. + + + Happy + Feeling pleased and content. + + + Jealous + Feeling threatened by a rival in a relationship with another individual, in particular an intimate partner, usually involves feelings of threat, fear, suspicion, distrust, anxiety, anger, betrayal, and rejection. + + + Joyful + Feeling delight or intense happiness. + + + Loving + Feeling a strong positive emotion of affection and attraction. + + + Relieved + No longer feeling pain, distress, anxiety, or reassured. + + + Sad + Feeling grief or unhappiness. + + + Stressed + Experiencing mental or emotional strain or tension. + + + + Agent-physiological-state + Having to do with the mechanical, physical, or biochemical function of an agent. + + Healthy + Having no significant health-related issues. + + relatedTag + Sick + + + + Hungry + Being in a state of craving or desiring food. + + relatedTag + Sated + Thirsty + + + + Rested + Feeling refreshed and relaxed. + + relatedTag + Tired + + + + Sated + Feeling full. + + relatedTag + Hungry + + + + Sick + Being in a state of ill health, bodily malfunction, or discomfort. + + relatedTag + Healthy + + + + Thirsty + Feeling a need to drink. + + relatedTag + Hungry + + + + Tired + Feeling in need of sleep or rest. + + relatedTag + Rested + + + + + Agent-postural-state + Pertaining to the position in which agent holds their body. + + Crouching + Adopting a position where the knees are bent and the upper body is brought forward and down, sometimes to avoid detection or to defend oneself. + + + Eyes-closed + Keeping eyes closed with no blinking. + + + Eyes-open + Keeping eyes open with occasional blinking. + + + Kneeling + Positioned where one or both knees are on the ground. + + + On-treadmill + Ambulation on an exercise apparatus with an endless moving belt to support moving in place. + + + Prone + Positioned in a recumbent body position whereby the person lies on its stomach and faces downward. + + + Sitting + In a seated position. + + + Standing + Assuming or maintaining an erect upright position. + + + Seated-with-chin-rest + Using a device that supports the chin and head. + + + + + Agent-task-role + The function or part that is ascribed to an agent in performing the task. + + Experiment-actor + An agent who plays a predetermined role to create the experiment scenario. + + + Experiment-controller + An agent exerting control over some aspect of the experiment. + + + Experiment-participant + Someone who takes part in an activity related to an experiment. + + + Experimenter + Person who is the owner of the experiment and has its responsibility. + + + + Agent-trait + A genetically, environmentally, or socially determined characteristic of an agent. + + Age + Length of time elapsed time since birth of the agent. + + # + + takesValue + + + valueClass + numericClass + + + + + Agent-experience-level + Amount of skill or knowledge that the agent has as pertains to the task. + + Expert-level + Having comprehensive and authoritative knowledge of or skill in a particular area related to the task. + + relatedTag + Intermediate-experience-level + Novice-level + + + + Intermediate-experience-level + Having a moderate amount of knowledge or skill related to the task. + + relatedTag + Expert-level + Novice-level + + + + Novice-level + Being inexperienced in a field or situation related to the task. + + relatedTag + Expert-level + Intermediate-experience-level + + + + + Gender + Characteristics that are socially constructed, including norms, behaviors, and roles based on sex. + + + Sex + Physical properties or qualities by which male is distinguished from female. + + Female + Biological sex of an individual with female sexual organs such ova. + + + Male + Biological sex of an individual with male sexual organs producing sperm. + + + Intersex + Having genitalia and/or secondary sexual characteristics of indeterminate sex. + + + + Ethnicity + Belong to a social group that has a common national or cultural tradition. Use with Label to avoid extension. + + + Handedness + Individual preference for use of a hand, known as the dominant hand. + + Left-handed + Preference for using the left hand or foot for tasks requiring the use of a single hand or foot. + + + Right-handed + Preference for using the right hand or foot for tasks requiring the use of a single hand or foot. + + + Ambidextrous + Having no overall dominance in the use of right or left hand or foot in the performance of tasks that require one hand or foot. + + + + Race + Belonging to a group sharing physical or social qualities as defined within a specified society. Use with Label to avoid extension. + + + + + Data-property + Something that pertains to data or information. + + extensionAllowed + + + Data-marker + An indicator placed to mark something. + + Data-break-marker + An indicator place to indicate a gap in the data. + + + Temporal-marker + An indicator placed at a particular time in the data. + + Inset + Marks an intermediate point in an ongoing event of temporal extent. + + topLevelTagGroup + + + reserved + + + relatedTag + Onset + Offset + + + + Onset + Marks the start of an ongoing event of temporal extent. + + topLevelTagGroup + + + reserved + + + relatedTag + Inset + Offset + + + + Offset + Marks the end of an event of temporal extent. + + topLevelTagGroup + + + reserved + + + relatedTag + Onset + Inset + + + + Pause + Indicates the temporary interruption of the operation a process and subsequently wait for a signal to continue. + + + Time-out + A cancellation or cessation that automatically occurs when a predefined interval of time has passed without a certain event occurring. + + + Time-sync + A synchronization signal whose purpose to help synchronize different signals or processes. Often used to indicate a marker inserted into the recorded data to allow post hoc synchronization of concurrently recorded data streams. + + + + + Data-resolution + Smallest change in a quality being measured by an sensor that causes a perceptible change. + + Printer-resolution + Resolution of a printer, usually expressed as the number of dots-per-inch for a printer. + + # + + takesValue + + + valueClass + numericClass + + + + + Screen-resolution + Resolution of a screen, usually expressed as the of pixels in a dimension for a digital display device. + + # + + takesValue + + + valueClass + numericClass + + + + + Sensory-resolution + Resolution of measurements by a sensing device. + + # + + takesValue + + + valueClass + numericClass + + + + + Spatial-resolution + Linear spacing of a spatial measurement. + + # + + takesValue + + + valueClass + numericClass + + + + + Spectral-resolution + Measures the ability of a sensor to resolve features in the electromagnetic spectrum. + + # + + takesValue + + + valueClass + numericClass + + + + + Temporal-resolution + Measures the ability of a sensor to resolve features in time. + + # + + takesValue + + + valueClass + numericClass + + + + + + Data-source-type + The type of place, person, or thing from which the data comes or can be obtained. + + Computed-feature + A feature computed from the data by a tool. This tag should be grouped with a label of the form Toolname_propertyName. + + + Computed-prediction + A computed extrapolation of known data. + + + Expert-annotation + An explanatory or critical comment or other in-context information provided by an authority. + + + Instrument-measurement + Information obtained from a device that is used to measure material properties or make other observations. + + + Observation + Active acquisition of information from a primary source. Should be grouped with a label of the form AgentID_featureName. + + + + Data-value + Designation of the type of a data item. + + Categorical-value + Indicates that something can take on a limited and usually fixed number of possible values. + + Categorical-class-value + Categorical values that fall into discrete classes such as true or false. The grouping is absolute in the sense that it is the same for all participants. + + All + To a complete degree or to the full or entire extent. + + relatedTag + Some + None + + + + Correct + Free from error. Especially conforming to fact or truth. + + relatedTag + Wrong + + + + Explicit + Stated clearly and in detail, leaving no room for confusion or doubt. + + relatedTag + Implicit + + + + False + Not in accordance with facts, reality or definitive criteria. + + relatedTag + True + + + + Implicit + Implied though not plainly expressed. + + relatedTag + Explicit + + + + Invalid + Not allowed or not conforming to the correct format or specifications. + + relatedTag + Valid + + + + None + No person or thing, nobody, not any. + + relatedTag + All + Some + + + + Some + At least a small amount or number of, but not a large amount of, or often. + + relatedTag + All + None + + + + True + Conforming to facts, reality or definitive criteria. + + relatedTag + False + + + + Valid + Allowable, usable, or acceptable. + + relatedTag + Invalid + + + + Wrong + Inaccurate or not correct. + + relatedTag + Correct + + + + + Categorical-judgment-value + Categorical values that are based on the judgment or perception of the participant such familiar and famous. + + Abnormal + Deviating in any way from the state, position, structure, condition, behavior, or rule which is considered a norm. + + relatedTag + Normal + + + + Asymmetrical + Lacking symmetry or having parts that fail to correspond to one another in shape, size, or arrangement. + + relatedTag + Symmetrical + + + + Audible + A sound that can be perceived by the participant. + + relatedTag + Inaudible + + + + Congruent + Concordance of multiple evidence lines. In agreement or harmony. + + relatedTag + Incongruent + + + + Complex + Hard, involved or complicated, elaborate, having many parts. + + relatedTag + Simple + + + + Constrained + Keeping something within particular limits or bounds. + + relatedTag + Unconstrained + + + + Disordered + Not neatly arranged. Confused and untidy. A structural quality in which the parts of an object are non-rigid. + + relatedTag + Ordered + + + + Familiar + Recognized, familiar, or within the scope of knowledge. + + relatedTag + Unfamiliar + Famous + + + + Famous + A person who has a high degree of recognition by the general population for his or her success or accomplishments. A famous person. + + relatedTag + Familiar + Unfamiliar + + + + Inaudible + A sound below the threshold of perception of the participant. + + relatedTag + Audible + + + + Incongruent + Not in agreement or harmony. + + relatedTag + Congruent + + + + Involuntary + An action that is not made by choice. In the body, involuntary actions (such as blushing) occur automatically, and cannot be controlled by choice. + + relatedTag + Voluntary + + + + Masked + Information exists but is not provided or is partially obscured due to security, privacy, or other concerns. + + relatedTag + Unmasked + + + + Normal + Being approximately average or within certain limits. Conforming with or constituting a norm or standard or level or type or social norm. + + relatedTag + Abnormal + + + + Ordered + Conforming to a logical or comprehensible arrangement of separate elements. + + relatedTag + Disordered + + + + Simple + Easily understood or presenting no difficulties. + + relatedTag + Complex + + + + Symmetrical + Made up of exactly similar parts facing each other or around an axis. Showing aspects of symmetry. + + relatedTag + Asymmetrical + + + + Unconstrained + Moving without restriction. + + relatedTag + Constrained + + + + Unfamiliar + Not having knowledge or experience of. + + relatedTag + Familiar + Famous + + + + Unmasked + Information is revealed. + + relatedTag + Masked + + + + Voluntary + Using free will or design; not forced or compelled; controlled by individual volition. + + relatedTag + Involuntary + + + + + Categorical-level-value + Categorical values based on dividing a continuous variable into levels such as high and low. + + Cold + Having an absence of heat. + + relatedTag + Hot + + + + Deep + Extending relatively far inward or downward. + + relatedTag + Shallow + + + + High + Having a greater than normal degree, intensity, or amount. + + relatedTag + Low + Medium + + + + Hot + Having an excess of heat. + + relatedTag + Cold + + + + Large + Having a great extent such as in physical dimensions, period of time, amplitude or frequency. + + relatedTag + Small + + + + Liminal + Situated at a sensory threshold that is barely perceptible or capable of eliciting a response. + + relatedTag + Subliminal + Supraliminal + + + + Loud + Having a perceived high intensity of sound. + + relatedTag + Quiet + + + + Low + Less than normal in degree, intensity or amount. + + relatedTag + High + + + + Medium + Mid-way between small and large in number, quantity, magnitude or extent. + + relatedTag + Low + High + + + + Negative + Involving disadvantage or harm. + + relatedTag + Positive + + + + Positive + Involving advantage or good. + + relatedTag + Negative + + + + Quiet + Characterizing a perceived low intensity of sound. + + relatedTag + Loud + + + + Rough + Having a surface with perceptible bumps, ridges, or irregularities. + + relatedTag + Smooth + + + + Shallow + Having a depth which is relatively low. + + relatedTag + Deep + + + + Small + Having a small extent such as in physical dimensions, period of time, amplitude or frequency. + + relatedTag + Large + + + + Smooth + Having a surface free from bumps, ridges, or irregularities. + + relatedTag + Rough + + + + Subliminal + Situated below a sensory threshold that is imperceptible or not capable of eliciting a response. + + relatedTag + Liminal + Supraliminal + + + + Supraliminal + Situated above a sensory threshold that is perceptible or capable of eliciting a response. + + relatedTag + Liminal + Subliminal + + + + Thick + Wide in width, extent or cross-section. + + relatedTag + Thin + + + + Thin + Narrow in width, extent or cross-section. + + relatedTag + Thick + + + + + Categorical-orientation-value + Value indicating the orientation or direction of something. + + Backward + Directed behind or to the rear. + + relatedTag + Forward + + + + Downward + Moving or leading toward a lower place or level. + + relatedTag + Leftward + Rightward + Upward + + + + Forward + At or near or directed toward the front. + + relatedTag + Backward + + + + Horizontally-oriented + Oriented parallel to or in the plane of the horizon. + + relatedTag + Vertically-oriented + + + + Leftward + Going toward or facing the left. + + relatedTag + Downward + Rightward + Upward + + + + Oblique + Slanting or inclined in direction, course, or position that is neither parallel nor perpendicular nor right-angular. + + relatedTag + Rotated + + + + Rightward + Going toward or situated on the right. + + relatedTag + Downward + Leftward + Upward + + + + Rotated + Positioned offset around an axis or center. + + + Upward + Moving, pointing, or leading to a higher place, point, or level. + + relatedTag + Downward + Leftward + Rightward + + + + Vertically-oriented + Oriented perpendicular to the plane of the horizon. + + relatedTag + Horizontally-oriented + + + + + + Physical-value + The value of some physical property of something. + + Weight + The relative mass or the quantity of matter contained by something. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + weightUnits + + + + + Temperature + A measure of hot or cold based on the average kinetic energy of the atoms or molecules in the system. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + temperatureUnits + + + + + + Quantitative-value + Something capable of being estimated or expressed with numeric values. + + Fraction + A numerical value between 0 and 1. + + # + + takesValue + + + valueClass + numericClass + + + + + Item-count + The integer count of something which is usually grouped with the entity it is counting. (Item-count/3, A) indicates that 3 of A have occurred up to this point. + + # + + takesValue + + + valueClass + numericClass + + + + + Item-index + The index of an item in a collection, sequence or other structure. (A (Item-index/3, B)) means that A is item number 3 in B. + + # + + takesValue + + + valueClass + numericClass + + + + + Item-interval + An integer indicating how many items or entities have passed since the last one of these. An item interval of 0 indicates the current item. + + # + + takesValue + + + valueClass + numericClass + + + + + Percentage + A fraction or ratio with 100 understood as the denominator. + + # + + takesValue + + + valueClass + numericClass + + + + + Ratio + A quotient of quantities of the same kind for different components within the same system. + + # + + takesValue + + + valueClass + numericClass + + + + + + Statistical-value + A value based on or employing the principles of statistics. + + extensionAllowed + + + Data-maximum + The largest possible quantity or degree. + + # + + takesValue + + + valueClass + numericClass + + + + + Data-mean + The sum of a set of values divided by the number of values in the set. + + # + + takesValue + + + valueClass + numericClass + + + + + Data-median + The value which has an equal number of values greater and less than it. + + # + + takesValue + + + valueClass + numericClass + + + + + Data-minimum + The smallest possible quantity. + + # + + takesValue + + + valueClass + numericClass + + + + + Probability + A measure of the expectation of the occurrence of a particular event. + + # + + takesValue + + + valueClass + numericClass + + + + + Standard-deviation + A measure of the range of values in a set of numbers. Standard deviation is a statistic used as a measure of the dispersion or variation in a distribution, equal to the square root of the arithmetic mean of the squares of the deviations from the arithmetic mean. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-accuracy + A measure of closeness to true value expressed as a number between 0 and 1. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-precision + A quantitative representation of the degree of accuracy necessary for or associated with a particular action. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-recall + Sensitivity is a measurement datum qualifying a binary classification test and is computed by substracting the false negative rate to the integral numeral 1. + + # + + takesValue + + + valueClass + numericClass + + + + + Statistical-uncertainty + A measure of the inherent variability of repeated observation measurements of a quantity including quantities evaluated by statistical methods and by other means. + + # + + takesValue + + + valueClass + numericClass + + + + + + Spatiotemporal-value + A property relating to space and/or time. + + Rate-of-change + The amount of change accumulated per unit time. + + Acceleration + Magnitude of the rate of change in either speed or direction. The direction of change should be given separately. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + accelerationUnits + + + + + Frequency + Frequency is the number of occurrences of a repeating event per unit time. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + frequencyUnits + + + + + Jerk-rate + Magnitude of the rate at which the acceleration of an object changes with respect to time. The direction of change should be given separately. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + jerkUnits + + + + + Sampling-rate + The number of digital samples taken or recorded per unit of time. + + # + + takesValue + + + unitClass + frequencyUnits + + + + + Refresh-rate + The frequency with which the image on a computer monitor or similar electronic display screen is refreshed, usually expressed in hertz. + + # + + takesValue + + + valueClass + numericClass + + + + + Speed + A scalar measure of the rate of movement of the object expressed either as the distance travelled divided by the time taken (average speed) or the rate of change of position with respect to time at a particular point (instantaneous speed). The direction of change should be given separately. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + speedUnits + + + + + Temporal-rate + The number of items per unit of time. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + frequencyUnits + + + + + + Spatial-value + Value of an item involving space. + + Angle + The amount of inclination of one line to another or the plane of one object to another. + + # + + takesValue + + + unitClass + angleUnits + + + valueClass + numericClass + + + + + Distance + A measure of the space separating two objects or points. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Position + A reference to the alignment of an object, a particular situation or view of a situation, or the location of an object. Coordinates with respect a specified frame of reference or the default Screen-frame if no frame is given. + + X-position + The position along the x-axis of the frame of reference. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Y-position + The position along the y-axis of the frame of reference. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Z-position + The position along the z-axis of the frame of reference. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + + Size + The physical magnitude of something. + + Area + The extent of a 2-dimensional surface enclosed within a boundary. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + areaUnits + + + + + Depth + The distance from the surface of something especially from the perspective of looking from the front. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Length + The linear extent in space from one end of something to the other end, or the extent of something from beginning to end. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Width + The extent or measurement of something from side to side. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Height + The vertical measurement or distance from the base to the top of an object. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + physicalLengthUnits + + + + + Volume + The amount of three dimensional space occupied by an object or the capacity of a space or container. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + volumeUnits + + + + + + + Temporal-value + A characteristic of or relating to time or limited by time. + + Delay + The time at which an event start time is delayed from the current onset time. This tag defines the start time of an event of temporal extent and may be used with the Duration tag. + + topLevelTagGroup + + + reserved + + + relatedTag + Duration + + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Duration + The period of time during which an event occurs. This tag defines the end time of an event of temporal extent and may be used with the Delay tag. + + topLevelTagGroup + + + reserved + + + relatedTag + Delay + + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Time-interval + The period of time separating two instances, events, or occurrences. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Time-value + A value with units of time. Usually grouped with tags identifying what the value represents. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + + + + Data-variability-attribute + An attribute describing how something changes or varies. + + Abrupt + Marked by sudden change. + + + Constant + Continually recurring or continuing without interruption. Not changing in time or space. + + + Continuous + Uninterrupted in time, sequence, substance, or extent. + + relatedTag + Discrete + Discontinuous + + + + Decreasing + Becoming smaller or fewer in size, amount, intensity, or degree. + + relatedTag + Increasing + + + + Deterministic + No randomness is involved in the development of the future states of the element. + + relatedTag + Random + Stochastic + + + + Discontinuous + Having a gap in time, sequence, substance, or extent. + + relatedTag + Continuous + + + + Discrete + Constituting a separate entities or parts. + + relatedTag + Continuous + Discontinuous + + + + Flickering + Moving irregularly or unsteadily or burning or shining fitfully or with a fluctuating light. + + + Estimated-value + Something that has been calculated or measured approximately. + + + Exact-value + A value that is viewed to the true value according to some standard. + + + Fractal + Having extremely irregular curves or shapes for which any suitably chosen part is similar in shape to a given larger or smaller part when magnified or reduced to the same size. + + + Increasing + Becoming greater in size, amount, or degree. + + relatedTag + Decreasing + + + + Random + Governed by or depending on chance. Lacking any definite plan or order or purpose. + + relatedTag + Deterministic + Stochastic + + + + Repetitive + A recurring action that is often non-purposeful. + + + Stochastic + Uses a random probability distribution or pattern that may be analysed statistically but may not be predicted precisely to determine future states. + + relatedTag + Deterministic + Random + + + + Varying + Differing in size, amount, degree, or nature. + + + + + Environmental-property + Relating to or arising from the surroundings of an agent. + + Indoors + Located inside a building or enclosure. + + + Outdoors + Any area outside a building or shelter. + + + Real-world + Located in a place that exists in real space and time under realistic conditions. + + + Virtual-world + Using technology that creates immersive, computer-generated experiences that a person can interact with and navigate through. The digital content is generally delivered to the user through some type of headset and responds to changes in head position or through interaction with other types of sensors. Existing in a virtual setting such as a simulation or game environment. + + + Augmented-reality + Using technology that enhances real-world experiences with computer-derived digital overlays to change some aspects of perception of the natural environment. The digital content is shown to the user through a smart device or glasses and responds to changes in the environment. + + + Motion-platform + A mechanism that creates the feelings of being in a real motion environment. + + + Urban + Relating to, located in, or characteristic of a city or densely populated area. + + + Rural + Of or pertaining to the country as opposed to the city. + + + Terrain + Characterization of the physical features of a tract of land. + + Composite-terrain + Tracts of land characterized by a mixure of physical features. + + + Dirt-terrain + Tracts of land characterized by a soil surface and lack of vegetation. + + + Grassy-terrain + Tracts of land covered by grass. + + + Gravel-terrain + Tracts of land covered by a surface consisting a loose aggregation of small water-worn or pounded stones. + + + Leaf-covered-terrain + Tracts of land covered by leaves and composited organic material. + + + Muddy-terrain + Tracts of land covered by a liquid or semi-liquid mixture of water and some combination of soil, silt, and clay. + + + Paved-terrain + Tracts of land covered with concrete, asphalt, stones, or bricks. + + + Rocky-terrain + Tracts of land consisting or full of rock or rocks. + + + Sloped-terrain + Tracts of land arranged in a sloping or inclined position. + + + Uneven-terrain + Tracts of land that are not level, smooth, or regular. + + + + + Informational-property + Something that pertains to a task. + + extensionAllowed + + + Description + An explanation of what the tag group it is in means. If the description is at the top-level of an event string, the description applies to the event. + + requireChild + + + # + + takesValue + + + valueClass + textClass + + + + + ID + An alphanumeric name that identifies either a unique object or a unique class of objects. Here the object or class may be an idea, physical countable object (or class), or physical uncountable substance (or class). + + requireChild + + + # + + takesValue + + + valueClass + textClass + + + + + Label + A string of 20 or fewer characters identifying something. Labels usually refer to general classes of things while IDs refer to specific instances. A term that is associated with some entity. A brief description given for purposes of identification. An identifying or descriptive marker that is attached to an object. + + requireChild + + + # + + takesValue + + + valueClass + nameClass + + + + + Metadata + Data about data. Information that describes another set of data. + + CogAtlas + The Cognitive Atlas ID number of something. + + # + + takesValue + + + + + CogPo + The CogPO ID number of something. + + # + + takesValue + + + + + Creation-date + The date on which data creation of this element began. + + requireChild + + + # + + takesValue + + + valueClass + dateTimeClass + + + + + Experimental-note + A brief written record about the experiment. + + # + + takesValue + + + valueClass + textClass + + + + + Library-name + Official name of a HED library. + + # + + takesValue + + + valueClass + nameClass + + + + + OBO-identifier + The identifier of a term in some Open Biology Ontology (OBO) ontology. + + # + + takesValue + + + valueClass + nameClass + + + + + Pathname + The specification of a node (file or directory) in a hierarchical file system, usually specified by listing the nodes top-down. + + # + + takesValue + + + + + Subject-identifier + A sequence of characters used to identify, name, or characterize a trial or study subject. + + # + + takesValue + + + + + Version-identifier + An alphanumeric character string that identifies a form or variant of a type or original. + + # + Usually is a semantic version. + + takesValue + + + + + + Parameter + Something user-defined for this experiment. + + Parameter-label + The name of the parameter. + + # + + takesValue + + + valueClass + nameClass + + + + + Parameter-value + The value of the parameter. + + # + + takesValue + + + valueClass + textClass + + + + + + + Organizational-property + Relating to an organization or the action of organizing something. + + Collection + A tag designating a grouping of items such as in a set or list. + + # + Name of the collection. + + takesValue + + + valueClass + nameClass + + + + + Condition-variable + An aspect of the experiment or task that is to be varied during the experiment. Task-conditions are sometimes called independent variables or contrasts. + + # + Name of the condition variable. + + takesValue + + + valueClass + nameClass + + + + + Control-variable + An aspect of the experiment that is fixed throughout the study and usually is explicitly controlled. + + # + Name of the control variable. + + takesValue + + + valueClass + nameClass + + + + + Def + A HED-specific utility tag used with a defined name to represent the tags associated with that definition. + + requireChild + + + reserved + + + # + Name of the definition. + + takesValue + + + valueClass + nameClass + + + + + Def-expand + A HED specific utility tag that is grouped with an expanded definition. The child value of the Def-expand is the name of the expanded definition. + + requireChild + + + reserved + + + tagGroup + + + # + + takesValue + + + valueClass + nameClass + + + + + Definition + A HED-specific utility tag whose child value is the name of the concept and the tag group associated with the tag is an English language explanation of a concept. + + requireChild + + + reserved + + + topLevelTagGroup + + + # + Name of the definition. + + takesValue + + + valueClass + nameClass + + + + + Event-context + A special HED tag inserted as part of a top-level tag group to contain information about the interrelated conditions under which the event occurs. The event context includes information about other events that are ongoing when this event happens. + + reserved + + + topLevelTagGroup + + + unique + + + + Event-stream + A special HED tag indicating that this event is a member of an ordered succession of events. + + # + Name of the event stream. + + takesValue + + + valueClass + nameClass + + + + + Experimental-intertrial + A tag used to indicate a part of the experiment between trials usually where nothing is happening. + + # + Optional label for the intertrial block. + + takesValue + + + valueClass + nameClass + + + + + Experimental-trial + Designates a run or execution of an activity, for example, one execution of a script. A tag used to indicate a particular organizational part in the experimental design often containing a stimulus-response pair or stimulus-response-feedback triad. + + # + Optional label for the trial (often a numerical string). + + takesValue + + + valueClass + nameClass + + + + + Indicator-variable + An aspect of the experiment or task that is measured as task conditions are varied during the experiment. Experiment indicators are sometimes called dependent variables. + + # + Name of the indicator variable. + + takesValue + + + valueClass + nameClass + + + + + Recording + A tag designating the data recording. Recording tags are usually have temporal scope which is the entire recording. + + # + Optional label for the recording. + + takesValue + + + valueClass + nameClass + + + + + Task + An assigned piece of work, usually with a time allotment. A tag used to indicate a linkage the structured activities performed as part of the experiment. + + # + Optional label for the task block. + + takesValue + + + valueClass + nameClass + + + + + Time-block + A tag used to indicate a contiguous time block in the experiment during which something is fixed or noted. + + # + Optional label for the task block. + + takesValue + + + valueClass + nameClass + + + + + + Sensory-property + Relating to sensation or the physical senses. + + Sensory-attribute + A sensory characteristic associated with another entity. + + Auditory-attribute + Pertaining to the sense of hearing. + + Loudness + Perceived intensity of a sound. + + # + + takesValue + + + valueClass + numericClass + nameClass + + + + + Pitch + A perceptual property that allows the user to order sounds on a frequency scale. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + frequencyUnits + + + + + Sound-envelope + Description of how a sound changes over time. + + Sound-envelope-attack + The time taken for initial run-up of level from nil to peak usually beginning when the key on a musical instrument is pressed. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Sound-envelope-decay + The time taken for the subsequent run down from the attack level to the designated sustain level. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Sound-envelope-release + The time taken for the level to decay from the sustain level to zero after the key is released. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + Sound-envelope-sustain + The time taken for the main sequence of the sound duration, until the key is released. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + timeUnits + + + + + + Timbre + The perceived sound quality of a singing voice or musical instrument. + + # + + takesValue + + + valueClass + nameClass + + + + + Sound-volume + The sound pressure level (SPL) usually the ratio to a reference signal estimated as the lower bound of hearing. + + # + + takesValue + + + valueClass + numericClass + + + unitClass + intensityUnits + + + + + + Gustatory-attribute + Pertaining to the sense of taste. + + Bitter + Having a sharp, pungent taste. + + + Salty + Tasting of or like salt. + + + Savory + Belonging to a taste that is salty or spicy rather than sweet. + + + Sour + Having a sharp, acidic taste. + + + Sweet + Having or resembling the taste of sugar. + + + + Olfactory-attribute + Having a smell. + + + Somatic-attribute + Pertaining to the feelings in the body or of the nervous system. + + Pain + The sensation of discomfort, distress, or agony, resulting from the stimulation of specialized nerve endings. + + + Stress + The negative mental, emotional, and physical reactions that occur when environmental stressors are perceived as exceeding the adaptive capacities of the individual. + + + + Tactile-attribute + Pertaining to the sense of touch. + + Tactile-pressure + Having a feeling of heaviness. + + + Tactile-temperature + Having a feeling of hotness or coldness. + + + Tactile-texture + Having a feeling of roughness. + + + Tactile-vibration + Having a feeling of mechanical oscillation. + + + + Vestibular-attribute + Pertaining to the sense of balance or body position. + + + Visual-attribute + Pertaining to the sense of sight. + + Color + The appearance of objects (or light sources) described in terms of perception of their hue and lightness (or brightness) and saturation. + + CSS-color + One of 140 colors supported by all browsers. For more details such as the color RGB or HEX values, check: https://www.w3schools.com/colors/colors_groups.asp. + + Blue-color + CSS color group. + + CadetBlue + CSS-color 0x5F9EA0. + + + SteelBlue + CSS-color 0x4682B4. + + + LightSteelBlue + CSS-color 0xB0C4DE. + + + LightBlue + CSS-color 0xADD8E6. + + + PowderBlue + CSS-color 0xB0E0E6. + + + LightSkyBlue + CSS-color 0x87CEFA. + + + SkyBlue + CSS-color 0x87CEEB. + + + CornflowerBlue + CSS-color 0x6495ED. + + + DeepSkyBlue + CSS-color 0x00BFFF. + + + DodgerBlue + CSS-color 0x1E90FF. + + + RoyalBlue + CSS-color 0x4169E1. + + + Blue + CSS-color 0x0000FF. + + + MediumBlue + CSS-color 0x0000CD. + + + DarkBlue + CSS-color 0x00008B. + + + Navy + CSS-color 0x000080. + + + MidnightBlue + CSS-color 0x191970. + + + + Brown-color + CSS color group. + + Cornsilk + CSS-color 0xFFF8DC. + + + BlanchedAlmond + CSS-color 0xFFEBCD. + + + Bisque + CSS-color 0xFFE4C4. + + + NavajoWhite + CSS-color 0xFFDEAD. + + + Wheat + CSS-color 0xF5DEB3. + + + BurlyWood + CSS-color 0xDEB887. + + + Tan + CSS-color 0xD2B48C. + + + RosyBrown + CSS-color 0xBC8F8F. + + + SandyBrown + CSS-color 0xF4A460. + + + GoldenRod + CSS-color 0xDAA520. + + + DarkGoldenRod + CSS-color 0xB8860B. + + + Peru + CSS-color 0xCD853F. + + + Chocolate + CSS-color 0xD2691E. + + + Olive + CSS-color 0x808000. + + + SaddleBrown + CSS-color 0x8B4513. + + + Sienna + CSS-color 0xA0522D. + + + Brown + CSS-color 0xA52A2A. + + + Maroon + CSS-color 0x800000. + + + + Cyan-color + CSS color group. + + Aqua + CSS-color 0x00FFFF. + + + Cyan + CSS-color 0x00FFFF. + + + LightCyan + CSS-color 0xE0FFFF. + + + PaleTurquoise + CSS-color 0xAFEEEE. + + + Aquamarine + CSS-color 0x7FFFD4. + + + Turquoise + CSS-color 0x40E0D0. + + + MediumTurquoise + CSS-color 0x48D1CC. + + + DarkTurquoise + CSS-color 0x00CED1. + + + + Green-color + CSS color group. + + GreenYellow + CSS-color 0xADFF2F. + + + Chartreuse + CSS-color 0x7FFF00. + + + LawnGreen + CSS-color 0x7CFC00. + + + Lime + CSS-color 0x00FF00. + + + LimeGreen + CSS-color 0x32CD32. + + + PaleGreen + CSS-color 0x98FB98. + + + LightGreen + CSS-color 0x90EE90. + + + MediumSpringGreen + CSS-color 0x00FA9A. + + + SpringGreen + CSS-color 0x00FF7F. + + + MediumSeaGreen + CSS-color 0x3CB371. + + + SeaGreen + CSS-color 0x2E8B57. + + + ForestGreen + CSS-color 0x228B22. + + + Green + CSS-color 0x008000. + + + DarkGreen + CSS-color 0x006400. + + + YellowGreen + CSS-color 0x9ACD32. + + + OliveDrab + CSS-color 0x6B8E23. + + + DarkOliveGreen + CSS-color 0x556B2F. + + + MediumAquaMarine + CSS-color 0x66CDAA. + + + DarkSeaGreen + CSS-color 0x8FBC8F. + + + LightSeaGreen + CSS-color 0x20B2AA. + + + DarkCyan + CSS-color 0x008B8B. + + + Teal + CSS-color 0x008080. + + + + Gray-color + CSS color group. + + Gainsboro + CSS-color 0xDCDCDC. + + + LightGray + CSS-color 0xD3D3D3. + + + Silver + CSS-color 0xC0C0C0. + + + DarkGray + CSS-color 0xA9A9A9. + + + DimGray + CSS-color 0x696969. + + + Gray + CSS-color 0x808080. + + + LightSlateGray + CSS-color 0x778899. + + + SlateGray + CSS-color 0x708090. + + + DarkSlateGray + CSS-color 0x2F4F4F. + + + Black + CSS-color 0x000000. + + + + Orange-color + CSS color group. + + Orange + CSS-color 0xFFA500. + + + DarkOrange + CSS-color 0xFF8C00. + + + Coral + CSS-color 0xFF7F50. + + + Tomato + CSS-color 0xFF6347. + + + OrangeRed + CSS-color 0xFF4500. + + + + Pink-color + CSS color group. + + Pink + CSS-color 0xFFC0CB. + + + LightPink + CSS-color 0xFFB6C1. + + + HotPink + CSS-color 0xFF69B4. + + + DeepPink + CSS-color 0xFF1493. + + + PaleVioletRed + CSS-color 0xDB7093. + + + MediumVioletRed + CSS-color 0xC71585. + + + + Purple-color + CSS color group. + + Lavender + CSS-color 0xE6E6FA. + + + Thistle + CSS-color 0xD8BFD8. + + + Plum + CSS-color 0xDDA0DD. + + + Orchid + CSS-color 0xDA70D6. + + + Violet + CSS-color 0xEE82EE. + + + Fuchsia + CSS-color 0xFF00FF. + + + Magenta + CSS-color 0xFF00FF. + + + MediumOrchid + CSS-color 0xBA55D3. + + + DarkOrchid + CSS-color 0x9932CC. + + + DarkViolet + CSS-color 0x9400D3. + + + BlueViolet + CSS-color 0x8A2BE2. + + + DarkMagenta + CSS-color 0x8B008B. + + + Purple + CSS-color 0x800080. + + + MediumPurple + CSS-color 0x9370DB. + + + MediumSlateBlue + CSS-color 0x7B68EE. + + + SlateBlue + CSS-color 0x6A5ACD. + + + DarkSlateBlue + CSS-color 0x483D8B. + + + RebeccaPurple + CSS-color 0x663399. + + + Indigo + CSS-color 0x4B0082. + + + + Red-color + CSS color group. + + LightSalmon + CSS-color 0xFFA07A. + + + Salmon + CSS-color 0xFA8072. + + + DarkSalmon + CSS-color 0xE9967A. + + + LightCoral + CSS-color 0xF08080. + + + IndianRed + CSS-color 0xCD5C5C. + + + Crimson + CSS-color 0xDC143C. + + + Red + CSS-color 0xFF0000. + + + FireBrick + CSS-color 0xB22222. + + + DarkRed + CSS-color 0x8B0000. + + + + Yellow-color + CSS color group. + + Gold + CSS-color 0xFFD700. + + + Yellow + CSS-color 0xFFFF00. + + + LightYellow + CSS-color 0xFFFFE0. + + + LemonChiffon + CSS-color 0xFFFACD. + + + LightGoldenRodYellow + CSS-color 0xFAFAD2. + + + PapayaWhip + CSS-color 0xFFEFD5. + + + Moccasin + CSS-color 0xFFE4B5. + + + PeachPuff + CSS-color 0xFFDAB9. + + + PaleGoldenRod + CSS-color 0xEEE8AA. + + + Khaki + CSS-color 0xF0E68C. + + + DarkKhaki + CSS-color 0xBDB76B. + + + + White-color + CSS color group. + + White + CSS-color 0xFFFFFF. + + + Snow + CSS-color 0xFFFAFA. + + + HoneyDew + CSS-color 0xF0FFF0. + + + MintCream + CSS-color 0xF5FFFA. + + + Azure + CSS-color 0xF0FFFF. + + + AliceBlue + CSS-color 0xF0F8FF. + + + GhostWhite + CSS-color 0xF8F8FF. + + + WhiteSmoke + CSS-color 0xF5F5F5. + + + SeaShell + CSS-color 0xFFF5EE. + + + Beige + CSS-color 0xF5F5DC. + + + OldLace + CSS-color 0xFDF5E6. + + + FloralWhite + CSS-color 0xFFFAF0. + + + Ivory + CSS-color 0xFFFFF0. + + + AntiqueWhite + CSS-color 0xFAEBD7. + + + Linen + CSS-color 0xFAF0E6. + + + LavenderBlush + CSS-color 0xFFF0F5. + + + MistyRose + CSS-color 0xFFE4E1. + + + + + Color-shade + A slight degree of difference between colors, especially with regard to how light or dark it is or as distinguished from one nearly like it. + + Dark-shade + A color tone not reflecting much light. + + + Light-shade + A color tone reflecting more light. + + + + Grayscale + Using a color map composed of shades of gray, varying from black at the weakest intensity to white at the strongest. + + # + White intensity between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + HSV-color + A color representation that models how colors appear under light. + + Hue + Attribute of a visual sensation according to which an area appears to be similar to one of the perceived colors. + + # + Angular value between 0 and 360. + + takesValue + + + valueClass + numericClass + + + + + Saturation + Colorfulness of a stimulus relative to its own brightness. + + # + B value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + HSV-value + An attribute of a visual sensation according to which an area appears to emit more or less light. + + # + + takesValue + + + valueClass + numericClass + + + + + + RGB-color + A color from the RGB schema. + + RGB-red + The red component. + + # + R value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + RGB-blue + The blue component. + + # + B value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + RGB-green + The green component. + + # + G value of RGB between 0 and 1. + + takesValue + + + valueClass + numericClass + + + + + + + Luminance + A quality that exists by virtue of the luminous intensity per unit area projected in a given direction. + + + Opacity + A measure of impenetrability to light. + + + + + Sensory-presentation + The entity has a sensory manifestation. + + Auditory-presentation + The sense of hearing is used in the presentation to the user. + + Loudspeaker-separation + The distance between two loudspeakers. Grouped with the Distance tag. + + suggestedTag + Distance + + + + Monophonic + Relating to sound transmission, recording, or reproduction involving a single transmission path. + + + Silent + The absence of ambient audible sound or the state of having ceased to produce sounds. + + + Stereophonic + Relating to, or constituting sound reproduction involving the use of separated microphones and two transmission channels to achieve the sound separation of a live hearing. + + + + Gustatory-presentation + The sense of taste used in the presentation to the user. + + + Olfactory-presentation + The sense of smell used in the presentation to the user. + + + Somatic-presentation + The nervous system is used in the presentation to the user. + + + Tactile-presentation + The sense of touch used in the presentation to the user. + + + Vestibular-presentation + The sense balance used in the presentation to the user. + + + Visual-presentation + The sense of sight used in the presentation to the user. + + 2D-view + A view showing only two dimensions. + + + 3D-view + A view showing three dimensions. + + + Background-view + Parts of the view that are farthest from the viewer and usually the not part of the visual focus. + + + Bistable-view + Something having two stable visual forms that have two distinguishable stable forms as in optical illusions. + + + Foreground-view + Parts of the view that are closest to the viewer and usually the most important part of the visual focus. + + + Foveal-view + Visual presentation directly on the fovea. A view projected on the small depression in the retina containing only cones and where vision is most acute. + + + Map-view + A diagrammatic representation of an area of land or sea showing physical features, cities, roads. + + Aerial-view + Elevated view of an object from above, with a perspective as though the observer were a bird. + + + Satellite-view + A representation as captured by technology such as a satellite. + + + Street-view + A 360-degrees panoramic view from a position on the ground. + + + + Peripheral-view + Indirect vision as it occurs outside the point of fixation. + + + + + + Task-property + Something that pertains to a task. + + extensionAllowed + + + Task-attentional-demand + Strategy for allocating attention toward goal-relevant information. + + Bottom-up-attention + Attentional guidance purely by externally driven factors to stimuli that are salient because of their inherent properties relative to the background. Sometimes this is referred to as stimulus driven. + + relatedTag + Top-down-attention + + + + Covert-attention + Paying attention without moving the eyes. + + relatedTag + Overt-attention + + + + Divided-attention + Integrating parallel multiple stimuli. Behavior involving responding simultaneously to multiple tasks or multiple task demands. + + relatedTag + Focused-attention + + + + Focused-attention + Responding discretely to specific visual, auditory, or tactile stimuli. + + relatedTag + Divided-attention + + + + Orienting-attention + Directing attention to a target stimulus. + + + Overt-attention + Selectively processing one location over others by moving the eyes to point at that location. + + relatedTag + Covert-attention + + + + Selective-attention + Maintaining a behavioral or cognitive set in the face of distracting or competing stimuli. Ability to pay attention to a limited array of all available sensory information. + + + Sustained-attention + Maintaining a consistent behavioral response during continuous and repetitive activity. + + + Switched-attention + Having to switch attention between two or more modalities of presentation. + + + Top-down-attention + Voluntary allocation of attention to certain features. Sometimes this is referred to goal-oriented attention. + + relatedTag + Bottom-up-attention + + + + + Task-effect-evidence + The evidence supporting the conclusion that the event had the specified effect. + + Computational-evidence + A type of evidence in which data are produced, and/or generated, and/or analyzed on a computer. + + + External-evidence + A phenomenon that follows and is caused by some previous phenomenon. + + + Intended-effect + A phenomenon that is intended to follow and be caused by some previous phenomenon. + + + Behavioral-evidence + An indication or conclusion based on the behavior of an agent. + + + + Task-event-role + The purpose of an event with respect to the task. + + Experimental-stimulus + Part of something designed to elicit a response in the experiment. + + + Incidental + A sensory or other type of event that is unrelated to the task or experiment. + + + Instructional + Usually associated with a sensory event intended to give instructions to the participant about the task or behavior. + + + Mishap + Unplanned disruption such as an equipment or experiment control abnormality or experimenter error. + + + Participant-response + Something related to a participant actions in performing the task. + + + Task-activity + Something that is part of the overall task or is necessary to the overall experiment but is not directly part of a stimulus-response cycle. Examples would be taking a survey or provided providing a silva sample. + + + Warning + Something that should warn the participant that the parameters of the task have been or are about to be exceeded such as a warning message about getting too close to the shoulder of the road in a driving task. + + + + Task-action-type + How an agent action should be interpreted in terms of the task specification. + + Appropriate-action + An action suitable or proper in the circumstances. + + relatedTag + Inappropriate-action + + + + Correct-action + An action that was a correct response in the context of the task. + + relatedTag + Incorrect-action + Indeterminate-action + + + + Correction + An action offering an improvement to replace a mistake or error. + + + Done-indication + An action that indicates that the participant has completed this step in the task. + + relatedTag + Ready-indication + + + + Incorrect-action + An action considered wrong or incorrect in the context of the task. + + relatedTag + Correct-action + Indeterminate-action + + + + Imagined-action + Form a mental image or concept of something. This is used to identity something that only happened in the imagination of the participant as in imagined movements in motor imagery paradigms. + + + Inappropriate-action + An action not in keeping with what is correct or proper for the task. + + relatedTag + Appropriate-action + + + + Indeterminate-action + An action that cannot be distinguished between two or more possibibities in the current context. This tag might be applied when an outside evaluator or a classification algorithm cannot determine a definitive result. + + relatedTag + Correct-action + Incorrect-action + Miss + Near-miss + + + + Omitted-action + An expected response was skipped. + + + Miss + An action considered to be a failure in the context of the task. For example, if the agent is supposed to try to hit a target and misses. + + relatedTag + Near-miss + + + + Near-miss + An action barely satisfied the requirements of the task. In a driving experiment for example this could pertain to a narrowly avoided collision or other accident. + + relatedTag + Miss + + + + Ready-indication + An action that indicates that the participant is ready to perform the next step in the task. + + relatedTag + Done-indication + + + + + Task-relationship + Specifying organizational importance of sub-tasks. + + Background-subtask + A part of the task which should be performed in the background as for example inhibiting blinks due to instruction while performing the primary task. + + + Primary-subtask + A part of the task which should be the primary focus of the participant. + + + + Task-stimulus-role + The role the stimulus plays in the task. + + Cue + A signal for an action, a pattern of stimuli indicating a particular response. + + + Distractor + A person or thing that distracts or a plausible but incorrect option in a multiple-choice question. In pyschological studies this is sometimes referred to as a foil. + + + Expected + Considered likely, probable or anticipated. Something of low information value as in frequent non-targets in an RSVP paradigm. + + relatedTag + Unexpected + + + suggestedTag + Target + + + + Extraneous + Irrelevant or unrelated to the subject being dealt with. + + + Feedback + An evaluative response to an inquiry, process, event, or activity. + + + Go-signal + An indicator to proceed with a planned action. + + relatedTag + Stop-signal + + + + Meaningful + Conveying significant or relevant information. + + + Newly-learned + Representing recently acquired information or understanding. + + + Non-informative + Something that is not useful in forming an opinion or judging an outcome. + + + Non-target + Something other than that done or looked for. Also tag Expected if the Non-target is frequent. + + relatedTag + Target + + + + Not-meaningful + Not having a serious, important, or useful quality or purpose. + + + Novel + Having no previous example or precedent or parallel. + + + Oddball + Something unusual, or infrequent. + + relatedTag + Unexpected + + + suggestedTag + Target + + + + Planned + Something that was decided on or arranged in advance. + + relatedTag + Unplanned + + + + Penalty + A disadvantage, loss, or hardship due to some action. + + + Priming + An implicit memory effect in which exposure to a stimulus influences response to a later stimulus. + + + Query + A sentence of inquiry that asks for a reply. + + + Reward + A positive reinforcement for a desired action, behavior or response. + + + Stop-signal + An indicator that the agent should stop the current activity. + + relatedTag + Go-signal + + + + Target + Something fixed as a goal, destination, or point of examination. + + + Threat + An indicator that signifies hostility and predicts an increased probability of attack. + + + Timed + Something planned or scheduled to be done at a particular time or lasting for a specified amount of time. + + + Unexpected + Something that is not anticipated. + + relatedTag + Expected + + + + Unplanned + Something that has not been planned as part of the task. + + relatedTag + Planned + + + + + + + Relation + Concerns the way in which two or more people or things are connected. + + extensionAllowed + + + Comparative-relation + Something considered in comparison to something else. The first entity is the focus. + + Approximately-equal-to + (A, (Approximately-equal-to, B)) indicates that A and B have almost the same value. Here A and B could refer to sizes, orders, positions or other quantities. + + + Less-than + (A, (Less-than, B)) indicates that A is smaller than B. Here A and B could refer to sizes, orders, positions or other quantities. + + + Less-than-or-equal-to + (A, (Less-than-or-equal-to, B)) indicates that the relative size or order of A is smaller than or equal to B. + + + Greater-than + (A, (Greater-than, B)) indicates that the relative size or order of A is bigger than that of B. + + + Greater-than-or-equal-to + (A, (Greater-than-or-equal-to, B)) indicates that the relative size or order of A is bigger than or the same as that of B. + + + Equal-to + (A, (Equal-to, B)) indicates that the size or order of A is the same as that of B. + + + Not-equal-to + (A, (Not-equal-to, B)) indicates that the size or order of A is not the same as that of B. + + + + Connective-relation + Indicates two entities are related in some way. The first entity is the focus. + + Belongs-to + (A, (Belongs-to, B)) indicates that A is a member of B. + + + Connected-to + (A, (Connected-to, B)) indicates that A is related to B in some respect, usually through a direct link. + + + Contained-in + (A, (Contained-in, B)) indicates that A is completely inside of B. + + + Described-by + (A, (Described-by, B)) indicates that B provides information about A. + + + From-to + (A, (From-to, B)) indicates a directional relation from A to B. A is considered the source. + + + Group-of + (A, (Group-of, B)) indicates A is a group of items of type B. + + + Implied-by + (A, (Implied-by, B)) indicates B is suggested by A. + + + Includes + (A, (Includes, B)) indicates that A has B as a member or part. + + + Interacts-with + (A, (Interacts-with, B)) indicates A and B interact, possibly reciprocally. + + + Member-of + (A, (Member-of, B)) indicates A is a member of group B. + + + Part-of + (A, (Part-of, B)) indicates A is a part of the whole B. + + + Performed-by + (A, (Performed-by, B)) indicates that the action or procedure A was carried out by agent B. + + + Performed-using + (A, (Performed-using, B)) indicates that the action or procedure A was accomplished using B. + + + Related-to + (A, (Related-to, B)) indicates A has some relationship to B. + + + Unrelated-to + (A, (Unrelated-to, B)) indicates that A is not related to B. For example, A is not related to Task. + + + + Directional-relation + A relationship indicating direction of change of one entity relative to another. The first entity is the focus. + + Away-from + (A, (Away-from, B)) indicates that A is going or has moved away from B. The meaning depends on A and B. + + + Towards + (A, (Towards, B)) indicates that A is going to or has moved to B. The meaning depends on A and B. + + + + Logical-relation + Indicating a logical relationship between entities. The first entity is usually the focus. + + And + (A, (And, B)) means A and B are both in effect. + + + Or + (A, (Or, B)) means at least one of A and B are in effect. + + + + Spatial-relation + Indicating a relationship about position between entities. + + Above + (A, (Above, B)) means A is in a place or position that is higher than B. + + + Across-from + (A, (Across-from, B)) means A is on the opposite side of something from B. + + + Adjacent-to + (A, (Adjacent-to, B)) indicates that A is next to B in time or space. + + + Ahead-of + (A, (Ahead-of, B)) indicates that A is further forward in time or space in B. + + + Around + (A, (Around, B)) means A is in or near the present place or situation of B. + + + Behind + (A, (Behind, B)) means A is at or to the far side of B, typically so as to be hidden by it. + + + Below + (A, (Below, B)) means A is in a place or position that is lower than the position of B. + + + Between + (A, (Between, (B, C))) means A is in the space or interval separating B and C. + + + Bilateral-to + (A, (Bilateral, B)) means A is on both sides of B or affects both sides of B. + + + Bottom-edge-of + (A, (Bottom-edge-of, B)) means A is on the bottom most part or or near the boundary of B. + + relatedTag + Left-edge-of + Right-edge-of + Top-edge-of + + + + Boundary-of + (A, (Boundary-of, B)) means A is on or part of the edge or boundary of B. + + + Center-of + (A, (Center-of, B)) means A is at a point or or in an area that is approximately central within B. + + + Close-to + (A, (Close-to, B)) means A is at a small distance from or is located near in space to B. + + + Far-from + (A, (Far-from, B)) means A is at a large distance from or is not located near in space to B. + + + In-front-of + (A, (In-front-of, B)) means A is in a position just ahead or at the front part of B, potentially partially blocking B from view. + + + Left-edge-of + (A, (Left-edge-of, B)) means A is located on the left side of B on or near the boundary of B. + + relatedTag + Bottom-edge-of + Right-edge-of + Top-edge-of + + + + Left-side-of + (A, (Left-side-of, B)) means A is located on the left side of B usually as part of B. + + relatedTag + Right-side-of + + + + Lower-center-of + (A, (Lower-center-of, B)) means A is situated on the lower center part of B (due south). This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-left-of + Lower-right-of + Upper-center-of + Upper-right-of + + + + Lower-left-of + (A, (Lower-left-of, B)) means A is situated on the lower left part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-right-of + Upper-center-of + Upper-left-of + Upper-right-of + + + + Lower-right-of + (A, (Lower-right-of, B)) means A is situated on the lower right part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Upper-left-of + Upper-center-of + Upper-left-of + Lower-right-of + + + + Outside-of + (A, (Outside-of, B)) means A is located in the space around but not including B. + + + Over + (A, (Over, B)) means A above is above B so as to cover or protect or A extends over the a general area as from a from a vantage point. + + + Right-edge-of + (A, (Right-edge-of, B)) means A is located on the right side of B on or near the boundary of B. + + relatedTag + Bottom-edge-of + Left-edge-of + Top-edge-of + + + + Right-side-of + (A, (Right-side-of, B)) means A is located on the right side of B usually as part of B. + + relatedTag + Left-side-of + + + + To-left-of + (A, (To-left-of, B)) means A is located on or directed toward the side to the west of B when B is facing north. This term is used when A is not part of B. + + + To-right-of + (A, (To-right-of, B)) means A is located on or directed toward the side to the east of B when B is facing north. This term is used when A is not part of B. + + + Top-edge-of + (A, (Top-edge-of, B)) means A is on the uppermost part or or near the boundary of B. + + relatedTag + Left-edge-of + Right-edge-of + Bottom-edge-of + + + + Top-of + (A, (Top-of, B)) means A is on the uppermost part, side, or surface of B. + + + Upper-center-of + (A, (Upper-center-of, B)) means A is situated on the upper center part of B (due north). This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Lower-right-of + Upper-center-of + Upper-right-of + + + + Upper-left-of + (A, (Upper-left-of, B)) means A is situated on the upper left part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Lower-right-of + Upper-center-of + Upper-right-of + + + + Upper-right-of + (A, (Upper-right-of, B)) means A is situated on the upper right part of B. This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Upper-left-of + Upper-center-of + Lower-right-of + + + + Underneath + (A, (Underneath, B)) means A is situated directly below and may be concealed by B. + + + Within + (A, (Within, B)) means A is on the inside of or contained in B. + + + + Temporal-relation + A relationship that includes a temporal or time-based component. + + After + (A, (After B)) means A happens at a time subsequent to a reference time related to B. + + + Asynchronous-with + (A, (Asynchronous-with, B)) means A happens at times not occurring at the same time or having the same period or phase as B. + + + Before + (A, (Before B)) means A happens at a time earlier in time or order than B. + + + During + (A, (During, B)) means A happens at some point in a given period of time in which B is ongoing. + + + Synchronous-with + (A, (Synchronous-with, B)) means A happens at occurs at the same time or rate as B. + + + Waiting-for + (A, (Waiting-for, B)) means A pauses for something to happen in B. + + + + + + + accelerationUnits + + defaultUnits + m-per-s^2 + + + m-per-s^2 + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + angleUnits + + defaultUnits + radian + + + radian + + SIUnit + + + conversionFactor + 1.0 + + + + rad + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + degree + + conversionFactor + 0.0174533 + + + + + areaUnits + + defaultUnits + m^2 + + + m^2 + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + currencyUnits + Units indicating the worth of something. + + defaultUnits + $ + + + dollar + + conversionFactor + 1.0 + + + + $ + + unitPrefix + + + unitSymbol + + + conversionFactor + 1.0 + + + + euro + + + point + + + + electricPotentialUnits + + defaultUnits + uv + + + v + + SIUnit + + + unitSymbol + + + conversionFactor + 0.000001 + + + + Volt + + SIUnit + + + conversionFactor + 0.000001 + + + + + frequencyUnits + + defaultUnits + Hz + + + hertz + + SIUnit + + + conversionFactor + 1.0 + + + + Hz + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + intensityUnits + + defaultUnits + dB + + + dB + Intensity expressed as ratio to a threshold. May be used for sound intensity. + + unitSymbol + + + conversionFactor + 1.0 + + + + candela + Units used to express light intensity. + + SIUnit + + + + cd + Units used to express light intensity. + + SIUnit + + + unitSymbol + + + + + jerkUnits + + defaultUnits + m-per-s^3 + + + m-per-s^3 + + unitSymbol + + + conversionFactor + 1.0 + + + + + magneticFieldUnits + Units used to magnetic field intensity. + + defaultUnits + fT + + + tesla + + SIUnit + + + conversionFactor + 10^-15 + + + + T + + SIUnit + + + unitSymbol + + + conversionFactor + 10^-15 + + + + + memorySizeUnits + + defaultUnits + B + + + byte + + SIUnit + + + conversionFactor + 1.0 + + + + B + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + physicalLengthUnits + + defaultUnits + m + + + foot + + conversionFactor + 0.3048 + + + + inch + + conversionFactor + 0.0254 + + + + meter + + SIUnit + + + conversionFactor + 1.0 + + + + metre + + SIUnit + + + conversionFactor + 1.0 + + + + m + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + mile + + conversionFactor + 1609.34 + + + + + speedUnits + + defaultUnits + m-per-s + + + m-per-s + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + mph + + unitSymbol + + + conversionFactor + 0.44704 + + + + kph + + unitSymbol + + + conversionFactor + 0.277778 + + + + + temperatureUnits + + degree Celsius + + SIUnit + + + conversionFactor + 1.0 + + + + oC + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + timeUnits + + defaultUnits + s + + + second + + SIUnit + + + conversionFactor + 1.0 + + + + s + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + day + + conversionFactor + 86400 + + + + minute + + conversionFactor + 60 + + + + hour + Should be in 24-hour format. + + conversionFactor + 3600 + + + + + volumeUnits + + defaultUnits + m^3 + + + m^3 + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + + weightUnits + + defaultUnits + g + + + g + + SIUnit + + + unitSymbol + + + conversionFactor + 1.0 + + + + gram + + SIUnit + + + conversionFactor + 1.0 + + + + pound + + conversionFactor + 453.592 + + + + lb + + conversionFactor + 453.592 + + + + + + + deca + SI unit multiple representing 10^1. + + SIUnitModifier + + + conversionFactor + 10.0 + + + + da + SI unit multiple representing 10^1. + + SIUnitSymbolModifier + + + conversionFactor + 10.0 + + + + hecto + SI unit multiple representing 10^2. + + SIUnitModifier + + + conversionFactor + 100.0 + + + + h + SI unit multiple representing 10^2. + + SIUnitSymbolModifier + + + conversionFactor + 100.0 + + + + kilo + SI unit multiple representing 10^3. + + SIUnitModifier + + + conversionFactor + 1000.0 + + + + k + SI unit multiple representing 10^3. + + SIUnitSymbolModifier + + + conversionFactor + 1000.0 + + + + mega + SI unit multiple representing 10^6. + + SIUnitModifier + + + conversionFactor + 10^6 + + + + M + SI unit multiple representing 10^6. + + SIUnitSymbolModifier + + + conversionFactor + 10^6 + + + + giga + SI unit multiple representing 10^9. + + SIUnitModifier + + + conversionFactor + 10^9 + + + + G + SI unit multiple representing 10^9. + + SIUnitSymbolModifier + + + conversionFactor + 10^9 + + + + tera + SI unit multiple representing 10^12. + + SIUnitModifier + + + conversionFactor + 10^12 + + + + T + SI unit multiple representing 10^12. + + SIUnitSymbolModifier + + + conversionFactor + 10^12 + + + + peta + SI unit multiple representing 10^15. + + SIUnitModifier + + + conversionFactor + 10^15 + + + + P + SI unit multiple representing 10^15. + + SIUnitSymbolModifier + + + conversionFactor + 10^15 + + + + exa + SI unit multiple representing 10^18. + + SIUnitModifier + + + conversionFactor + 10^18 + + + + E + SI unit multiple representing 10^18. + + SIUnitSymbolModifier + + + conversionFactor + 10^18 + + + + zetta + SI unit multiple representing 10^21. + + SIUnitModifier + + + conversionFactor + 10^21 + + + + Z + SI unit multiple representing 10^21. + + SIUnitSymbolModifier + + + conversionFactor + 10^21 + + + + yotta + SI unit multiple representing 10^24. + + SIUnitModifier + + + conversionFactor + 10^24 + + + + Y + SI unit multiple representing 10^24. + + SIUnitSymbolModifier + + + conversionFactor + 10^24 + + + + deci + SI unit submultiple representing 10^-1. + + SIUnitModifier + + + conversionFactor + 0.1 + + + + d + SI unit submultiple representing 10^-1. + + SIUnitSymbolModifier + + + conversionFactor + 0.1 + + + + centi + SI unit submultiple representing 10^-2. + + SIUnitModifier + + + conversionFactor + 0.01 + + + + c + SI unit submultiple representing 10^-2. + + SIUnitSymbolModifier + + + conversionFactor + 0.01 + + + + milli + SI unit submultiple representing 10^-3. + + SIUnitModifier + + + conversionFactor + 0.001 + + + + m + SI unit submultiple representing 10^-3. + + SIUnitSymbolModifier + + + conversionFactor + 0.001 + + + + micro + SI unit submultiple representing 10^-6. + + SIUnitModifier + + + conversionFactor + 10^-6 + + + + u + SI unit submultiple representing 10^-6. + + SIUnitSymbolModifier + + + conversionFactor + 10^-6 + + + + nano + SI unit submultiple representing 10^-9. + + SIUnitModifier + + + conversionFactor + 10^-9 + + + + n + SI unit submultiple representing 10^-9. + + SIUnitSymbolModifier + + + conversionFactor + 10^-9 + + + + pico + SI unit submultiple representing 10^-12. + + SIUnitModifier + + + conversionFactor + 10^-12 + + + + p + SI unit submultiple representing 10^-12. + + SIUnitSymbolModifier + + + conversionFactor + 10^-12 + + + + femto + SI unit submultiple representing 10^-15. + + SIUnitModifier + + + conversionFactor + 10^-15 + + + + f + SI unit submultiple representing 10^-15. + + SIUnitSymbolModifier + + + conversionFactor + 10^-15 + + + + atto + SI unit submultiple representing 10^-18. + + SIUnitModifier + + + conversionFactor + 10^-18 + + + + a + SI unit submultiple representing 10^-18. + + SIUnitSymbolModifier + + + conversionFactor + 10^-18 + + + + zepto + SI unit submultiple representing 10^-21. + + SIUnitModifier + + + conversionFactor + 10^-21 + + + + z + SI unit submultiple representing 10^-21. + + SIUnitSymbolModifier + + + conversionFactor + 10^-21 + + + + yocto + SI unit submultiple representing 10^-24. + + SIUnitModifier + + + conversionFactor + 10^-24 + + + + y + SI unit submultiple representing 10^-24. + + SIUnitSymbolModifier + + + conversionFactor + 10^-24 + + + + + + dateTimeClass + Date-times should conform to ISO8601 date-time format YYYY-MM-DDThh:mm:ss. Any variation on the full form is allowed. + + allowedCharacter + digits + T + - + : + + + + nameClass + Value class designating values that have the characteristics of node names. The allowed characters are alphanumeric, hyphen, and underbar. + + allowedCharacter + letters + digits + _ + - + + + + numericClass + Value must be a valid numerical value. + + allowedCharacter + digits + E + e + + + - + . + + + + posixPath + Posix path specification. + + allowedCharacter + digits + letters + / + : + + + + textClass + Value class designating values that have the characteristics of text such as in descriptions. + + allowedCharacter + letters + digits + blank + + + - + : + ; + . + / + ( + ) + ? + * + % + $ + @ + + + + + + allowedCharacter + A schema attribute of value classes specifying a special character that is allowed in expressing the value of a placeholder. Normally the allowed characters are listed individually. However, the word letters designates the upper and lower case alphabetic characters and the word digits designates the digits 0-9. The word blank designates the blank character. + + valueClassProperty + + + + conversionFactor + The multiplicative factor to multiply these units to convert to default units. + + unitProperty + + + unitModifierProperty + + + + deprecatedFrom + Indicates that this element is deprecated. The value of the attribute is the latest schema version in which the element appeared in undeprecated form. + + elementProperty + + + + defaultUnits + A schema attribute of unit classes specifying the default units to use if the placeholder has a unit class but the substituted value has no units. + + unitClassProperty + + + + extensionAllowed + A schema attribute indicating that users can add unlimited levels of child nodes under this tag. This tag is propagated to child nodes with the exception of the hashtag placeholders. + + boolProperty + + + nodeProperty + + + isInheritedProperty + + + + inLibrary + Indicates this schema element came from the named library schema, not the standard schema. This attribute is added by tools when a library schema is merged into its partnered standard schema. + + elementProperty + + + + recommended + A schema attribute indicating that the event-level HED string should include this tag. + + boolProperty + + + nodeProperty + + + + relatedTag + A schema attribute suggesting HED tags that are closely related to this tag. This attribute is used by tagging tools. + + nodeProperty + + + isInheritedProperty + + + + requireChild + A schema attribute indicating that one of the node elements descendants must be included when using this tag. + + boolProperty + + + nodeProperty + + + + required + A schema attribute indicating that every event-level HED string should include this tag. + + boolProperty + + + nodeProperty + + + + reserved + A schema attribute indicating that this tag has special meaning and requires special handling by tools. + + boolProperty + + + nodeProperty + + + + rooted + Indicates a top-level library schema node is identical to a node of the same name in the partnered standard schema. This attribute can only appear in nodes that have the inLibrary schema attribute. + + nodeProperty + + + + SIUnit + A schema attribute indicating that this unit element is an SI unit and can be modified by multiple and submultiple names. Note that some units such as byte are designated as SI units although they are not part of the standard. + + boolProperty + + + unitProperty + + + + SIUnitModifier + A schema attribute indicating that this SI unit modifier represents a multiple or submultiple of a base unit rather than a unit symbol. + + boolProperty + + + unitModifierProperty + + + + SIUnitSymbolModifier + A schema attribute indicating that this SI unit modifier represents a multiple or submultiple of a unit symbol rather than a base symbol. + + boolProperty + + + unitModifierProperty + + + + suggestedTag + A schema attribute that indicates another tag that is often associated with this tag. This attribute is used by tagging tools to provide tagging suggestions. + + nodeProperty + + + isInheritedProperty + + + + tagGroup + A schema attribute indicating the tag can only appear inside a tag group. + + boolProperty + + + nodeProperty + + + + takesValue + A schema attribute indicating the tag is a hashtag placeholder that is expected to be replaced with a user-defined value. + + boolProperty + + + nodeProperty + + + + topLevelTagGroup + A schema attribute indicating that this tag (or its descendants) can only appear in a top-level tag group. A tag group can have at most one tag with this attribute. + + boolProperty + + + nodeProperty + + + + unique + A schema attribute indicating that only one of this tag or its descendants can be used in the event-level HED string. + + boolProperty + + + nodeProperty + + + + unitClass + A schema attribute specifying which unit class this value tag belongs to. + + nodeProperty + + + + unitPrefix + A schema attribute applied specifically to unit elements to designate that the unit indicator is a prefix (e.g., dollar sign in the currency units). + + boolProperty + + + unitProperty + + + + unitSymbol + A schema attribute indicating this tag is an abbreviation or symbol representing a type of unit. Unit symbols represent both the singular and the plural and thus cannot be pluralized. + + boolProperty + + + unitProperty + + + + valueClass + A schema attribute specifying which value class this value tag belongs to. + + nodeProperty + + + + + + boolProperty + Indicates that the schema attribute represents something that is either true or false and does not have a value. Attributes without this value are assumed to have string values. + + + elementProperty + Indicates this schema attribute can apply to any type of element(tag term, unit class, etc). + + + isInheritedProperty + Indicates that this attribute is inherited by child nodes. This property only applies to schema attributes for nodes. + + + nodeProperty + Indicates this schema attribute applies to node (tag-term) elements. This was added to allow for an attribute to apply to multiple elements. + + + unitClassProperty + Indicates that the schema attribute is meant to be applied to unit classes. + + + unitModifierProperty + Indicates that the schema attribute is meant to be applied to unit modifier classes. + + + unitProperty + Indicates that the schema attribute is meant to be applied to units within a unit class. + + + valueClassProperty + Indicates that the schema attribute is meant to be applied to value classes. + + + This schema is released under the Creative Commons Attribution 4.0 International and is a product of the HED Working Group. The DOI for the latest version of the HED standard schema is 10.5281/zenodo.7876037. + + diff --git a/hedxml/HEDLatest.xml b/hedxml/HEDLatest.xml index f5b7cfc..1f55c7a 100644 --- a/hedxml/HEDLatest.xml +++ b/hedxml/HEDLatest.xml @@ -1,6 +1,8 @@ - - This schema includes an xsd and requires unit class, unit modifier, value class, schema attribute and property sections. + + The HED standard schema is a hierarchically-organized vocabulary for annotating events and experimental structure. HED annotations consist of comma-separated tags drawn from this vocabulary. This vocabulary can be augmented by terms drawn from specialized library schema. + +Each term in this vocabulary has a human-readable description and may include additional attributes that give additional properties or that specify how tools should treat the tag during analysis. The meaning of these attributes is described in the Additional schema properties section. @@ -932,6 +934,10 @@ Gentalia The external organs of reproduction. + + deprecatedFrom + 8.1.0 + Hip @@ -2089,6 +2095,10 @@ Having genitalia and/or secondary sexual characteristics of indeterminate sex. + + Ethnicity + Belong to a social group that has a common national or cultural tradition. Use with Label to avoid extension. + Handedness Individual preference for use of a hand, known as the dominant hand. @@ -2105,6 +2115,10 @@ Having no overall dominance in the use of right or left hand or foot in the performance of tasks that require one hand or foot. + + Race + Belonging to a group sharing physical or social qualities as defined within a specified society. Use with Label to avoid extension. + @@ -2123,19 +2137,50 @@ Temporal-marker An indicator placed at a particular time in the data. + + Inset + Marks an intermediate point in an ongoing event of temporal extent. + + topLevelTagGroup + + + reserved + + + relatedTag + Onset + Offset + + Onset - Labels the start or beginning of something, usually an event. + Marks the start of an ongoing event of temporal extent. topLevelTagGroup + + reserved + + + relatedTag + Inset + Offset + Offset - Labels the time at which something stops. + Marks the end of an event of temporal extent. topLevelTagGroup + + reserved + + + relatedTag + Onset + Inset + Pause @@ -3412,7 +3457,17 @@ A characteristic of or relating to time or limited by time. Delay - Time during which some action is awaited. + The time at which an event start time is delayed from the current onset time. This tag defines the start time of an event of temporal extent and may be used with the Duration tag. + + topLevelTagGroup + + + reserved + + + relatedTag + Duration + # @@ -3430,7 +3485,17 @@ Duration - The period of time during which something occurs or continues. + The period of time during which an event occurs. This tag defines the end time of an event of temporal extent and may be used with the Delay tag. + + topLevelTagGroup + + + reserved + + + relatedTag + Delay + # @@ -3929,6 +3994,9 @@ requireChild + + reserved + # Name of the definition. @@ -3947,6 +4015,9 @@ requireChild + + reserved + tagGroup @@ -3967,6 +4038,9 @@ requireChild + + reserved + topLevelTagGroup @@ -3985,6 +4059,9 @@ Event-context A special HED tag inserted as part of a top-level tag group to contain information about the interrelated conditions under which the event occurs. The event context includes information about other events that are ongoing when this event happens. + + reserved + topLevelTagGroup @@ -5544,7 +5621,7 @@ Comparative-relation - Something considered in comparison to something else. The first argument is the focus. + Something considered in comparison to something else. The first entity is the focus. Approximately-equal-to (A, (Approximately-equal-to, B)) indicates that A and B have almost the same value. Here A and B could refer to sizes, orders, positions or other quantities. @@ -5576,7 +5653,7 @@ Connective-relation - Indicates two items are related in some way. + Indicates two entities are related in some way. The first entity is the focus. Belongs-to (A, (Belongs-to, B)) indicates that A is a member of B. @@ -5627,7 +5704,7 @@ Performed-using - A, (Performed-using, B)) indicates that the action or procedure A was accomplished using B. + (A, (Performed-using, B)) indicates that the action or procedure A was accomplished using B. Related-to @@ -5640,7 +5717,7 @@ Directional-relation - A relationship indicating direction of change. + A relationship indicating direction of change of one entity relative to another. The first entity is the focus. Away-from (A, (Away-from, B)) indicates that A is going or has moved away from B. The meaning depends on A and B. @@ -5650,9 +5727,21 @@ (A, (Towards, B)) indicates that A is going to or has moved to B. The meaning depends on A and B. + + Logical-relation + Indicating a logical relationship between entities. The first entity is usually the focus. + + And + (A, (And, B)) means A and B are both in effect. + + + Or + (A, (Or, B)) means at least one of A and B are in effect. + + Spatial-relation - Indicating information about position. + Indicating a relationship about position between entities. Above (A, (Above, B)) means A is in a place or position that is higher than B. @@ -5737,12 +5826,27 @@ Right-side-of + + Lower-center-of + (A, (Lower-center-of, B)) means A is situated on the lower center part of B (due south). This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-left-of + Lower-right-of + Upper-center-of + Upper-right-of + + Lower-left-of (A, (Lower-left-of, B)) means A is situated on the lower left part of B. This relation is often used to specify qualitative information about screen position. relatedTag + Center-of + Lower-center-of Lower-right-of + Upper-center-of Upper-left-of Upper-right-of @@ -5752,7 +5856,11 @@ (A, (Lower-right-of, B)) means A is situated on the lower right part of B. This relation is often used to specify qualitative information about screen position. relatedTag + Center-of + Lower-center-of + Lower-left-of Upper-left-of + Upper-center-of Upper-left-of Lower-right-of @@ -5805,13 +5913,29 @@ Top-of (A, (Top-of, B)) means A is on the uppermost part, side, or surface of B. + + Upper-center-of + (A, (Upper-center-of, B)) means A is situated on the upper center part of B (due north). This relation is often used to specify qualitative information about screen position. + + relatedTag + Center-of + Lower-center-of + Lower-left-of + Lower-right-of + Upper-center-of + Upper-right-of + + Upper-left-of (A, (Upper-left-of, B)) means A is situated on the upper left part of B. This relation is often used to specify qualitative information about screen position. relatedTag + Center-of + Lower-center-of Lower-left-of Lower-right-of + Upper-center-of Upper-right-of @@ -5820,8 +5944,11 @@ (A, (Upper-right-of, B)) means A is situated on the upper right part of B. This relation is often used to specify qualitative information about screen position. relatedTag + Center-of + Lower-center-of Lower-left-of Upper-left-of + Upper-center-of Lower-right-of @@ -5836,7 +5963,7 @@ Temporal-relation - Any relationship which includes a temporal or time-based component. + A relationship that includes a temporal or time-based component. After (A, (After B)) means A happens at a time subsequent to a reference time related to B. @@ -6169,6 +6296,16 @@ 0.0254 + + meter + + SIUnit + + + conversionFactor + 1.0 + + metre @@ -6914,6 +7051,13 @@ unitModifierProperty + + deprecatedFrom + Indicates that this element is deprecated. The value of the attribute is the latest schema version in which the element appeared in undeprecated form. + + elementProperty + + defaultUnits A schema attribute of unit classes specifying the default units to use if the placeholder has a unit class but the substituted value has no units. @@ -6927,6 +7071,19 @@ boolProperty + + nodeProperty + + + isInheritedProperty + + + + inLibrary + Indicates this schema element came from the named library schema, not the standard schema. This attribute is added by tools when a library schema is merged into its partnered standard schema. + + elementProperty + recommended @@ -6934,10 +7091,19 @@ boolProperty + + nodeProperty + relatedTag A schema attribute suggesting HED tags that are closely related to this tag. This attribute is used by tagging tools. + + nodeProperty + + + isInheritedProperty + requireChild @@ -6945,6 +7111,9 @@ boolProperty + + nodeProperty + required @@ -6952,6 +7121,26 @@ boolProperty + + nodeProperty + + + + reserved + A schema attribute indicating that this tag has special meaning and requires special handling by tools. + + boolProperty + + + nodeProperty + + + + rooted + Indicates a top-level library schema node is identical to a node of the same name in the partnered standard schema. This attribute can only appear in nodes that have the inLibrary schema attribute. + + nodeProperty + SIUnit @@ -6986,6 +7175,12 @@ suggestedTag A schema attribute that indicates another tag that is often associated with this tag. This attribute is used by tagging tools to provide tagging suggestions. + + nodeProperty + + + isInheritedProperty + tagGroup @@ -6993,6 +7188,9 @@ boolProperty + + nodeProperty + takesValue @@ -7000,6 +7198,9 @@ boolProperty + + nodeProperty + topLevelTagGroup @@ -7007,6 +7208,9 @@ boolProperty + + nodeProperty + unique @@ -7014,10 +7218,16 @@ boolProperty + + nodeProperty + unitClass A schema attribute specifying which unit class this value tag belongs to. + + nodeProperty + unitPrefix @@ -7042,6 +7252,9 @@ valueClass A schema attribute specifying which value class this value tag belongs to. + + nodeProperty + @@ -7049,6 +7262,18 @@ boolProperty Indicates that the schema attribute represents something that is either true or false and does not have a value. Attributes without this value are assumed to have string values. + + elementProperty + Indicates this schema attribute can apply to any type of element(tag term, unit class, etc). + + + isInheritedProperty + Indicates that this attribute is inherited by child nodes. This property only applies to schema attributes for nodes. + + + nodeProperty + Indicates this schema attribute applies to node (tag-term) elements. This was added to allow for an attribute to apply to multiple elements. + unitClassProperty Indicates that the schema attribute is meant to be applied to unit classes. @@ -7066,7 +7291,6 @@ Indicates that the schema attribute is meant to be applied to value classes. - This is an updated version of the schema format. The properties are now part of the schema. The schema attributes are designed to be checked in software rather than hard-coded. The schema attributes, themselves have properties. - + This schema is released under the Creative Commons Attribution 4.0 International and is a product of the HED Working Group. The DOI for the latest version of the HED standard schema is 10.5281/zenodo.7876037. diff --git a/readthedocs.yml b/readthedocs.yml index 74423ca..5bfa491 100644 --- a/readthedocs.yml +++ b/readthedocs.yml @@ -15,7 +15,6 @@ sphinx: # Optionally set the version of Python and requirements required to _build your docs python: - version: "3.7" install: - requirements: docs/requirements.txt system_packages: true \ No newline at end of file diff --git a/tests/json_tests/CHARACTER_INVALID.json b/tests/json_tests/CHARACTER_INVALID.json index d2bfdf5..8b88238 100644 --- a/tests/json_tests/CHARACTER_INVALID.json +++ b/tests/json_tests/CHARACTER_INVALID.json @@ -86,5 +86,40 @@ ] } } + }, + { + "error_code": "CHARACTER_INVALID", + "name": "curly-braces-not-in-sidecar", + "description": "The curly brace notation is used outside of a sidecar.", + "schema": "8.1.0", + "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], + "tests": { + "string_tests": { + "fails": [ + "{col_1}, Red" + ], + "passes": [ + "Red, Blue, Description/Red" + ] + }, + "sidecar_tests": { + }, + "event_tests": { + "fails": [ + [ + ["onset", "duration", "HED"], + [ 4.5, 0, "{who_knows}, Red"] + ] + ], + "passes": [ + [ + ["onset", "duration", "HED"], + [ 4.5, 0, "Label/Temp"] + ] + ] + }, + "combo_tests": { + } + } } -] \ No newline at end of file + ] \ No newline at end of file diff --git a/tests/json_tests/ONSET_OFFSET_ERROR.json b/tests/json_tests/ONSET_OFFSET_INSET_ERROR.json similarity index 76% rename from tests/json_tests/ONSET_OFFSET_ERROR.json rename to tests/json_tests/ONSET_OFFSET_INSET_ERROR.json index c90c180..e47ad7b 100644 --- a/tests/json_tests/ONSET_OFFSET_ERROR.json +++ b/tests/json_tests/ONSET_OFFSET_INSET_ERROR.json @@ -1,9 +1,9 @@ [ { - "error_code": "ONSET_OFFSET_ERROR", + "error_code": "ONSET_OFFSET_INSET_ERROR", "name": "onset-offset-error-not-tag-group", "description": "An Onset or Offset tag does not appear in a tag group.", - "schema": "8.1.0", + "schema": "8.2.0", "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], "tests": { "string_tests": { @@ -65,7 +65,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code", "HED"], [ 4.5, 0, "ball", "Onset, Red"], @@ -83,7 +83,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code", "HED"], [ 5.5, 0, "n/a","(Onset, Def/Acc/5.4 m-per-s^2)"], @@ -97,10 +97,10 @@ } }, { - "error_code": "ONSET_OFFSET_ERROR", + "error_code": "ONSET_OFFSET_INSET_ERROR", "name": "onset-offset-error-nested-group", "description": "An Onset or Offset tag appears in a nested tag group (not a top-level tag group).", - "schema": "8.1.0", + "schema": "8.2.0", "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], "tests": { "string_tests": { @@ -155,7 +155,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code", "HED"], [ 4.5, 0, "n/a", "((Onset, Def/MyColor), Red)"], @@ -172,7 +172,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code","HED"], [ 4.5, 0, "face", "Blue"], @@ -184,10 +184,10 @@ } }, { - "error_code": "ONSET_OFFSET_ERROR", + "error_code": "ONSET_OFFSET_INSET_ERROR", "name": "onset-offset-error-wrong-number-of-defs", "description": "An Onset or Offset tag is not grouped with exactly one Def-expand tag group or a Def tag.", - "schema": "8.1.0", + "schema": "8.2.0", "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], "tests": { "string_tests": { @@ -246,7 +246,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code", "HED"], [ 4.5, 0, "face", "Green, Def/MyColor"], @@ -264,7 +264,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code","HED"], [ 4.5, 0, "face", "Blue"], @@ -276,10 +276,10 @@ } }, { - "error_code": "ONSET_OFFSET_ERROR", + "error_code": "ONSET_OFFSET_INSET_ERROR", "name": "onset-error-onset-has-more-groups", "description": "An Onset group has more than one additional tag group.", - "schema": "8.1.0", + "schema": "8.2.0", "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], "tests": { "string_tests": { @@ -341,7 +341,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code","HED"], [ 4.5, 0, "face", "Red, Def/MyColor"], @@ -360,7 +360,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code","HED"], [ 4.5, 0, "face", "((Def-expand/MyColor, (Label/Pie)), (Green, (Yellow)), Onset)"], @@ -372,10 +372,10 @@ } }, { - "error_code": "ONSET_OFFSET_ERROR", + "error_code": "ONSET_OFFSET_INSET_ERROR", "name": "onset-offset-error-offset-has-groups", "description": "An Offset appears with one or more tags or additional tag groups.", - "schema": "8.1.0", + "schema": "8.2.0", "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], "tests": { "string_tests": { @@ -396,7 +396,7 @@ "ball": "((Def-expand/MyColor, (Label/Pie)), Onset)", "square": "(Offset, Def/MyColor, (Red))", "circle": "((Def-expand/MyColor, (Label/Pie)), Offset, Blue)" - + } } } @@ -444,11 +444,11 @@ "ball": "((Def-expand/MyColor, (Label/Pie)), Onset)", "square": "(Offset, Def/MyColor, (Red))", "circle": "((Def-expand/MyColor, (Label/Pie)), Offset, Blue)" - + } } }, - "events": + "events": [ ["onset", "duration", "event_code", "HED"], [ 4.5, 0, "face", "n/a"], @@ -470,7 +470,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code", "HED"], [ 4.5, 0, "face", "n/a"], @@ -484,10 +484,10 @@ } }, { - "error_code": "ONSET_OFFSET_ERROR", + "error_code": "ONSET_OFFSET_INSET_ERROR", "name": "onset-offset-error-mismatch", "description": "An Offset tag associated with a given definition appears after a previous Offset tag without the appearance of an intervening Onset of the same name.", - "schema": "8.1.0", + "schema": "8.2.0", "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], "tests": { "string_tests": { @@ -531,7 +531,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code", "HED"], [ 4.5, 0, "ball", "Red, Blue"], @@ -550,7 +550,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code", "HED"], [ 4.5, 0, "face", "Blue"], @@ -562,10 +562,10 @@ } }, { - "error_code": "ONSET_OFFSET_ERROR", + "error_code": "ONSET_OFFSET_INSET_ERROR", "name": "onset-offset-error-extra tags", "description": "An Onset tag group with has tags besides the anchor Def or Def-expand that are not in a tag group.", - "schema": "8.1.0", + "schema": "8.2.0", "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], "tests": { "string_tests": { @@ -621,7 +621,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code","HED"], [ 4.5, 0, "face", "Red, Def/MyColor"], @@ -639,7 +639,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code","HED"], [ 4.5, 0, "face", "Blue"], @@ -650,11 +650,11 @@ } } }, - { - "error_code": "ONSET_OFFSET_ERROR", + { + "error_code": "ONSET_OFFSET_INSET_ERROR", "name": "onset-offset-error-duplicated-onset-or-offset", "description": "An Onset or an Offset with a given Def or Def-expand anchor appears in the same event marker with another Onset or Offset that uses the same anchor.", - "schema": "8.1.0", + "schema": "8.2.0", "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], "tests": { "string_tests": { @@ -686,7 +686,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code","HED"], [ 4.5, 0, "face", "(Def/MyColor, (Blue), Onset)"], @@ -702,7 +702,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code","HED"], [ 4.5, 0, "face", "(Def/MyColor, Offset)"], @@ -718,7 +718,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code","HED"], [ 4.5, 0, "face", "(Def/MyColor, Offset)"], @@ -736,7 +736,7 @@ } } }, - "events": + "events": [ ["onset", "duration", "event_code","HED"], [ 4.5, 0, "face", "Blue"], @@ -746,5 +746,170 @@ ] } } + }, + { + "error_code": "ONSET_OFFSET_INSET_ERROR", + "name": "inset-outside-its-event", + "description": "An Inset tag is not grouped with a Def or Def-expand of an ongoing Onset.", + "schema": "8.2.0", + "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], + "tests": { + "string_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "sidecar_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "event_tests": { + "fails": [ + [ + ["onset", "duration", "HED"], + [ 4.5, 0, "(Def/MyColor, Offset)"], + [ 6.5, 0, "Red, (Def/MyColor, Offset)"], + [ 5.5, 0, "(Def/MyColor, Offset)"] + ] + ], + "passes": [ + [ + ["onset", "duration", "HED"], + [ 4.5, 0, "(Def/MyColor, Onset)"], + [ 5.5, 0, "(Def/MyColor, Offset)"], + [ 6.5, 0, "Red"] + ] + ] + }, + "combo_tests": { + "fails": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Def/MyColor, Onset)", + "ball": "(Def/MyColor, Offset)", + "snack": "(Def/MyColor, Inset)" + } + } + }, + "events": + [ + ["onset", "duration", "event_code", "HED"], + [ 4.5, 0, "snack", "Red, Blue"], + [ 4.8, 0, "face", "Red, Blue"], + [ 5.0, 0, "face", "Green"] + ] + } + ], + "passes": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Def/MyColor, Onset)", + "ball": "(Def/MyColor, Offset)", + "snack": "(Def/MyColor, Inset)" + } + } + }, + "events": + [ + ["onset", "duration", "event_code", "HED"], + [ 4.5, 0, "face", "Blue"], + [ 4.8, 0, "snack", "Blue"], + [ 5.0, 0, "ball", "Green, Def/MyColor"] + ] + } + ] + } + } + }, + { + "error_code": "ONSET_OFFSET_INSET_ERROR", + "name": "inset-group-has-extras", + "description": "An Inset group has tags or groups in addition to its defining Def or Def-expand.", + "schema": "8.2.0", + "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], + "tests": { + "string_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "sidecar_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "event_tests": { + "fails": [ + [ + ["onset", "duration", "HED"], + [ 2.5, 0, "Red, (Def/MyColor, Onset)"], + [ 4.5, 0, "(Def/MyColor, Blue, Inset)"], + [ 6.5, 0, "Red, (Def/MyColor, Onset)"], + [ 5.5, 0, "(Def/MyColor, Offset)"] + ] + ], + "passes": [ + [ + ["onset", "duration", "HED"], + [ 4.5, 0, "(Def/MyColor, (Blue), Onset)"], + [ 4.8, 0, "(Def/MyColor, (Green), Inset)"], + [ 5.5, 0, "(Def/MyColor, Offset)"], + [ 6.5, 0, "Red"] + ] + ] + }, + "combo_tests": { + "fails": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Def/MyColor, Onset)", + "ball": "(Def/MyColor, Offset)", + "snack": "(Def/MyColor, Inset)" + } + } + }, + "events": + [ + ["onset", "duration", "event_code", "HED"], + [ 4.5, 0, "snack", "Red, Blue"], + [ 4.8, 0, "face", "Red, Blue"], + [ 5.0, 0, "face", "Green"] + ] + } + ], + "passes": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Def/MyColor, Onset)", + "ball": "(Def/MyColor, Offset)", + "snack": "(Def/MyColor, Inset)" + } + } + }, + "events": + [ + ["onset", "duration", "event_code", "HED"], + [ 4.5, 0, "face", "Blue"], + [ 4.5, 0, "face", "Blue"], + [ 4.8, 0, "snack", "Blue"], + [ 5.0, 0, "ball", "Green, Def/MyColor"] + ] + } + ] + } + } } ] \ No newline at end of file diff --git a/tests/json_tests/SCHEMA_LIBRARY_INVALID.json b/tests/json_tests/SCHEMA_LIBRARY_INVALID.json new file mode 100644 index 0000000..3f7630a --- /dev/null +++ b/tests/json_tests/SCHEMA_LIBRARY_INVALID.json @@ -0,0 +1,269 @@ +[ + { + "error_code": "SCHEMA_LIBRARY_INVALID", + "name": "library-invalid-bad-name", + "warning": true, + "description": "A schema library issue, indicating the name is invalid.", + "schema": "", + "definitions": [], + "tests": { + "schema_tests": { + "fails": [ + [ + "HED version=\"1.0.0\" library=\"score_invalidchar\" withStandard=\"8.2.0\" unmerged=\"True\"" + ], + [ + "HED version=\"1.0.0\" library=\"score1\" withStandard=\"8.2.0\" unmerged=\"True\"" + ], + [ + "HED version=\"1.0.0\" library=\"Score\" withStandard=\"8.2.0\" unmerged=\"True\"" + ] + ], + "passes": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "!# end schema", + "!# end hed" + ] + ] + } + } + }, + { + "error_code": "SCHEMA_LIBRARY_INVALID", + "name": "library-invalid-bad_with-standard", + "warning": true, + "description": "A schema library issue, the with-standard attribute is present without the library attribute.", + "schema": "", + "definitions": [], + "tests": { + "schema_tests": { + "fails": [ + [ + "HED version=\"1.0.0\" withStandard=\"8.2.0\" unmerged=\"True\"" + ], + [ + "HED version=\"1.0.0\" withStandard=\"8.2.0\"" + ] + ], + "passes": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "!# end schema", + "!# end hed" + ] + ] + } + } + }, + { + "error_code": "SCHEMA_LIBRARY_INVALID", + "name": "library-invalid-bad_with-standard-version", + "warning": true, + "description": "A schema library issue, indicating it references a version of the standard that can't be found.", + "schema": "", + "definitions": [], + "tests": { + "schema_tests": { + "fails": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.9.9\" unmerged=\"True\"" + ], + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"7.9.9\" unmerged=\"True\"" + ] + ], + "passes": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "!# end schema", + "!# end hed" + ] + ] + } + } + }, + { + "error_code": "SCHEMA_LIBRARY_INVALID", + "name": "library-invalid-rooted-present", + "warning": true, + "description": "A schema library issue, indicating the rooted property appears in a file it shouldn't.", + "schema": "", + "definitions": [], + "tests": { + "schema_tests": { + "fails": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\"", + "!# start schema", + "'''Event''' {rooted}", + "!# end schema", + "!# end hed" + ], + [ + "HED version=\"1.0.0\"", + "!# start schema", + "'''Event''' {rooted}", + "!# end schema", + "'''Schema attributes'''", + "* rooted {nodeProperty} ", + "'''Properties'''", + "* nodeProperty", + "!# end hed" + ] + ], + "passes": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "'''Event''' {rooted}", + "!# end schema", + "!# end hed" + ] + ] + } + } + }, + { + "error_code": "SCHEMA_LIBRARY_INVALID", + "name": "library-invalid-rooted-not-top-level", + "warning": true, + "description": "A schema library issue, indicating a node is being rooted that is not a top level node.", + "schema": "", + "definitions": [], + "tests": { + "schema_tests": { + "fails": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "'''NewNode'''", + "* NewExtension {rooted}", + "!# end schema", + "!# end hed" + ] + ], + "passes": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "'''Event''' {rooted}", + "!# end schema", + "!# end hed" + ] + ] + } + } + }, + { + "error_code": "SCHEMA_LIBRARY_INVALID", + "name": "library-invalid-rooted-not-in-base", + "warning": true, + "description": "A schema library issue, rooted tag does not exist.", + "schema": "", + "definitions": [], + "tests": { + "schema_tests": { + "fails": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "'''DummyTag'''", + "'''DummyTag'''{rooted}", + "!# end schema", + "!# end hed" + ], + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "'''DummyTag'''{rooted}", + "!# end schema", + "!# end hed" + ] + ], + "passes": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "'''Event''' {rooted}", + "!# end schema", + "!# end hed" + ] + ] + } + } + }, + { + "error_code": "SCHEMA_LIBRARY_INVALID", + "name": "library-invalid-rooted-in-library-present", + "warning": true, + "description": "A schema library issue, indicating the InLibrary attribute appears when it shouldn't.", + "schema": "", + "definitions": [], + "tests": { + "schema_tests": { + "fails": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "'''Event''' {rooted}", + "* ExtendedEvent {inLibrary=\"score\"}", + "!# end schema", + "!# end hed" + ] + ], + "passes": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "'''Event''' {rooted}", + "* ExtendedEvent", + "!# end schema", + "!# end hed" + ] + ] + } + } + }, + { + "error_code": "SCHEMA_LIBRARY_INVALID", + "name": "library-invalid-rooted-in-duplicate-other", + "warning": true, + "description": "A schema library issue, indicating the InLibrary attribute appears when it shouldn't.", + "schema": "", + "definitions": [], + "tests": { + "schema_tests": { + "fails": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "'''Event''' {rooted}", + "* ExtendedEvent", + "!# end schema", + "'''Unit classes'''", + "* weightUnits", + "** g {SIUnit, unitSymbol, conversionFactor=1.0}", + "!# end hed" + ] + ], + "passes": [ + [ + "HED version=\"1.0.0\" library=\"score\" withStandard=\"8.2.0\" unmerged=\"True\"", + "!# start schema", + "'''Event''' {rooted}", + "* ExtendedEvent", + "!# end schema", + "'''Unit classes'''", + "* weightUnits", + "** testNewUnit {conversionFactor=10.0}", + "!# end hed" + ] + ] + } + } + } +] \ No newline at end of file diff --git a/tests/json_tests/SIDECAR_BRACES_INVALID.json b/tests/json_tests/SIDECAR_BRACES_INVALID.json new file mode 100644 index 0000000..025c16f --- /dev/null +++ b/tests/json_tests/SIDECAR_BRACES_INVALID.json @@ -0,0 +1,548 @@ +[ + { + "error_code": "SIDECAR_BRACES_INVALID", + "name": "sidecar-braces-contents-invalid", + "description": "The item in curly braces is not the word HED or a column name with HED annotations in the sidecar.", + "schema": "8.1.0", + "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], + "tests": { + "string_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "sidecar_tests": { + "fails": [ + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description but no HED" + } + }, + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_action": { + "Description": "Does not correspond to curly braces" + } + } + ], + "passes": [ + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#" + } + }, + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "{HED}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_action": { + "Description": "Does not correspond to curly braces" + } + } + ] + }, + "event_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "combo_tests": { + "fails": [ + ], + "passes": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow)), ({HED})", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#" + } + }, + "events": + [ + ["onset", "duration", "event_code","HED", "response_time"], + [ 4.5, 0, "face", "Blue", 0], + [ 5.0, 0, "ball", "Green, Def/MyColor", 1], + [ 5.0, 0, "face", "", 2], + [ 5.0, 0, "face", "n/a", 3] + ] + } + ] + } + } + }, + { + "error_code": "SIDECAR_BRACES_INVALID", + "name": "sidecar-braces-circular-reference", + "description": "The item in curly braces has a HED annotation that contains curly braces.", + "schema": "8.2.0", + "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], + "tests": { + "string_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "sidecar_tests": { + "fails": [ + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow)), {HED}", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "HED": "Label/#, {event_code}" + } + }, + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow)), {HED}", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)", + "dog": "Orange, {event_type}" + } + }, + "response_time": { + "HED": "Label/#" + }, + "event_type": { + "HED": { + "banana": "Blue, {response_time}", + "apple": "Green" + } + } + } + ], + "passes": [ + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#" + }, + "response_count": { + "Description": "A count used to test curly braces in value columns.", + "HED": "(Item-count/#, {response_time})" + } + }, + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "{HED}, (Def/Acc/3.5 m-per-s^2, {response_action})" + } + }, + "response_action": { + "Description": "Does not correspond to curly braces", + "HED": "Label/#" + } + } + ] + }, + "event_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "combo_tests": { + "fails": [ + ], + "passes": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow)), ({HED})", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#" + } + }, + "events": + [ + ["onset", "duration", "response_time", "event_code","HED"], + [ 4.5, 0, 3.4, "face", "Blue"], + [ 5.0, 0, 6.8, "ball", "Green, Def/MyColor"], + [ 5.0, 0, "n/a", "face", ""], + [ 5.0, 0, "any", "face", "n/a"] + ] + } + ] + } + } + }, + { + "error_code": "SIDECAR_BRACES_INVALID", + "name": "sidecar-braces-self-reference", + "description": "The item in curly braces has a HED annotation that contains itself.", + "schema": "8.2.0", + "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], + "tests": { + "string_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "sidecar_tests": { + "fails": [ + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow)), {HED}", + "ball": "{HED}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "HED": "Label/#, {response_time}" + } + } + ], + "passes": [ + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#" + }, + "response_count": { + "Description": "A count used to test curly braces in value columns.", + "HED": "(Item-count/#, {response_time})" + } + }, + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "{HED}, (Def/Acc/3.5 m-per-s^2, {response_action})" + } + }, + "response_action": { + "Description": "Does not correspond to curly braces", + "HED": "Label/#" + } + } + ] + }, + "event_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "combo_tests": { + "fails": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow)), ({HED})", + "ball": "{HED}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#, {response_time}" + } + }, + "events": + [ + ["onset", "duration", "response_time", "event_code","HED"], + [ 4.5, 0, 3.4, "face", "Blue"], + [ 5.0, 0, 6.8, "ball", "Green, Def/MyColor"], + [ 5.0, 0, "n/a", "face", ""], + [ 5.0, 0, "any", "face", "n/a"] + ] + } + ], + "passes": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow)), ({HED})", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#" + } + }, + "events": + [ + ["onset", "duration", "response_time", "event_code","HED"], + [ 4.5, 0, 3.4, "face", "Blue"], + [ 5.0, 0, 6.8, "ball", "Green, Def/MyColor"], + [ 5.0, 0, "n/a", "face", ""], + [ 5.0, 0, "any", "face", "n/a"] + ] + } + ] + } + } + }, + { + "error_code": "SIDECAR_BRACES_INVALID", + "name": "sidecar-braces-nested-or-mismatched", + "description": "The curly braces in the sidecar are mismatched or nested.", + "schema": "8.1.0", + "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], + "tests": { + "string_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "sidecar_tests": { + "fails": [ + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "{response_time}{, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description but no HED", + "HED": "Label/#" + } + }, + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "{{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description but no HED", + "HED": "Label/#" + } + }, + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "{{response_time}}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description but no HED", + "HED": "Label/#" + } + } + ], + "passes": [ + { + "event_code": { + "HED": { + "face": "(Red, Blue), ({response_time}, (Green, (Yellow)))", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#" + } + }, + { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow))", + "ball": "({HED}, (Def/Acc/3.5 m-per-s^2))" + } + }, + "response_action": { + "Description": "Does not correspond to curly braces" + } + } + ] + }, + "event_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "combo_tests": { + "fails": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow)), ({HED})", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#" + } + }, + "events": + [ + ["onset", "duration", "event_code","HED"], + [ 4.5, 0, "face", "Blue"], + [ 5.0, 0, "ball", "Green, Def/MyColor"], + [ 5.0, 0, "face", ""], + [ 5.0, 0, "face", "n/a"] + ] + } + ], + "passes": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow)), ({HED})", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#" + } + }, + "events": + [ + ["onset", "duration", "event_code","HED", "response_time"], + [ 4.5, 0, "face", "Blue", 1], + [ 5.0, 0, "ball", "Green, Def/MyColor", 1], + [ 5.0, 0, "face", "", 1], + [ 5.0, 0, "face", "n/a", 1] + ] + } + ] + } + } + }, + { + "error_code": "INVALID_CHARACTER", + "name": "sidecar-braces-in-events-file", + "description": "The curly braces in the sidecar are mismatched or nested.", + "schema": "8.1.0", + "definitions": ["(Definition/Acc/#, (Acceleration/#, Red))", "(Definition/MyColor, (Label/Pie))"], + "tests": { + "string_tests": { + "fails": [ + "{HED}, Def/MyColor" + ], + "passes": [ + ] + }, + "sidecar_tests": { + "fails": [ + ], + "passes": [ + ] + }, + "event_tests": { + "fails": [ + [ + ["onset", "duration", "HED"], + [ 4.5, 0, "{who_knows}, Red"] + ] + ], + "passes": [ + ] + }, + "combo_tests": { + "fails": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow)), ({HED})", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#" + } + }, + "events": + [ + ["onset", "duration", "event_code","HED"], + [ 4.5, 0, "face", "Blue, {response_time}"], + [ 5.0, 0, "ball", "Green, Def/MyColor"], + [ 5.0, 0, "face", ""], + [ 5.0, 0, "face", "n/a"] + ] + } + ], + "passes": [ + { + "sidecar": { + "event_code": { + "HED": { + "face": "(Red, Blue), (Green, (Yellow)), ({HED})", + "ball": "{response_time}, (Def/Acc/3.5 m-per-s^2)" + } + }, + "response_time": { + "Description": "Has description with HED", + "HED": "Label/#" + } + }, + "events": + [ + ["onset", "duration", "event_code","HED", "response_time"], + [ 4.5, 0, "face", "Blue", 1], + [ 5.0, 0, "ball", "Green, Def/MyColor", 1], + [ 5.0, 0, "face", "", 1], + [ 5.0, 0, "face", "n/a", 1] + ] + } + ] + } + } + } +]