Äîêóìåíò âçÿò èç êýøà ïîèñêîâîé ìàøèíû. Àäðåñ îðèãèíàëüíîãî äîêóìåíòà : http://www.stsci.edu/ftp/documents/p2pi/p2pi_160.pdf
Äàòà èçìåíåíèÿ: Fri May 23 00:18:40 2008
Äàòà èíäåêñèðîâàíèÿ: Sat Sep 6 04:53:19 2008
Êîäèðîâêà:

Ïîèñêîâûå ñëîâà: reflection nebula
Version 16.0 April 3, 2007

HST Phase II Proposal Instructions for Cycle 16

Operations and Data Management Division 3700 San Martin Drive Baltimore, Maryland 21218 help@stsci.edu

Operated by the Association of Universities for Research in Astronomy, Inc., for the National Aeronautics and Space Administration


Revision History
Version 16.0 Type GO Date April 2007 Editor Jim Younger Initial release for Cycle 16

Version 16.0 is issued in coordination with the APT release and is intended to be fully compliant with Cycle 16 APT. Shelf life: This version should not be used after September 1, 2007 without checking for a more recent version

This is the General Observer version. If you would like some hints on how to read and use the PDF document, click on: Some Pointers in PDF and APT JavaHelp

How to get help
1. Visit STScI's Web site: http://www.stsci.edu/

where you will find resources for observing with HST and working with HST data.
2. Contact your Program Coordinator (PC) or Contact Scientist (CS) you have

been assigned. These individuals were identified in the notification letter from STScI.
3. Send e-mail to help@stsci.edu, or call 1-800-544-8125.

From outside the United States, call 1-410-338-1082.


Table of Contents
HST Phase II Proposal Instructions for Cycle 16
Part I: Phase II Proposal Writing
1.1 1.2 1.3 1.4 1.5 1.6
................................. 1 .................... 3 4 4 4 5 5 6

Chapter 1: About This Document

Document Design and Structure ............................... Changes Since the Previous Version ....................... Document Presentation ............................................... Technical Content ......................................................... Where to Find Additional Information ....................... Some Pointers in PDF and APT JavaHelp .............

Chapter 2: The Basics of Phase II Proposals............................................................................................ 9
2.1 How to Prepare and Submit Phase II Information ......................................................................... 9
2.1.1 Astronomer's Proposal Tool (APT) ............................. 9 2.1.2 Entering Information: The APT Graphical User Interface (GUI) versus the Text Proposal File .............................. 10 2.1.3 APT Tools ................................................................. 11 2.1.4 Submitting Your Program ......................................... 12 2.2 What to Submit ............................................................ 12 2.3 General Instructions ................................................... 13 2.3.1 Proposal Information [Proposal_Information] ........... 13 2.3.2 Proposal Description................................................. 15 2.3.3 Investigators ............................................................. 16 2.3.4 Target Information [Fixed_Targets,
iii


iv

Solar_System_Targets, Generic_Targets] .................... 2.3.5 Visit Information [Visits] ............................................ 2.4 Examples and General Advice................................. 2.4.1 Acquisitions and Pointings ........................................ 2.4.2 Examples .................................................................. 2.4.3 Common Problems ................................................... 2.4.4 Consideration of Limited Resources ......................... 2.5 Text Proposal File ...................................................... 2.5.1 Basic Syntax Rules ................................................... 2.5.2 Sample Text Proposal File Template........................

17 17 17 17 18 19 19 21 21 21

Chapter 3: Fixed and Generic Targets

....... 25

3.1 Target Number [Target_Number] .......................... 27 3.2 Target Name [Target_Name and Alternate_Names] ........................................................ 27
3.2.1 3.2.2 3.2.3 3.2.4 Catalog Name ........................................................... Uncataloged Targets ................................................ Common Names ....................................................... Special Targets ......................................................... 28 29 30 30

3.3 Target Category and Target Description [Description] .................................................................. 31 3.4 Target Position Type[Position] ............................... 36
3.4.1 Required Accuracies of Target Positions.................. 36 3.4.2 Equatorial Coordinates ............................................. 38 3.4.3 Positional Offsets ...................................................... 39 3.4.4 Region of Sky (Extended Targets)............................ 41 3.4.5 Determining Coordinates in the Guide Star Selection System (GSSS) Reference System .............................. 42 3.4.6 A Caution on Astrometry Prepared from STScI Plate Scans ............................................................................ 44 3.4.7 Early Acquisitions ..................................................... 45 3.5 Equinox for Coordinates [Equinox] ......................... 45

3.6 Coordinate Reference Frame [Reference_Frame]........................................................ 45 3.7 Radial Velocity or Redshift [RV_ or _Z] ................ 46 3.8 Is Proper Motion or Parallax Relevant? ................. 46
3.8.1 Proper Motion and Parallax Data.............................. 3.9 Flux Data [Flux and Other_Fluxes] ...................... 3.9.1 General Guidelines on What Flux Data to Include.... 3.10 Bright-Object Constraints ........................................ 46 47 48 51


v

