How to retrieve OBs from the Repository for revision

This tutorial shows you how to retrieve (i.e. check-out) OBs from the ESO Repository for revision.

In what follows we assume that you have an approved observing run with FORS2 and that you have already submitted the corresponding Phase 2 package (i.e. OBs, README and FCs).  Few weeks after the Phase 2 submission the USD support astronomer in charge to review and approve your Phase 2 material contacts you because some OBs need to be revised.

Hence, start a P2PP session, log in with your User Portal credentials to have access to the list of your approved observing runs, and then select the run within the  P2PP main GUI for which the OBs should be revised.

The P2PP main GUI should then show you the Phase 2 material you have prepared so far for this run. For the sake of this tutorial we assume that you have submitted a total of 2 groups containers (each one containing 4 OBs) and and additional set of 3 individual OBs. Then the P2PP main GUI should look like as follows:

 

file

The lock symbol next to each entry (OB or container) means that the OBs and the containers have been submitted to the ESO database (checked-in), therefore they are not editable unless you don't check them out. You still have access to the content of the OBs but you cannot implement any changes. In fact, try to select a given OB and double click on it to see the OB view window. The content of the OB appears in gray and none of the fields is editable (see below).

file

Now we assume that your USD support astronomer asked you to revise the OB named v-long belonging to group container object1, and then the three individual OBs named obj3, obj4 and obj5.

Now to check-out those OBs you have two ways to proceed, although the process behind is esentially the same in the sense that in both cases you will get the OBs from the ESO database:

  1. Direct check-out
  2. Retrive from Repository

to the top

1. Direct check-out

While holding the Ctrl button select the 4 OBs that need to be revised, then open the pull-down menu from File in the upper left corner of the P2PP main GUI to find the Check-out option. As you may notice such option appears in gray and it is not enabled because you are trying to check-out an OB belonging to a container separately from the other OBs. You must check-out the entire container in order to have access to any of its OBs. Once you select OBs obj3, obj4, obj5 and the group object1 you see that the Check-out option is enabled, so now you can select it. The P2PP main GUI should appear as follows:

file

Once you have simply acknowledged the pop-up window pressing the Yes button the P2PP main GUI should look like this:

file

As mentioned in the check-out log message the procedure was successful, but you know that already because the lock icon next to OBs obj3, obj4, obj5 as well as to the OBs belonging to the group  object1 is gone and that the selected OBs appear now in black (i.e. meaning that they are editable). You can now proceed with the revision following your USD support astronomer guidelines.


Once you have implemented the requested revisions you can re-submit the OBs following the precedure described in section 3.

to the top

2. Retreive from Repository

From the File pull-down menu, in the upper left corner of the P2PP main GUI, select the option View ESO Database which will open the ESO Database Repository window as shown here below:

file

By default, the ESO Database Repository shows you all the OBs and containers associated to the User/PI whose credentials were used to start the P2PP session (i.e. your User Portal ID is also your UserName). Because in this tutorial we are using the P2PP tutorial account whose log in is 52052, this is the reason why you see all the OBs associate to the UserName: 52052. Now it is more convenient to enable some fields in the ESO Database window in order to be sure that we will select the correct OBs for the check-out, although you could simply select them based on their OB ID. Enable the OB Name, the ProgID, the Target fields and then from the Instrument list select FORS2.  Press the Query button in the lower left corner to query the Database, the Repository window will look like as follow:

file

Holding the Ctrl button, select with the mouse the 4 OBs you need to check-out and then from the File pull-down menu in the left upper corner of the ESO Databse window choose the option Check-out. The ESO Database window should appear as below:

file

Confirm that you want to proceed with the check-out procedure and then go back on the P2PP main GUI which meanwhile should look like as follows:

file

If the check-out log message does not show errors, as in this case, then once you close it you will notice (see picture below) that the lock icon next to OBs obj3, obj4, obj5 as well as to the OBs belonging to the group  object1 is gone and that the selected OBs appear now in black (i.e. meaning that they are editable). You can now proceed with the revision following your USD support astronomer guidelines.


Once you have implemented the requested revisions you can re-submit the OBs following the precedure described in section 3.

 

file

to the top

3. Re-submit the revised version

Now we assume that you have completed your OBs revision and you need to re-submit the OBs which were checked-out. Before proceeding with the OBs submission is always very highly recommended to check that the revised version is free from errors. To do so, select the OBs obj3, obj4, obj5 and the entire container object1 and then from the Reports pull-down menu, in the upper bar of the P2PP main GUI, select the option Verify. The verification log window will appear listing the results on checks just performed.

Make sure that the group object1 and the three individual OBs are still selected, from the File pull-down menu on the left upper corner or the P2PP main GUI, select the Check-in option. At this point the P2PP main GUI looks like this:

file

You are sure about the submission so you press the Yes button!

In the P2PP main GUI all OBs have the lock icon next to them, meaning that they are back into the ESO Database and therefore they are not editable anymore. Before closing the P2PP session, remember to select the run ID and then to click on the whistle icon to alert your USD support astronomer that your Phase 2 material has been re-submitted.

file

to the top

 

Click here to go back to the main P2PP Documentation page.