; READISK ;--------------------------------------------------------------- ;! writes images / uv data w extensions to tape in FITS format ;# PROCEDURE FITS UV IMAGE-UTIL ;----------------------------------------------------------------------- ;; Copyright (C) 2002, 2008 ;; Associated Universities, Inc. Washington DC, USA. ;; ;; This program is free software; you can redistribute it and/or ;; modify it under the terms of the GNU General Public License as ;; published by the Free Software Foundation; either version 2 of ;; the License, or (at your option) any later version. ;; ;; This program is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. ;; ;; You should have received a copy of the GNU General Public ;; License along with this program; if not, write to the Free ;; Software Foundation, Inc., 675 Massachusetts Ave, Cambridge, ;; MA 02139, USA. ;; ;; Correspondence concerning AIPS should be addressed as follows: ;; Internet email: aipsmail@nrao.edu. ;; Postal address: AIPS Project Office ;; National Radio Astronomy Observatory ;; 520 Edgemont Road ;; Charlottesville, VA 22903-2475 USA ;----------------------------------------------------------------------- READISK LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC READISK: procedure to read maps or uv data to disk type RUN WRTPROCS first! OLDVOL 0.0 35.0 Disk # input to WRITDISK DATAIN Logical directory name NFILES 0.0 9999.0 First catalog number NCOUNT 0.0 9999.0 Last catalog number OUTDISK 0.0 9.0 Output UV file disk drive # DOUVCOMP -1.0 1.0 >0 => compressed data (FITS) ---------------------------------------------------------------- READISK Type: Procedure Use: READISK reads FITS files from disk, looping through many files if instructed. The files must have a standard name (DISK##C####) which is the name produced when files are written out with WRTDISK. This procedure cannot be used unless the file(s) have names with this format. READISK uses FITLD (see HELP FITLD for details). Remember to load this procedure typing RUN WRTPROCS before trying to run it (by typing READISK). This procedure can transfer data across the Internet if needed. Warning: this procedure runs with DOWAIT FALSE. This allows it to continue even if some of the files are missing - which will occur if the WRTDISK found empty catalog slots. However, the procedure will also continue to run in the presence of a real error. Adverbs: OLDVOL.....The DISK # in the file's name, i.e. the number after "DISK" in the file name. The is the INDISK used in WRITDISK. DATAIN.....The name of a directory from which to read files. The name is limited to 48-characters and must be in the form or :: where is the remote computer name, is the environment variable (logical name) for the disk area in which the file. is usually omitted when the file is local to the current computer. TPMON1 must be running of the computer names in . NFILES.....The first number of the file to be loaded, i.e. the number after the "C" in the name of the first file to be loaded. 0 => 1 NCOUNT.....The last number of the file to be loaded, i.e. the number after the "C" in the name of the last file to be loaded. 0 => number in NFILES OUTDISK....The disk drive #. 0 => highest with space DOUVCOMP...If true (DOUVCOMP > 0) the output data is written in compressed format which can result in a substantial reduction in disk space with some loss of weighting information. Only used for FITS UV files ---------------------------------------------------------------- READISK: Procedure to run FITLD to read files from disk that have standard format names. These file names are the format WRTDISK uses to write out files. Documenter: Amy Mioduszewski Related Programs: FITLD, WRTDISK, WRTPROCS To load the procedure type RUN WRTPROCS. This must be done before running the procedure (by typing READISK). READISK will read a file from disk (with FITLD) that has a standard format file name. This standard format is DISKddCcccc, where the dd and the cccc are numbers. The dd is specified in the OLDVOL input and the cccc is specified by NFILES and NCOUNT. If NFILES and NCOUNT are different then the numbers NFILES through NCOUNT are read. Example: If you want to read in files: DISK01C0098 DISK01C0090 DISK01C0100 DISK01C0101 which are on disk $FITS Set: OLDVOL 1 DATAIN 'FITS' NFILES 98 NCOUNT 101 Note that the OLDVOL adverb will not be knowen until you have RUN WRTPROCS