3.11 Comments [Comments] ......................................... 52 3.12 Generic Targets List [Generic_Targets] ............ 53
Target Number(s) [Target_Number] ....................... Target Name [Target_Name] .................................. Target Description [Description] ............................. Flux Data [Flux]....................................................... Comments [Comments] .......................................... Generic Target Specifications [Criteria} .................. 3.13 Getting Coordinates Coordinated ......................... 3.12.1 3.12.2 3.12.3 3.12.4 3.12.5 3.12.6 53 53 54 54 54 54 56

Chapter 4: Solar System Targets
4.1 4.2 4.3 4.4 Target Target Target Target

................... 59 61 62 64 65 67 69 75 75 76 76 81 82 84 84 85

Number [Target_Number] .......................... Name [Target_Name] .................................. Description [Description] ............................ Position .............................................................

4.4.1 Target Position Level 1 [Level_1] ............................. 4.4.2 Target Position Level 2 [Level_2] ............................. 4.4.3 Target Position Level 3 [Level_3] ............................. 4.5 Ephemeris Uncertainty [Ephem_Uncert] ............. 4.6 Acquisition Uncertainty [Acq_Uncert] ................... 4.7 Observing Windows [Windows] ............................. 4.7.1 Default Target Windows ........................................... 4.8 Flux Data [Flux and Other_Fluxes] ...................... 4.9 Comments [Comments] ........................................... 4.10 Illustrations of Orbital Longitude ............................ 4.11 Examples of Target List Blocks .............................

Chapter 5: Visits, Exposures and Exposure Groups .................................................................
5.1 Visit Number and Status .......................................... 5.2 Visit Priority [Visit_Priority] ........................................ 5.3 Visit-level Special Requirements [Visit_Requirements] .................................................. 5.4 On Hold Comments [On_Hold_Comments] ....... 5.5 Visit Comments [Visit_Comments] ....................... 5.6 Exposure Number [Exposure_Number] ..............

89 91 92 92 93 93 94


vi

5.7 Exposure Label [Exposure_Label] .......................... 94 5.8 Target Name [Target_Name] ................................... 94
5.8.1 Astronomical Targets ................................................ 5.8.2 Special Targets ......................................................... 5.9 Instrument Configuration [Config] .......................... 5.10 Operating Mode [Opmode].................................... 5.11 Aperture or Field of View [Aperture] ................... 5.12 Spectral Element [Sp_Element].......................... 95 95 95 96 96 96

5.13 Central Wavelength or Range if Grating or Prism Used [Wavelength] ....................................................... 97 5.14 Number of Times to Iterate the Exposure [Number_of_Iterations].............................................. 97 5.15 Time per Exposure [Time_Per_Exposure] ....... 98 5.16 Exposure-level Comments [Comments] ............ 99 5.17 Optional Parameters[Optional_Parameters] ...... 99 5.18 Exposure-level Special Requirements[Special_Requirements]................................. 99 5.19 Exposure Containers: Exposure Groups, Coordinated Parallels and Patterns ..................................... 100 5.20 Subexposures .......................................................... 101
5.20.1 Actual_Duration .................................................... 101 5.20.2 Orbit_Number ....................................................... 101

Chapter 6: Parallel Science Exposures

.. 103

6.1 Parallel Science Limitations .................................... 104 6.2 Pure Parallels ............................................................. 105 6.3 Coordinated Parallel Containers............................ 107
6.3.1 6.3.2 6.3.3 6.3.4 6.3.5 6.3.6 Instrument Configuration ........................................ Targets.................................................................... Special Requirements............................................. Optional Parameters ............................................... Ordering Restrictions and Interpretations ............... Efficiency Considerations ....................................... 108 108 109 110 111 111


vii

Chapter 7: Special Requirements [Visit and Exposure Special_Requirements] ...................................

113

7.1 Introduction to Special Requirements: Syntax and Rules ......................................................... 114 7.2 Visit-level Special Requirements ........................... 117
Guiding ................................................................... Target Orientation ................................................... Special Observation Requirements ........................ Timing Requirements.............................................. Conditional Requirements ...................................... 7.3 Exposure-level Special Requirements ................. 7.3.1 Target Acquisition ................................................... 7.3.2 Target Position........................................................ 7.3.3 Special Observation Requirements ........................ 7.3.4 Special Communications Requirements ................. 7.3.5 Timing Requirements.............................................. 7.2.1 7.2.2 7.2.3 7.2.4 7.2.5 117 120 130 131 134 135 135 136 138 139 141

Chapter 8: Pointings and Patterns

.............. 145

8.1 Pointing the Telescope ............................................ 145 8.2 Introduction to Patterns............................................ 145
8.2.1 APT User Interface ................................................. 8.2.2 Text Proposal File ................................................... 8.3 How to Fill Out the Pattern Parameters Form .... 8.3.1 Pattern Parameters................................................. 8.4 Convenience Patterns .............................................. 8.4.1 WFPC2 Patterns ..................................................... 8.4.2 ACS Patterns (HRC and WFC unavailable for Cycle 16) ...................... 8.4.3 NICMOS Patterns ................................................... 146 147 148 149 152 153 155 160

Part II: Supported Science Instruments

............ 169

Chapter 9: Wide Field Planetary Camera 2 (WFPC2) ......................................................................... 171
9.1 Introduction to WFPC2............................................. 172 9.2 Mode = IMAGE


