OBs needing modification

Once your OBs and README file have been submitted to ESO, you have completed your Phase 2 submission, and you have notified ESO by pressing the p2pp-submit button in P2PP,the status of your OBs will be changed to prevent them from being checked out.

It is possible that during the Phase 2 package review process the support astronomers discover problems with your OBs or your README filethat require their modification. Also, problems may be discovered only at the execution time, requiring the OBs to be modified before their execution can be attempted again. In such cases you will be notified by ESO. If the OBs or any of their components need modification, their status will be changed so that you can check the OBs out, implement the required changes, and check them in again. Likewise, if the README file needs to be modified, you will be contacted by your support astronomer so that you check out, modify, and check in again your README file.

This webpage describes step-by-step procedures for the modification and resubmission of OBs and README files. More detailed information on each of the operations involved can be found in the P2PP User Manual and in the ~5 min video tutorial.

Checking out OBs and restoring them to the ESO Database

The procedure to modify your OBs can be summarized as follows:

  • Start P2PP
  • Select the folder that contains the OBs to be modified.
  • If you are using the same P2PP installation where you prepared your OBs, they will appear displayed in the P2PP main GUI with a lock icon next to their name in the OB Summary grid. The icon means that these OBs, which reside in the Local Cache, have been submitted to the ESO Database. You cannot make the modifications directly on these OBs; instead, you need to check out the copies of the OBs that exist in the ESO Database.
    • To check-out these OBs, select the OB and then File > Check-out option. Your OBs will be unlocked in your P2PP OB Summary grid and deleted from the ESO Database.
    • If the OBs you want to check-out belong to a scheduling container (concatenations, group, time-link), then you must select the parent container in order to check-out the OBs. It is not possible to check-out only individual OBs from a container.
  • If you are not working from the same installation where you prepared your OBs, and therefore you do not have the original OBs grayed out with the lock symbol next to them, proceed as follows to check out the OBs:
    • Start the ESO Database Browser by selecting File > View ESO Database...
    • When the ESO Database Browser widget appears, choose the information to be displayed that allows you to easily select and recognize the OBs that you wish to check out. For instance, Selected Columns: Name, ProgID, PIName Selection Criteria: Period = XX (e.g. 91)
    • Click on the Query button. All your OBs submitted for the selected Period will be displayed.
    • When the query is completed, select the OBs you need to modify.
    • Once you have selected the proper OBs, select File > Check-out in the ESO Database Browser menu bar. Your OBs will be unlocked in your P2PP OB Summary grid and deleted from the ESO Database.
  • Make whatever modifications are necessary by highlighting the OBs to be modified, viewing their contents with the Edit Observation Block icon, and editing them in the View OB window.
  • To save your modified OBs back to the Garching database, select them in the OB Summary grid and then select File>Check-in. To check-in OBs belonging to a container, select the container and then File > Check-in.
  • Notify ESO by pressing the p2pp-submit button in the P2PP main GUI.
  • Exit P2PP

Resubmission of modified finding charts and ephemerides files

Finding charts and ephemerides files are submitted as integral parts of the OBs. Therefore, requests for changes in the finding charts require checking out the OBs that use them and following the procedure described above for OB modification and resubmission, with the following specific steps:

  • To modify the finding chart or ephemerides file, detach the original one from the checked-out OBs.
  • Produce a correct finding chart (in JPEG format) or ephemerides file.
  • Attach the corrected finding chart or ephemerides file to the affected OBs, and check them in when this is done.

Note about file naming: It is important to note that a one-to-one correspondence must exist between finding charts or ephemerides files and their contents in the ESO Database. For this reason,

  • If the finding chart or ephemerides file that you need to replace is still valid for other OBs in the Database belonging to the same run that have not been checked out, the corrected finding chart or ephemerides file must be given a different name. Otherwise, two finding charts or ephemerides files with the same name but different contents would exist, which is not allowed.
  • If the new finding chart or ephemerides file has a content identical to another file already existing in the ESO Database for the same run (for example, if a finding chart for a different object was attached by mistake in one of a series of OBs with the same target), the name of the correct file must be the same as that of the files already in the Database that have the same contents.

Modifying the README file

README files are prepared and submitted from P2PP. If the README file needs to be modified the steps are as follows:

  • Select the Check-Out Readme option under the Readme File menu in the P2PP main GUI.
  • Correct the content of the Readme file as needed.
  • Once a correct Readme file has been produced, use the CheckIn Readme option under the Readme File menu in the P2PP main GUI to resubmit the Readme file to the ESO Database.

Instrument selector

This page is valid for all instruments