[AIPS]

Going AIPS

[NRAO]

VERSION FOR 1990 (!) AIPS

Most recently changed on 2000/02/17

Going AIPS, the programmers guide to the AIPS system, was rewritten in 1990.It has not been revised since that time.

Nonetheless, it remains an interesting and useful document to many of the basic concepts and data structures of the AIPS package. Like the CookBook, it is being made available via PostScript files for each chapter with this html version of the Table of Contents as a guide. If you are writing code in AIPS that depends on the details of call sequences or data structures, you should use Going AIPS as guide, but refer to the current (31DEC00 release) version of the code for the actual definitions.

If you wish to get these files via anonymous ftp (in one go with an mget command), then you should connect to ftp.aoc.nrao.edu, username anonymous, use your email address as password, and cd to /pub/software/aips/ftp://ftp.aoc.nrao.edu/pub/software/aips/TEXT/PUBL/ where you will find all the COOK*.PS files. If you just want some chapters, it may be simpler to just click on the links to the PostScript files below.

The following is a list of pointers to the different chapters in this Table of Contents.

To find out whether the most recent revisions of each chapter were minor or of interest, consult the revision history appended to the end of this version of the table of contents.

TABLE OF CONTENTS: Volume 1

Each link here gets you a PostScript file for the section.

0. Table of Contents: Volume 1 (141201 bytes)

          Title page                                          
          Table of contents                                       i

Back to top of table of contents.

1. Introduction (141579 bytes)

1.1       The NRAO AIPS Project - A Summary                     1 - 1
1.1       Scope                                                 1 - 1
1.2       Hey You, Read This                                    1 - 1
1.3       Philosophy                                            1 - 2
1.4       An Overview of the AIPS System                        1 - 2
1.4.1        Tasks                                              1 - 3
1.4.2        Verbs                                              1 - 3
1.4.3        Data Files                                         1 - 3
1.4.4        I/O                                                1 - 3
1.5       Style                                                 1 - 4
1.5.1        Precursor Comments                                 1 - 4
1.5.2        Body Comments                                      1 - 5
1.5.3        Indentation                                        1 - 5
1.5.4        CONTINUE Statements                                1 - 6
1.5.5        Statement Numbers                                  1 - 6
1.5.6        Blanks                                             1 - 6
1.5.7        Modular Code                                       1 - 6
1.5.8        Portability                                        1 - 6
1.6       Language                                              1 - 7
1.6.1        FORTRAN                                            1 - 7
1.6.2        Statement Order                                    1 - 8
1.6.3        INCLUDEs                                           1 - 8
1.6.4        Dimension Declaration                              1 - 9
1.6.5        SAVE Statements                                    1 - 9
1.7       Documentation                                         1 - 9
1.7.1        User Documentation                                 1 - 9
1.7.1.1         HELP files                                      1 - 9
1.7.1.2         AIPS Cookbook                                   1 - 10
1.7.2           Programmer Documentation                        1 - 10
1.7.2.1            Precursor Comments                           1 - 10
1.7.2.2            Shopping Lists                               1 - 10
1.7.2.3            CHANGE.DOC                                   1 - 10
1.7.2.3            The Checkout System                          1 - 10

Back to top of table of contents.

2. Skeleton Tasks (119787 bytes)

2.1       Data Modification Tasks  - - FUDGE and TAFFY          2 - 1
2.1.1        FUDGE                                              2 - 2
2.1.2        TAFFY                                              2 - 4
2.2       Data Entry Tasks (UVFIL and CANDY)                    2 - 7
2.2.1        UVFIL                                              2 - 8
2.2.2        CANDY                                              2 - 11
2.3       Modifying a Skeleton Task                             2 - 13

Back to top of table of contents.

3. Getting Started - Tasks (223928 bytes)

3.1       Overview                                              3 - 1
3.2       The Cost of Machine Independence                      3 - 2
3.2.1        Character Strings                                  3 - 2
3.3       Task Name Conventions                                 3 - 3
3.4       Getting the Parameters                                3 - 3
3.4.1        In AIPS (Help file)                                3 - 3
3.4.2        At Task Startup (GTPARM)                           3 - 6
3.4.3        While a Task is Running (GTTELL)                   3 - 6
3.5       Restarting AIPS                                       3 - 6
3.6       INCLUDE files                                         3 - 6
3.7       Initializing Commons                                  3 - 7
3.7.1        Device Characteristics Common                      3 - 7
3.7.2        Catalog Pointer Common                             3 - 9
3.7.3        History Common                                     3 - 9
3.7.4        TV Common                                          3 - 9
3.7.5        UV data pointer common                             3 - 9
3.7.6        Files common, DFIL.INC                             3 - 9
3.8       Input and Output File Names                           3 - 10
3.9       Copying Extension Files                               3 - 10
3.9.1        History                                            3 - 11
3.9.2        Extension tables (ALLTAB, TABCOP)                  3 - 12
3.10      Communication with the user                           3 - 12
3.10.1       Writing messages                                   3 - 12
3.10.2       Turning off system messages                        3 - 12
3.10.3       Writing to the line printer                        3 - 13
3.10.4       Writing to the Terminal (ZTTYIO)                   3 - 14
3.11      Scratch Files                                         3 - 15
3.12      Terminating the Program                               3 - 16
3.13      Batch Jobs                                            3 - 16
3.14      Installing a New Task                                 3 - 16
3.15      INCLUDEs                                              3 - 17
3.15.1       DDCH.INC                                           3 - 17
3.15.2       DFIL.INC                                           3 - 17
3.15.3       DMSG.INC                                           3 - 18
3.15.4       DUVH.INC                                           3 - 18
3.15.5       PUVD.INC                                           3 - 18
3.16      Routines                                              3 - 19
3.16.1       ALLTAB                                             3 - 19
3.16.2       CHCOPY                                             3 - 19
3.16.3       CHCOMP                                             3 - 20
3.16.4       CHFILL                                             3 - 20
3.16.5       CHLTOU                                             3 - 20
3.16.6       CHMATC                                             3 - 20
3.16.7       CHR2H                                              3 - 21
3.16.8       CHWMAT                                             3 - 21
3.16.9       DIE                                                3 - 21
3.16.10      DIETSK                                             3 - 22
3.16.11      EXTCOP                                             3 - 22
3.16.12      GTPARM                                             3 - 22
3.16.13      GTTELL                                             3 - 23
3.16.14      HIADD                                              3 - 23
3.16.15      HIADDN                                             3 - 23
3.16.16      HIAD80                                             3 - 24
3.16.17      HICLOS                                             3 - 24
3.16.18      HIINIT                                             3 - 24
3.16.19      HIMERG                                             3 - 24
3.16.20      HIREAD                                             3 - 25
3.16.21      HISCOP                                             3 - 25
3.16.22      H2CHR                                              3 - 26
3.16.23      MAKOUT                                             3 - 26
3.16.24      PRTLIN                                             3 - 27
3.16.25      PSFORM                                             3 - 27
3.16.26      RELPOP                                             3 - 27
3.16.27      SCREAT                                             3 - 28
3.16.28      TABCOP                                             3 - 28
3.16.29      UVPGET                                             3 - 29
3.16.30      ZDCHIN                                             3 - 30
3.16.31      ZTTYIO                                             3 - 30

Back to top of table of contents.

4. The AIPS Program (208631 bytes)

4.1       Overview                                              4 - 1
4.2       Structure of the AIPS Program                         4 - 1
4.2.1        The POPS processor                                 4 - 2
4.2.2        POPS commons                                       4 - 4
4.2.2.1         DCON.INC                                        4 - 4
4.2.2.2         DPOP.INC                                        4 - 6
4.2.2.3         DSMS.INC                                        4 - 7
4.2.2.4         DIO.INC                                         4 - 7
4.2.3        TAG and TYPE                                       4 - 7
4.2.4        Error Handling                                     4 - 8
4.2.5        Memory Files                                       4 - 9
4.2.6        Special modes                                      4 - 9
4.2.6.3         RUN files                                       4 - 9
4.2.6.3         Batch                                           4 - 9
4.2.6.3         Procedures                                      4 - 10
4.3       Example of the POPS processor                         4 - 10
4.3.1        The Compiler                                       4 - 10
4.3.2        The Interpreter                                    4 - 13
4.4       Installing new VERBS                                  4 - 14
4.5       Installing new ADVERBS                                4 - 16
4.6       POPSGN                                                4 - 16
4.6.1        Function                                           4 - 16
4.6.2        POPSDAT.HLP                                        4 - 17
4.7       INCLUDEs                                              4 - 29
4.7.1        DAPL.INC                                           4 - 29
4.7.2        DBAT.INC                                           4 - 31
4.7.3        DBWT.INC                                           4 - 31
4.7.4        DCON.INC                                           4 - 31
4.7.5        DERR.INC                                           4 - 31
4.7.6        DIO.INC                                            4 - 31
4.7.7        DPOP.INC                                           4 - 32
4.7.8        DSMS.INC                                           4 - 32

Back to top of table of contents.

5. Catalogs (180469 bytes)

