README File creation instructions
The README file contains an overview of the run, aspects specific to it, and an instrument-dependent checklist. The README file interface is accessible from the P2PP main GUI via either the Readme button or the Readme menu at the top bar; see the P2PP User Manual (or the P2PP3 User Manual for the cases of VISTA, VST and UT2 instruments observation preparation in Period 89) for a detailed description. The README file has the following sections:
- A non-editable section giving basic information on the run as scheduled: the ID, instrument, priority class, approved execution time, type (normal, large, guaranteed time, or director's discretionary time), and PI name.
- A list of sections accessible through tabs where specific aspects of the run can be described:
- General Description: a short summary of observing run, providing ESO with any information needed to meet your science objective. Decision paths and/or OB modification requests that depend on the outcome of previously executed OBs are not allowed.
- Waiver Requests: a short summary of any approved Phase 2 waiver requests, including when they were submitted and when they were approved.
- Critical Observing Conditions Constraints: any information about required observing conditions that are critical for the achievement of the goals of the project (beyond those defined in the Constraints Set box).
- Time-Critical Aspects: if your OBs must be executed within specific time windows or in some time specific sequence, please describe those constraints here. Note that in the case of specific time windows, these need to be indicated also under the Time Intervals information in the OB itself.
- Special Execution Requirements: any other requirements regarding the execution of your run other than those indicated in the previous sections, such as preferences on the relative completion of OBs; for instance, if preference should be given to the completion of all the OBs on a given target before proceeding with another target.
- Special Calibration Information: if you have submitted OBs for calibration, please describe them here, why you have submitted them, and how they should be executed relative to your science OBs (e.g. same night, once per observing run, etc.). In particular, you must provide the magnitude and spectral type for all user supplied photometric or spectrophotometric calibration stars.
- ToO Information: please indicate here if this is a Target of Opportunity run and give any special details.
- ToO Activators List: please give here the names of the investigators who are authorized to trigger a Target of Opportunity observation.
- Pre-Imaging Requirements: if this is a pre-imaging run, please indicate it here and describe any special requirements; for instance the need to obtain on- and off- observations in narrow-band filters contiguously.
- An entry for the e-mail address of the Principal Investigator of the programme. This ensures that this important piece of information is kept updated in ESO's records. Please do not enter here any address other than that of the Principal Investigator, even in the case that the person preparing the Phase 2 package is not the PI.
- Estimated Total Execution Time: please include here the execution time as given by the execution time report of P2PP.
- Is this a Pre-imaging run? this is a tick box that must be checked if the run is pre-imaging for another run. This is important to ensure that pre-imaging runs receive the due execution priority.
- In case the pre-imaging was required to prepare these OBs, you must indicate the source of pre-imaging in the corresponding box. If the source is none of those listed there, you can indicate the actual source in the entry below it.
The last part of the README file is a check list including most of the relevant aspects related to Phase 2 preparation with the corresponding instrument. You must click either yes or N/A to ensure that you have taken all these aspects into account.
A tutorial that explains step by step how to fill out a README file with P2PP can be found under this link for the "old" version 2.13 P2PP. The steps how to fill out a README under the new P2PP3 are similar and are explained in a video tutorial.