viii

Config = WFPC2 .......................................................... 173
Aperture or FOV ..................................................... Spectral Elements................................................... Wavelength ............................................................. Optional Parameters ............................................... Number of Iterations ............................................... Time Per Exposure ................................................. 9.3 Tabular Reference Data .......................................... 9.4 WFPC2 Aperture Coordinate System .................. 9.2.1 9.2.2 9.2.3 9.2.4 9.2.5 9.2.6 174 175 175 176 177 177 178 182

Chapter 10: Fine Guidance Sensors (FGS) ................................................................................

183

10.1 Introduction to the FGS ......................................... 184 10.2 Mode = POS Config = FGS ................................................................ 185
10.2.1 10.2.2 10.2.3 10.2.4 10.2.5 Aperture or FOV ................................................... Spectral Element .................................................. Optional Parameters ............................................. Special Requirements........................................... Time Per Exposure ............................................... 185 186 186 187 188

10.3 Mode = TRANS Config = FGS ................................................................ 188
Aperture or FOV ................................................... Spectral Element .................................................. Optional Parameters ............................................. Time Per Exposure ............................................... Special Requirements........................................... 10.4 Tables and Illustrations ......................................... 10.3.1 10.3.2 10.3.3 10.3.4 10.3.5 188 188 189 189 189 190

Chapter 11: Advanced Camera for Surveys (ACS) .................................................

193

11.1 Introduction to the ACS ......................................... 194 11.2 Mode = ACCUM Config = ACS/WFC(Unavailable for Cycle 16) ........ 195
11.2.1 11.2.2 11.2.3 11.2.4 Aperture or FOV ................................................... Spectral Element .................................................. Wavelength ........................................................... Optional Parameters ............................................. 196 196 197 197


ix

11.2.5 Number of Iterations ............................................. 198 11.2.6 Time Per Exposure ............................................... 198

11.3 Mode = ACCUM Config = ACS/HRC (Unavailable for Cycle 16) ....... 198
11.3.1 11.3.2 11.3.3 11.3.4 11.3.5 11.3.6 Aperture or FOV ................................................... Spectral Element .................................................. Wavelength ........................................................... Optional Parameters ............................................. Number of Iterations ............................................. Time Per Exposure ............................................... 199 199 200 200 201 201

11.4 Mode = ACQ Config = ACS/HRC (Unavailable for Cycle 16) ....... 203
11.4.1 11.4.2 11.4.3 11.4.4 11.4.5 11.4.6 Aperture or FOV ................................................... Spectral Element .................................................. Wavelength ........................................................... Optional Parameters ............................................. Number of Iterations ............................................. Time Per Exposure ............................................... 203 203 203 203 204 204

11.5 Mode = ACCUM Config = ACS/SBC ...................................................... 204
Aperture or FOV ................................................... 204 Spectral Element .................................................. 204 Wavelength ........................................................... 204 Optional Parameters ............................................. 205 Number of Iterations ............................................. 205 Time Per Exposure ............................................... 205 11.6 Tabular Reference Data ........................................ 205 11.6.1 Spectral Elements for WFC and HRC .................. 205 11.6.2 Ramp Filter Wavelength Ranges .......................... 209 11.6.3 Spectral Elements for ACS/SBC........................... 209 11.6.4 Allowed Combinations of Aperture, Spectral Element & Readout ................................................................... 210 11.7 ACS Aperture Coordinate System ...................... 211 11.5.1 11.5.2 11.5.3 11.5.4 11.5.5 11.5.6

Chapter 12: Near Infrared Camera and Multi-Object Spectrometer (NICMOS) ......................................................................

213

12.1 Introduction to NICMOS ........................................ 214 12.2 Mode = ACCUM


x

Config = NIC1 or NIC2 or NIC3 ................................ 215
12.2.1 12.2.2 12.2.3 12.2.4 12.2.5 12.2.6 12.2.7 Aperture or FOV ................................................... Spectral Elements................................................. Wavelength ........................................................... Optional Parameters ............................................. Number of Iterations ............................................. Time Per Exposure ............................................... Special Requirements........................................... 216 216 216 216 217 217 218

12.3 Mode = MULTIACCUM Config = NIC1 or NIC2 or NIC3 ................................ 218
12.3.1 12.3.2 12.3.3 12.3.4 12.3.5 12.3.6 12.3.7 Aperture or FOV ................................................... Spectral Elements................................................. Wavelength ........................................................... Optional Parameters ............................................. Number of Iterations ............................................. Time Per Exposure ............................................... Special Requirements........................................... 218 218 218 218 220 220 220

12.4 Mode = ACQ Config = NIC2 ............................................................... 223
Aperture or FOV ................................................... Spectral Elements................................................. Wavelength ........................................................... Optional Parameters ............................................. Number of Iterations ............................................. Time Per Exposure ............................................... Special Requirements........................................... 12.5 Tabular Data ............................................................ 12.5.1 TPG_TIME Values ................................................ 12.5.2 NICMOS Apertures ............................................... 12.5.3 NICMOS Spectral Elements ................................. 12.6 Illustrations ............................................................... 12.4.1 12.4.2 12.4.3 12.4.4 12.4.5 12.4.6 12.4.7 223 223 223 223 223 223 224 224 224 225 226 229

