[ Top ] [ Programs ]
NAME
apply_offsets_to_grpt_maps_AMSU.pro
PURPOSE
applies AMSU zonal intersatellite offsets to the adjusted monthly averaged grid point maps.
DESCRIPTION
applies AMSU zonal intersatellite offsets to the adjusted monthly averaged grid point maps as 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 operates directly on the adjusted tb maps
INPUTS
tb_arr_adj (144,72,num_months,num_sats) real(4) array of adjusted(for target temperature changes) brightness temperatures offsets (num_lats,num_sats) real(4) array of offsets
OUTPUTS
tb_arr_adj (144,72,num_months,num_sats) real(4) array of adjusted(for target temperature changes) brightness temperatures (adjustments are made in place)
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/21/2012 Initial Version prepared for NCDC
USAGE
apply_offsets_to_grpt_maps_AMSU,tb_arr_adj,offsets
[ Top ] [ Programs ]
NAME
apply_TF_to_grpt_maps_AMSU.pro
PURPOSE
applies AMSU 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 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/21/2012 Initial Version prepared for NCDC
USAGE
apply_TF_to_grpt_maps_AMSU,tb_arr,tar_arr,channel,target_factors,target_means,months_to_use,tb_arr_adj
[ Top ] [ Programs ]
NAME
calc_offsets_from_grpt_maps_AMSU.pro
PURPOSE
calculates AMSU zonal intersatellite offsets directly from the adjusted monthly averaged grid point maps.
DESCRIPTION
Calculates the offsets 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 offsets directly from the monthly averaged grid point maps.
INPUTS
tb_arr_adj (144,72,num_months,num_sats) real(4) array of adjusted(for target temperature changes) brightness temperatures months_to_use (num_sats,num_months) array of integers -- 1 means use this month, 0 mean ignore)
OUTPUTS
offsets (num_lats,num_sats) real(4) array of offsets
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/21/2012 Initial Version prepared for NCDC
USAGE
calc_offsets_from_grpt_maps_AMSU,tb_arr_adj,months_to_use,offsets
[ Top ] [ Programs ]
NAME
calc_TF_from_grpt_maps_AMSU_v3_3.pro
PURPOSE
calculates AMSU 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 months_to_use (num_sats,num_months) array of integers -- 1 means use this month, 0 mean ignore) 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
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/21/2012 Initial Version prepared for NCDC
USAGE
calc_TF_from_grpt_maps_AMSU_v3_3,tb_arr,tar_arr,months_to_use,channel,target_factor,target_means
[ Top ] [ Programs ]
NAME
check_grpt_maps_AMSU_v3_3.pro
PURPOSE
Check AMSU montly gridded data for months with too little data Determines which months to use in merge and returns and array, months_to_use, that is used in subsequent steps to choose which satellite months to include
DESCRIPTION
This routine checks the AMSU GRPT data for months with too little data Inputs: num_arr (should be a (144,72,num_months,num_sats) array of number of obs per grid cell sats_to_use (num_AMSUs) array of integers 0 to ignore this satellite, 1, to use it num_thres is the threshold for the mean number of observations to be good data. months_to_use_mask is a (num_months, num_sats) array of integers: -1 to exclude 0 to use threshold to determine use (the usual case) 1 to use even if threshold fails Output: months_to_use (num_months,num_sats) array of months to use in the merge. 1 means use,0 means don't use
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/21/2019 Initial Version prepared for NCDC
USAGE
check_grpt_maps_AMSU_v3_3,num_arr,sats_to_use,num_thres,months_to_use_mask,months_to_use
[ Top ] [ Programs ]
NAME
grpt_merge_AMSU_only_3_3.pro
PURPOSE
Top-level program that performs adjustments to AMSU monthyl gridded data, and then merges the data together into a single AMSU derived brightness temperature dataset
DESCRIPTION
Reads gridded monthly averages from individual files. We call these L2C files. Calculates and applies target factors using singluar value decomposition Calculates and applies latitude dependendent offsets using singlular value decompostion Scene temeprature 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 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/21/2012 Initial Version prepared for NCDC
USAGE
grpt_merge_amsu_only_3_3
[ Top ] [ Programs ]
NAME
read_all_monthly_maps_amsu_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. The global variables the describe the size of this file must already be set. These are: !AMSU_L2C_Path !Num_AMSU_months !Num_AMSUs !AMSU_year_range !Num_hist_datatypes !Num_Nodes !Num_GrPt_Lons !Num_GrPt_Lats
INPUTS
channel_str is the layer begin processed ('TLT','TMT','TTS','TLS') view_str is a string that describes the FOV set used for the montly average (N12 = near-nadir 12 views, L8 = near limb 8 views, TLT = TLT weighted views) sats_to_use is an int32 array that tell the routine which satellite to read 1 means read the data, 0 means skip this satellite diurnal_model is a string that describes the diurnal adjustment used ('CCM3' means the CCM3 cliamte model) no_nadir is a flag. If set to 1, no nadir adjustment is performed no_diurnal is a flag. If set to 1, no diurnal adjustment is performed diurnal_only is a flag. If set to 1, only the adjustment is returned
OUTPUTS
tb_arr is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_AMSU_months,!num_AMSUs] of brightness temperatures. tar_arr is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_AMSU_months,!num_AMSUs] of calibration target temperatures. num_arr is a float32 array[!Num_GrPt_Lons,!Num_GrPt_Lats,!num_AMSU_months,!num_AMSUs] of the number of obs in each average. rain_arr is an optional float32 array of rain flag occurences file_list_all_sats is the a list of file names that were read date_processed is an array of dates (in IDL julday form) that each monthly file was processed
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_amsu_only_v3_3, $ channel_str, $ view_str, $ sats_to_use, $ tb_arr, $ tar_arr, $ num_arr, $ rain_Arr=rain_Arr, $ file_list_all_sats=file_list_all_sats, $ no_diurnal=no_diurnal, $ diurnal_only = diurnal_only, $ date_processed=date_processed, $ diurnal_model=diurnal_model, $ no_nadir=no_nadir
[ Top ] [ Programs ]
NAME
read_amsu_monthly_histograms_one_sat_ind_files_v3_3.pro
PURPOSE
finds and reads all files containing monthly gridded averages for a single 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 must already be set. These are: !AMSU_L2C_Path !Num_AMSU_months !AMSU_year_range !Num_hist_datatypes !Num_Nodes !Num_GrPt_Lons !Num_GrPt_Lats
INPUTS
channel is the AMSU channel to be read (5,7,9) satnum is the satellite number of the AMSU satellite to be read (10 = NOAA-15, 11 = NOAA-16, 12 = NOAA-17, 13 = NOAA-18, 14 = METOP-A, 15 = AQUA, 16 = NOAA-19) view_str is a string that describes the FOV set used for the montly average (N12 = near-nadir 12 views, L8 = near limb 8 views, TLT = TLT weighted views) diurnal_str is a string that describes the diurnal adjustment used ('CCM3' means the CCM3 cliamte model)
OUTPUTS
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_list is the a list of file names that were read date_processed is an array of dates (in IDL julday form) that each monthly file was processed
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_amsu_monthly_histograms_one_sat_ind_files_v3_3,channel,satnum,view_str,diurnal_str,monthly_histograms_one_sat,error,file_list=file_list,date_processed=date_processed
[ Top ] [ Programs ]
NAME
read_amsu_monthly_single_month.pro
PURPOSE
finds and reads a file containing a single monthly gridded average for a single satellite and channel
DESCRIPTION
Reads a flat binary file with the monthly averaged data. This file is real(4) little endian. The global variables the describe the size of this file must already be set. These are: !AMSU_L2C_Path
INPUTS
channel is the AMSU channel to be read (5,7,9) satnum is the satellite number of the AMSU satellite to be read (10 = NOAA-15, 11 = NOAA-16, 12 = NOAA-17, 13 = NOAA-18, 14 = METOP-A, 15 = AQUA, 16 = NOAA-19) year is the year of the month to be read month is the month to be read view_str is a string that describes the FOV set used for the montly average (N12 = near-nadir 12 views, L8 = near limb 8 views, TLT = TLT weighted views) diurnal_str is a string that describes the diurnal adjustment used ('CCM3' means the CCM3 cliamte model)
OUTPUTS
monthly_hist[!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 name of the file that was 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_amsu_monthly_single_month,channel,satnum,year,month,view_str,diurnal_str,monthly_hist,error,file=file
[ Top ] [ Programs ]
NAME
read_monthly_histograms_V3_0.pro
PURPOSE
reads a file (already open) containing a single monthly gridded average for a single satellite and channel
DESCRIPTION
Reads a flat binary file with the monthly averaged data. This file is real(4) little endian. The global variables the describe the size of this file must already be set. These are: !Num_hist_datatypes !Num_Nodes !Num_GrPt_Lons !Num_GrPt_Lats
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_monthly_histograms_V3_0,lu,month_num,monthly_hist,error lu is the (already open) logical unit that contains the monthly average data month_num is the month number corresponding to the month requested. 0 is Jan 1978 monthly_hist[!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
[ Top ] [ Programs ]
NAME
write_amsu_only_merged_Tbs_144_72_netcdf_3_3.pro
PURPOSE
writes intermediate results from the AMSU-only merge step to a netcdf file
DESCRIPTION
writes intermediate results from the AMSU-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_AMSUs] of offsets applied target_factors Array[!Num_GrPt_Lats,!num_AMSUs] of target factors target_means Array[!num_AMSUs] of mean target temperatures tb_Factors Array[!Num_GrPt_Lats,!num_AMSUs] of tb factors applied months_used Array[!Num_AMSU_months,!num_AMSUs] of offsets applied date_L2C_processed Array[!Num_AMSU_months,!num_AMSUs] of the date each level 2c file used was processed 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 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