Skip to main content

PNNL

  • About
  • News & Media
  • Careers
  • Events
  • Research
    • Scientific Discovery
      • Biology
        • Chemical Biology
        • Computational Biology
        • Ecosystem Science
        • Human Health
          • Cancer Biology
          • Exposure Science & Pathogen Biology
        • Integrative Omics
          • Advanced Metabolomics
          • Chemical Biology
          • Mass Spectrometry-Based Measurement Technologies
          • Spatial and Single-Cell Proteomics
          • Structural Biology
        • Microbiome Science
          • Biofuels & Bioproducts
          • Human Microbiome
          • Soil Microbiome
          • Synthetic Biology
        • Predictive Phenomics
      • Chemistry
        • Computational Chemistry
        • Chemical Separations
        • Chemical Physics
        • Catalysis
      • Earth & Coastal Sciences
        • Global Change
        • Atmospheric Science
          • Atmospheric Aerosols
          • Human-Earth System Interactions
          • Modeling Earth Systems
        • Coastal Science
        • Ecosystem Science
        • Subsurface Science
        • Terrestrial Aquatics
      • Materials Sciences
        • Materials in Extreme Environments
        • Precision Materials by Design
        • Science of Interfaces
        • Solid Phase Processing
          • Cold Spray
          • Friction Stir Welding & Processing
          • ShAPE
      • Nuclear & Particle Physics
        • Dark Matter
        • Fusion Energy Science
        • Neutrino Physics
      • Quantum Information Sciences
    • Energy Resiliency
      • Electric Grid Modernization
        • Emergency Response
        • Grid Analytics
          • AGM Program
          • Tools and Capabilities
        • Grid Architecture
        • Grid Cybersecurity
        • Grid Energy Storage
        • Transmission
        • Distribution
      • Energy Efficiency
        • Appliance and Equipment Standards
        • Building Energy Codes
        • Building Technologies
          • Advanced Building Controls
          • Advanced Lighting
          • Building-Grid Integration
        • Building and Grid Modeling
        • Commercial Buildings
        • Federal Buildings
          • Federal Performance Optimization
          • Resilience and Security
        • Residential Buildings
          • Building America Solution Center
          • Energy Efficient Technology Integration
          • Home Energy Score
        • Energy Efficient Technology Integration
      • Energy Storage
        • Electrochemical Energy Storage
        • Flexible Loads and Generation
        • Grid Integration, Controls, and Architecture
        • Regulation, Policy, and Valuation
        • Science Supporting Energy Storage
        • Chemical Energy Storage
      • Environmental Management
        • Waste Processing
        • Radiation Measurement
        • Environmental Remediation
      • Fossil Energy
        • Subsurface Energy Systems
        • Carbon Management
          • Carbon Capture
          • Carbon Storage
          • Carbon Utilization
        • Advanced Hydrocarbon Conversion
      • Nuclear Energy
        • Fuel Cycle Research
        • Advanced Reactors
        • Reactor Operations
        • Reactor Licensing
      • Renewable Energy
        • Solar Energy
        • Wind Energy
          • Wind Resource Characterization
          • Wildlife and Wind
          • Community Values and Ocean Co-Use
          • Wind Systems Integration
          • Wind Data Management
          • Distributed Wind
        • Marine Energy
          • Environmental Monitoring for Marine Energy
          • Marine Biofouling and Corrosion
          • Marine Energy Resource Characterization
          • Testing for Marine Energy
          • The Blue Economy
        • Hydropower
          • Environmental Performance of Hydropower
          • Hydropower Cybersecurity and Digitalization
          • Hydropower and the Electric Grid
          • Materials Science for Hydropower
          • Pumped Storage Hydropower
          • Water + Hydropower Planning
        • Grid Integration of Renewable Energy
        • Geothermal Energy
      • Transportation
        • Bioenergy Technologies
          • Algal Biofuels
          • Aviation Biofuels
          • Waste-to-Energy and Products
        • Hydrogen & Fuel Cells
        • Vehicle Technologies
          • Emission Control
          • Energy-Efficient Mobility Systems
          • Lightweight Materials
          • Vehicle Electrification
          • Vehicle Grid Integration
    • National Security
      • Chemical & Biothreat Signatures
        • Contraband Detection
        • Pathogen Science & Detection
        • Explosives Detection
        • Threat-Agnostic Biodefense
      • Cybersecurity
        • Discovery and Insight
        • Proactive Defense
        • Trusted Systems
      • Nuclear Material Science
      • Nuclear Nonproliferation
        • Radiological & Nuclear Detection
        • Nuclear Forensics
        • Ultra-Sensitive Nuclear Measurements
        • Nuclear Explosion Monitoring
        • Global Nuclear & Radiological Security
      • Stakeholder Engagement
        • Disaster Recovery
        • Global Collaborations
        • Legislative and Regulatory Analysis
        • Technical Training
      • Systems Integration & Deployment
        • Additive Manufacturing
        • Deployed Technologies
        • Rapid Prototyping
        • Systems Engineering
      • Threat Analysis
        • Advanced Wireless Security
          • 5G Security
          • RF Signal Detection & Exploitation
        • Internet of Things
        • Maritime Security
        • Millimeter Wave
        • Mission Risk and Resilience
    • Data Science & Computing
      • Artificial Intelligence
      • Graph and Data Analytics
      • Software Engineering
      • Computational Mathematics & Statistics
      • Future Computing Technologies
        • Adaptive Autonomous Systems
    • Publications & Reports
    • Featured Research
  • People
    • Inventors
    • Lab Leadership
    • Lab Fellows
    • Staff Accomplishments
  • Partner with PNNL
    • Education
      • Undergraduate Students
      • Graduate Students
      • Post-graduate Students
      • University Faculty
      • University Partnerships
      • K-12 Educators and Students
      • STEM Education
        • STEM Workforce Development
        • STEM Outreach
        • Meet the Team
      • Internships
    • Community
      • Regional Impact
      • Philanthropy
      • Volunteering
    • Industry
      • Available Technologies
      • Industry
      • Industry Partnerships
      • Licensing & Technology Transfer
      • Entrepreneurial Leave
      • Visual Intellectual Property Search (VIPS)
  • Facilities & Centers
    • All Facilities
      • Atmospheric Radiation Measurement User Facility
      • Electricity Infrastructure Operations Center
      • Energy Sciences Center
      • Environmental Molecular Sciences Laboratory
      • Grid Storage Launchpad
      • Institute for Integrated Catalysis
      • Interdiction Technology and Integration Laboratory
      • PNNL Portland Research Center
      • PNNL Seattle Research Center
      • PNNL-Sequim (Marine and Coastal Research)
      • Radiochemical Processing Laboratory
      • Shallow Underground Laboratory

Breadcrumb

  1. Home
  2. Projects
  3. EARTH - Environmental Sciences and Risk Analyses Tools

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. 

PNNL

  • Get in Touch
    • Contact
    • Careers
    • Doing Business
    • Environmental Reports
    • Security & Privacy
    • Vulnerability Disclosure Policy
  • Research
    • Scientific Discovery
    • Energy Resiliency
    • National Security
Subscribe to PNNL News
Department of Energy Logo Battelle Logo
Pacific Northwest National Laboratory (PNNL) is managed and operated by Battelle for the Department of Energy
  • YouTube
  • Facebook
  • X (formerly Twitter)
  • Instagram
  • LinkedIn