From 01e4f9004c0de624dacea5ab73c9c66f01c6f37a Mon Sep 17 00:00:00 2001
From: Jameson Graef Rollins <jrollins@finestructure.net>
Date: Thu, 13 Feb 2020 08:53:50 -0800
Subject: [PATCH] nb: clarify use of calibrations on references

---
 gwinc/nb.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/gwinc/nb.py b/gwinc/nb.py
index f6c650ee..be0be4bf 100644
--- a/gwinc/nb.py
+++ b/gwinc/nb.py
@@ -212,13 +212,13 @@ class Budget(Noise):
     """
 
     noises = []
-    """List of constituent noise classes"""
+    """List of constituent noise classes, or (noise, cal) tuples"""
 
     calibrations = []
-    """List of calibrations to be applied to all noises in budget"""
+    """List of calibrations to be applied to all budget noises (not references)"""
 
     references = []
-    """List of reference nosie classes"""
+    """List of reference noise classes, or (ref, cal) tuples"""
 
     def __init__(self, *args, noises=None, **kwargs):
         """Initialize Budget object.
@@ -253,10 +253,10 @@ class Budget(Noise):
         for nc in self.noises:
             name = self.__init_noise(nc, noises)
             self._budget_noises.add(name)
-        # add common calibrations
+        # initialize common calibrations and add to all budget noises
         for cal in self.calibrations:
             self.__add_calibration(cal, self._budget_noises)
-        # add references
+        # initialize references, without common calibrations
         for nc in self.references:
             self.__init_noise(nc, noises)
         # error if requested noise is not present
-- 
GitLab