# Introduction¶

## Purpose¶

geco_stat can be used to easily generate histograms, statistics, and anomaly reports for timing signals generated by LIGO interferometers. It is meant to simplify the handling of massive amounts of diagnostic data by providing a simple, organized interface to relevant statistics, easy progress tracking for large jobs, effortless data visualization, and convenient ways to combine reports, so that very long timeseries can be efficiently analyzed in parallel and then recombined into single, monolithic reports covering entire eras.

Future versions of geco_statistics will also provide tools for automating report generation, reducing the amount of effort that has to go into creating reports on LIGO’s functioning.

## Intended Use Cases¶

This is a python-2.6 compatible Python module intended for use in LIGO production environments. Its python dependencies are minimal, which means it should work out of the box on most python distributions for viewing and manipulating existing reports generated using the package. At time of writing, generating new reports requires tools installed in LIGO production environments; it is intended primarily to be run on LIGO servers, though future implementations may integrate remote access tools.

If you are just interested in viewing existing diagnostic report data, you can use Python, though iPython is recommended for interactive use. You can install iPython from the project website. If you are running this module on a LIGO production environment, no additional dependencies should be necessary.

## Getting Started¶

Install with pip:

pip install --upgrade geco-stats


If you don’t have root privileges (as is probably the case on a LIGO server), change to the directory where you would like to work and run:

virtualenv env
source env/bin/activate

When you are done using your virtualenv, you can run deactivate to go back to using your regular system install of python and associated tools.