It assumed that SWIN format visibility file(s) to be converted live in directory <baseFilename>.difx/ It is also assumed that at least 3 additional files exist: <baseFilename>.input DiFX input file <baseFilename>.calc Base file for calcif <baseFilename>.im Polynomial UVW and model One other files is optionally read: <baseFilename>.flag Antenna-based flagging
VLBA calibration transfer will produce 4 files: flag, tsys, pcal, weather If these are present in the current directory, they will be used to form the FL, TS, PH and WR tables
If env variable GAIN_CURVE_PATH is set, gain curves will be looked for and turned into a GN table
The output file <outfile> will be written in FITS-IDI format nearly identical to that made at the VLBA HW correlator. The first two optional files are required for full model accountability.
options can include: --help -h Print this help message
--bin <bin> -B <bin> Select on this pulsar bin number
--difx -d Run on all .difx files in directory
--no-model -n Don't write model (ML) table --dont-combine -1 Don't combine jobs
--scale <scale> -s <scale> Scale visibility data by <scale>
--deltat <deltat> -t <deltat> Set interval (sec) in printing job matrix (default 20.0)
--difx-tsys-interval -i <interval> Set the Difx-derived tsys interval (sec) (default 30.0)
--difx-pcal-interval <interval> Set the Difx-derived pcal interval (sec) (default 30.0), 0 means to average over a whole scan
--phaseCentre <p> --phasecenter <p> Create a fits file for all the <p>th phase centres (default 0)
--keep-order -k Keep antenna order
--ac-always -a Write standard autocorrelations into every output file
--profilemode Don't discard autocorrelations for pulsar bins other than bin 0 --skip-extra-autocorrs Ignore e.g. LL autocorrs in a job with only RR cross-corrs --history <file> -H <file> Read file <file> and populate FITS History --sniff-all -S Sniff all bins and centers --dont-sniff -x Don't produce sniffer output
--sniff-time <t> -T <t> Sniff output on a <t> second timescale (default 30.0) Set to zero to disable sniffing
--union -u Form union of frequency setups
--max-jobs <max> -m <max> Set maximum number of jobs to merge into one FITS file to <max>
--eop-merge-mode Set the mode for merging differerent EOPs. Legal modes are strict (default), drop, relaxed.
--clock-merge-mode Set the mode for merging clock entries of an antenna. Legal modes are strict (default), drop (ignore clock breaks).
--verbose -v Be verbose. -v -v for more!
--override-version Ignore difx versions
--zero -0 Don't put visibility data in FITS file --antpol Use antenna-based polarization codes. Warning: fits-idi file will violate original specifcaitions and abide extended specifications. --polxy2hv Convert XY polarziation codes to HV codes. Requires --antpol option --localdir -l *.calc, *.im, and *.difx are sought in the same directory as *.input files --all-pcal-tones -A Extract all phase calibration tones --primary-band <pb> Add PRIBAND keyword with value <pb> to FITS file --relabelCircular Change naming of all polarizations to R/L --vanVleck Force difx2fits to apply van Vleck correction --bandpass Write baseline-based bandpass to .bandpass file --applybandpass <file> Read <file> and apply it as a bandpass to the output --applydelaycal <file> Read <file> and apply it as delay corrections to the output --sourcelist <list> Only propagate source(s) listed (comma separated) difx2fits responds to the following environment variables: DIFX_GROUP_ID If set, run with umask(2). DIFX_VERSION The DiFX version to report. DIFX_LABEL Your local DiFX version label. GAIN_CURVE_PATH Path where gain curves can be found. TCAL_PATH Path where switched power T_cal values are found. TCAL_FILE Path to single specific T_cal file. DIFX_MAX_SNIFFER_MEMORY Max number of bytes to allow for sniffing. DIFX2FITS_UVFITS_DUMP Prints in stdout the ascii dump of records from the binary visilibity file. Warning: the output may be huge. DIFX2FITS_UVFITS_DUMP_UTCMIN Sets the minimum UTC time tag for the visibility dump. Units are seconds. Default is zero. DIFX2FITS_UVFITS_DUMP_UTCMAX Sets the maximum UTC time tag for the visibility dump. Units are seconds. Default is 86400. DIFX_USE_CABLE_CAL If 0, then cable calibration files are ignored. Default is 1. PLEASE file all bug reports at http://svn.atnf.csiro.au/trac/difx . Include at a minimum the output of difx2fits with extra verbosity (that is with -v -v). The .input, .im & .calc files may help too.