LIST Program LIST generates a formatted, printable listing from a MERGE-format file. The listing can include any or all of: the header records, the amplitudes, the visibility phases, the closure phases, the (u,v,w) coordinates, and the errors on these quantities. Both MERGE-formats 1 and 2 are accepted. To run the program use the command `list'. The program is available on both VAX/VMS and Convex-UNIX. Examples $! VMS # UNIX $ LIST list input = T1.MRG input = t1.mrg listfile = T1.LIS listfile = t1.lis amp err amp err / / $ PRINT T1.LIS lpr t1.lis Parameters Parameter INPUT must be specified; the others are optional. The parameters names can be abbreviated to uniqueness (minimum match). End the list of parameters with a slash (/). The data selection parameters are AMP, PHASE, CLOSE, U, V, W, ERR, ALL. If none of these parameters is specified, only the file header and counts of records and visibility samples are printed. The parameters BASELINES and TRIANGLES can be used to select a subset of the available baselines and closure triangles. If neither BAS nor TRIA is specified, all the data of the selected types will be printed. Baseline and triangle identification numbers are formed by stringing together 2 or 3 station numbers in ascending order. (e.g., 12, 23, 910; 123, 234, 91011). Up to 20 baselines and/or 20 triangles may be specified. INPUT = "filename" : the name of the input merge-format file (eg 3C84.VLB); wild card constructions are allowed (eg *.MRG or [TJP...]*.M%%). LISTFILE = "filename" : file name for the output printable file (eg OUTPUT.LIS). The default is SYS$OUTPUT (usually the terminal). If output is to a file, it can be printed with the PRINT or lpr command: eg $ PRINT OUTPUT.LIS. AMP, PHASE, CLOSE (no value) : to print data of the corresponding type (amplitude or correlation coefficient, visibility phase, closure phase, respectively). U, V, W (no value) : to print the U, V, and/or W baseline components. ERR (no value) : in addition to the selected data-types, display the corresponding errors (it is not possible to display the errors only); this does not affect U, V, and W, which have no errors. LIST Page 2 ALL (no value) : equivalent to AMP PHASE CLOSE ERR (it does not include U, V, W). BAS[elines] eg BAS=12,13,56 : print AMP or PHASE data for the specified baselines only. TRIA[ngles] eg TRIA=123,8910 : print CLOSE data for the specified triangles only. INT eg INT=100,119 : print data for records 100 to 119 inclusive; the default is the entire dataset (INT=1,100000). Note that the INT parameter can only select one record number range, unlike the INT parameter in VLBEDIT. GST (no value) : display the GST for each data record instead of UT. The default is to display UT. BASE (no value) : in addition to the standard header, print a list of the baselines and their lengths in wavelengths. COLS eg, COLS=8 : to specify the number of columns to print on each page, in the range 1 to 14; COLS=6 is suitable for terminal output. The default is 12 (this gives a listing suitable for a 132-character printer or terminal). NOFEED (no value) : compresses the output slightly by omitting page headers. Limitations: 1. The program accepts MERGE-format files containing 40 or fewer stations. 2. To list closure amplitudes, use program CLAMP. History: Version 1.0: 1979 May 1 - T.J. Pearson. Version 1.1: 1979 Oct 16 - Extended to 10 stations (TJP). Version 1.2: 1980 Jan 11 - Supplementary printout (TJP). Version 2.0: 1981 May 4 - Suppress error message on format overflow, adopt Fortran-77 standards (TJP). Version 2.1: 1981 Nov 24 - Add source name to page header (TJP). Version 2.2: 1982 May 13 - More decimal places for calibrated amplitudes, add help routine (TJP). Version 2.3: 1982 Sep 17 - Extended to 15 stations (TJP). Version 2.4: 1982 Oct 12 - Add record count to listing, wild cards (TJP). Version 2.5: 1982 Dec 15 - Add parameters GST, INT, BAS, TRIA (TJP). Version 3.0: 1983 Jul 5 - Extend to include MERGE-format 2 and orbiting stations (D.L. Meier). Version 3.1: 1983 Aug 3 - Added W to version 2 files; change so only visibility data and errors are loaded into LIST Page 3 array DATA (DLM). Version 3.2: 1984 Jul 10 - Fix "output overflow" bug, and improve behavior if asked to read a non-MERGE-format file (TJP). Version 3.3: 1984 Dec 15 - Add display of Julian Date and Epoch to header (TJP). Version 3.4: 1986 Jan 29 - Correct pagination and add LPP parameter (TJP). Version 3.5: 1986 Feb 3 - Display polarization code (TJP). Version 3.6: 1986 Feb 13 - Display date last modified instead of today's date; further correction to pagination; display LIST version in listing; give warning instead of dying if input file is not Merge format; display corr-coeff with 1 decimal place only, and phases with 2 (TJP). Version 3.7: 1986 Mar 18 - Filter unprintable characters out of history records (yes, I known there shouldn't be any, but...) (TJP). Version 3.8: 1986 Aug 28 - Increase from 15 to 20 stations (TJP). Version 4.0: 1986 Nov 15 - Add parameters INPUT and LISTFILE and remove questions (TJP). Version 4.1: 1987 Nov 7 - Changes for Convex compatibility (TJP). Version 4.2: 1988 Apr 14 - Change listing file format for Unix compatibility (TJP). Version 4.3: 1989 Jan 10 - Make no data the default (instead of AMP CLOSE); add count of data points; add u, v, w; parameters HEADER and NONE now ignored (TJP). Version 4.4: 1990 Jan 31 - If frequency in header is 0, try not to divide by 0. Version 4.5: 1991 Mar 22 - Allow up to 40 stations.