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.
