tomwer 1.3.26__py3-none-any.whl → 1.4.0__py3-none-any.whl

tomwer/gui/utils/sandboxes.py

@@ -1,36 +1,11 @@
 # coding: utf-8
-# /*##########################################################################
-# Copyright (C) 2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-#############################################################################*/
 
 """
 This module is used to define the process of the reference creator.
 This is related to the issue #184
 """
 
-__authors__ = ["H.Payno"]
-__license__ = "MIT"
-__date__ = "19/07/2018"
-
+from __future__ import annotations
 
 from silx.gui import qt
 

tomwer/gui/utils/scandescription.py

@@ -1,33 +1,4 @@
-# coding: utf-8
-# /*##########################################################################
-# Copyright (C) 2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-#############################################################################*/
-
-__authors__ = ["H.Payno"]
-__license__ = "MIT"
-__date__ = "04/02/2020"
-
-
-from typing import Optional
+from __future__ import annotations
 
 from silx.gui import qt
 
@@ -61,7 +32,7 @@ class ScanNameLabelAndShape(qt.QWidget):
         # set up
         self.clear()
 
-    def setScan(self, scan: Optional[TomwerScanBase]):
+    def setScan(self, scan: TomwerScanBase | None):
         if scan is None or scan.path is None:
             self.clear()
         elif not isinstance(scan, TomwerScanBase):

tomwer/gui/utils/scrollarea.py

@@ -1,73 +1,24 @@
 # coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-# ###########################################################################*/
+from __future__ import annotations
 
-__authors__ = ["H. Payno"]
-__license__ = "MIT"
-__date__ = "16/04/2021"
 
 from silx.gui import qt
 
 
 class _IgnoreWheelBase:
-    """QWidget giving priority to the scrollArea containing it"""
-
-    def __init__(self, scrollArea):
-        self._scrollArea = scrollArea
+    """QWidget ignoring "wheelEvent" and forwarding it to its parent in case this is a QScrollArea"""
 
     def wheelEvent(self, *args, **kwargs):
-        if self._scrollArea is not None:
-            self._scrollArea.wheelEvent(*args, **kwargs)
+        pass
 
 
 class QComboBoxIgnoreWheel(qt.QComboBox, _IgnoreWheelBase):
-    """Combobox which give priority to the scrollArea containing it"""
-
-    def __init__(self, parent, scrollArea):
-        qt.QComboBox.__init__(self, parent, scrollArea=scrollArea)
-        _IgnoreWheelBase.__init__(self, scrollArea)
-
-    def wheelEvent(self, *args, **kwargs):
-        # Note: we are enforce to duplicate this due to an error on pyqt side.
-        self._scrollArea.wheelEvent(*args, **kwargs)
+    pass
 
 
 class QDoubleSpinBoxIgnoreWheel(qt.QDoubleSpinBox):
-    def __init__(self, parent, scrollArea):
-        qt.QDoubleSpinBox.__init__(self, parent)
-        _IgnoreWheelBase.__init__(self, scrollArea)
-
-    def wheelEvent(self, *args, **kwargs):
-        # Note: we are enforce to duplicate this due to an error on pyqt side.
-        self._scrollArea.wheelEvent(*args, **kwargs)
+    pass
 
 
 class QSpinBoxIgnoreWheel(qt.QSpinBox, _IgnoreWheelBase):
-    def __init__(self, parent, scrollArea):
-        qt.QSpinBox.__init__(self, parent, scrollArea=scrollArea)
-        _IgnoreWheelBase.__init__(self, scrollArea)
-
-    def wheelEvent(self, *args, **kwargs):
-        # Note: we are enforce to duplicate this due to an error on pyqt side.
-        self._scrollArea.wheelEvent(*args, **kwargs)
+    pass

tomwer/gui/utils/slider.py

@@ -1,33 +1,9 @@
 # coding: utf-8
-# /*##########################################################################
-# Copyright (C) 2016 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-#############################################################################*/
+
 """some utils relative to PyHST
 """
 
-__authors__ = ["H. Payno"]
-__license__ = "MIT"
-__date__ = "17/02/2021"
-
+from __future__ import annotations
 
 import numpy
 from silx.gui import qt
@@ -67,8 +43,8 @@ class LogSlider(qt.QWidget):
         """
         Define slider range
 
-        :param float min_:
-        :param float max_:
+        :param min_:
+        :param max_:
         """
         if min_ <= 0.0 or max_ <= 0.0:
             raise ValueError("LogSlider can only handled positive values")