5.1       Overview                                              5 - 1
5.2       Public and Private catalogs                           5 - 1
5.3       File Names                                            5 - 1
5.4       Data Catalog                                          5 - 2
5.4.1        Catalog Directory                                  5 - 2
5.4.2        Header block                                       5 - 2
5.4.3        Directory Section                                  5 - 2
5.4.4        Directory Usage                                    5 - 3
5.4.5        Structure of The Catalog Header Record             5 - 3
5.4.5.1         Keyword-Value Pairs                             5 - 6
5.4.5.2         Image Files                                     5 - 6
5.4.5.3         Uv Data Files                                   5 - 6
5.4.5.4         Single Dish Data Files                          5 - 7
5.4.6        Routines to Access the Data Catalog                5 - 7
5.4.6.1         MAPOPN and MAPCLS                               5 - 7
5.4.6.2         CATDIR and CATIO                                5 - 7
5.4.7        Routines to Interpret the Catalog Header           5 - 7
5.4.8        Catalog Status                                     5 - 8
5.5       Image Catalog                                         5 - 8
5.5.1        Overview                                           5 - 8
5.5.2        Data Structures                                    5 - 8
5.5.3        Usage notes                                        5 - 9
5.5.4        Subroutines                                        5 - 9
5.5.5        Image Catalog Commons                              5 - 9
5.6       Coordinate Systems                                    5 - 10
5.6.1        Velocity and Frequency                             5 - 10
5.6.1.1         Axis Labels                                     5 - 10
5.6.1.2         Catalog Information                             5 - 10
5.6.2        Celestial Positions                                5 - 10
5.6.2.1         Axis Labels                                     5 - 11
5.6.2.2         Determining Positions                           5 - 11
5.6.2.2.1          Position Routines                            5 - 11
5.6.2.2.2          Include DLOC.INC                             5 - 12
5.6.3        Rotations                                          5 - 13
5.7       Text of INCLUDE files                                 5 - 13
5.7.1        DCAT.INC                                           5 - 13
5.7.2        DHDR.INC                                           5 - 13
5.7.3        DLOC.INC                                           5 - 14
5.7.4        DTVC.INC                                           5 - 14
5.8       Routines                                              5 - 15
5.8.1        AXEFND                                             5 - 15
5.8.2        CATDIR                                             5 - 15
5.8.3        CATKEY                                             5 - 16
5.8.4        CATIO                                              5 - 17
5.8.5        COORDT                                             5 - 17
5.8.6        FNDX                                               5 - 18
5.8.7        FNDY                                               5 - 18
5.8.8        MAPCLS                                             5 - 18
5.8.9        MAPOPN                                             5 - 19
5.8.10       ROTFND                                             5 - 19
5.8.11       SETLOC                                             5 - 20
5.8.12       TVFIND                                             5 - 20
5.8.13       UVPGET                                             5 - 20
5.8.14       XYPIX                                              5 - 21
5.8.15       XYVAL                                              5 - 21
5.8.16       YCINIT                                             5 - 22
5.8.17       YCOVER                                             5 - 22
5.8.18       YCWRIT                                             5 - 22
5.8.19       YCREAD                                             5 - 23

Back to top of table of contents.

6. Disk files (316660 bytes)

6.1       Overview                                              6 - 1
6.2       Types of Files                                        6 - 1
6.3       File Management                                       6 - 2
6.3.1        Creating Files                                     6 - 2
6.3.2        Example Using ZCREAT                               6 - 2
6.3.3        Destruction Routines                               6 - 3
6.3.4        Expansion and Contraction of Files                 6 - 3
6.4       I/O to Disk Files                                     6 - 3
6.4.1        Upper Level I/O Routines                           6 - 4
6.4.2        Logical unit numbers                               6 - 5
6.4.3        Contents of the Device Characteristics Commons     6 - 5
6.4.4        Image Files                                        6 - 6
6.4.4.1         Opening Image Files                             6 - 6
6.4.4.2         MINIT and MDISK                                 6 - 7
6.4.4.3         Multi-plane Images (COMOFF)                     6 - 7
6.4.4.4         Example of MINIT and MDISK                      6 - 8
6.4.4.5         MINSK and MSKIP                                 6 - 10
6.4.5        Image File Manipulation Routines                   6 - 10
6.4.6        UV Data Files                                      6 - 11
6.4.6.1         Single-source Files                             6 - 11
6.4.6.2         Multi-source Files                              6 - 11
6.4.6.3         Compressed Data                                 6 - 12
6.4.6.4         Subarrays                                       6 - 12
6.4.6.5         Visibility record structure                     6 - 12
6.4.6.6         Data Order, UVPGET                              6 - 14
6.4.6.7         Antenna and Subarray Numbers                    6 - 14
6.4.6.8         Data Reformatting Routines                      6 - 14
6.4.7        UV Data Access                                     6 - 15
6.4.7.1         UVGET and CALCOP                                6 - 15
6.4.7.2         UVINIT and UVDISK                               6 - 15
6.4.7.3         Example using UVINIT and UVDISK                 6 - 16
6.4.8        Single Dish Data                                   6 - 19
6.4.8.1         Single dish random parameters                   6 - 19
6.4.8.2         Single dish regular axis coordinates            6 - 20
6.4.8.3         UVPGET and Single Dish Data                     6 - 20
6.4.8.4         Access to and Calibration of Single Dish Data   6 - 21
6.4.9        Extension files                                    6 - 21
6.4.9.1         TABINI and TABIO                                6 - 21
6.4.9.2         EXTINI and EXTIO                                6 - 21
6.4.10       Text files                                         6 - 21
6.5       Bottom Level I/O Routines                             6 - 23
6.5.1        ZMIO and ZWAIT                                     6 - 23
6.5.2        ZFIO                                               6 - 24
6.6       Text of INCLUDE files                                 6 - 24
6.6.1        DDCH.INC                                           6 - 24
6.6.2        DSEL.INC                                           6 - 24
6.6.3        DUVH.INC                                           6 - 27
6.7       Routines                                              6 - 27
6.7.1        CALCOP                                             6 - 27
6.7.2        CHNDAT                                             6 - 28
6.7.3        COMOFF                                             6 - 28
6.7.4        DGGET                                              6 - 29
6.7.5        DGINIT                                             6 - 29
6.7.6        EXTINI                                             6 - 30
6.7.7        EXTIO                                              6 - 31
6.7.8        GETVIS                                             6 - 32
6.7.9        GET1VS                                             6 - 32
6.7.10       KEYIN                                              6 - 33
6.7.11       MAPSIZ                                             6 - 33
6.7.12       MAPCLS                                             6 - 33
6.7.13       MAPOPN                                             6 - 34
6.7.14       MCREAT                                             6 - 34
6.7.15       MDESTR                                             6 - 35
6.7.16       MDISK                                              6 - 35
6.7.17       MINIT                                              6 - 36
6.7.18       MINSK                                              6 - 37
6.7.19       MSKIP                                              6 - 37
6.7.20       PLNGET                                             6 - 38
6.7.21       PLNPUT                                             6 - 39
6.7.22       SCREAT                                             6 - 39
6.7.23       SDGET                                              6 - 40
6.7.24       SELINI                                             6 - 41
6.7.25       SETVIS                                             6 - 42
6.7.26       SET1VS                                             6 - 43
6.7.27       TABINI                                             6 - 43
6.7.28       TABIO                                              6 - 45
6.7.29       UVCREA                                             6 - 46
6.7.30       UVDISK                                             6 - 47
6.7.31       UVGET                                              6 - 47
6.7.32       UVINIT                                             6 - 50
6.7.33       UVPGET                                             6 - 51
6.7.34       ZCLOSE                                             6 - 52
6.7.35       ZCMPRS                                             6 - 52
6.7.36       ZCREAT                                             6 - 53
6.7.37       ZDESTR                                             6 - 53
6.7.38       ZEXPND                                             6 - 53
6.7.39       ZFIO                                               6 - 54
6.7.40       ZMIO                                               6 - 54
6.7.41       ZOPEN                                              6 - 54
6.7.42       ZPHFIL                                             6 - 55
6.7.43       ZTCLOS                                             6 - 55
6.7.44       ZTOPEN                                             6 - 56
6.7.45       ZTREAD                                             6 - 56
6.7.46       ZUVPAK                                             6 - 56
6.7.47       ZUVXPN                                             6 - 57
6.7.48       ZTXCLS                                             6 - 57
6.7.49       ZTXIO                                              6 - 57
6.7.50       ZTXOPN                                             6 - 58
6.7.51       ZUVPAK                                             6 - 58
6.7.52       ZUVXPN                                             6 - 58
6.7.53       ZWAIT                                              6 - 59

Back to top of table of contents.

7. High Level Utility Routines (146917 bytes)

7.1       Overview                                              7 - 1
7.2       File Specification                                    7 - 1
7.3       Data Calibration and Reformatting Routines            7 - 1
7.4       Operations on Images                                  7 - 1
7.5       UV Model Calculations                                 7 - 2
7.6       Image Formation                                       7 - 2
7.7       INCLUDEs                                              7 - 2
7.7.1        PUVD.INC                                           7 - 2
7.7.2        DFIL.INC                                           7 - 3
7.7.3        DGDS.INC                                           7 - 3
7.7.4        DMPR.INC                                           7 - 4
7.7.5        DSEL.INC                                           7 - 4
7.7.6        DUVH.INC                                           7 - 7
7.8       Routines                                              7 - 7
7.8.1        APCONV                                             7 - 7
7.8.2        CALCOP                                             7 - 8
7.8.3        DSKFFT                                             7 - 9
7.8.4        GRDCOR                                             7 - 9
7.8.5        MAKMAP                                             7 - 10
7.8.6        UVGET                                              7 - 15
7.8.7        UVMDIV                                             7 - 17
7.8.8        UVMSUB                                             7 - 18

