TABLE OF CONTENTS

1. MLT_RSS/apply_TF_to_grpt_maps.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   apply_TF_to_grpt_maps.pro

PURPOSE

   applies MSU offset to grid point maps to produce an adjusted dataset. 

DESCRIPTION

   Applies the target factors using the method described in 
   Mears, CA, FJ Wentz, 2009, 
   Construction of the Remote Sensing Systems V3.2 atmospheric temperature records from the MSU and AMSU microwave sounders 
   Journal of Atmospheric and Oceanic Technology, 26, 1040-1056.
   
   and 
   
   Mears, CA, FJ Wentz, 2009, 
   Construction of the RSS V3.2 lower tropospheric dataset from the MSU and AMSU microwave sounders 
   Journal of Atmospheric and Oceanic Technology, 26, 1493-1509.

INPUTS

   tb_arr_adj          (144,72,num_months,num_sats) real(4) array of brightness temperatures
   offsets  (num_lats,num_sats) float 32 array of latitude-dependent offsets

OUTPUTS

   tb_arr_adj      (144,72,num_months,num_sats) real(4) array of adjusted brightness temperatures (tb_arr_adj is modified in place)

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

   3/02/2012 Initial Version prepared for NCDC

USAGE

   apply_offsets_to_grpt_maps,tb_arr_adj,offsets

2. MLT_RSS/apply_TF_to_grpt_maps.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   apply_TF_to_grpt_maps.pro

PURPOSE

   applies MSU target factors to grid point maps to produce an adjusted dataset. 

DESCRIPTION

   Applies the target factors using the method described in 
   Mears, CA, FJ Wentz, 2009, 
   Construction of the Remote Sensing Systems V3.2 atmospheric temperature records from the MSU and AMSU microwave sounders 
   Journal of Atmospheric and Oceanic Technology, 26, 1040-1056.
   
   and 
   
   Mears, CA, FJ Wentz, 2009, 
   Construction of the RSS V3.2 lower tropospheric dataset from the MSU and AMSU microwave sounders 
   Journal of Atmospheric and Oceanic Technology, 26, 1493-1509.

INPUTS

   tb_arr          (144,72,num_months,num_sats) real(4) array of brightness temperatures
   tar_arr         (144,72,num_months,num_sats) real(4) array of target temperatures
   channel          3 character channel string (TLT,TMT, etc)  not used in this version
   target_factors  (num_sats) float 32 array of target_factors
   target_means    (num_sats) float32 array of target_factors
   months_to_use   (num_sats,num_months) array of integers -- 1 means use this month, 0 mean ignore)

OUTPUTS

   tb_arr_adj      (144,72,num_months,num_sats) real(4) array of adjusted brightness temperatures

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

   3/02/2012 Initial Version prepared for NCDC

USAGE

   apply_TF_to_grpt_maps,tb_arr,tar_arr,channel,target_factors,target_means,months_to_use,tb_arr_adj

3. MLT_RSS/calc_TF_from_grpt_maps.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   calc_TF_from_grpt_maps.pro

PURPOSE

   calculates MSU target factors directly from the monthly averaged grid point maps. 

DESCRIPTION

   Calculates the target factors using the method described in 
   Mears, CA, FJ Wentz, 2009, 
   Construction of the Remote Sensing Systems V3.2 atmospheric temperature records from the MSU and AMSU microwave sounders 
   Journal of Atmospheric and Oceanic Technology, 26, 1040-1056.
   
   and 
   
   Mears, CA, FJ Wentz, 2009, 
   Construction of the RSS V3.2 lower tropospheric dataset from the MSU and AMSU microwave sounders 
   Journal of Atmospheric and Oceanic Technology, 26, 1493-1509.

   The routine calculates the target factors directly from the monthly averaged grid point maps.  The in put data is

INPUTS

   tb_arr          (144,72,num_months,num_sats) real(4) array of brightness temperatures
   tar_arr         (144,72,num_months,num_sats) real(4) array of target temperatures
   sats_to_use     (9) int32 array, 1 means use this satellite, 0 mean ignore)
   months_to_use   (num_sats,num_months) array of integers -- 1 means use this month, 0 mean ignore)
   num_thres        number of observations per cell to make a valid cell
   channel          3 character channel string (TLT,TMT, etc)

OUTPUTS

   target_factor   (num_sats) real(4) array of target factors
   target_means    (num_sats) real(4) array of global mean traget temperatures
   offset          (num_sats) float32 array of globa offsets (discarded)
   months_to_use   (num_sats,num_months) array of integers -- 1 means use this month, 0 mean ignore)

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

   2/29/2012 Initial Version prepared for NCDC

