slsDetector Package
Overview
The slsDetector package provides a way to interface with SLS detectors in the Karabo control system. More information on the detectors can be found on this webpage:
https://www.psi.ch/en/lxn/documentation
Contact
For questions, please contact opensource@xfel.eu.
License and Contributing
This software is released by the European XFEL GmbH as is and without any warranty under the GPLv3 license. If you have questions on contributing to the project, please get in touch at opensource@xfel.eu.
Source Code
The sources for this project can be found at https://github.com/European-XFEL/Karabo-slsDetectors
Dependencies
The Karabo slsDetector package depends on slsDetectorPackage, which is the SDK provided by the SLS detector group under the LGPL-3.0 license.
-
slsDetectorPackage v10.0.x
Installing and Running from PyPI
The device can further be installed from PyPI and ships in the form of a self-hosting device server. All the needed libaries are grafted in, including the ones from slsDetectorPackage.
To install, run
pip install karabo-sls-detectors
To run, make sure you initially prepared a Karabo environment using
pip install karabo.services
karabo-activate --init-to PATH/TO/KARABO
and have activated that Karabo environment using
source PATH/TO/KARABO/activate
and then start the self-hosting server with
karabo-sls-detector-server [serverId=, ... karabo-cpp-server options]
Update to SLS Detector Software v5.0.1
In the SLS detector software, some of the parameters changed from v4.0.1 to v5.0.1. The Karabo device followed these changes, thus some of the keys have been renamed:
| Old Key Name | New Key Name |
|---|---|
| bitDepth | dynamicRange |
| detectorIp | udpSrcIp |
| detectorMac | udpSrcMac |
| detectorNumber | serialNumber |
| detectorVersion | firmwareVersion |
| numberOfCycles | numberOfTriggers |
| rxUdpIp | udpDstIp |
| rxUdpPort | udpDstPort |
| softwareVersion | detServerVersion |
| thisVersion | clientVersion |
| vHighVoltage | highVoltage |
| vHighVoltageMax | highVoltageMax |
The following parameters have been removed, as not available any more, or not available for the detectors we currently have at XFEL:
| Removed Key Name |
|---|
| angConv |
| angDir |
| binSize |
| detectorDeveloper |
| flatFieldCorrectionFile |
| globalOff |
| lock |
| master |
| maximumDetectorSize |
| moveFlag |
| numberOfGates |
| online |
| sync |
| threaded |
For some other properties the unit and type have changed:
| Key Name | Old Unit | New Unit | Old Type | New Type |
|---|---|---|---|---|
| exposureTime | s | ns | FLOAT | INT64 |
| exposurePeriod | s | ns | FLOAT | INT64 |
| delayAfterTrigger | s | ns | FLOAT | INT64 |
Metadata
Release files for karabo-sls-detectors 3.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| karabo_sls_detectors-3.2.4-cp312-cp312-manylinux_2_28_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.28+ x86-64 | Details |
Release files / karabo_sls_detectors-3.2.4-cp312-cp312-manylinux_2_28_x86_64.whl
| Download URL | karabo_sls_detectors-3.2.4-cp312-cp312-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 11.7 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
598f825d66cbcd3f0d6522105299024bf3d6120410f5c20a3d320cf74b0a4ab0
|
|
BLAKE2b-256 checksum How to use checksums |
cce856c9a9f2f1306c64364dbf7537df13d0bea0f273bf4db1f0163db88cd6e5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|