Back to top of table of contents.

8. WaWa ("Easy") I/O (130910 bytes)

8.1       Overview                                              8 - 1
8.2       Salient Features of the WaWa I/O package              8 - 1
8.3       Namestrings                                           8 - 1
8.4       Subroutines                                           8 - 2
8.5       Things WaWa Can't Do Well or At All                   8 - 3
8.5.1        Non-map files                                      8 - 3
8.5.2        UV data files                                      8 - 3
8.5.3        Plotting                                           8 - 3
8.5.4        History                                            8 - 3
8.5.5        More than 5 I/O Streams at a Time                  8 - 3
8.5.6        I/O to Tapes                                       8 - 3
8.6       Additional goodies and ``helpful'' hints              8 - 4
8.6.1        Use of LUNs                                        8 - 4
8.6.2        WaWa commons                                       8 - 4
1.7.2.3         Information common                              8 - 4
1.7.2.3         Catalog and Buffer Commons                      8 - 5
1.7.2.3         Declaration of Commons                          8 - 5
8.6.3        Error return codes                                 8 - 6
8.7       INCLUDEs                                              8 - 6
8.7.1        DBUF.INC                                           8 - 6
8.7.2        DCAT.INC                                           8 - 7
8.7.3        DFIL.INC                                           8 - 7
8.7.4        DITB.INC                                           8 - 7
8.8       Detailed Descriptions of the Subroutines              8 - 7
8.8.1        A2WAWA                                             8 - 7
8.8.2        CLENUP                                             8 - 8
8.8.3        FILCLS                                             8 - 8
8.8.4        FILCR                                              8 - 8
8.8.5        FILDES                                             8 - 9
8.8.6        FILIO                                              8 - 9
8.8.7        FILNUM                                             8 - 9
8.8.8        FILOPN                                             8 - 10
8.8.9        GETHDR                                             8 - 10
8.8.10       HDRINF                                             8 - 10
8.8.11       H2WAWA                                             8 - 11
8.8.12       IOSET                                              8 - 11
8.8.13       MAPCR                                              8 - 11
8.8.14       MAPIO                                              8 - 12
8.8.15       MAPMAX                                             8 - 12
8.8.16       MAPWIN                                             8 - 12
8.8.17       MAPXY                                              8 - 13
8.8.18       OPENCF                                             8 - 13
8.8.19       SAVHDR                                             8 - 13
8.8.20       TSKBEG                                             8 - 14
8.8.21       TSKEND                                             8 - 14
8.8.22       UNSCR                                              8 - 14
8.8.23       WAWA2A                                             8 - 14

Back to top of table of contents.

A.. AIPS Directory Structure and Software Management (258941 bytes)

A.1       Introduction                                          A - 1
A.2       Directory Structure                                   A - 1
A.2.1        Design Guidelines                                  A - 1
A.2.2        Directory Structure                                A - 2
A.2.2.1         APL                                             A - 2
A.2.2.2         Q                                               A - 3
A.2.2.3         Y                                               A - 4
A.2.2.4         QY                                              A - 5
A.2.2.5         AIPS                                            A - 5
A.2.2.6         Include                                         A - 6
A.2.2.7         Help                                            A - 6
A.2.2.8         Load                                            A - 6
A.2.2.9         Library                                         A - 6
A.2.2.10        Documentation                                   A - 6
A.2.2.11        Text files                                      A - 7
A.2.2.12        System                                          A - 7
A.2.3        Mnemonics  -  AREAS.DAT                            A - 8
A.3       File Names For Data                                   A - 14
A.4       VMS Details                                           A - 15
A.4.1        Object libraries                                   A - 15
A.5       A Tutorial for Programmers Using VMS                  A - 16
A.5.1        Initialization and Startup Procedures              A - 16
A.5.1.1         LOGIN.PRG                                       A - 16
A.5.1.2         AIPS ``Version'' ``Option''                     A - 16
A.5.2        Compiling and Linking                              A - 16
A.5.2.1         COMRPL ``SubroutineSpec'' ``Option''            A - 16
A.5.2.2         COMLNK ``ProgramSpec'' ``Option''               A - 17
A.5.2.3         COMTST ``ProgramSpec'' ``Option''               A - 17
A.5.2.4         Options                                         A - 17
A.5.3        Miscellaneous routines                             A - 18
A.5.3.1         VERSION ``Version''                             A - 18
A.5.3.2         FORK ``command''                                A - 18
A.5.3.3         FLOG                                            A - 18
A.5.4        Compiling and Linking: An Example                  A - 18
A.5.5        Debugging under VMS                                A - 20
A.5.6        Check out system                                   A - 20
A.6       Unix Details                                          A - 21
A.6.1        Mnemonics                                          A - 21
A.6.2        Object Libraries                                   A - 21
A.7       A Tutorial for Programmers Using Unix                 A - 27
A.7.1        Initialization And Startup Procedures              A - 27
A.7.1.1         LOGIN.CSH or LOGIN.SH                           A - 27
A.7.1.2         AIPS ``Version'' ``Option''                     A - 28
A.7.1.3         BATER ``Version'' ``Option''                    A - 29
A.7.1.4         RUN ``Program''                                 A - 29
A.7.1.5         COMRPL                                          A - 29
A.7.1.6         COMLNK ``ProgramSpec'' ``Option''               A - 32
A.7.1.7         COMTST                                          A - 34
A.7.1.8         Options                                         A - 34
A.7.2        Miscellaneous Routines                             A - 35
A.7.2.1         VERSION ``Version''                             A - 35
A.7.2.2         FORK                                            A - 35
A.7.2.3         FLOG                                            A - 35
A.7.3        Compiling and linking, an example                  A - 35
A.7.4        Non-standard INCLUDE files                         A - 39
A.7.5        Running Tasks from Private Directories             A - 39
A.7.6        Debugging under Unix                               A - 39
A.7.7        Check out system                                   A - 39

Back to top of table of contents.

B. Shopping lists (247416 bytes)

B.1       Introduction                                          B - 1
B.1.1        AP-APPL                                            B - 3
B.1.2        AP-FFT                                             B - 5
B.1.3        AP-UTIL                                            B - 5
B.1.4        BATCH                                              B - 5
B.1.5        BINARY                                             B - 6
B.1.6        CALIBRATION                                        B - 6
B.1.7        CATALOG                                            B - 8
B.1.8        CHARACTER                                          B - 8
B.1.9        COORDINATES                                        B - 9
B.1.10       EXT-APPL                                           B - 9
B.1.11       EXT-UTIL                                           B - 10
B.1.12       FITS                                               B - 11
B.1.13       GRAPHICS                                           B - 12
B.1.14       HEADER                                             B - 13
B.1.15       HISTORY                                            B - 13
B.1.16       IO-APPL                                            B - 14
B.1.17       IO-BASIC                                           B - 14
B.1.18       IO-TV                                              B - 15
B.1.19       IO-UTIL                                            B - 15
B.1.20       IO-WAWA                                            B - 16
B.1.21       MAP                                                B - 17
B.1.22       MAP-UTIL                                           B - 18
B.1.23       MATH                                               B - 18
B.1.24       MESSAGES                                           B - 20
B.1.25       MODELING                                           B - 20
B.1.26       PARSING                                            B - 20
B.1.27       PLOT-APPL                                          B - 21
B.1.28       PLOT-UTIL                                          B - 21
B.1.29       POPS-APPL                                          B - 22
B.1.30       POPS-LANG                                          B - 23
B.1.31       POPS-UTIL                                          B - 23
B.1.32       PRINTER                                            B - 23
B.1.33       SDISH                                              B - 24
B.1.34       SERVICE                                            B - 24
B.1.35       SLICE                                              B - 24
B.1.36       SORT                                               B - 25
B.1.37       SPECTRAL                                           B - 25
B.1.38       SYSTEM                                             B - 25
B.1.39       TAPE                                               B - 26
B.1.40       TERMINAL                                           B - 27
B.1.41       TEXT                                               B - 27
B.1.42       TV                                                 B - 27
B.1.43       TV-APPL                                            B - 27
B.1.44       TV-BASIC                                           B - 28
B.1.45       TV-IO                                              B - 28
B.1.46       TV-UTIL                                            B - 29
B.1.47       UTILITY                                            B - 30
B.1.48       UV                                                 B - 31
B.1.49       UV-UTIL                                            B - 33
B.1.50       VLA                                                B - 33
B.1.51       Y0                                                 B - 33
B.1.52       Y1                                                 B - 33
B.1.53       Y2                                                 B - 34
B.1.54       Y3                                                 B - 34
B.1.55       Z                                                  B - 34
B.1.56       Z2                                                 B - 36

Back to top of table of contents.

0. Table of Contents: Volume 2 (127002 bytes)

          Title page                                          
          Table of contents                                       i

Back to top of table of contents.

9. Devices (142517 bytes)

