Version 3.1 March 1993 HST Archive Manual This document was prepared by the Space Telescope Science Institute under U.S. Government contract NAS5-26555. Users shall not, without prior written permission of the U.S. Government, establish a claim to statutory copyright. The Government and others acting on its behalf, shall have a royalty-free, non- exclusive, irrevocable, worldwide license for Government purposes to publish, distribute, translate, copy, and exhibit such material. Send comments or corrections to: Stefi Baum, SCARS Space Telescope Science Institute 3700 San Martin Drive Baltimore, Maryland 21218 E-mail: sbaum@stsci.edu Operated by the Association of Universities for Research in Astronomy, Inc., for the National Aeronautics and Space Administration Data Systems Operations Branch Science Computing and Research Support Division 3700 San Martin Drive Baltimore, Maryland 21218 Table of Contents Chapter 1: Overview of the HST Archive 1 Chapter 2: Support for Archival Research at STScI 3 Chapter 3: Getting Started On the HST Archive System 7 Logging In 7 Logging Out 8 Reading the Archive News 8 Available Commands 8 Guest Users 9 Logging In 9 Registering as a User 10 Using STARCAT 11 Reading Text Files in the Documents Directory 12 Manuals 12 Forms 12 Info 13 Exposure Catalogs 13 Help 14 Chapter 4: A STARCAT Cookbook 15 Typical STARCAT Session 16 Logging In 16 The Banner Screen 17 Basic Commands 18 Choosing Menu Options 18 Refreshing the Screen Display 18 Selecting Screens 19 STARCAT Structure 20 Moving Through Screen Levels 21 Data Screens 24 Defining Search Criteria 26 Qualifying Fields 26 Sample Qualifying Step 28 Scanning the Data Base 30 Proprietary Rights 31 Retrieving Files From the Archive 31 Marking Records 31 Building a List of Files for Retrieval 32 Choosing a Retrieval Mode 34 Editing the File Retrieval List 35 Submitting the Request 35 Checking the Status of Your Request 37 Data Retrieved Via LAN 37 Converting File Formats 38 VAX2SUN 38 Writing FITS Files 39 Using FTP 41 Now That You Have Your Data... 43 Documentation on the Telescope and Instruments 43 Getting STSDAS 44 Learning and Using STSDAS 44 Selecting Files and Data Retrieval Mode 45 Getting Help Within STARCAT 48 Pop-Up Keyboard Help 48 On-Line Help 49 Data Screen Documentation 49 Sending Feedback to STScI 50 Chapter 5: Tutorial: Sample Archive Session 51 Chapter 6: Archive Search Strategies 61 Planned Versus Executed Information 61 Choosing the Right STARCAT Screen 62 GENERAL Screen 62 PRE-OBS MENU 63 POST-OBS MENU 63 TARGETS 63 INSTRUMENTS 64 ENGINEERING 64 ARCHIVE 64 ADMIN 64 Search Strategies 65 Overview 65 Searching for Specific Sources 65 Searching for a Class of Object 69 Assessing Data Quality 77 PODPS Data Quality Keyword and Comments 78 The PDQ Files 79 OSS Observer Comment Files 80 Exposure Flag 80 Fine Guidance System Lock 81 The AEC and the EC 82 Chapter 7: Advanced Topics 85 About Modes... 85 Menu Mode 86 Prompt Mode 86 Readfile Mode 86 Searching an Area Around a Centered Position 89 Table-Row Format 90 Creating User-Defined Screens 91 Using Output Files 94 ASCII Text 95 Example of Creating ASCII Output File 96 FITS 97 MIDAS 97 LaTeX 98 Retrieving Files from a List of Datasets 98 Modifying STARCAT-Created SQL Queries 99 SQL 101 Chapter 8: STARCAT Commands 103 Banner Commands 103 Menu Commands 104 Data Screen Commands 106 Retrieve Screen Commands 108 Table (List) Format Screen Commands 108 Personal Screen Creation Commands 110 Output File Specification Commands 111 Utilities Screen Commands 112 Chapter 9: HST Catalog Screens 113 Pre-Obs Screens 114 ABSTRACTS_SHORT 115 ABSTRACTS_LONG 116 EXP_CAT 117 OBS 119 GTO-GO 121 OPPARM 123 PROP 124 PROP-OBS 126 USERS-EXP-INFO 128 Post-Obs Screens 130 EPHEMERIS 130 EXP 131 GENERAL 133 PDQ 135 Planned-vs-Done 136 Instruments Screens 138 FGS 139 FOC 141 FOS 143 FOS2 145 GHRS 146 HSP 148 WFPC 150 Targets Screens 152 FIXTARG 152 SS_TARG 154 TARGFLUX 155 TARGSEARCH 156 Engineering Screens 158 RTA 158 REC_ENG 160 ENG_SUB 162 OPPARM 164 SMS 165 MS 166 MAN_VER_DATA 168 GS_DATA 170 OBC_DUMP 172 DUMP_EXT 174 Archive Screens 175 DSNAME 175 FILES 177 Chapter 10: Data in the HST Archive 179 Overview 179 Files and Archive Classes 181 File Names 181 Science Files 182 GEIS Files 182 Common Extensions for Instrument Data Files 183 Non-Science Data Files 188 Unidentified Instrument Data 188 Dump Data Files 188 Science Instrument Engineering Data Files 189 Engineering Subset Data Files 190 Guide Star Position Data Files 190 Common Extensions for Non-Science Data Files 191 Chapter 11: DMF Database Structure 193 EXP 194 OBS 196 PROP 199 PEPSI 200 DSNAME 201 FILES 202 Appendix A: Forms 203 HST Archive Account Registration 204 HST Archival Data Request 205 HST Archival Research Visit Request 206 Index 207