Skip to main content

Format & Content

Joint Atmosphere Product (ATML2) File Format Basics

Joint Atmosphere Product files are stored in Hierarchical Data Format (HDF). HDF is a multi-object file format for sharing scientific data in multi-platform distributed environments. HDF files should only be accessed through HDF library subroutine and function calls, which can be downloaded from the HDF web site. Each of the parameters listed below is stored as a Scientific Data Set (SDS) within the HDF file.

There are two sets of geolocation arrays in the Joint Atmosphere product. The first (default) set is for the 5-km resolution parameters, which are derived from the Water Vapor (05_L2), Cloud (06_L2), Profile (07_L2), and Cloud Mask (35_L2) products. These 5-km geolocation arrays have the Scientific Data Set (SDS) names: Latitude and Longitude.

The second set is for the 10-km resolution parameters, which are derived from the Aerosol (04_L2) product. These 10-km geolocation arrays have the SDS names: Latitude_10km and Longitude_10km. Users should ensure they are using the correct geolocation array when working with various parameters in the file.

Joint Atmosphere Product (ATML2) Scientific Data Sets 
(Primary SDS's only, not a complete list)

 

5-km Resolution Parameters

5-km Geolocation

  • Latitude  (Daytime, Nighttime, Packed)
    Description: Latitude for 5-km parameters.
    Source Product, SDS: 06_L2, Latitude
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, day & night
    Notes: For reduced file size, Real*4 source data are repacked as Integer*2. A precision loss of 1/1000th of a degree results.
  • Longitude  (Daytime, Nighttime, Packed)
    Description: Longitude for 5-km parameters.
    Source Product, SDS: 06_L2, Longitude
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, day & night
    Notes: For reduced file size, Real*4 source data are repacked as Integer*2. A precision loss of 1/1000th of a degree results. 

Water Vapor (05_L2)

  • Precipitable_Water_Near_Infrared_Clear  (Daytime, Sampled, Renamed)
    Description: Total column precipitable water vapor (cm) for clear sky (bright land and sunglint ocean only) using near infrared retrieval.
    Source Product, SDS: 05_L2, Water_Vapor_Near_Infrared
    Array type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Clear sky data are collected by using the Surface Type Flag in the 05_L2 SDS Quality_Assurance_Near_Infrared. Flag values of 0 (bright land) and 3 (ocean glint) only are used to pass data through to array. SDS name changed to clarify aggregation.

Cloud (06_L2)

Cloud Top Properties

  • Cloud_Top_Pressure   (Daytime, Nighttime)
    Description: Cloud top pressure (hPa) at 5x5 1-km pixel resolution using infrared retrieval methods. If less than 4 out of the 25 1-km pixels are cloudy (cloud fraction < 16%), then the 5x5 km area is processed using the "clear" retrieval path and cloud top pressure is set to missing (fill). This is done because CO2-slicing is not sensitive enough to give an accurate cloud top pressure when the cloud fraction is less than around 15%.
    Source Product, SDS: 06_L2, Cloud_Top_Pressure
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, day & night
    Notes: Data duplicated exactly from source file.
  • Cloud_Top_Temperature   (Daytime, Nighttime)
    Description: Cloud top temperature (K) at 5x5 1-km pixel resolution using infrared retrieval methods. If less than 4 out of the 25 1-km pixels are cloudy (cloud fraction < 16%), then the 5x5 km area is processed using the "clear" retrieval path and cloud top temperature is set to missing (fill). This is done because CO2-slicing is not sensitive enough to give an accurate cloud top pressure, from which temperature is derived, when the cloud fraction is less than around 15%.
    Source Product, SDS: 06_L2, Cloud_Top_Temperature
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, day & night
    Notes: Data duplicated exactly from source file.
  • Cloud_Fraction  (Daytime, Nighttime)
    Description: Cloud fraction at 5-km derived from 1-km cloud mask (5x5 1-km pixel resolution) using solar and infrared tests. Fractions are computed as: [(count of lowest 2 clear sky confidence levels, cloudy & probably cloudy) / (total count)].
    Source Product, SDS: 06_L2, Cloud_Fraction
    Array Type, Dimension, Size: Int*1, 406x270, 109k
    Resolution, Mode: 5-km, day & night
    Notes: Data duplicated exactly from source file. Due to computational characteristics, cloud fractions are typically computed in 4% increments [0%, 4%, 8%, ... 96%, 100%], the exceptions are in areas where 1 or more of the 5x5 1-km cloud mask pixels contain missing data or fill (in other words, invalid cloud mask values -- for example in severe sun-glint regions like the Gulf of Mexico in June). Only cloud fractions of 16% and above will have corresponding non-fill cloud top pressure and cloud top temperature data associated with them (see Cloud Top Pressure and Temperature Description fields, above).
  • Cloud_Phase_Infrared  (Daytime, Nighttime)
    Description: Cloud Phase as determined by the UW Infrared algorithm.
    Source Product, SDS: 06_L2, Cloud_Phase_Infrared
    Array Type, Dimension, Size: Int*1, 406x270, 109k
    Resolution, Mode: 5-km, day & night
    Notes: Data duplicated exactly from source file. Key: [ 0 = Clear, 1 = Liquid Water Phase Cloud, 2 = Ice Phase Cloud, 3 = Mixed Phase Cloud, 6 = Undetermined Phase Cloud ]

Cloud Optical Properties

  • Cloud_Optical_Thickness  (Daytime, Sampled)
    Description: Cloud optical thickness at 0.66 µm derived from a two-channel retrieval using MODIS band 7 and either band 1, 2, 5.
    Source Product, SDS: 06_L2, Cloud_Optical_Thickness
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Optical_Thickness_Uncertainty  (Daytime, Sampled)
    Description: Cloud Optical Thickness Relative Uncertainty (Percent).
    Source Product, SDS: 06_L2, Cloud_Optical_Thickness_Uncertainty
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Effective_Radius  (Daytime, Sampled)
    Description: Cloud particle effective radius (µm) derived from a two-channel retrieval using MODIS band 7 and either band 1, 2, 5.
    Source Product, SDS: 06_L2, Cloud_Effective_Radius
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Effective_Radius_Uncertainty   (Daytime, Sampled)
    Description: Cloud Effective Radius Relative Uncertainty (Percent).
    Source Product, SDS: 06_L2, Cloud_Effective_Radius_Uncertainty
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Water_Path  (Daytime, Sampled)
    Description: Column Cloud Water Path two-band retrieval using band 7 and either band 1, 2, 5.
    Source product, SDS: 06_L2, Cloud_Water_Path
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Water_Path_Uncertainty  (Daytime, Sampled)
    Description: Cloud Water Path Relative Uncertainty (Percent).
    Source Product, SDS: 06_L2, Cloud_Water_Path_Uncertainty
    Array Type, Dimension, size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Optical_Thickness_1621  (Daytime, Sampled)
    Description: Cloud optical thickness two-channel retrieval using band 7 and band 6
    Source Product, SDS: 06_L2, Cloud_Optical_Thickness_1621
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Optical_Thickness_Uncertainty_1621 (Daytime, Sampled)
    Description: Cloud Optical Thickness Relative Uncertainty (Percent) using band 7 and band 6
    Source Product, SDS: 06_L2, Cloud_Optical_Thickness_Uncertainty_1621
    Array Type, Dimension, size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Effective_Radius_1621  (Daytime, Sampled)
    Description: Cloud Particle Effective Radius two-channel retrieval using band 7 and band 6
    Source Product, SDS: 06_L2, Cloud_Effective_Radius_1621
    Array Type, dimension, size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Effective_Radius_Uncertainty_1621  (Daytime, Sampled)
    Description: Cloud Effective Particle Radius Relative Uncertainty (Percent) using band 7 and band 6
    Source Product, SDS: 06_L2, Cloud_Effective_Radius_Uncertainty_1621
    Array Type, Dimension, size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Water_Path_1621  (Daytime, Sampled)
    Description: Column Cloud Water Path two-band retrieval using band 7 and band 6.
    Source Product, SDS: 06_L2, Cloud_Water_Path_1621
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Water_Path_Uncertainty_1621  (Daytime, Sampled)
    Description: Cloud Water Path Relative Uncertainty (Percent) using band 7 and band 6
    Source Product, SDS: 06_L2, Cloud_Water_Path_Uncertainty_1621
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. Note that all cloud phases (liquid water, ice, and undetermined phase) are represented in the parameter; users must read the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS to determine the cloud phase represented by each pixel.
  • Cloud_Phase_Optical_Properties  (Daytime, Sampled)
    Description: Cloud Phase as determined by the Cloud Optical Property algorithm. Note that this phase flag is identical for both the primary retrieval and the 1.6/2.1 µm retrieval.
    Source Product, SDS: 06_L2, Cloud_Phase_Optical_Properties
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. This information is identical to that stored in the Cloud Phase (Retrieval Processing Path) Flag in the Cloud_Quality_Assurance SDS; but is stored here to simplify its access by users. Key: [ 0 = Fill (Cloud Mask undetermined), 1 = Decision Tree Stop (typically Clear), 2 = Liquid Water Phase Cloud, 3 = Ice Phase Cloud, 4 = Undetermined Phase Cloud ]
  • Cloud_Quality_Assurance  (Daytime, Sampled, Renamed, Bit Flags)
    Description: Cloud Optical Property QA Flags.
    Source Product, SDS: 06_L2, Quality_Assurance_1km
    Array Type, Dimension, Size: Int*1, 9x406x270, 981k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km. The complete Collection 6 9-byte QA Flag array is copied from the source (input) SDS. SDS name changed to clarify application. Note that for Collection 004 this array was only 1 byte in length and contained only 4 flags. For Collection 005 this array was expanded to 5 bytes in length and set to match the source C5 SDS ("Quality_Assurance_1km" from 06_L2) exactly. For Collection 006, this array was expanded to 9 bytes in length and set to match the source C6 SDS ("Quality_Assurance_1km" from 06_L2) exactly.
    Key: For help reading QA (bit) flag arrays, review the QA Plan.

Cirrus Detection

  • Cirrus_Reflectance  (Daytime, Sampled)
    Description: Cirrus reflectance at 0.66 µm.
    Source Product, SDS: 06_L2, Cirrus_Reflectance
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, daytime only
    Notes: Source data at 1-km is subsampled at 5-km.

Atmosphere Profile (07_L2)

  • Precipitable_Water_Infrared_Clear   (Daytime, Nighttime, Renamed)
    Description: Total column precipitable water vapor (cm) for clear sky using infrared retrieval.
    Source Product, SDS: 07_L2, Water_Vapor
    Array Type, Dimension, Size: Int*2, 406x270, 219k
    Resolution, Mode: 5-km, day & night
    Notes: Data duplicated exactly from source file. SDS name changed to clarify application.

Cloud Mask (35_L2)

  • Cloud_Mask     (Daytime, Nighttime, Sampled, Bit Flags)
    Description: Cloud mask information. Source Product, SDS: 35_L2, Cloud_Mask (1st byte only)
    Array Type, Dimension, Size: Int*1, 406x270, 109k
    Resolution, Mode: 5-km, day & night
    Notes: Source data at 1-km is subsampled at 5-km. Only the first byte is copied from the source (input) SDS. The first byte contains six QA flags.
    Key: For help reading QA (bit) flag arrays, review the Bit Interpretation information at the bottom of the FAQ Data Logistics page.
     

Cloud_Mask (Bit) Flag Description Key: 1st byte only

All bit and byte numbering starts at 0

Right (least significant bit) to Left (most significant bit)

Byte #0

Bits

Field Description

Bit Interpretation Key

0

Cloud Mask Flag

0=Not Determined

1 = Determined

1-2

Unobstructed FOV Cloudiness Flag

0 = Cloudy

1 = Probably Cloudy

2 = Probably Clear

3 = Confident Clear

3

Day/Night Flag

0 = Night
1 = Day

4

Sunglint Flag

0 = Yes
1 = No

5

Snow/Ice Background Flag

0 = Yes
1 = No

6-7

Land/Water Flag

0 =Water

1 = Coastal 

2 = Desert 

3 = Land

10-km Resolution Parameters

10-km Geolocation

  • Latitude_10km    (Daytime, Packed, Renamed)
    Description: Latitude for 10-km parameters.
    Source Product, SDS: 04_L2, Latitude
    Array Type, Dimension, Size: Int*2, 203x135, 54k
    Resolution, Mode: 10-km, daytime only
    Notes: For reduced file size, Real*4 source data are repacked as Integer*2. A precision loss of 1/1000th of a degree results. SDS name changed to clarify application.
  • Longitude_10km  (Daytime, Packed, Renamed)
    Description: Longitude for 10-km parameters.
    Source Product, SDS: 04_L2, Longitude
    Array Type, Dimension, Size: Int*2, 203x135, 54k
    Resolution, Mode: 10-km, daytime only
    Notes: For reduced file size, Real*4 source data are repacked as Integer*2. A precision loss of 1/1000th of a degree results. SDS name changed to clarify application.

10-km Zenith & Azimuth Angles

  • Solar_Zenith_10km  (Daytime, Renamed)
    Description: Solar zenith angle (cell to sun) for 10-km parameters.
    Source Product, SDS: 04_L2, Solar_Zenith
    Array Type, Dimension, Size: Int*2, 203x135, 54k
    Resolution, Mode: 10-km, daytime only
    Notes: Data duplicated exactly from source file. SDS name changed to clarify application.
  • Viewing_Zenith_10km  (Daytime, Renamed)
    Description: Sensor zenith angle (cell to sensor) for 10-km parameters.
    Source Product, SDS: 04_L2, Sensor_Zenith
    Array Type, Dimension, Size: Int*2, 203x135, 54k
    Resolution, Mode: 10-km, daytime only
    Notes: Data duplicated exactly from source file. SDS name changed to clarify application.
  • Relative_Azimuth_10km  (Daytime, Renamed)
    Description: Relative azimuth angle for 10-km parameters. Computation equation: if ( abs (sensor_azimuth - solar_azimuth) > 180) then RA = 360 - abs ( sensor_azimuth - solar_azimuth ) else RA = abs ( sensor_azimuth - solar_azimuth )
    Array Type, Dimension, Size: Int*2, 203x135, 54k
    Resolution, Mode: 10-km, daytime only
    Notes: New angle parameter computed from input sensor and solar azimuth angle data.

Aerosol (04_L2)

  • Aerosol_Optical_Depth  (Daytime, Renamed)
    Description: Aerosol optical depth at 0.55 µm over land (corrected solution) and ocean (best solution).
    Source Product, SDS: 04_L2, Optical_Depth_Land_And_Ocean
    Array Type, Dimension, Size: Int*2, 203x135, 54k
    Resolution, Mode: 10-km, daytime only
    Notes: Data duplicated exactly from source file. SDS name changed to clarify application.
  • Aerosol_Optical_Depth_Ratio_Small  (Daytime, Renamed)
    Description: Ratio of small mode optical depth to all modes at 0.55 µm over land and ocean.
    Source Product, SDS: 04_L2, Optical_Depth_Ratio_Small_Land_And_Ocean
    Array Type, Dimension, Size: Int*2, 203x135, 54k
    Resolution, Mode: 10-km, daytime only
    Notes: Data duplicated exactly from source file. SDS name changed to clarify application.
  • Aerosol_Solution_Index_Ocean_Small_Average  (Daytime, Renamed)
    Description: Solution number index (1 through 4) for small aerosol particles (average solution only) over ocean. Indices of ocean models 1 through 4 correspond to accumulation (small) mode models with effective radii 0.10, 0.15, 0.20, 0.25 µm, respectively.
    Source Product, SDS: 04_L2, Solution_Index _Ocean_Small
    Array Type, Dimension, Size: Int*1, 203x135, 27k
    Resolution, Mode: 10-km, daytime only
    Notes: Data packed from Int*2 in source file to Int*1 to save space (causes no data accuracy loss). Only the 2nd (average) solution is kept. SDS name changed to clarify application.
  • Aerosol_Solution_Index_Ocean_Large_Average  (Daytime, Renamed)
    Description: Solution number index (5 through 9) for large aerosol particles (average solution only) over ocean. Indices of ocean models 5 through 7 correspond to coarse (large) mode models of marine (sea salt) particles with effective radii 1.0, 1.5, 2.0 µm, respectively. Indices of ocean models 8 and 9 correspond to coarse (large) mode models of mineral dust particles with effective radii 1.5 and 2.5 µm, respectively.
    Source Product, SDS: 04_L2, Solution_Index _Ocean_Large
    Array Type, Dimension, Size: Int*1, 203x135, 27k
    Resolution, Mode: 10-km, daytime only
    Notes: Data packed from Int*2 in source file to Int*1 to save space (causes no data accuracy reduction). Only the 2nd (average) solution is kept. SDS name changed to clarify application.
  • Deep_Blue_Aerosol_Optical_Depth_550_Land  (Daytime)
    Description: AOT at 0.55 micron for land (corrected) with all quality data (Quality flag=1,2,3).
    Source Product, SDS: 04_L2, Deep_Blue_Aerosol_Optical_Depth_550_Land
    Array Type, Dimension, Size: Int*2, 203x135, 54k
    Resolution, Mode: 10-km, daytime only
  • Deep_Blue_Angstrom_Exponent_Land  (Daytime)
    Description: Deep Blue Angstrom Exponent for land (0.412-0.47 micron) with all quality data (Quality flag=1,2,3).
    Source Product, SDS: 04_L2, Deep_Blue_Angstrom_Exponent_Land
    Array Type, Dimension, Size: Int*2, 203x135, 54k
    Resolution, Mode: 10-km, daytime only
  • Deep_Blue_Single_Scattering_Albedo_412_Land  (Daytime, Renamed)
    Description: Deep Blue Single Scattering Albedo at 0.412 micron for land with all quality data (Quality flag=1,2,3).
    Source Product, SDS: 04_L2, Deep_Blue_Single_Scattering_Albedo_Land
    Array Type, Dimension, Size: Int*2, 203x135, 54k
    Resolution, Mode: 10-km, daytime only
  • Deep_Blue_Aerosol_Quality_Assurance   (Daytime, Renamed, Bit Flags)
    Description: QA flags for (deep blue) aerosol retrievals over land.
    Source Product, SDS: 04_L2, Quality_Assurance_Land
    Array Type, Dimension, Size: Int*1, 203x135, 27k
    Resolution, Mode: 10-km, daytime only
    Notes: First populated in C006.
    Key: For help reading QA (bit) flag arrays, review the QA Plan.
  • Aerosol_Quality_Assurance  (Daytime, Renamed, Bit Flags)
    Description: QA flags for aerosol retrievals over land and ocean.
    Source Product, SDS: 04_L2, Quality_Assurance_Land {2 QA flags only} and Quality_Assurance_Ocean {1 QA flag only}
    Array Type, Dimension, Size: Int*1, 203x135, 27k
    Resolution, Mode: 10-km, daytime only
    Notes: Only six bits gleaned from two QA arrays in the source (input) 04_L2 HDF file are set. SDS name changed to clarify application.
    Key: For help reading QA (bit) flag arrays, review the QA Plan.