TABLE OF CONTENTS

1. MLT_RSS/combine_msu_amsu_merged_maps_3_3.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   combine_msu_amsu_merged_maps_3_3.pro

PURPOSE

   Top level driver program for merging msu and amsu data together

DESCRIPTION

   Top level driver program for merging msu and amsu data together.  Reads in merged MSU and AMSU
   data from netcdf files, computes merging parameters, calculates merged data, and writes a new 
   netcdf file containing the merged data.

FILE READ:

   merged msu data file in netcdf format
   e.g. RSS_Tb_Maps_ch_TMT_V3_3_011.nc
   merged amsu data file in netcdf format
   e.g. RSS_Tb_Maps_ch_05_V3_3_011.nc

FILES WRITTEN

   netcdf file containing msu amsu merged data
   e.g. RSS_Tb_Maps_ch_TMT_V3_3_001.nc

AUTHOR

   Carl Mears, Remote Sensing Systems

COPYRIGHT

   THIS SOFTWARE AND ITS DOCUMENTATION ARE COPYRIGHT 2012 REMOTE SENSING SYSTEMS.  
   THEY ARE PROVIDED FOR INFORMATIONAL AND ALGORITHM VERIFICATION PURPOSES ONLY 
   AND MAY NOT BE USED IN WHOLE OR IN PART FOR ANY OTHER PURPOSE WITHOUT WRITTEN
   PERMISSION FROM REMOTE SENSING SYSTEMS.  THEY ARE FURNISHED "AS IS." THE 
   AUTHORS, THE UNITED STATES GOVERNMENT, ITS INSTRUMENTALITIES, OFFICERS, EMPLOYEES, 
   AND AGENTS MAKE NO WARRANTY, EXPRESS OR IMPLIED, AS TO THE USEFULNESS OF THE 
   SOFTWARE AND DOCUMENTATION FOR ANY PURPOSE. THEY ASSUME NO RESPONSIBILITY (1) FOR
   THE USE OF THE SOFTWARE AND DOCUMENTATION; OR (2) TO PROVIDE TECHNICAL SUPPORT 
   TO USERS.;

HISTORY

   10/24/2012 Initial Version prepared for NCDC

USAGE

   top level program invoked by .r command in IDL environment

2. MLT_RSS/current_month_number.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   current_month_number

PURPOSE

   Returns the month number (number of months since dec 1977) using the system time.

DESCRIPTION

   Returns the month number (number of months since dec 1977) using the system time.

INPUTS:

   none

RETURN VALUE:

   month number (number of months since dec 1977)

AUTHOR

   Carl Mears, Remote Sensing Systems

COPYRIGHT

   THIS SOFTWARE AND ITS DOCUMENTATION ARE COPYRIGHT 2012 REMOTE SENSING SYSTEMS.  
   THEY ARE PROVIDED FOR INFORMATIONAL AND ALGORITHM VERIFICATION PURPOSES ONLY 
   AND MAY NOT BE USED IN WHOLE OR IN PART FOR ANY OTHER PURPOSE WITHOUT WRITTEN
   PERMISSION FROM REMOTE SENSING SYSTEMS.  THEY ARE FURNISHED "AS IS." THE 
   AUTHORS, THE UNITED STATES GOVERNMENT, ITS INSTRUMENTALITIES, OFFICERS, EMPLOYEES, 
   AND AGENTS MAKE NO WARRANTY, EXPRESS OR IMPLIED, AS TO THE USEFULNESS OF THE 
   SOFTWARE AND DOCUMENTATION FOR ANY PURPOSE. THEY ASSUME NO RESPONSIBILITY (1) FOR
   THE USE OF THE SOFTWARE AND DOCUMENTATION; OR (2) TO PROVIDE TECHNICAL SUPPORT 
   TO USERS.;

HISTORY

   10/18/2012 Initial Version prepared for NCDC

USAGE

   month_number = current_month_number()

3. MLT_RSS/grpt_merge_AMSU_only_3_3.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   chng_to_midnight_tlt.pro

