Description of the E-Mail Format For the Aerosols Protocol
NOTE: This version of the Aerosols Protocol e-mail format has changed considerably from
(and is more complicated than) earlier versions.
Do NOT use earlier versions, as they will not be accepted by GLOBE's computers!
There are several advantages to using the e-mail format for reporting GLOBE sun photometer data
for the Aerosols Protocol, even though the format is complicated relative to some other
GLOBE protocols.
- Once you get used to using it, e-mail entry takes less time than online data entry.
- It is easy to submit several days' worth of data all at once. You can mix several different
protocols in the same e-mail entry. They don't have to be in chronological order.
- If you have questions about data you have collected, you can send this format directly to me first, for my
comments. (I have my own software to read and process data in this format.)
- If you are working directly with me on a satellite ground validation project, we have probably
agreed to save data reports even on days when you can collect only metadata. GLOBE will not accept
such reports, but my software will.
Note that GLOBE forwards to me a copy of your data entries, even if you use online data entry,
in e-mail format.
Aerosols (AZ):
Field1: AZ
Field2: School ID
Field3: Atmosphere Site Number
Field4: Day of Measurement (UT) ( YYYYMMDD )
Field5: Sun Photometer Serial Number
Field6: Satellite overflight time ( UT ) ( HHmmss ) ( 6 numbers - i.e. 093000 for 9:30 and 0 seconds )
Field7: Maximum elevation angle of satellite ( degrees )
Field8: Case temperature before taking measurements, multiply voltage reading by 100. ( degrees C )
Field9: Green Sample #1 Measurement Time ( HHmmss ) ( If seconds are unknown, fill with 00 )
Field10: Green Channel sample 1 Light Voltage
Field11: Green Channel sample 1 Dark Voltage
Field12: Red Sample #1 Measurement Time ( HHmmss ) ( If seconds are unknown, fill with 00 )
Field13: Red Channel sample 1 Light Voltage
Field14: Red Channel sample 1 Dark Voltage
Field15: Green Sample #2 Measurement Time ( HHmmss ) ( If seconds are unknown, fill with 00 )
Field16: Green Channel sample 2 Light Voltage
Field17: Green Channel sample 2 Dark Voltage
Field18: Red Sample #2 Measurement Time ( HHmmss ) ( If seconds are unknown, fill with 00 )
Field19: Red Channel sample sample 2 Light Voltage
Field20: Red Channel sample sample 2 Dark Voltage
Field21: Green Sample #3 Measurement Time ( HHmmss ) ( If seconds are unknown, fill with 00 )
Field22: Green Channel sample 3 Light Voltage
Field23: Green Channel sample 3 Dark Voltage
Field24: Red Sample #3 Measurement Time ( HHmmss ) ( If seconds are unknown, fill with 00 )
Field25: Red Channel sample 3 Light Voltage
Field26: Red Channel sample 3 Dark Voltage
Field27: Green Sample #4 Measurement Time ( HHmmss ) ( If seconds are unknown, fill with 00 )
Field28: Green Channel sample 4 Light Voltage
Field29: Green Channel sample 4 Dark Voltage
Field30: Red Sample #4 Measurement Time ( HHmmss ) ( If seconds are unknown, fill with 00 )
Field31: Red Channel sample 4 Light Voltage
Field32: Red Channel sample 4 Dark Voltage
Field33: Green Sample #5 Measurement Time ( HHmmss ) ( If seconds are unknown, fill with 00 )
Field34: Green Channel sample 5 Light Voltage
Field35: Green Channel sample 5 Dark Voltage
Field36: Red Sample #5 Measurement Time ( HHmmss ) ( If seconds are unknown, fill with 00 )
Field37: Red Channel sample 5 Light Voltage
Field38: Red Channel sample 5 Dark Voltage
Field39: Case temperature after taking measurements, multiply voltage reading by 100. ( degrees C )
Field40: Cloud Type (A 10-digit string representing 10 cloud types. Each digit is either a 0 = cloud type not observed, or 1 = cloud type observed.)
1st character Cirrus
2nd character Cirrocumulus
3rd character Cirrostratus
4th character Altostratus
5th character Altocumulus
6th character Stratus
7th character Stratocumulus
8th character Nimbostratus
9th character Cumulus
10th character Cumulonimbus
Field41: Number of observed Short Lived Contrails ( Integer )
Field42: Number of observed Persistent Non-Spreading Contrails ( Integer )
Field43: Number of observed Persistent Spreading Contrails ( Integer )
Field44: Cloud Cover (N=No Clouds, C=Clear, I=Isolated, S=Scattered, B=Broken, O=Overcast, OB=Obscured )
Field45: Contrail Cover ( Integer 1-5 ) ( 1 = None, 2 = 1-10%, 3 = 10-25%, 4 = 25-50%, 5 = 50-100% )
Field46: Obscurations - If Cloud Cover (Field45) is not Obscured (OB) then enter an "X" for no obscurations. If Cloud cover is reported as Obscured, then enter a 10-digit string representing the 10 obscuration types. Each digit being either 0 (obscuration not observed), or 1 (obscuration observed)
1st character Blowing Snow
2nd character Heavy Snow
3rd character Heavy Rain
4th character Fog
5th character Spray
6th character Volcanic Ash
7th character Smoke
8th character Dust
9th character Sand
10th character Haze
Field47: Sky Color ( DB=Deep Blue, B=Blue, LB=Light Blue, PB=Pale Blue, M=Milky )
Field48: Sky Clarity( UC=Unusually Clear, CL=Clear, SH=Somewhat Hazy, VH=Very Hazy, EH=Extremely Hazy )
Field49: Current Air Temperature if obtained following GLOBE Protocol ( degrees C )
Field50: Relative Humidity Measuring Device if obtained following GLOBE Protocol
( S=Sling Psychrometer, D=Digital Hygrometer, O=online or other source)
Field51: Dry Bulb Temperature (with Sling Psychrometer only) ( degrees C )
Field52: Wet Bulb Temperature (with Sling Psychrometer only ) ( degrees C )
Field53: Relative Humidity (%)
Field54: Current Station Pressure (mbar)
Field55: Current Sea Level Pressure (mbars)
Field56: The data Source for pressure Fields 54 or 55 ( 1=Aneroid barometer, 2=Public Broadcast or Online Source, 3=Other )
For each sample number all fields are required. At least three samples are required.
Example:
At atmosphere site number one on May 10, 2001, using a sun photometer with serial number RG4-051,
the following voltages and times were recorded:
channel | MM | DD | YYYY | HH | mm | ss | V |
V-dark |
green | 05 | 10 | 2001 | 16 | 07 | 00 | 1.233 |
0.013 |
red | 05 | 10 | 2001 | 16 | 07 | 30 | 1.340 |
0.014 |
green | 05 | 10 | 2001 | 16 | 08 | 00 | 1.255 |
0.013 |
red | 05 | 16 | 2001 | 16 | 08 | 30 | 1.340 |
0.014 |
green | 05 | 10 | 2001 | 16 | 09 | 00 | 1.255 |
0.013 |
red | 05 | 10 | 2001 | 16 | 09 | 15 | 1.347 |
0.014 |
Note that times must be reported as Universal Time (UTC or UT), not local times.
The data shown here are appropriate for observations just after clock noon during the summer on the
east coast of the United States, for example. (EDT -- Eastern Daylight, or Summer, Time -- is four
hours earlier than UT.) The data
entry sheet for field use contains places for both local and UT times because it may be easier to use local times
in the field. It is usually very difficult or impossible to tell whether you have converted times
correctly. Depending on your time zone, reporting local hours will result in very strange AOT values
or no results at all. It is more often the case that AOT values will still look reasonable even though
the local hour has been reported. The AOT calculations depend strongly on the elevation angle of the
sun which, of course, is directly related to time. So, errors in reporting time will produce AOT
values that may look OK but, in fact, are wrong. Please be careful!
Each set of measurements starts with AZ (or az). A set
of measurements may be continued on more than one line if there
is not enough space on one line. This sun photometer is an older instrument. Newer instruments will have dark voltages of
only a few millivolts (reported as 0.003, for example) or, in some cases,
only a few tenths of a millivolt (reported as 0.0002, for example).
There were some scattered altocumulus and
cirrocumulus clouds when these measurements were taken.
The sky color was light blue, the haze condition was somewhat hazy, the air temperature was
20° C, and the station pressure was 1009 mbar. (Presumably this value was obtained directly
from an aneroid barometer calibrated at sea level.) There were 3 short lived contrails that
covered less than 10% of the sky. With only 3 sets of voltages recorded, all the values for the last
2 samples
must be set to missing. (See the string of 12 X's.) A satellite flew over at 16:08:12 UT with a
maximum elevation angle of 67 degrees above the horizon. The case temperature before the
reading was 24° C and after
the reading it was 25° C. relative humidity was measured with a sling psychrometer, which
gave 37% based on a dry bulb temperature of
20° and a wet bulb temperature of 12°.
Because the sky was not obscured and no sea level pressure value
was reported, these fields are represented by X's. When you report barometric pressure, be
sure to report actual pressure at your site as "station pressure" in Field 54. If you get barometric
pressure from an online, broadcast, or newspaper source, it is invariably sea level pressure,
and should be reported as such in Field 55. Note that because classroom aneroid barometers
(as used for this example) are
typically not very accurate, an online or broadcast weather report is
the preferred source for sea level barometric pressure values. Regardless of whether you report sea level or
station pressure, GLOBE will calculate the missing value based on your site elevation. A common mistake is to report sea level
pressure in the station pressure field. This will lead to errors in the AOT calculation, especially
if your site is at an elevation significantly above sea level. Please be careful!
The comment at the end of the format indicates
the possibility of cirrus cloud contamination during the measurements.
AZ ZZZZTEST 1 20010510 RG4-051 160812 67 23.9
160700 1.233 .0140 160730 1.340 .0140
160800 1.255 .0141 160830 1.349 .0141
160900 1.255 .0141 160915 1.347 .0142
X X X X X X X X X X X X 25.1 0100100000 3 0 0
SC 2 X LB SH 20 S 20 12 37 1009 X 1 Ci contamination possible