USAGE

   calc_TF_from_grpt_maps,tb_arr,tar_arr,num_arr,channel,sats_to_use,   $
             target_factor,target_means,offset,months_to_use,             $
             num_thres=num_thres

4. MLT_RSS/grpt_merge_AMSU_only_3_3.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   grpt_merge_MSU_only_3_3.pro

PURPOSE

   Top-level program that performs adjustments to MSU monthly gridded data, and then 
   merges the data together into a single MSU derived brightness temperature dataset

DESCRIPTION

   Reads gridded monthly averages from individual files.  We call these L2C files.
   Calculates and applies target factors using singular value decomposition
   Calculates and applies latitude dependent offsets using singular value decomposition
   Scene temperature factors are set to zero for AMSU
   Merges data from the chosen set of satellite together using equal weighting
   Writes the results to a netcdf file.  We call these files L3.

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

   2/21/2012 Initial Version prepared for NCDC

USAGE

   grpt_merge_MSU_only_3_3

5. MLT_RSS/read_all_monthly_maps_msu_only_v3_3.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   read_all_monthly_maps_msu_only_v3_3.pro

PURPOSE

   finds and reads all files containing monthly gridded averages for a 
   channel

DESCRIPTION

   Reads a number of flat binary file with the monthly averaged data.  Each file is
   real(4) little endian.

INPUTS

   channel_str     3 character string describing the layer begin processed ('TLT','TMT','TTS','TLS')
   diurnal_model   is a string that describes the diurnal adjustment used ('CCM3' means the CCM3 climate model)  CCM3 is the default model
   
   The global variables the describe the size of this file must already be set.  These are:
     !AMSU_L2C_Path
     !Num_Months
     !Num_MSUs
     !Num_hist_datatypes
     !Num_Nodes
     !Num_GrPt_Lons
     !Num_GrPt_Lats

OUTPUTS

     tb_arr           is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_months,!num_MSUs] of brightness temperatures.
     tar_arr          is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_months,!num_MSUs] of calibration target temperatures.
     num_arr          is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_months,!num_MSUs] of the number of obs in each average.
     mn_day_arr       is an float32 array of mean day num in month
     tb_clim_arr      is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,12] of mean climatological brightness temperatures for each month
     file_list        is the a list of file names that were read 

AUTHOR

   Carl Mears, Remote Sensing Systems

COPYRIGHT

   THIS SOFTWARE AND ITS DOCUMENTATION ARE CONSIDERED TO BE IN THE PUBLIC DOMAIN AND
   THUS ARE AVAILABLE FOR UNRESTRICTED PUBLIC USE.  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

   2/29/2012 Initial Version prepared for NCDC

USAGE

   read_all_monthly_maps_msu_only_v3_3,channel_str,tb_arr,tar_arr,mn_day_arr,tb_clim_arr,num_arr,file_list=file_list,diurnal_model = diurnal_model
                            
     channel_str      is the layer begin processed ('TLT','TMT','TTS','TLS')
     tb_arr           is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_months,!num_MSUs] of brightness temperatures.
     tar_arr          is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_months,!num_MSUs] of calibration target temperatures.
     num_arr          is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_months,!num_MSUs] of the number of obs in each average.
     mn_day_arr       is an float32 array of mean day num in month
     tb_clim_arr      is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,12] of mean climatological brightness temperatures for each month
     file_list        is the a list of file names that were read   
     diurnal_model    is a string that describes the diurnal adjustment used ('CCM3' means the CCM3 climate model)

6. MLT_RSS/read_all_monthly_maps_msu_only_v3_3.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   read_all_monthly_maps_msu_only_v3_3.pro

PURPOSE

   finds and reads all files containing monthly gridded averages for a 
   channel

DESCRIPTION

   Reads a number of flat binary files with the monthly averaged data.  Each file is
   real(4) little endian.

INPUTS

   channel_str     3 character string describing the layer begin processed ('TLT','TMT','TTS','TLS')
   diurnal_model   is a string that describes the diurnal adjustment used ('CCM3' means the CCM3 climate model)  CCM3 is the default model
   
   The global variables the describe the size of this file must already be set.  These are:
     !AMSU_L2C_Path
     !Num_Months
     !Num_MSUs
     !Num_hist_datatypes
     !Num_Nodes
     !Num_GrPt_Lons
     !Num_GrPt_Lats
   typically, these are set by the routine initialize_msu_variables_w_amsu.

OUTPUTS

     tb_arr           is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_months,!num_MSUs] of brightness temperatures.
     tar_arr          is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_months,!num_MSUs] of calibration target temperatures.
     num_arr          is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_months,!num_MSUs] of the number of obs in each average.
     mn_day_arr       is an float32 array of mean day num in month
     tb_clim_arr      is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,12] of mean climatological brightness temperatures for each month
     file_list        is the a list of file names that were read   

