TOI-Process.md

+# 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:
+```bash
+$ 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.
+```bash
+$ 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<sup>1</sup>:
+
+```bash
+$ {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
+-----
+- <sup>1</sup>These commands are isolated in PostgreSQL transactions; any changes will be rolled back if any error occurs.
\ No newline at end of file