The P2PP version 3 Tool

P2PP has been in use at ESO telescopes since 1997 and has undergone much evolution since then, trying to adapt to both operational and user-friendliness needs as they have been identified, and providing enhanced functionality.

P2PP development continues. Motivated by specific requirements that were set by the ESO Public Survey programmes with Survey Telescopes, VST and VISTA, on Paranal, the new P2PP version 3 (P2PP3) has been developed. Many of these new functionalities and enhancements of P2PP3 are useful also for all Service Mode users of ESO telescopes, including those conducting short programmes. Therefore ESO has started to extend the use of the new P2PP3 also for "normal" programmes on the VLT and other telescopes in the future. In Period 89 P2PP3 has to be used for preparation of observations of all VISTA, VST and UT2 instruments, meaning that  all users who have Period 89 observations scheduled on VIRCAM, OmegaCAM, X-SHOOTER, FLAMES, and UVES must use P2PP3 to prepare their observations.

This page provides a quick overview of the enhancements to the functionality of P2PP version 3 and provides links to the relevant documentation.


User Manual and Related Documents

The users preparing the observations for UT2, VST, and VISTA instruments (X-SHOOTER, FLAMES, UVES, OmegaCAM, and VIRCAM) should read the P2PP version 3 User Manual for a detailed description of the currently available functionalities.

For the preparation of all observations to be carried with VIRCAM on VISTA the users will have to define the survey areas using the Survey Area Definition Tool (SADT). The usage of SADT for OmegaCAM observations on VST is not mandatory, but it is recommended. The output of the SADT will then be imported in the new P2PP3 (version 3.2)  to prepare valid observation blocks.

Time-linking of OBs

It is frequent that OBs must be executed within precise time windows, rather than any time when the external conditions (moon, seeing, transparency...) would allow the execution. The following types of time-dependencies can be recognized:

  • Absolute time constraints, meaning that an OB must be executed at specific dates that can be predetermined. An example is the observation of a binary star at a precise phase of its period.
  • Relative time links, implying that an OB must be executed within a time interval after the execution of a previous OB, but not necessarily at a fixed date. Examples of this are monitoring observations of a variable source at roughly constant intervals.

Only the first type of time-dependency is implemented in P2PP version 2.13.1 that is used for service mode programmes on VLT. In the new P2PP version 3, the relative time links are implemented within the new "Time Link" container.

Within a Time Link container, the user can define a series of OBs, having the earliest and latest time when a given OB in the series must be executed with respect to the preceding OB. The time-related information is stored in a database, from where it is retrieved by scheduling tools available to the operator on the mountainin order to build up a short-term schedule that properly takes these constraints into account.

Concatenation of OBs

In some cases it may be desired to execute the OBs consecutively, with no other observations in between. This has been implemented in the P2PP version 3 with in the new "Concatenation" container. The concatenation container consists of two or more OBs that must be executed "back-to-back" without breaks. The sequence of the execution of OBs in a concatenation is not fixed.

Definition of groups of OBs

It is possible at present to assign an execution priority to each OB, so that the operator is aware of the ones that have a higher scientific importance at the time of deciding on observations to execute for a given programme.

It has been recognized nevertheless that such simple priority scheme is sometimes insufficient to deal with programmes containing large number of OBs, and especially for surveys containing large numbers of target fields observed in a number of instrumental setups. In such cases the need for a prioritization scheme above the individual OB level, which can take into account the past execution history of the programme, becomes clear. One can consider for instance the case of a survey of several target fields to be observed through several different filters, with each field and filter specified in a single OBs. Depending on the science goals of the programme it may be desirable to complete the observations of a given field in all filters before proceeding to the next field, or conversely to observe all the fields in a given filter before proceeding to the next filter, or even ensure that contiguous coverage among the fields takes priority.

The approach adopted to deal with such cases is the definition of groups of OBs, in which internal priorities within each group are reflected in the form of a contribution of each OB to the total group score. The short-term scheduling tools available on the mountain will take into account the current scores of each group of OBs, and will then apply a number of rules in order to prioritize the possible OBs to be executed according to them. Such rules will for instance give the highest execution priority to those OBs that set a new maximum of the score among the existing groups; and among those, the highest priority will be given in turn to those that produce the largest increase in group score. By assigning to the OBs the appropriate contributions to the scores of their respective groups, the users can make sure that the progress in the execution of the programme will take place in a way that is consistent with the scientific priorities of the observations. In addition, it will be possible to assign different priorities to each group.

Import of target fields produced by the Survey Area Definition Tool

The Survey Area Definition Tool (SADT) is a utility developed by the VISTA consortium that allows users to define areas to be covered by surveys executed with either VIRCAM at VISTA or OmegaCam at the VST according to a number of criteria. The SADT determines the central coordinates of the different pointings required to cover the field according to the specifications, as well as ancillary guide star information to allow acquisition and guiding. The output produced is a file to be ingested by P2PP version 3 containing all the target information needed for the preparation of the OBs with which the survey will be executed.

The latest distribution of the tool can be downloaded from the SADT web page, where also a video tutorial and the SADT Cookbook with step-by-step instructions and examples can be found.

Instrument selector

This page is specific to Public Surveys on the VST and VISTA telescopes.