TOI Process

Uploading Pipeline Deliveries

Pipeline Deliveries are managed from TEV's command line interface. To access, you must cd into the respective TEV root directory and activate TEV's virtual environment:

$ cd ${TEVROOT}
$ . pythonenv/bin/activate

Once activated, you can access the TEV commands via $ python manage.py.

QLP and SPOC imports are done via their respective import entry points, but the flag and syntax structures are the same.

$ python manage.py import_qlp # or
$ python manage.py import_spoc

Deliveries are sent to /tev/data/{spoc|qlp}/ and should be uncompressed/expanded into readable directories.

Now, the deliveries can be imported¹:

$ {IMPORT_CMD} --user ${your TEV username} --column-list "${column list name}" ${delivery_name} ${delivery_path}

Typically, the column list name to use is "Sparse Data Overview", but ask current operators what the currently used column list is if you're unsure.

Initialize Vetting

Log into TEV via a web browser and navigate to the created collection.

Look for the Start a Vetting Process and select the relevant process you wish to start.

Filter collection by Vets

You can open the menu for advanced item selection in the upper left corner of the data table. There, you can select items according to specific vetting criteria. These criteria are boolean OR'd together during SQL query emission.

Sub-Collection Creation

To create a subcollection with selected items, click on the Cog near the top of the data table. In the With Selection submenu, click Create Subcollection. After completing and submitting the form, a new collection will be made with the current collection as its parent. Upon successfully resolving the request, your browser will be redirected to the new collection.

TOI Assignment

To assign items as TOIs, navigate to the appropriate collection (item type does not matter) and click the Cog. Go to TOI Management and click Assign TOIs to Collection.

A view will appear showing a preview of the TOI Assignment. Various statistics will be displayed, such as the number of new TOI stars and TOI signals (this is not a 1 to 1 correspondence). After selecting a TOI disposition to be assigned to all signals, you may submit the TOI assignment (the preview does not guarantee that the shown TOI numbers are what will be assigned).

Notes

• ¹These commands are isolated in PostgreSQL transactions; any changes will be rolled back if any error occurs.