tomwer 1.3.27__py3-none-any.whl → 1.4.0rc0__py3-none-any.whl

tomwer/core/process/reconstruction/nabu/nabuslices.py

@@ -1,32 +1,4 @@
-# coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2020 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__ = "26/10/2021"
-
+from __future__ import annotations
 
 import copy
 import functools
@@ -44,11 +16,10 @@ from tomwer.core.utils.scanutils import data_identifier_to_scan
 from tomwer.core.utils.slurm import is_slurm_available
 from tomwer.core.process.reconstruction.nabu.plane import NabuPlane
 from tomwer.core.process.reconstruction.nabu.utils import slice_index_to_int
-from tomwer.core.process.icat.gallery import (
-    IcatScreenshots,
-    deduce_dataset_gallery_location,
-)
 from tomwer.core.volume.volumefactory import VolumeFactory
+from tomwer.core.process.reconstruction.output import (
+    PROCESS_FOLDER_RECONSTRUCTED_SLICES,
+)
 
 try:
     from nabu.pipeline.fullfield.reconstruction import (  # noqa F401
@@ -70,7 +41,7 @@ else:
     has_nabu = True
     _err_import_nabu = None
 
-from typing import Iterable, Optional, Union
+from typing import Iterable
 
 from nabu import version as nabu_version
 from nabu.pipeline.config import (
@@ -114,32 +85,30 @@ def run_slices_reconstruction(
     config: dict,
     dry_run: bool = False,
     advancement=None,
-    process_id=None,
-    instanciate_classes_only: bool = False,
+    process_id: int | None = None,
+    instantiate_classes_only: bool = False,
 ) -> tuple:
     """
     call nabu for a reconstruction on scan with the given configuration
 
-    :param TomwerScanBase scan: scan to reconstruct
-    :param dict config: configuration to run the reconstruction.
+    :param scan: scan to reconstruct
+    :param config: configuration to run the reconstruction.
                         Contains nabu reconstruction parameters and slurm cluster
-                        configruation if requested (key: `slurm-cluster`).
-    :param bool dry_run: do we want to run dry
-    :param bool local: do we want to run a local reconstruction
+                        configuration if requested (key: `slurm-cluster`).
+    :param dry_run: do we want to run dry
+    :param local: do we want to run a local reconstruction
     :param stderr: file to redirect stderr
     :param stdout: file to redirect stdout
     :param advancement: optional Progress class to display advancement
-    :param int process_id: optional process id
-    :param bool instanciate_class_only: if we don't want to run the SingleSliceRunner but only return them. Use case: we want to keep a hand on processing and it can be cancelled
+    :param process_id: optional process id
+    :param instantiate_class_only: if we don't want to run the SingleSliceRunner but only return them. Use case: we want to keep a hand on processing and it can be cancelled
 
     :return: (all_succeed, stdouts, stderrs, final_configs, future_scan)
-             * all_succeed: bool, True if all the reconstruction succeed or if all job request succeed.
-             * stdouts: list of stdout of job reconstruction or job requests
-             * stderrs: list of stderr of job reconstruction or job requests
-             * final_configs: list of configurations submits to nabu
-             * future_scan: Optional[FutureTomwerScan] future scan containing futures pointing to job submited to the cluster.
-                            None if local reconstruction
-    :rtype: tuple
+        * all_succeed: bool, True if all the reconstruction succeed or if all job request succeed.
+        * stdouts: list of stdout of job reconstruction or job requests
+        * stderrs: list of stderr of job reconstruction or job requests
+        * final_configs: list of configurations submits to nabu
+        * future_scan: FutureTomwerScan | None future scan containing futures pointing to job submited to the cluster. None if local reconstruction
 
     Behavior: will clear the last slices reconstructed
     """
@@ -162,7 +131,7 @@ def run_slices_reconstruction(
     if scan.axis_params is not None and scan.axis_params.relative_cor_value is not None:
         if "reconstruction" in config:
             # move the cor value to the nabu reference
-            cor_nabu_ref = scan.axis_params.relative_cor_value + scan.dim_1 / 2.0
+            cor_nabu_ref = scan.axis_params.relative_cor_value + (scan.dim_1 - 1) / 2.0
             config["reconstruction"]["rotation_axis_position"] = str(cor_nabu_ref)
     _logger.info(f"set nabu reconstruction parameters to {scan}")
 
@@ -178,10 +147,10 @@ def run_slices_reconstruction(
     stdouts = []
     final_configs = []
     futures = []
-    instanciated_classes = []
+    instantiated_classes = []
     all_succeed = True
     if advancement is not None:
-        advancement.setMaxAdvancement(len(nabu_configurations))
+        advancement.total = len(nabu_configurations)
     scan.clear_latest_reconstructions()
     for nabu_configuration in nabu_configurations:
         l_config, slice_index = nabu_configuration
@@ -191,7 +160,7 @@ def run_slices_reconstruction(
             scan=scan,
             slice_index=slice_index,
             dry_run=dry_run,
-            instanciate_class_only=instanciate_classes_only,
+            instantiate_class_only=instantiate_classes_only,
             axis=config.get("reconstruction", {}).get("slice_plane", "XY"),
         )
 
@@ -199,8 +168,8 @@ def run_slices_reconstruction(
         if result is None:
             # in case of timeout or another issue. Log should already have been provided
             pass
-        elif instanciate_classes_only:
-            instanciated_classes.append(result)
+        elif instantiate_classes_only:
+            instantiated_classes.append(result)
             continue
         if slice_index is None:
             continue
@@ -229,10 +198,10 @@ def run_slices_reconstruction(
             all_succeed = all_succeed and result.success
 
         if advancement is not None:
-            advancement.increaseAdvancement(1)
+            advancement.update()
 
-    if instanciate_classes_only:
-        return instanciated_classes
+    if instantiate_classes_only:
+        return instantiated_classes
     if is_cluster_job:
         future_tomo_obj = FutureTomwerObject(
             tomo_obj=scan,
@@ -258,7 +227,7 @@ class NabuSlicesTask(
         "dry_run",
         "serialize_output_data",
     ),
-    output_names=("data", "nabu_params", "future_tomo_obj", "screenshots"),
+    output_names=("data", "nabu_params", "future_tomo_obj"),
 ):
     """
     Definition of the nabu reconstruction volume reconstruction process
@@ -321,10 +290,10 @@ class NabuSlicesTask(
                 scan=scan,
                 dry_run=self._dry_run,
                 process_id=self.process_id,
-                instanciate_classes_only=True,
+                instantiate_classes_only=True,
             )
         except Exception as e:
-            mess = f"Fail to instanciate slice reconstructor for {str(scan)}. Reason is {e}."
+            mess = f"Fail to instantiate slice reconstructor for {str(scan)}. Reason is {e}."
             _logger.processFailed(mess)
             ProcessManager().notify_dataset_state(
                 dataset=scan,
@@ -389,15 +358,6 @@ class NabuSlicesTask(
                 VolumeFactory.from_identifier_to_vol_urls(rec_identifier)
             )
 
-        self.outputs.screenshots = IcatScreenshots(
-            data_dir=deduce_dataset_gallery_location(scan),
-            screenshots={
-                os.path.splitext(os.path.basename(url.file_path()))[0]: url
-                for url in volume_urls
-            },
-            scan=scan,
-        )
-
         process_index = scan.pop_process_index()
         # update processes information / registration
         gc.collect()
@@ -470,15 +430,11 @@ class NabuSlicesTask(
         return self._dry_run
 
     @staticmethod
-    def get_process_frm_process_file(process_file, entry):
+    def get_process_frm_process_file(process_file: str, entry: str) -> dict:
         """
-        Read informations regarding the nabu process save in the
-        tomwer_process.h5 file
+        Read informations regarding the nabu process save in the tomwer_process.h5 file
 
-        :param process_file:
-        :param entry:
         :return: dictionary with the contain of the nabu process
-        :rtype:dict
         """
         if entry is None:
             with open_hdf5(process_file) as h5f:
@@ -553,15 +509,13 @@ class NabuSlicesTask(
                 return h5py_read_dataset(latest_nabu_node[path])
 
 
-def interpret_tomwer_configuration(
-    config: dict, scan: Union[TomwerScanBase, None]
-) -> tuple:
+def interpret_tomwer_configuration(config: dict, scan: TomwerScanBase | None) -> tuple:
     """
     tomwer can 'mock' the nabu reconstruction to request more feature.
     Typical use case is that we can ask for reconstruction of several
     slices and not only the volume
 
-    :param dict config: tomwer configuration for nabu
+    :param config: tomwer configuration for nabu
     :param scan: requested if we want to get slices
     :return: tuple of tuples (nabu configuration, is slice)
     """
@@ -624,10 +578,10 @@ class SingleSliceRunner(_NabuBaseReconstructor):
         scan: TomwerScanBase,
         config: dict,
         dry_run: bool,
-        slice_index: Union[int, str, None],
+        slice_index: int | str | None,
         axis: NabuPlane,
         target: Target,
-        cluster_config: Optional[dict],
+        cluster_config: dict | None,
         process_name: str,
         add_to_latest_reconstructions: bool = True,
     ) -> None:
@@ -657,6 +611,11 @@ class SingleSliceRunner(_NabuBaseReconstructor):
     def add_to_latest_reconstructions(self):
         return self._add_to_latest_reconstructions
 
+    @property
+    def processed_data_folder_name(self):
+        """return the specific processed folder name associated to this type of reconstruction."""
+        return PROCESS_FOLDER_RECONSTRUCTED_SLICES
+
     @docstring(_NabuBaseReconstructor)
     def only_create_config_file(self):
         return self.slice_index is None
@@ -690,9 +649,9 @@ class SingleSliceRunner(_NabuBaseReconstructor):
                 config_complete[key].update(self.config[key])
         config = config_complete
 
-        config["resources"] = utils.get_nabu_resources_desc(
-            scan=self.scan, workers=1, method="local"
-        )
+        config["resources"] = config.get("resources", {})
+        config["resources"]["method"] = "local"
+
         # force overwrite results
         if "output" not in config:
             config["output"] = {}
@@ -789,7 +748,7 @@ class SingleSliceRunner(_NabuBaseReconstructor):
         pag,
         ctf,
         db,
-        slice_index: Union[str, int],
+        slice_index: str | int,
         axis: NabuPlane,
     ):
         axis = NabuPlane.from_value(axis)
@@ -853,12 +812,8 @@ class SingleSliceRunner(_NabuBaseReconstructor):
     def _get_file_basename_reconstruction(self, pag, db, ctf, axis):
         """
 
-        :param TomwerScanBase scan: scan reconstructed
-        :param Union[None, int] slice_index: index of the slice reconstructed.
-                                            if None, we want to reconstruct the
-                                            entire volume
-        :param bool pag: is it a paganin reconstruction
-        :param int db: delta / beta parameter
+        :param pag: is it a paganin reconstruction
+        :param db: delta / beta parameter
         :return: basename of the file reconstructed (without any extension)
         """
         return self.get_file_basename_reconstruction(
@@ -875,30 +830,29 @@ def run_single_slice_reconstruction(
     scan,
     nabu_config,
     dry_run,
-    slice_index: Union[int, str, None],
-    process_id: Optional[int] = None,
-    cluster_config: Optional[dict] = None,
+    slice_index: int | str | None,
+    process_id: int | None = None,
+    cluster_config: dict | None = None,
     add_to_latest_reconstructions=True,
-    instanciate_class_only=False,
+    instantiate_class_only=False,
     axis: NabuPlane = NabuPlane.XY,
-) -> Optional[ResultsRun]:
+) -> ResultsRun | None:
     """
     # TODO: might need something like a context or an option "keep" slice in memory
 
     :param scan:
-    :param nabu_config: configruation of nabu process
-    :param cluster_config: configruation of cluster (slurm-cluster only for now)
+    :param nabu_config: configuration of nabu process
+    :param cluster_config: configuration of cluster (slurm-cluster only for now)
     :param dry_run:
-    :param Union[None,int, str] slice_index: slice index to reconstruct.
+    :param slice_index: slice index to reconstruct.
                                              If str should be "middle"
     :param local:
     :param stdout: file to redirect stdout
     :param stderr: file to redirect stderr
-    :param bool add_to_latest_reconstructions: if true add reconstructed slice to the latest reconstruction.
+    :param add_to_latest_reconstructions: if true add reconstructed slice to the latest reconstruction.
                                                We wan't to avoid this treatment for saaxis and sadeltebeta for example
-    :param bool instanciate_class_only: if we don't want to run the SingleSliceRunner but only return them. Use case: we want to keep a hand on processing and it can be cancelled
+    :param instantiate_class_only: if we don't want to run the SingleSliceRunner but only return them. Use case: we want to keep a hand on processing and it can be cancelled
     :return: result of the slice reconstruction if succeed to launch it.
-    :rtype: Optional[ResultsRun]
     """
     # TODO: remove local from the function signature
     target = Target.SLURM if cluster_config not in ({}, None) else Target.LOCAL
@@ -928,7 +882,7 @@ def run_single_slice_reconstruction(
         add_to_latest_reconstructions=add_to_latest_reconstructions,
         process_name=process_name,
     )
-    if instanciate_class_only:
+    if instantiate_class_only:
         return slice_reconstructor
 
     try:

tomwer/core/process/reconstruction/nabu/nabuvolume.py

@@ -1,38 +1,10 @@
-# coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2020 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__ = "26/10/2021"
-
+from __future__ import annotations
 
 import copy
 import functools
 import logging
 import os
-from typing import Iterable, Optional
+from typing import Iterable
 
 from nabu import version as nabu_version
 from nabu.pipeline.config import generate_nabu_configfile
@@ -50,11 +22,7 @@ from tomwer.core.cluster.cluster import SlurmClusterConfiguration
 from tomwer.core.futureobject import FutureTomwerObject
 from tomwer.core.process.reconstruction.nabu.plane import NabuPlane
 from tomwer.core.process.task import Task
-from tomwer.core.process.icat.gallery import (
-    IcatScreenshots,
-    deduce_dataset_gallery_location,
-    select_screenshot_from_volume,
-)
+from tomwer.core.process.drac.processeddataset import DracReconstructedVolumeDataset
 from tomwer.core.scan.edfscan import EDFTomoScan
 from tomwer.core.scan.nxtomoscan import NXtomoScan
 from tomwer.core.scan.scanbase import TomwerScanBase
@@ -65,6 +33,9 @@ from tomwer.core.volume.volumefactory import VolumeFactory
 from tomwer.io.utils.h5pyutils import EntryReader
 from tomwer.utils import docstring
 from tomwer.io.utils import format_stderr_stdout
+from tomwer.core.process.reconstruction.output import (
+    PROCESS_FOLDER_RECONSTRUCTED_VOLUMES,
+)
 
 from . import settings, utils
 from .nabucommon import ResultsLocalRun, ResultSlurmRun, _NabuBaseReconstructor
@@ -77,17 +48,16 @@ def run_volume_reconstruction(
     scan: TomwerScanBase,
     config: dict,
     dry_run: bool,
-    process_id: Optional[int] = None,
+    process_id: int | None = None,
 ) -> tuple:
     """
     Run a volume reconstruction. Scan need to have reconstruction parameters for nabu.
 
     Behavior: will clear link to the last volume reconstructed
 
-    :param int process_id: optional process id
+    :param process_id: optional process id
 
     :return: succeed, stdouts, stderrs, configs, future_scan
-    :rtype: tuple
     """
 
     if scan.nabu_recons_params in ({}, None):
@@ -199,7 +169,7 @@ class VolumeRunner(_NabuBaseReconstructor):
         self,
         scan: TomwerScanBase,
         config_nabu,
-        cluster_config: Optional[dict],
+        cluster_config: dict | None,
         dry_run: bool,
         target: Target,
         process_name: str,
@@ -217,15 +187,20 @@ class VolumeRunner(_NabuBaseReconstructor):
     def configuration(self):
         return self._config
 
+    @property
+    def processed_data_folder_name(self):
+        """return the specific processed folder name associated to this type of reconstruction."""
+        return PROCESS_FOLDER_RECONSTRUCTED_VOLUMES
+
     @docstring(_NabuBaseReconstructor)
     def run(self) -> Iterable:
         dataset_params = self.scan.get_nabu_dataset_info()
         if "dataset" in self.configuration:
             dataset_params.update(self.configuration["dataset"])
         self.configuration["dataset"] = dataset_params
-        self.configuration["resources"] = utils.get_nabu_resources_desc(
-            scan=self.scan, workers=1, method="local"
-        )
+
+        self.configuration["resources"] = self.configuration.get("resources", {})
+        self.configuration["resources"]["method"] = "local"
 
         # force overwrite results
         if "output" not in self.configuration:
@@ -337,12 +312,8 @@ class VolumeRunner(_NabuBaseReconstructor):
     def _get_file_basename_reconstruction(self, pag, db, ctf, axis):
         """
 
-        :param TomwerScanBase scan: scan reconstructed
-        :param Union[None, int] slice_index: index of the slice reconstructed.
-                                            if None, we want to reconstruct the
-                                            entire volume
-        :param bool pag: is it a paganin reconstruction
-        :param int db: delta / beta parameter
+        :param pag: is it a Paganin reconstruction
+        :param db: delta / beta parameter
         :param axis: axis over which the reconstruction goes. For volume always expected to be z. So ignored in the function
         :return: basename of the file reconstructed (without any extension)
         """
@@ -373,7 +344,12 @@ class NabuVolumeTask(
     Task,
     SuperviseProcess,
     input_names=("data", "nabu_params"),
-    output_names=("data", "volumes", "future_tomo_obj", "screenshots"),
+    output_names=(
+        "data",
+        "volumes",
+        "future_tomo_obj",
+        "data_portal_processed_datasets",
+    ),
     optional_input_names=(
         "dry_run",
         "nabu_extra_params",  # some parameter that must update 'nabu_params' before launching the reconstruction. Such as z range...
@@ -530,29 +506,27 @@ class NabuVolumeTask(
         self.outputs.future_tomo_obj = future_tomo_obj
 
         # build screenshots
+        data_portal_processed_datasets = []
         if scan.latest_vol_reconstructions is not None:
-            try:
-                screenshots = {}
-                [
-                    screenshots.update(
-                        select_screenshot_from_volume(
-                            VolumeFactory.create_tomo_object_from_identifier(
-                                rec_identifier
-                            )
-                        )
+            for volume_id in scan.latest_vol_reconstructions:
+                try:
+                    volume = VolumeFactory.create_tomo_object_from_identifier(
+                        identifier=volume_id
                     )
-                    for rec_identifier in scan.latest_vol_reconstructions
-                ]
-            except Exception as e:
-                _logger.error(f"screenshot creation failed. Error is {e}")
-            else:
-                self.outputs.screenshots = IcatScreenshots(
-                    data_dir=deduce_dataset_gallery_location(scan),
-                    screenshots=screenshots,
-                    scan=scan,
-                )
-        else:
-            self.outputs.screenshots = tuple()
+                except Exception as e:
+                    _logger.error(
+                        f"Fail to build volume from {volume_id}. Error is {e}"
+                    )
+                else:
+                    icatReconstructedDataset = DracReconstructedVolumeDataset(
+                        tomo_obj=volume,
+                        source_scan=scan,
+                    )
+                    data_portal_processed_datasets.append(icatReconstructedDataset)
+
+        self.outputs.data_portal_processed_datasets = tuple(
+            data_portal_processed_datasets
+        )
 
     def set_configuration(self, configuration: dict) -> None:
         Task.set_configuration(self, configuration=configuration)

tomwer/core/process/reconstruction/nabu/plane.py

@@ -7,3 +7,13 @@ class NabuPlane(_Enum):
     YZ = "YZ"
     XZ = "XZ"
     XY = "XY"
+
+    @classmethod
+    def from_value(cls, value):
+        if value == 0:
+            return NabuPlane.XY
+        elif value == 1:
+            return NabuPlane.XZ
+        elif value == 2:
+            return NabuPlane.YZ
+        return super().from_value(value=value)

tomwer/core/process/reconstruction/nabu/settings.py

@@ -1,32 +1,5 @@
 # coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2020 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__ = "06/08/2020"
-
+from __future__ import annotations
 
 import logging
 

tomwer/core/process/reconstruction/nabu/target.py

@@ -1,32 +1,4 @@
 # coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2020 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__ = "26/10/2021"
-
 
 from silx.utils.enum import Enum as _Enum