Adds residual gas damping and additional molecular species to the residual gas calculations. The gas scattering and gas damping are now tracked separately for each species in an excess gas sub-budget. The damping calculation is done in the infinite volume limit by default but adds corrections for squeezed film damping if specified in the yaml file.

H2, N2, H2O, and O2 are considered. The numbers for aLIGO are taken from the link in this commit. The numbers for Aplus and Voyager are copied from aLIGO.  For the existing LIGO facilities the O2 numbers are unknown but are suspected to be low, and are therefore set 10x below the expected noise floor.

Closes #63.

We don't want to advertise these parameters yet, since they will
likely be changed to support different loss functions.

Anchal Gupta authored 4 years ago and Jameson Rollins committed 4 years ago

Modified getCoatBrownian() to accept different Bulk and Shear Loss
Angles and calculate brownian noise using Hong et a. PRD 87, 082001
(2013).

New Function description:
This function calculates Coating ThermoOptic noise using
Hong et al . PRD 87, 082001 (2013).
All references to 'the paper', 'Eq' adn 'Sec' are to this paper.

***Important Note***
Inside this function phi is used for denoting the phase shift suffered
by light in one way propagation through a layer. This is in conflict
with present nomenclature everywhere else where it is used as loss
angle.

The layers are assumed to be alernating low-n high-n layers, with
low-n first.
Inputs:
         f = frequency vector in Hz
       ifo = parameter struct from IFOmodel.m
     wBeam = beam radius (at 1 / e^2 power)
      dOpt = the optical thickness, normalized by lambda, of each
             coating layer.
New required arguments:
       mTi = Mirror Transmittance
        Ic = Circulating Laser Power falling on the Mirror (W)
The following new arguments should be made available in the Materials
object and lines 108-110 and 116-118 should be uncommented:
 lossBlown = Coating Bulk Loss Angle of Low Refractive Index layer
 lossSlown = Coating Shear Loss Angle of Low Refractive Index layer
lossBhighn = Coating Bulk Loss Angle of High Refractive Index layer
lossShighn = Coating Shear Loss Angle of High Refractive Index layer
   PETlown = Relevant component of Photoelastic Tensor of High n layer*
  PEThighn = Relevant component of Photoelastic Tensor of Low n layer*
Returns:
SbrZ = Brownian noise spectra for one mirror in m^2 / Hz

*
Default values of PETlown and PEThighn are chosen from sec. A.1. to get
the longitudnal coefficent of photoelasticity as -0.5 as been asserted
by the paper there for Tantala and -0.27 for Silica.
These values also need to be added in Materials object.

Nicholas Demos authored 4 years ago and Jameson Rollins committed 4 years ago

From MIT coating thermal noise experiment results:
* https://dcc.ligo.org/LIGO-G2000880
and LMA 2020 paper:
* https://iopscience.iop.org/article/10.1088/1361-6382/ab77e9

Addresses #52 (pending measurements for A+ test masses)

As was done in matgwinc some months ago

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.

(addresses #23)

Implements the changes recommended by Jan Harms in https://git.ligo.org/rana-adhikari/CryogenicLIGO/issues/45
Fixes #18

Improves readbility.  use translation for MATLAB purposes.

Infrastructure is obviously where it really belongs.  This also allows us
to almost eliminate the need for the Constants struct on our side.

ifo.Suspension.Type now accepts string for suspension calc func, e.g. 'Quad'
for 'suspQuad' calc.

Updates to materials parameters for new thermal noise estimate, and SRM and
PD params.

 https://dcc.ligo.org/LIGO-T1800044

no functional change

This is now commensurate with what matlab gwinc does, and makes the IFO
structures directly comparable without any hacky conversions.

This adds a Struct() class that mimics a MATLAB struct by storing values as
class attributes, but also includes methods for converting to/from dicts,
yaml, and mat_struct objects.

A convenience function load_ifo() is included to load an ifo definition
either from a .yaml or .mat file or from an included <ifo>.yaml.

An 'aLIGO.yaml' definition is included.