.. currentmodule:: gwpy.timeseries

########################
Filtering a `TimeSeries`
########################

Much of the real-time control system of the LIGO interferometers is handled by monitoring and filtering time-series data.
Additionally, in gravitational-wave analysis, the interesting frequency bands for a given search can be a sub-set of the full bandwidth of the instruments.
In both cases it is required to apply time-domain filters to some data in order to extract the most useful information.

===========
Bandpassing
===========

The following methods of the `TimeSeries` provide functionality for band-passing data:

.. autosummary::

   TimeSeries.lowpass
   TimeSeries.highpass
   TimeSeries.bandpass

=================
General filtering
=================

While the above methods provide an easy way to remove unwanted frequency information, the :meth:`~TimeSeries.zpk` and, more generally, :meth:`~TimeSeries.filter` methods provide a way to apply a general filters to any `TimeSeries` data:

.. autosummary::

   TimeSeries.zpk
   TimeSeries.filter

========
Examples
========

See the following examples for usage of the above functions:

.. toctree::
   :maxdepth: 1

   ../examples/timeseries/filter