Skip to content

Class: MRI

An MRI acquisition of any kind -- functional, structural, or diffusion, as modality records. Its own attributes are the ones commonly useful for study selection, subgrouping, or sensitivity analyses in coordinate- or image-based meta-analysis.

URI: neurostudy:MRI

 classDiagram
    class MRI
    click MRI href "../MRI/"
      Acquisition <|-- MRI
        click Acquisition href "../Acquisition/"

      MRI : acquisition_duration_seconds

      MRI : acquisition_type

      MRI : acquisition_voxel_size_mm

      MRI : brain_coverage





        MRI --> "0..1" BrainCoverage : brain_coverage
        click BrainCoverage href "../BrainCoverage/"



      MRI : device





        MRI --> "0..1" Device : device
        click Device href "../Device/"



      MRI : echo_time_seconds

      MRI : id

      MRI : magnetic_field_strength_tesla

      MRI : modality

      MRI : mr_acquisition_type

      MRI : number_of_volumes

      MRI : pulse_sequence_type

      MRI : repetition_time_seconds

Inheritance

Slots

Name Cardinality and Range Description Inheritance
magnetic_field_strength_tesla 0..1
Float		 Nominal static magnetic field strength in tesla direct
pulse_sequence_type 0..1
String		 General pulse sequence family, such as EPI, MPRAGE, SPGR, or spin echo direct
mr_acquisition_type 0..1
String		 Acquisition dimensionality, such as 2D or 3D; useful for distinguishing proto... direct
repetition_time_seconds 0..1
Float		 Time between the start of successive acquired volumes, in seconds direct
echo_time_seconds *
Float		 Echo time in seconds, as a list of one value per echo direct
acquisition_voxel_size_mm *
Float		 Original acquisition voxel size [x, y, z] in millimeters, before interpolatio... direct
number_of_volumes 0..1
Integer		 Number of acquired volumes contributing to the recording, when reported; a pr... direct
id 1
String		 Acquisition
acquisition_type 1
String		 The concrete subclass this record instantiates Acquisition
modality 1
String or 
Modality		 Imaging or recording modality Acquisition
acquisition_duration_seconds 0..1
Float		 Total usable acquisition or recording duration in seconds Acquisition
device 0..1
Device		 The scanner, amplifier, or recording system this acquisition was made on, by ... Acquisition
brain_coverage 0..1
BrainCoverage		 How much of the brain the acquired volume contained Acquisition

Identifier and Mapping Information

Schema Source

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

Mappings

Mapping Type Mapped Value
self neurostudy:MRI
native neurostudy:MRI

LinkML Source

Direct

name: MRI
description: An MRI acquisition of any kind -- functional, structural, or diffusion,
  as modality records. Its own attributes are the ones commonly useful for study selection,
  subgrouping, or sensitivity analyses in coordinate- or image-based meta-analysis.
from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage
rank: 1000
is_a: Acquisition
attributes:
  magnetic_field_strength_tesla:
    name: magnetic_field_strength_tesla
    description: Nominal static magnetic field strength in tesla.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    domain_of:
    - MRI
    range: float
    minimum_value: 0
  pulse_sequence_type:
    name: pulse_sequence_type
    description: General pulse sequence family, such as EPI, MPRAGE, SPGR, or spin
      echo.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    domain_of:
    - MRI
    range: string
  mr_acquisition_type:
    name: mr_acquisition_type
    description: Acquisition dimensionality, such as 2D or 3D; useful for distinguishing
      protocols with materially different spatial sampling.
    in_subset:
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    domain_of:
    - MRI
    range: string
  repetition_time_seconds:
    name: repetition_time_seconds
    description: Time between the start of successive acquired volumes, in seconds.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    domain_of:
    - MRI
    range: float
    minimum_value: 0
  echo_time_seconds:
    name: echo_time_seconds
    description: Echo time in seconds, as a list of one value per echo. A multi-echo
      sequence has several; a single-echo one has a list of length one.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    domain_of:
    - MRI
    range: float
    multivalued: true
    minimum_value: 0
  acquisition_voxel_size_mm:
    name: acquisition_voxel_size_mm
    description: Original acquisition voxel size [x, y, z] in millimeters, before
      interpolation or resampling.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    domain_of:
    - MRI
    range: float
    multivalued: true
    minimum_value: 0
  number_of_volumes:
    name: number_of_volumes
    description: Number of acquired volumes contributing to the recording, when reported;
      a proxy for scan length and temporal sampling in functional acquisitions.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    domain_of:
    - MRI
    range: integer
    minimum_value: 0

Induced

name: MRI
description: An MRI acquisition of any kind -- functional, structural, or diffusion,
  as modality records. Its own attributes are the ones commonly useful for study selection,
  subgrouping, or sensitivity analyses in coordinate- or image-based meta-analysis.
