Class: Task

A meaningful participant paradigm, such as a task, resting-state protocol, stimulation, or passive viewing, performed in association with an acquisition. A Task record is required wherever the study models conditions, a resting-state protocol included. Acquisitions with no paradigm do not require one, even in a longitudinal or interventional study: a structural comparison across occasions is carried by the Effect's timepoint terms and linked through Analysis.acquisitions.

URI: neurostudy_ex:Task

 classDiagram
    class Task
    click Task href "../Task/"
      Task : acquisitions





        Task --> "*" Acquisition : acquisitions
        click Acquisition href "../Acquisition/"



      Task : conditions





        Task --> "*" Condition : conditions
        click Condition href "../Condition/"



      Task : description





        Task --> "0..1" ExtractedString : description
        click ExtractedString href "../ExtractedString/"



      Task : design_type





        Task --> "0..1" ExtractedDesignType : design_type
        click ExtractedDesignType href "../ExtractedDesignType/"



      Task : instructions





        Task --> "0..1" ExtractedString : instructions
        click ExtractedString href "../ExtractedString/"



      Task : local_id

      Task : name





        Task --> "0..1" ExtractedString : name
        click ExtractedString href "../ExtractedString/"



      Task : paradigm





        Task --> "0..1" ExtractedString : paradigm
        click ExtractedString href "../ExtractedString/"



      Task : performance_measures





        Task --> "0..1" ExtractedStringList : performance_measures
        click ExtractedStringList href "../ExtractedStringList/"



      Task : presentation_software





        Task --> "0..1" ExtractedString : presentation_software
        click ExtractedString href "../ExtractedString/"



      Task : references





        Task --> "0..1" ExtractedStringList : references
        click ExtractedStringList href "../ExtractedStringList/"



      Task : response_modality





        Task --> "0..1" ExtractedResponseModalityList : response_modality
        click ExtractedResponseModalityList href "../ExtractedResponseModalityList/"



      Task : stable_id

      Task : stimuli





        Task --> "0..1" ExtractedStringList : stimuli
        click ExtractedStringList href "../ExtractedStringList/"



      Task : stimulus_content





        Task --> "0..1" ExtractedStringList : stimulus_content
        click ExtractedStringList href "../ExtractedStringList/"



      Task : stimulus_modality





        Task --> "0..1" ExtractedStimulusModalityList : stimulus_modality
        click ExtractedStimulusModalityList href "../ExtractedStimulusModalityList/"



      Task : variant_qualifiers





        Task --> "*" TaskQualifier : variant_qualifiers
        click TaskQualifier href "../TaskQualifier/"

Slots

Name	Cardinality and Range	Description	Inheritance
stable_id	0..1 String	UUID minted by the store the first time this entity appears, never by an extr...	direct
local_id	1 String		direct
name	0..1 ExtractedString	Short, unique label for the task or paradigm; corresponds conceptually to BID...	direct
paradigm	0..1 ExtractedString	The name with every qualifier that says how this version varies taken off and...	direct
variant_qualifiers	* TaskQualifier	The words of name that paradigm leaves out, each with the axis it varies ...	direct
description	0..1 ExtractedString	Complete narrative description of what participants experienced and did	direct
conditions	* Condition	The conditions this task was made of	direct
design_type	0..1 ExtractedDesignType	How the task's events were modelled in time	direct
acquisitions	* Acquisition	The acquisition protocols used to collect data for this task	direct
presentation_software	0..1 ExtractedString	Stimulus-presentation software name, version, and operating system when repor...	direct
instructions	0..1 ExtractedString	Task- or paradigm-specific instructions given to participants	direct
references	0..1 ExtractedStringList	Works the source cites for this task, exactly as it writes them: an author-ye...	direct
stimuli	0..1 ExtractedStringList	The materials presented to participants, in the source's own terms -- the sti...	direct
stimulus_content	0..1 ExtractedStringList	What the task's stimuli were about when that holds across all its conditions ...	direct
stimulus_modality	0..1 ExtractedStimulusModalityList	The sensory channel the stimuli were delivered through	direct
response_modality	0..1 ExtractedResponseModalityList	How participants responded	direct
performance_measures	0..1 ExtractedStringList	Behavioral variables recorded and summaries used to verify task performance	direct

