% README File FOR AIPS Release 15JAN95 % This File describes the patches to known bugs in 15JAN95 % Last modified Mon Jun 5 10:41am US/EDT % IMPORTANT: If you performed a binary "load-and-go" installation, and you % do *not* have any Fortran compiler (or your revision of the % compiler predates ours, you will most likely not be able to % apply most of these patches. In particular, under SunOS or % Solaris, Sun Fortran SC2.0.1 or later is required. % Unfortunately, the NRAO AIPS group is unable at this time to provide % binary replacements for the affected tasks. Tasks and other things for which patches have been made: =============================================================================== Task: UV disk I/O Summary: The low-level basic routine UVINIT had an error allowing it to wrongly conclude that it could do fast I/O. It then set its safety margin to 0, checked the buffer size, changed the I/O method, and left the safety margin WRONGLY at 0. This was triggered by a combination of circumstances starting with NVIS = integer multiple of 256. Files: /15JAN95/APL/SUB/UVINIT.FOR Fix: (1) Get the file and place it in $APLSUB (2) Compile it to the libraries with COMRPL $APLSUB/UVINIT (3) Rebuild programs that need it - or perhaps jsut do everything: COMLNK $APLPGM/*.FOR $APGNOT/*.FOR COMLNK $YPGM/*.FOR $YPGNOT/*.FOR COMLNK $QPGNOT/*.FOR $QYPGNOT/*.FOR COMLNK $APGOOP/*.FOR $QPGOOP/*.FOR Documentor: Eric W. Greisen Date: 1995.01.31 ------------------------------------------------------------------------ Task: SETPAR Summary: SETPAR messed up the setting of assigned users. The SP file only supports 15 disks for this and applies to disk 1 now. Changed it to limit the disk numbers to 1 through MIN (NVOL, 15). Files: /15JAN95/AIPS/PGM/NOTST/SETPAR.FOR Fix: (1) Fetch the file and put it in $AIPNOT (2) Compile and link it with COMLNK $AIPNOT/SETPAR Documentor: Eric W. Greisen Date: 1995.01.31 ------------------------------------------------------------------------ Utility: SYSETUP Summary: SYSETUP did not handle the symbolic linking of the gripes (GR) and password (PW) files due to a couple of missing quote marks. It now does. Files: /15JAN95/SYSTEM/UNIX/SYSETUP Fix: (1) Fetch the file and put it in $SYSUNIX (2) Check each host-specific area under $AIPS_ROOT/DA00/ to see if there are any spurious GRD000000; or PWD000000; symbolic links; if there are any, remove them. DO NOT REMOVE THE MASTER GR AND PW FILES, ONLY REMOVE THE SYMLINKS! (3) Type SYSETUP and let it make the links. Documentor: Patrick P. Murphy (thanks to Martin Shepherd) Date: 1995.02.06 ------------------------------------------------------------------------ Task: AIPS Summary: PSEUDO made errors when handling the pseudoverbs VERB and PSEUDOVB for previously defined symbols. The errors would cause the procedureto containing the pseudoverb to be declared a verb or pseudoverb with some verb number such as 4 (=) or the one trying to be declared. Files: /15JAN95/AIPS/SUB/PSEUDO.FOR Fix: (1) Fetch the file, placing it in $AIPSUB (2) Compile it with COMRPL $AIPSUB/PSEUDO (3) Install it with COMLNK $AIPPGM/AIPS*.FOR $AIPPGM/POPSGN Documentor: Eric W. Greisen Date: 1995.02.08 ------------------------------------------------------------------------ Task: CVEL Summary: An error in the use of the same array in two parts of the task caused CVEL to progressively flag more and more channels as it ran through the data. This would only occur for data from the VLBA correlator when bandpass calibration was requested. Files: /15JAN95/Q/PGM/NOTST/CVEL.FOR Fix: (1) Fetch the file, placing it in $QPGNOT (2) Compile and link it with COMLNK $QPGNOT/CVEL Documentor: Phil Diamond Date: 1995.02.08 ------------------------------------------------------------------------ Task: SDGRD Summary: SDGRD failed to place the STOKES adverb into the common used by the data reading routines. Therefore, it always did Stokes 'I'. Files: /15JAN95/Q/PGM/NOTST/SDGRD.FOR /15JAN95/HELP/SDGRD.HLP Fix: (1) Fetch the two files, placing the first in $QPGNOT and the second in $HLPFIL. (2) Compile and link it with COMLNK $QPGNOT/SDGRD Documentor: Eric W. Greisen Date: 1995.02.14 ------------------------------------------------------------------------ Task: Patches only (Solaris and SunOS Binary distributions) Summary: The file $SYSLOCAL/USESHARED was inadvertently included in the binary distribution for SunOS and Solaris systems. This causes the COMLNKs to fail when any patches or rebuilding is attempted as LINK attempts to use shared libraries which are not included in the distribution. Files: 15JAN95/SUN4/SYSTEM/USESHARED 15JAN95/SOL/SYSTEM/USESHARED 15JAN95/$ARCH/SYSTEM/$SITE/USESHARED Fix: Delete all the above! Documentor: Patrick P. Murphy Date: 1995.03.08 ------------------------------------------------------------------------ Task: AIPS REMOTE (no TV, just a tek or compatible terminal) Summary: The functionality of being able to display graphics on one's Tektronix or compatible terminal was broken. In previous releases since 15APR92, devices 241-255 were reserved for possible "REMOTE" tek devices for AIPS (POPS) numbers 1 through 15. Now, it is assumed that the first 35 devices BEYOND the last configured TV device (as set in the SP file via SETPAR or SETSP) are reserved for these devices. Files: 15JAN95/SYSTEM/UNIX/AIPSEXEC 15JAN95/SYSTEM/UNIX/TVDEVS.SH 15JAN95/SYSTEM/UNIX/START_AIPS 15JAN95/SYSTEM/UNIX/AIPS.L 15JAN95/HELP/AIPS.HLP 15JAN95/APL/DEV/ZWHOMI.FOR Fix: (1) Fetch the first four files and place them in $SYSUNIX/. Copy the fourth to /usr/local/man/manl/aips.l (and AIPS.l if desired) if you want the unix command "man aips" to work. (2) Fetch the fifth file and place it in $HLPFIL/ (3) Fetch the last file and place it in $APLGEN (4) Compile the last file with COMRPL $APLGEN/ZWHOMI (5) Link the main AIPS program with COMLNK $AIPPGM/AIPS NOTE: this may cause running AIPS sessions to crash; warn your users ahead of time! (6) Remove the old version of $AIPS_ROOT/START_AIPS and replace it with the newer one: cd $AIPS_ROOT mv START_AIPS START_AIPS.OLD cat 15JAN95/SYSTEM/UNIX/START_AIPS | sed -e \ "s,DEFINE_ME,$AIPS_ROOT," > START_AIPS (7) Check that you have at least 35 more tek devices than tv devices: RUN SETPAR or RUN SETSP and check items 12 and 13. Documentor: Patrick P. Murphy Date: 1995.03.10 (updated same date with AIPS.L, AIPS.HLP) ------------------------------------------------------------------------ Task: SWPOL Summary: The GEODLY array in SWPCAL is not dimensioned to cope with the 6-term polynomials used for VLBA data. SWPOL is therefore likely to crash when working with VLBA polarization data. Files: 15JAN95/APL/PGM/NOTST/SWPOL.FOR Fix: 1) Obtain the corrected source file. 2) Recompile using COMLNK $APGNOT/SWPOL Documentor: Chris Flatters Date: 1995.04.26 -------------------------------------------------------------------------- Task: SDGRD Summary: SDGRD had three addressing bugs in the in-core gridding. One could have caused data to overwrite the gridding function in the "AP" memory. This should have produced obvious problems. Perhaps various round-downs kept the gridding routine from actually doing this. The second left very little room in the "AP" for data and could have hit limits where it tried to do many channels and then said there was no room for the data. The third was the most serious: an extra "data sample" was gridded for each channel in the group using whatever was in the AP in that range of addresses. In the case in which this was found, values of 2, 4, 6, and 8 were gridded in some of the channels and appeared as 5x5 blocks of cells. The AP memory being used was probably correctly used in doing uniform weighting, so these values are likely to be counts of samples. Thus other integer-like values can occur. The weight image showed vary large values at the affect pixels since the gridding routine was called numerous times (every 63 samples in my case). A minor change was made in the test to decide whether to do a weight map (> 2 was changed to >= 2 in the code and inputs to match the help). Files: /15JAN95/Q/PGM/NOTST/SDGRD.FOR /15JAN95/HELP/SDGRD.HLP Fix: (1) Fetch the two files, placing the first in $QPGNOT and the second in $HLPFIL. (2) Compile and link it with COMLNK $QPGNOT/SDGRD Documentor: Eric W. Greisen Date: 1995.05.26 -------------------------------------------------------------------------- Task: SDGRD Summary: Improved the task to offer the option of computing an image of 1/sigma**2 where sigma is the correctly computed expected rms in the gridded image (given that the data weights are all the same constant / rms**2 where rms is the data sample's expected rms). Files: /15JAN95/Q/PGM/NOTST/SDGRD.FOR /15JAN95/HELP/SDGRD.HLP /15JAN95/Q/DEV/PSAP/QGRIDA.FOR /15JAN95/Q/DEV/PSAP/QGRD5.FOR /15JAN95/Q/DEV/PSAP/QGRD6.FOR /15JAN95/Q/DEV/PSAP/QGRD7.FOR /15JAN95/Q/DEV/PSAP/QGRD8.FOR Fix: (1) Fetch the first file, placing it in $QPGNOT (2) Fetch the second file, placing it in $HLPFIL. (3) Fetch the other 5 files, placing them in $QPSAP (4) Compile the subroutines with COMRPL $QPSAP/QGRIDA $QPSAP/QGRD5 $QPSAP/QGRD6 COMRPL $QPSAP/QGRD7 $QPSAP/QGRD8 (2) Compile and link the task with COMLNK $QPGNOT/SDGRD Documentor: Eric W. Greisen Date: 1995.05.31 ------------------------------------------------------------------------ Task: WTSUM Summary: New task of interest to single-dish users (and perhaps others) particularly in conjunction with the SDGRD change above. It does a weighted sum of two images using two images of weights or of rms's. Files: /15JAN95/APL/PGM/WTSUM.FOR /15JAN95/HELP/WTSUM.HLP /15JAN95/APL/SUB/HENCO4.FOR Fix: (1) Fetch the files, placing the first in $APLPGM, the second in $HLPFIL, and the third in $APLSUB (2) Compile the subroutine with COMRPL $APLSUB/HENCO4 (2) Compile and link the task with COMLNK $APLPGM/WTSUM Documentor: Eric W. Greisen Date: 1995.05.31 ------------------------------------------------------------------------ Task: OTFUV Summary: Added the capability to specify an averaging interval and an output interval. The main benefit is a reduction in disk needs. Files: /15JAN95/APL/PGM/OTFUV.FOR /15JAN95/HELP/OTFUV.HLP Fix: (1) Fetch the files, placing the first in $APLPGM and the second in $HLPFIL. (2) Compile and link the task with COMLNK $APLPGM/OTFUV Documentor: Eric W. Greisen Date: 1995.07.14 -------------------------------------------------------------------------- Task: SDGRD Summary: Improved the task to offer the option of computing with a circular convolving function including a new BESSJ1(x) / X * Gaussian All subroutines concatenated to avoid repercussions on MX and friends. Files: /15JAN95/Q/PGM/NOTST/SDGRD.FOR /15JAN95/HELP/SDGRD.HLP Fix: (1) Fetch the first file, placing it in $QPGNOT (2) Fetch the second file, placing it in $HLPFIL. (3) Compile and link the task with COMLNK $QPGNOT/SDGRD Documentor: Eric W. Greisen Date: 1995.08.02 ------------------------------------------------------------------------