PURPOSE

   uses diurnal climatology to change reference time for a gridded TLT dataset from noon to midnight

DESCRIPTION

   Uses the CCM3 diurnal cycle to adjust gridded data from noon to midnight, local time.

INPUTS:

   mean_tb_map  gridded monthly Tb dataset, local reference time set to noon.  Channel is assumed to be TLT

OUTPUTS:

   mean_tb_map_midnight  gridded monthly Tb dataset, local reference time adjusted to midnight
   noon_midnight_diff    optional:  gridded monthly dataset of noon minus midnight differences

AUTHOR

   Carl Mears, Remote Sensing Systems

COPYRIGHT

   THIS SOFTWARE AND ITS DOCUMENTATION ARE COPYRIGHT 2012 REMOTE SENSING SYSTEMS.  
   THEY ARE PROVIDED FOR INFORMATIONAL AND ALGORITHM VERIFICATION PURPOSES ONLY 
   AND MAY NOT BE USED IN WHOLE OR IN PART FOR ANY OTHER PURPOSE WITHOUT WRITTEN
   PERMISSION FROM REMOTE SENSING SYSTEMS.  THEY ARE FURNISHED "AS IS." THE 
   AUTHORS, THE UNITED STATES GOVERNMENT, ITS INSTRUMENTALITIES, OFFICERS, EMPLOYEES, 
   AND AGENTS MAKE NO WARRANTY, EXPRESS OR IMPLIED, AS TO THE USEFULNESS OF THE 
   SOFTWARE AND DOCUMENTATION FOR ANY PURPOSE. THEY ASSUME NO RESPONSIBILITY (1) FOR
   THE USE OF THE SOFTWARE AND DOCUMENTATION; OR (2) TO PROVIDE TECHNICAL SUPPORT 
   TO USERS.

HISTORY

   6/18/2012 Initial Version prepared for NCDC

USAGE

   chng_to_midnight_tlt,mean_tb_map,mean_tb_map_midnight,noon_midnight_diff = noon_midnight_diff

4. MLT_RSS/grpt_merge_AMSU_only_3_3.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   chng_to_midnight.pro

PURPOSE

   uses diurnal climatology to change reference time for a gridded Tb dataset from noon to midnight

DESCRIPTION

   Uses the CCM3 diurnal cycle to adjust gridded data from noon to midnight, local time.

INPUTS:

   chan  MSU channel number (2 to 4).  This routine is for TMT, TTS, and TLS only
   mean_tb_map  gridded monthly Tb dataset, local reference time set to noon

OUTPUTS:

   mean_tb_map_midnight  gridded monthly Tb dataset, local reference time adjusted to midnight
   noon_midnight_diff    optional:  gridded monthly dataset of noon minus midnight differences

AUTHOR

   Carl Mears, Remote Sensing Systems

COPYRIGHT

   THIS SOFTWARE AND ITS DOCUMENTATION ARE COPYRIGHT 2012 REMOTE SENSING SYSTEMS.  
   THEY ARE PROVIDED FOR INFORMATIONAL AND ALGORITHM VERIFICATION PURPOSES ONLY 
   AND MAY NOT BE USED IN WHOLE OR IN PART FOR ANY OTHER PURPOSE WITHOUT WRITTEN
   PERMISSION FROM REMOTE SENSING SYSTEMS.  THEY ARE FURNISHED "AS IS." THE 
   AUTHORS, THE UNITED STATES GOVERNMENT, ITS INSTRUMENTALITIES, OFFICERS, EMPLOYEES, 
   AND AGENTS MAKE NO WARRANTY, EXPRESS OR IMPLIED, AS TO THE USEFULNESS OF THE 
   SOFTWARE AND DOCUMENTATION FOR ANY PURPOSE. THEY ASSUME NO RESPONSIBILITY (1) FOR
   THE USE OF THE SOFTWARE AND DOCUMENTATION; OR (2) TO PROVIDE TECHNICAL SUPPORT 
   TO USERS.;

