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

Frames 1x

Air Transport Output File (.ATO)

The ATO file provides data for use by exposure pathway modules for airborne releases and atmospheric transport and deposition of pollutants. The basic data sets are provided as point values at specific locations relative to the release point. Use of keywords is suggested, although other methods of describing data types could be used (e.g. logical or integer flags). Currently the ATO has six qualified types those are: "Acute Polar Air", "Polar Air", "Acute Cartesian Air", "Cartesian Air", "Acute Air", and "Air".

The following outline is a description of the basic information provided in the ATO. This file may be modified through an API. See the Software Development Kit (SDK) for more information. An example ATO file 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 ATO file. Lines beginning with ';' are descriptive comments only and will not appear in the actual ATO.



For each 'Module' producing an ATO 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:
      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:
      Number of Flux Types - [INTEGER]
      Data Set name - [STRING]
    End Line
    For each 'Flux Type'
      A line with:
        Flux Type Name - [STRING]
          ;If Gas, then
          ;  'Flux Type Name' = "Gas 1"
          ;ElseIf Particle then "Particle #" followed by the particle count
          ;  'Flux Type Name' = "Particle 1" / "Particle 2" / "Particle 3", ...
          ;EndIf
        If Type Name = "Gas #" then
          Reactive Gas fraction - [FLOAT]
          Reactive Gas fraction unit - [Const STRING] - "fraction"
        Else
          Particle Radius - [FLOAT]
          Particle Radius unit - [Const STRING] - "um"
        EndIf
        Flux Type Density - [FLOAT]
        Flux Type Density unit - [Const STRING] - "g/cm^3"
      End Line
    Next 'Flux Type'
    A line with:
      Release type - [Const STRING] - "acute" / "chronic"
      Co-ordinate grid type - [Const STRING] - "polar" / "cartesian"
      Spatial type - [Const STRING] - "grid" / "points"
      Number of Constituents - [INTEGER]
    End Line
    For each 'Constituent'
      A line with:
        Constituent Name - [STRING]
        Constituent ID - [STRING]
        Number of Time Periods - [INTEGER]
        Number of Progeny - [INTEGER]
        ;  must be set to zero for 1.6+ specifications
      End Line
      For each 'Time Period'
        A line with:
          Time - [FLOAT]
          If 'Release Type' = "acute" then
            Time unit - [Const STRING] - "hr"
          ElseIf 'Release Type' = "chronic" then
            Time unit - [Const STRING] - "yr"
          EndIf
          Number of Output Products - [INTEGER]
        End Line
        For each 'Output Product'
          A line with:
            Output Product Name - [Const STRING] - "Air Concentration" / "Deposition Rate" / "External Dose"
            Output Product Flux Type' - [Const STRING]
              ;If 'OutPut Product Name' = "Air Concentration" or "Deposition Rate" then
              ;  'Output Product Flux Type' = "Particle 1" / "Particle 2" / "Particle 3" / "Gas 1"
              ;Else
              ;  'Output Product Flux Type' = ""
              ;EndIf
            Relative Moisture of Output Product - [Const STRING] - "wet" / "dry" / "total"
              ;If 'Output Product Name' = "Deposition Rate" then
              ;  'Relative Moisture of Output Product' = "wet" / "dry" / "total"
              ;Else
              ;  'Relative Moisture of Output Product' = ""
              ;EndIf
            Output Product unit - [Const STRING]
              ;If 'OutPut Product Name' = "Air Concentration"
              ;  Output Product unit = "Bq/m^3" / "kg/m^3"
              ;ElseIf 'OutPut Product Name' = "Deposition Rate" then
              ;  If 'Release Type' = "acute" then
              ;    Output Product unit = "Bq/m^2/hr" / "kg/m^2/hr"
              ;  EndIf
              ;  If 'Release Type' = "chronic" then
              ;    Output Product unit = "Bq/m^2/yr" / "kg/m^2/yr"
              ;  EndIf
              ;Else 'OutPut Product Name' = "External Dose" then
              ;  Output Product unit = - "Sv"
              ;EndIf
            If 'Co-ordinate grid type' = "polar" and 'Spatial type' = "grid" then
              Number of Radial Distances - [INTEGER]
            ElseIf 'Co-ordinate grid type' = "cartesian" and 'Spatial type' = "grid" then
              Number of x Co-ordinates - [INTEGER]
            Else 'Co-ordinate grid type' = "cartesian" and 'Spatial type' = "points" then
              Number of x, y coordinate points - [INTEGER]
            EndIf
            If 'Co-ordinate grid type' = "polar" then
              Unit of Radial Distances - [Const STRING] - "m"
            Else 'Co-ordinate grid type' = "cartesian"
              Unit of x Co-ordinate - [Const STRING] - "m"
            EndIf
            If 'Co-ordinate grid type' = "polar" and 'Spatial type' = "grid" then
              Number of Directions - [INTEGER]
            ElseIf 'Co-ordinate grid type' = "cartesian" and 'Spatial type' = "grid" then
              Number of y Co-ordinates - [INTEGER]
            Else 'Co-ordinate grid type' = "cartesian" and 'Spatial type' = "points" then
              Number - [INTEGER] - 1
            EndIf
            If 'Co-ordinate grid type' = "polar" then
              Unit of Directions - [Const STRING] - "deg"
            Else 'Co-ordinate grid type' = "cartesian"
              Unit of y Co-ordinate - [Const STRING] - "m"
            EndIf
          End Line
          If 'Spatial type' = "grid" then
            A line with:
              All Radial Distances or x Co-ordinates - [Set of FLOAT]
              If 'Co-ordinate grid type' = "polar" then
                For each 'Direction'
                  A line with:
                    Direction - [FLOAT]
                    Output Product Value for the 'Radial Distance' and 'Direction' - [FLOAT]
                  End Line
                Next 'Direction'
              Else 'Co-ordinate grid type' = "cartesian" then line with:
                For each 'y Co-ordinate'
                  A line with:
                    y Co-ordinate - [FLOAT]
                    Output Product Value for the 'x, y Co-ordinate' pair - [FLOAT]
                  End Line
                Next 'Direction'
              EndIf
            End Line
          Else 'Spatial type' = "points"
            A line with: Name of Reporting Points - (set of strings)
            A line with: Values of x Co-ordinates For each point - [Set of FLOAT]
            A line with: Values of y Co-ordinates For each point - [Set of FLOAT]
            A line with:
              Number - [INTEGER] - 99
              Output Product Values For each point - [Set of FLOAT]
            End Line
          EndIf
        Next 'Output Product'
      Next 'Time Period'
    Next 'Constituent'
  Next 'Data Set'
Next 'Module'


This ATO 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