Connecting a Single Module’s Raw Data to the Bridge

Follow the procedure below to connect a ZMQ bridge directly to a single modules data stream in extraordinary case and in the only supported way.

  1. Talk to the users and instrument. Question if they really needs this option. Then question again if they really really need it and if they know how to handle raw data from the detector. Tell them that for any calibration they will be on their own, and that it impacts online views of the instrument.
  2. Stop the detector from producing data
  3. Remove the module for the mandatory modules list, found at the bottom left corners of the CORRECTED and RAW overview scenes, in case it is configured there.
  4. Find the corresponding SPLITTER device by searching the topology for the module location, e.g. FEM_SPLITTER_Q1M1.
  5. On this device, set Output to GPU to false and select set Output to to B. This will make sure no data is forwarded to the online pipeline anymore.
  6. On the same device you can now reconfigure Filter pulses to individual ranges other than the global setting in the manager scene.
  7. In a differnt Karabo-GUI, open the ZMQ Bridge project corresponding to the instrument and detector. Navigate to the ZEROMQ/RAW device and shut it down. Now reconfigure the bridge device to …output_1 instead of …output_0. Make sure it also connects to the correct splitter device id. Then reinstantiate the device.
  8. Finally, you can now decrease the train module number on the corresponding data aggregator. You will find them in the corresponding subproject. They are named by channel, where for AGIPD e.g. Q1M1 is channel 0 and Q4M4 is channel 15. You will find the field as DataDispatcher.trainStride. Note that 1, and thus every train, will likely fail. A train stride of 2 has worked in the past.

To revert, step through the sequence in reversed order.