; BPEPL ;--------------------------------------------------------------- ;! Plots bandpass tables overlaying multiple times like BPEDT ;# TASK PLOT SPECTRAL UV CALIBRATION ;----------------------------------------------------------------------- ;; Copyright (C) 2020 ;; Associated Universities, Inc. Washington DC, USA. ;; ;; This program is free software; you can redistribute it and/or ;; modify it under the terms of the GNU General Public License as ;; published by the Free Software Foundation; either version 2 of ;; the License, or (at your option) any later version. ;; ;; This program is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. ;; ;; You should have received a copy of the GNU General Public ;; License along with this program; if not, write to the Free ;; Software Foundation, Inc., 675 Massachusetts Ave, Cambridge, ;; MA 02139, USA. ;; ;; Correspondence concerning AIPS should be addressed as follows: ;; Internet email: aipsmail@nrao.edu. ;; Postal address: AIPS Project Office ;; National Radio Astronomy Observatory ;; 520 Edgemont Road ;; Charlottesville, VA 22903-2475 USA ;----------------------------------------------------------------------- BPEPL LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC BPEPL: plot bandpass table overlaying multiple times like BPEDT INNAME Input UV data (name) INCLASS Input UV data (class) INSEQ Input UV data (seq. #) INDISK Input UV data disk drive # INVERS Input table file version no. FREQID -1.0 Frequency ID; 0 => 1 SUBARRAY 0.0 Subarray number 0 => 1. TIMERANG Time range to include BCHAN Lowest channel number ECHAN Highest channel number BIF First IF to include EIF Last IF to include ANTENNAS Antennas to include/exclude DO3COLOR -1.0 2.0 > 0 => color times < 0 black & white plot file APARM Initial plot ranges for (1,2) amplitude (3,4) phase (5) fraction for phase (6) > 0 do image type plot LTYPE -410.0 410.0 Type of labeling: 1 border, 2 no ticks, 3 standard, 4 rel to center, 5 rel to subim cen 6 pixels, 7-10 as 3-6 with only tick labels <0 -> no date/time DOTV -1.0 1.0 > 0 Do plot on the TV, else make a plot file GRCHAN 0.0 8.0 Graphics channel 0 => 1. XYRATIO 0.0 X/Y ratio 0 -> fit TV or 1 PL IMSIZE Size for grid plot when APARM(6) > 0. 0 -> 1000 BADDISK Disks to avoid for scratch ---------------------------------------------------------------- BPEPL Type: Task Use: This task makes plots much like BPEDT but can put them in plot files for later display rather than using the TV and interactivity. The two polarizations are always plotted separately. Adverbs: INNAME.....Input UV data file (name). Standard defaults. INCLASS....Input UV data file (class). Standard defaults. INSEQ......Input UV data file (seq. #). 0 => highest. INDISK.....Input UV data file disk drive #. 0 => any. INVERS.....Input table file version number, 0 -> current highest. The input file is not changed, but may be sorted. FREQID.....Frequency ID to edit. 0 => 1. SUBARRAY...Subarray number to edit. 0 => 1. TIMERANG...Time range of the data to be edited. In order: Start day, hour, min. sec, end day, hour, min. sec. Days are relative to the reference date. BIF........The lowest numbered IF to include. 0 => 1. EIF........The highest numbered IF to include. 0 =>highest. Note: not all data sets will have IFs. ANTENNAS...A list of antenna numbers to include. 0 => all. DO3COLOR...If DO3COL > 0, use 3 grey-scale image planes to plot the data in colors so as to differentiate between times. The first time is pure red, the last nearly pure blue. Blue can overwrite the earlier times. < 0 on plot files => make a black on white plot. Use DOCOLOR <= 0 in LWPLA = 0 on plot files, color plotted points with standard color for GRCHAN (default = 4 = cyan). Any DOCOLOR works in LWPLA. > 0 on plot files plots points in suitable colors (as above) on a black background. DOCOLOR > 0 in LWPLA is needed to see labels. APARM......Initial plot rnges - can change later (1) Minimum amplitude plotted (2) Maximum amplitude plotted (1) >= (2) self-scale (3) Minimum phase (degrees) plotted (4) Maximum phase plotted (3) >= (4) self-scale (5) Fraction of vertical scale for phase. 0 -> 0.3 (6) > 0 => plot the bandpasses into memory and then put the grid as an image onto the TV or the plot file. If there are lots of times, this can be quite a saving. LTYPE......Labelling type, see HELP LTYPE for details: 1 = border, 2 = no ticks, 3 or 7 = standard, 4 or 8 = relative to ref. pixel, 5 or 9 = relative to subimage (BLC, TRC) center, 6 or 10 = pixels. 7-10 all labels other than tick numbers and axis type are omitted. Less than 0 is the same except that the plot file version number and create time are omitted. Add n * 100 to alter the metric scaling. DOTV.......> 0 => plot directly on the TV device, otherwise make a plot file for later display on one or more devices (including the TV if desired). GRCHAN.....Graphics channel (1 - 7) to use for line drawing. 0 => 1. XYRATIO....Scale the X axis longer than the Y by XYRATIO. If DOTV > 0, 0 -> fit to the TV window If DOTV <= 0, 0 -> 1. IMSIZE.....If APARM(6) > 0 and DOTV <= 0, make the grid this size. The default is 1000 x 1000. Note that is IMSIZE is larger than your TV screen, then TVPL will not be able to plot. LWPLA can handle any size. BADDISK....The disk numbers to avoid for scratch files (sorting tables mostly). ------------------------------------------------------------------------