MeerTRAP Database Backend

This repository contains the database backend code for the MeerTRAP project at the MeerKAT telescope. The code is mainly developed for Python 3, but Python 2 from version 2.7 onwards should work fine.

Author

The software is primarily developed and maintained by Fabian Jankowski. For more information feel free to contact me via: fabian.jankowski at manchester.ac.uk.

Citation

If you make use of the software, please add a link to this repository and cite our upcoming paper. See the CITATION file.

Installation

The easiest and recommended way to install the software is through pip directly from its GitHub repository. For example, to install the master branch of the code, use the following command:

pip3 install git+https://github.com/fjankowsk/meertrapdb.git@master

This will automatically install all dependencies.

Known source matching

The psrmatch known source matching code has been moved into a separate repository.

Sky map data handling

The skymap code to create, handle, and visualise sky map (e.g. HEALPix) data has been moved into a separate repository.

Multi-beam clustering

The repository contains a module to cluster (or sift) single-pulse candidates detected in multiple beams, based on their proximity in time and fractional dispersion measure. The parameters of the temporal width of the matching box and the fractional DM threshold can be tweaked as required. Example usage is like this:

```python from meertrapdb.clustering import Clusterer

clust = Clusterer() info = clust.match_candidates(candidates) ```

Usage

bash $ meertrapdb-benchmark_clusterer

```bash $ meertrapdb-clustermultibeam -h usage: meertrapdb-clustermultibeam [-h] [--dm DM] [--time TIME] [--spcclversion SPCCLVERSION] filename

Perform multi-beam candidate clustering.

positional arguments: filename

optional arguments: -h, --help show this help message and exit --dm DM Fractional DM tolerance. (default: 0.02) --time TIME Time tolerance for matching in milliseconds. (default: 10.0) --spcclversion SPCCLVERSION The version of the input SPCCL file. (default: 2) ```

```bash $ meertrapdb-makeplots -h usage: meertrapdb-makeplots [-h] [--version] {heimdall,knownsources,sifting,skymap,timeline,timeonsky}

Make plots from database.

positional arguments: {heimdall,knownsources,sifting,skymap,timeline,timeonsky} Mode of operation.

optional arguments: -h, --help show this help message and exit --version show program's version number and exit ```

```bash $ meertrapdb-parsedatadump -h usage: meertrapdb-parsedatadump [-h] [--enddate YYYY-MM-DDThh:mm:ss]

Process the sensor data dump.

optional arguments: -h, --help show this help message and exit --enddate YYYY-MM-DDThh:mm:ss Process sensor data until this UTC date in ISOT format. (default: None) ```

```bash $ meertrapdb-populatedb -h usage: meertrapdb-populatedb [-h] [-s SCHEDULEBLOCK] [-t] [-v] [--version] {fake,inittables,known_sources,production,sift,parameters}

Populate the database.

positional arguments: {fake,inittables,knownsources,production,sift,parameters} Mode of operation.

optional arguments: -h, --help show this help message and exit -s SCHEDULEBLOCK, --scheduleblock SCHEDULEBLOCK The schedule block ID to use. (default: None) -t, --testrun Do neither move, nor copy files. This flag works with "production" mode only. (default: False) -v, --verbose Get verbose program output. This switches on the display of debug messages. (default: False) --version show program's version number and exit ```

bash $ meertrapdb-search_knownsources