Patches to 31DEC08

You will find patches to known bugs in 31DEC08 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 31DEC08 and may be downloaded using a 31DEC08 "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. CALIB could infinite loop if 1st NX record 0 length 2009-01-27
2. TYAPL would apply the highest flag table without permission when it should just be copied 2009-02-04
3. OFM files were not adjusted to the new TV instensity ranges 2009-04-02
4. IMAGR TV option FORCE A FIELD caused all facets to be re-imaged; scratch files way too large under some circumstances 2009-04-22
5. DBCON copied keyword MAXBLINE which confused later imaging routines 2009-04-27
6. IMAGR had a limit test that was too small affecting restoration of large numbers of CCs from one facet to another 2009-05-18
7. IMAGR had a tendency to sort input data sets when it did not really have to do so 2009-06-19
8. install.pl skipped the automatic tarball download when one was missing 2009-07-26
9. FITLD did not correct the AN table frequency when rearranging frequency order for IDI-format data 2009-08-18
10. BPASS did not translate the ICHANSEL adverb correctly, causing all channels to be averaged 2009-11-11
11. ANFIX8 is a new RUN file and procedure to correct ANtenna files back to 31DEC08 geometry 2009-11-30
12. 2009-??-??

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

Task:

CALIB

Summary: The handling of scan averaging corrected for 0-length scans (a single time) for all NX records except the first. Added a line to prevent an infinite loop when the first NX record is of zero length.

Files:

/31DEC08/Q/PGM/NOTST/CALIB.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2009-01-27

Task:

TYAPL

Summary: uses the calibration software set to read/copy the data. The default FLAGVER was used which meant that the flag table was actually applied, an unintended result. Corrected the variable internally so that the FG table will be copied and not otherwise used.

Files:

/31DEC08/APL/PGM/NOTST/TYAPL.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2009-02-04

Task:

OFM

Summary: files are provided in $AIPSOFM as a convenience in setting color look up tables. When the TV was changed to use 0-2045 rather than 0-255 as its intensity range, these tables were not changed. The plot tasks (e.g. KNTR) handled this correctly, but OFMGET et al. verbs did not. The OFM files were recomputed and the routines that read them were changed for a new file name form and for the need to up the format for a wider range of input intensities.

Files:

/31DEC08/APL/SUB/OFMDIR.FOR

/31DEC08/Y/SUB/GETOFM.FOR

/31DEC08/TEXT/OFM/*.000

Fix:

1. Fetch the 2 files listed above and place them in the corresponding areas ($APLSUB and $YSUB) on your system.
2. COMRPL $APLSUB/OFMDIR $YSUB/GETOFM
3. COMLNK $AIPPGM/AIPS
4. COMLNK $APLOOP/PLAYR
5. COMLNK $YPGM/{PCNTR,GREYS,KNTR,LWPLA}
6. Fetch the 52 files in the OFM TEXT area and place them in the area $AIPSOFM on your system.

Documentor:

Eric W Greisen

Date:

2009-04-02

Task:

IMAGR

Summary: has a TV-option FORCE A FIELD which is supposed to select a new facet and re-image only that facet. A one-character error in QCLEAN caused it to re-image all facets at great expense. The attempt to handle sub-images as models led to making very large work files for offset facets when DO3D false.

Files:

/31DEC08/Q/SUB/OOP/QCLEAN.FOR

/31DEC08/Q/SUB/NOTST/GRDSUB.FOR

/31DEC08/APL/SUB/NOTST/GRDSET.FOR

Fix:

1. Fetch the files listed above and place it in the corresponding area ($QOOP, $QNOT, $APLNOT respectively) on your system.
2. COMRPL $QOOP/QCLEAN
3. COMRPL $QNOT/GRDSUB
4. COMRPL $APLNOT/GRDSET
5. COMLNK $QPGOOP/IMAGR

Documentor:

Eric W Greisen

Date:

2009-04-22

Task:

DBCON

Summary: copied all header keywords including MAXBLINE despite the fact that the value of that parameter is likely to be different in the concatenated database. This led to errors in imaging including failures in uniform weighting.

Files:

/31DEC08/APL/PGM/NOTST/DBCON.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2009-04-27

Task:

IMAGR

Summary: restores Clean Components from one facet to another when they overlap. The test on the maximum number that may be restored failed, with a message, around 85000 CCs when ~1000 times that could fit. Corrected the test.

Files:

/31DEC08/Q/SUB/OOP/QCLEAN.FOR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($QOOP) on your system.
2. COMRPL $QOOP/QCLEAN.FOR
3. COMLNK $QPGOOP/IMAGR.FOR

Documentor:

Eric W Greisen

Date:

2009-05-18

Task:

IMAGR

Summary: makes a decision about the available memory in order to decide whether the data remain in the input sort order or are put in XY order. Errors in 2 places caused it to conclude wrongly that sorts were required in many cases.

Files:

/31DEC08/Q/SUB/OOP/QCLEAN.FOR

/31DEC08/Q/SUB/OOP/QUVUTIL.FOR

Fix:

1. Fetch the files listed above and place tthem in the corresponding area ($QOOP) on your system.
2. COMRPL $QOOP/Q{CLEAN,UVUTIL}.FOR
3. COMLNK $QPGOOP/{IMAGR,SCIMG,SCMAP}

Documentor:

Eric W Greisen

Date:

2009-06-19