tomwer/gui/utils/splashscreen.py

@@ -1,32 +1,4 @@
 # coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-# ###########################################################################*/
-
-__authors__ = ["H. Payno", "T. Vincent"]
-__license__ = "MIT"
-__date__ = "04/01/2018"
-
 
 try:
     from silx.gui import qt

tomwer/gui/utils/step.py

@@ -1,6 +1,7 @@
+from __future__ import annotations
+
 import functools
 from silx.gui import qt
-from typing import Optional, Union
 from tomwer.gui.utils.qt_utils import block_signals
 
 
@@ -8,8 +9,8 @@ class StepSizeSelectorWidget(qt.QGroupBox):
     """
     Widget to define some steps size (as float). Used by the Axis and the AxisOrdered widgets
 
-    :param str title: title to provide to the group box
-    :param str label: text for the label set at the left of the QLineEdit
+    :param title: title to provide to the group box
+    :param label: text for the label set at the left of the QLineEdit
     :param fine_value: (optional) value to provide for 'fine' step
     :param medium_value: (optional) value to provide for 'medium' step
     :param rough_value: (optional) value to provide for 'rough' step
@@ -17,17 +18,18 @@ class StepSizeSelectorWidget(qt.QGroupBox):
     """
 
     valueChanged = qt.Signal()