from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage
rank: 1000
is_a: Acquisition
attributes:
  magnetic_field_strength_tesla:
    name: magnetic_field_strength_tesla
    description: Nominal static magnetic field strength in tesla.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    owner: MRI
    domain_of:
    - MRI
    range: float
    minimum_value: 0
  pulse_sequence_type:
    name: pulse_sequence_type
    description: General pulse sequence family, such as EPI, MPRAGE, SPGR, or spin
      echo.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    owner: MRI
    domain_of:
    - MRI
    range: string
  mr_acquisition_type:
    name: mr_acquisition_type
    description: Acquisition dimensionality, such as 2D or 3D; useful for distinguishing
      protocols with materially different spatial sampling.
    in_subset:
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    owner: MRI
    domain_of:
    - MRI
    range: string
  repetition_time_seconds:
    name: repetition_time_seconds
    description: Time between the start of successive acquired volumes, in seconds.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    owner: MRI
    domain_of:
    - MRI
    range: float
    minimum_value: 0
  echo_time_seconds:
    name: echo_time_seconds
    description: Echo time in seconds, as a list of one value per echo. A multi-echo
      sequence has several; a single-echo one has a list of length one.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    owner: MRI
    domain_of:
    - MRI
    range: float
    multivalued: true
    minimum_value: 0
  acquisition_voxel_size_mm:
    name: acquisition_voxel_size_mm
    description: Original acquisition voxel size [x, y, z] in millimeters, before
      interpolation or resampling.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    owner: MRI
    domain_of:
    - MRI
    range: float
    multivalued: true
    minimum_value: 0
  number_of_volumes:
    name: number_of_volumes
    description: Number of acquired volumes contributing to the recording, when reported;
      a proxy for scan length and temporal sampling in functional acquisitions.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    owner: MRI
    domain_of:
    - MRI
    range: integer
    minimum_value: 0
  id:
    name: id
    in_subset:
    - mvp
    - deterministic
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    identifier: true
    owner: MRI
    domain_of:
    - Arm
    - Timepoint
    - Group
    - Task
    - Condition
    - Assessment
    - Region
    - Acquisition
    - Device
    - Analysis
    - Measure
    - Preprocessing
    - ModelEstimation
    - ModelTerm
    - InferenceSettings
    - StatisticalMap
    - Table
    - CoordinateSet
    - Study
    range: string
    required: true
  acquisition_type:
    name: acquisition_type
    description: The concrete subclass this record instantiates. Derived by the mapper
      from the modality value's `instantiates`, never extracted.
    in_subset:
    - mvp
    - deterministic
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    designates_type: true
    owner: MRI
    domain_of:
    - Acquisition
    range: string
    required: true
  modality:
    name: modality
    description: 'Imaging or recording modality. A value in the Modality vocabulary
      also names the class holding this acquisition''s modality-specific parameters,
      through that value''s `instantiates`.

      Open vocabulary: write the source''s own wording in the field when nothing here
      fits, because the value is required and a closed range would discard the whole
      acquisition over one unrecognised word. Only a vocabulary value carries an `instantiates`,
      so an acquisition outside it resolves to the base class until normalization
      maps the wording back on -- which is why `acquisition_type` is derived rather
      than extracted, and why an unmapped modality is worth reporting.'
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    owner: MRI
    domain_of:
    - Acquisition
    range: string
    required: true
    any_of:
    - range: Modality
    - range: string
  acquisition_duration_seconds:
    name: acquisition_duration_seconds
    description: Total usable acquisition or recording duration in seconds. Useful
      for filtering studies by the amount of data contributing to an analysis, especially
      resting-state and continuous recordings.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    owner: MRI
    domain_of:
    - Acquisition
    range: float
    minimum_value: 0
  device:
    name: device
    description: The scanner, amplifier, or recording system this acquisition was
      made on, by identifier. Acquisitions made on one machine reference one record;
      a second record asserts the study used a second machine.
    in_subset:
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    owner: MRI
    domain_of:
    - Acquisition
    range: Device
    inlined: false
  brain_coverage:
    name: brain_coverage
    description: 'How much of the brain the acquired volume contained. This is the
      extent the SCANNER sampled, and it is a third axis distinct from the two the
      schema already carries: `Analysis.spatial_scope` is what the analysis tested,
      and `InferenceSettings.correction_scope` with `search_volume` is where multiple
      comparisons were controlled. A voxelwise analysis over a volume that clipped
      the cerebellum is `whole_brain` in scope and `partial` here, and an ROI analysis
      of a whole-head acquisition is the reverse. Never infer this from either of
      those.

      It describes the volume behind the REPORTED results. A scan that clipped a structure
      in participants who were then excluded is `whole_brain`, because the analysed
      volume was not clipped; calling it `partial` would say the opposite of what
      the results rest on.

      A field of view or slice prescription in millimetres is not by itself a statement
      of coverage. Where only the geometry is given, the value is an inference and
      `value_source` records it as one. Which structure a partial volume missed is
      not a field of its own -- the evidence span carries that detail.'
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/acquisition
    rank: 1000
    owner: MRI
    domain_of:
    - Acquisition
    range: BrainCoverage