9.1       Overview                                              9 - 1
9.2       Tape Drives                                           9 - 1
9.2.1        Opening Tape Files (TAPIO)                         9 - 1
9.2.2        Positioning Tapes                                  9 - 2
9.2.3        I/O to Tape Files (TAPIO)                          9 - 2
9.2.3.1         VBOUT                                           9 - 3
9.2.3.2         Sequential External Files                       9 - 3
9.2.4        Tape Data Structure                                9 - 3
9.2.5        Tape Data Formats                                  9 - 3
9.3G       raphics Displays                                     9 - 4
9.3.1        Opening the Graphics Terminal                      9 - 4
9.3.2        Writing to the Graphics Terminal                   9 - 4
9.3.3        Activating and Reading the Cursor                  9 - 5
9.3.4        Updating the Image Catalog                         9 - 5
9.3.5        An Example                                         9 - 5
9.4       INCLUDEs                                              9 - 7
9.4.1        DTKS.INC                                           9 - 7
9.4.2        DDCH.INC                                           9 - 7
9.5       Routines                                              9 - 7
9.5.1        TAPIO                                              9 - 7
9.5.2        TEKFLS                                             9 - 9
9.5.3        TEKVEC                                             9 - 9
9.5.4        TKCATL                                             9 - 10
9.5.5        TKCHAR                                             9 - 10
9.5.6        TKCLR                                              9 - 10
9.5.7        TKCURS                                             9 - 11
9.5.8        TKDVEC                                             9 - 11
9.5.9        VBOUT                                              9 - 11
9.5.10       ZC8CL                                              9 - 11
9.5.11       ZCLC8                                              9 - 12
9.5.12       ZI8IL                                              9 - 12
9.5.13       ZI16IL                                             9 - 12
9.5.14       ZILI16                                             9 - 13
9.5.15       ZI32IL                                             9 - 13
9.5.16       ZILI32                                             9 - 13
9.5.17       ZR32RL                                             9 - 13
9.5.18       ZRLR32                                             9 - 14
9.5.19       ZR64RL                                             9 - 14
9.5.20       ZRLR64                                             9 - 15
9.5.21       ZTAPE                                              9 - 15
9.5.22       ZTKCLS                                             9 - 16
9.5.23       ZTKOPN                                             9 - 16
9.5.24       ZTPCLS                                             9 - 17
9.5.25       ZTPMIO                                             9 - 17
9.5.26       ZTPOPN                                             9 - 17
9.5.27       ZTPWAT                                             9 - 18

Back to top of table of contents.

10. Using the TV Display (272533 bytes)

10.1      Overview                                             10 - 1
10.1.1       Why Use (or not use) the TV Display               10 - 1
10.1.2       The AIPS Model of a TV Display Device             10 - 1
10.2      Fundamentals of the Coding                           10 - 3
10.2.1       The Parameter Commons and their Maintenance       10 - 3
10.2.2       The I/O Routines                                  10 - 5
10.2.3       The Y Routines                                    10 - 6
10.2.3.1        Level 0                                        10 - 9
10.2.3.1        Level 1                                        10 - 10
10.2.3.1        Level 2                                        10 - 10
10.2.3.1        Level 3                                        10 - 11
10.3      Current Applications                                 10 - 12
10.3.1       Status Setting                                    10 - 12
10.3.2       Load Images, Label                                10 - 13
10.3.3       UVMAP                                             10 - 15
10.3.4       APCLN, VTESS, MX, et al.                          10 - 15
10.3.5       Plot Files (TVPL)                                 10 - 18
10.3.6       Transfer Function Modification, Zooming           10 - 19
10.3.7       Object location, window setting                   10 - 20
10.3.8       Blotch Setting, Use                               10 - 22
10.3.9       Roam                                              10 - 23
10.3.10      Movie, Blink                                      10 - 23
10.3.11      Tasks                                             10 - 23
10.3.12      Non-Standard Tasks                                10 - 24
10.4      Includes                                             10 - 24
10.4.1       DTVC.INC                                          10 - 24
10.4.2       DTVD.INC                                          10 - 24
10.4.3       YDEA.INC                                          10 - 25
10.5      Y-Routine Precursor Remarks                          10 - 25
10.5.1       Level 0                                           10 - 25
10.5.1.1        YCHRW                                          10 - 25
10.5.1.2        YCINIT                                         10 - 26
10.5.1.3        YCNECT                                         10 - 26
10.5.1.4        YCOVER                                         10 - 26
10.5.1.5        YCREAD                                         10 - 27
10.5.1.6        YCUCOR                                         10 - 27
10.5.1.7        YCURSE                                         10 - 27
10.5.1.8        YCWRIT                                         10 - 28
10.5.1.9        YFILL                                          10 - 28
10.5.1.10       YFIND                                          10 - 28
10.5.1.11       YLOCAT                                         10 - 29
10.5.1.12       YLOWON                                         10 - 29
10.5.1.13       YSLECT                                         10 - 30
10.5.1.14       YTCOMP                                         10 - 30
10.5.1.15       YTVCLS                                         10 - 30
10.5.1.16       YWINDO                                         10 - 30
10.5.1.17       YTVOPN                                         10 - 31
10.5.2       Level 1                                           10 - 31
10.5.2.1        YCRCTL                                         10 - 31
10.5.2.2        YGRAFX                                         10 - 31
10.5.2.3        YGRAPH                                         10 - 32
10.5.2.4        YIMGIO                                         10 - 32
10.5.2.5        YINIT                                          10 - 33
10.5.2.6        YLUT                                           10 - 33
10.5.2.7        YOFM                                           10 - 33
10.5.2.8        YSCROL                                         10 - 33
10.5.2.9        YSPLIT                                         10 - 34
10.5.2.10       YTVCIN                                         10 - 34
10.5.2.11       YTVCL2                                         10 - 34
10.5.2.12       YTVMC                                          10 - 35
10.5.2.13       YTVOP2                                         10 - 35
10.5.2.14       YZERO                                          10 - 35
10.5.2.15       YZOOMC                                         10 - 35
10.5.3       Level 2 (Used as level 1 in non-standard tasks)   10 - 36
10.5.3.1        YALUCT                                         10 - 36
10.5.3.2        YCONST                                         10 - 36
10.5.3.3        YFDBCK                                         10 - 36
10.5.3.4        YIFM                                           10 - 37
10.5.3.5        YMNMAX                                         10 - 37
10.5.3.6        YRHIST                                         10 - 38
10.5.3.7        YSHIFT                                         10 - 38
10.5.4       Level 3 (selected ones of some general interest)  10 - 38
10.5.4.1        YBUTON                                         10 - 38
10.5.4.2        YGGRAM                                         10 - 38
10.5.4.3        YGRAFE                                         10 - 39
10.5.4.4        YSTCUR                                         10 - 39
10.6      Selected Applications Subroutines                    10 - 40
10.6.1       Basic TV I/O Operations                           10 - 40
10.6.1.1        DLINTR                                         10 - 40
10.6.1.2        IMANOT                                         10 - 40
10.6.1.3        IMVECT                                         10 - 40
10.6.1.4        TVCLOS                                         10 - 41
10.6.1.5        TVFIND                                         10 - 41
10.6.1.6        TVOPEN                                         10 - 41
10.6.1.7        TVWHER                                         10 - 42
10.6.2       TV I/O Utilities                                  10 - 42
10.6.2.1        BLTFIL                                         10 - 42
10.6.2.2        GRPOLY                                         10 - 42
10.6.2.3        IENHNS                                         10 - 42
10.6.2.4        ILNCLR                                         10 - 43
10.6.2.5        IMCCLR                                         10 - 43
10.6.2.6        IMCHAR                                         10 - 44
10.6.2.7        IMLCLR                                         10 - 44
10.6.2.8        IMPCLR                                         10 - 44
10.6.2.9        TVFIDL                                         10 - 45
10.6.2.10       TVLOAD                                         10 - 45
10.6.3       Non-I/O Utilities                                 10 - 45
10.6.3.1        DECBIT                                         10 - 45
10.6.3.2        ISCALE                                         10 - 45
10.6.3.3        MOVIST                                         10 - 46
10.6.3.4        RNGSET                                         10 - 46
10.6.3.5        TVWIND                                         10 - 46

Back to top of table of contents.

11. Plotting (178861 bytes)