HISTORY

   6/18/2012 Initial Version prepared for NCDC

USAGE

   chng_to_midnight,chan,mean_tb_map,mean_tb_map_midnight,noon_midnight_diff = noon_midnight_diff

5. MLT_RSS/read_ccm3_diurnal_cycle_map.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   read_ccm3_diurnal_cycle_map.pro

PURPOSE

   Reads ccm3 diurnal climatology map for a given month and fov 

DESCRIPTION

   Reads ccm3 diurnal climatology map for a given month and fov from an
   already open file.

FILES READ

   ccm3 diurnal climatology file
   e.g. mn_ccm3_diur_cycles_amsu_chan_09.dat

INPUTS:

   lun logical unit number of diurnal climatology file
   fov  field of view number
   month month of the diurnal cycle wanted

OUTPUTS:

  d_cycle_map 144 (longitude) by 72 (latitude) x 24(hours) array of 
  climatological diurnal anomalies.

AUTHOR

   Carl Mears, Remote Sensing Systems

COPYRIGHT

   THIS SOFTWARE AND ITS DOCUMENTATION ARE COPYRIGHT 2012 REMOTE SENSING SYSTEMS.  
   THEY ARE PROVIDED FOR INFORMATIONAL AND ALGORITHM VERIFICATION PURPOSES ONLY 
   AND MAY NOT BE USED IN WHOLE OR IN PART FOR ANY OTHER PURPOSE WITHOUT WRITTEN
   PERMISSION FROM REMOTE SENSING SYSTEMS.  THEY ARE FURNISHED "AS IS." THE 
   AUTHORS, THE UNITED STATES GOVERNMENT, ITS INSTRUMENTALITIES, OFFICERS, EMPLOYEES, 
   AND AGENTS MAKE NO WARRANTY, EXPRESS OR IMPLIED, AS TO THE USEFULNESS OF THE 
   SOFTWARE AND DOCUMENTATION FOR ANY PURPOSE. THEY ASSUME NO RESPONSIBILITY (1) FOR
   THE USE OF THE SOFTWARE AND DOCUMENTATION; OR (2) TO PROVIDE TECHNICAL SUPPORT 
   TO USERS.

HISTORY

   6/18/2012 Initial Version prepared for NCDC

USAGE

   read_ccm3_diurnal_cycle_map,lun,fov,month,d_cycle_map;

6. MLT_RSS/write_msu_amsu_merged_Tbs_144_72_netcdf_3_3.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   write_msu_amsu_merged_Tbs_144_72_netcdf_3_3.pro

PURPOSE

   writes merged results to netcdf file

DESCRIPTION

   writes merged results to netcdf file