Usages

used by	used in	type	used
Analysis	tasks	range	Task
Study	tasks	range	Task

Identifier and Mapping Information

Schema Source

• from schema: https://neurostuff.org/schemas/neuroimaging-study-extraction

Mappings

Mapping Type	Mapped Value
self	neurostudy_ex:Task
native	neurostudy_ex:Task

LinkML Source

Direct

name: Task
description: 'A meaningful participant paradigm, such as a task, resting-state protocol,
  stimulation, or passive viewing, performed in association with an acquisition. A
  Task record is required wherever the study models conditions, a resting-state protocol
  included. Acquisitions with no paradigm do not require one, even in a longitudinal
  or interventional study: a structural comparison across occasions is carried by
  the Effect''s timepoint terms and linked through Analysis.acquisitions.'
from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction
rank: 1000
attributes:
  stable_id:
    name: stable_id
    description: UUID minted by the store the first time this entity appears, never
      by an extractor, and kept across re-runs so a later extraction matches the same
      entity.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    domain_of:
    - Arm
    - Timepoint
    - Group
    - Task
    - Condition
    - Assessment
    - Region
    - Acquisition
    - Device
    - Analysis
    - Measure
    - Preprocessing
    - ModelEstimation
    - ModelTerm
    - InferenceSettings
    - Table
    - CoordinateSet
    - Study
    range: string
    pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  local_id:
    name: local_id
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    identifier: true
    domain_of:
    - Arm
    - Timepoint
    - Group
    - Task
    - Condition
    - Assessment
    - Region
    - Acquisition
    - Device
    - Analysis
    - Measure
    - Preprocessing
    - ModelEstimation
    - ModelTerm
    - InferenceSettings
    - Table
    - CoordinateSet
    - Study
    range: string
    required: true
  name:
    name: name
    description: Short, unique label for the task or paradigm; corresponds conceptually
      to BIDS TaskName when applicable.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    domain_of:
    - Arm
    - Timepoint
    - Group
    - Task
    - Condition
    - Assessment
    - Region
    - Analysis
    - ModelTerm
    - ExternalDataset
    - PerformanceMetric
    range: ExtractedString
  paradigm:
    name: paradigm
    description: 'The name with every qualifier that says how this version varies
      taken off and moved to its own field: `Stroop task` for an emotional Stroop
      task, `flanker task` for an auditory flanker task, `n-back task` for a food-picture
      n-back, `incentive delay task` for a monetary incentive delay task. The same
      as `name` when nothing qualifies it.

      This is the extractor''s split, made the same way in every paper. Whether the
      stem or the qualified name is the paradigm is not a fact one paper can state;
      it is decided across the corpus, in `paradigm_category`.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    range: ExtractedString
  variant_qualifiers:
    name: variant_qualifiers
    description: 'The words of `name` that `paradigm` leaves out, each with the axis
      it varies the paradigm on. Each is also stated in its own field: a stimulus-content
      qualifier in `stimulus_content`, a modality qualifier in `stimulus_modality`
      or `response_modality`, a timing qualifier in `design_type`. Empty when `paradigm`
      equals `name`.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    range: TaskQualifier
    multivalued: true
    inlined_as_list: true
  description:
    name: description
    description: Complete narrative description of what participants experienced and
      did.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    domain_of:
    - StudyDesign
    - Arm
    - Group
    - Task
    - Condition
    - Assessment
    - Region
    - Preprocessing
    - Table
    - CoordinateSet
    - Study
    range: ExtractedString
  conditions:
    name: conditions
    description: The conditions this task was made of. These are the different states/modes
      of the task.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    - FactorLevel
    range: Condition
    multivalued: true
    inlined_as_list: true
  design_type:
    name: design_type
    description: 'How the task''s events were modelled in time. Open vocabulary: write
      the source''s own wording in the field when nothing here fits.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    range: ExtractedDesignType
  acquisitions:
    name: acquisitions
    description: The acquisition protocols used to collect data for this task. Exclude
      structural scans unless they are part of the task itself.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    - Analysis
    - Study
    range: Acquisition
    multivalued: true
    inlined: false
  presentation_software:
    name: presentation_software
    description: Stimulus-presentation software name, version, and operating system
      when reported.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    range: ExtractedString
  instructions:
    name: instructions
    description: Task- or paradigm-specific instructions given to participants.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    range: ExtractedString
  references:
    name: references
    description: 'Works the source cites for this task, exactly as it writes them:
      an author-year citation or a bracketed reference number, kept in the source''s
      own punctuation. Copy the in-text citation; do not resolve, expand or look it
      up.

      Multivalued -- a task may cite the paradigm''s origin, an adaptation, and the
      stimulus set separately. Empty when the source cites nothing for the task.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    range: ExtractedStringList
  stimuli:
    name: stimuli
    description: The materials presented to participants, in the source's own terms
      -- the stimulus set, its name, how many items. One entry per distinct material;
      `stimulus_modality` carries the sensory channel.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    range: ExtractedStringList
  stimulus_content:
    name: stimulus_content
    description: 'What the task''s stimuli were about when that holds across all its
      conditions -- food pictures at every n-back load, emotional words throughout
      a Stroop -- which `Condition.stimulus_content` leaves unset because it does
      not tell the conditions apart. The task-level half of the stimulus facet: a
      meta-analysis can ask for food stimuli across paradigms, or for Stroop tasks
      across stimuli, without either question splitting the other.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    - Condition
    range: ExtractedStringList
  stimulus_modality:
    name: stimulus_modality
    description: 'The sensory channel the stimuli were delivered through. Multivalued
      because a paradigm may use more than one -- a photograph with a spoken label.

      Often not stated in those words: a source naming IAPS, NimStim, Ekman faces
      or film clips has said `visual` without using the word. Inferring it from such
      a cue is intended, and the cue is what belongs in the evidence -- not the whole
      methods section.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    range: ExtractedStimulusModalityList
  response_modality:
    name: response_modality
    description: How participants responded. Multivalued because a paradigm often
      collects more than one -- a button press for accuracy and a spoken report afterwards.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    range: ExtractedResponseModalityList
  performance_measures:
    name: performance_measures
    description: Behavioral variables recorded and summaries used to verify task performance.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    domain_of:
    - Task
    range: ExtractedStringList

