OVRO-LWA Fast Transients

This repository contains the code for the OVRO-LWA Fast Transients project.

Description

The project is dedicated to building pipelines that aim to detect and analyze fast transients with the OVRO-LWA.

Quick Start

Installation

To run the pipeline, the following software needs to be installed:

• LWA Software Library
• PSRFITS utils
• LWA1 Pulsar Scripts
• Your Unified Reader
• High dimensional Interactive Plotting
• PyTorch Dedispersion

Basic Usage

1. Prepare JSON MetaData

   python src/prepare_metadata.py --file_name <file_name> --ra <RA> --dec <DEC> --dm <DM> --lo_dm <loDM> --hi_dm <hiDM> --json_file <path_to_json_file>

2. Run the Search Pipeline

   python src/pipeline.py <path_to_json_file> <path_to_checkpoint_file>

For detailed instructions, visit the Wiki.

Key Features

• Conversion: Channelizes and converts voltage beam files to filterbank .fil format.
• RFI Filtering: Applies RFI filtering on the created filterbank file.
• Dedispersion: Processes the filterbank file to generate dedispersed data and finds candidates.
• Visualization: Uses HiPlot to visualize the candidate detections.

Configuration

Create a config.ini file with the necessary paths (see config.ini.template).

Links

• Wiki - Detailed documentation, troubleshooting, and advanced usage.

Logs

Check pipeline.log for detailed information about the execution of each step.

License

This project is licensed under the MIT License (LICENSE).