mxcubecore is the back-end library for
MXCuBE Qt
and MXCuBE Web.
It allows access to the beamline control system and instrumentation.
It acts as a container of single Python objects (called "hardware objects").
Please read the contributing guidelines before submitting your code to the repository.
MXCuBE is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
MXCuBE is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with MXCuBE. If not, see https://www.gnu.org/licenses/.
Installation of the mxcubecore module is commonly done as a dependency of either
MXCuBE Web
or MXCuBE Qt.
Standalone installation of the mxcubecore for development purposes can be done
via Poetry with poetry install
or via pip with python -m pip install --editable . (don't forget the trailing dot .).
mxcubecore depends on python-ldap that in turn depends on the openldap system library.
It can be installed in a conda environment: conda install openldap
or on systems using the apt package manager (Debian and derivatives, including Ubuntu):
sudo apt-get install -y libldap2-dev libsasl2-dev.
See python-ldap
for more information.
See Developer documentation for more information on working with mxcubecore.