C.5 VLBA Pipeline

VLBARUN is a procedure which uses the VLBA calibration procedures (from VLBAUTIL) and some logic to calibrate and image VLBA data. VLBARUN attempts to make intelligent decisions on defaults, so it can be run fairly automatically if the names of the sources are known. If desired, VLBARUN will produce diagnostic plot files and write them to disk, creating an HTML file to ease examination of these files. Images will be produced, but no self-cal is done, so the images should be considered diagnostic in nature.

VLBARUN does all the calibration steps described in C.1 and the next few sections. It does not do polarization calibration or flagging. Although VLBARUN is intended for simple VLBI observations, the addition of non-VLBA antennas should work if all the non-VLBA system temperature and gain curve information are loaded into the first TY and GC tables.

Sample inputs for procedure VLBARUN are:

> RUN VLBAUTIL  C R

to acquire the procedures used by VLBARUN.

> RUN VLBARUN  C R

to acquire VLBARUN.

> INDISK n ; GETN ctn  C R

to specify the input data file.

> OPTYPE ’CONT’

to say this is a continuum data set.

> CLINT 0

to use default.

> CHREFANT ’FD’

to set reference antenna to Fort Davis.

> TIMERANG 0

to have VLBARUN determine a good instrumental delay calibration scan.

> INVER 0

PC table to use, -1 if you want to force manual phase cal.

> CALSOUR ’CAL-BAND’, ’CAL-PHASE’, ’CAL-AMP’

to list calibrators, bandpass calibrator must be first.

> SOURCES ’CAL-PHASE’, ’TARGET’

to list phase referencing and target pairs.

> INFILE 

set if you want to apply a zenith delay file produced by DELZN.

> SOLINT 0

to use default.

> IMSIZE 512

to make images and specify size of target images.

> FACTOR 0

to make calibrator images 128x128.

> DOPLOT 1

to make some diagnostic plots.

> OUTFILE /directory/name

to specify directory for output plots. If this is set then plots are written out from AIPS and organized in an HTML file for easy viewing. Preferably, this directory should be empty before the procedure is used.

> OUTTEXT email@somewhere.edu

to specify an e-mail address if the user wants to be notified when the pipeline is done.

> BADDISK 0  C R

to specify which disks to avoid for scratch.

> VLBARUN  C R

to run the procedure.

VLBARUN will then run and produce the requested number of diagnostic plots. For details on the plots produced for each level of DOPLOT see EXPLAIN VLBARUN. If an e-mail address is specified then a VLBARUN DONE or VLBARUN FAILED message will be sent. However, the VLBARUN FAILED message will only be sent if VLBARUN failed because of problems with the inputs, if VLBARUN failed because a task it was running failed this message is not sent. It is highly recommended that the user read the explain file for VLBARUN