;***************************************************************************** ; NICST TOOL ; ; Readme file for RC5 Test Part 1. M13 low gain portion. ;***************************************************************************** Extract using the LRV the following files: 27007 ETA_FT_LW_CFPA_HI_RSL, 27009 ETA_FT_SM_CFPA_HI_RSL, 29024 ETP_MF_STOPASSY_BAFF_NZ, 29005 ETP_MF_AO_BLKHD_NX_PZ, 21028 ETP_AP_LW_CCA, 21029 ETP_AP_SM_CCA, 29017 ETP_MF_SCAN_CVTY_BAF_NZ, 29016 ETP_MF_SCAN_CVTY_BAF_PZ, 29014 ETP_MF_SCAN_CAVITY_NX_P, 29011 ETP_MF_TEL_BLKHD_PY, 2006 ETP_BB_6, 22005 ETP_BB_5, 2004 ETP_BB_4, 2003 ETP_BB_3, 22002 ETP_BB_2, 2001 ETP_BB_1, 12021 TP_SE_HAM_MIRR_T1, 12022 TP_SE_HAM_MIRR_T2. First place the LRV files in a directory such as ../Hot_plateau/28V/TMC/LRV/, place the relavant .gse files in a directory such as ../Hot_plateau/28V/TMC/GSE/, and place the relavant .adf files in a directory such as ../Hot_plateau/28V/TMC/ADF/. Then dump the raw dn for 200 M band samples in a directory such as ../Hot_plateau/28V/TMC/. Also, required is the general_TEB.sav file, which contains general band info and sav files for xxx_teb_final_coef.sav (RVS), xxx_rsr.sav (RSR), and xxx_general_coef.sav (xxx=EDU or FU1). ;***************************************************************************** ; General procedure. ;***************************************************************************** 1) RC5_TMC_read_LRV_data.pro Reads the LRV files and scan averages the temperatures (converting to K where appropriate). In addition, the slopes of the temperatures over scan and collect are recorded. Use Slope_temp_1 and Slope_temp_3 for SRV0654, std_obc_temp1 and std_obc_temp2 for SRV0095, and T_obc and T_obc_2 for SRV0598. Input: an input file with a path to the raw data and a path for the output data. Output: ...temp.sav file containing T_xxx[collect] (svs, bcs, tmc, omm, cfpa, lwasp, and mwasp) and T_xxx[ham,collect] (ham, cav, rta, sh, and obc), T_xxx_2[scans,ham,collect] (ham, cav, rta, sh, and obc), slope_temp_1[ham=0 cav=1 rta=2 sh=3 obc=4,ham,collect,a0=1 a1=1], slope_temp_2[cfpa=0 omm=1 lwasp=2 mwasp=3,collect,a0=1 a1=1], slope_temp_3[ham=0 cav=1 rta=2 sh=3 obc=4,ham,a0=1 a1=1], slope_temp_4[cfpa=0 omm=1 lwasp=2 mwasp=3,a0=1 a1=1],slope_temp_5[bcs=0 svs=1,collect,a0=1 a1=1], slope_temp_6[bcs=0 svs=1,collect,a0=1 a1=1], std_obc_temp1[HAM,collect], std_obc_temp1[HAM]). 2) RC5_TMC_rad_1.pro (backup RC5_TMC_rad_1_EDU.pro for the EDU) Reads the temperatures and calculates the radiances based on Planck's radiation law. It then incorporates both the RVS and RSR data to determine the delta radiance for the TMC low temperature collects (between 300 and 370 K). Input: an input file with a path to the raw data and a path for the output data. The input file also contains the paths to sav files for the RVS, EDU instrument coefficients, RSR, and temperature output from RC5_read_LRV_data.pro. Output: ...rad.1.sav file containing ncollects, p[bannds], rad_TMC[collect,band,HAM,detector,subsample,0=RSR 1=no RSR], rad_p1[band,collect,bcs=0 svs=1,0=RSR 1=no RSR], rad_p2[band,HAM,collect,ham=0 rta=1 cav=2 sh=3 obc=4,0=RSR 1=no RSR], and rvs[band,subsample,detector,HAM,bcs=0 svs=1]. 3) RC5_TMC_dn_4.pro (backup RC5_TMC_dn_3.pro) Reads the dumped DN files, background subtracts, scan and frame averages, determines the standard deviations, and calulates the slopes of the data as a function of frames and scans for EV DN. The dn and std are calculated three ways: scan and then frame averaged, frame and then scan averaged, and scan + frame averaged (uses a 3 sigma kick out at each step). Input: an input file with a path to the raw data and a path for the output data. Output: ...dn.sav file containing dn(collect,band,HAM,detector,subsample,F->S S->F S+F], std(collect,band,HAM,detector,subsample,F->S S->F S+F], slope1(collect,band,HAM,detector,subsample,scan,a0=1 a1=1], slope2(collect,band,HAM,detector,subsample,a0=1 a1=1], dn_col(collect,band,HAM,detector,subsample,scan,EV=0 SV=1], std_col(collect,band,HAM,detector,subsample,scan,EV=0 SV=1], dn_col_2(collect,band,HAM,detector,subsample,frame], std_col_2(collect,band,HAM,detector,subsample,frame]. 4) RC5_TMC_fit_1.pro Takes the low temperature rad_TMC and dn generated and fits this data with polynomials at the linear, quadratic, and cubic levels. Fits are conducted for L vs dn (ifit=1-3) and dn vs L (ifit=3-5). Calulates fitting residuals for the first three fits. Input: an input file with a path to the raw data and a path for the output data. Output: ...rg.1.sav file containing ncollects, rg_1[band,HAM,detector,subsample,a0 a1 a2 a3,ifit,0=RSR 1=no RSR] -- radiometric gains, dL_fit[collect,band,HAM,detector,subsample,ifit,0=RSR 1=no RSR] -- fractional fitting residual. 5) RC5_eff_rad.pro Calculates the retreived radiance for the TMC at low temperature and then determines the TMC emissivity. It then extrapolates this emissivity to the high temperature range with a straight line fit. Input: an input file with a path to the raw data and a path for the output data. Output: ...eff_rad.sav file containing rad_BCS_ret[collect,band,HAM,detector,subsample,ifit] emiss_TMC[collect,3,ifit], std_emiss_TMC[collect,3,ifit]. 6) RC5_TMC_rad_2.pro (backup RC5_TMC_rad_2_EDU.pro for the EDU) Reads the temperatures and calculates the radiances based on Planck's radiation law. It then incorporates both the RVS, RSR data as well as the TMC emissivity to determine the delta radiance for the TMC high temperature collects (above 400 K). Input: an input file with a path to the raw data and a path for the output data. The input file also contains the paths to sav files for the RVS, EDU instrument coefficients, RSR, and temperature output from RC5_read_LRV_data.pro. Output: ...rad.2.sav file containing ncollects, p[bannds], rad_TMC[collect,band,HAM,detector,subsample,0=RSR 1=no RSR], rad_p1[band,collect,bcs=0 svs=1,0=RSR 1=no RSR], rad_p2[band,HAM,collect,ham=0 rta=1 cav=2 sh=3 obc=4,0=RSR 1=no RSR], and rvs[band,subsample,detector,HAM,bcs=0 svs=1]. 7) RC5_TMC_fit_2.pro Takes the high temperature rad_TMC and dn generated and fits this data with polynomials at the linear, quadratic, and cubic levels. Fits are conducted for L vs dn (ifit=1-3) and dn vs L (ifit=3-5). Calulates fitting residuals for the first three fits. Input: an input file with a path to the raw data and a path for the output data. Output: ...rg.2.sav file containing ncollects, rg_1[band,HAM,detector,subsample,a0 a1 a2 a3,ifit,0=RSR 1=no RSR] -- radiometric gains, dL_fit[collect,band,HAM,detector,subsample,ifit,0=RSR 1=no RSR] -- fractional fitting residual. The following text files: ...rg.txt,...rg.avg.txt,...rg.no_rsr.txt,...rg.avg.no_rsr.txt . ;************Misc********* Subroutines: read_dmpd.pro read_dmpd2.pro sig_mean.pro n_collect.pro initial_ham_side.pro Planck.pro legend.pro set_legend.pro set_multicolor.pro get_avg_2.pro Files that produce .sav files used here: general_data.pro read_rvs.pro read_rsr.pro FU1_general_coef.pro Input file: Input.txt