From 973a61377d4ab46cc9af958e481b303892e49ad8 Mon Sep 17 00:00:00 2001
From: Karim Ahmed <karim.ahmed@xfel.eu>
Date: Tue, 18 Apr 2023 12:26:52 +0200
Subject: [PATCH] convert ipynb to md

---
 ...ow_to_write_xfel_calibrate_notebook_NBC.md | 255 ++++++++++++++++++
 docs/requirements.txt                         |   1 -
 docs/static/webservice_job_db.png             | Bin 0 -> 60370 bytes
 mkdocs.yml                                    |   5 +-
 4 files changed, 256 insertions(+), 5 deletions(-)
 create mode 100644 docs/development/how_to_write_xfel_calibrate_notebook_NBC.md
 create mode 100644 docs/static/webservice_job_db.png

diff --git a/docs/development/how_to_write_xfel_calibrate_notebook_NBC.md b/docs/development/how_to_write_xfel_calibrate_notebook_NBC.md
new file mode 100644
index 000000000..dd050d28c
--- /dev/null
+++ b/docs/development/how_to_write_xfel_calibrate_notebook_NBC.md
@@ -0,0 +1,255 @@
+# How to start writing a calibration notebook
+
+Author: European XFEL Detector Group, Version 0.1
+
+This is an example notebook to point to some common practices used in production notebooks.
+This notebook is using ePix100 detector RAW data to apply offset and gain correction
+
+This is meant to be a starting point on how to write calibration notebooks that can run in production using
+`xfel-calibrate` CLI. However, it is recommended to have a look on some production notebooks residing
+in `/notebooks/` directory which can have more advanced practices that can help you during your notebook development.
+
+
+```python
+# This first code cell must always contain the global notebook parameters.
+# The parameters are parsed as input arguments for `xfel-calibration` command line interface.
+# It is very important to have a comment for each parameter. The comments are not only helpful within the notebook,
+# but they are used the as parameter description when `xfel-calibrate DETECTOR CALIBRATION --help` is used.
+
+in_folder = "/gpfs/exfel/exp/CALLAB/202130/p900203/raw/"  # directory to read data from, required
+out_folder = "/gpfs/exfel/exp/CALLAB/202130/p900203/scratch/how_write_xfel_calibrate_NBC"  # directory to output to, required
+# Adding `required` at the comment here forces the user to add the parameter through the command line,
+# ignoring the default value and only using it as an indication of the expected type.
+run = 9046  # runs to process, required
+
+# Parameters for accessing the raw data.
+karabo_da = "EPIX01"  # Data aggregator names. For multi-modular detectors like AGIPD and LPD, this is a list.
+# To access the correct data files and calibration constants. The karabo_id string is used as a detector identifier.
+karabo_id = "HED_IA1_EPX100-1"  # Detector karabo_id name
+
+# Boolean parameter can be set to False from xfel-calibrate by adding `no-` at the beginning of the boolean parameter name.
+gain_correction = True  # Proceed with gain correction.
+
+# Parameters for the calibration database.
+creation_time = ""  # The timestamp to use with Calibration DB. Required Format: "YYYY-MM-DD hh:mm:ss" e.g. 2019-07-04 11:02:41
+# It is preferred if operating conditions are read from RAW data instead of passed as an input argument.
+bias_voltage = 200  # RAW data bias voltage.
+in_vacuum = False  # Detector operated in vacuum
+photon_energy = 8.048  # Photon energy used for gain calibration
+fix_temperature = 290  # fixed temperature value in Kelvin.
+
+# Parameters affecting writing corrected data.
+chunk_size_idim = 1  # H5 chunking size of output data
+```
+
+
+```python
+from pathlib import Path
+
+# Write after the first python notebook cell. It is a good practice to import all needed libraries and modules.
+# Same as we do in a normal python module.
+import matplotlib.pyplot as plt
+
+import numpy as np
+
+# To access data `extra_data` is used to read RAW/CORR data.
+from extra_data import RunDirectory  # https://extra-data.readthedocs.io/en/latest/
+
+from extra_geom import Epix100Geometry  # https://extra-geom.readthedocs.io/en/latest/
+
+# For parallelization with a notebook it is suggested to use multiprocessing.
+import multiprocessing  # or
+import pasha as psh # https://github.com/European-XFEL/pasha
+# This library uses multiprocessing and provide tight integration with extra_data
+
+# `cal_tools` directory consists of multiple useful functions that are used in many notebooks.
+import cal_tools.restful_config as rest_cfg
+# `calcat_interface` is the main module with functions to retrieve calibration constants from CALCAT.
+from cal_tools.calcat_interface import EPIX100_CalibrationData
+from cal_tools.epix100 import epix100lib
+# `cal_tools.files` is recommended to write corrected data.
+from cal_tools.files import DataFile
+# An internal class to record computation time.
+from cal_tools.step_timing import StepTimer
+# `tools` consists for various number of functions to read files, wrappers for iCalibrationDB, etc ...
+from cal_tools.tools import (
+    calcat_creation_time,
+)
+```
+
+## Prepare global variables.
+
+In the following cells it is a common practice to start assigning global variables,
+like converting in_folder and out_folder to Path objects or initializing step_timer object.
+
+
+```python
+# Convert main folders to Paths.
+in_folder = Path(in_folder)
+out_folder = Path(out_folder)
+# This is only needed in case of running the notebook interactively. Otherwise, the machinery take care of this.
+out_folder.mkdir(parents=True, exist_ok=True)
+run_folder = in_folder / f"r{run:04d}"
+
+# Initiate the main Run data collection.
+run_dc = RunDirectory(
+    run_folder, include="*S00000*").select(f"*{karabo_id}*", require_all=True)
+
+print(f"The available source to correct for {karabo_id} are {list(run_dc.all_sources)}")
+
+step_timer = StepTimer()
+```
+
+    The available source to correct for HED_IA1_EPX100-1 are ['HED_IA1_EPX100-1/DET/RECEIVER', 'HED_IA1_EPX100-1/DET/RECEIVER:daqOutput', 'HED_IA1_EPX100-1/DET/CONTROL']
+
+
+## Read operating conditions from RAW data.
+
+It is recommended to read the calibration constants' operating conditions directly from RAW data.
+To avoid wrong given values from the notebook's input argument.
+Unfortunately, there is the possibility that these conditions are not stored in RAW data
+because the detector is in its early operation stages.
+
+
+Below we give an example of reading the integration time of the data. There are multiple functions and similar class
+as epix100Ctrl for other detectors that are used for the same purpose. 
+
+
+```python
+# Read control data.
+data_source = "HED_IA1_EPX100-1/DET/RECEIVER:daqOutput"
+
+ctrl_data = epix100lib.epix100Ctrl(
+    run_dc=run_dc,
+    instrument_src=data_source,
+    ctrl_src=f"{karabo_id}/DET/CONTROL",
+    )
+
+integration_time = ctrl_data.get_integration_time()
+```
+
+## Retrieve needed calibration constants
+
+Usually there is a cell when we retrieve calibration constants before correction
+and sometimes before processing new calibration constants.
+
+In this example we use `EPIX100_CalibrationData` class to initialize an object with
+the necessary operating conditions and creation time.
+
+Below the operating conditions values like integration_time and sensor_temperature are hard coded to specific value.
+In production notebooks this is done differently.
+
+
+```python
+# Run creation time is important to get the correct calibration constant versions.
+creation_time = calcat_creation_time(in_folder, run, creation_time)
+print(f"Using {creation_time.isoformat()} as creation time")
+
+epix_cal = EPIX100_CalibrationData(
+    detector_name=karabo_id,
+    sensor_bias_voltage=bias_voltage,
+    integration_time=integration_time,
+    sensor_temperature=fix_temperature,
+    in_vacuum=in_vacuum,
+    source_energy=photon_energy,
+    event_at=creation_time,
+    client=rest_cfg.calibration_client(),
+)
+
+const_data = epix_cal.ndarray_map()[karabo_da]
+
+print(f"Retrieved calibrations for {karabo_id}: {list(const_data.keys())}")
+```
+
+    Reading creation_date from input files metadata `INDEX/timestamp`
+    Using 2021-09-19T14:39:26.744069+00:00 as creation time
+    Retrieved calibrations for HED_IA1_EPX100-1: ['BadPixelsDarkEPix100', 'NoiseEPix100', 'OffsetEPix100', 'RelativeGainEPix100']
+
+
+## Correcting Raw data
+
+
+```python
+data_key = "data.image.pixels"
+raw_data = run_dc[data_source, data_key].ndarray()
+dshape = raw_data.shape  # Raw input data shape.
+
+print(f"Number of trains to correct is {len(run_dc.train_ids)}")
+
+def correct_train(wid, index, d):
+    """Correct one train for ePix100 detector."""
+    d -= const_data["OffsetEPix100"][..., 0]
+    if gain_correction:
+        d /= const_data["RelativeGainEPix100"]
+
+step_timer.start()
+context = psh.context.ThreadContext(num_workers=10)
+corr_data = context.alloc(shape=dshape, dtype=np.float32)
+
+context.map(correct_train, raw_data.astype(np.float32))
+step_timer.done_step('Correcting data')
+```
+
+    Number of trains to correct is 1000
+    Correcting data: 1.0 s
+
+
+## Writing corrected data
+
+
+```python
+# Storing data.
+out_file = out_folder / "CORR-R9046-EPIX01-S00000.h5"
+instrument_source = "HED_IA1_EPX100-1/DET/RECEIVER:daqOutput"
+
+image_counts = run_dc[instrument_source, "data.image.pixels"].data_counts(labelled=False)
+
+step_timer.start()
+
+with DataFile(out_file, "w") as ofile:
+    # Create INDEX datasets.
+    ofile.create_index(run_dc.train_ids, from_file=run_dc.files[0])
+
+    # Create METDATA datasets
+    ofile.create_metadata(
+        like=run_dc,
+        sequence=run_dc.run_metadata()["sequenceNumber"],
+        instrument_channels=(f"{instrument_source}/data",)
+    )
+    # Create Instrument section to later add corrected datasets.
+    outp_source = ofile.create_instrument_source(instrument_source)
+
+    # Create count/first datasets at INDEX source.
+    outp_source.create_index(data=image_counts)
+
+    # Add main corrected `data.image.pixels` dataset and store corrected data.
+    outp_source.create_key(
+        "data.image.pixels", data=corr_data, chunks=((chunk_size_idim,) + dshape[1:]))
+step_timer.done_step('Writing corrected data')
+```
+
+    Writing corrected data: 1.2 s
+
+
+# Plotting results
+
+
+```python
+geom = Epix100Geometry.from_origin()
+
+fig, (ax1, ax2) = plt.subplots(nrows=1, ncols=2, figsize=(25, 10))
+
+# Plotting mean data for RAW and CORRECTED across trains
+geom.plot_data(np.mean(raw_data, axis=0), ax=ax1)
+ax1.set_title("Mean RAW across trains")
+geom.plot_data(np.mean(corr_data, axis=0), ax=ax2)
+ax2.set_title("Mean CORR across trains")
+
+plt.show()
+```
+
+
+    
+![png](how_to_write_xfel_calibrate_notebook_NBC_files/how_to_write_xfel_calibrate_notebook_NBC_14_0.png)
+    
+
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 2b62c613c..249fc1853 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -5,7 +5,6 @@ mkdocs-glightbox
 mkdocs-section-index==0.3.5
 mkdocs-literate-nav==0.5.0
 mkdocs-redirects==1.2.0