Index

...................................................................................... 235


PART I:

Phase II Proposal Writing
The chapters in this section explain how to use the Phase II Instructions, how to fill out your Phase II information file and submit it to STScI. It also explains where to go for help and describes the information that must be submitted to STScI by GOs and GTOs during Phase II. Chapter 1: About This Document / 3 Chapter 2: The Basics of Phase II Proposals / 9 Chapter 3: Fixed and Generic Targets / 25 Chapter 4: Solar System Targets / 59 Chapter 5: Visits, Exposures and Exposure Groups / 89 Chapter 6: Parallel Science Exposures / 103 Chapter 7: Special Requirements Special_Requirements] / 113 Chapter 8: Pointings and Patterns / 145 [Visit and Exposure

1


2


CHAPTER 1:

About This Document
In this chapter. . .
1.1 Document Design and Structure 1.2 Changes Since the Previous Version 1.3 Document Presentation 1.4 Technical Content 1.5 Where to Find Additional Information 1.6 Some Pointers in PDF and APT JavaHelp / / / / / / 4 4 4 5 5 6

Proposals to observe with Hubble Space Telescope (HST) are reviewed in two phases managed by the Space Telescope Science Institute (STScI). In Phase I, proposers submitted an Observation Summary for review by the Telescope Allocation Committee (TAC). The Observation Summary provides only general descriptions of the targets and of the proposed observations. The TAC review results in a list of accepted proposals. During Phase II, General Observers (GOs) with accepted proposals, as well as Guaranteed Time Observers (GTOs), must provide complete details of their proposed observations so that STScI can conduct a full technical feasibility review. The Phase II information will then be used to schedule the actual observations and obtain data. This document, the Phase II Proposal Instructions, has the following purposes: · To describe the information that must be submitted to STScI by GOs and GTOs during Phase II. · To describe what you have to provide in APT (Astronomer's Proposal Tool). · To show how to submit the information to STScI. Readers of this document should be familiar with the Cycle 16 Call for Proposals, issued in October 2006, and with the Instrument Handbooks.

3


4

Chapter 1: About This Document

Note on colors in the GO Version: Blue text shows active external references and cross-references to other parts of this document. Brown text pertains to use of the Text Proposal File.

1.1 Document Design and Structure
These Instructions are meant to be read on-line, although many readers may wish to print selected portions. Many cross-references have been added to make navigation easy and convenient. A comprehensive table of contents allows you to go directly to chapters, sections and subsections. Each chapter starts with a listing of sections and subsections, each linked to its page. Near the beginning of most chapters, a list of figures and tables is provided; this list is cross-referenced for convenient navigation to a particular item you may wish to examine. Also, an index has been provided.

1.2 Changes Since the Previous Version
Initial Release for Cycle 16. Significant changes include: · ACS HRC and WFC are not available · A new proposal type, GO/SURVEY has been added

1.3 Document Presentation
Navigation Cross-references and external references highlighted in blue can be accessed by clicking on the item. Text Proposal File Instructions Sections and text in brown have been added for those proposers who elect to export, and then edit their proposal in a Text Proposal File. For


Technical Content

5

guidelines on when you might use this template, see "Using the Text Proposal File" in Chapter 2. Available Formats Proposers can access this information in two formats: PDF via the Web and Sun JavaHelp via the Astronomer's Proposal Tool (APT). · The PDF version available on the Web will be the only one that you can be certain is up-to-date. It can be downloaded and printed if you wish, and when used on-line provides "instant" access to internal and external cross-references. · The JavaHelp version available in APT should not be printed due to the limitations of printing in Java. You can use the internal cross-references, but the external references in JavaHelp have been disabled. Reader Feedback We have striven to present this critical, detailed, and complex information in a form that allows it to be used accurately and effectively. Your comments on its good and bad qualities will help us in the future; send e-mail to help@stsci.edu.

1.4 Technical Content
Available Science NICMOS, WFPC2 and the side 2 electronics in Cycle 16 (see ACS Web Instruments for Cycle 16 FGS are available in Cycle 16. Due to a failure in January 2007 , only the ACS SBC is available for Site).

Instrument Modes, Special Requirements, etc. Some changes have been made to these Instructions since the previous version to correct errors and omissions, and to document new modes or options. There are too many to list, but as long as you use the most recent version the information provided should reflect our current state of knowledge.

1.5 Where to Find Additional Information
As you write your Phase II proposal, you will probably need to consult the Instrument Handbooks for additional information on one or more Science Instruments. These handbooks are available on the Web in both PDF and


6

Chapter 1: About This Document

HTML versions at http://www.stsci.edu/hst/HST_overview/documents There are some policies that were delineated in the Call for Proposals, which asked for Phase I proposals. You may wish to review those, particularly the sections discussing limited resources.

1.6 Some Pointers in PDF and APT JavaHelp
PDF Online and Print Adobe's Portable Document Format (PDF) is the standard for the commercial sector because it is easily produced with modern documentation software and has many excellent features. If you're new to PDF here are some hints that you may find useful: · PDF has links, just like HTML. Anything in blue in this document is a link you can click on to go somewhere else. · PDF can print selected pages. Note that the page numbers you enter are PDF's sequential numbers (look at the bottom of the Acrobat window to see where you are). · PDF is searchable with most viewing software such as Adobe's Reader and Apple's Preview. · You can move up or down page by page using the scroll bar on the right of your Acrobat window; just click above or under the indicator that shows your relative position. You can also click and hold on this indicator to speed through the document. · If you wish to save this document as a PDF file on your local machine, click with your right mouse button on the Institute's Web page that has the Phase II information at the spot where you link to the PDF file. In other words, your left button opens the file in Acrobat, but the right button lets you save the file if you pull down to "Save Link as." · Look at Acrobat's help facility (the help button is in the upper right corner of the Acrobat window) for more pointers. APT JavaHelp The Astronomer's Proposal Tool (APT) user interface provides access to this document via Sun JavaHelp -- a help format specifically designed for Java-based applications. · The internal cross-references are linked (in blue), but all external references have been disabled.


Some Pointers in PDF and APT JavaHelp

7

· The JavaHelp viewer provides access to a table of contents and an index; all the listed items are linked to the referenced sections. Once you are in a document, you can use the table of contents, the index, or the cross-references in the text to navigate to other parts of the document as you would in html. · JavaHelp has a very useful search utility. · Some of the sections in the Phase II Instructions are used for "context-sensitive" help in APT. At the top of the APT user interface, click on the "Help" menu item for access to this document and instructions on how to use the context-sensitive help. We welcome your comments and thoughts for improving how we provide information to you.


8

Chapter 1: About This Document


CHAPTER 2:

The Basics of Phase II Proposals
In this chapter . . .
2.1 How to Prepare and Submit Phase II Information 2.2 What to Submit / 2.3 General Instructions / 2.4 Examples and General Advice / 2.5 Text Proposal File / /9 12 13 17 21

2.1 How to Prepare and Submit Phase II Information
The computer software used to schedule and execute HST observations can interpret the proposal information only if it is in the proper format. Therefore, proposals must be filled out accurately, completely, and in strict accordance with the instructions in this document. Observers now have the capability and responsibility, with the help of their Program Coordinator (PC) and/or Contact Scientist (CS) for creating and submitting proposals that are not only syntactically correct but also feasible and schedulable. The Astronomer's Proposal Tool (APT) will help you achieve this.

2.1.1 Astronomer's Proposal Tool (APT)
With APT you can prepare your Phase II program on your computer and then submit it electronically to STScI. You will use a copy of your Phase I proposal (marked up in XML), which contains all the information from your Phase I submission. If you haven't done so already, please consult the APT Web Page for detailed instructions on how to install and use APT on

9


10

Chapter 2: The Basics of Phase II Proposals

your computer. Observers without access to a suitable computer platform to run APT for Phase II should contact their PC.

2.1.2 Entering Information: The APT Graphical User Interface (GUI) versus the Text Proposal File
In the previous proposal entry system, RPS2, you could enter and edit information as text (usually in the form =) using a template and your favorite text editor. Also, you could use the Proposal Editor (PED), a graphical editor in RPS2 designed for editing your Phase II program. In APT you can enter proposal information by using either the APT Form/Spreadsheet Editors via a GUI or a Text Proposal File that employs a "simplified" RPS2 syntax. This text file has been developed for APT as an alternative method for editing proposals outside of the APT GUI; you use a flat ASCII file format that is similar to the RPS2 .prop file that was used in HST cycles 5-11. Small changes to the original RPS2 format were necessary to accommodate enhancements that came with APT, and some of the syntax has been made stricter in order to make reading of the file more robust. You create this file in APT by exporting your proposal into a text proposal file format (for details please see the APT Web Page). Using the APT GUI In most of the fields in the APT graphical interface, you choose a keyword or parameter in a list from a pull-down menu, or check a box. In a few other fields (e.g., Other Fluxes, Observing Windows and Criteria in the Targets forms) you enter free text in the field using the formats specified in this document. Required items are marked with a red "x" if you haven't selected or entered a . Also, for many of the keywords, a tooltips message will appear when you place your pointer on the keyword: area. Using the Text Proposal File When creating or editing large repetitive proposals, editing with APT's graphical interface can be inefficient and prone to error. We present two examples where you may want to use a text proposal file.
1. You are building a large repetitive program with many targets and

visits in order to create a mosaic. Initially, you would use APT to build a proposal that has one or two targets and one of each of the unique visits. You would then run the Orbit Planner and Visit Planner to make sure that the visits fill the right number of orbits and schedule. Then, you would export this small template proposal to the Text Proposal File format, and use scripts or your favorite editor to build your program into a larger version. You would then import the resulting file back into APT for checking and processing.


How to Prepare and Submit Phase II Information

11

2. You have already built a fairly large program in APT by creating

unique exposures and visits, and then used the duplicate and multiple duplicate features in APT. Then, you discover that you need to make a small change to a large number of exposures (such as removing or adding an optional parameter). This would be tedious to do in the APT GUI, but straightforward in the Text Proposal File. Simply export your program to the Text Proposal File format, make your changes in an editor, and then import the Text Proposal File back into APT for new processing. Table 2.1 summarizes some of the differences between the APT GUI and the Text Proposal File.
Table 2.1: Comparison of APT GUI and the Text Proposal File
Data Entry Method APT Use the Form or Spreadsheet Editors via the APT User Interface Syntax For most of the fields (exceptions noted below1), choose a keyword from a pull-down list, or check a checkbox, or enter a text in the field provided. Enter free text in the file in the form =. You must conform to the proper syntax described in this document. Help Features and Error Checking 1) Required data marked with a red x 2) Tooltips (e.g., a message noting a required item and its format) provided during data entry 3) Context-sensitive help available None while editing. After editing your proposal, you must import it back into APT (see the APT Web page for instructions). Once you have imported your program back into APT you can run the diagnostics tool.

