Patches to 31DEC14

You will find patches to known bugs in 31DEC14 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 31DEC12 and may be downloaded using a 31DEC13 "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. DOFARS procedure and inputs retained adverbs no longer used by FARS. 2015-01-02
2. RMFIT failed to copy the FQ table to the output residual images. 2015-01-13
3. FTFLG messed up antenna numbers in the output FG table when a single antena or baseline was used 2015-01-16
4. VLBATECR had trouble around the end of the year deciding what files needed to be downloaded. 2015-01-19
5. VLBARUN requires convert to make the html output files. Added tests and a control on DOTV. 2015-01-19
6. BPASS had an array and history writing code which could not handle more than 32 antennas. 2015-01-20
7. MORIF messed up bandpass and other spectral tables 2015-01-29
8. TYSMO did not apply clipping unless median-window filtering was also requested 2015-02-11
9. BPASS did not understand that low-level VLB routines expected left-handed antenna coordinates 2015-02-21
10. UV data disk I/O had an issue if the full file fit into the first of the two buffers and the disk file was exactly the right size! 2015-04-24
11. START_AIPS, START_TVSERVERS needed a grammar change to support Mac yosemite systems 2015-04-24
12. Basic calibration subroutines mis-computed the channel wavelengths and did not always do dispersion correction 2015-05-19
13. XAS needed a change to support Mac yosemite systems and also to write black character backgrounds 2015-05-20
14. KRING help file adverb list did not match that of the Fortran. 2015-06-17
15. IMAGR did not do the baseline-based time averaging properly for the last baselines written to the work file. 2015-06-22
16. PCAL did not detect fully flagged channels when using a source model and so died. 2015-08-14
17. SETJY had bad formats capable of aborting the task 2015-08-22
18. SAD and TVSAD hid the new model-fit table when making a stars table. 2015-09-07
19. PCAL did not do mode SPECTRAL false correctly, leaving files open and then quitting. 2015-09-14
20. 2015-??-??

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

Task:

DOFARS

Summary: procedure and help/inputs files retained and used OUT2NAME et al adverbs which were dropped some time ago from FARS. Theye were dropped and OUTNAME et al substituted.

Files:

/31DEC14/RUN/DOFARS.001

/31DEC14/HELP/DOFARS.HLP

Fix:

1. Fetch the files listed above and place them in the corresponding areas ($RUNSYS AND $HLPFIL, respectively) on your system.

Documentor:

Eric W Greisen

Date:

2015-01-08

Task:

RMFIT

Summary: needed to copy the FQ table from the input file to the output residual Q and U image cubes so that the frequencies would be known. This had been overlooked.

Files:

/31DEC14/Y/PGM/RMFIT.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2015-01-13

Task:

FTFLG

Summary: had vestiges of SPFLG code for handling baselines. That needs to be completely different since they all appear in one plane. Corrected the output flag and history records to have correct baseline information.

Files:

/31DEC14/Y/PGM/NOTST/FTFLG.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2015-01-16

Task:

VLBATECR

Summary: did not handle the change to a new year properly when figuring out which files to download.

Files:

/31DEC14/RUN/VLBAUTIL.001

Fix:

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

Documentor:

Eric W Greisen

Date:

2015-01-19

Task:

VLBARUN

Summary: procedure requires the convert program in the local system in order to produce the html version of the output plots. Added a test for the absence of this program. Also added the setting of DOTV to zero to prevent issues when no TV has been assigned.

Files:

/31DEC14/RUN/VLBARUN.001

/31DEC14/HELP/VLBARUN.HLP

Fix:

1. Fetch the files listed above and place them in the corresponding areas ($RUNSYS and $HLPFIL) on your system.

Documentor:

Eric W Greisen

Date:

2015-01-19

Task:

BPASS

Summary: had an array dimensioned 500 instead of MXBASE. This caused bad things to happen with more than 32 antennas. Non-general code in the history writing of antenna numbers caused an abort as well when there were more than 34 antennas.

Files:

/31DEC14/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:

2015-01-20

Task:

MORIF

Summary: an addressing bug made output spectral tables (bandpass, polarization) incorrect.

Files:

/31DEC14/ORIF.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2015-01-29

Task:

TYSMO

Summary: did not apply data max/min clipping (APARM) unless median-window filtering (CPARM) was also requested.

Files:

/31DEC14/APL/PGM/NOTST/TYSMO.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2015-02-11

Task:

BPASS

Summary: did not understand that the low-level routine used to find the frequency shifts for VLB bandpasses expected antenna coordinates in a left-handed system. Bandpass application routines howvere did know this, so there was a disconnect leading to wrong bandpass functions in VLBI experiments at high frequency with narrow spectral channels. Changed two low level routines to make everything use the now standard right-hand systems.

Files:

/31DEC14/APL/SUB/NOTST/DETRAT.FOR

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

/31DEC14/APL/SUB/NOTST/DOBAND.SRT

Fix:

1. Fetch the files listed above and place them in the corresponding areas ($APLNOT for the Fortran and your work area for the command file) on your system.
2. source DOBAND.SRT

Documentor:

Eric W Greisen

Date:

2015-02-21

Task:

UVINIT

Summary: initializes disk I/O to UV data sets and had an error that caused it to read beyond the end-of-file when all of the data fit in the first of the two buffers and the disk file was exactly the minimum size to hold the data. It is not known how the latter case could arise since all UV create, expansion, and compression routines try to make the file a bit larger than the minimum but is has arisen.

Files:

/31DEC14/APL/SUB/UVINIT.FOR

/31DEC14/APL/SUB/UVINIT.LST

Fix:

1. Fetch the files listed above and place them in the corresponding area ($APLSUB and a work area, resp.) on your system.
2. COMRPL $APLSUB/UVINIT.FOR
3. source UVINIT.LST

Documentor:

Eric W Greisen

Date:

2015-04-24

Task:

START_AIPS, START_TVSERVERS

Summary: scripts needed a change to support the new Mac yosemite OS version. In that version /tmp is now a link file rather than a real directory.

Files:

/31DEC14/SYSTEM/UNIX/START_AIPS

/31DEC14/SYSTEM/UNIX/START_TVSERVERS

Fix:

1. Fetch the files listed above and place them in the corresponding areas (both $SYSUNIX and $AIPS_ROOT for both) on your system.
2. Edit the $AIPS_ROOT copies to have the correct value assigned to $AIPS_ROOT.

Documentor:

Eric W Greisen

Date:

2015-04-24

Task:

many

Summary: Two basic calibration subroutines had errors. One computed channel wavelengths assuming that the frequency reference pixel is always 1.0. It is now usually Nchan/2 + 1, cauing errors in applying polarization and dispersion corrections.

Files:

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

/31DEC14/APL/SUB/NOTST/GAININ.FOR

/31DEC14/APL/SUB/NOTST/DOCAL.SRT

Fix:

1. Fetch the files listed above and place them in the corresponding areas ($APLNOT and a work area) on your system.
2. COMRPL $APLNOT/{DATCAL,GAININ}
3. source DOCAL.SRT

Documentor:

Eric W Greisen

Date:

2015-05-19

Task:

XAS

Summary: needed a change to support Mac yosemite (10.3.3) systems. It now needs to recognize both /tmp and /private/tmp as local to the host and thus able to use shared memory. Also changed the background for characters in gray-scale memories from 1 to zero so that the background will stay black.

Files:

/31DEC14/Y/SERVERS/XAS.SHR

Fix:

1. Fetch the file listed above and place it in the corresponding area ($YSERV) on your system.
2. cd $YSERV/XAS
3. make clean
4. mv Makefile Makefile.save
5. sh ../XAS.SHR
6. mv Makefile.save Makefile
7. make

Documentor:

Eric W Greisen

Date:

2015-05-20

Task:

KRING

Summary: help file did not contain all of the adverbs assumed by the Fortran code. This version of KRING has issues; 31DEC15 is changed substantially.

Files:

/31DEC14/HELP/KRING.HLP

Fix:

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

Documentor:

Eric W Greisen

Date:

2015-06-17

Task:

IMAGR

Summary: copied too little data to the work file for the last complete set of baselines when doing baseline-length based time averaging. The last 2-3 spectral channels were not copied and curious things could happen to their values.

Files:

/31DEC14/Q/PGM/OOP/IMAGR.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2015-06-22

Task:

PCAL

Summary: copies each spectral window to a scratch file and then reads each channel, one at a time, from that file. This read did not detect the presence of channel-dependent flagging and so could cause the task to die when a channel had no un-flagged data. The task managed despite this when fitting a source model, but not when using a model.

Files:

/31DEC14/Q/PGM/NOTST/PCAL.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2015-08-14

Task:

SETJY

Summary: had two different erroneous refences to a particular error message format. If either error occurred, the task would abort without telling the user the real issue.

Files:

/31DEC14/APL/PGM/NOTST/SETJY.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2015-08-22

Task:

SAD

Summary: caused the new model-fit (MF) table to disappear from the image header when creating a new stars table. TVSAD inherited this bug.

Files:

/31DEC14/APL/PGM/SAD.FOR

/31DEC14/Y/PGM/TVSAD.FOR

Fix:

1. Fetch the files listed above and place then in the corresponding areas ($?APLPGM and $?YPGM) on your system.
2. COMLNK $APLPGM/SAD
3. COMLNK $APLPGM/TVSAD

Documentor:

Eric W Greisen

Date:

2015-09-07

Task:

PCAL

Summary: did not handle the end-of-file condition when reading data in the SPECTRAL false mode correctly. As a consequence, it left files open and did not do solutions. The open files eventually caused the task to quit.

Files:

/31DEC14/Q/PGM/NOTST/PCAL.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2015-09-14

Task:

Summary:

Files:

/31DEC14/

Fix:

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

Documentor:

Eric W Greisen

Date:

2015-??-??