11.1      Overview                                             11 - 1
11.2      Plot files                                           11 - 1
11.2.1       General Comments                                  11 - 1
11.2.2       Structure of a Plot File                          11 - 2
11.2.3       Types of Plot File Logical Records                11 - 2
11.2.3.1        Initialize plot record                         11 - 2
11.2.3.2        Initialize for line drawing record             11 - 3
11.2.3.3        Initialize for grey scale record               11 - 3
11.2.3.4        Position record                                11 - 4
11.2.3.5        Draw vector record                             11 - 4
11.2.3.6        Write character string record                  11 - 4
11.2.3.7        Write pixels record                            11 - 4
11.2.3.8        Write misc. info to image catalog record       11 - 5
11.2.3.9        End of plot record                             11 - 5
11.2.4       Other Plotting Customs                            11 - 5
11.3      Plot Paraform Tasks                                  11 - 6
11.3.1       Introduction                                      11 - 6
11.3.2       Getting Started                                   11 - 6
11.3.3       Labeling the Plot                                 11 - 6
11.3.4       Plotting                                          11 - 7
11.3.5       Map I/O                                           11 - 7
11.3.6       Cleaning Up                                       11 - 8
11.3.7       The Three Paraform Plot Tasks                     11 - 8
11.3.7.1        PFPL1                                          11 - 8
11.3.7.2        PFPL2                                          11 - 9
11.3.7.3        PFPL3                                          11 - 10
11.4      Plotting to Devices                                  11 - 10
11.4.1       Versatec                                          11 - 11
11.4.2       QMS Laser Printer                                 11 - 11
11.5      Includes                                             11 - 12
11.5.1       DLOC.INC                                          11 - 12
11.5.2       DGPH.INC                                          11 - 13
11.5.3       DPLT.INC                                          11 - 13
11.6      Routines                                             11 - 14
11.6.1       CHNTIC                                            11 - 14
11.6.2       CLAB1                                             11 - 14
11.6.3       CLAB2                                             11 - 14
11.6.4       COMLAB                                            11 - 15
11.6.5       CONDRW                                            11 - 15
11.6.6       CTICS                                             11 - 16
11.6.7       GCHAR                                             11 - 16
11.6.8       GETROW                                            11 - 17
11.6.9       GFINIS                                            11 - 17
11.6.10      GINIT                                             11 - 17
11.6.11      GINITG                                            11 - 18
11.6.12      GINITL                                            11 - 19
11.6.13      GMCAT                                             11 - 20
11.6.14      GPOS                                              11 - 20
11.6.15      GRAYPX                                            11 - 20
11.6.16      GVEC                                              11 - 21
11.6.17      HIPLOT                                            11 - 21
11.6.18      INTMIO                                            11 - 21
11.6.19      LABINI                                            11 - 22
11.6.20      PLEND                                             11 - 23
11.6.21      PLGRY                                             11 - 23
11.6.22      PLMAKE                                            11 - 23
11.6.23      PLPOS                                             11 - 24
11.6.24      PLVEC                                             11 - 24
11.6.25      REIMIO                                            11 - 24
11.6.26      STARPL                                            11 - 25

Back to top of table of contents.

12. Using the Array Processors (247231 bytes)

12.1      Overview                                             12 - 1
12.1.1       Why use the Array Processor?                      12 - 1
12.1.2       When to Use, and Not to Use, the AP               12 - 1
12.2      The AIPS Model of an Array Processor                 12 - 2
12.3      How to Use the Array Processor                       12 - 3
12.3.1       AP Data Addresses                                 12 - 3
12.3.1.1        Q Routine Arguments                            12 - 3
12.3.1.2        Array Processor Memory Size                    12 - 3
12.3.2       Assigning the AP                                  12 - 4
12.3.3       Data Transfers To and From the AP                 12 - 4
12.3.4       Loading and Executing AP Programs                 12 - 5
12.3.5       Timing Calls                                      12 - 5
12.3.6       Writing AP Routines                               12 - 5
12.3.6.1        Microcoding Routines                           12 - 6
12.3.6.2        Vector Function Chainer                        12 - 6
12.3.7       FFTs                                              12 - 6
12.4      Pseudo-Array Processor and Vector Computers          12 - 7
12.4.1       Vectorization                                     12 - 7
12.4.1.1        What is Vectorization?                         12 - 7
12.4.1.2        Vector Hardware                                12 - 7
12.4.1.3        Vector Operations                              12 - 7
12.4.1.4        Difficulties with Vectorization                12 - 8
12.4.1.4.1         Dependencies                                12 - 8
12.4.1.4.2         Short Loops                                 12 - 9
12.4.1.4.3         Branches in Loops                           12 - 9
12.4.1.5        Tuning                                         12 - 9
12.4.2       Memory Use                                        12 - 9
12.4.2.1        Memory Heirarchy                               12 - 9
12.4.2.1        Work Vectors                                   12 - 10
12.4.2.1        Extension of AP Memory                         12 - 11
12.4.2.1        Memory allocation                              12 - 11
12.5      Example of the Use of the AP                         12 - 11
12.6      INCLUDEs                                             12 - 13
12.6.1       DAPC.INC                                          12 - 13
12.6.2       DBPR.INC                                          12 - 14
12.6.3       DDCH.INC                                          12 - 14
12.6.4       ZVND.INC                                          12 - 15
12.6.5       ZVND.INC                                          12 - 15
12.7      Routines                                             12 - 15
12.7.1       Utility Routines                                  12 - 15
12.7.1.1        APCONV                                         12 - 15
12.7.1.2        APIO                                           12 - 16
12.7.1.3        DSKFFT                                         12 - 18
12.7.1.4        PEAKFN                                         12 - 18
12.7.1.5        PLNGET                                         12 - 19
12.7.1.6        QROLL                                          12 - 19
12.7.2       Array Processor Routines                          12 - 20
12.7.3       AP Routine Call Sequences                         12 - 22
12.7.3.1        QGET                                           12 - 22
12.7.3.2        QGSP                                           12 - 23
12.7.3.3        QPUT                                           12 - 23
12.7.3.4        QWAIT                                          12 - 23
12.7.3.5        QWD                                            12 - 23
12.7.3.6        QWR                                            12 - 23
12.7.3.7        QINIT                                          12 - 23
12.7.3.8        QRLSE                                          12 - 24
12.7.3.9        QBOXSU                                         12 - 24
12.7.3.10       QCFFT                                          12 - 24
12.7.3.11       QCRVMU                                         12 - 24
12.7.3.12       QCSQTR                                         12 - 25
12.7.3.13       QCVCMU                                         12 - 25
12.7.3.14       QCVCON                                         12 - 25
12.7.3.15       QCVEXP                                         12 - 26
12.7.3.16       QCVJAD                                         12 - 26
12.7.3.17       QCVMAG                                         12 - 26
12.7.3.18       QCVMMA                                         12 - 26
12.7.3.19       QCVMOV                                         12 - 27
12.7.3.20       QCVMUL                                         12 - 27
12.7.3.21       QCVSDI                                         12 - 28
12.7.3.22       QCVSMS                                         12 - 28
12.7.3.23       QDIRAD                                         12 - 28
12.7.3.24       QHIST                                          12 - 29
12.7.3.25       QLVGT                                          12 - 29
12.7.3.26       QMAXMI                                         12 - 29
12.7.3.27       QMAXV                                          12 - 30
12.7.3.28       QMEMSZ                                         12 - 30
12.7.3.29       QMINV                                          12 - 30
12.7.3.30       QMTRAN                                         12 - 31
12.7.3.31       QPHSRO                                         12 - 31
12.7.3.32       QPOLAR                                         12 - 31
12.7.3.33       QRECT                                          12 - 32
12.7.3.34       QRFFT                                          12 - 32
12.7.3.35       QRFT                                           12 - 32
12.7.3.36       QSVE                                           12 - 33
12.7.3.37       QSVESQ                                         12 - 33
12.7.3.38       QVABS                                          12 - 33
12.7.3.39       QVADD                                          12 - 34
12.7.3.40       QVCLIP                                         12 - 34
12.7.3.41       QVCLR                                          12 - 34
12.7.3.42       QVCOS                                          12 - 35
12.7.3.43       QVDIV                                          12 - 35
12.7.3.44       QVEXP                                          12 - 35
12.7.3.45       QVFILL                                         12 - 35
12.7.3.46       QVFIX                                          12 - 36
12.7.3.47       QVFLT                                          12 - 36
12.7.3.48       QVIDIV                                         12 - 36
12.7.3.49       QVLN                                           12 - 37
12.7.3.50       QVMA                                           12 - 37
12.7.3.51       QVMOV                                          12 - 37
12.7.3.52       QVMUL                                          12 - 38
12.7.3.53       QVNEG                                          12 - 38
12.7.3.54       QVRVRS                                         12 - 38
12.7.3.55       QVSADD                                         12 - 38
12.7.3.56       QVSIN                                          12 - 39
12.7.3.57       QVSMA                                          12 - 39
12.7.3.58       QVSMAFX                                        12 - 39
12.7.3.59       QVSMSA                                         12 - 40
12.7.3.60       QVSMUL                                         12 - 40
12.7.3.61       QVSQ                                           12 - 40
12.7.3.62       QVSQRT                                         12 - 41
12.7.3.63       QVSUB                                          12 - 41
12.7.3.64       QVSWAP                                         12 - 41
12.7.3.65       QVTRAN                                         12 - 41

Back to top of table of contents.

13. Tables in AIPS (181754 bytes)

