Skip to main content

"tomography workflow tools"

Project description

Orange3 ESRF Add-on

Tomwer is offering tools to automate acquisition and reconstruction processes for Tomography. It contains:

  • a library to access each acquisition process individually
  • gui and applications to control main processes (reconstruction, data transfert...) and execute them as a stand alone application.
  • an orange add-on to help users defining their own workflow (

.. image::

.. |Gitlab Status| image:: :target:


Documentation of latest release is available at


Step 0 - Create a virtual env '''''''''''''''''''''''''''''

It is recommended to create a python virtual environment to run the workflow tool. Virtual environment might avoid some conflict between python packages. But you can also install it on your 'current' python environment and move to step 1.

.. code-block:: bash

virtualenv --python=python3 --system-site-packages myvirtualenv

Then activate the virtual environment

.. code-block:: bash

source myvirtualenv/bin/activate

First update pip and setuptools to avoid some potential errors

.. code-block:: bash

pip install --upgrade pip pip install setuptools --upgrade

.. note:: To quit the virtual environment

.. code-block:: bash


Step 1 - Orange3 installation '''''''''''''''''''''''''''''

You will need a fork of the original Orange project in order to run the tomwer project. This is needed because small modification have been made in order to get the behavio we wanted (has looping workflows).

The fork is accessible here :

So install this fork :

.. code-block:: bash

pip install git+

.. note:: Orange will try to access '/var/log/orange' to store logs of the last ten execusion. So if you want to keep those log make sure the directory exists.

Step 2 - tomwer '''''''''''''''

From wheel

To install it with the 'minimal' features:

.. code-block:: bash

pip install tomwer

To install it with all the potential 'feature':

.. code-block:: bash

pip install tomwer[full]

From source

clone the tomwer project

.. code-block:: bash

git clone

then install it

.. code-block:: bash

cd tomwer pip install .

or for the 'full' version

.. code-block:: bash

pip install .[full]

Step 3 - web log ''''''''''''''''

the workflow tool can send some log into graylog in order to get view of the status of the workflow execution. If this is active (by default) then you will be able to see important log from a web interface.

To get more information see

Launching applications ::::::::::::::::::::::

After the installation tomwer is embedding several applications.

Those applications can be launched by calling:

.. code-block:: bash

tomwer appName {options}

.. note:: if you only call tomwer then the man page will be displayed.

.. note:: You can access each application help using ``

.. code-block:: bash

   tomwer appName --help

tomwer canvas - orange canvas '''''''''''''''''''''''''''''

You can launch the canvas to create workflows from the different 'bricks'

.. code-block:: bash

tomwer canvas

.. note:: you can also use orange-canvas

.. note:: if your installed a virtual environment do not forget to active it :

.. code-block:: bash

   source myvirtualenv/bin/activate

Documentation :::::::::::::

.. code-block:: bash

cd doc make html

The documentation is build in doc/build/html and the entry point is index.html

.. code-block:: bash

firefox build/html/index.html

.. note:: the build of the documentation need sphinx to be installed. This is not an hard dependacy. So you might need to install it.

You also should generate documentation to be accessible from Orange GUI (pressing the F1 key).

.. code-block:: bash

cd doc make htmlhelp

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tomwer, version 0.9.2
Filename, size File type Python version Upload date Hashes
Filename, size tomwer-0.9.2.tar.gz (4.0 MB) File type Source Python version None Upload date Hashes View
Filename, size tomwer-0.9.2-py3-none-any.whl (4.5 MB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page