is the command-line tool for initialising and running the TraP pipeline. Different tasks are handled via the use of ‘subcommands’ as detailed below.

When the TraP is correctly installed on the system you can issue the command. Documentation of subcommands is also available on the command line. You can use the --help flag (also per subcommand) to explore all possible options.

A tool for managing TKP projects.

Use ‘initproject’ to create a project directory. Other Subcommands should be run from within a project directory.

NB: To overwrite the database settings in pipeline.cfg you can use these environment variables to configure the connection:


(This is useful for setting up test databases, etc.)

usage: [-h] {initproject,initjob,run,initdb} ...



Initialize a pipeline project directory, complete with config files which you can use to configure your pipeline. initproject [-h] [-t TARGET] name

Positional Arguments

name project folder name

Named Arguments

-t, --target location of new TKP project


Create a job folder, complete with job-specific config files which you will need to modify. initjob [-h] name

Positional Arguments

name Name of new job


Run a job by specifying the name of the job folder. run [-h] [-m MONITOR_COORDS] [-l MONITOR_LIST] name

Positional Arguments

name Name of job to run

Named Arguments

-m, --monitor-coords
 a list of RA,DEC coordinates to monitor in JSON format, example: [[5, 6], [7, 8]]
-l, --monitor-list
 Specify a file containing a list of RA,DEC


Initialize a database with the TKP schema. initdb [-h] [-y] [-d]

Named Arguments

-y, --yes

don’t ask for confirmation

Default: False

-d, --destroy

remove all tables before population(only works with Postgres backend)

Default: False