Patches to 31DEC09

You will find patches to known bugs in 31DEC09 here.

With previous releases, we did not change the frozen release tar ball; user sites were required to download the text files and do any compilations themselves. But, beginning with 31DEC04, we provide binary releases for which user sites are not required to have compilers. Therefore, we have reversed our policy. These patches have been applied to the official code of 31DEC09 and may be downloaded using a 31DEC09 "Midnight Job". Any tarball taken after the change date listed below will already have the patches applied. Of course, you may still download and compile the files as before.

The following is a list of pointers to the different patches in this document.

1. IMEAN and IMSTAT must count pixels in double precision for large cubes. 2010-02-05
2. DOBAND must not use edge channels to scale weights for EVLA. 2010-01-18
3. FITLD messed of the polarization type code in the antenna file for FITS IDI files. 2010-01-25
4. Amplitudes were corrected for delay corrections which should be done only if channel averaging is done post correlation. 2010-02-11
5. APCAL read every other row of the weather table and could go off the end. 2010-02-11
6. CVEL could go into an infinite loop and would not shift scans > 1 for single-source files having an index (NX) table 2010-03-01
7. UVFLG failed to flag shadowed antennas correctly 2010-03-05 and 2010-06-23
8. FITLD issued alarming but harmless messages about reference date with EVN FITS-IDI data files. 2010-03-05
9. UVCON did not produce correct models from images 2010-03-17
10. SPLIT and SPLAT corrected the alternate refernce pixel for BCHAN twice 2010-03-17
11. CVEL shifted VLBA antennas wrongly, using the antenna location rather than the center of the Earth 2010-04-05
12. INDXR when making a new CL table 1 for VLA data made mistakes likely to affect P, KA, and Q bands 2010-04-08
13. BPASS aborted when trying to shift VLBA bandpasses 2010-04-21
14. DBCON excited errors in the AN file reformatting 2010-07-09
15. UVCOP and others failed to copy BP table records that were only partially blanked 2010-07-09
16. 2010-??-??

The remainder of this document is comprised of the patch descriptions pointed to by the above references.

Task:

IMEAN

Summary: and IMSTAT need to use double precision to count pixels in large cubes. IMEAN also had a Fortran error at least on some compilers.

Files:

/31DEC09/Y/PGM/IMEAN.FOR

/31DEC09/AIPS/SUB/AU6D.FOR

Fix:

1. Fetch the files listed above and place them in the corresponding area ($YPGM and $AIPSUB, resp.) on your system.
2. COMRPL $AIPSUB/AU6D
3. COMLNK $AIPPGM/AIPS
4. COMLNK $YPGM/IMEAN

Documentor:

Eric W Greisen

Date:

2010-01-18

Date corrected:

2010-02-05

Task:

DOBAND

Summary: Bandpass calibration can also adjust the data weights. For this it must average the amplitude correction in the bandpass over some channels. It is intended to use all channels only for the VLBA and EVN and the central 75% otherwise. The flag that caused the latter to occur was lost and led to bad things since the edgemost channels are frequently quite bad. Note that a very large number of tasks must be link edited - use a MNJ if you can. The instructions below are simplified and do more than necessary.

Files:

/31DEC09/APL/SUB/NOTST/BPASET.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($APLNOT) on your system.
2. COMRPL $APLNOT/BPASET
3. COMLNK $APGNOT/*.FOR
4. COMLNK $APGOOP/*.FOR
5. COMLNK $QPGNOT/*.FOR
6. COMLNK $QPGOOP/*.FOR
7. COMLNK $YPGNOT/*.FOR

Documentor:

Eric W Greisen

Date:

2010-01-18

Task:

FITLD

Summary: did not put in the correct hollerith value for polarization type in the ANtenna file header, The error arose only for FITS IDI files and was diagnosed by Olaf Wucknitz of Bonn University.

Files:

/31DEC09/APL/PGM/NOTST/FITLD.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($APGNOT) on your system.
2. COMLNK $APGNOT/FITLD

Documentor:

Eric W Greisen

Date:

2010-01-25

Task:

DATCAL

Summary: Data calibration applied an amplitude correction whenever there was a delay correction. This is incorrect if the channels are at the same width as they were in the correlator. A correction for post-correlation channel averaging should be done, but only if we develop a way to know how much this is. The VLBA CQ table provides such information for the VLBA.

Files:

/31DEC09/APL/SUB/NOTST/DATCAL.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($APLNOT) on your system.
2. COMRPL $APLNOT/DATCAL
3. COMLNK $APGNOT/*.FOR
4. COMLNK $APGOOP/*.FOR
5. COMLNK $QPGNOT/*.FOR
6. COMLNK $QPGOOP/*.FOR
7. COMLNK $YPGNOT/*.FOR

Documentor:

Eric W Greisen

Date:

2010-02-11

Task:

APCAL

Summary: had a coding error that caused it to read every other row of the weather table. For some reason, it would also attempt to read off the end of the table, casing the task to quit.

Files:

/31DEC09/Y/PGM/NOTST/APCAL.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($YPGNOT) on your system.
2. COMLNK $YPGNOT/APCAL

Documentor:

Eric W Greisen

Date:

2010-02-11

Task:

CVEL

Summary: had a relatively recent bug that could cause it to go into an infinite loop. It also would not shift scans 2 through N for single-source files having an index (NX) table. That has often been the case over the past 1 or 2 years. The fact of this lack of shift was obscured by the failure of the program to set a valid source name. The null name caused the message that said "no shift" to be truncated.

Files:

/31DEC09/Q/PGM/NOTST/CVEL.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($QPGNOT) on your system.
2. COMLNK $QPGNOT/CVEL

Documentor:

Eric W Greisen

Date:

2010-03-01

Task:

UVFLG

Summary: had a call sequence error that caused the flagging for shadowing to be done quite incorrectly. It also used station longitude rather than array longitude in computing the hour angle (second correction made 23 June).

Files:

/31DEC09/APL/PGM/NOTST/UVFLG.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($APGNOT) on your system.
2. COMLNK $APGNOT/UVFLG

Documentor:

Eric W Greisen

Date:

2010-03-05, 2010-06-23

Task:

FITLD

Summary: assumed that RDATE was a required keyword, which it is not although the VLBA writes it very freely. This caused alarming messages to appear with EVN data sets but did not seem to affect the output. Fixed it to use only non-blank RDATEs and to retain the RDATE when it is found.

Files:

/31DEC09/APL/PGM/NOTST/FITLD.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($APGNOT) on your system.
2. COMLNK $APGNOT/FITLD

Documentor:

Eric W Greisen

Date:

2010-03-05

Task:

UVCON

Summary: was not changed sufficiently when DO3DIMAG false was changed to use a uvw rotation matrix. The output models from images were correct for very small values of u, but not for larger values of u. A sufficient correction is to defend UVPROT from a zero-valued rotation matrix.

Files:

/31DEC09/APL/SUB/UVPROT.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($APLSUB) on your system.
2. COMRPL $APLSUB/UVPROT
3. COMLNK $QPGNOT/UVCON

Documentor:

Eric W Greisen

Date:

2010-03-17

Task:

SPLIT

Summary: and SPLAT computed the alternate reference pixel from multi-source input data sets not realizing that the new reference pixel had already been corrected for BCHAN. Thus, the correction ended up being applied twice.

Files:

/31DEC09/APL/PGM/NOTST/SPLIT.FOR

/31DEC09/APL/PGM/NOTST/SPLAT.FOR

Fix:

1. Fetch the files listed above and place them in the corresponding area ($APGNOT) on your system.
2. COMLNK $APGNOT/SPL{I,A}T

Documentor:

Eric W Greisen

Date:

2010-03-17

Task:

CVEL

Summary: lost track of the fact that the array was the VLBA and so shifted the spectra based on the location of the first antenna in each baseline. The correct shift is based on the center of the Earth and so is just about the same for each antenna.

Files:

/31DEC09/Q/PGM/NOTST/CVEL.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($QPGNOT) on your system.
2. COMLNK $QPGNOT/CVEL

Documentor:

Eric W Greisen

Date:

2010-04-05

Task:

INDXR

Summary: had an array with provision for only 8 rather than the current 10 bands for VLA antenna gains. That and another error caused KA and Q band data to use erroneous values for antennas for which there are no gains. It also pushed Q band numbers into places used for P band, causing antenna gains to appear for a band that should have none.

Files:

/31DEC09/APL/PGM/OOP/INDXR.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($APGOOP) on your system.
2. COMLNK $APGOOP/INDXR

Documentor:

Eric W Greisen

Date:

2010-04-08

Task:

BPASS

Summary: was not changed when the call sequence to FRQUPD was changed. The result was an abort when trying to figure out how to shift VLBA bandpasses.

Files:

/31DEC09/Q/PGM/NOTST/BPASS.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($QPGNOT) on your system.
2. COMLNK $QPGNOT/BPASS

Documentor:

Eric W Greisen

Date:

2010-04-21

Task:

DBCON

Summary: managed to excite an error in the AN file reformatting routines which caused the INPUT files to have their headers changed in an incorrect fashion. Prevented this error and also added new station names and the MWA array to the antenna-find routine.

Files:

/31DEC09/APL/SUB/ANREFM.FOR

/31DEC09/APL/SUB/ANFIND.FOR

/31DEC09/APL/SUB/RMEXT.FOR

Fix:

1. Fetch the .FOR files listed above and place them in the corresponding area ($APLSUB) on your system.
2. Do the patch below which will install both patches.

Documentor:

Eric W Greisen

Date:

2010-07-09

Task:

BP

Summary: tables were changed when they were copied, omitting not only fully flagged solutions, but also solutions in which the right or the left polarization was flagged but the other was good. All records must be copied even if flagged to avoid changing how the BP table is applied.

Files:

/31DEC09/APL/SUB/NOTST/BPFSEL.FOR

/31DEC09/APL/PGM/NOTST/UVDEC.FOR

/31DEC09/July8.comlnk

Fix:

1. Fetch the BPFSEL file listed above and place it in the corresponding area ($APLNOT) on your system.
2. Fetch the UVDEC file listed above and place it in the corresponding area ($APGNOT) on your system.
3. Fetch the July8.comlnk file and place it in your work area. Use it for this and the previous patch.
4. source ./July8.comlnk

Documentor:

Eric W Greisen

Date:

2010-07-09

Task:

Summary:

Files:

/31DEC09/

Fix:

1. Fetch the file listed above and place it in the corresponding area ($???) on your system.
2. COMLNK $

Documentor:

Eric W Greisen

Date:

2010-??-??