Class: Component

name: Component
description: Metadata about components of nutritional interest measured from foods.
in_subset:
- RecommendedSubset
from_schema: https://w3id.org/kaiiam/mifc
is_a: NamedThing
slots:
- component_sample_id
- component_type
- component_type_label
- component_recorded_value
- component_measurement_unit
- component_data_points_number
- component_record_date
- component_analysis_date
- component_analysis_organization
- component_comment
- component_derivation_type
- component_limit_of_quantitation
- compound_sample_aggregation_minimum_value
- compound_sample_aggregation_maximum_value
- compound_sample_aggregation_median_value
- compound_sample_aggregation_standard_deviation
- compound_analytical_measurement_protocol_url
- compound_analytical_measurement_method
- compound_analytical_laboratory_name
- component_quality_control_remeasurement
- compound_individual_sample_id_list
- component_atwater_protein_conversion_factor
- component_atwater_fat_conversion_factor
- component_atwater_carbohydrate_conversion_factor
- component_protein_from_nitrogen_conversion_factor
- food_laboratory_sample_id
- food_laboratory_sample_aliquot_id
- food_laboratory_sample_batch_id
class_uri: schema:Component

name: Component
description: Metadata about components of nutritional interest measured from foods.
in_subset:
- RecommendedSubset
from_schema: https://w3id.org/kaiiam/mifc
is_a: NamedThing
attributes:
  component_sample_id:
    name: component_sample_id
    description: A string denoting the primary identifier for a sample of the class
      Component.
    comments:
    - Note that component_sample_id does not need be unique in a given dataset and
      should be used to relate Food and Component records via food_sample_id from
      the Food class.
    examples:
    - value: CY121UM
    in_subset:
    - RecommendedSubset
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_sample_id
    owner: Component
    domain_of:
    - Component
    range: string
    required: true
  component_type:
    name: component_type
    description: A controlled vocabulary term representing the type of component of
      nutritional interest analyzed from a food sample.
    examples:
    - value: COMPONENT:1007
    in_subset:
    - RecommendedSubset
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_type
    owner: Component
    domain_of:
    - Component
    range: string
    recommended: true
  component_type_label:
    name: component_type_label
    description: A string denoting the label of a controlled vocabulary term representing
      an analyzed component_type from a food sample.
    examples:
    - value: Ash
    in_subset:
    - RecommendedSubset
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_type_label
    owner: Component
    domain_of:
    - Component
    range: string
    recommended: true
  component_recorded_value:
    name: component_recorded_value
    description: A float representing a recorded value of a component of nutritional
      interest measured from a laboratory sample derived from a food sample.
    examples:
    - value: '0.52'
    in_subset:
    - RecommendedSubset
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_recorded_value
    owner: Component
    domain_of:
    - Component
    range: float
    required: true
  component_measurement_unit:
    name: component_measurement_unit
    description: A unit code representing the unit of measurement in which a component_recorded_value
      is measured.
    comments:
    - TODO find a way to constrain these with valid UCUM codes perhaps enum or recommended
      LINKML units docs.
    examples:
    - value: g/(100.g)
    in_subset:
    - RecommendedSubset
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_measurement_unit
    owner: Component
    domain_of:
    - Component
    range: string
    required: true
  component_data_points_number:
    name: component_data_points_number
    description: An integer representing the number of individual samples that comprise
      a component sample. 1 if an individual sample >1 if an aggregation of samples.
    comments:
    - This slot defines if component is source from an individual sample, or an aggregated
      collection of sample (a profile).
    examples:
    - value: '7'
    in_subset:
    - RecommendedSubset
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_data_points_number
    owner: Component
    domain_of:
    - Component
    range: integer
    required: true
  component_record_date:
    name: component_record_date
    description: A date value representing recorded date pertaining to an analyzed
      sample.
    comments:
    - Allows for ambiguity of date record relative to component_analysis_date. Use
      this if a date for a record is know but it is unclear if it is specifically
      the date of analysis.
    examples:
    - value: '2023-03-08'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_record_date
    owner: Component
    domain_of:
    - Component
    range: date
  component_analysis_date:
    name: component_analysis_date
    description: A date value representing the date in which a component of nutritional
      interest was analyzed.
    comments:
    - Use this field if the exact date of analysis is known if there is date ambiguity
      use component_record_date.
    examples:
    - value: '2023-03-08'
    in_subset:
    - RecommendedSubset
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_analysis_date
    owner: Component
    domain_of:
    - Component
    range: date
    recommended: true
  component_analysis_organization:
    name: component_analysis_organization
    description: One or more string value(s) representing the name(s) of any organization(s)
      involved in the analysis of a component of nutritional interest from a food
      sample.
    examples:
    - value: USDA
    - value: Unknown manufacturer
    in_subset:
    - RecommendedSubset
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_analysis_organization
    owner: Component
    domain_of:
    - Component
    range: string
    recommended: true
    multivalued: true
  component_comment:
    name: component_comment
    description: A string representing a comment relating to an analyzed component
      of nutritional interest.
    examples:
    - value: Samples were obtained from 12 retail stores using a probability-based
        sampling plan. Some fish had been treated during processing to retain moisture
        on thawing. Untreated fish = 265 mg sodium/100g.
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_comment
    owner: Component
    domain_of:
    - Component
    range: string
  component_derivation_type:
    name: component_derivation_type
    description: A controlled vocabulary term denoting how a component of nutritional
      interest was generated.
    comments:
    - Should make an enumeration with appropriate values (e.g, Analytical as default,
      Calculated, inferred/Estimated, Sourced from literature etc)
    examples:
    - value: Analytical
    in_subset:
    - RecommendedSubset
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_derivation_type
    owner: Component
    domain_of:
    - Component
    range: string
    recommended: true
  component_limit_of_quantitation:
    name: component_limit_of_quantitation
    description: A string representing the lowest analyte concentration likely to
      be reliably distinguished from the Limit of Blank (LoB) and at which detection
      is feasible during the analysis of a component of nutritional interest.
    comments:
    - LoB, (used in the description) is the highest apparent analyte concentration
      expected to be found when replicates of a blank sample containing no analyte
      are tested. Description reference from https://www.ncbi.nlm.nih.gov/pmc/articles/PMC2556583/.
    examples:
    - value: <0.25
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_limit_of_quantitation
    owner: Component
    domain_of:
    - Component
    range: string
  compound_sample_aggregation_minimum_value:
    name: compound_sample_aggregation_minimum_value
    description: A float representing the minimum measured compound value of an aggregation
      of compound samples.
    examples:
    - value: '0.8'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: compound_sample_aggregation_minimum_value
    owner: Component
    domain_of:
    - Component
    range: float
  compound_sample_aggregation_maximum_value:
    name: compound_sample_aggregation_maximum_value
    description: A float representing the maximum measured compound value of an aggregation
      of compound samples.
    examples:
    - value: '2.2'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: compound_sample_aggregation_maximum_value
    owner: Component
    domain_of:
    - Component
    range: float
  compound_sample_aggregation_median_value:
    name: compound_sample_aggregation_median_value
    description: A float representing the median measured compound value of an aggregation
      of compound samples.
    examples:
    - value: '1.5'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: compound_sample_aggregation_median_value
    owner: Component
    domain_of:
    - Component
    range: float
  compound_sample_aggregation_standard_deviation:
    name: compound_sample_aggregation_standard_deviation
    description: A float representing the standard deviation of a measured compound
      value of an aggregation of compound samples.
    examples:
    - value: '0.61'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: compound_sample_aggregation_standard_deviation
    owner: Component
    domain_of:
    - Component
    range: float
  compound_analytical_measurement_protocol_url:
    name: compound_analytical_measurement_protocol_url
    description: A string denoting a uniform resource locator (URL) linking to a measurement
      protocol used to conduct an analytical analysis on a sample.
    comments:
    - Ideally a protocol with a digital object identifier (DOI) should be used in
      place of a generic URL if possible.
    examples:
    - value: https://doi.org/10.1093/9780197610145.003.3363
    in_subset:
    - RecommendedSubset
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: compound_analytical_measurement_protocol_url
    owner: Component
    domain_of:
    - Component
    range: string
    recommended: true
  compound_analytical_measurement_method:
    name: compound_analytical_measurement_method
    description: A value from an enumerated set of controlled vocabulary terms denoting
      the method used to conduct an analytical analysis on a sample.
    examples:
    - value: HPLC
    in_subset:
    - RecommendedSubset
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: compound_analytical_measurement_method
    owner: Component
    domain_of:
    - Component
    range: CompoundAnalyticalMeasurementMethod
    recommended: true
  compound_analytical_laboratory_name:
    name: compound_analytical_laboratory_name
    description: A string denoting the name of a laboratory that conducted the analytical
      analysis of a component of nutritional interest.
    examples:
    - value: Covance
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: compound_analytical_laboratory_name
    owner: Component
    domain_of:
    - Component
    range: string
  component_quality_control_remeasurement:
    name: component_quality_control_remeasurement
    description: A boolean value denoting TRUE if a component_recorded_value was measured
      more than once for internal laboratory quality control purposes.
    comments:
    - This could be alternatively be modeled with an integer rather than a boolean.
      Note this might give some issues with the way excel saves boolean values.
    examples:
    - value: 'False'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_quality_control_remeasurement
    owner: Component
    domain_of:
    - Component
    range: boolean
  compound_individual_sample_id_list:
    name: compound_individual_sample_id_list
    description: A list of component_sample_id's that were used to create a component
      profile.
    comments:
    - This would typically be the list of individual samples the values of which were
      averaged to create a generic component profile.
    examples:
    - value: '[CY123W2|CY123W3|CY123W7|CY123W5|CY123W4|CY123W6]'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: compound_individual_sample_id_list
    owner: Component
    domain_of:
    - Component
    range: string
    multivalued: true
  component_atwater_protein_conversion_factor:
    name: component_atwater_protein_conversion_factor
    description: A float representing the protein conversion factor used to calculate
      the available energy of a food when employing the Atwater system or a derivative
      thereof.
    comments:
    - The Atwater general factor for protein is 4. See the USDA Handbook 74 https://www.ars.usda.gov/ARSUSERFILES/80400535/DATA/CLASSICS/USDA%20HANDBOOK%2074.PDF
      for the calculation of energy using Atwater specific factors.
    examples:
    - value: '2.78'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_atwater_protein_conversion_factor
    owner: Component
    domain_of:
    - Component
    range: float
  component_atwater_fat_conversion_factor:
    name: component_atwater_fat_conversion_factor
    description: A float representing the fat conversion factor used to calculate
      the available energy of a food when employing the Atwater system or a derivative
      thereof.
    comments:
    - The Atwater general factor for fat is 9. See the USDA Handbook 74 https://www.ars.usda.gov/ARSUSERFILES/80400535/DATA/CLASSICS/USDA%20HANDBOOK%2074.PDF
      for the calculation of energy using Atwater specific factors.
    examples:
    - value: '8.37'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_atwater_fat_conversion_factor
    owner: Component
    domain_of:
    - Component
    range: float
  component_atwater_carbohydrate_conversion_factor:
    name: component_atwater_carbohydrate_conversion_factor
    description: A float representing the carbohydrate conversion factor used to calculate
      the available energy of a food when employing the Atwater system or a derivative
      thereof.
    comments:
    - The Atwater general factor for carbohydrates is of 4. See the USDA Handbook
      74 https://www.ars.usda.gov/ARSUSERFILES/80400535/DATA/CLASSICS/USDA%20HANDBOOK%2074.PDF
      for the calculation of energy using Atwater specific factors.
    examples:
    - value: '3.84'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_atwater_carbohydrate_conversion_factor
    owner: Component
    domain_of:
    - Component
    range: float
  component_protein_from_nitrogen_conversion_factor:
    name: component_protein_from_nitrogen_conversion_factor
    description: A float representing the nitrogen to protein conversion factor used
      to calculate a protein value indirectly using a measured nitrogen value.
    comments:
    - Also known as Jones' factors. https://www.ars.usda.gov/ARSUserFiles/80400525/Data/Classics/cir183.pdf.
      A commonly used value for the component_protein_from_nitrogen_conversion_factor
      is 6.25 based on the assumptions that all proteins have a nitrogen content of
      16%, and that all nitrogen is derived from protein. It should be noted that
      these assumptions might not always hold.
    examples:
    - value: '6.38'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_protein_from_nitrogen_conversion_factor
    owner: Component
    domain_of:
    - Component
    range: float
  food_laboratory_sample_id:
    name: food_laboratory_sample_id
    description: A string denoting an identifier of a laboratory sample which was
      prepared from a food sample.
    comments:
    - Only use this attribute if a separate ID is assigned to laboratory samples derived
      from food samples. Otherwise just use the food_sample_id.
    examples:
    - value: CY124YB_1
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: food_laboratory_sample_id
    owner: Component
    domain_of:
    - Food
    - Component
    range: string
  food_laboratory_sample_aliquot_id:
    name: food_laboratory_sample_aliquot_id
    description: A string denoting an identifier of a unique aliquot of a food laboratory
      sample which was prepared from a food sample.
    comments:
    - Only use this attribute if identifiers are assigned to aliquots/sub-samples
      of food laboratory samples denoted by their food_laboratory_sample_id.
    examples:
    - value: NFY122P11
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: food_laboratory_sample_aliquot_id
    owner: Component
    domain_of:
    - Food
    - Component
    range: string
  food_laboratory_sample_batch_id:
    name: food_laboratory_sample_batch_id
    description: A string denoting an identifier of a batch of laboratory samples
      analysed together.
    examples:
    - value: t
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: food_laboratory_sample_batch_id
    owner: Component
    domain_of:
    - Food
    - Component
    range: string
class_uri: schema:Component