Class: Measure

The scientific quantity of the map, independent of the statistic used to test it. When a paper alternates terms for the same map -- grey matter concentration in Methods and volume in Results -- take the Methods term for type and keep both wordings in source_label.

One record may be referenced by several Analyses, so every field must hold for all of them; an analysis of a different quantity takes its own record. The test is mechanical: two analyses share a record when family, type, specific_metric and unit all match. A study measures one or two quantities and tests them many ways, so sharing is the common case -- eight analyses of one connectivity measure are one record, not eight.

Not a property of the thresholding scheme: one correction scheme routinely covers several measures, and one measure is often tested under several schemes. See storage-schema-design-notes.md for the reasoning behind this shape.

URI: neurostudy:Measure

 classDiagram
    class Measure
    click Measure href "../Measure/"
      Measure : family

      Measure : id

      Measure : source_label

      Measure : specific_metric

      Measure : type

      Measure : unit

Slots

Name	Cardinality and Range	Description	Inheritance
id	1 String	Stable identifier used by Analysis foreign-key references	direct
family	1 String or  MeasureFamily	Broad imaging or signal family, for coarse filtering	direct
type	1 String or  MeasureType	Normalized quantity, for cross-study queries	direct
source_label	0..1 String	The paper's own term for the measure	direct
specific_metric	0..1 String	Named metric when type is intentionally broad, such as fractional anisotropy,...	direct
unit	0..1 String	The unit the measure is reported in, when the source gives one and it carries...	direct

Usages

used by	used in	type	used
Analysis	measure	range	Measure
Study	measures	range	Measure

Identifier and Mapping Information

Schema Source

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

Mappings

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

LinkML Source

Direct

name: Measure
description: 'The scientific quantity of the map, independent of the statistic used
  to test it. When a paper alternates terms for the same map -- grey matter concentration
  in Methods and volume in Results -- take the Methods term for type and keep both
  wordings in source_label.

  One record may be referenced by several Analyses, so every field must hold for all
  of them; an analysis of a different quantity takes its own record. The test is mechanical:
  two analyses share a record when `family`, `type`, `specific_metric` and `unit`
  all match. A study measures one or two quantities and tests them many ways, so sharing
  is the common case -- eight analyses of one connectivity measure are one record,
  not eight.

  Not a property of the thresholding scheme: one correction scheme routinely covers
  several measures, and one measure is often tested under several schemes. See storage-schema-design-notes.md
  for the reasoning behind this shape.'
from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage
rank: 1000
attributes:
  id:
    name: id
    description: Stable identifier used by Analysis foreign-key references.
    in_subset:
    - deterministic
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    identifier: true
    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
  family:
    name: family
    description: Broad imaging or signal family, for coarse filtering.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    domain_of:
    - Statistic
    - Measure
    required: true
    any_of:
    - range: MeasureFamily
    - range: string
  type:
    name: type
    description: Normalized quantity, for cross-study queries.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    rank: 1000
    domain_of:
    - Measure
    - ModelTerm
    required: true
    any_of:
    - range: MeasureType
    - range: string
  source_label:
    name: source_label
    description: The paper's own term for the measure. Unset only when the source
      does not identify the measure.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    rank: 1000
    domain_of:
    - Measure
    range: string
  specific_metric:
    name: specific_metric
    description: Named metric when type is intentionally broad, such as fractional
      anisotropy, ALFF, fALFF, or a specific tracer binding potential.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    rank: 1000
    domain_of:
    - Measure
    range: string
  unit:
    name: unit
    description: The unit the measure is reported in, when the source gives one and
      it carries information -- mm for a thickness, mL for a volume. Omitted for a
      unitless quantity such as a correlation or a normalized index.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    rank: 1000
    domain_of:
    - Measure
    - ModelTerm
    range: string

Induced

name: Measure
description: 'The scientific quantity of the map, independent of the statistic used
  to test it. When a paper alternates terms for the same map -- grey matter concentration
  in Methods and volume in Results -- take the Methods term for type and keep both
  wordings in source_label.

  One record may be referenced by several Analyses, so every field must hold for all
  of them; an analysis of a different quantity takes its own record. The test is mechanical:
  two analyses share a record when `family`, `type`, `specific_metric` and `unit`
  all match. A study measures one or two quantities and tests them many ways, so sharing
  is the common case -- eight analyses of one connectivity measure are one record,
  not eight.

  Not a property of the thresholding scheme: one correction scheme routinely covers
  several measures, and one measure is often tested under several schemes. See storage-schema-design-notes.md
  for the reasoning behind this shape.'
from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage
rank: 1000
attributes:
  id:
    name: id
    description: Stable identifier used by Analysis foreign-key references.
    in_subset:
    - deterministic
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    identifier: true
    owner: Measure
    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
  family:
    name: family
    description: Broad imaging or signal family, for coarse filtering.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    owner: Measure
    domain_of:
    - Statistic
    - Measure
    range: string
    required: true
    any_of:
    - range: MeasureFamily
    - range: string
  type:
    name: type
    description: Normalized quantity, for cross-study queries.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    rank: 1000
    owner: Measure
    domain_of:
    - Measure
    - ModelTerm
    range: string
    required: true
    any_of:
    - range: MeasureType
    - range: string
  source_label:
    name: source_label
    description: The paper's own term for the measure. Unset only when the source
      does not identify the measure.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    rank: 1000
    owner: Measure
    domain_of:
    - Measure
    range: string
  specific_metric:
    name: specific_metric
    description: Named metric when type is intentionally broad, such as fractional
      anisotropy, ALFF, fALFF, or a specific tracer binding potential.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    rank: 1000
    owner: Measure
    domain_of:
    - Measure
    range: string
  unit:
    name: unit
    description: The unit the measure is reported in, when the source gives one and
      it carries information -- mm for a thickness, mL for a volume. Omitted for a
      unitless quantity such as a correlation or a normalized index.
    in_subset:
    - mvp
    - model_extracted
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-storage/analysis
    rank: 1000
    owner: Measure
    domain_of:
    - Measure
    - ModelTerm
    range: string