tomwer 2.0.2__tar.gz → 2.0.3__tar.gz

{tomwer-2.0.2/src/tomwer.egg-info → tomwer-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tomwer
-Version: 2.0.2
+Version: 2.0.3
 Summary: Tomography workflow tools
 Author-email: Henri Payno <henri.payno@esrf.fr>, Pierre Paleo <pierre.paleo@esrf.fr>, Pierre-Olivier Autran <pierre-olivier.autran@esrf.fr>, Jérôme Lesaint <jerome.lesaint@esrf.fr>
 License: MIT

{tomwer-2.0.2 → tomwer-2.0.3}/src/tomwer/app/canvas_launcher/mainwindow.py

@@ -35,6 +35,7 @@ from ewoksorange.gui.orange_utils.signal_manager import patch_signal_manager
 from ewoksorange.gui.workflows.owscheme import patch_parse_ows_stream
 
 from .config import TomwerConfig, TomwerSplashScreen
+from .schemeedit import SchemeEditWidget as _SchemeEditWidget
 
 from tomwer.io.processlog import (
     PROCESS_ENDED_NAME,
@@ -123,6 +124,8 @@ class MainWindow(_MainWindow):
     FORCE_OBJECT_SUPERVISOR_DISPLAY = True
     """If true will always display the processed supervisor at start up. Restore state will be ignored."""
 
+    EDITOR_WIDGET_CONSTRUCTOR = _SchemeEditWidget
+
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
         self.process_supervisor_dock = DockWidget(

tomwer-2.0.3/src/tomwer/app/canvas_launcher/schemeedit.py

@@ -0,0 +1,54 @@
+# Note: integrate on ewoksorange 5.0 and older. To be removed in future versions.
+import logging
+
+from AnyQt.QtWidgets import QAction
+from orangecanvas.document.schemeedit import SchemeEditWidget as _SchemeEditWidget
+from orangecanvas.scheme import SchemeLink
+
+_logger = logging.getLogger(__file__)
+
+
+class SchemeEditWidget(_SchemeEditWidget):
+    """Class to add the "Trigger" action to the link context menu in the canvas, which allows to trigger again the scan if any in memory."""
+
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+
+        self.__linkTriggerAction = QAction(
+            self.tr("Trigger"),
+            self,
+            objectName="link-trigger-action",
+            triggered=self.__linkTrigger,
+            toolTip=self.tr("Trigger link."),
+        )
+
+        linkMenu = self.linkMenu()
+        linkMenu.addSeparator()
+        linkMenu.addAction(self.__linkTriggerAction)
+        self.__link = None  # type: Optional[SchemeLink]
+        # Active link in the context menu.
+
+    def __linkTrigger(self):
+        link = self.__link
+        if not link:
+            return
+
+        runtime_state = link.runtime_state()
+        if not link.is_enabled():
+            _logger.debug("Won't trigger link %s because it is not active", link)
+        elif runtime_state != SchemeLink.State.Active:
+            _logger.debug(
+                "Won't trigger link %s because runtime state is", runtime_state
+            )
+        else:
+            self.removeLink(link)
+            self.addLink(link)
+
+    def contextMenuForLink(self, link: SchemeLink):
+        """
+        Return a `QMenu` for a context click on the connection represented
+        by `link`.
+        """
+        menu = super().contextMenuForLink(link)
+        self.__link = link
+        return menu

{tomwer-2.0.2 → tomwer-2.0.3}/src/tomwer/version.py

@@ -77,7 +77,7 @@ RELEASE_LEVEL_VALUE = {
 
 MAJOR = 2
 MINOR = 0
-MICRO = 2
+MICRO = 3
 RELEV = "final"  # <16
 SERIAL = 0  # <16
 

{tomwer-2.0.2 → tomwer-2.0.3/src/tomwer.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tomwer
-Version: 2.0.2
+Version: 2.0.3
 Summary: Tomography workflow tools
 Author-email: Henri Payno <henri.payno@esrf.fr>, Pierre Paleo <pierre.paleo@esrf.fr>, Pierre-Olivier Autran <pierre-olivier.autran@esrf.fr>, Jérôme Lesaint <jerome.lesaint@esrf.fr>
 License: MIT

{tomwer-2.0.2 → tomwer-2.0.3}/src/tomwer.egg-info/SOURCES.txt

@@ -20,7 +20,6 @@ src/orangecontrib/tomwer/tutorials/cast_volume.ows
 src/orangecontrib/tomwer/tutorials/complete_on_the_fly.ows
 src/orangecontrib/tomwer/tutorials/copy_reduced_darks_and_flats_meth1.ows
 src/orangecontrib/tomwer/tutorials/copy_reduced_darks_and_flats_meth2.ows
-src/orangecontrib/tomwer/tutorials/darks and flats copy - method 2.ows
 src/orangecontrib/tomwer/tutorials/default_cor_search.ows
 src/orangecontrib/tomwer/tutorials/drac_publication.ows
 src/orangecontrib/tomwer/tutorials/hello_world_python_script.ows
@@ -29,7 +28,6 @@ src/orangecontrib/tomwer/tutorials/simple_slice_reconstruction.ows
 src/orangecontrib/tomwer/tutorials/simple_slice_reconstruction_on_slurm.ows
 src/orangecontrib/tomwer/tutorials/simple_volume_local_reconstruction.ows
 src/orangecontrib/tomwer/tutorials/simple_volume_to_slurm_reconstruction.ows
-src/orangecontrib/tomwer/tutorials/untitled.ows
 src/orangecontrib/tomwer/tutorials/using_multicor_to_find_cor.ows
 src/orangecontrib/tomwer/tutorials/volume_casting_on_slurm.ows
 src/orangecontrib/tomwer/tutorials/id16b/ID16b_full_volume.ows
@@ -240,9 +238,7 @@ src/tomwer.egg-info/PKG-INFO
 src/tomwer.egg-info/SOURCES.txt
 src/tomwer.egg-info/dependency_links.txt
 src/tomwer.egg-info/entry_points.txt
-src/tomwer.egg-info/pkg_info
 src/tomwer.egg-info/requires.txt
-src/tomwer.egg-info/sources.txt
 src/tomwer.egg-info/top_level.txt
 src/tomwer/app/__init__.py
 src/tomwer/app/canvas.py
@@ -269,6 +265,7 @@ src/tomwer/app/canvas_launcher/__init__.py
 src/tomwer/app/canvas_launcher/config.py
 src/tomwer/app/canvas_launcher/environ.py
 src/tomwer/app/canvas_launcher/mainwindow.py
+src/tomwer/app/canvas_launcher/schemeedit.py
 src/tomwer/app/canvas_launcher/splash.py
 src/tomwer/app/canvas_launcher/utils.py
 src/tomwer/app/canvas_launcher/widgetsscheme.py
@@ -946,7 +943,6 @@ src/tomwer/tests/utils.py
 src/tomwer/tests/app/test_stitching.py
 src/tomwer/tests/orangecontrib/tomwer/widgets/test_conditions.py
 src/tomwer/tests/orangecontrib/tomwer/widgets/test_darkflat.py
-src/tomwer/tests/orangecontrib/tomwer/widgets/cluster/tests/test_monitor_ow.py
 src/tomwer/tests/orangecontrib/tomwer/widgets/cluster/tests/test_slurm_clusterow.py
 src/tomwer/tests/orangecontrib/tomwer/widgets/control/tests/test_advancement.py
 src/tomwer/tests/orangecontrib/tomwer/widgets/control/tests/test_data_validator.py

tomwer-2.0.2/src/orangecontrib/tomwer/tutorials/darks and flats copy - method 2.ows

@@ -1,42 +0,0 @@
-<?xml version='1.0' encoding='utf-8'?>
-<scheme version="2.0" title="darks and flats copy - method 2" description="">
-	<nodes>
-		<node id="0" name="scan selector" qualified_name="orangecontrib.tomwer.widgets.control.DataSelectorOW.DataSelectorOW" project_name="tomwer" version="" title="scan selector" position="(-519.0, -209.0)" />
-		<node id="1" name="image-key-upgrader" qualified_name="orangecontrib.tomwer.widgets.edit.ImageKeyUpgraderOW.ImageKeyUpgraderOW" project_name="tomwer" version="" title="image-key-upgrader" position="(-293.0, -209.0)" />
-		<node id="2" name="scan selector" qualified_name="orangecontrib.tomwer.widgets.control.DataSelectorOW.DataSelectorOW" project_name="tomwer" version="" title="scan selector (1)" position="(291.0, -211.0)" />
-		<node id="3" name="copy reduced darks and flats" qualified_name="orangecontrib.tomwer.widgets.reconstruction.CopyReducedDarkAndFlatOW.CopyReducedDarkAndFlatOW" project_name="tomwer" version="" title="copy reduced darks and flats" position="(61.0, -213.0)" />
-	</nodes>
-	<links>
-		<link id="0" source_node_id="0" sink_node_id="1" source_channel="data" sink_channel="data" enabled="true" source_channel_id="data" sink_channel_id="data" />
-		<link id="1" source_node_id="1" sink_node_id="3" source_channel="data" sink_channel="data" enabled="true" source_channel_id="data" sink_channel_id="data" />
-		<link id="2" source_node_id="3" sink_node_id="2" source_channel="data" sink_channel="data" enabled="true" source_channel_id="data" sink_channel_id="data" />
-	</links>
-	<annotations>
-		<text id="0" type="text/plain" rect="(-597.0, -79.0, 150.0, 126.0)" font-family="Sans" font-size="16">step2: provide scans for which we need to copy reduced darks and flats</text>
-		<arrow id="1" start="(-522.0, -87.0)" end="(-523.0, -151.0)" fill="#C1272D" />
-		<text id="2" type="text/plain" rect="(-379.0, -87.0, 236.0, 111.0)" font-family="Sans" font-size="16">invalid any existing darks or flats frames (else reduced darks and flats will use them instead of making the copy)</text>
-		<arrow id="3" start="(-293.0, -97.0)" end="(-290.0, -158.0)" fill="#C1272D" />
-		<text id="4" type="text/plain" rect="(-70.0, -81.0, 270.0, 80.0)" font-family="Sans" font-size="16">will copy reduced darks / flats to `dataset_{darks|flats}.hdf5` to be used for reconstruction</text>
-		<arrow id="5" start="(61.99999999999998, -91.0)" end="(61.99999999999998, -142.0)" fill="#C1272D" />
-		<text id="6" type="text/plain" rect="(-141.0, -427.0, 464.0, 85.0)" font-family="Sans" font-size="16">step1: provide reduced darks and flats from the 'copy' tab,
-unselecting auto and setting them through `select darks url` and `select flats url`</text>
-		<arrow id="7" start="(57.0, -334.0)" end="(58.99999999999997, -259.00000000000006)" fill="#C1272D" />
-		<text id="8" type="text/plain" rect="(241.0, -94.0, 150.0, 88.0)" font-family="Sans" font-size="16">result: scans with copied reduced darks / flats</text>
-		<text id="9" type="text/plain" rect="(-601.0, -590.0, 932.0, 68.0)" font-family="Sans" font-size="16">Context: on this workflow we want to copy reduced flats / darks from a dataset to others.
-This one of the various way to do this.
-</text>
-		<text id="10" type="text/plain" rect="(-593.0, 94.0, 919.0, 84.0)" font-family="Sans" font-size="16">Note: reduced darks / flats can be saved to disk from another python script using the `silx.io.dictdump` dicttoh5 function.
-Reduced darks and flats are dictionary with index in the sequence as key (so index==0 if the dark / flat serie is done at the beginning) and the reduced darks / flats as value (2D numpy array) </text>
-		<arrow id="11" start="(291.0, -109.0)" end="(290.0, -158.0)" fill="#C1272D" />
-	</annotations>
-	<thumbnail />
-	<node_properties>
-		<properties node_id="0" format="literal">{'_scanIDs': [], 'controlAreaVisible': True, 'savedWidgetGeometry': None, '__version__': 1}</properties>
-		<properties node_id="1" format="literal">{'_ewoks_default_inputs': {'operations': {}}, '_ewoks_execinfo': {}, '_ewoks_task_options': {}, '_ewoks_varinfo': {}, 'controlAreaVisible': True, 'default_inputs': {}, 'savedWidgetGeometry': None, '__version__': 1}</properties>
-		<properties node_id="2" format="literal">{'_scanIDs': [], 'controlAreaVisible': True, 'savedWidgetGeometry': None, '__version__': 1}</properties>
-		<properties node_id="3" format="literal">{'_auto_mode': True, '_ewoks_default_inputs': {}, '_ewoks_execinfo': {}, '_ewoks_task_options': {}, '_ewoks_varinfo': {}, 'controlAreaVisible': True, 'default_inputs': {}, 'savedWidgetGeometry': None, '__version__': 1}</properties>
-	</node_properties>
-	<session_state>
-		<window_groups />
-	</session_state>
-</scheme>

tomwer-2.0.2/src/orangecontrib/tomwer/tutorials/untitled.ows

@@ -1,15 +0,0 @@
-<?xml version='1.0' encoding='utf-8'?>
-<scheme version="2.0" title="" description="">
-	<nodes>
-		<node id="0" name="nabu volume reconstruction" qualified_name="orangecontrib.tomwer.widgets.reconstruction.NabuVolumeOW.NabuVolumeOW" project_name="tomwer" version="" title="nabu volume reconstruction" position="(440.0, 214.0)" />
-	</nodes>
-	<links />
-	<annotations />
-	<thumbnail />
-	<node_properties>
-		<properties node_id="0" format="literal">{'_ewoks_default_inputs': {'data': None, 'nabu_volume_params': None, 'nabu_params': None}, 'controlAreaVisible': True, 'savedWidgetGeometry': b'\x01\xd9\xd0\xcb\x00\x03\x00\x00\x00\x00\x03\x08\x00\x00\x01o\x00\x00\x04\xd1\x00\x00\x03\xe5\x00\x00\x03\x08\x00\x00\x01\x94\x00\x00\x04\xd1\x00\x00\x03\xe5\x00\x00\x00\x00\x00\x00\x00\x00\x07\x80\x00\x00\x03\x08\x00\x00\x01\x94\x00\x00\x04\xd1\x00\x00\x03\xe5', '__version__': 1}</properties>
-	</node_properties>
-	<session_state>
-		<window_groups />
-	</session_state>
-</scheme>

tomwer-2.0.2/src/tomwer/tests/orangecontrib/tomwer/widgets/cluster/tests/test_monitor_ow.py

@@ -1,92 +0,0 @@
-from __future__ import annotations
-
-import os
-from concurrent.futures import Future
-from unittest import mock
-
-from orangecontrib.tomwer.widgets.cluster.MonitorOW import (
-    FutureTomwerObjectObserverWidget,
-)
-from processview.core.superviseprocess import SuperviseProcess
-from tomwer.core.futureobject import FutureTomwerObject
-from tomwer.core.utils.scanutils import MockNXtomo
-from tomwer.tests.conftest import qtapp  # noqa F401
-
-
-class _FakeProcess(SuperviseProcess):
-    """minimal SuperviseProcess with mocked _startProcessing / _endProcessing hooks"""
-
-    def __init__(self):
-        super().__init__()
-        self._startProcessing = mock.Mock()
-        self._endProcessing = mock.Mock()
-
-
-def _create_future_tomo_obj(tmp_path, index, job_id) -> FutureTomwerObject:
-    scan = MockNXtomo(
-        scan_path=os.path.join(str(tmp_path), f"scan_{index}"),
-        n_proj=10,
-        n_ini_proj=10,
-        create_ini_dark=False,
-        create_ini_flat=False,
-        dim=10,
-    ).scan
-    # a plain concurrent.futures.Future stands in for the distributed / sluurp
-    # future: only 'job_id' is read by FutureTomwerObject.status
-    future = Future()
-    future.job_id = job_id
-    return FutureTomwerObject(tomo_obj=scan, futures=(future,))
-
-
-def test_start_and_end_processing_feedback(qtapp, tmp_path):  # noqa F811
-    """
-    '_startProcessing' must be triggered once when a first future arrives and
-    '_endProcessing' only once every tracked future / slurm job has reached a
-    terminal status.
-    """
-    statuses = {}
-
-    def fake_get_job_status(job_id):
-        return statuses[job_id]
-
-    process = _FakeProcess()
-    widget = FutureTomwerObjectObserverWidget(name="test", process=process)
-    try:
-        with mock.patch(
-            "tomwer.core.futureobject.get_job_status",
-            side_effect=fake_get_job_status,
-        ):
-            statuses["job-1"] = "pending"
-            future_tomo_obj_1 = _create_future_tomo_obj(tmp_path, 0, "job-1")
-            widget.addFutureTomoObj(future_tomo_obj_1)
-            process._startProcessing.assert_called_once()
-            process._endProcessing.assert_not_called()
-
-            # a second future arriving while already processing must not
-            # trigger '_startProcessing' a second time
-            statuses["job-2"] = "running"
-            future_tomo_obj_2 = _create_future_tomo_obj(tmp_path, 1, "job-2")
-            widget.addFutureTomoObj(future_tomo_obj_2)
-            process._startProcessing.assert_called_once()
-
-            # some futures are still pending / running: processing must not end
-            widget.updateView()
-            process._endProcessing.assert_not_called()
-
-            # only one of the two futures finished: processing must not end
-            statuses["job-1"] = "finished"
-            widget.updateView()
-            process._endProcessing.assert_not_called()
-
-            # all futures reached a terminal status: processing must end
-            statuses["job-2"] = "error"
-            widget.updateView()
-            process._endProcessing.assert_called_once()
-
-            # a new future arriving after processing ended must restart it
-            statuses["job-3"] = "pending"
-            future_tomo_obj_3 = _create_future_tomo_obj(tmp_path, 2, "job-3")
-            widget.addFutureTomoObj(future_tomo_obj_3)
-            assert process._startProcessing.call_count == 2
-    finally:
-        widget.close()

tomwer-2.0.2/src/tomwer.egg-info/pkg_info

@@ -1,205 +0,0 @@
-Metadata-Version: 2.4
-Name: tomwer
-Version: 2.0.0.dev0
-Summary: Tomography workflow tools
-Author-email: Henri Payno <henri.payno@esrf.fr>, Pierre Paleo <pierre.paleo@esrf.fr>, Pierre-Olivier Autran <pierre-olivier.autran@esrf.fr>, Jérôme Lesaint <jerome.lesaint@esrf.fr>, Alessandro Mirone <mirone@esrf.fr>
-License: MIT
-Project-URL: Homepage, https://gitlab.esrf.fr/tomotools/tomwer
-Project-URL: Documentation, https://tomotools.gitlab-pages.esrf.fr/tomwer/
-Project-URL: Repository, https://gitlab.esrf.fr/tomotools/tomwer
-Project-URL: Issues, https://gitlab.esrf.fr/tomotools/tomwer/-/issues
-Project-URL: Changelog, https://gitlab.esrf.fr/tomotools/tomwer/-/blob/main/CHANGELOG.rst?ref_type=heads
-Keywords: orange3 add-on,ewoks
-Classifier: Intended Audience :: Education
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Environment :: Console
-Classifier: Environment :: X11 Applications :: Qt
-Classifier: Operating System :: POSIX
-Classifier: Natural Language :: English
-Classifier: Topic :: Scientific/Engineering :: Physics
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
-Description-Content-Type: text/x-rst
-License-File: LICENSE
-Requires-Dist: numpy
-Requires-Dist: setuptools
-Requires-Dist: psutil
-Requires-Dist: silx[full]>=2.1.1
-Requires-Dist: tomoscan>=2.2.0a6
-Requires-Dist: nxtomo>2.0.0dev2
-Requires-Dist: nxtomomill>=2.0.0dev0
-Requires-Dist: processview>=1.5.2
-Requires-Dist: ewokscore
-Requires-Dist: sluurp>=0.4.1
-Requires-Dist: packaging
-Requires-Dist: pint
-Requires-Dist: tqdm
-Requires-Dist: eval_type_backport; python_version < "3.10"
-Provides-Extra: full-base
-Requires-Dist: orange-canvas-core; extra == "full-base"
-Requires-Dist: orange-widget-base; extra == "full-base"
-Requires-Dist: ewokscore; extra == "full-base"
-Requires-Dist: ewoksorange>=3.0.0rc1; extra == "full-base"
-Requires-Dist: fabio; extra == "full-base"
-Requires-Dist: h5py>=3; extra == "full-base"
-Requires-Dist: lxml; extra == "full-base"
-Requires-Dist: werkzeug; extra == "full-base"
-Requires-Dist: json-rpc; extra == "full-base"
-Requires-Dist: scipy; extra == "full-base"
-Requires-Dist: Pillow; extra == "full-base"
-Requires-Dist: glymur<0.14; extra == "full-base"
-Requires-Dist: resource; extra == "full-base"
-Requires-Dist: tifffile; extra == "full-base"
-Requires-Dist: hdf5plugin; extra == "full-base"
-Requires-Dist: pyicat_plus; extra == "full-base"
-Requires-Dist: ewoksnotify[base]; extra == "full-base"
-Requires-Dist: ewoksnotify[icat]; extra == "full-base"
-Requires-Dist: chime; extra == "full-base"
-Requires-Dist: pyicat_plus; extra == "full-base"
-Requires-Dist: blissdata; extra == "full-base"
-Provides-Extra: full-no-cuda
-Requires-Dist: tomwer[full_base]; extra == "full-no-cuda"
-Requires-Dist: nabu>=2024.2.0; extra == "full-no-cuda"
-Provides-Extra: full
-Requires-Dist: tomwer[full_base]; extra == "full"
-Requires-Dist: nabu[full]>=2024.2.0; extra == "full"
-Requires-Dist: pycuda<2024.1.1; extra == "full"
-Requires-Dist: scikit-cuda; extra == "full"
-Provides-Extra: doc
-Requires-Dist: tomwer[full_no_cuda]; extra == "doc"
-Requires-Dist: Sphinx>=4.0.0; extra == "doc"
-Requires-Dist: nbsphinx; extra == "doc"
-Requires-Dist: pandoc; extra == "doc"
-Requires-Dist: jupyterlab; extra == "doc"
-Requires-Dist: pydata_sphinx_theme; extra == "doc"
-Requires-Dist: sphinx-design; extra == "doc"
-Requires-Dist: sphinx-autodoc-typehints; extra == "doc"
-Requires-Dist: sphinxcontrib-programoutput; extra == "doc"
-Requires-Dist: sphinxcontrib-youtube; extra == "doc"
-Requires-Dist: myst-parser; extra == "doc"
-Provides-Extra: dev-spec
-Requires-Dist: black; extra == "dev-spec"
-Requires-Dist: flake8; extra == "dev-spec"
-Requires-Dist: timeout-decorator; extra == "dev-spec"
-Requires-Dist: pyopencl; extra == "dev-spec"
-Provides-Extra: dev
-Requires-Dist: tomwer[full]; extra == "dev"
-Requires-Dist: tomwer[dev_spec]; extra == "dev"
-Provides-Extra: dev-no-cuda
-Requires-Dist: tomwer[full_no_cuda]; extra == "dev-no-cuda"
-Requires-Dist: tomwer[dev_spec]; extra == "dev-no-cuda"
-Provides-Extra: test
-Requires-Dist: tomwer[full_no_cuda]; extra == "test"
-Requires-Dist: pytest-asyncio; extra == "test"
-Requires-Dist: tomoscan[test]>=2.2.0a6; extra == "test"
-Dynamic: license-file
-
-.. image:: doc/img/tomwer.png
-   :alt: Tomwer Logo
-   :align: left
-   :width: 400px
-
-Introduction
-------------
-
-**Tomwer** provides tools to automate acquisition and reconstruction processes for tomography. The package includes:
-
-- A library to individually access each acquisition process.
-- Graphical User Interface (GUI) applications to control key processes such as reconstruction and data transfer, which can be executed as standalone applications.
-- An Orange add-on to help users define custom workflows (`Orange3 <http://orange.biolab.si>`_).
-
-Tomwer relies on `Nabu <https://gitlab.esrf.fr/tomotools/nabu>`_ for tomographic reconstruction.
-
-**Note**: Currently, the software is only compatible with Linux.
-
-Documentation
--------------
-
-The documentation is available here:
-
-`Stable Version <https://tomwer.readthedocs.io/en/stable/>`_
-
-`Latest Version <https://tomotools.gitlab-pages.esrf.fr/tomwer/>`_
-
-Installation
-------------
-
-Step 1: Installing Tomwer
-'''''''''''''''''''''''''
-
-To install Tomwer with all features:
-
-.. code-block:: bash
-
-    pip install tomwer[full]
-
-Alternatively, you can install the latest development branch from the repository:
-
-.. code-block:: bash
-
-    pip install git+https://gitlab.esrf.fr/tomotools/tomwer/#egg=tomwer[full]
-
-
-Step 2: (Optional) Update Orange-CANVAS-CORE and Orange-WIDGET-BASE
-''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-If you need access to additional 'processing' wheels and 'reprocess action,' you may want to update these Orange forks. This is optional, as the project works with the native Orange libraries.
-
-.. code-block:: bash
-
-    pip install git+https://github.com/payno/orange-canvas-core@0.2 --no-deps --upgrade
-    pip install git+https://github.com/payno/orange-widget-base@4.26 --no-deps --upgrade
-
-
-Launching Applications
------------------------
-
-After installation, Tomwer includes several applications. You can launch an application by running:
-
-.. code-block:: bash
-
-    tomwer <appName> [options]
-
-- If you run `tomwer` without arguments, a manual page will be displayed.
-- For application-specific help, run:
-
-.. code-block:: bash
-
-    tomwer <appName> --help
-
-
-Tomwer Canvas - Orange Canvas
------------------------------
-
-You can launch the Orange canvas to create workflows using the available building blocks:
-
-.. code-block:: bash
-
-    tomwer canvas
-
-- Alternatively, you can use `orange-canvas`.
-- If you're using a virtual environment, remember to activate it:
-
-.. code-block:: bash
-
-    source myvirtualenv/bin/activate
-
-
-Building Documentation
------------------------
-
-To build the documentation:
-
-.. code-block:: bash
-
-    sphinx-build doc build/html
-
-The documentation will be generated in `doc/build/html`, and the entry point is `index.html`. To view the documentation in a browser:
-
-.. code-block:: bash
-
-    firefox build/html/index.html
-
-**Note**: Building the documentation requires `sphinx` to be installed, which is not a hard dependency of Tomwer. If needed, install it separately.