tovret - uses a physical retrieval model to obtain vertical atmospheric profiles.

tovret - Uses a physical retrieval model to obtain vertical atmospheric profiles.

SYNOPSIS

tovret

Parameters are: LETTER, SFC-DATA_FLAG, GUESS_TYPE, START_LINE, START_ELEM, NUMBER_OF_LINES, NUMBER_OF_ELEMS, LINE-INCREMENT, ELEM-INCREMENT, TOPOGRAPHY_FLAG, MWHS, DIAGNOSTICS_PRINT_FLAG, RTVL-FILE_INIT_FLAG

DESCRIPTION

tovret uses a physical retrieval model to obtain vertical profiles of atmospheric temperature, humidity, geopotential height, total ozone, and stability parameters. This program can operate on HIRS and MSU data that have been limb-corrected or not, however, the latter seems to give better results. Tovret is our most up-to-date model. It obtains solutions for temperature and water vapor in a single step from combined infrared and microwave measurements.

Input files: TOVSND?.DAT TOVSORB?.DAT Output file: TOVSRET?.DAT

The question mark (?) should be replaced with the response to the ENTER LETTER OF FILE TO PROCESS parameter. The TERASCAN TOVS implementation includes the Sept. 27, 1988 corrections to TOVRET.

STRUCTURE OF THE 'TOVRET' FILE

      ACCESS ROUTINE: RETIO
      RECORD LENGTH = 112 INTEGER*4 WORDS
CONTENTS OF FIRST RECORD ('DOCUMENTATION' OR 'HEADER'):
      IBUF( 1) = YYDDD AT START OF PASS
      IBUF( 2) = HHMMSS AT START OF PASS
      IBUF( 3) = HHMMSS AT END OF PASS
      IBUF( 4) = NUMBER OF HIRS LINES IN PASS
      IBUF( 5) = SATELLITE IDENTIFICATION (1=ODD, 2=EVEN)
      IBUF( 6) = STATUS (TO IDENTIFY USER, ETC.)
      IBUF( 7) = DIRECTION (1=ASCENDING, 2=DESCENDING)
      IBUF(8:49) NOT MEANINGFUL
      IBUF(50) = START TIME OF PASS IN MILLISECONDS
      IBUF(51) = HIRS LIMB-CORRECTION FLAG (0=ON,1=OFF)
      IBUF(52) = MSU  LIMB-CORRECTION FLAG (0=ON,1=OFF)
      IBUF(53:109) NOT MEANINGFUL
      IBUF(110) = LINE-COORDINATE OF LAST SOUNDING MADE
      IBUF(111) = ELEM-COORDINATE OF LAST SOUNDING MADE
      IBUF(112) = NUMBER OF SOUNDINGS MADE

CONTENTS OF INDIVIDUAL SOUNDING RECORDS

All pressures are in units of millibars. All temperatures are in units of degrees KELVIN X 100. A value of 999999 denotes 'MISSING' or 'FILL'.

      IBUF( 1)   = LATITUDE  (DEG X 100,+N,-S)
      IBUF( 2)   = LONGITUDE (DEG X 100,+E,-W)
      IBUF( 3)   = TIME (HHMM)
      IBUF( 4)   = SURFACE ELEVATION (METERS ABOVE MSL)
      IBUF(5:19) = GEOPOTENTIAL HEIGHT (METERS)
      IBUF(20)   = AIR TEMPERATURE AT GROUND LEVEL (OR 1000 MB)
      IBUF(21:34)= AIR TEMPERATURE AT 850, 700, ..., 10 MB
      IBUF(35)   = DEW-POINT TEMPERATURE AT GROUND LEVEL (OR 1000 MB)
      IBUF(36:40)= DEW-POINT TEMPERATURE AT 850, 700, ..., 300 MB
      IBUF(41:59)= HIRS BRIGHTNESS TEMPERATURES, CHANNELS 1 - 19
      IBUF(60:63)=  MSU BRIGHTNESS TEMPERATURES, CHANNELS 1 - 4
      IBUF(64)   = SURFACE SKIN TEMPERATURE
      IBUF(65)   = IMAGE-LINE COORDINATE AT CENTER OF RETRIEVAL BOX
      IBUF(66)   = IMAGE-ELEMENT COORDINATE AT CENTER OF BOX
      IBUF(67)   = PRESSURE AT GROUND LEVEL
      IBUF(68:77)= FIRST-GUESS TEMPERATURE AT 1000, 850, ..., 100 MB
      IBUF(78:82)= FIRST-GUESS DEW-POINT AT 850, 700, ..., 300 MB
      IBUF(83:90)= FILL
      IBUF(91)   = TOTAL-TOTALS STABILITY INDEX (DEG X 100)
      IBUF(92:95)= FILL
      IBUF(96)   = TOTAL OZONE (DOBSON UNITS X 100)
      IBUF(97)   = TOTAL PRECIPITABLE WATER VAPOR (MM X 100)
      IBUF(98)   = TOTAL OUTGOING LONGWAVE FLUX (WATT/SQ-METER, X 100)
      IBUF(99)   = CLOUD PRESSURE
      IBUF(100)  = CLOUD TEMPERATURE
      IBUF(101)  = FILL
      IBUF(102)  = RTVL TYPE (CLEAR=10, PARTLY-CLOUDY=20, MW+HS=30)
      IBUF(103)  = SOLAR ZENITH ANGLE (DEG X 100; 9000 IF NIGHT)
      IBUF(104:112) = WINDS (DDDFFF: DEG,METERS/SEC)

PARAMETERS

The recommended parameter responses are shown in the example.

NOTE: Even though the questions given in the example imply that they have default values, they DO NOT! Each value must be entered.

EXAMPLES

[ 5] % tovret
ENTER LETTER OF FILE TO PROCESS:
1
ENTER SFC-DATA FLAG (1=YES,0=NO):
0
ENTER GUESS TYPE (0=REGRESSION,1=CLIMATOLOGY):
1
ENTER START LINE (DEFAULT=2):
2
ENTER START ELEM (DEFAULT=2):
2
 TO MAKE SINGLE SOUNDING, LET NUM-LINES AND NUM-ELEMS=1
ENTER NUMBER OF LINES (DEFAULT=98):
98
ENTER NUMBER OF ELEMS (DEFAULT=54):
54
ENTER LINE-INCREMENT (DEFAULT=3):
3
ENTER ELEM-INCREMENT (DEFAULT=3):
3
ENTER TOPOGRAPHY FLAG (0=HI-RES,1=LO-RES):
1
MWHS = RTVL USING MSU+HIRS (STRATOSPHERIC)CHANNELS
  IF = 0, OUTPUT ONLY FULL-HIRS SOUNDINGS
  IF = 1, OUTPUT MWHS IF FULL-HIRS SOUNDING FAILS
  IF = 2, OUTPUT ONLY MWHS SOUNDINGS
ENTER VALUE OF MWHS:
1
ENTER DIAGNOSTICS PRINT FLAG (0=NO,1=YES):
0
ENTER RTVL-FILE INIT FLAG (0=NO,1=YES):
1

FILES

tovsfile.