summaryclassification

The summaryclassification executable allows the user to generate source based classification probabilities given the samples in a GW specific result file by interacting with the pesummary.gw.pepredicates and pesummary.gw.p_astro modules and PEPredicates and ligo.em-bright packages.

To see help for this executable please run:

$ summaryclassification --help
usage: summaryclassification [-h] [-w DIR] [-s SAMPLES [SAMPLES ...]]
                             [--labels LABELS [LABELS ...]]
                             [--prior {population,default,both}]
                             [--plot {bar,mass_1_mass_2}] [--seed SEED]

This executable is used to generate a txt file containing the source
classification probailities

optional arguments:
  -h, --help            show this help message and exit
  -w DIR, --webdir DIR  make page and plots in DIR
  -s SAMPLES [SAMPLES ...], --samples SAMPLES [SAMPLES ...]
                        Path to posterior samples file(s). See documentation
                        for allowed formats. If path is on a remote server,
                        add username and servername in the form
                        {username}@{servername}:{path}. If path is on a public
                        webpage, ensure the path starts with https://. You may
                        also pass a string such as posterior_samples*.dat and
                        all matching files will be used
  --labels LABELS [LABELS ...]
                        labels used to distinguish runs
  --prior {population,default,both}
                        Prior to use when calculating source classification
                        probabilities
  --plot {bar,mass_1_mass_2}
                        Name of the plot you wish to make
  --seed SEED           Random seed to used through the analysis.

Generating classification probabilities

Below is an example of the output from summary summaryclassification on a result file,

$ summaryclassification --webdir ./ --samples posterior_samples.hdf5 \
                        --labels GW150914
$ ls ./
GW150914_default_prior_pe_classification.json
GW150914_population_prior_pe_classification.json
GW150914_population_pepredicates_bar.png

pesummary.gw.pepredicates

pesummary.gw.p_astro