+    """emit when the step size change"""
 
     def __init__(
         self,
         parent=None,
         title="",
         label: str = "step size",
-        fine_value: [float, int, None] = 0.1,
-        medium_value: [float, int, None] = 0.5,
-        rough_value: [float, int, None] = 1.0,
-        unit: Optional[str] = "px",
-        dtype: Union[int, float] = float,
+        fine_value: float | int | None = 0.1,
+        medium_value: float | int | None = 0.5,
+        rough_value: float | int | None = 1.0,
+        unit: str | None = "px",
+        dtype: int | float = float,
     ):
         assert fine_value is None or isinstance(
             fine_value, dtype
@@ -127,18 +129,17 @@ class StepSizeSelectorWidget(qt.QGroupBox):
             with block_signals(button):
                 button.setChecked(activation_value == current_value)
 
-    def getStepSize(self) -> Union[float, int]:
+    def getStepSize(self) -> float | int:
         """
 
-        :return: displacement shift defined
-        :rtype: float
+        :return: displacement shift defined. Output is of same type as the 'dtype' provided during construction.
         """
         return self._dtype(self._manualLE.text())
 
-    def setStepSize(self, value: Union[float, int]):
+    def setStepSize(self, value: float | int):
         """
 
-        :param float value: shift step
+        :param value: shift step
         """
         assert isinstance(value, self._dtype)
         self._manualLE.setText(str(value))

tomwer/gui/utils/tests/test_completer.py

@@ -0,0 +1,41 @@
+# coding: utf-8
+
+"""module defining dedicated completer"""
+
+from __future__ import annotations
+
+
+import pytest
+from silx.gui import qt
+from silx.gui.utils.testutils import TestCaseQt
+
+from tomwer.gui.utils.completer import UrlCompleterDialog
+from tomwer.tests.utils import skip_gui_test
+
+
+@pytest.mark.skipif(skip_gui_test(), reason="skip gui test")
+class TestUrlCompleterDialog(TestCaseQt):
+    def setUp(self):
+        super().setUp()
+        self._urls = (
+            "test",
+            "test1",
+            "test2",
+        )
+        self._dialog = UrlCompleterDialog(
+            urls=self._urls,
+            current_url="test",
+        )
+
+    def tearDown(self):
+        self._dialog.setAttribute(qt.Qt.WA_DeleteOnClose)
+        self._dialog.close()
+        self._dialog = None
+        super().tearDown()
+
+    def test(self):
+        """simple test on the dialog behavior"""
+        assert self._dialog._buttons.button(qt.QDialogButtonBox.Ok).isEnabled()
+        self._dialog._completerWidget.setText("toto")
+        self.qapp.processEvents()
+        assert not self._dialog._buttons.button(qt.QDialogButtonBox.Ok).isEnabled()

tomwer/gui/utils/tests/test_line_selector.py

@@ -0,0 +1,21 @@
+import numpy
+
+from tomwer.gui.utils.lineselector.lineselector import QSliceSelectorDialog
+from tomwer.tests.conftest import qtapp  # noqa F401
+
+
+def test_line_selector(
+    qtapp,  # noqa F811
+):
+    dialog = QSliceSelectorDialog(parent=None)
+    dialog.setData(
+        numpy.ones((100, 100)),
+    )
+    dialog.mainWidget.addSlice(2)
+    dialog.mainWidget.addSlice(12)
+    assert dialog.getSelection() == (2, 12)
+    dialog.mainWidget.removeSlice(12)
+    assert dialog.getSelection() == (2,)
+    dialog.setSelection((12, 23))
+    assert dialog.getSelection() == (12, 23)
+    assert dialog.mainWidget.nSelected() == 2

tomwer/gui/utils/tests/test_splashscreen.py

@@ -0,0 +1,8 @@
+from silx.gui import qt
+
+from tomwer.gui.utils.splashscreen import getMainSplashScreen
+from tomwer.tests.conftest import qtapp  # noqa F401
+
+
+def test_get_splash_screen(qtapp):  # noqa F401
+    assert isinstance(getMainSplashScreen(), qt.QSplashScreen)

tomwer/gui/utils/tests/test_vignettes.py

@@ -0,0 +1,68 @@
+"""
+test vignettes
+"""
+
+import time
+import numpy
+import pytest
+from silx.gui import qt
+from silx.gui.utils.testutils import TestCaseQt
+
+from tomwer.core.process.reconstruction.scores.scores import ComputedScore, ScoreMethod
+from tomwer.gui.utils.vignettes import VignettesQDialog
+from tomwer.tests.utils import skip_gui_test
+
+
+@pytest.mark.skipif(skip_gui_test(), reason="skip gui test")
+class TestVignettes(TestCaseQt):
+    def setUp(self):
+        super().setUp()
+        self._window = VignettesQDialog(
+            value_name="cor",
+            score_name="score",
+        )
+
+    def tearDown(self):
+        self._window.setAttribute(qt.Qt.WA_DeleteOnClose)
+        self._window.close()
+        self._window = None
+        super().tearDown()
+
+    def test(self):
+        self._window.setScores(
+            scores={
+                "3": (numpy.ones((100, 100)), ComputedScore(tv=2.0, std=3.2)),
+                "7": (numpy.zeros((100, 100)), ComputedScore(tv=25, std=0.6)),
+            },
+            score_method="standard deviation",
+        )
+        self._window.show()
+        self.qWaitForWindowExposed(self._window)
+
+        def assert_scores_are_equal(scores_1, scores_2):
+            assert scores_1.keys() == scores_2.keys()
+            for key, (data_1, computed_score_1) in scores_1.items():
+                data_2, computed_score_2 = scores_2[key]
+                numpy.testing.assert_array_almost_equal(data_1, data_2)
+                assert computed_score_1 == computed_score_2
+
+        scores, score_method = self._window._vignettesWidget.getScores()
+        assert_scores_are_equal(
+            scores_1=scores,
+            scores_2={
+                "3": (numpy.ones((100, 100)), ComputedScore(std=3.2, tv=None)),
+                "7": (numpy.zeros((100, 100)), ComputedScore(std=0.6, tv=None)),
+            },
+        )
+        assert score_method is ScoreMethod.STD
+
+        self._window.setNbColumn(4)
+        self._window.setNbColumn(2)
+        with pytest.raises(ValueError):
+            self._window.setNbColumn(20)
+        self._window.setNbColumn("auto")
+
+        self._window.resize(qt.QSize(400, 400))
+        self.qapp.processEvents()
+        time.sleep(VignettesQDialog.RESIZE_MAX_TIME * 2 / 1000)
+        self.qapp.processEvents()

tomwer/gui/utils/unitsystem.py

@@ -1,41 +1,17 @@
 # coding: utf-8
-# /*##########################################################################
-# Copyright (C) 2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-#############################################################################*/
 
 """
 This module is used to define the process of the reference creator.
 This is related to the issue #184
 """
 
-__authors__ = ["H.Payno"]
-__license__ = "MIT"
-__date__ = "21/09/2018"
+from __future__ import annotations
 
 
 import logging
 
 from silx.gui import qt
-from pyunitsystem import metricsystem
+from pyunitsystem.metricsystem import MetricSystem
 
 from tomwer.core.utils.char import MU_CHAR
 
@@ -44,6 +20,7 @@ _logger = logging.getLogger(__name__)
 
 class PixelEntry(qt.QWidget):
     valueChanged = qt.Signal()
+    """emit when the pixel value change"""
 
     class Validator(qt.QIntValidator):
         def validate(self, a0: str, a1: int):
@@ -85,11 +62,12 @@ class MetricEntry(qt.QWidget):
     Create a simple line with a name, a QLineEdit and a combobox to define the
     unit in order to define a metric value.
 
-    :param str name: name of the metric value to define
-    :param str: base_unit. Default way to present a value when setted
+    :param name: name of the metric value to define
+    :param default_unit: Default way to present a value when set
     """
 
     editingFinished = qt.Signal()
+    """emit when editing is finished"""
 
     class DoubleValidator(qt.QDoubleValidator):
         def __init__(self, *args, **kwargs):
@@ -103,14 +81,15 @@ class MetricEntry(qt.QWidget):
                 return super().validate(a0, a1)
 
     _CONVERSION = {
-        "nm": metricsystem.nanometer.value,
-        f"{MU_CHAR}m": metricsystem.micrometer.value,
-        "mm": metricsystem.millimeter.value,
-        "cm": metricsystem.centimeter.value,
-        "m": metricsystem.meter.value,
+        "nm": MetricSystem.NANOMETER.value,
+        f"{MU_CHAR}m": MetricSystem.MICROMETER.value,
+        "mm": MetricSystem.MILLIMETER.value,
+        "cm": MetricSystem.CENTIMETER.value,
+        "m": MetricSystem.METER.value,
     }
 
     valueChanged = qt.Signal()
+    """emit when the metric value change"""
 
     def __init__(self, name, value=0.0, default_unit="m", parent=None):
         qt.QWidget.__init__(self, parent)
@@ -155,7 +134,7 @@ class MetricEntry(qt.QWidget):
     def setValue(self, value_m, displayed_unit: str = "m"):
         """
 
-        :param float value: pixel size in international metric system (meter)
+        :param value: pixel size in international metric system (meter)
         """
         _value = value_m
         if _value in (None, "unknown"):
@@ -185,11 +164,10 @@ class MetricEntry(qt.QWidget):
         else:
             self._qcbUnit.setCurrentIndex(index)
 
-    def getValue(self):
+    def getValue(self) -> float:
         """
 
         :return: the value in meter
-        :rtype: float
         """
         if self._qlePixelSize.text() in ("unknown", ""):
             return None
@@ -200,38 +178,6 @@ class MetricEntry(qt.QWidget):
         self._qlePixelSize.setValidator(validator)
 
     def setUnit(self, unit):
-        unit = str(metricsystem.MetricSystem.from_value(unit))
+        unit = str(MetricSystem.from_value(unit))
         idx = self._qcbUnit.findText(unit)
         self._qcbUnit.setCurrentIndex(idx)
-
-
-class CentimeterEntry(MetricEntry):
-    """
-    Define a QlineEdit which will set and get metric values in centimeter
-    """
-
-    def __init__(self, name, default_unit="cm", parent=None):
-        MetricEntry.__init__(self, name, default_unit=default_unit, parent=parent)
-
-    def setValue(self, value):
-        """
-
-        :param float value: pixel size in centimeter
-        """
-        _value = value
-        if type(_value) is str:
-            try:
-                _value = float(_value)
-            except Exception as error:
-                raise ValueError("Given string does not represent a float", error)
-        _value = _value * metricsystem.centimeter
-        MetricEntry.setValue(self, _value)
-
-    def getValue(self):
-        """
-
-        :return: the value in meter
-        :rtype: float
-        """
-        value = MetricEntry.getValue(self)
-        return value / metricsystem.centimeter

tomwer/gui/utils/utils.py

@@ -2,9 +2,8 @@
 Some utils GUI associated to illustrations
 """
 
-__authors__ = ["H.Payno"]
-__license__ = "MIT"
-__date__ = "29/01/2020"
+from __future__ import annotations
+from silx.io.url import DataUrl
 
 
 import logging
@@ -44,11 +43,11 @@ def has_imagej():
     return __has_image_j
 
 
-def open_url_with_image_j(url) -> threading.Thread:
+def open_url_with_image_j(url: DataUrl) -> threading.Thread:
     """open the url in an imagej subprocess within a thread.
     It is up to the caller to handle thread life
 
-    :param DataUrl url: url we want to open in imagej
+    :param url: url we want to open in imagej
     """
     global __image_j_from
     if not has_imagej():