Induced

name: Task
description: 'A meaningful participant paradigm, such as a task, resting-state protocol,
  stimulation, or passive viewing, performed in association with an acquisition. A
  Task record is required wherever the study models conditions, a resting-state protocol
  included. Acquisitions with no paradigm do not require one, even in a longitudinal
  or interventional study: a structural comparison across occasions is carried by
  the Effect''s timepoint terms and linked through Analysis.acquisitions.'
from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction
rank: 1000
attributes:
  stable_id:
    name: stable_id
    description: UUID minted by the store the first time this entity appears, never
      by an extractor, and kept across re-runs so a later extraction matches the same
      entity.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    owner: Task
    domain_of:
    - Arm
    - Timepoint
    - Group
    - Task
    - Condition
    - Assessment
    - Region
    - Acquisition
    - Device
    - Analysis
    - Measure
    - Preprocessing
    - ModelEstimation
    - ModelTerm
    - InferenceSettings
    - Table
    - CoordinateSet
    - Study
    range: string
    pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  local_id:
    name: local_id
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    identifier: true
    owner: Task
    domain_of:
    - Arm
    - Timepoint
    - Group
    - Task
    - Condition
    - Assessment
    - Region
    - Acquisition
    - Device
    - Analysis
    - Measure
    - Preprocessing
    - ModelEstimation
    - ModelTerm
    - InferenceSettings
    - Table
    - CoordinateSet
    - Study
    range: string
    required: true
  name:
    name: name
    description: Short, unique label for the task or paradigm; corresponds conceptually
      to BIDS TaskName when applicable.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    owner: Task
    domain_of:
    - Arm
    - Timepoint
    - Group
    - Task
    - Condition
    - Assessment
    - Region
    - Analysis
    - ModelTerm
    - ExternalDataset
    - PerformanceMetric
    range: ExtractedString
  paradigm:
    name: paradigm
    description: 'The name with every qualifier that says how this version varies
      taken off and moved to its own field: `Stroop task` for an emotional Stroop
      task, `flanker task` for an auditory flanker task, `n-back task` for a food-picture
      n-back, `incentive delay task` for a monetary incentive delay task. The same
      as `name` when nothing qualifies it.

      This is the extractor''s split, made the same way in every paper. Whether the
      stem or the qualified name is the paradigm is not a fact one paper can state;
      it is decided across the corpus, in `paradigm_category`.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    range: ExtractedString
  variant_qualifiers:
    name: variant_qualifiers
    description: 'The words of `name` that `paradigm` leaves out, each with the axis
      it varies the paradigm on. Each is also stated in its own field: a stimulus-content
      qualifier in `stimulus_content`, a modality qualifier in `stimulus_modality`
      or `response_modality`, a timing qualifier in `design_type`. Empty when `paradigm`
      equals `name`.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    range: TaskQualifier
    multivalued: true
    inlined: true
    inlined_as_list: true
  description:
    name: description
    description: Complete narrative description of what participants experienced and
      did.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    owner: Task
    domain_of:
    - StudyDesign
    - Arm
    - Group
    - Task
    - Condition
    - Assessment
    - Region
    - Preprocessing
    - Table
    - CoordinateSet
    - Study
    range: ExtractedString
  conditions:
    name: conditions
    description: The conditions this task was made of. These are the different states/modes
      of the task.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    - FactorLevel
    range: Condition
    multivalued: true
    inlined: true
    inlined_as_list: true
  design_type:
    name: design_type
    description: 'How the task''s events were modelled in time. Open vocabulary: write
      the source''s own wording in the field when nothing here fits.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    range: ExtractedDesignType
  acquisitions:
    name: acquisitions
    description: The acquisition protocols used to collect data for this task. Exclude
      structural scans unless they are part of the task itself.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    - Analysis
    - Study
    range: Acquisition
    multivalued: true
    inlined: false
  presentation_software:
    name: presentation_software
    description: Stimulus-presentation software name, version, and operating system
      when reported.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    range: ExtractedString
  instructions:
    name: instructions
    description: Task- or paradigm-specific instructions given to participants.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    range: ExtractedString
  references:
    name: references
    description: 'Works the source cites for this task, exactly as it writes them:
      an author-year citation or a bracketed reference number, kept in the source''s
      own punctuation. Copy the in-text citation; do not resolve, expand or look it
      up.

      Multivalued -- a task may cite the paradigm''s origin, an adaptation, and the
      stimulus set separately. Empty when the source cites nothing for the task.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    range: ExtractedStringList
  stimuli:
    name: stimuli
    description: The materials presented to participants, in the source's own terms
      -- the stimulus set, its name, how many items. One entry per distinct material;
      `stimulus_modality` carries the sensory channel.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    range: ExtractedStringList
  stimulus_content:
    name: stimulus_content
    description: 'What the task''s stimuli were about when that holds across all its
      conditions -- food pictures at every n-back load, emotional words throughout
      a Stroop -- which `Condition.stimulus_content` leaves unset because it does
      not tell the conditions apart. The task-level half of the stimulus facet: a
      meta-analysis can ask for food stimuli across paradigms, or for Stroop tasks
      across stimuli, without either question splitting the other.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    - Condition
    range: ExtractedStringList
  stimulus_modality:
    name: stimulus_modality
    description: 'The sensory channel the stimuli were delivered through. Multivalued
      because a paradigm may use more than one -- a photograph with a spoken label.

      Often not stated in those words: a source naming IAPS, NimStim, Ekman faces
      or film clips has said `visual` without using the word. Inferring it from such
      a cue is intended, and the cue is what belongs in the evidence -- not the whole
      methods section.'
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    range: ExtractedStimulusModalityList
  response_modality:
    name: response_modality
    description: How participants responded. Multivalued because a paradigm often
      collects more than one -- a button press for accuracy and a spoken report afterwards.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    range: ExtractedResponseModalityList
  performance_measures:
    name: performance_measures
    description: Behavioral variables recorded and summaries used to verify task performance.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/task
    rank: 1000
    owner: Task
    domain_of:
    - Task
    range: ExtractedStringList