; VLBAPIPE - Lorant Sjouwerman, NRAO - Nov 26 01 ; Ver 0.1 : mainly to run BS104* and BS086 ;--------------------------------------------------------------- ;! applies amplitude and phase calibration procs to VLBA data ;# PROCEDURE VLBI UTILITY CALIBRATION ;--------------------------------------------------------------- ;; Copyright (C) 2001-2002 +GNUGPL? ;--------------------------------------------------------------- VLBAPIPE LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC VLBAPIPE: Applies amplitude and phase calibration to VLBA data ! ***************************** This is 'the' input dialog to the VLBA pipeline.. There are NO DEFAULTS! Note the special use of almost all variables ! + Clean up BEFORE you start + +++++++++++++++++++++++++++++ Specify either REFANT or SORT and full TIMERANG or scan#,0. The only further dialog is in loading the distribution tape (1,2,.) by typing 0 & return. After all tapes are loaded it does not need any more inputs provided that values do exist and are legitimate after load checks (will break otherwise) - WHEN IT GOES, IT GOES !!! - Check the plots and if it did a good job, then back it up ! ***************************** OUTNAME VLBA program name (eg BZ099A) First 6=outclass cal'd data! DOALL Tape unit #, < 1 to skip load and -1, -2, etc, for restart with frequency-ID 1, 2, etc, ie. outclass FQ-1, FQ-2, etc or UVDATA if only one freqID =0 will do mcal,subs,fqs too ----------------------------- OPTY 'CONT', 'SPEC', or 'PSEU' for pseudo continuum (continnum, but no frequency averaging). DOPOL Do a polarization calibration DOPOL NOT AVAILABLE YET ----------------------------- NCOUNT Number of distribution tapes, APARM Number of files on each tape. ----------------------------- OUTDISK Working disk with ample space CLINT CL table interval in minutes. ----------------------------- REFANT Reference antenna #, or use 0 SORT and eg. SORT 'PT' if unknown ----------------------------- TIMERANG A good band-pass scan, or use scan# in TIMERANG(1)+rest=0. All antennas must be present in the scan. For specralline this is used for manual pcal otherwise will use PC table. ----------------------------- INFILE 1st IONEX file name for TECOR NFILES Number of days spanning obser vations-ftp those IONEX too! NFILES < 1: don't run TECOR. ----------------------------- CALSOUR List ALL FriFit & CAL sources FIRST is bandpass calibrator Include at least all Ph-Refs Negative: no selfcal attempt (recomm, as it breaks often) SOURCES Source * PAIRS * to calibrate Maximum of 15 Ph-Ref. pairs! START each pair with Ph-Ref. DO NOT repeat non-PRef srcs. ----------------------------- DOTV Show plots: TV>0, PL=0, PS<0. Recommend =0, discourage =-1 BADDISK Disks to avoid for scratch VLBAPIPE is defined solely in LORANTs run file area. ---------------------------------------------------------------- VLBAPIPE Type: Procedure Use: VLBAPIPE is the procedure that applies the VLBA calibration procedures for a-priori amplitude and phase corrections, and also performs fringe fitting on single strong sources and phase-references weak sources. Simple visibility flagging, bandpass calibration, and total electron content corrections are applied before fringe fitting and averaging. It will attempt to self-cal the calibrators and to image the targets. NOTE: this procedure is designed to work on simple VLBA-only experiments! Type RUN VLBAPIPE to define the VLBAPIPE procedure. The procedure itself is run by typing : INP VLBAPIPE; (GO) VLBAPIPE ====================================================================== READ THE EXPLAIN FILE THOROUGHLY BEFORE USING (BECAUSE OF CONVENTIONS) ====================================================================== ---------------------------------------------------------------------------- OUTNAME....VLBA program name (eg. BZ099A) or any other unique name to use. The first 6 characters are used to name the outclass SPLIT data DOALL......Tape unit drive number to use for loading tapes and backing up the data; also used for restarts but be aware of introducing artifacts or breaks when the starting point is chosen wrong: with restarts you're on your own! (Main breaks occur when the structure is different -eg. other sources- per frequency id). OPTY.......Type of observation: 'CONT' for continuum using pulse-cal tones and averaging frequency in the output; 'SPEC' for spectral line using 'manual pulse-cal' on a strong source in a time range and without averaging in frequency; and 'PSEU' for pseudo-continuum using pulse-cal tones (if available) but no frequency averaging DOPOL......Do a polarization calibration NOT AVIALABLE YET! -> CALS xxx??? NCOUNT.....Number of distribution tapes, assuming that no other files are on the tape, ie. NFILES=0 (to advance) in FITLD for all tapes. APARM......Number of files on each tape, NCOUNT in FITLD, in order of appearance; make sure the rest of APARM is set to zero. OUTDISK....Working disk; need ample space to store ALL processed files. CLINT......CL table interval in minutes throughout the calibration. REFANT.....Reference antenna #, or use REFANT=0 and SORT below if unknown. SORT.......Reference antenna NAME (2 characters) to use eg. 'PT'; REFANT=0 TIMERANG...Full 8 value time range for a good BP-calibrator scan for PCAL, or use the scan number in TIMERANG(1) and set the rest to zero. All antennas should have produced good data in this scan/time. INFILE.....First IONEX file name for TECOR; it assumes a fixed format! No need to specify if TECOR is skipped with NFILES < 1. However it is recommended to run TECOR for ALL frequencies up to 15 GHz. The IONEX files can be downloaded through an anonymous ftp to cddisa.gsfc.nasa.gov and following the directory structure: /gps/products/ionex// (take doy from *.sum). NFILES.....Number of days spanning observations for which the consecutive IONEX files have been downloaded, with the same assumed format with only the daynumber incremented (see explainfile TECOR). CALSOUR....List of ALL calibrator sources and sources meant to fringe-fit. Start (cal)source name with a minus if you don't want it to be self-cald afterwards (eg for a weak phase-reference source) NOTE: The first source WILL be used for p-cal+bandpass calibration. SOURCES....Source *PAIRS* to calibrate in a phase-reference scheme. It is assumed that the odd source numbers are the phase-references, the even sources are the target sources, each of them to be phase-referenced to the source directly in front of it. That is > SOURCES='PREF_1','TARG_1','PREF_2','TARG_2','PREF_1','TARG_3' will reference target sources 'TARG_1' and 'TARG_3' to phase- reference source 'PREF_1', and target source 'TARG_2' will be phase-referenced to source 'PREF_2', assuming that all sources used as reference appeared in CALSOUR above (with ample proper phase solutions). Sources solely used for amplitude or bandpass calibration need not (shouldn't!) be repeated in SOURCES under assumption that they appeared in CALSOUR where they should be.. DOTV.......Shows plots interactively when they appear on TV when positive, keeps as PLot files attatched to input file when zero and pipes the unseen(!) PostScript plots to the printer when negative. Recommended use: DOTV=0, and view afterwards with 'p_allplot'. BADDISK....Disks to avoid for scratch ---------------------------------------------------------------------------- VLBAPIPE: Procedure that attempts to calibrate VLBA data blindly. Documentor: Lorant Sjouwerman, lsjouwer@nrao.edu, Version 25 Jan 02. Related Programs: All VLBAUTIL procs, TECOR, BPASS, UVMLN, SPLIT, IMAGR,.. CLIPM, POSSM, VPLOT VLBAPIPE applies VLBAUTIL procedures to simple VLBA-only experiments, with simple flagging and Total Electron Content correction before bandpass calbr. Sources are split after calibration, and strong and phase-reference sources are self-called and target sources are imaged as a fist order quality check. ====================================================================== READ THE EXPLAIN FILE THOROUGHLY BEFORE USING (BECAUSE OF CONVENTIONS) ====================================================================== HIGHLY UNSTABLE PROCEDURE because it is UNDER CONTINOUOS DEVELOPMENT! (LOS). ----------------------------------------------------------------------------