Skip to Main Content U.S. Department of Energy
EARTH at PNNL

Frames 1x

Exposure Pathways File (.EPF)

The output from the Exposure Pathways component is the concentration of each pollutant for a given route and pathway. The EPF is the input to the Receptor Intake Component which produces estimates of pollutant intakes. Currently the EPF has one qualifier type: "Exposure Pathways".

The following outline is a description of the basic information provided in the EPF. This file may be modified through an API. See the Software Development Kit (SDK) for more information. An example EPF is included after the outline. Comparing the line-by-line description in the outline to the example should clarify and help locate data contained in the EPF. Lines beginning with ';' are descriptive comments only and will not appear in the actual EPF.



For each 'Module' producing an EPF section
  A line with:
    Module Name - [STRING]
    Number of Lines in section - [INTEGER]
  End Line
  A line with:
    Number of Header Lines - [INTEGER]
  End Line
  For each 'Header Line' A line with:
    A line with:
      Header information - [STRING]
    End Line
  Next 'Header Line'
  A line with:
    Number of Data Sets - [INTEGER]
  End Line
  For each 'Data Set'
    A line with:
      Data set type - [Const STRING] - "acute" / "chronic"
      File Extension - [STRING]
        ;If 'Data Set' is user defined then
        ;  'File Extension' is ""
        ;Else 'File Extension' is a valid PDCF Extension (i.e. "SCF"/ "WCF" / ...)
        ;  The consumed PDCF's extension used to generate this data set
        ;EndIf
        ;If more than one input file was used to generate this data set then
        ;  Separate each with a semicolon (e.g. "SCF:WCF")
        ;EndIf
      File Qualifier - [STRING]
        ;If 'Data Set' is user defined then
        ;  'File Qualifier' is the media that exposed this data set
        ;Else 'File Qualifier' is a valid PDCF Qualifier for 'File Extension' (i.e. "Sediment" / "Aquifer" / ...)
        ;  The consumed PDCF's qualifier used to generate this data set
        ;EndIf
        ;If more than one input file was used to generate this data set then
        ;  Separate each with a semicolon (e.g. "Sediment:quifer")
        ;EndIf
      Number of Exposure Media Points - [INTEGER]
      Number of Constituents - [INTEGER]
    End Line
    For each 'Exposure Media Point'
      A line with:
        X coordinate - [FLOAT]
        X coordinate unit - [Const STRING] - "km"
        Y coordinate - [FLOAT]
        Y coordinate unit - [Const STRING] - "km"
      End Line
    Next 'Exposure Media Point'
    For each 'Constituent'
      A line with:
        Constituent Name - [STRING]
        Constituent ID - [STRING]
        Number of Progeny - [INTEGER] - 0
        ;  must be set to zero for 1.6+ specifications
        Number of Exposure Start Times - [INTEGER]
      End Line
      For each 'Exposure Start Time'
        A line with:
          Exposure Start Time - [FLOAT]
          Exposure Start Time unit - [Const STRING] - "yr"
          Exposure Duration - [FLOAT]
          Exposure Duration unit - [Const STRING] - "yr"
          Number of Exposure Pathways - [INTEGER]
        End Line
        For each 'Exposure Pathway'
          A line with:
            Exposure Pathway Name - [STRING]
              ;"Air" / "Indoor air" / "Ground" / "Leafy vegetables" /
              ;"Root vegetables" / "Fruit" / "Grain" / "Beef" /
              ;"Poultry" / "Milk" / "Eggs" / "Soil" / "Swimming" /
              ;"Boating" / "Shoreline" / "Water" / "Fish" / "Mollusks" /
              ;"Crustacea" / "Aquatic plants" / "Showering" / ...
            Exposure Route - [STRING]
              ;"Ingestion" / "Inhalation" / "Dermal" / "External"
            Exposure Concentration unit - [Const STRING]
              ;"Bq/kg" / "Bq/l" / "Bq/m3" for radionuclides
              ;"mg/kg" / "mg/l" / "mg/m3" for non-radionuclides
              ;"Sv" for external routes
          End Line
          A line with:
            Exposure Concentration - [Set of FLOAT]
              ;a concentration For each 'Exposure Media Point'
          End Line
        Next 'Exposure Pathway'
      Next 'Exposure Start Time'
    Next 'Constituent'
  Next 'Data Set'
Next 'Module'

This EPF Example was created using the case_01 test case. For testing information visit the Frames Wiki Wiki Testing page.

Go to Specifications | Go to Top

EARTH

APPLICATION

DESIGN

SOFTWARE &
DEVELOPMENT TOOLS

TRAINING

Related EARTH Links