INPUTS:

   Tbs_144_72 = Tbs_144_72 ,     $           ; brightness temperatures
   channel_str=channel_str,      $           ; string containing channel name ('TLT, etc)
   version_num=version_num,      $           ; version number
   offsets = offsets,          $             ; offsets used in intratype merge
   target_factors = target_factors,  $       ; target factors used in intratype merge
   tb_Factors = tb_factors,      $           ; scene temepratuer factors used in intratype merge
   satellites_used = satellites_used,  $     ; array of satellites used
   date_L2C_processed = date_L2C_processed,  $    ; array of processing dates for L2C files
   global_Attributes = global_attributes,    $    ; new global arrtibutes
   msu_global_Attributes=msu_global_Attributes,   $  ; msu-only global atrributes
   amsu_global_Attributes=amsu_global_Attributes, $  ; amsu_only global attributes
   msu_amsu_diff=msu_amsu_diff, $                    ; 144x72x12 array of msu amsu differences -- adjustments have been applied to AMSU data
   nc_file = nc_file,  $                             ; file name for netcdf file
   output_path = output_path                         ; location to write netcdf file

FILES WRITTEN:

   netcdf file containing msu amsu merged data

AUTHOR

   Carl Mears, Remote Sensing Systems

COPYRIGHT

   THIS SOFTWARE AND ITS DOCUMENTATION ARE COPYRIGHT 2012 REMOTE SENSING SYSTEMS.  
   THEY ARE PROVIDED FOR INFORMATIONAL AND ALGORITHM VERIFICATION PURPOSES ONLY 
   AND MAY NOT BE USED IN WHOLE OR IN PART FOR ANY OTHER PURPOSE WITHOUT WRITTEN
   PERMISSION FROM REMOTE SENSING SYSTEMS.  THEY ARE FURNISHED "AS IS." THE 
   AUTHORS, THE UNITED STATES GOVERNMENT, ITS INSTRUMENTALITIES, OFFICERS, EMPLOYEES, 
   AND AGENTS MAKE NO WARRANTY, EXPRESS OR IMPLIED, AS TO THE USEFULNESS OF THE 
   SOFTWARE AND DOCUMENTATION FOR ANY PURPOSE. THEY ASSUME NO RESPONSIBILITY (1) FOR
   THE USE OF THE SOFTWARE AND DOCUMENTATION; OR (2) TO PROVIDE TECHNICAL SUPPORT 
   TO USERS.;

HISTORY

   6/18/2012 Initial Version prepared for NCDC

USAGE

   write_msu_amsu_merged_Tbs_144_72_netcdf_3_3,  Tbs_144_72 = Tbs_144_72 ,     $
                          channel_str=channel_str,      $
                          version_num=version_num,      $
                          offsets = offsets,          $
                          target_factors = target_factors,  $
                          tb_Factors = tb_factors,      $
                          satellites_used = satellites_used,  $
                          date_L2C_processed = date_L2C_processed,  $
                          global_Attributes = global_attributes,    $
                          msu_global_Attributes=msu_global_Attributes,   $
                          amsu_global_Attributes=amsu_global_Attributes, $
                          msu_amsu_diff=msu_amsu_diff, $
                          nc_file = nc_file,  $
                          output_path = output_path

7. MLT_RSS/y_lm_fit.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   y_lm_fit.pro

PURPOSE

   Fits a 144 x 72 gridded map using a series of spherical harmonics

DESCRIPTION

   Fits a 144 x 72 gridded map using a series of spherical harmonics

INPUTS:

   map         ; 144 x 72 array : map to be fitted
   sigma_in,   ; 144 x 72 array of estimated errors
   l_max       ; largest l coefficient to be used -- maximum is L = 14
   trim = trim ; if set, outliers are trimmed.  e.g. if set to 0.8, 80% of the values are kept
   init=init   ; set if need to recompute YLM basis

OUTPUTS:

   fitted_map  ; spherical harmonic fit
   coeff       ; coefficients of fit

AUTHOR

   Carl Mears, Remote Sensing Systems

COPYRIGHT

   THIS SOFTWARE AND ITS DOCUMENTATION ARE COPYRIGHT 2012 REMOTE SENSING SYSTEMS.  
   THEY ARE PROVIDED FOR INFORMATIONAL AND ALGORITHM VERIFICATION PURPOSES ONLY 
   AND MAY NOT BE USED IN WHOLE OR IN PART FOR ANY OTHER PURPOSE WITHOUT WRITTEN
   PERMISSION FROM REMOTE SENSING SYSTEMS.  THEY ARE FURNISHED "AS IS." THE 
   AUTHORS, THE UNITED STATES GOVERNMENT, ITS INSTRUMENTALITIES, OFFICERS, EMPLOYEES, 
   AND AGENTS MAKE NO WARRANTY, EXPRESS OR IMPLIED, AS TO THE USEFULNESS OF THE 
   SOFTWARE AND DOCUMENTATION FOR ANY PURPOSE. THEY ASSUME NO RESPONSIBILITY (1) FOR
   THE USE OF THE SOFTWARE AND DOCUMENTATION; OR (2) TO PROVIDE TECHNICAL SUPPORT 
   TO USERS.;

HISTORY

   6/18/2012 Initial Version prepared for NCDC

USAGE

   y_lm_fit,map,sigma_in,l_max,fitted_map,coeff,trim = 0.8,init=1