13.1      Overview                                             13 - 1
13.2      General Tables Routines                              13 - 1
13.3      Specific Tables Routines                             13 - 1
13.4      The Format Details                                   13 - 2
13.4.1       Row Data                                          13 - 2
13.4.2       Physical File Format                              13 - 3
13.4.3       Control Information                               13 - 3
13.4.4       Keyword/value records                             13 - 5
13.4.5       I/O buffers                                       13 - 5
13.4.6       Fundamental Table Access Subroutines              13 - 6
13.4.7       Table Reformating Subroutines                     13 - 6
13.5      Includes                                             13 - 6
13.5.1       PUVD.INC                                          13 - 6
13.6      Routines                                             13 - 7
13.6.1       Routines Applying to All Tables                   13 - 7
13.6.1.1        ALLTAB                                         13 - 7
13.6.1.2        FNDCOL                                         13 - 7
13.6.1.3        GETCOL                                         13 - 8
13.6.1.4        ISTAB                                          13 - 8
13.6.1.5        PUTCOL                                         13 - 9
13.6.1.6        TABCOP                                         13 - 9
13.6.1.7        TABINI                                         13 - 10
13.6.1.8        TABIO                                          13 - 11
13.6.1.9        TABKEY                                         13 - 11
13.6.1.10       TABMRG                                         13 - 12
13.6.1.11       TABSRT                                         13 - 13
13.6.2       Routines Applying to Specific Tables              13 - 14
13.6.2.1        ANTINI                                         13 - 14
13.6.2.2        BLINI                                          13 - 15
13.6.2.3        BLREFM                                         13 - 15
13.6.2.4        BPINI                                          13 - 16
13.6.2.5        BPREFM                                         13 - 16
13.6.2.6        CALINI                                         13 - 17
13.6.2.7        CCINI                                          13 - 17
13.6.2.8        CCMERG                                         13 - 18
13.6.2.9        CHNDAT                                         13 - 18
13.6.2.10       CHNCOP                                         13 - 19
13.6.2.11       CLREFM                                         13 - 19
13.6.2.12       FLGINI                                         13 - 20
13.6.2.13       FQINI                                          13 - 20
13.6.2.14       GETNAN                                         13 - 21
13.6.2.15       NDXINI                                         13 - 21
13.6.2.16       SNINI                                          13 - 22
13.6.2.17       SNREFM                                         13 - 22
13.6.2.18       SOUINI                                         13 - 23
13.6.2.19       TABAN                                          13 - 23
13.6.2.20       TABBL                                          13 - 24
13.6.2.21       TABBP                                          13 - 25
13.6.2.22       TABCAL                                         13 - 26
13.6.2.23       TABFLG                                         13 - 27
13.6.2.24       TABFQ                                          13 - 28
13.6.2.25       TABNDX                                         13 - 28
13.6.2.26       TABSN                                          13 - 29
13.6.2.27       TABSOU                                         13 - 30

Back to top of table of contents.

14. FITS Tapes (243881 bytes)

14.1      Overview                                             14 - 1
14.2      Philosophy                                           14 - 1
14.3      Image Files                                          14 - 2
14.3.1       Overall Structure                                 14 - 2
14.3.2       Header Records                                    14 - 2
14.3.2.1        Keywords                                       14 - 3
14.3.2.2        History                                        14 - 4
14.3.2.3        AIPS Non-standard Image File Keywords          14 - 4
14.3.2.4        Coordinate Systems                             14 - 5
14.3.2.5        Example Image Header                           14 - 6
14.3.2.6        Units                                          14 - 7
14.3.3       Data Records                                      14 - 7
14.4      Random Group (UV data) Files                         14 - 7
14.4.1       Header Record                                     14 - 8
14.4.2       Data Records                                      14 - 8
14.4.2.1        Units of Random Parameters                     14 - 9
14.4.2.2        Units of the Regular Axis Coordinates          14 - 9
14.4.2.3        Weights and Flagging                           14 - 9
14.4.2.4        Antennas and Subarrays                         14 - 10
14.4.2.5        Coordinates                                    14 - 10
14.4.2.6        Sort Order                                     14 - 10
14.4.3       Typical VLA Record Structure                      14 - 11
14.4.4       Single Dish Data                                  14 - 13
14.4.4.1        Single Dish Random Parameters                  14 - 13
14.4.4.2        Single Dish Regular Axis Coordinates           14 - 13
14.4.4.3        Example Single Dish Data File Header           14 - 14
14.5      Extension Files                                      14 - 15
14.5.1       Standard Extension                                14 - 16
14.5.2       Tables Extension                                  14 - 17
14.5.2.1        Tables Header Record                           14 - 17
14.5.2.2        Table Data Records                             14 - 18
14.5.2.3        Example Table Header and Data                  14 - 18
14.5.3       3- D Tables Extension                             14 - 19
14.5.3.1        3-D Tables Header Record                       14 - 19
14.5.3.2        Table Data Records                             14 - 20
14.5.3.3        Example 3- D Table Header                      14 - 21
14.5.4       Older AIPS Tables                                 14 - 22
14.5.4.1        General Form of Header                         14 - 22
14.5.4.2        Data Records                                   14 - 22
14.5.4.3        CC Files                                       14 - 22
14.5.4.4        AN Files                                       14 - 23
14.6      AIPS FITS INCLUDEs                                   14 - 23
14.6.1       DFUV.INC                                          14 - 23
14.6.2       DFIT.INC                                          14 - 24
14.6.3       VFUV.INC                                          14 - 24
14.6.4       VFIT.INC                                          14 - 25
14.7      AIPS FITS Parsing Routines                           14 - 26
14.7.1       EXTREQ                                            14 - 27
14.7.2       FPARSE                                            14 - 28
14.7.3       GETCRD                                            14 - 28
14.7.4       GETKEY                                            14 - 29
14.7.5       GETLOG                                            14 - 29
14.7.6       GETNUM                                            14 - 29
14.7.7       GETSTR                                            14 - 30
14.7.8       GETSYM                                            14 - 30
14.7.9       GTWCRD                                            14 - 30
14.7.10      IDWCRD                                            14 - 31
14.7.11      R3DTAB                                            14 - 31
14.7.12      RWTAB                                             14 - 31
14.7.13      TABAXI                                            14 - 32
14.7.14      TABHDK                                            14 - 32
14.7.15      TABHDR                                            14 - 33
14.8      References                                           14 - 33

Back to top of table of contents.

15. The Z Routines (275799 bytes)

15.1      Overview                                             15 - 1
15.1.1       Device Characteristics Common                     15 - 2
15.1.2       FTAB                                              15 - 2
15.1.3       Logicals                                          15 - 3
15.1.4       Disk Files                                        15 - 3
15.1.4.1        Binary (data) files                            15 - 3
15.1.4.1        Text files                                     15 - 3
15.2      System Functions                                     15 - 4
15.3      Disk I/O and File Manipulation Routines              15 - 5
15.4      Device (non-disk) I/O Routines                       15 - 6
15.5      Data Manipulation Routines                           15 - 8
15.6      Directory and Text File Routines                     15 - 9
15.7      Television I/O                                       15 - 10
15.8      Virtual Devices                                      15 - 11
15.9      Miscellaneous                                        15 - 11
15.10     INCLUDEs                                             15 - 12
15.10.1      DDCH.INC                                          15 - 12
15.10.2      DMSG.INC                                          15 - 12
15.11     Routines                                             15 - 13
15.11.1      SYSTEM                                            15 - 13
15.11.1.1       ZABORT                                         15 - 13
15.11.1.2       ZACTV8                                         15 - 13
15.11.1.3       ZCPU                                           15 - 13
15.11.1.4       ZDATE                                          15 - 14
15.11.1.5       ZDCHIN                                         15 - 14
15.11.1.6       ZDELAY                                         15 - 14
15.11.1.7       ZFREE                                          15 - 15
15.11.1.8       ZGNAME                                         15 - 15
15.11.1.9       ZPRIO                                          15 - 15
15.11.1.10      ZSETUP                                         15 - 15
15.11.1.11      ZSTAIP                                         15 - 16
15.11.1.12      ZTACTQ                                         15 - 16
15.11.1.13      ZTIME                                          15 - 16
15.11.1.14      ZTKILL                                         15 - 16
15.11.1.15      ZTQSPY                                         15 - 17
15.11.1.16      ZTRLOG                                         15 - 17
15.11.1.17      ZWHOMI                                         15 - 17
15.11.2      Disk I/O                                          15 - 17
15.11.2.1       ZCLOSE                                         15 - 17
15.11.2.2       ZCMPRS                                         15 - 18
15.11.2.3       ZCREAT                                         15 - 18
15.11.2.4       ZDESTR                                         15 - 19
15.11.2.5       ZEXIST                                         15 - 19
15.11.2.6       ZEXPND                                         15 - 19
15.11.2.7       ZFIO                                           15 - 19
15.11.2.8       ZFULLN                                         15 - 20
15.11.2.9       ZMIO                                           15 - 20
15.11.2.10      ZMKTMP                                         15 - 21
15.11.2.11      ZMSGCL                                         15 - 21
15.11.2.12      ZMSGDK                                         15 - 22
15.11.2.13      ZMSGOP                                         15 - 22
15.11.2.14      ZMSGXP                                         15 - 22
15.11.2.15      ZOPEN                                          15 - 23
15.11.2.16      ZPHFIL                                         15 - 23
15.11.2.17      ZPHOLV                                         15 - 24
15.11.2.18      ZRENAM                                         15 - 24
15.11.2.19      ZTFILL                                         15 - 25
15.11.2.20      ZWAIT                                          15 - 25
15.11.3      Non-disk I/O routines                             15 - 25
15.11.3.1       ZBKLD1                                         15 - 25
15.11.3.2       ZBKLD2                                         15 - 26
15.11.3.3       ZBKLD3                                         15 - 26
15.11.3.4       ZBKTP1                                         15 - 26
15.11.3.5       ZBKTP2                                         15 - 26
15.11.3.6       ZBKTP3                                         15 - 27
15.11.3.7       ZDOPRT                                         15 - 27
15.11.3.8       ZENDPG                                         15 - 27
15.11.3.9       ZLASCL                                         15 - 27
15.11.3.10      ZLASIO                                         15 - 28
15.11.3.11      ZLPCLS                                         15 - 28
15.11.3.12      ZLPOPN                                         15 - 28
15.11.3.13      ZLWIO                                          15 - 29
15.11.3.14      ZLWOP                                          15 - 29
15.11.3.15      ZMOUNT                                         15 - 29
15.11.3.16      ZPRMPT                                         15 - 29
15.11.3.17      ZPRPAS                                         15 - 30
15.11.3.18      ZTAPE                                          15 - 30
15.11.3.19      ZTAPIO                                         15 - 30
15.11.3.20      ZTKBUF                                         15 - 31
15.11.3.21      ZTKCLS                                         15 - 31
15.11.3.22      ZTKFI2                                         15 - 32
15.11.3.23      ZTKOPN                                         15 - 32
15.11.3.24      ZTPCLS                                         15 - 32
15.11.3.25      ZTPMIO                                         15 - 33
15.11.3.26      ZTPOPN                                         15 - 33
15.11.3.27      ZTPWAT                                         15 - 33
15.11.3.28      ZTTBUF                                         15 - 34
15.11.3.29      ZTTYIO                                         15 - 34
15.11.4      Data Manipulation                                 15 - 34
15.11.4.1       ZBYMOV                                         15 - 35
15.11.4.2       ZBYTFL                                         15 - 35
15.11.4.3       ZC8CL                                          15 - 35
15.11.4.4       ZCLC8                                          15 - 35
15.11.4.5       ZDHPRL                                         15 - 36
15.11.4.6       ZDM2DL                                         15 - 36
15.11.4.7       ZGETCH                                         15 - 37
15.11.4.8       ZGTBIT                                         15 - 37
15.11.4.9       ZI16IL                                         15 - 37
15.11.4.10      ZI32IL                                         15 - 38
15.11.4.11      ZI8IL                                          15 - 38
15.11.4.12      ZILI16                                         15 - 38
15.11.4.13      ZILI32                                         15 - 38
15.11.4.14      ZMCACL                                         15 - 39
15.11.4.15      ZPTBIT                                         15 - 39
15.11.4.16      ZPUTCH                                         15 - 40
15.11.4.17      ZR32RL                                         15 - 40
15.11.4.18      ZR64RL                                         15 - 41
15.11.4.19      ZR8P4                                          15 - 41
15.11.4.20      ZRDMF                                          15 - 42
15.11.4.21      ZRHPRL                                         15 - 42
15.11.4.22      ZRLR32                                         15 - 43
15.11.4.23      ZRLR64                                         15 - 43
15.11.4.24      ZRM2RL                                         15 - 43
15.11.4.25      ZUVPAK                                         15 - 44
15.11.4.26      ZUVXPN                                         15 - 44
15.11.4.27      ZX8XL                                          15 - 45
15.11.4.28      ZXLX8                                          15 - 45
15.11.5      Directory and Text File                           15 - 45
15.11.5.1       ZTCLOS                                         15 - 45
15.11.5.2       ZTOPEN                                         15 - 46
15.11.5.3       ZTREAD                                         15 - 46
15.11.5.4       ZTXCLS                                         15 - 46
15.11.5.5       ZTXIO                                          15 - 47
15.11.5.6       ZTXMAT                                         15 - 47
15.11.5.7       ZTXOPN                                         15 - 48
15.11.6      Virtual Devices                                   15 - 48
15.11.6.1       ZVTVCL                                         15 - 48
15.11.6.2       ZVTVGC                                         15 - 48
15.11.6.3       ZVTVOP                                         15 - 49
15.11.6.4       ZVTVRC                                         15 - 49
15.11.6.5       ZVTVRO                                         15 - 49
15.11.6.6       ZVTVRX                                         15 - 49
15.11.6.7       ZVTVXF                                         15 - 50
15.11.7      Miscellaneous                                     15 - 50
15.11.7.1       ZADDR                                          15 - 50
15.11.7.2       ZERROR                                         15 - 51
15.11.7.3       ZHEX                                           15 - 51
15.11.7.4       ZKDUMP                                         15 - 51
15.11.7.5       ZMSGER                                         15 - 51
15.11.7.6       ZMYVER                                         15 - 52