Text Proposal File

After exporting your proposal from APT to the text file, edit it using your favorite editor.

1. The exceptions are: - Other Fluxes field for all types of Targets - Criteria field for Generic Targets In these fields you must enter text (, and any separators) exactly as described in the relevant sections of this document.

2.1.3 APT Tools
APT also provides tools to help you plan your observations, such as an Aladin based visualization tool, an Orbit Planner and a Visit Planner (see the Using APT web page). If you have any problems using APT, or have any questions about your proposal, please feel free to contact your assigned Program Coordinator (PC) and/or Contact Scientist (CS). Programs without an assigned CS may also contact help@stsci.edu for help with APT.


12

Chapter 2: The Basics of Phase II Proposals

2.1.4 Submitting Your Program
After you submit your Phase II program, the APT system will give you an automatic electronic acknowledgment. This should be followed in a few days by an acknowledgment from your PC. If, at the time of submission, the proposal contains errors, the APT submission system will give a warning, but will allow the proposal to be submitted. However, the proposal will be flagged, and your PC will contact you within a few days to discuss how to proceed.

The resolution of errors in the Phase II Program is the responsibility of the Principal Investigator. The fact that APT may allow you to submit a program that contains errors does not mean that your program can or will be scheduled. We strive to make APT a useful aid for preparing and checking your Phase II program, but it is nevertheless imperfect. On rare occasions syntax errors are not detected. Also, APT does not check for guide stars.

