Use of jupyter-notebook.

applications/lofar2/model/readme_lofar2_model.txt

@@ -5,7 +5,8 @@ Contents:
 1) Original LOFAR1 scripts from FilterTaskForce.zip [1]
 2) Original LOFAR1 documents
 3) Copied from APERTIF [3]
-4) LOFAR2.0
+4) LOFAR2.0 PFB in VHDL
+5) LOFAR2.0 Python notebooks for quantization and statistics
 
 
 References:
@@ -27,7 +28,7 @@ References:
      coefficients is not available anymore (For Apertif Erko looked in old
      repositories back to 2005 of Lofar software and Station firmware
      but could not find it.)
-                                                                      
+
 - pfs_coeff_final.m [1]
      creates Coefficient_16KKaiser.dat, but using e.g. meld shows that
      these do differ slightly within +-40 from
@@ -58,7 +59,20 @@ APERTIF uses the same PFB FIR coefficients as LOFAR1.
                                      time and frequency domain, and optionally calls pfir_coeff_dc_adjust.m
 
 
+4) LOFAR2.0 PFB in VHDL
+
+- tb_tb_verify_pfb_wg.vhd, 2021 [4] : VHDL simulation of LOFAR1 PFB2 (pfb2_unit.vhd) and APERTIF WPFB
+                                      (wpfb_unit_dev.vhd) for LOFAR2.0
+
+
+5) LOFAR2.0 Python notebooks for quantization and statistics
+
+- lofar2_station_sdp_firmware_model.ipynb: SDP FW quantization levels
+- signal_statistics.ipynb: SNR improvement for beamformer, correlator and powers
 
-4) LOFAR2.0
+The notebook results are used in [1]. Start Jupyter notebook kernel with:
+> jupyter-notebook &
+and then navigate to the notebook script in the browser and open it.
+The results of the ipynb runs are stored as html files with the same name.
 
-- tb_tb_verify_pfb_wg.vhd, 2021 [4] : VHDL simulation of LOFAR1 PFB2 and APERTIF WPFB for LOFAR2.0
+[1] "L4 SDPFW Decision: LOFAR2.0 SDP Firmware Quantization Model", https://support.astron.nl/confluence/pages/viewpage.action?spaceKey=L2M&title=L4+SDPFW+Decision%3A+LOFAR2.0+SDP+Firmware+Quantization+Model

doc/erko_howto_tools.txt

@@ -1472,6 +1472,10 @@ https://www.dataquest.io/blog/advanced-jupyter-notebooks-tutorial/
 
 uses Markdown
 
+Start Jupyter notebook kernel for LOFAR2 quantization and statistics models with:
+> jupyter-notebook &
+and then navigate to the notebook script in the browser and open it.
+
 Startup with:
 > jupyter-lab  # lab is new,