{"id":19180491,"url":"https://github.com/fjankowsk/meertrapdb","last_synced_at":"2026-04-21T03:32:00.467Z","repository":{"id":65940651,"uuid":"602972955","full_name":"fjankowsk/meertrapdb","owner":"fjankowsk","description":"Database backend and survey analysis code for MeerTRAP.","archived":false,"fork":false,"pushed_at":"2023-07-05T13:42:20.000Z","size":1808,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-05T12:38:03.897Z","etag":null,"topics":["astronomy","astronomy-astrophysics","database","fastradiobursts","pulsars","survey","survey-analysis"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fjankowsk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-17T10:46:07.000Z","updated_at":"2024-11-20T19:08:32.000Z","dependencies_parsed_at":"2023-09-27T11:53:26.012Z","dependency_job_id":null,"html_url":"https://github.com/fjankowsk/meertrapdb","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/fjankowsk/meertrapdb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjankowsk%2Fmeertrapdb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjankowsk%2Fmeertrapdb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjankowsk%2Fmeertrapdb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjankowsk%2Fmeertrapdb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fjankowsk","download_url":"https://codeload.github.com/fjankowsk/meertrapdb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjankowsk%2Fmeertrapdb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32075225,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T02:38:07.213Z","status":"ssl_error","status_checked_at":"2026-04-21T02:38:06.559Z","response_time":128,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astronomy","astronomy-astrophysics","database","fastradiobursts","pulsars","survey","survey-analysis"],"created_at":"2024-11-09T10:49:51.826Z","updated_at":"2026-04-21T03:32:00.462Z","avatar_url":"https://github.com/fjankowsk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MeerTRAP Database Backend #\n\nThis repository contains the database backend code for the [MeerTRAP project](https://www.meertrap.org/) at the MeerKAT telescope. The code is mainly developed for Python 3, but Python 2 from version 2.7 onwards should work fine.\n\n## Author ##\n\nThe software is primarily developed and maintained by Fabian Jankowski. For more information feel free to contact me via: fabian.jankowski at manchester.ac.uk.\n\n## Citation ##\n\nIf you make use of the software, please add a link to this repository and cite our upcoming paper. See the CITATION file.\n\n## Installation ##\n\nThe 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:\n\n`pip3 install git+https://github.com/fjankowsk/meertrapdb.git@master`\n\nThis will automatically install all dependencies.\n\n## Known source matching ##\n\nThe `psrmatch` known source matching code has been moved into a [separate repository](https://github.com/fjankowsk/psrmatch/).\n\n## Sky map data handling ##\n\nThe `skymap` code to create, handle, and visualise sky map (e.g. HEALPix) data has been moved into a [separate repository](https://github.com/fjankowsk/skymap/).\n\n## Multi-beam clustering ##\n\nThe 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:\n\n```python\nfrom meertrapdb.clustering import Clusterer\n\nclust = Clusterer()\ninfo = clust.match_candidates(candidates)\n```\n\n## Usage ##\n\n```bash\n$ meertrapdb-benchmark_clusterer\n```\n\n```bash\n$ meertrapdb-cluster_multibeam -h\nusage: meertrapdb-cluster_multibeam [-h] [--dm DM] [--time TIME] [--spccl_version SPCCL_VERSION] filename\n\nPerform multi-beam candidate clustering.\n\npositional arguments:\n  filename\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --dm DM               Fractional DM tolerance. (default: 0.02)\n  --time TIME           Time tolerance for matching in milliseconds. (default: 10.0)\n  --spccl_version SPCCL_VERSION\n                        The version of the input SPCCL file. (default: 2)\n```\n\n```bash\n$ meertrapdb-make_plots -h\nusage: meertrapdb-make_plots [-h] [--version] {heimdall,knownsources,sifting,skymap,timeline,timeonsky}\n\nMake plots from database.\n\npositional arguments:\n  {heimdall,knownsources,sifting,skymap,timeline,timeonsky}\n                        Mode of operation.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --version             show program's version number and exit\n```\n\n```bash\n$ meertrapdb-parse_datadump -h\nusage: meertrapdb-parse_datadump [-h] [--enddate YYYY-MM-DDThh:mm:ss]\n\nProcess the sensor data dump.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --enddate YYYY-MM-DDThh:mm:ss\n                        Process sensor data until this UTC date in ISOT format. (default: None)\n```\n\n```bash\n$ meertrapdb-populate_db -h\nusage: meertrapdb-populate_db [-h] [-s SCHEDULE_BLOCK] [-t] [-v] [--version] {fake,init_tables,known_sources,production,sift,parameters}\n\nPopulate the database.\n\npositional arguments:\n  {fake,init_tables,known_sources,production,sift,parameters}\n                        Mode of operation.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -s SCHEDULE_BLOCK, --schedule_block SCHEDULE_BLOCK\n                        The schedule block ID to use. (default: None)\n  -t, --test_run        Do neither move, nor copy files. This flag works with \"production\" mode only. (default: False)\n  -v, --verbose         Get verbose program output. This switches on the display of debug messages. (default: False)\n  --version             show program's version number and exit\n```\n\n```bash\n$ meertrapdb-search_knownsources\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffjankowsk%2Fmeertrapdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffjankowsk%2Fmeertrapdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffjankowsk%2Fmeertrapdb/lists"}