2.2 What to Submit
Observers must submit their Phase II proposal to STScI by the Phase II deadline. It should contain the following: · Updated Proposal Information: This section includes the title, the abstract, a Phase II ID, a proposal description, PI and CoI information. Please note that some general information is very useful for a thorough and helpful technical review of your proposal. You may wish to include parts of your Phase I science discussion, but please note that all the Phase II information you provide will be freely available via the Web. · Target Information: The information for one or more of the Fixed, Solar System, or Generic Targets must be completed. If necessary, proper motion and parallax information should be supplied for fixed targets. Detailed instructions for filling out the target data, as well as the proper motion and parallax information, are provided in Chapter 3: Fixed and Generic Targets on page 25 and Chapter 4: Solar System Targets on page 59 of this document.


General Instructions

13

· Visit, Exposure Group, and Exposure Specifications: These specifications include orientation information, scheduling requirements, SI information, exposure special requirements and so on. Required items will be clearly noted as you complete the specifications. General instructions for completing this section are provided in Chapter 5: Visits, Exposures and Exposure Groups on page 89 of this document.

2.3 General Instructions
When you first bring up APT, you will have to convert the information in your Phase I proposal, which is an XML file, into a Phase II program format using the "Phase I->Phase II" conversion button on the APT User Interface. Note the following general instructions and conventions when entering your Phase II information: · After converting your Phase I Proposal into Phase II information, please verify that all the general information is correct and readable. · Entries in text must precisely conform to the formats specified in this document. If you have decided to use the Text Proposal File, the order of the entries must be correct as well (see Section 2.5 on page 21). · Proposal data text may contain only standard ASCII characters. All other symbols must be spelled out. Greek letters must be spelled out (e.g. BETA-LYR, H-ALPHA). The degree sign should be replaced with "D" (e.g. BD+16D516). Subscripts and superscripts are not allowed. · Additional information not covered by the keywords and values already provided may be entered in the "Additional Comments" or "Comments" boxes. · When providing a Target "Description" please use the target keywords and syntax presented in Tables 3.2 to 3.10 and Table 4.2. If you are unable to use the APT software, please contact your PC (listed in your notification letter) to make other arrangements.

2.3.1 Proposal Information [Proposal_Information]
This block contains basic information about the proposal including the Title, Abstract, Category, and Cycle. After converting your proposal from


14

Chapter 2: The Basics of Phase II Proposals

