List of Routines

RD_MOM
Routine Descriptions

RD_MOM

 NAME:
       RD_MOM

 PURPOSE:
       retrieves data from a MOM file

 CATEGORY:
        INPUT/OUTPUT

 CALLING SEQUENCE:
        s=rd_mom(FILENAME=filename)

 INPUTS:
        None

 OPTIONAL INPUTS:
        FILENAME - filename holding data

 KEYWORD PARAMETERS:
        CONV_6S - if set then azimuth difference angles follow the 6S
                  convention (thus MEGS - see SIDE EFFECTS below)


 OUTPUTS:
  structure holding the following attributes :
          header.INPUT_FILE           -
          header.HauptDatei_1         -
          header.HauptDatei_2         -
          header.HauptDatei_5         -
          header.wavelength           -
          header.total_opt_thickness  -
          header.Rayl_opt_thickness   -
          header.horizont_visibility  -
          header.atm_turbidity        -
          dims.height                 -
          dims.wavelengths            - array
          dims.theta_s                - array
          dims.delta_phi              - array
          dims.theta_v                - array
          data                        - floating point 4-dimensional array of size
                                        [N_theta_v,N_delta_phi,N_theta_s,N_wavelengths]
                                        (theta_v is the indice that varies the fastest)

 OPTIONAL OUTPUTS:
        None


 COMMON BLOCKS:
        None


 SIDE EFFECTS:
        1) values of theta_s, theta_v and delta_phi are hard-coded in
        this routine ; therefore, if MOM grid changes than this
        routine will no longer be compatible. This was done because
        geometry is not listed in MOM file and because delta_phi
        angles are wrong in the MOM file !!! only wavelengths and
        altitudes are given properly in MOM file.

        2) The MOM file follows the OS convention for the azimuth
        difference angles - therefore, when using it with MEGS, one
                            should reverse the azimuth difference
                            angles to comply with the 6S convention.


 RESTRICTIONS:
        Angle values are hard-coded in this function and are not
        retrieved from the MOM datafile.


 PROCEDURE:
        reads the momfile line per line

 EXAMPLE:
       datadir='/megs_test/validation/Ocean/sen_onlycase1_noatm'
       s=rd_mom(filename=datadir+'/momFile_C0.03_S0.003_Y0.0.surf')
       s=rd_mom(filename=datadir+'/momFile_C0.03_S0.003_Y0.0.surf',/CONV_6S)

       datadir='/megs_test/simulations_LPCM_dec98/rho/wind0'
       s=rd_mom(filename=datadir+'/m33.050')
       s=rd_mom(filename=datadir+'/m33.050',/CONV_6S)

       help,s,/structure

 MODIFICATION HISTORY:
                created by Vincent Fournier-Sicre - June 1999 - vfs@acri.fr
(See $IDL_LOCAL\Meris\rd_mom.pro)
News|HOME