User Contributed Perl Documentation TABLEPLOT_IR(1) NNNNAAAAMMMMEEEE tableplot_ir.pl - make a DQC log for IR data SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ttttaaaabbbblllleeeeppppllllooootttt____iiiirrrr....ppppllll [----nnnnvvvv] _i_n_d_i_r [...] _o_u_t_d_i_r DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN ttttaaaabbbblllleeeeppppllllooootttt____iiiirrrr....ppppllll generates a data quality control (DQC) log for infra-red data (initially WFCAM), from a set of object catalogue files in _i_n_d_i_r. The log files are written to the directory _o_u_t_d_i_r, which is created first if necessary, with a subdirectory made for each input catalogue directory, named by taking the _b_a_s_e_n_a_m_e(1) of _i_n_d_i_r (see EXAMPLES, below). The default is to create an HTML page, _d_q_c._h_t_m_l, containing the generated plots as inline PNG images, with links to Postscript versions of the plots (for printing) and to the summary files generated. This mode can be disabled, such that only the summary files and Postscript plots are produced (see OPTIONS, below). The catalogue files are searched for in the directories _i_n_d_i_r specified on the command line. They are expected to be named with __c_a_t._f_i_t_s at the end of the filename (extensions of ._f_i_t and ._f_t_s are also supported). The following files are generated: _s_u_m_m_a_r_y._p_s Plots of the surface brightness, seeing, 1-sigma sky noise and 5-sigma magnitude limit, per filter, by day. _s_u_m_m_a_r_y._l_i_s_t A DQC summary ASCII table containing one line per detector in each data-set, with various DQC parameters. The columns are described under SUMMARY COLUMNS, below. _s_k_y._p_e_r_c_e_n_t_a_g_e_s A table of the median percentage sky level differences from catalogue analysis. This is used as input to _f_i_t_s_i_o__p_e_r_c_e_n_t(1). _e_l_l_i_p_t._p_s A plot of the average stellar ellipticity for each detector, per day. _s_e_e_i_n_g._p_s A histogram of the seeing over all detectors and days. _s_e_e_i_n_g._h_i_s_t An ASCII table of the data used to produce _s_e_e_i_n_g._p_s. 2003-07-01 Last change: perl v5.6.0 1 User Contributed Perl Documentation TABLEPLOT_IR(1) _a_s_t_r_o_m._p_s Plots of the RMS astrometric fit error, number of astrometric standards used in calibration and mean pointing error for each detector, by day. _d_e_t_e_c_t._p_s Plots of the stellar aperture correction and number of detected sources for each detector, by day. _s_i_t_e._p_s Plots of the relative humidity, Tau at 2.5GHz, wind direction (in degrees azimuth) and wind speed by day. OOOOPPPPTTTTIIIIOOOONNNNSSSS The following command-line options are supported: -nnnn Disables HTML output: only the files listed above are produced. Otherwise, additional PNG images and a file _d_q_c._h_t_m_l are produced. -vvvv Increases the verbosity level of the program. SSSSUUUUMMMMMMMMAAAARRRRYYYY CCCCOOOOLLLLUUUUMMMMNNNNSSSS The following columns are present in the summary files (_s_u_m_m_a_r_y._l_i_s_t): _R_u_n _n_o. An identifier for the frame in the format _w_{_r_u_n}_{_c_h_a_n} where {_r_u_n} is the run number, and {_c_h_a_n} is the detector DAS channel. _C_C_D A blank column for historical reasons. _O_b_j_e_c_t _N_a_m_e Name of the target, taken from the _O_B_J_E_C_T FITS header. _R_A Right ascension of the desired target position, in sexagesimal format with the hours, minutes, seconds separated by `:'. _D_e_c Declination of the desired target position, in sexagesimal format with the degrees, arcminutes, arcseconds separated by `:'. _E_q_u_i_n_o_x The equinox of _R_A and _D_e_c. For WFCAM data no leading `J' is present: the equinoxes are always Julian. _A_M The effective mean airmass. _P_A Position angle of the observation. For WFCAM data this is always `-1.0' since the detector cannot be rotated. 2003-07-01 Last change: perl v5.6.0 2 User Contributed Perl Documentation TABLEPLOT_IR(1) For INT and other data this gives the rotator angle. _D_a_t_e The observation date (in UTC). This is in the format _y_y_y_y-_m_m-_d_d. _U_T The start UT of the integration, in the format _h_h:_m_m:_s_s. _E_x_p The measured actual length of the exposure computed in the micro-controller. _F_i_l_t Filter used in the observation. For IR data this will generally be `J', `H' or `K'. _S_e_e_i_n_g Average realistic stellar FWHM in arcseconds. _S_k_y Median sky brightness, in ADU. _N_o_i_s_e Robust MAD estimator for the pixel noise at the sky level, scaled to the equivalent Gaussian RMS, in ADU. _E_l_l_i_p_t A direct estimate of the average stellar ellipticity in the frame, useful for spotting trailed frames, etc. _A_P_c_o_r Stellar image aperture correction for the default recommended aperture measure, diameter =2x{FWHM}, in magnitudes. _S_T_D_r_m_s RMS astrometric fit error in arcseconds. _C_o_m_m_e_n_t_s Extra space for insertion of user comments. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS Process catalogues from the directory /_d_i_r_e_c_t_o_r_y/_i_n_d_i_r, writing output to _o_u_t_d_i_r. This fill create a directory named _o_u_t_d_i_r/_i_n_d_i_r containing the output files. tableplot_ir.pl /directory/indir outdir The same, except with no HTML output. tableplot_ir.pl -n /directory/indir outdir 2003-07-01 Last change: perl v5.6.0 3 User Contributed Perl Documentation TABLEPLOT_IR(1) SSSSEEEEEEEE AAAALLLLSSSSOOOO _b_a_s_e_n_a_m_e(1), _f_i_t_s_i_o__p_e_r_c_e_n_t(1) AAAAUUUUTTTTHHHHOOOORRRR Jonathan Irwin (jmi@ast.cam.ac.uk) Based on fitsiotableplot, written by Mike Irwin (mike@ast.cam.ac.uk) 2003-07-01 Last change: perl v5.6.0 4