Phase I to Phase II, your Phase II program will have the program information filled out based on your Phase I submission. Proposal Title Abstract The Abstract from your Phase I submission has been included in your Phase II information. Please check this since you may need to update this text based on your final TAC allocation. If a Phase II submission is not based on a Phase I proposal, please fill in missing information. Phase II ID This ID will be provided to you by your Program Coordinator. STScI Edit Number This field holds a counter for an operational version number of the proposal and cannot be edited by the user. If you are connected to the internet, the version number in your proposal file is compared to the one in the STScI proposal database when a proposal is opened or submitted. In either case, if your file's version number is less than the database's number for that proposal, you will get a pop up warning that a more recent version is available (via APT's Retrieve from STScI). This prevents you from doing an update with an old copy of the proposal, or making edits to a version that does not include changes your PC has made to the proposal.The STScI software increments this number whenever the Phase II file is edited by STScI staff. Proposal Cycle Unless you have been told otherwise, the Cycle should be 16. Multiple values of Cycle are not permitted. Proposal Category For those Phase II submissions that are not based on a Phase I proposal, the Category should be selected from one of the following:
GO (General Observer) GO/DD (Director's Discretionary time)

GO/SURVEY (GO Survey Programs) SNAP (snapshot proposals) GTO (Guaranteed Time Observer)

A Category of SNAP is used for "snapshot" programs. By their nature these programs take advantage of otherwise-unused blocks of telescope


General Instructions

15

time for relatively short exposures. SNAP exposures therefore must carry as few restrictions as possible. In particular, Special Requirements should not ordinarily be used with SNAP programs (consult with your Program Coordinator if you feel you need to do so). Some special policies apply to SNAP programs: in particular, STScI will not repeat failed SNAP exposures. Starting with Cycle 16 a GO/SURVEY Category has been created as an alternative option for programs that are statistical in nature. These proposals are like SNAP programs in that they have a large pool of candidate targets from which a subset will be observed. As in all GO programs, GO/SURVEY programs have been assigned a specific number of orbits, but specific targets are not guarenteed to be observed. These observations cannot require special scheduling constraints (for example, CVZ, any timing requirement, or any telescope orientation requirements) and are limited to durations of no more than 48 minutes per orbit. For pure parallel proposals (see 6.2 Pure Parallels on page 105), check the "Parallel" checkbox next to the Proposal Category in the Proposal Information form. Please note that SNAP/PAR and GO/SURVEY/PAR are not valid proposal types. Availability You must choose supported. If the observing modes normally offered by STScI to GOs do not meet the needs of your program, please contact your Program Coordinator. Parallel Pointing Tolerance This information is required with pure parallel proposals. The Parallel_Pointing_Tolerance gives the maximum acceptable variation in pointing at the parallel aperture during a parallel visit. The units are arcsec but must be explicitly stated. The number must be non-negative (e.g., 10). This will normally be set to the maximum pointing change that still allows exposures taken at slightly different pointings to be combined later during data analysis.

2.3.2 Proposal Description
Proposal Text Sections These four sections are needed for STScI to execute your program properly. Not all questions will need to be answered by every observer, and note that the answers to these questions will be made public. As with the Abstract, please review this text to make certain the information is correct.


16

Chapter 2: The Basics of Phase II Proposals

Description of Obser vations [Observing_Description] Provide a detailed description of your observing plans. Text from your Phase I proposal has been inserted, but it will need updating based on your final TAC allocation and on details worked out in Phase II. Justification of Real-time observations and Special Scheduling Requirements [Realtime_Justification] Provide an explanation for any real-time or special scheduling requirements, if they have been requested. Information from your Phase I proposal has been inserted, but it is possible that the text will need updating based on your final TAC allocation, to include the details worked out in Phase II, and to remove any special calibration requirements (see below). Justification of Special Calibration Requirements [Calibration_Justification] Provide a justification for any special calibrations required for your program, if requested. Additional Comments [Additional_Comments] Provide any additional comments that you feel STScI needs to know in order to properly implement your program.

2.3.3 Investigators
These sections contain the names of the Principal Investigator (PI), all Co-Investigators1 (CoI), and their institute affiliations. This information comes from your Phase I proposal submission. If one of the Co-Investigators (or another individual) is to serve as the contact for a program, then the Contact keyword box should be checked. The Contact is the person the Principal Investigator has designated to receive all (non-budgetary) questions/information on the program and to be the official voice for the team. Only one person may be designated as the Contact. Once designated, only the Contact may make Change Requests so that conflicting requests are not made. If any of the Investigators have changed addresses between the Phase I and Phase II submissions (or any time after the Phase I submission), please contact your Program Coordinator with the updated address. You cannot use the Phase II submission to implement address changes. For Phase II submissions that are not based on a Phase I proposal, please fill in the information accordingly.

1. The number of CoIs is limited to 99.


Examples and General Advice

17

2.3.4 Target Information [Fixed_Targets, Solar_System_Targets, Generic_Targets]
Chapter 3: Fixed and Generic Targets on page 25 and Chapter 4: Solar System Targets on page 59 describe how to fill out the Target Lists.

2.3.5 Visit Information [Visits]
Chapter 5: Visits, Exposures and Exposure Groups on page 89 of this document describes how to fill out the Visit and Exposure Specifications. Instructions for submitting parallel observations are given in Chapter 6: Parallel Science Exposures on page 103, and the detailed, instrument-specific parameters are described in Part II: Supported Science Instruments on page 169.

2.4 Examples and General Advice
2.4.1 Acquisitions and Pointings
Getting HST located and oriented properly lies at the heart of successful observations, especially when a small aperture is being used, and there are a number of ways to do that. The remarks here apply specifically to fixed targets, and mostly apply to the use of small apertures, although many of them can be applied to moving targets as well. For more information, see Section 3.4 on page 36. First, you have to acquire an object successfully that is at or near the position at which the science observation will be made. The object to be acquired should meet these conditions:
1. It should be a point source or nearly enough to point-like that the cen-

tering algorithms can determine a precise centroid.
2. The object's coordinates must be both precise and accurate and any

proper motion must be known. This requirement boils down to the need for the object to fall within the search region at the time of the acquisition. For this to happen the coordinates must also be consistent with the Guide Star Catalog or they must fall within another system that can be related to the GSC. This is why the source of the acquired object's coordinates are required.
3. The object must be neither too bright nor too faint for the instrument

mode used. These conditions are described in the various Instrument Handbooks. The coordinates for the acquired object can be specified in several ways:


18

Chapter 2: The Basics of Phase II Proposals

· As explicit absolute celestial coordinates, i.e., RA and DEC. See Section 3.4.2 on page 38. · As celestial coordinates relative to another nearby object, using offsets in RA and DEC. See Section 3.4.3 on page 39. · As a REGION; see Section 3.4.4 on page 41. Second, once the acquisition has been made, the telescope must be repositioned to the precise point desired. This step is unnecessary, of course, if the object acquired in the first instance is the object to be observed. Repositioning can be implicit or explicit. An offset is implicit when a target such as "XX-OFFSET" is acquired with some ACQ mode, and then "XX" is observed via a science exposure. This often leads to confusion because no specific motion of the telescope has been provided, but that motion is implied by specifying the separate targets with different coordinates. "XX-OFFSET" is specified for the acquisition because it is bright enough and point-like enough to be acquired successfully, but the coordinates specified by "XX" are what is to be observed. An offset is explicit when you use a Special Requirement such as POS TARG (see POSition TARGet ,) to move the telescope away from the position acquired. In this scheme, the position specified in the acquisition is placed at the fiducial point for the aperture requested (in general the geometric center of the aperture). The POS TARG then moves the telescope relative to that nominal position. Thus POS TARGs are not cumulative, and always refer back to the original acquired position.

2.4.2 Examples
People who are looking for examples of APT files are encouraged to go to http://archive.stsci.edu/hst/abstract.html and do a search for a selection of proposals from the most recent cycle. For any program that appears as though it could serve as a useful example, the APT file can be obtained by typing the proposal ID number into the search form at http://www.stsci.edu/hst/scheduling/program_information Additionally, several examples of ACS dither patterns using POS TARGs which may be used in an APT proposal can be found on the ACS Web site at: http://www.stsci.edu/hst/acs/proposing/dither


Examples and General Advice

19

2.4.3 Common Problems
Incorrect Proposal Format When you are entering text in a field the formats described in this document must be followed exactly, since the information in the forms is interpreted by computer software. Some items that warrant repetition are: · Visit numbers must be unique. · Target names must be spelled exactly the same throughout the proposal. · The format for target positions must be followed to the letter. For more information on coordinates, see Section 3.13 on page 56. · The format for flux data must be followed. Only those defined in these Instructions are acceptable. · The format for Optional Parameters and Special Requirements must be followed to the letter. · Observations which cannot be defined using the syntax in these Instructions may be described in Comments fields, but such comments should be used very sparingly, if at all, and their use may impede execution of a program. Imprecise Target Positions See the discussion of required position accuracies in Table 3.11: Required Coordinate Accuracies. The requirements are much more stringent than is typically the case for ground-based observations. Lack of Acquisition Exposures with Small Apertures When exposures are requested in very small apertures or fields of view, a separate acquisition exposure is generally required. Please consult the Instrument Handbooks for the instrument you are using.

2.4.4 Consideration of Limited Resources
Proposers should be aware that several of the Special Requirements impose serious constraints on the scheduling system because they require the use of limited resources; for example, RT ANALYSIS requires real-time use of the TDRSS that is only available some of the time. Hence these Special Requirements should be requested only if they are absolutely necessary to achieve the scientific goals of a project. It is quite possible that some proposals will be impossible to schedule because of their resource requirements, rather than a lack of scientific merit. The limited-resource Special Requirements can force the planning system to schedule the observations at a less than optimal time. The use of limited-resource


20

Chapter 2: The Basics of Phase II Proposals

Special Requirements by many observers can reduce the overall efficiency with which the planning system can schedule the science program. For these reasons, these Special Requirements should only be used when necessary to achieve the science objectives of the program. The STScI will review the necessity for the Special Requirements and in some cases may suggest removing them, or using alternate methods to obtain the same goal. The following table summarizes the Special Requirements that involve seriously limited resources. The need for many of these Special Requirements must be justified in the Proposal Description. Note that several of these Special Requirements must have been justified in the Phase I Proposal in order to be used legitimately in Phase II; those are CVZ, SHADOW, LOW-SKY, and ON HOLD for Targets of Opportunity.
Table 2.2: Limited-Resource Special Requirements
Limited Resource ON HOLD [FOR ] RT ANALYSIS, REQuires UPLINK ORIENTation TO , SAME ORIENTation AS SHADOW, LOW-SKY, CVZ AFTER , BETWEEN AND , BEFORE , SEQuence WITHIN