Back to top of table of contents.

16. Calibration and Editing (246931 bytes)

16.1      Introduction                                         16 - 1
16.2      Multi-source uv Data Files                           16 - 1
16.2.1       Distinguishing Sources                            16 - 1
16.2.2       Time Order                                        16 - 2
16.2.3       Scans                                             16 - 2
16.2.4       Subarrays                                         16 - 2
16.2.5       Compressed Data                                   16 - 2
16.2.6       Frequency Sets (FQ id)                            16 - 2
16.2.7       Tables                                            16 - 2
16.3      Editing Basics                                       16 - 3
16.4      Interferometric Calibration Basics                   16 - 3
16.4.1       Internal Calibration                              16 - 4
16.4.2       Smoothing                                         16 - 4
16.4.3       Reference Antennas                                16 - 4
16.5      Observing Model                                      16 - 5
16.6      Applying Calibration to Interferometer Data          16 - 5
16.6.1       Amplitude, Phase, Delay and Rate                  16 - 5
16.6.2       Baseline Dependent Calibration                    16 - 5
16.6.3       Bandpass Calibration                              16 - 6
16.6.4       Spectral Smoothing                                16 - 6
16.6.5       Polarization Calibration                          16 - 6
16.7      Data Selection                                       16 - 6
16.8      Table Access Routines                                16 - 7
16.9      Calibration Table Routines                           16 - 7
16.10     Data Access Routines                                 16 - 7
16.10.1      Structure of the Interferometer Data Access System 16 - 8
16.10.2      Data Access Routines                              16 - 8
16.11     Example Using UVGET                                  16 - 9
16.12     Single Dish Data                                     16 - 12
16.13     Text of INCLUDE files                                16 - 13
16.13.1      DSEL.INC                                          16 - 13
16.13.2      PUVD.INC                                          16 - 16
16.14     Routines                                             16 - 17
16.14.1      BLREFM                                            16 - 17
16.14.2      BLSET                                             16 - 17
16.14.3      BPASET                                            16 - 18
16.14.4      BPGET                                             16 - 18
16.14.5      BPREFM                                            16 - 19
16.14.6      CALCOP                                            16 - 19
16.14.7      CALREF                                            16 - 20
16.14.8      CGASET                                            16 - 20
16.14.9      CLREFM                                            16 - 21
16.14.10     CLUPDA                                            16 - 22
16.14.11     CSLGET                                            16 - 22
16.14.12     DATBND                                            16 - 23
16.14.13     DATCAL                                            16 - 24
16.14.14     DATFLG                                            16 - 25
16.14.15     DATGET                                            16 - 25
16.14.16     DGGET                                             16 - 26
16.14.17     DGHEAD                                            16 - 27
16.14.18     DGINIT                                            16 - 27
16.14.19     GACSIN                                            16 - 28
16.14.20     GAININ                                            16 - 28
16.14.21     LXYPOL                                            16 - 28
16.14.22     NXTFLG                                            16 - 29
16.14.23     POLSET                                            16 - 30
16.14.24     SCLOAD                                            16 - 30
16.14.25     SCINTP                                            16 - 30
16.14.26     SDCGET                                            16 - 31
16.14.27     SDCSET                                            16 - 31
16.14.28     SDGET                                             16 - 32
16.14.29     SETSM                                             16 - 34
16.14.30     SELINI                                            16 - 34
16.14.31     SNREFM                                            16 - 35
16.14.32     SOUFIL                                            16 - 35
16.14.33     UVGET                                             16 - 36
16.14.34     VISCNT                                            16 - 39

Back to top of table of contents.

C. Details of AIPS files (338178 bytes)

C.1       Introduction                                          C - 1
C.2       AIPS System files                                     C - 1
C.2.1        Accounting (AC) file                               C - 1
C.2.1.1         Overview                                        C - 1
C.2.1.2         File Structure                                  C - 1
C.2.1.3         Usage Notes                                     C - 2
C.2.1.4         Routines and commons for writing the account
                   task data file                               C - 2
C.2.1.5         Routines and commons for reading the account 
                   task data file                               C - 2
C.2.2        Batch text (BA) file                               C - 2
C.2.2.1         Overview                                        C - 2
C.2.2.2         Data structures                                 C - 3
C.2.2.3         Usage Notes                                     C - 3
C.2.2.4         Routines and commons for reading batch text files C - 3
C.2.2.5         Routines and commons for writing batch text files C - 4
C.2.3        Batch queing (BQ) file                             C - 4
C.2.3.1         Overview                                        C - 4
C.2.3.2         Data structure                                  C - 4
C.2.3.3         Usage Notes                                     C - 5
C.2.3.4         Routines and commons                            C - 5
C.2.4        GRIPE (GR) files                                   C - 5
C.2.4.1         Overview                                        C - 5
C.2.4.2         Data structure                                  C - 5
C.2.4.3         Usage Notes                                     C - 6
C.2.4.4         Routines and commons                            C - 6
C.2.5        Help (HE) file                                     C - 6
C.2.5.1         Overview                                        C - 6
C.2.5.2         File Structure and contents                     C - 6
C.2.5.3         Usage Notes                                     C - 8
C.2.5.4         Routines and commons for reading Help files     C - 9
C.2.5.5         Routines and commons for writing Help files     C - 9
C.2.6        Image catalog (IC) file                            C - 9
C.2.6.1         Overview                                        C - 9
C.2.6.2         Data Structures                                 C - 9
C.2.6.3         Usage Notes                                     C - 10
C.2.6.4         Subroutines:                                    C - 10
C.2.6.5         Commons:                                        C - 10
C.2.7        TV lock (ID) file                                  C - 11
C.2.7.1         Overview                                        C - 11
C.2.7.2         Data Structures                                 C - 11
C.2.7.3         Usage Notes                                     C - 11
C.2.8        POPS memory (ME) file                              C - 11
C.2.8.1         Overview                                        C - 11
C.2.8.2         File Structure                                  C - 11
C.2.8.3         User notes                                      C - 11
C.2.8.4         Routines which read and write POPS memory files C - 12
C.2.9        Message (MS) file                                  C - 12
C.2.9.1         Overview                                        C - 12
C.2.9.2         File Structure                                  C - 12
C.2.9.3         User notes                                      C - 12
C.2.9.4         Routines and commons for writing message files  C - 12
C.2.9.5         Routines and commons for reading message files  C - 13
C.2.10       Password (PW) file                                 C - 13
C.2.10.1        Overview                                        C - 13
C.2.10.2        File Structure                                  C - 13
C.2.10.3        Useage notes                                    C - 13
C.2.11       POPS Save-Get (SG) file                            C - 14
C.2.11.1        Overview                                        C - 14
C.2.11.2        File Structure                                  C - 14
C.2.11.3        User notes                                      C - 15
C.2.11.4        Routines which read and write POPS memory files C - 15
C.2.12       System parameter (SP) file                         C - 15
C.2.12.1        Overview                                        C - 15
C.2.12.2        File Structure                                  C - 15
C.2.12.3        Routines and commons for reading the system
                   parameter file         .                     C - 16
