Patches to 31DEC12

You will find patches to known bugs in 31DEC12 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 31DEC12 "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. Bandpass calibration was not applied to enough channels to support frequency smoothing afterwards. 2013-01-16
2. Tick increments were computed with an erroneous round-off parameter leading some tick marks to be plotted at offset values. 2013-01-29
3. POSSM had a variety of irritating bugs. 2013-02-05
4. FITLD turned off DIGICOR corrections when the array name was not VLBA. 2013-02-05
5. FITLD, after correction 4, failed if it could not make a CQ table. 2013-02-18
6. CL2HF aborted because of an internal name conflict 2013-02-19
7. PRTAB had a format issue with large F formats (NDIG <= 0).2013-03-01
8. COMB did not do POLC correctly when using constant noise values 2013-04-04
9. AFARS had a header bug causing it to try to write too much 2013-04-05
10. FITLD could get the EQUINOX wrong in the SU table with FITS-IDI input 2013-04-11
11. COMB messed up scaling when combining two images with one of them not JY/BEAM 2013-05-03
12. FITLD had a bad warning message, causing aborts on some machines. 2013-05-21
13. 2013-??-??

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

Task:

Summary: The subroutine that applies the bandpass correction to the data can be called either after or before the frequency smoothing (depending on what smoothing was done to prepare the bandpass correction). It limited the correction to BCHAN to ECHAN without correcting the needed channels less than BCHAN and greater than ECHAN which will be used in the smoothing. Corrected the loop limits.

Files:

/31DEC12/APL/SUB/NOTST/DATBND.FOR

/31DEC12/APL/SUB/NOTST/DOBAND.LST

Fix:

1. Fetch the files listed above and place the first in the corresponding area ($APLNOT) on your system. Place the second in the disk directory in which you are working.
2. COMRPL $APLNOT/DATBND
3. source DOBAND.LST

Documentor:

Eric W Greisen

Date:

2013-01-16

Task:

Summary: The subroutine that computes tick increments also supplies a "round-off" value. When it was revised in November 2012 to allow finer tick intervals, certain subscript references were not updated leading to bad round off values. This could lead the tick labels to be offset from their correct values. For example, 2 minutes of time was often added to times.

Files:

/31DEC12/APL/SUB/ticinc.FOR

/31DEC12/APL/SUB/TICINC.LST

Fix:

1. Fetch the files listed above and place the first in the corresponding area ($APLSUB) on your system. Place the second in the disk directory in which you are working.
2. COMRPL $APLSUB/TICINC
3. source TICINC.LST

Documentor:

Eric W Greisen

Date:

2013-01-29

Task:

POSSM

Summary: Corrected a number of irritating bugs. When plotting BD tables it would sometimes abort since the wrong close subroutine was called. The task did not understand "formal i" Stokes and so looped badly. It did not initialize values correctly for the upper plot, causing the labeling/scaling not to appear properly. Finally, when plotting a single baseline it would still read and calibrate all data before discarding the unwanted samples. Changed it to ask the low level routines only for the desired baseline.

Files:

/31DEC12/Y/PGM/NOTST/POSSM.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2013-02-05

Task:

FITLD

Summary: tested the array name from the antenna file and, if it was not VLBA turned off the creation of a CQ table and the application of digital corrections. Changed it to use the user's value of DIGICOR for better or for worse and changed the help file to say so. Note that DiFX IDI files probably assert array name VLBA even when it is not.

Files:

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

/31DEC12/HELP/FITLD.HLP

Fix:

1. Fetch the files listed above and place them in the corresponding areas ($APGNOT and $HLPFIL) on your system.
2. COMLNK $APGNOT/FITLD

Documentor:

Eric W Greisen

Date:

2013-02-05

Task:

FITLD

Summary: was changed in correction 4 above to attempt to make and fill a CQ table as well as doing the digital corrections. Some IDI data lack the information needed to do this, so the task was changed to report this failure while not regarding it as fatal.

Files:

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

/31DEC12/HELP/FITLD.HLP

Fix:

1. Fetch the files listed above and place them in the corresponding areas ($APGNOT and $HLPFIL) on your system.
2. COMLNK $APGNOT/FITLD

Documentor:

Eric W Greisen

Date:

2013-02-18

Task:

CL2HF

Summary: had a common named ANINI which conflicted with a subroutine created September 20, 2009 which the task has to call. Changed the name of the COMMON.

Files:

/31DEC12/APL/PGM/OOP/CL2HF.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2013-02-19

Task:

PRTAB

Summary: had an error in which it could compute an illegal format to use on very large floating numbers in the F format (NDIG <= 0) option.

Files:

/31DEC12/APL/PGM/PRTAB.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2013-03-01

Task:

COMB

Summary: did not do OPCODE = 'POLC' correctly with constant noise values (rather than noise images). It applied a beam area correction to the constant values making them nearly zero and hence making the polarization bias correction negligible.

Files:

/31DEC12/APL/PGM/COMB.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2013-04-04

Task:

AFARS

Summary: had a bug in setting up the output header which caused it to try to write multiple planes when in fact it should write only one. The task then died and deleted the output files.

Files:

/31DEC12/APL/PGM/NOTST/AFARS.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2013-04-05

Task:

FITLD

Summary: was affected by a buffer declaration that was too small. On some compilers, the overflow affected parameters that sometimes mattered (and sometime did not). The EQUINOX in the SU table would end up set to -1 when this occurred. A truncated error message from SOTAB would also appear. This only happened with FITS-IDI format VLB data.

Files:

/31DEC12/INC/DSOV.INC

Fix:

1. Fetch the file listed above and place it in the corresponding area ($INC) on your system.
2. COMRPL $APLNOT/SO{IO,INI,TAB}.FOR
3. COMLNK $APGNOT/FITLD.FOR

Documentor:

Eric W Greisen

Date:

2013-04-11

Task:

COMB

Summary: messed up the scaling when one of the images was not in units of JY/BEAM and the other was.

Files:

/31DEC12/APL/PGM/COMB.FOR

Fix:

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

Documentor:

Eric W Greisen

Date:

2013-05-03

Task:

FITLD

Summary: had a warning message in the IDI section that had more arguments than format items. It caused aborts on some machines.

Files:

/31DEC12/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.FOR

Documentor:

Eric W Greisen

Date:

2013-05-21

Task:

Summary:

Files:

/31DEC12/

Fix:

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

Documentor:

Eric W Greisen

Date:

2013-??-??