Metadata-Version: 1.1
Name: gwopensci
Version: 0.1.1
Summary: A python interface to the GW Open Science data archive
Home-page: https://github.com/duncanmmacleod/gwopensci
Author: Duncan Macleod
Author-email: duncan.macleod@ligo.org
License: MIT
Description-Content-Type: UNKNOWN
Description: |PyPI Release| |Zenodo DOI| |License| |Python Versions|
        
        |Build Status| |Coverage Status|
        
        The ``gwopensci`` package provides an interface to querying and discovering
        data files hosted on https://losc.ligo.org as part of the open data
        releases from the LIGO and Virgo gravitational-wave observatories.
        
        To install:
        
        ::
        
            pip install gwopensci
        
        Query by event name
        -------------------
        
        You can search for remote data URLS based on the event name:
        
        .. code:: python
        
            >>> from gwopensci.locate import get_event_urls
            >>> get_event_urls('GW150914')
            ['https://losc.ligo.org//s/events/GW150914/H-H1_LOSC_4_V2-1126259446-32.hdf5', 'https://losc.ligo.org//s/events/GW150914/L-L1_LOSC_4_V2-1126259446-32.hdf5', 'https://losc.ligo.org//s/events/GW150914/H-H1_LOSC_4_V2-1126257414-4096.hdf5', 'https://losc.ligo.org//s/events/GW150914/L-L1_LOSC_4_V2-1126257414-4096.hdf5']
        
        You can down-select the URLs using keyword arguments:
        
        .. code:: python
        
            >>> get_event_urls('GW150914', detector='L1', duration=32)
            ['https://losc.ligo.org//s/events/GW150914/L-L1_LOSC_4_V2-1126259446-32.hdf5']
        
        Query by GPS interval
        ---------------------
        
        You can search for remote data URLs based on the GPS time interval as
        follows:
        
        .. code:: python
        
            >>> from gwopensci.locate import get_urls
            >>> get_urls('L1', 968650000, 968660000)
            ['https://losc.ligo.org/archive/data/S6/967835648/L-L1_LOSC_4_V1-968646656-4096.hdf5', 'https://losc.ligo.org/archive/data/S6/967835648/L-L1_LOSC_4_V1-968650752-4096.hdf5', 'https://losc.ligo.org/archive/data/S6/967835648/L-L1_LOSC_4_V1-968654848-4096.hdf5', 'https://losc.ligo.org/archive/data/S6/967835648/L-L1_LOSC_4_V1-968658944-4096.hdf5']
        
        This arguments for this function are as follows
        
        -  ``detector`` : the prefix of the relevant gravitational-wave
           interferometer, either ``'H1'`` for LIGO-Hanford, or ``'L1'`` for
           LIGO Livingston,
        -  ``start``: the GPS start time of the interval of interest
        -  ``end``: the GPS end time of the interval of interest
        
        By default, this method will return the paths to HDF5 files for the 4
        kHz sample-rate data, these can be specified as keyword arguments. For
        full information, run
        
        .. code:: python
        
            >>> help(get_urls)
        
        Query for Timeline segments
        ---------------------------
        
        You can also search for Timeline segments, based on a flag name, and a
        GPS time interval as follows:
        
        .. code:: python
        
            >>> from gwopensci.timeline import get_segments
            >>> get_segments('H1_DATA', 1126051217, 1126151217)
            [(1126073529, 1126114861), (1126121462, 1126123267), (1126123553, 1126126832), (1126139205, 1126139266), (1126149058, 1126151217)]
        
        The output is a ``list`` of ``(start, end)`` 2-tuples which each
        represent a semi-open time interval.
        
        For documentation on what flags are available, for example for the O1
        science run, see `the O1 data release
        page <https://losc.ligo.org/O1/>`__ (*Data Quality*).
        
        .. |PyPI Release| image:: https://badge.fury.io/py/gwopensci.svg
           :target: http://badge.fury.io/py/gwopensci
        .. |Zenodo DOI| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.1196306.svg
           :target: https://doi.org/10.5281/zenodo.1196306
        .. |License| image:: https://img.shields.io/pypi/l/gwopensci.svg
           :target: https://choosealicense.com/licenses/mit/
        .. |Python Versions| image:: https://img.shields.io/pypi/pyversions/gwopensci.svg
        .. |Build Status| image:: https://travis-ci.org/duncanmmacleod/gwopensci.svg?branch=develop
           :target: https://travis-ci.org/duncanmmacleod/gwopensci
        .. |Coverage Status| image:: https://coveralls.io/repos/github/duncanmmacleod/gwopensci/badge.svg?branch=develop
           :target: https://coveralls.io/github/duncanmmacleod/gwopensci?branch=develop
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: License :: OSI Approved :: MIT License
