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
- component_limit_of_blank
- component_limit_of_detection
- component_method_detection_limit
- compound_trace_analysis_boolean
- 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 the level above which quantitative results
      may be determined with acceptable accuracy and precision. Limit of quantitation
      (or quantification) (LOQ) is variously defined but must be a value greater than
      the Method Detection Limit (MDL) and should apply to the complete analytical
      method.
    comments:
    - 'Description reference: https://www.fda.gov/science-research/field-science-and-laboratories/field-science-laboratory-manual.
      Alternative definition: the minimum amount/concentration that can be quantified
      with acceptable precision.'
    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
  component_limit_of_blank:
    name: component_limit_of_blank
    description: A float representing the highest apparent analyte concentration expected
      to be found when measuring replicates of a blank sample containing no analyte.
    comments:
    - Description reference from https://www.ncbi.nlm.nih.gov/pmc/articles/PMC2556583/.
    examples:
    - value: '0.0785'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_limit_of_blank
    owner: Component
    domain_of:
    - Component
    range: float
  component_limit_of_detection:
    name: component_limit_of_detection
    description: A string representing the lowest amount of analyte in a sample which
      can be detected but not necessarily quantified as an exact value. It is often
      called the Limit Of Detection (LOD) which is the lowest concentration level
      that can be determined statistically different from a blank at a specified level
      of confidence.
    comments:
    - 'Description reference: https://www.fda.gov/science-research/field-science-and-laboratories/field-science-laboratory-manual.'
    examples:
    - value: <0.15
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_limit_of_detection
    owner: Component
    domain_of:
    - Component
    range: string
  component_method_detection_limit:
    name: component_method_detection_limit
    description: A string representing the Method Detection Limit (MDL), the minimum
      concentration of a substance that can be measured and reported with 99% confidence
      that the analyte concentration is greater than zero. It is determined from analysis
      of a sample in a given matrix containing the analyte.
    comments:
    - 'Description reference: https://www.fda.gov/science-research/field-science-and-laboratories/field-science-laboratory-manual.'
    examples:
    - value: '0.57'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: component_method_detection_limit
    owner: Component
    domain_of:
    - Component
    range: float
  compound_trace_analysis_boolean:
    name: compound_trace_analysis_boolean
    description: A boolean value denoting True if a measured component of nutritional
      is present at a very low concentration, requiring the use of precise analytical
      instrumentation.
    comments:
    - Trace analyses typically refer to analyte concentrations in the range of parts
      per million, parts per billion or lower.
    examples:
    - value: 'False'
    from_schema: https://w3id.org/kaiiam/mifc
    rank: 1000
    alias: compound_trace_analysis_boolean
    owner: Component
    domain_of:
    - Component
    range: boolean
  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