closes #34

This patch provides a new nb sub-module that defines classes for managing
and calculating noise budgets.  It provides the following overridable
classes:

nb.Calibration  A noise calibration
nb.Noise        A noise source
nb.Budget       A budget of noises

The Budget class includes a calc_trace() method that will return a traces
dictionary that includes data and trace plot styling for every noise term
in the budget recursively.

The existing included interferometers are updated to define their budgets
using this new interface, and the plot_noises function is updated to
accept the new traces dictionary.

An HDF5_SCHEMA describes how trace dictionaries are encoded into HDF5 files.
The new io module includes functions for writing traces to HDF5 files, and
for reading traces stored in this format.

The command line interface is updated to handle this new structure.

This is ultimately to remove assumptions about what is being plotted from
the plotting function.

The gwinc_matlab function itself is not being touched, but the gwinc function
is being relegated to legacy with the upcoming nb.Budget interface.

Evan Hall authored 5 years ago and Jameson Rollins committed 5 years ago

It is calculated if the YAML model include an 'Atmospheric' section that describes the atmospheric intrasound spectrum and coupling.

Based on Harms LRR (2015), eq. 172 [https://doi.org/10.1007/lrr-2015-3]

Thermal noise still needs attention

Jameson Graef Rollins authored 6 years ago and Jameson Rollins committed 6 years ago

for consistency with all other noise calculation functions.

This reverts commit 4a60fc58.

This was not an appropriate fix to whatever was needing to be addressed.

returns list of (param, value, other_value) tuples.

command line interface added as well.

This is not elegant, but it works.

--dump option was not working anyway because of changes to precompIFO (which
hopefully will be going away).  text output now does not do precomp.

matplotlib.pyplot throws a RuntimeError when no display is present.  One
way around that is to set the backend to AGG.  But we don't want AGG when
we do have a display.  So we only want to set it opportunistically.  But
it also has to be set before anything else is imported.  Kind of convoluted.

So we really just import pyplot as opportunistically as possible, and then
rely on setting AGG backend when we're sure we don't need it in main().

All noise calculation functions in pygwinc take the arguments (freq, ifo)
in that order.  It's annoying that for some reason this one is different.

The products of precompQuantum (primarily fSQL) are currently only
used in squeeze.py (which is itself not used anywhere).  Remove this
function from preocomp, and move relevant bits into squeeze.py

Also remove unused variables in precompPower that could confuse
memoization.

adds CI documentation builder

See merge request !27