obximport script

Some users may wish to use OBs from their previous runs for their upcoming observations, without having to recreate them from scratch in p2.   

Please be aware of the following:

  • Service Mode runs: All OBs that were submitted (check-in) via P2PP3 in P100 or before are visible in p2 under the previous run ID. Those OBs can be re-used and simply copy & pasted from the pre-P101 run to the current run within p2. Please notice that the creation of OBs inside P100 observing runs and earlyer is not supported in p2. Runs younger then P90 are not visible in p2.
  • Visitor Mode runs: OBs belonging to visitor mode runs that were executed at least once during P100 or before are already visible in p2 under the previous run ID. Those OBs can be re-used and simply copy & pasted from the pre-P100 run to the current run within p2.

Users who wants to import a large amounts (> 100 single files) of OBX files or scheduling containers into the database and as such made available in p2 should use the obximport tool. It is a ready-to-run packaged Python program and is described in the following.

The program requires Python 2.7. It will not run on any earlier Python version or on any Python 3 version. It was tested only with CPython.

Installation on UNIX-like systems: Save the obximport python binary on your local disk, make it executable:

$:chmod +x obximport

then print its usage message:

$:./obximport --help


Definition: the obximport script is a Python based program which uses the ESO Phase 2 API to allow users to import large number of OBs into a ESO run. In the context of the API, a Container is defined as any item "containing" one or more objects. More specifically, any ESO run or folder and scheduling container (group/time-link/concatenation) created inside the ESO run is defined as a Container by the API and is uniquely identified in the ESO database by a Container ID.  

Preparation: Please log into the new web application for Phase 2 preparation p2 using your ESO User Portal credentials. Click on specific Container (Run, Folder, Scheduling container) to display the Container infos, including the Container ID of obximport. This number must be memorized since it uniquely identifies the selected Container. The Contained ID will be used to import OBX into the Container itself, being it a ESO run, a folder or a scheduling container.

General usage: The program needs at least one OBX file to import and the -c option with the Contained ID of a Container (see previous sections). After reading the OBX file(s), the program will prompt for a user credentials, i.e. a name to login and a password. It will then proceed with creating OBs into the ESO's database under the run, folder and/or scheduling container identified by the Contained ID.


Import a number of OBs from my local machine into a folder (option -c) identified with the Container ID=1234567

$:./obximport -u username -c 1234567 *.obx

Import a number of OBs from my local machine into a run identified with the Container ID=200123456 

$:./obximport -u username -c 200123456 *.obx

Please use the option --demo to import OBs into the public demo server. In such a case, please use the following credentials: Username (option -u) "52052" ; Password "tutorial". Please do not use the credential of your user portal account to access the demo server.

Please use ./obximport --help for a full list of options. Please note that the option -r is dismissed.

Tip: To avoid typing the password over and over again for repeated runs, store it in a file and redirect stdin of obximport from this file, e.g

$:./obximport -u username -c containerId *.obx < password.txt

This works only in combination with the --user -u option.