AUTHOR

   Carl Mears, Remote Sensing Systems

COPYRIGHT

   THIS SOFTWARE AND ITS DOCUMENTATION ARE CONSIDERED TO BE IN THE PUBLIC DOMAIN AND
   THUS ARE AVAILABLE FOR UNRESTRICTED PUBLIC USE.  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

   2/29/2012 Initial Version prepared for NCDC

USAGE

   read_all_monthly_maps_msu_only_v3_3,channel_str,tb_arr,tar_arr,mn_day_arr,tb_clim_arr,num_arr,file_list=file_list,diurnal_model = diurnal_model

7. MLT_RSS/read_monthly_histograms_V3_0.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   rread_monthly_histograms_V3_0.pro

PURPOSE

   reads a single monthly gridded histogram record

DESCRIPTION

   reads a single monthly gridded histogram record

INPUTS

   lu          logical unit to read from

OUTPUTS

   month_num            ; month number for the histogram read
   monthly_hist         ; monthly hsit with averaged AMSU data
   error                ; error flag.  0 means everything is OK, -1 Means a read error

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

   9/02/2012 Initial Version prepared for NCDC

USAGE

   read_monthly_histograms_V3_0,lu,month_num,monthly_hist,error

8. MLT_RSS/read_monthly_histograms_V3_2.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   rread_monthly_histograms_V3_2.pro

PURPOSE

   reads a single monthly gridded histogram record

DESCRIPTION

   reads a single monthly gridded histogram record

INPUTS

   lu          logical unit to read from

OUTPUTS

   month_num            ; month number for the histogram read
   monthly_hist         ; monthly hsit with averaged AMSU data
   error                ; error flag.  0 means everything is OK, -1 Means a read error

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

   9/02/2012 Initial Version prepared for NCDC

USAGE

   read_monthly_histograms_V3_2,lu,month_num,monthly_hist,error

9. MLT_RSS/read_msu_monthly_histograms_one_sat.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   read_msu_monthly_histograms_one_sat_v3_2.pro

PURPOSE

   finds and reads file containing monthly gridded averages for a 
   single msu satellite and channel.  This is really a TLT specific routine, because the second 
   index in the histogram array is not the node (ascending/descending) but rather the side of the
   swath that the data came from.

DESCRIPTION

   Reads a number of flat binary file with the monthly averaged data.  Each file is
   real(4) little endian.

INPUTS

   channel          is the MSU channel to be read (2,3,4)
   
   The global variables the describe the size of this file and its general location must already be set.  These are:
     !AMSU_L2C_Path
     !Num_months
     !Num_hist_datatypes
     !Num_Nodes
     !Num_GrPt_Lons
     !Num_GrPt_Lats
     !Num_months

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

   3/02/2012 Initial Version prepared for NCDC

USAGE

   read_msu_monthly_histograms_one_sat,channel,satnum,monthly_histograms_one_sat,error,file=file
   
     channel          is the MSU channel to be read (2,3,4)
     satnum           is the satellite number of the AMSU satellite to be read (1 = TIROS-N, 2 = NOAA-06, 3 = NOAA-07, etc)
     monthly_histgrams_one_sat[!Num_hist_datatypes,!Num_Nodes,!Num_GrPt_Lons,!Num_GrPt_Lats] is a float(4) array
     error            is set to 0 if the read was successful, -1 otherwise
     file             is the file name that was read

10. MLT_RSS/read_msu_monthly_histograms_one_sat.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   read_msu_monthly_histograms_one_sat.pro

PURPOSE

   finds and reads file containing monthly gridded averages for a 
   single msu satellite and channel

DESCRIPTION

   Reads a number of flat binary file with the monthly averaged data.  Each file is
   real(4) little endian.
   
   The global variables the describe the size of this file and its general location must already be set.  These are:
     !AMSU_L2C_Path
     !Num_months
     !Num_hist_datatypes
     !Num_Nodes
     !Num_GrPt_Lons
     !Num_GrPt_Lats
     !Num_months

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

   3/02/2012 Initial Version prepared for NCDC

USAGE

   read_msu_monthly_histograms_one_sat,channel,satnum,monthly_histograms_one_sat,error,file=file
   
     channel          is the MSU channel to be read (2,3,4)
     satnum           is the satellite number of the AMSU satellite to be read (1 = TIROS-N, 2 = NOAA-06, 3 = NOAA-07, etc)
     monthly_histgrams_one_sat[!Num_hist_datatypes,!Num_Nodes,!Num_GrPt_Lons,!Num_GrPt_Lats] is a float(4) array
     error            is set to 0 if the read was successful, -1 otherwise
     file             is the file name that was read

