![[AIPS]](/aips.gif)
Going AIPS
![[NRAO]](/nraologo_tiny.gif)
|
|
Going AIPS |
|
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/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.
Title page
Table of contents i
Back to top of table of contents.
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.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.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.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.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.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.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.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.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.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.
Title page
Table of contents i
Back to top of table of contents.
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.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.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.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.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.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.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.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.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.
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!]](/icons/apache_pb.gif){kind=icon}