C.2.12.4        Routine for initializing and updating the
                   system parameter file  .                     C - 16
C.2.13       Task Show and Tell (TC) file                       C - 17
C.2.13.1        Overview                                        C - 17
C.2.13.2        File Structure                                  C - 17
C.2.14       Task data (TD) file                                C - 18
C.2.14.1        Overview                                        C - 18
C.2.14.2        File Structure                                  C - 18
C.2.14.3        Usage Notes                                     C - 19
C.2.14.4        Routines and commons for writing the task 
                   data file                                    C - 19
C.2.14.5        Routines and commons for reading the task
                   data file                                    C - 19
C.2.15       Tape lock (TP) file                                C - 20
C.2.15.1        Overview                                        C - 20
C.2.15.2        File Structure                                  C - 20
C.2.15.3        Usage Notes                                     C - 20
C.2.16       Task Adverb Save (TS) file                         C - 20
C.2.16.1        Overview                                        C - 20
C.2.16.2        File Structure                                  C - 20
C.2.16.3        Usage Notes                                     C - 21
C.2.16.4        Routines which read and write the Task Save file C - 21
C.3       User data files                                       C - 21
C.3.1        Catalog directory (CA) file                        C - 21
C.3.1.1         Overview                                        C - 21
C.3.1.2         Data Structures and usage notes                 C - 22
C.3.1.3         Usage protocols:                                C - 22
C.3.1.4         Subroutines                                     C - 23
C.3.2        Catalog header (CB) file                           C - 23
C.3.2.1         Overview                                        C - 23
C.3.2.2         Data Structures and usage notes                 C - 23
C.3.2.3         Comments                                        C - 25
C.3.2.4         Keywords                                        C - 25
C.3.2.5         Subroutines                                     C - 26
C.3.3       Gain (GA) file                                      C - 26
C.3.3.1         Overview                                        C - 26
C.3.3.2         File structure.                                 C - 26
C.3.3.3         User notes.                                     C - 27
C.3.3.4         Routines to write GA files:                     C - 27
C.3.3.5         Routines to access GA files:                    C - 27
C.3.4        History (HI) file                                  C - 27
C.3.4.1         Overview                                        C - 27
C.3.4.2         File Structure                                  C - 27
C.3.4.3         User notes                                      C - 28
C.3.4.4         Routines and commons for writing history files  C - 28
C.3.4.5         Routines and commons for reading history files  C - 29
C.3.5        Image (MA) file                                    C - 29
C.3.5.1         Overview                                        C - 29
C.3.5.2         Record formats                                  C - 29
C.3.5.3         Usage Notes                                     C - 29
C.3.5.4         Routines and commons for reading and writing
                   map files                                    C - 29
C.3.6        Plot (PL) file                                     C - 29
C.3.6.1         Overview                                        C - 29
C.3.6.2         Record layouts                                  C - 30
C.3.6.3         Subroutines and Commons for Writing             C - 32
C.3.6.4         Subroutines and Commons for Reading.            C - 33
C.3.7        Slice (SL) file                                    C - 33
C.3.7.1         Overview                                        C - 33
C.3.7.2         Record formats                                  C - 33
C.3.7.3         User notes.                                     C - 35
C.3.7.4         Routines to write SL files:                     C - 35
C.3.7.5         Routines to access SL files:                    C - 35
C.3.8       Uv data (UV) file                                   C - 35
C.3.8.1         Overview                                        C - 35
C.3.8.2         Record formats                                  C - 35
C.3.8.3         Usage Notes                                     C - 35
C.3.8.14        Routines and commons for reading and writing
                   UV files                                     C - 35
C.4       Table details                                         C - 35
C.4.1        Antenna (AN) table                                 C - 36
C.4.1.1         Overview                                        C - 36
C.4.1.2         File Structure                                  C - 36
C.4.1.3         User Notes                                      C - 37
C.4.1.4         Routines to access AN files                     C - 37
C.4.2        Baseline dependent calibration (BL) table          C - 37
C.4.2.1         Overview                                        C - 37
C.4.2.2         File structure                                  C - 37
C.4.2.3         User notes                                      C - 38
C.4.2.4         Routines to access BL files                     C - 38
C.4.3        Bandpass calibration (BP) table                    C - 38
C.4.3.1         Overview                                        C - 38
C.4.3.2         File structure                                  C - 38
C.4.3.3         User notes                                      C - 39
C.4.3.4         Routines to access BP files                     C - 39
C.4.4        Clean Components (CC) table                        C - 40
C.4.4.1         Overview                                        C - 40
C.4.4.2         File Structure                                  C - 40
C.4.4.3         User notes                                      C - 40
C.4.4.4         Routines for accessing CC files                 C - 40
C.4.5        Calibration (CL) table                             C - 40
C.4.5.1         Overview                                        C - 40
C.4.5.2         Phase model                                     C - 41
C.4.5.3         File Structure                                  C - 42
C.4.5.4         User Notes                                      C - 43
C.4.5.5         AIPS routines to access CL files                C - 43
C.4.6        Frequency (CH) table                               C - 43
C.4.6.1         Overview                                        C - 43
C.4.6.2         File Structure                                  C - 44
C.4.6.3         User Notes                                      C - 44
C.4.6.4         Routines to access CH files                     C - 44
C.4.7        Single dish calibration (CS) table                 C - 44
C.4.7.1         Overview                                        C - 44
C.4.7.2         File structure                                  C - 44
C.4.7.3         User notes.                                     C - 45
C.4.7.4         Routines to access CS files                     C - 45
C.4.8        Flag (FG) table                                    C - 45
C.4.8.1         Overview                                        C - 45
C.4.8.2         File Structure                                  C - 46
C.4.8.3         User Notes                                      C - 46
C.4.8.4         Routines to access FG files                     C - 46
C.4.9        Frequency (FQ) table                               C - 46
C.4.9.1         Overview                                        C - 46
C.4.9.2         File Structure                                  C - 46
C.4.9.3         User Notes                                      C - 47
C.4.9.4         Routines to access FQ files                     C - 47
C.4.10       Index (NX) table                                   C - 47
C.4.10.1        Overview                                        C - 47
C.4.10.2        File Structure                                  C - 47
C.4.10.3        User Notes                                      C - 48
C.4.10.4        Routines to access NX files                     C - 48
C.4.11       Solution (SN) table                                C - 48
C.4.11.1        Overview                                        C - 48
C.4.11.2        File Structure                                  C - 48
C.4.11.3        User Notes                                      C - 49
C.4.11.4        Routines to access SN files                     C - 50
C.4.12       Source (SU) table                                  C - 50
C.4.12.1        Overview                                        C - 50
C.4.12.2        File Structure                                  C - 50
C.4.12.3        User Notes                                      C - 51
C.4.12.4        Routines to access SU files                     C - 51
C.5       Task Specific Tables                                  C - 51
C.5.1        SPFLG baseline (BL) table                          C - 51
C.5.1.1         Overview                                        C - 51
C.5.1.2         File Structure                                  C - 51
C.5.1.3         User Notes                                      C - 51
C.5.1.4         Routines to access SPFLG type BL files          C - 51
C.5.2        SPFLG/TVFLG Temporary Flag (FC) table              C - 52
C.5.2.1         Overview                                        C - 52
C.5.2.2         File Structure                                  C - 52
C.5.3        ANCAL System Temperature (TY) table                C - 52
C.5.3.1         Overview                                        C - 52
C.5.3.2         File Structure                                  C - 52
C.5.3.3         User Notes                                      C - 52
C.5.3.4         Routines to access TY files                     C - 52

Back to top of table of contents.

I. Index (68782 bytes)

Truncated Revision History

CHAPTER  DATE      WHAT DONE
   0.1   
   1     
   2     
   3     
   4     
   5     
   6     
   7     
   8     
   A     
   B     
   0.2   
   9     
  10     
  11     
  12     
  13     
  14     
  15     
  16     
   C     
   I     

Back to top of table of contents.


[Powered by Apache!] Eric W. Greisen