11. MLT_RSS/smooth_offsets.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   calc_offsets_from_grpt_maps.pro

PURPOSE

   Calculates latitude-dependent offsets from gridded monthly maps of MSU data.

DESCRIPTION

   begins with gridded monthly maps of MSU data.  Typically, the target factor adjustment 
   adjustment has already been applied. Singular value decomposition is used to calculate  
   offsets for each 2.5 degree latitude band separately from a system of equations 
   derived from inter satellite differences.

INPUTS

   tb_arr_adj         (num_lons,num_lats,num_months) float32 array of brightness temperatures
   months_to_use      (num_sats,num_months) int32 array. 1 means use that month, 0 mean don't use.

OUTPUTS

   offsets            (num_lats,num_sats) float32 array of fitted offsets

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

   2/21/2012 Initial Version prepared for NCDC

USAGE

   calc_offsets_from_grpt_maps,tb_arr_adj,months_to_use,offsets,/plt_offsets

12. MLT_RSS/smooth_offsets.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   calc_offsets_from_grpt_maps.pro

PURPOSE

   Calculates single scene temperature factors for each satellite from gridded monthly maps of MSU data.
   It then applies this adjustment to tb_arr_adj.

DESCRIPTION

   begins with gridded monthly maps of MSU data.  Typically, the target factor adjustment 
   adjustment and offsets have already been applied. Singular value decomposition is used to calculate  
   a scene temperature factor for each satellite.  The adjustment is the applied to tb_arr_adj.

INPUTS

   tb_arr_adj         (num_lons,num_lats,num_months) float32 array of brightness temperatures
   tb_clim_arr        (num_lons,num_lats,12) float32 array of average brightness temperature for each month
   months_to_use      (num_sats,num_months) int32 array. 1 means use that month, 0 mean don't use.

OUTPUTS

   tb_factors         (num_sats) float32 array of scene temperature factors
   tb_arr_adj         (num_lons,num_lats,num_months) float32 array of brightness temperatures

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

   2/21/2012 Initial Version prepared for NCDC

USAGE

   calc_single_TbF_from_grpt_map,tb_arr_adj,tb_clim_arr,months_to_use,tb_factors

13. MLT_RSS/smooth_offsets_tlt.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   smooth_offsets_tlt.pro

PURPOSE

   smooths AMSU zonal intersatellite offsets in the north/south direction. 

DESCRIPTION

   smooths AMSU zonal intersatellite offsets in the north/south direction.  A simple, "boxcar" smooth
   is used of width 5 2.5 degree bins

INPUTS

   offsets         (num_lats,num_sats) float32 array of offsets

OUTPUTS

   offsets_smooth  (num_lats,num_sats) float32 array of smoothed offsets

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

   2/29/2012 Initial Version prepared for NCDC

USAGE

   smooth_offsets,offsets,offsets_smooth

14. MLT_RSS/write_msu_only_merged_Tbs_144_72_netcdf_3_3.pro [ Programs ]

[ Top ] [ Programs ]

NAME

   write_msu_only_merged_Tbs_144_72_netcdf_3_3.pro

PURPOSE

   writes intermediate results from the MSU-only merge step to a netcdf file 

DESCRIPTION

   writes intermediate results from the MSU-only merge step to a netcdf file.  The netcdf file contain
   both the merged tbs, the values of the various merging parameters, and the months for each satellite that
   were used in the merge.

INPUTS

   Tbs_144_72                Float32 array[num_lons,num_lats,num_amsu_months] of merged intercalibrated brightness temperatures
   channel_str               Channel (TLT, TMT, TTS, TLS)
   version_num               Version Number
   source_files              List of Source Files
   offsets = offsets         Array[!Num_GrPt_Lats,!num_MSUs] of offsets applied
   target_factors            Array[!Num_GrPt_Lats,!num_MSUs] of target factors
   tb_Factors                Array[!Num_GrPt_Lats,!num_MSUs] of tb factors applied
   months_used               Array[!Num_AMSU_months,!num_MSUs] of offsets applied
   output_path               Optional output path parameter.  If not supplied, set to !AMSU_L3_Path+'AMSU_Only\'

OUTPUTS

   none

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

   2/29/2012 Initial Version prepared for NCDC

USAGE

   write_msu_only_merged_Tbs_144_72_netcdf_3_3,  Tbs_144_72 = Tbs_144_72 ,   $
                          channel_str=channel_str,    $
                          version_num=version_num,    $
                          source_files = source_files,$
                          offsets = offsets,          $
                          target_factors = target_factors, $
                          tb_factors = tb_factors,        $
                          months_used = months_used