Internal Technical Memorandum ITM-1998-04
Notes on v8.0.1 of the Phase II Proposal
Instructions
D. Soderblom
October 1, 1998
ABSTRACT
Version 8.0.1 of the Phase II Proposal Instructions is substantially different from previous editions.
This ITM discusses some of its features (and reasons for them), provides descriptions of formatting for document maintenance purposes, and lists the OPRs that were closed in producing v8.0.1.
1. The Previous Phase II Proposal Instructions
The document referred to here is designated as Version 8.0.1 of the Phase II Proposal Instructions
(“P2PI”). As explained in the Introduction to P2PI, the previous version was “9,” and a new number series was adopted so that henceforth P2PI and RPS2 would be issued together and will have
concordant version numbers. P2PI will use three-part numbers, so little confusion should result.
Version 8.0.1 has been formatted for effective presentation both on paper and via the web as a Portable Document Format (pdf) file. A pdf file is easy and quick to download, and, once opened, can
be left on one’s screen as a ready reference. The pdf document provides all of the capabilities of
html and more, and there are no current plans to produce an html version of P2PI. Experiments
showed that a significant effort would be needed to produce good-looking and effective html. The
pdf document provides html features and is easy to produce.
2. Features of the New Phase II Proposal Instructions
Content
The entire P2PI has been thoroughly edited for consistency of style, and many changes made to
ensure completeness and accuracy. See Section 4, “PROPINST OPRs,” on page 3.
Navigation
Each page has a “Back” button to return the reader to the previous location. Buttons are also available to take the reader to the start of the current chapter they are in, or to the Table of Contents at
the beginning of P2PI.
Readers can click on cross-references in pdf to jump to the referenced location. These cross-references are shown in blue, except in colored (conditional) text, where their presence is ordinarily
obvious from context. The Table of Contents is entirely cross-referenced to take the reader straight
1
Internal Technical Memorandum ITM-1998-04
to a topic. The first page of each chapter lists major headings, tables, and figures as cross-references for the same purpose.
Logo
For easy identification of this document and its components, a Phase II logo was created by the
Graphics group and included at the start of each chapter. It is recommended that this logo be used
elsewhere within the Phase II process (e.g., RPS2) so that users can identify their location easily
and confirm the version number.
Phase II
v8.0.1
Bulk
The total size of P2PI has been reduced substantially by using better page layout. Some text has
been removed, but more has been added as well.
Access
With the release of v8.0.1 there is no longer intent of support of paper copies of P2PI; instead we
expect HST users to download the current version to view or print as they please at their home
institution. Doing this ensures that the user is getting the most current version, it provides them
with the full functionality of the pdf document, and it eliminates the substantial cost of printing
and distribution.
Two version of P2PI have been produced: p2pi_v801.pdf and p2pi_v801_ENG.pdf. The former is
the GO version and is freely available over the web. The latter Engineering version is visible only
from within STScI.
3. Document Notes
3.1 Paragraph Numbering
This is now done automatically by FrameMaker. One implication is that the numbers of sections,
tables, and figures is no longer absolute. To refer to numbered text, cross-reference formats must
be used. These have the additional benefits of being self-maintaining and of being converted to
hypertext links in html.
3.2 Version Number
Any reference to version number should be by reference to the “p2pi version” variable.
2
Internal Technical Memorandum ITM-1998-04
3.3 Chapter, Page, and Part Numbering
Chapter and page numbers are generated automatically. Pages are numbered within chapters (e.g.,
2-5).
3.4 Conditional Text
There are four types of text in this document.
GO
GO text is Unconditional and is set in black. It will appear in both the GO and ENG versions.
Engineering
Engineering text is set to Condition tag “Engineering” and Character Tag “Engineering” so that
change bars appear next to this text. It appears in green. Engineering text is intended for comments
that are not specifically “Available” or “Restricted” but which need to appear only in the ENG version. It is also used for text set in place to be invoked in a future edition.
Available
Available but Unsupported modes are set as Condition tag “Available” and Character Tag “Available.” Both are needed for the text to appear properly in Frame, in PDF, and in HTML. Available
text is magenta and appears with a tag of “Available but Unsupported.”
Restricted
Restricted mode text is set with Condition Tag “Restricted” and Character Tag “Restricted.” This
text appears as red and is always accompanied by a “(Restricted)” warning tag as well.
Conditional Text in Tables
Table cells are not ordinarily given a conditional setting even when their surrounding text is
because they are in separate text flows. To make table cells conditional it is possible to select a
group of cells and to then apply a condition tag. This results in the boundaries of this area being
highlighted with cross-hatching, which can interfere with legibility. I have preferred to set the condition tags of table cells one cell at a time because the appearance is very much better, even though
the process is laborious.
3.5 Character Formats
The use of Available, Engineering, and Restricted character formats has just been explained. As
noted, they are needed in addition to the Condition Tags so that the text appears in the proper color
in all document versions.
“Bold” is probably the most-frequently used character format. It must be applied to text if the
boldfacing is to show up properly in all the document versions.
4. PROPINST OPRs
The mechanism for identifying errors, deficiencies, or needs in P2PI is the Operations Problem
Report (OPR). OPRs can be filed or viewed by going to
http://www.sesd.stsci.edu/prsystem/
3
Internal Technical Memorandum ITM-1998-04
and selecting “PROPINST.”
This version has incorporated as many OPRs as possible, summarized below.
5. Acknowledgments
Previous editors of the Phase II Proposal Instructions have included Howard Bond, Ron Downes,
Jim Fraher, Larry Petro, Brad Whitmore, and Ron Henry. I would especially like to thank Ron
Henry for his help in preparing this document.
Many others have also provided useful information or advice, including A. Koratkar, P. Stanley, G.
Miller, K. Peterson, R. Douglas, A. Roman, D. Golombek, A. Lubenow, E. Perriello, and P. Royle.
We also thank the SSD instrument groups for their help.
4
Table 1. OPRs Incorporated into Version 8.0.1
OPR
Description
Comment
Closed
9.1, T9.1
WFPC2: pre-flash
added as placeholder; needs
TRANS
980528
Need to identify TOO and EARLY ACQ in proposals
not PROPINST; rejected
980617
8.2, T8.1
9.1, T9.1
WFPC2: Option CLOCK=YES should be used with caution
9.5
12.2.1
STIS: instructions for PATTERNs
was already in place; not in Henry
list
980528
Remove target number range for generic targets
PED; rejected
980617
Current
(v8.0.1)
Old (9E)
8.2, T8.1
32903
33011
31469
31710
33044
980528
5
33105
3.7
5.1.7
Fixed Targ: Unclear about parallax on offset targets
980528
33590
6.3
8.3
Parallels: Sets of coordinated primes and parallels must be one orbit
980528
33665
2.3.1
4.1
Basic: Document “avail_ok”
980528
33934
—
5.2.4
SS Targ: GREAT_CIRCLE and STELLAR made “Available”
980528
33938
4.7
5.2.7
SS Targ: Drop angle with MAX/MIN and moving target windows
980528
33957
T9.6
T12.6
STIS: Monitor bias values for subarrays
980528
33959
4
5.2
SS Targ: Require four-digit years with EPOCH
980528
33998
6.3
8.3
Parallels: Clarify limitations on <primary-exp-list>
980528
34108
19.5
11
NICMOS: Remove CR-ELIM=NONE from RAMP mode
34185A
2.3.1, 2.3.2
4.1
Basic: Pure parallels syntax
980528
34185B
3.11
Fixed Targ: Pure parallels syntax
980528
34185C
5.2
Logsheet: Pure parallels syntax
980528
Ch 6
OK’d 980330
980528
34185D
7.2.3
7.1.3
SpReq: Pure parallels syntax
980528
34185E
6.1, 6.2
8.1
Parallels: Pure parallels syntax
980528
34301
9
12
STIS: Allow use of deuterium (D2) lamp with CCD
34343
9
12
STIS: Change 0.3X0.05ND to “supported”
980528
34359A
5.6.2, T5.2
6.6.2, T6.1,
T6.2
Logsheet: Support ANY target
980528
34359B
6.3
8.3
Parallels: Support ANY target
34389
9.3
12.1.2
STIS: Missing ACQs; RPS2 should warn
34393
17
15
COSTAR: Missing text for FOS mode
980528
34394
17
15
COSTAR: Missing text for GHRS mode
980528
TRANS?
980528
980528
add to P2PI
980528
Internal Technical Memorandum ITM-1998-04
Section
Section
Description
Comment
Closed
Current
(v8.0.1)
Old (9E)
34395
—
—
TOC: Missing hypertext links for tables
980528
34396
—
—
TOC: Missing hypertext links for chapters
980528
34397
—
—
All: Missing hypertext links to sections
980528
34398
—
—
All: Missing hypertext links to tables
980528
34399
—
—
All: Missing table titles
980528
34400
—
—
All: Some tables concatenated
980528
34401
—
—
All: Figures not displayed properly
980528
34402
—
—
All: Missing index
980528
34403
—
—
All: Improper conversion of Frame to html
980528
34475
9.6, 9.7, T9.1
T12.1, 12.22.,
12.2.3
STIS: Optional parameter LAMP for TIME-TAG observations
980528
34497
19
11
NICMOS: Support compromise focus position
980528
34531
4
5.2
SS Targ: Require EPOCH with a rate parameter
980528
34539
7
7
SpReq: Disallow POS TARG on internal exposures
980528
34541
7
7
SpReq: Clarify SAME POS wording
980528
34589
4.5
5.2.5
SS Targ: Allow angular units for ephemeris uncertainty
980528
34449
Allow GO/CAR proposal type
not in Henry list
980528
6
34677A
STIS: Reorder PATTERN optional parameters?
moot due to patterns in Transverse
980716
34677B
NICMOS: Reorder PATTERN optional parameters?
moot due to patterns in Transverse
980716
34688
7.3.3
34901
9
12
SpReq: More description of SAA CONTOURs
980528
STIS: BUFFER-TIME should be an integer
980528
34921A
1
—
Intro: New conventions for Engineering, Available, and Restricted
980528
34921B
2
2, 3, 4, 14
Basic: New conventions for Engineering, Available, and Restricted
980528
34921C
3
5.1, 5.3
Fixed Targ: New conventions for Engineering, Available, and
Restricted
980528
34921D
4
5.2
SS Targ: New conventions for Engineering, Available, and Restricted
980528
34921E
5
6
Logsheet: New conventions for Engineering, Available, and Restricted
980528
34921F
6
8
Parallels: New conventions for Engineering, Available, and Restricted
980528
34921G
7
7
SpReq: New conventions for Engineering, Available, and Restricted
980528
Internal Technical Memorandum ITM-1998-04
OPR
Section
Description
Comment
Closed
7
Current
(v8.0.1)
Old (9E)
34921H
8
9
WFPC2: New conventions for Engineering, Available, and Restricted
34921I
9
12
STIS: New conventions for Engineering, Available, and Restricted
980528
34921J
10
13
FGS: New conventions for Engineering, Available, and Restricted
980528
34921K
15
10
FOC: New conventions for Engineering, Available, and Restricted
980528
34921L
16
—
ACS: New conventions for Engineering, Available, and Restricted
980528
34921M
17
15
COSTAR: New conventions for Engineering, Available, and
Restricted
980528
34921N
18
16
S/C: New conventions for Engineering, Available, and Restricted
980528
34921O
19
11
NICMOS: New conventions for Engineering, Available, and
Restricted
980528
34928
7
7
SpReq: SM proposals should be SCHED 100%
Needs PP OPR; remove
980528
34950
9
12
STIS: WEDGEA or WEDGEB not identified in figure
Figures deleted; ref. to STIS IH
980819
34973
T9.6
T12.6
STIS: CCD fringe flats
980528
34981
3.4
5.1.4
Fixed Targ: Update URL for GSSS
980528
35161
2.3.2, 5.2
8
Parallels: Point PED help to P2PI
35186
7
7
SpReq: Allow PCS mode options with S/C configuration
Restricted
35188
7
7
SpReq: Fix ORIENT example in Fig. 7.2
Use new non-FOC examples
35197
T9.5
T12.5
STIS: Disallow secondary tilts
980528
35199
9.5, 9.6, 9.7
12.2.1, 12.2.2,
12.2.3
STIS: Note exposures are quantized
980528
35201
7
7.2.5
SpReq: Improve description of MAX DUR
980528
35204
7
7.2.3
SpReq: SAA CONTOUR values
980528
35207
T9.6
T12.6
STIS: Disallow x-disp elements with WAVE
35232A
9.5, 9.6, 9.7
12.2.1, 12.2.2,
12.2.3
STIS: Error when SAME POS and PATTERN conflict
35232B
19
11
NICMOS: Error when SAME POS and PATTERN conflict
check P2PI
980528
35257
2
—
Basic: Remove Scientific Category
made “Available”
980528
35328
4
5.2
SS Targ: Add to standard bodies
980528
35358
5.6
6.6
Logsheet: Warn when EARTH-CALs are in same visit as externals
980528
35365
4
5.2
SS Targ: Require EPOCH with position angle
980528
980528
980528
980528
980528
check P2PI
OPEN; see OPR 35406
980528
980528
Internal Technical Memorandum ITM-1998-04
OPR
Section
Description
Comment
Closed
8
Current
(v8.0.1)
Old (9E)
35369
9
12
STIS: SIZEAXIS2, SIZEAXIS1, CENTERAXIS2, CENTERAXIS1
ranges
980528
35399
19
11
NICMOS: FOMXPOS, FOMYPOS
980528
35447
6
8
Parallels: Rules for generic and ANY targets
980528
35481
7
7.2.1
SpReq: Tighten restrictions on SAVE OFFSET/USE OFFSET
980528
35517
7
—
SpReq: New special requirements to replace TRANS manual merging
35697
9.5
12
STIS: Allow CR-SPLIT=NO with internals
35795
9.3
12
STIS: Allow smaller CCD subarray size for ACQ/PEAK and
MIRROR
35841
9
12
STIS: 1575 A wavelength illegal with G140L
35851
7
7
SpReq: Format of SEQ NON-INT
35868
2
—
Basic: Add “NASA” proposal type
36101
7
7
SpReq: Require four-digit dates
980528
36144
7
7
SpReq: Clarify NON-INT wording
980528
36177
19
11
NICMOS: Allow POS TARG with NIC2 ACQ
980528
36213
—
—
All: html version needs more links
980528
36332
9.4
12.1.3
STIS: Make STIS/MAMA ACQ/PEAK illegal
36379
—
—
RPS2: Incorporate RPS2 Users Manual into P2PI
980528
36380
12.2
—
RPS2: Changes to text
980528
36399
T9.5
T12.5
STIS: Make 0.2X0.2 aperture “Available” with G750L
980528
36417
9.7
12.2.3
STIS: Disallow multiple exposures in TIME-TAG mode
980528
36444
9.5
12.2.1
STIS: Disallow CR-SPLITs and multiple exposures with STIS pure
parallels
980528
36585
9.5
12.2.1
STIS: CR-SPLIT should default to NO for STIS pure parallels
TRANS
36586
STIS: Remove FGS DATA-RATE optional parameter
TRANS; for Cycle 8
36609
Calibration targets are also descriptive keywords
done as “Engineering” text
980528
980528
Wait?
980528
980528
980528
made “Available”
section remains as “Engineering”
980528
980528
980617
980617
980528
36670
7
7
SpecReq: Improve text on SAME POS
980528
36671
7
7
SpecReq: Improve explanation of POS TARG
980617
36676
6
8
Parallels: Clarification in section on coordinated parallels
980617
36681
7.
7
Change SAVE OFFSET and USE OFFSET to “Available”
980528
Internal Technical Memorandum ITM-1998-04
OPR
Section
Current
(v8.0.1)
Description
Comment
Closed
Old (9E)
36682
Restore text on spatial scans
980806
36699
All: Change “Available” to “Available but Unsupported”
980528
36755
SpReq: Allow NEW OBSET
980528
9
36759A
FOC: Make FOC “Available but Unsupported” for Cycle 8
980528
36759B
NICMOS: Make NICMOS “Restricted” for Cycle 8
980528
36761
STIS: New list of supported apertures
980617
36804
Basic: Include PROP file template
980528
36808
SpReq: Allow multiple ranges of angles for ORIENT
980528
36816
FixedTarg: New keyword: Coordinate_Source
980528
36875
SpReq: “SAA CONTOUR” not spelled correctly
980528
36876
SpReq: Remove “GROUP FGS WITHIN”
980617
36933
Visits and Exposures: Drop usage of “logsheet” in P2PI
980617
36934
STIS: Drop ACQ/PEAK mode with MAMA detectors
980617
36935
STIS: Do not allow subarrays with MAMA detectors
980617
36936
STIS: Add GOWAVE and CCDFLAT
980730
36942
Basic: Document proposal types
37013
SpReq: Target of Opportunity Special Requirement
37091
Basic: Changes to Data_Distribution
980716
37192
STIS: Make certain wavelengths Available but Unsupported
980716
37219
FGS: Make FGS-1 prime
980806
37220
FGS: Change F650W to F605W for FGS-1
980806
37221
FGS: Disable SCAN mode
980806
37240
SpecReq: Make ONBOARD ACQ FOR illegal unless ACQ mode
980806
37343
STIS: Supported grating-aperture combinations
980828
37379
Remove PCS MODE Coarse
980828
980617
rejected, do at program level
980617
Internal Technical Memorandum ITM-1998-04
OPR
Table 2. OPRs to be Incorporated into Next Version
OPR
36674
Description
Current
(v8.0.1)
Old (9E)
2
—
Comment
Confirmed
Description
Comment
Confirmed
Need introductory text on ACQs
37225
SI: support new PATTERN syntax
37500
Parallels: Disallow STIS and FOC coordinated parallels
Table 3. PROPINST OPRs That Cannot be Closed; On Hold
Section
OPR
31873
Current
(v8.0.1)
Old (9E)
7
7
10
SpReq: Add graphs to show target visibility data
Assess need
34027
SS Targs: Allow use of logical NOT
TRANS assessment needed
34081
SpReq: Allow ORIENT as exposure-level requirement
not supported by software
34957
SpReq: remove ONBOARD ACQ FOR and change INT ACQ FOR
on hold
35054
Parallels: Add coordinated parallel restrictions for STIS PATTERNs
still OPEN for PP
36557
SpReq: Make visit fit in orbital units
TRANS assessment needed
Internal Technical Memorandum ITM-1998-04
Section
Table 4. OPRs on Hold for Future Inclusion
OPR
Description
Comment
34582
ACS: Proposal instructions
not in Henry list
35060
ACS: Proposal types
35531
ACS: Update for internal lamps
35779
ACS: ALIGN mode
35970
ACS: HRC ACQ mode and coronagraphic observations
36197
ACS: Ramp filters
36486
ACS: Allow DROP TO GYRO
36888
ACS: SBC and WFC fixed filter offsets
37467
ACS: Phase V Proposal Instructions
Current
(v8.0.1)
Old (9E)
not in Henry list
Confirmed
Internal Technical Memorandum ITM-1998-04
Section
11
Table 5. Changes to P2PI with No OPR
OPR
Description
Comment
Confirmed
T5.3–T5.7,
T5.11
Remove arbitrary groupings of keywords
Done
Golombek
2
Strengthen wording about accepting proposals with RPS2 errors
Done
Golombek
Change wording such as “FOC/96” to “F/96”
Done
Golombek
Note that team Contact is only one who may make Change Requests
Done
Golombek
Change “Kspots” to “K spots” in WFPC2 chapter
Checked 980819
Golombek
Current
(v8.0.1)
Old (9E)
—
T3.3–T3.7,
T3.11
—
2
—
—
2.3.2
—
—
5.1.4
Remove reference to target coordinate accuracies
Irrelevant
Golombek
—
5.2.4
Why “lambda(III)” for Jupiter?
Closed – irrelevant
Storrs
12
—
Let GOs see that visit numbers are base 36
Done
Golombek
—
Emphasize difficulty of scheduling programs with multiple special
requirements
Done
Golombek
—
Need new confirmation chart
Done as Appendix A
980814
—
Need description of associations?
Irrelevant for P2PI
Noll
—
5.1.4
Need plate IDs for Hipparcos coordinates?
source of coord’s now required
Golombek
—
T5.14
Quantify bright-object limits for unfiltered STIS/CCD exposures
refer to STIS IH
Gilliland
—
T7.2
Is note on jitter needed?
unimportant
Gilliland
—
8.4
Clarify example of ordering restrictions
superseded by new parallel info
Golombek
—
2
14.1
Improve examples
OPEN
—
—
—
Change ^ and _ symbols to super- and subscripts
OPEN
Internal Technical Memorandum ITM-1998-04
Section