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_ex:Measure

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





        Measure --> "1" ExtractedMeasureFamily : family
        click ExtractedMeasureFamily href "../ExtractedMeasureFamily/"



      Measure : local_id

      Measure : source_label





        Measure --> "0..1" ExtractedString : source_label
        click ExtractedString href "../ExtractedString/"



      Measure : specific_metric





        Measure --> "0..1" ExtractedString : specific_metric
        click ExtractedString href "../ExtractedString/"



      Measure : stable_id

      Measure : type





        Measure --> "1" ExtractedMeasureType : type
        click ExtractedMeasureType href "../ExtractedMeasureType/"



      Measure : unit





        Measure --> "0..1" ExtractedString : unit
        click ExtractedString href "../ExtractedString/"

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	Stable identifier used by Analysis foreign-key references	direct
family	1 ExtractedMeasureFamily	Broad imaging or signal family, for coarse filtering	direct
type	1 ExtractedMeasureType	Normalized quantity, for cross-study queries	direct
source_label	0..1 ExtractedString	The paper's own term for the measure	direct
specific_metric	0..1 ExtractedString	Named metric when type is intentionally broad, such as fractional anisotropy,...	direct
unit	0..1 ExtractedString	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-extraction

Mappings

Mapping Type	Mapped Value
self	neurostudy_ex:Measure
native	neurostudy_ex: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-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/analysis
    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
    description: Stable identifier used by Analysis foreign-key references.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    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
  family:
    name: family
    description: Broad imaging or signal family, for coarse filtering.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    domain_of:
    - Statistic
    - Measure
    range: ExtractedMeasureFamily
    required: true
  type:
    name: type
    description: Normalized quantity, for cross-study queries.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    rank: 1000
    domain_of:
    - Measure
    - ModelTerm
    range: ExtractedMeasureType
    required: true
  source_label:
    name: source_label
    description: The paper's own term for the measure. Unset only when the source
      does not identify the measure.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    rank: 1000
    domain_of:
    - Measure
    range: ExtractedString
  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.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    rank: 1000
    domain_of:
    - Measure
    range: ExtractedString
  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.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    rank: 1000
    domain_of:
    - Measure
    - ModelTerm
    range: ExtractedString

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-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/analysis
    owner: Measure
    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
    description: Stable identifier used by Analysis foreign-key references.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    identifier: true
    owner: Measure
    domain_of:
    - Arm
    - Timepoint
    - Group
    - Task
    - Condition
    - Assessment
    - Region
    - Acquisition
    - Device
    - Analysis
    - Measure
    - Preprocessing
    - ModelEstimation
    - ModelTerm
    - InferenceSettings
    - Table
    - CoordinateSet
    - Study
    range: string
    required: true
  family:
    name: family
    description: Broad imaging or signal family, for coarse filtering.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    owner: Measure
    domain_of:
    - Statistic
    - Measure
    range: ExtractedMeasureFamily
    required: true
  type:
    name: type
    description: Normalized quantity, for cross-study queries.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    rank: 1000
    owner: Measure
    domain_of:
    - Measure
    - ModelTerm
    range: ExtractedMeasureType
    required: true
  source_label:
    name: source_label
    description: The paper's own term for the measure. Unset only when the source
      does not identify the measure.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    rank: 1000
    owner: Measure
    domain_of:
    - Measure
    range: ExtractedString
  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.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    rank: 1000
    owner: Measure
    domain_of:
    - Measure
    range: ExtractedString
  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.
    from_schema: https://neurostuff.org/schemas/neuroimaging-study-extraction/analysis
    rank: 1000
    owner: Measure
    domain_of:
    - Measure
    - ModelTerm
    range: ExtractedString