-mkdocs-jupyter==0.16.0
 mkdocs-gen-files==0.4.0
 griffe==0.27.1
 jupyter
diff --git a/docs/static/webservice_job_db.png b/docs/static/webservice_job_db.png
new file mode 100644
index 0000000000000000000000000000000000000000..1cfe96cec9bc9d6638eba254bfaee9d7df78e3d4
GIT binary patch
literal 60370
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

literal 0
HcmV?d00001

diff --git a/mkdocs.yml b/mkdocs.yml
index 06ff84b61..ce4abd263 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -65,9 +65,6 @@ plugins:
   - glightbox
   - search
   - autorefs
-  - mkdocs-jupyter:
-      include: ["development/how_to_write_xfel_calibrate_notebook_NBC.ipynb"]
-      allow_errors: false
   - gen-files:
       scripts:
         - docs/gen_ref_pages.py
@@ -99,7 +96,7 @@ nav:
     - Development:
       - Installation: development/installation.md
       - Workflow: development/workflow.md
-      - How to write a notebook: development/how_to_write_xfel_calibrate_notebook_NBC.ipynb
+      - How to write a notebook: development/how_to_write_xfel_calibrate_notebook_NBC.md
       - Configuration: development/configuration.md
     - Code Reference: reference/
     - Reference:
-- 
GitLab