Documentation - lx_wmap_run_iterative_calibration.pro

pro lx_wmap_run_iterative_calibration, raw_fits_prefix, cal_fits_prefix, sol_prefix, calibration_dir, map_dir, aux_dir, mask, map_rounds, map_n_years, map_years, da, zero_offset=offset, iter_num, iter_start=iter_init

• raw_fits_prefix Directory with raw TOD FITS archives.
• cal_fits_prefix Directory for calibrated FITS archives.
• sol_prefix Directory for calibration solutions (gain, baseline).
• calibration_dir Working directory for calibration (extracted raw data in SQL files).
• map_dir Working directory for mapmaking (output maps).
• aux_dir Auxiliary files (calibration application, masks, LOS tables, pre-compiled helper libraries).
• mask Mask file (name) used for masking in both calibration and mapmaking.
• map_rounds Number of map-making rounds (usually 80).
• map_n_years Number of years in the TOD set.
• map_years Years used in map-making.
• da Detector assembly (DA) to be calibrated.
• zero_offset If set evaluate pointings at the beginning of each observation, use the center otherwise.
• iter_num Number of iterations.
• iter_start This can be used to restart iterations from a given index provided that "calibration_dir" still contains data from previous iterations.

lx_wmap_run_iterative_calibration, "/home/user/uncalibrated-tod/", "/home/user/calibrated-tod/", "/home/user/calibration-solutions/", "/home/user/uncalibrated-tod-sql/", "/home/user/map-making/", "/home/user/auxiliary/", "wmap_processing_r9_mask_3yr_v2.fits", 80, 1, 1, "Q1", 5

Provided that there is one year of data in "/home/user/uncalibrated-tod/" use the whole year. The command above extracts the necessary information from the archives for calibration of "Q1" assembly into "/home/user/uncalibrated-tod-sql/". It also makes a copy of uncalibrated archives to "/home/user/calibrated-tod/" which will serve as calibrated archives for map-making. Calibration solutions for each iterative run go to "/home/user/calibration-solutions/" and maps to "/home/user/map-making/". Each map is iterated 80 times and the whole procedure is repeated in total 5 times.

NOTE #1: In case you already have extracted data. It is possible to copy the files manually into "/home/user/uncalibrated-tod-sql/" prior to calibration. This forces the routine to skip the extraction step.

NOTE #2: To save storage space, the routine does not store a copy of calibrated FITS files and raw SQL database files after each iteration. It rather overwrites any previous versions of the files. The number of calibration / raw data reduction runs already performed on any given assembly is stored in a calibration log file in the auxiliary directory. The log stores an IDL structure and can be loaded and edited in IDL. When re-running the procedure on an already processed assembly, make sure to first clear the associated log entry.