COBE Guest Investigator Support Software User's Guide Edition 2.2 December 21, 1994 DOCUMENT SUMMARY COBE Guest Investigator Handbook: Sent to guest investigators (GIs) before their arrival, this manual contains information on the GI program, the computer equipment earmarked for guests and its use, the released data products, and available software. Proposer Information Package: Distributed in the packet of materials sent to prospective guest investigators (GIs), this document provides preliminary details on the released COBE data products and the computing hardware and software for the GI program. COBE Software Catalog: A reference for anyone doing COBE data analysis, this catalog lists the help files for all of the UIDL routines, as well as listing and describing unconfigured routines used by the instrument teams. Note that these unconfigured routines are not available to the guest investigator community. CDAC Orientation Handbook: Intended primarily for new employees at the Cosmology Data Analysis Center or others with similar privileges on the COBECL cluster, this handbook describes the CDAC physical and computing facilities, as well as how to get around in the COBECL environment. Project software data processing and its associated tools are also discussed. Note to users: The information in this document reflects the released version of the COBE Guest Investigator Software as of December 21, 1994. Because changes and improvements to the software are constantly being implemented, users may find that some areas in this guide do not accurately represent the current state of the software. The ULTRIX and PC versions of the software may differ in some specifics (e.g., acceptable file names) ; no attempt has been made here to exhaustively catalog these. TABLE OF CONTENTS 1 INTRODUCING THE CGIS SOFTWARE Figure 1.1 Schematic view showing the connection between the packages available in CGIS. 1.1 ORGANIZATION OF THIS USER'S GUIDE 1.2 CONVENTIONS USED IN THIS GUIDE 1.3 WHERE TO FIND MORE HELP 1.4 WARNINGS TO WORKSTATION USERS 1.4.1 Deleting Windows 1.4.2 Resizing Windows 2 USING THE CGIS EXECUTIVE 2.1 ENTERING THE CGIS EXECUTIVE 2.2 BRANCHES OF THE EXECUTIVE 2.2.1 COBE Data and Analysis Menus (UIMAGE) 2.2.2 Go to Command Line (UIDL) 2.2.3 Other Analysis Tools 2.2.4 Documentation 2.2.5 News 2.2.6 E-Mail 2.2.7 Shell to Operating System 2.2.8 Gopher 2.2.9 Report Problems or Comments 2.2.10 Help 2.3 SELECTING EXECUTIVE MENU ITEMS 2.4 GETTING AROUND IN TEXT SCREENS Figure 2.1 Excerpt from News screen 2.5 GETTING SCREEN HELP Figure 2.2 Excerpt from text viewing help screen 2.6 REFRESHING THE SCREEN Figure 2.3 Sample of system message overwriting an Executive screen 2.7 COPYING A TEXT SCREEN TO A FILE 2.8 EXITING THE EXECUTIVE Figure 2.4 CGIS exit screen 3 GETTING STARTED WITH THE CGIS SOFTWARE 3.1 USING UIMAGE Setting up Getting the data Getting information about the data Making the image larger Looking at the signal across a sky cut Making a PostScript hardcopy Printing the file 3.2 USING UIDL Setting up Getting the data Getting information about the data Looking at the map of a single frequency Making the image larger Looking at the signal across a sky cut Making a PostScript hardcopy Printing the file 4 UIMAGE 4.1 WHAT IS UIMAGE? Figure 4.1 A right T, or unfolded skycube Figure 4.2 A compact unfolded skycube, commonly called a sixpack 4.2 NAVIGATING THROUGH UIMAGE 4.2.1 Starting Up UIMAGE 4.2.2 Journaling 4.2.3 Reporting Problems or Comments 4.2.4 Getting into and back from UIDL 4.2.5 Exiting 4.2.6 Getting Help Figure 4.3 A typical VT240 UIMAGE help screen Figure 4.4 A typical X Window help screen 4.2.7 A Word on Terminology 4.3 GETTING DATA INTO AND OUT OF UIMAGE 4.3.1 Reading in COBE Data Sets 4.3.2 Reading in Arbitrary Archive Data Sets Table 4.1 Frequencies and their corresponding UIMAGE subscripts 4.3.3 Reading in IDL Save Sets 4.3.4 Reading in Data Sets from UIDL 4.3.5 Reading in FITS Files 4.3.6 Writing IDL Save Sets 4.3.7 Transporting Data into UIDL 4.3.8 Writing FITS Files 4.3.9 Associating a Weight with an Object 4.3.10 Combining 2-D Objects into a 3-D Object 4.3.11 Making Hardcopies 4.4 UIMAGE IMAGING AND ANALYSIS CAPABILITIES 4.4.1 VT240 or TEK emulation Users: Read This! 4.4.2 General Display Manipulations 4.4.2.1 Removing an Object 4.4.2.2 Removing ALL Objects 4.4.2.3 Displaying/hiding an Object [X] 4.4.2.4 Extracting a Face from a Skycube 4.4.2.5 Refreshing an Image [X] 4.4.2.6 Stretching the Image Contrast [X] 4.4.2.7 Changing Image Colors [X] 4.4.2.8 Putting a Label in a Window [X] Figure 4.5 Map Label window used to place labels on graphs or maps 4.4.2.9 Changing a Title 4.4.2.10 Resizing ALL Display Windows [X] 4.4.3 Displays and Manipulations for 3-D Objects 4.4.3.1 Displaying a Frequency Table 4.4.3.2 Extracting Frequency/Wavelength Slices 4.4.3.3 Displaying the Spectrum of a Single Pixel 4.4.3.4 Integrating over Frequencies/Wavelengths 4.4.3.5 Averaging Spectra in an Area [X] 4.4.4 Displays and Manipulations for 2-D Objects 4.4.4.1 Zooming [X] 4.4.4.2 Making Contour Maps 4.4.4.3 Making 3-D Surface Plots of 2-D objects [X] 4.4.4.4 Changing the Skycube to Another Projection 4.4.4.5 Overlaying a Coordinate Grid [X] 4.4.4.6 Creating a Cross Section 4.4.4.7 Obtaining Single Pixel Information 4.4.4.8 Calculating Statistics and Plotting Histograms 4.4.4.9 Getting Pixel Information from Graphs 4.4.4.10 Making Scatter Plots 4.4.4.11 Changing Image Resolution 4.4.4.12 Smoothing an Image 4.4.4.13 Displaying Images Using Histogram Equalization 4.4.4.14 Displaying Images Using Edge Enhancement 4.4.4.15 Marking Positions on a Map [X] 4.4.4.16 Adding a Colorbar to an Image [X] 4.4.5 Graph Display Manipulations 4.4.5.1 Changing Axis Ranges 4.4.5.2 Changing Axis Titles 4.4.5.3 Resizing a Graph [X] 4.4.5.4 Changing Plot Colors [X] 4.4.5.5 Overlaying Graphs 4.4.5.6 Changing a Graph's Scaling 4.4.6 Algebraic Operations 4.4.6.1 Using Binary Operations 4.4.6.2 Using Unary Operations 4.4.6.3 Using N-ary Operations 4.4.7 Modeling and Fitting 4.4.7.1 Subtracting a Dipole 4.4.7.2 Subtracting a Dipole + Quadrupole 4.4.7.3 Fitting to a Multiple Blackbody Model 4.4.7.4 Fitting to a Bose-Einstein + Blackbody Model 4.4.7.5 Modeling General Backgrounds 4.4.7.6 Fitting Polynomials to Graphs 4.4.7.7 Fitting to a Gaussian 5 UIDL 5.1 WHAT IS UIDL? 5.2 GETTING INTO UIDL 5.3 GETTING OUT OF UIDL 5.4 GETTING HELP IN UIDL 5.4.1 UHelp 5.4.1.1 View UIDL Routine List 5.4.1.2 Search List with a Keyword 5.4.1.3 Specify Routine Name 5.4.1.4 View User Library Routine List 5.4.1.5 COBE Help Tree 5.4.1.6 UIDL News 5.4.1.7 Getting Source Code (GETPRO) 5.4.1.8 HELP Table 5.1 UIDL HELP TREE CATEGORIES 5.4.1.9 Typical UHelp Text Window 5.4.2 Standard IDL Help 5.5 GETTING DATA INTO AND OUT OF UIDL 5.5.1 Transporting Data between UIMAGE and UIDL 5.5.1.1 Reading in UIMAGE Objects (UGETDATA) 5.5.1.2 Writing Data Sets to UIMAGE (UPUTDATA) 5.5.2 Reading COBE Data Products at the Command Line (DATAIN) 5.5.3 Importing and Exporting COBE IDL Save Sets (CISS) 5.5.3.1 Reading in COBE IDL Save Sets (RESTORE) 5.5.3.2 Writing IDL Save Sets (SAVE) 5.5.4 Reading in ASCII Files (READCOL) 5.5.5 Using FITS Files 5.5.5.1 Reading in FITS Files (READFITS) 5.5.5.2 Writing FITS raster files (WRITEFITS) 5.5.6 Reading in COBE Skymap Format Data (BUILDMAP) Figure 5.1 An unfolded skycube and an unfolded skycube packed into a sixpack 5.6 USING UIDL FOR COMMON ANALYSIS TASKS 5.6.1 Packing an Unfolded Skycube to Save Space (SIXPACK) 5.6.2 Unpacking a Packed Skycube (SIXUNPACK) 5.6.3 Building an Unfolded Skycube from Separate Faces (BUILDTEE) 5.6.4 Making Different Projections (REPROJ) 5.6.5 Adding Grids to Displays (PROJGRID) 5.6.6 Getting Data from Pixels (PIXINFO) [X] 5.6.7 Converting Coordinates (COORCONV) 5.6.8 Making PostScript Graphs and Images (PSIMAGE) 5.6.9 Fitting to a Multiple Blackbody Model (FITSPEC) 5.6.10 Fitting to a Bose-Einstein Model (FITMU) 5.6.11 Subtracting a Dipole and/or Quadrupole (DIPOLE/MULTIPOLE) 5.6.12 Modeling Backgrounds (MKBGRMOD) 5.6.13 Placing Labels on Images 5.6.13.1 MARKMAP 5.6.13.2 WINLABEL 5.7 EXAMPLES OF UIDL COMMAND SEQUENCES 5.7.1 Example One Bringing data into UIDL from UIMAGE Displaying the data Smoothing and reprojecting the data Flipping the data about the Galactic Center Overlaying contours on the original image Making a hardcopy of the composite image 5.7.2 Example Two Reading in the save set Reprojecting the data Storing the data into IDL variables Plotting the strips Writing the data to a rasterized FITS file 5.7.3 Example Three Reading in and displaying the data Reading in the coordinate file and precessing the coordinates Writing out the precessed coordinates Labeling coordinate locations with squares Printing the map with overlays 6 OTHER ANALYSIS TOOLS 6.1 IRAF 6.1.1 Entering IRAF 6.1.2 Exiting IRAF 6.1.3 Getting Help in IRAF 6.1.4 Canceling Commands in IRAF 6.2 SAOIMAGE 6.2.1 Entering SAOimage 6.2.2 Exiting SAOimage 7 TROUBLESHOOTING 7.1 I GOT DUMPED INTO UIDL FROM UIMAGE! 7.2 I HAVE TO FIND A KNOWLEDGEABLE PERSON! 7.3 I LOST MY CURSOR! 7.4 MY WORKSTATION MENU TURNED INTO JUST THE TITLE BAR! 7.5 MY WORKSTATION WINDOWS DO NOT HAVE FRAMES! 7.6 MY IMAGE DISAPPEARED! 7.7 I THOUGHT I DELETED THAT... Appendix A UIMAGE MENU TREE AND HELP FILES MAIN MENU DATA I/O AND MANAGEMENT DISPLAY MANIPULATION IMAGE ENHANCEMENT ALGEBRAIC IMAGE OPERATIONS SPECTRUM OPERATIONS LINE PLOTS AND STATISTICS MODELING AND FITTING Appendix B UIDL ROUTINES COBE Data Input General Data I/O Image and Plot Analysis Tools Utilities Appendix C HELP: VIEWING TEXT SCREENS (terminals only) Appendix D FIGURES Figure D-1. Graphs and 3-D Objects Figure D-2. 2-D Objects Figure D-3. Cross Sections/Sky Cuts Figure D-4. Zooming Figure D-5. Reprojections and Dipole Subtraction Appendix E FITS HEADERS FOR THE PROJECT DATA SETS Appendix F IDL USER LIBRARY ROUTINES Appendix G THE COBE SKYCUBE Figure G-1. COBE skycube, ecliptic coordinates Figure G-2. COBE skycube, galactic coordinates Figure G-3. COBE skycube, resolution 6 pixel numbering Figure G-4. COBE skycube, resolution 9 pixel numbering Index