Command Line Interface¶

asimov-gwdata provides a command-line interface for downloading gravitational wave data.

gwdata Command¶

The main command-line tool for downloading gravitational wave data.

gwdata¶

Usage

gwdata [OPTIONS]

Options

--settings <settings>¶

Usage Examples¶

Basic Usage¶

To download data using a configuration file:

$ gwdata --settings config.yaml

Example Configuration Files¶

Downloading Frames¶

Example configuration for downloading gravitational wave strain data:

interferometers:
  - H1
  - L1
time:
  start: 1126259462
  end: 1126259478
  duration: 4096
data:
  - frames

Downloading Posterior Samples¶

Example configuration for extracting posterior samples from a PESummary metafile:

data:
  - posterior
source:
  type: pesummary
  location: /path/to/posterior_samples.h5
  analysis: C01:IMRPhenomXPHM

Downloading PSDs¶

Example configuration for extracting PSDs from a PESummary metafile:

data:
  - psds
source:
  type: pesummary
  location: /path/to/posterior_samples.h5
  analysis: C01:IMRPhenomXPHM

Downloading Calibration¶

Example configuration for downloading calibration uncertainty envelopes:

interferometers:
  - H1
  - L1
  - V1
time:
  start: 1126259462
  end: 1126259478
  duration: 32
data:
  - calibration
locations:
  calibration directory: /home/cal/archive/
calibration version: v1

Combined Download¶

You can download multiple data types in a single configuration:

interferometers:
  - H1
  - L1
time:
  start: 1126259462
  end: 1126259478
  duration: 4096
data:
  - frames
  - calibration
  - psds
source:
  type: pesummary
  location: /path/to/posterior_samples.h5
  analysis: C01:IMRPhenomXPHM
locations:
  calibration directory: /home/cal/archive/
calibration version: v1