Library for Image Acquisition
Clone or download
sdebionne Merge pull request #75 from PhilLAL/patch-1
Fixes a typo in plugin dev doc
Latest commit 16cfa82 Jul 30, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
applications - update tango-python documentation pco-1.7.7 May 24, 2018
camera pilatus: fixed submodule May 24, 2018
cmake Merge branch '37-add-missing-tests-of-simulator-on-windows' into 'mas… May 2, 2018
common Merge branch '37-add-missing-tests-of-simulator-on-windows' into 'mas… May 2, 2018
control Use printErrorStack() since printError() is deprecated May 15, 2018
debian Now debian/rules cleans a bit better between recompile. Jul 23, 2014
docs fixes a typo Jul 27, 2018
hardware py3 for __repr_ in sip Nov 17, 2017
python Move python source files to have the same folder structure than the i… Apr 18, 2018
scripts For python > 3.4, use Visual Studio 2017 (v14.1) Apr 20, 2018
sip Again updated MappedType for list of std::string and other map of std… Apr 9, 2018
third-party Processlib: merge branch 'msvc2017' into 'master' Mar 22, 2018
.gitignore New script for install. --help, --prefix and --python-packages option… Nov 17, 2017
.gitlab-ci.yml Use lima runner now that we have multiple active runners May 14, 2018
.gitmodules Remove submodule third-party/yat Apr 3, 2018
.travis.yml changed the script install_lima_submodule in order to use it if Lima/… Nov 17, 2017
AUTHORS added some options for windows install script. Nov 17, 2017
CMakeLists.txt Move python source files to have the same folder structure than the i… Apr 18, 2018
COPYING GPL license definitively added. Jan 20, 2011
INSTALL.txt Install: move INSTALL.txt to bootstrap.py argparse epilog (old print_… Apr 20, 2018
LIMA_GPL_HEADER.cpp.txt * Split camera list activation into a separated cmake file Nov 17, 2017
LIMA_GPL_HEADER.txt * Split camera list activation into a separated cmake file Nov 17, 2017
Lima.pc.in FITS saving implemented. Header information is still very short. Mar 26, 2012
README.rst Update README.rst with CMake depenpency > 3.1 Mar 20, 2018
ReleaseNotes.txt Official Release Core 1.7: Release Notes updated for 1.7.0/1.7.1/1.7.2 Feb 3, 2017
add_include_namespace.py Create a small script to add include namspace into source files Jan 6, 2015
addnewtags Fixed for path to tango/python Jul 19, 2016
appveyor.yml appveyor only for branch cmake Nov 17, 2017
compilation-env-python27-64bit.bat Window 64 bits compilation without Bpm Jul 30, 2013
install.bat Remove the cleanup of the build directory Mar 16, 2018
install.sh Remove the cleanup of the build directory Mar 16, 2018
mvn_build.py Add maven HDF5 dependency Nov 25, 2014
pom.xml Add maven HDF5 dependency Nov 25, 2014
python_path.py Commit from VB repo Apr 23, 2013
set_win_cmake_env.py Rewrite config parser function to include cameras Nov 17, 2017
windowsInstall.py [CMake] work by Yann Voté Nov 17, 2017
windowsSipCompilation.py Rewrite config parser function to include cameras Nov 17, 2017

README.rst

http://lima.blissgarden.org/_static/lima-logo-2-40perc.png

Library for Image Acquisition

Windows Status

Description

Lima ( L ibrary for Im age A cquisition) is a project for the unified control of 2D detectors. The aim is to clearly separate hardware specific code from common software configuration and features, like setting standard acquisition parameters (exposure time, external trigger), file saving and image processing.

Lima is a C++ library which can be used for many different cameras. The library is also available for Python and it provides a PyTango server for remote control.

Documentation: http://lima.blissgarden.org

Requirements

You need to install some tools and libraries for building Lima for both windows and Linux.

Build dependencies:

  • gcc for Linux
  • Visual Studio 2008 for x86 or x64 for Python 2.7.x
  • Visual Studio 2008 Express for x86 only for Python 2.7.x
  • Visual Studio 2015 for x86 and x64 for Python >= 3.5
  • git
  • CMake >= 3.1
  • gsl: For windows, download the esrf binary package gsl-windows and install it under "c:\program files\"

Python dependencies:

Lima can be compiled for python 2 and 3. The following packages must be installed, development versions with header files (include files) are mandatory.

The following requirements are optional.

Saving format dependencies:

PyTango server dependencies:

The LimaCCDs PyTango server only works for Python 2, it will be updated for Python 3 soon !!

Build and Install

Using scripts

the install scripts will run cmake, compile and install.

It accepts input arguments (see below) but it also uses a configuration file scripts/config.txt. Feel free to update this file for setting a permanent configuration for your own installation.

Linux:

[sudo] install.sh
[--git]
[--prefix=<desired installation path>]
[--python-packages=<desired python installation path>]
[options]

Windows:

install.bat
[--prefix=<desired installation path>]
[--python-packages=<desired python installation path>]
[options]

The --git (Linux only) option cab be used to clone the required submodules as a prerequisite. Otherwise you should install the submodules with git commands, for instance:

$ git submodule init third-party/Processlib
$ git submodule init camera/basler
$ git submodule init applications/tango/python
$ git submodule update

Options are <camera-name> <saving-format> python pytango-server:

  • camera-name:

    andor|andor3|basler|prosilica|adsc|mythen3|ueye|xh|xspress3|ultra| xpad|mythen|pco|marccd|pointgrey|imxpad|dexela|merlin|v4l2| eiger|pixirad|hexitec|aviex|roperscientific|rayonixhs|espia|maxipix|frelon

  • saving-format:

    cbf|nxs|fits|edfgz|edflz4|tiff|hdf5

  • python: to compile python module

  • pytango-server: to install the PyTango server

Example:

$ sudo install.sh --git
                --prefix=./install
                --python-packages=./install/python
                tiff basler python pytango-server

Using cmake

Install first the project submodules:

$ git submodule init third-party/Processlib
$ git submodule init camera/basler
$ git submodule init applications/tango/python
$ git submodule update

Run cmake in the build directory:

$ mkdir build
$ cd build
$ cmake ..
    [-G "Visual Studio 9 2008 Win64" | -G "Visual Studio 9 2008" | -G "Unix Makefiles"]
    [-DCMAKE_INSTALL_PREFIX=<desired installation path>]
    [-DPYTHON_SITE_PACKAGES_DIR=<desired python installation path>]
    -DLIMA_ENABLE_TIFF=true
    -DLIMACAMERA_BASLER=true
    -DLIMA_ENABLE_PYTANGO_SERVER=true
    -DLIMA_ENABLE_PYTHON=true

Then compile and install:

$ cmake --build
$ sudo cmake --build --target install

May you need to update your environment?

If you have changed the default destination path for both libraries and python modules you should update your environment variables.

For Linux:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<my-new-install-dir>/Lima/lib

export PYTHONPATH=$PYTHONPATH:<my-new-install-dir>

For Windows:

Update the system wide variables PATH for the libraries and PYTHONPATH for python.

Lima Team contact: lima@esrf.fr