tovscdf - Converts TOVS output files into TeraScan datasets

SYNOPSIS

tovscdf  [ parameter=value ... ]  [ outputfile ]

Parameter is: tovs_file_num.

DESCRIPTION

tovscdf converts University of Wisconsin TOVS output files into TeraScan datasets.

Input into this function is a University of Wisconsin TOVS output file (TOVRET?.DAT). There is one output TeraScan dataset.

PARAMETERS

tovs_file_num

This is a character designating the TOVS file to convert. TOVS output files are of the form TOVSRET?.DAT where the ? represents a letter between A and Z (upper or lower case), or numbers between 0 and 9.

Valid responses are [A to Z, 0 to 9]. The default is [1].

EXAMPLES

Convert a TOVS output file into a nine-dimensional TeraScan dataset and list the contents of the dataset.

[1] % tovscdf hugo.tovs
tovs_file_char : char( 1) ? [1] 1

[2] % contents hugo.tovs
printout       : char( 3) ? [no]

Contents of File: hugo.tovs    Page 1

Dimension       Size            Coord           Scale      Offset
 points           418            ?                  1           0
 hirs_channels     19            ?                  1           0
 msu_channels       4            ?                  1           0
 gp_levels         15            ?                  1           0
 temp_levels       14            ?                  1           0
 dew_pt_levels      5            ?                  1           0
 wind_levels        9            ?                  1           0
 temp_inp_levels   10            ?                  1           0
 dp_inp_levels      5            ?                  1           0

Attribute       Type            Units           Value
 pass_date       long            std_date
                                                  92/08/28
 start_time      double          std_time
                                                  10:13:50
 satellite       string12
                                                  noaa-11
 history         byte

Variable        Type            Units
 latitude        float           std_latitude
 longitude       float           std_longitude
 elevation       float           meters
 solar_zenith    float           degrees
 ground_temp     float           kelvin
 ground_dew_pt   float           kelvin
 ground_pressure float           millibars
 skin_temp       float           kelvin
 total_ozone     float           dobson_units
 stability_index float           kelvin
 precip_water    float           millimeters
 longwave_flux   float           watts/meter**2
 cloud_pressure  float           millibars
 cloud_temp      float           kelvin
 hirs_temp       float           kelvin
 msu_temp        float           kelvin
 gp_height       float           meters
 temperature     float           kelvin
 dew_pt          float           kelvin
 wind_speed      float           meters/sec
 wind_dir        float           degrees
 temp_guess      float           kelvin
 dew_pt_guess    float           kelvin
 gp_levels       float           millibars
 temp_levels     float           millibars
 dew_pt_levels   float           millibars
 wind_levels     float           millibars
 temp_inp_levels float           millibars
 dp_inp_levels   float           millibars

Variable        Dimension       Size
 latitude        points           418
 longitude       points           418
 elevation       points           418
 solar_zenith    points           418
 ground_temp     points           418
 ground_dew_pt   points           418
 ground_pressure points           418
 skin_temp       points           418
 total_ozone     points           418
 stability_index points           418
 precip_water    points           418
 longwave_flux   points           418
 cloud_pressure  points           418
 cloud_temp      points           418
 hirs_temp       points           418
 hirs_temp       hirs_channels     19
 msu_temp        points           418
 msu_temp        msu_channels       4
 gp_height       points           418
 gp_height       gp_levels         15
 temperature     points           418
 temperature     temp_levels       14
 dew_pt          points           418
 dew_pt          dew_pt_levels      5
 wind_speed      points           418
 wind_speed      wind_levels        9
 wind_dir        points           418
 wind_dir        wind_levels        9
 temp_guess      points           418
 temp_guess      temp_inp_levels   10
 dew_pt_guess    points           418
 dew_pt_guess    dp_inp_levels      5
 gp_levels       gp_levels         15
 temp_levels     temp_levels       14
 dew_pt_levels   dew_pt_levels      5
 wind_levels     wind_levels        9
 temp_inp_levels temp_inp_levels   10
 dp_inp_levels   dp_inp_levels      5

Variable            BadValue     Minimum     Maximum       Scale      Offset
 latitude        -3.4028e+38 -3.4028e+38  3.4028e+38           1           0
 longitude       -3.4028e+38 -3.4028e+38  3.4028e+38           1           0
 elevation                -1 -3.4028e+38  3.4028e+38           1           0
 solar_zenith             -1 -3.4028e+38  3.4028e+38           1           0
 ground_temp              -1 -3.4028e+38  3.4028e+38           1           0
 ground_dew_pt            -1 -3.4028e+38  3.4028e+38           1           0
 ground_pressure          -1 -3.4028e+38  3.4028e+38           1           0
 skin_temp                -1 -3.4028e+38  3.4028e+38           1           0
 total_ozone              -1 -3.4028e+38  3.4028e+38           1           0
 stability_index          -1 -3.4028e+38  3.4028e+38           1           0
 precip_water             -1 -3.4028e+38  3.4028e+38           1           0
 longwave_flux            -1 -3.4028e+38  3.4028e+38           1           0
 cloud_pressure           -1 -3.4028e+38  3.4028e+38           1           0
 cloud_temp               -1 -3.4028e+38  3.4028e+38           1           0
 hirs_temp                -1 -3.4028e+38  3.4028e+38           1           0
 msu_temp                 -1 -3.4028e+38  3.4028e+38           1           0
 gp_height                -1 -3.4028e+38  3.4028e+38           1           0
 temperature              -1 -3.4028e+38  3.4028e+38           1           0
 dew_pt                   -1 -3.4028e+38  3.4028e+38           1           0
 wind_speed               -1 -3.4028e+38  3.4028e+38           1           0
 wind_dir                 -1 -3.4028e+38  3.4028e+38           1           0
 temp_guess               -1 -3.4028e+38  3.4028e+38           1           0
 dew_pt_guess             -1 -3.4028e+38  3.4028e+38           1           0
 gp_levels       -3.4028e+38 -3.4028e+38  3.4028e+38           1           0
 temp_levels     -3.4028e+38 -3.4028e+38  3.4028e+38           1           0
 dew_pt_levels   -3.4028e+38 -3.4028e+38  3.4028e+38           1           0
 wind_levels     -3.4028e+38 -3.4028e+38  3.4028e+38           1           0
 temp_inp_levels -3.4028e+38 -3.4028e+38  3.4028e+38           1           0
 dp_inp_levels   -3.4028e+38 -3.4028e+38  3.4028e+38           1           0

SEE ALSO

tovsproc


Last Update: $Date: 1998/05/29 20:54:38 $