From 33612e37d9286938383674ac6d4ff8b3d729b798 Mon Sep 17 00:00:00 2001
From: Eric Kooistra <kooistra@astron.nl>
Date: Tue, 25 Jul 2023 15:42:26 +0200
Subject: [PATCH] Add block diagram.

---
 .../base/common/python/try_round_weight.py    | 21 ++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/libraries/base/common/python/try_round_weight.py b/libraries/base/common/python/try_round_weight.py
index 08c79bfb2b..fddf03dfaf 100755
--- a/libraries/base/common/python/try_round_weight.py
+++ b/libraries/base/common/python/try_round_weight.py
@@ -65,7 +65,26 @@ import matplotlib.pyplot as plt
 # Parse arguments to derive user parameters
 _parser = argparse.ArgumentParser(
     description="".join(textwrap.dedent("""\
-        Model effect of applying a weight after or before rounding:
+        Model effect of applying a weight on input noise after or before rounding,
+        for range of input noise sigma and range of weights:
+
+                 sigma
+                   |      2**resolution       1/2**resolution
+                   |       |                   |
+                   v       v                   v
+                 -----   -----   ---------   -----  noise_q   -----   ---------   -------
+        noise -->| X |-->| X |-->| round |-->| X |----------->| X |-->| round |-->| std |--> sigma_qq
+                 ----- | -----   ---------   -----            -----   ---------   -------
+                       |                                        ^
+                       |                                        |
+                       |                            weight ---->|
+                       |                                        |
+                       |                            noise_s   -----   ---------   -------
+                       |------------------------------------->| X |-->| round |-->| std |--> sigma_sq
+                                                              -----   ---------   -------
+
+        sigmas_ratio_qq_sq = sigma_qq / sigma_sq --> shows jumps and variation around 1 when resolution is low
+        sigmas_ratio_sq_input = sigma_sq / sigma --> shows that rounding causes change in sigma
 
         . weights in range(w_lo, w_hi, w_step)
         . sigma of noise in range(s_lo, s_hi, s_step)
-- 
GitLab