Data to Calibrate

Wideband ("White Light") data is equivalent to running "wbCalib -WL"; this option calibrates data taken on the wideband side of the beam splitter. Composite spectrometer is the same as running "wbCalib -Spectrometer"; this will calibrate the summed visibilities from the spectrometer side of the beam splitter. The Spectrometer Channels option runs nbCalib to calibrate narrowband data from the spectrometer channels.

You may choose more than one type of data to calibrate. webCalib handles running multiple programs to produce results for each type of data, and the results are returned in a new HTML page, or a tar of ASCII or L2 FITS files (see Output below for an explanation of output formats).

Calibration Script

A file that describes the target and its calibrators. A description of the format is given in the wbCalib online documentation.

If you do not have a calScript, you may generate a new one from a cat file (follow the link on entry form). No cat file? Use csAdHoc in your getCal installation to make a calScript - or construct one by hand using the format description.

L1 Data File

A L1 data file is a SUM file, SPEC file, or L1 FITS file. If you would like to calibrate more than one type of data you may concatenate SUM and SPEC files into a single file for upload, or upload a L1 FITS file.

If you have more than one night of SUM or SPEC files to process (for the same target) you can concatenate them into a single file for upload.

Baseline File (Optional)

You may provide a .baseline or .bline file. If no file is given webCalib uses a built-in baseline default (K1K2 for KI data and PTI_NS for PTI data). Note that the default baseline will also be used if the input baseline/bline file has format error or contains insufficient data (e.g. too many rejected data samples). In this case a warning message will appear in the output.

For example:

## Error detected in <pid>.bline and <pid>.baseline not found; provisionally using default baseline (PTI_NS).

where <pid> is an integer process identifier on our host system.

Note that the u,v (projected baseline) coordinates for the default baseline may be substantially different from the true coordinates for PTI.

If you choose a baseline file and later decide you do no want to use it, un-check the 'Use Baseline File' box.

A brief description of each output type is given below. Additional format specifications can be found at the KI V2 Data Overview.

On Screen

Default behavior sends results on a new HTML page.

ASCII Text File

webCalib returns results as a text file (Unix line endings). If you chose more than one type of data to calibrate in the input section above, you will receive a tar file containing two or three text files. If you chose only one type of data to calibrate you will receive the text file directly.

L2 FITS File
(-fits filename)

webCalib can also return L2 FITS files. If you chose more than one type of data to calibrate in the input section above, you will receive a tar file containing more than one FITS file. If you chose only one type of data you will receive the resulting FITS file directly.

Run Calibration on Cal Sources
(-doCalibrators)

Check the box to generate a new calibration script for each of the calibrator stars and rerun Calib using that script. This returns calibrated data for the targets and calibrator stars.

Use Flux Bias Correction
(-fluxBias)

Check to box to turn on flux depedent bias correction for Keck Interferometer data

Use Ratio Correction
(-ratioCorrection)

Check the box to turn on ratio correction.

Use rootN Weighting
(-rootNWeighting)

Check the box to turn on root N-sample scaling when computing scan uncertainties.

Band
(-Kband or -Hband or -allband)

Choose to calibrate K band, H band, or all bands.

V2
(-coherentV2 or -incoherentV2)

Choose to calibrate incoherent or coherent V2 data.

FrameRate
(-frameRate)

Enter an framerate (Hz) to calibrate, or the word All to calibrate all data regardless of framerate.

Jitter Correction
(-jitterCorrection[=jitterCoefficient])

Enter a jitter coefficient to use for jitter correction. Leave field blank for no jitter correction.

Calibration Time Window
(-calTimeWindow argument)

Enter time window (hours) for accepting calibration scans.

Calibration Time Proximity Weighting
(-timeWeighting -timeErrorVal argument)

Enter the time (hours) over which the calibrator visibility measurement variance is assumed to double. Leave blank to disable time weighting.

Calibration Angle Proximity Weighting
(-angleProxWeighting -angleErrorVal argument)

Enter target-calibrator angle (degrees) over which calibrator visibility measurement variance is assumed to double. Leave blank to disable angle proximity weighting.

Minimum Scan Uncertainty
(-minScanUncertainty argument)

Enter a minimum calibrated visibility uncertainty (V2 units). Leave blank to disable.

Minimum Scan Duration
(-scanThreshold argument)

Enter the maximum scan duration (seconds).

Calibrator Cross-Consistency Warning Threshold
(-chiWarning argument)

Enter a threshold (sigma) for reporting system visibility estimate inconsistencies.

Calibrator Cross-Consistency Rejection Threshold
(-chiReject argument)

Enter a threshold (sigma) for rejecting science scans due to system visibility estimate inconsistencies.

Delay Tolerance Check
(-delayCheck[=argument])

Enter a tolerance (meters). Warnings will be printed when target and calibrator delay values differ from model calculations by more than the tolerance. Leave blank to disable delay checking.