Revision 177e66fb023362fceeb3f99605c9433c864d8529 authored by Christopher M. Biwer on 07 June 2017, 17:06:29 UTC, committed by Collin Capano on 07 June 2017, 17:06:29 UTC
1 parent 705c6da
index.rst
.. PyCBC documentation master file, created by
sphinx-quickstart on Tue Jun 11 17:02:52 2013.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
===============
Getting Started
===============
PyCBC is a software package used to explore astrophysical sources of gravitational waves. It contains algorithms that can detect coalescing compact binaries and measure the astrophysical parameters of detected sources. PyCBC was used in the `first direct detection of gravitational waves (GW150914) by LIGO <https://journals.aps.org/prl/abstract/10.1103/PhysRevLett.116.061102>`_ and is used in the ongoing analysis of LIGO and Virgo data. If you use PyCBC in your scientific publications or projects, we ask that you acknowlege our work by citing the papers described on the page:
.. toctree::
:maxdepth: 1
credit
If you have `Docker <https://www.docker.com/community-edition>`_ installed, you can get started using PyCBC with just two commands:
.. raw:: html
<script type="text/javascript">
document.addEventListener("DOMContentLoaded", function(){
Typed.new(".element", {
strings: ["^500<strong>docker pull pycbc/pycbc-el7:latest</strong><br>$ ^500<strong>docker run -it pycbc/pycbc-el7:latest /bin/bash -l</strong><br>(pycbc-software)[pycbc@37184573e664 ~]$ ^500<strong>python</strong><br>Python 2.7.5 (default, Nov 6 2016, 00:28:07)<br>[GCC 4.8.5 20150623 (Red Hat 4.8.5-11)] on linux2<br>>>> ^500<strong>execfile("/home/pycbc/src/pycbc/examples/waveform/match_waveform.py")</strong><br>^1000The match is: 0.953<br>>>> ^500<strong>from pycbc.waveform import td_approximants</strong><br>>>> ^500<strong>print td_approximants()[20:24]</strong><br>['SEOBNRv3', 'SEOBNRv2', 'SpinTaylorT1', 'SEOBNRv4']<br>>>> "],
typeSpeed: 0
});
});
</script>
<div class="text-editor-wrap">
<div class="title-bar"><span class="title">pycbc — bash — 80x<span class="terminal-height">25</span></span></div>
<div class="text-body">
$ <span class="element"></span>
</div>
</div>
<br>
<br>
For more details, including instructions on starting a container that can display graphics, see:
.. toctree::
:maxdepth: 1
docker
===========
About PyCBC
===========
The goals of the PyCBC project are:
- Provide reliable and robust tools for building gravitational-wave search and parameter estimation workflows for CBCs.
- Create a flexible, extensible production code for CBC analysis that can be released for the public.
- Enable simple, easy and transparent access for various many-core architectures like GPUs.
Full installation instructions for users who want to install and develop PyCBC are available at:
.. toctree::
:maxdepth: 1
install
=======================
Documentation for Users
=======================
Users who want to create and run scientific workflows to search for compact
binaries should read the documentation in the links at:
.. toctree::
:maxdepth: 1
workflow/pycbc_make_psd_estimation_workflow
workflow/pycbc_make_coinc_search_workflow
workflow/pygrb.rst
Users who want to create and run parameter estimation workflows should read the
documentation at:
.. toctree::
:maxdepth: 1
workflow/pycbc_make_inference_workflow
Users who are interested in tools that PyCBC provides for various other
analysis tasks (e.g. template bank generation, hardware injections, and testing
template banks) should read the documentation at:
.. toctree::
:maxdepth: 1
tmpltbank
inference
hwinj
banksim
faithsim
upload_to_gracedb
Users who are intersted in using PyCBC utilities and functions should take a look at the
short code snippets below.
.. toctree::
:maxdepth: 2
gw150914
frame
psd
noise
waveform
filter
distributions
=============================
Documentation for Developers
=============================
Documentation on building stand-alone bundled executables with PyInstaller is available at:
.. toctree::
:maxdepth: 1
building_bundled_executables
PyCBC developers should read the pages below which explain how to write
documentation, develop the code, and create releases:
.. toctree::
:maxdepth: 1
documentation
release
Developers who are interested in file I/O, data storage, and access should
read the documentation at:
.. toctree::
:maxdepth: 1
formats/hdf_format
Developers who are interested in creating new scientific workflow generation
scripts should read the documentation at:
.. toctree::
:maxdepth: 1
workflow
Full Module Documentation is avaialable at:
.. toctree::
:maxdepth: 1
modules
===================
Indexes and Tables
===================
* :ref:`modindex`
* :ref:`genindex`
Computing file changes ...