dcnum 0.16.8__py3-none-any.whl → 0.17.1__py3-none-any.whl

dcnum/_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.16.8'
-__version_tuple__ = version_tuple = (0, 16, 8)
+__version__ = version = '0.17.1'
+__version_tuple__ = version_tuple = (0, 17, 1)

dcnum/feat/feat_background/base.py

@@ -4,7 +4,6 @@ import inspect
 import multiprocessing as mp
 import pathlib
 import uuid
-import warnings
 
 import h5py
 import numpy as np
@@ -212,13 +211,6 @@ class Background(abc.ABC):
     def process_approach(self):
         """The actual background computation approach"""
 
-    @classmethod
-    def get_ppid_from_kwargs(cls, kwargs):
-        warnings.warn(
-            "Please use get_ppid_from_ppkw instead of get_ppid_from_kwargs",
-            DeprecationWarning)
-        return cls.get_ppid_from_ppkw(kwargs)
-
 
 @functools.cache
 def get_available_background_methods():

dcnum/feat/gate.py

@@ -139,13 +139,6 @@ class Gate:
                                 ppid=pp_gate_kwargs)
         return kwargs
 
-    @classmethod
-    def get_ppid_from_kwargs(cls, kwargs):
-        warnings.warn(
-            "Please use get_ppid_from_ppkw instead of get_ppid_from_kwargs",
-            DeprecationWarning)
-        return cls.get_ppid_from_ppkw(kwargs)
-
     def gate_event(self, event):
         """Return None if the event should not be used, else `event`"""
         if self.box_gates and event:

dcnum/feat/queue_event_extractor.py

@@ -7,7 +7,6 @@ import os
 import queue
 import threading
 import traceback
-import warnings
 
 import numpy as np
 
@@ -126,8 +125,7 @@ class QueueEventExtractor:
                         num_extractors: int,
                         log_queue: mp.Queue,
                         log_level: int = logging.INFO,
-                        preselect: None = None,
-                        ptp_median: None = None):
+                        ):
         """Get initialization arguments for :cass:`.QueueEventExtractor`
 
         This method was created for convenience reasons:
@@ -147,8 +145,6 @@ class QueueEventExtractor:
             Queue the worker uses for sending log messages
         log_level: int
             Logging level to use in the worker process
-        preselect, ptp_median:
-            Deprecated
 
         Returns
         -------
@@ -160,13 +156,6 @@ class QueueEventExtractor:
         # queue with event-wise feature dictionaries
         event_queue = mp_spawn.Queue()
 
-        if preselect is not None:
-            warnings.warn("The `preselect` argument is deprecated!",
-                          DeprecationWarning)
-        if ptp_median is not None:
-            warnings.warn("The `ptp_median` argument is deprecated!",
-                          DeprecationWarning)
-
         # Note that the order must be identical to  __init__
         args = collections.OrderedDict()
         args["data"] = data
@@ -382,13 +371,6 @@ class QueueEventExtractor:
             self.log_queue.close()
             self.log_queue.join_thread()
 
-    @classmethod
-    def get_ppid_from_kwargs(cls, kwargs):
-        warnings.warn(
-            "Please use get_ppid_from_ppkw instead of get_ppid_from_kwargs",
-            DeprecationWarning)
-        return cls.get_ppid_from_ppkw(kwargs)
-
 
 class EventExtractorProcess(QueueEventExtractor, mp_spawn.Process):
     """Multiprocessing worker for regular segmentation and extraction"""

dcnum/meta/__init__.py

@@ -1,2 +1,3 @@
 # flake8: noqa: F401
+from . import paths
 from . import ppid

dcnum/meta/paths.py

@@ -0,0 +1,30 @@
+import pathlib
+
+search_path_registry = {}
+
+
+def register_search_path(topic: str,
+                         search_path: str | pathlib.Path):
+    """Register a search path for a given topic
+
+    Search paths are a global solution for organizing the locations
+    of resources that are part of an analysis pipeline. For instance,
+    if the location of such a file that depends on where your pipeline is
+    running, you can register multiple search paths and the file will
+    be found using :func:`find_file`.
+    """
+    topic_list = search_path_registry.setdefault(topic, [])
+    topic_list.append(pathlib.Path(search_path))
+
+
+def find_file(topic: str,
+              file_name: str):
+    """Find a file in the search path for the given topic"""
+    search_paths = search_path_registry.get(topic, [])
+    for pp in search_paths:
+        pf = pp / file_name
+        if pf.is_file():
+            return pf
+    else:
+        raise KeyError(f"Could not find {file_name} for {topic} in the "
+                       f"registered search paths {search_paths}")

dcnum/meta/ppid.py

@@ -71,14 +71,8 @@ def get_class_method_info(class_obj: ClassWithPPIDCapabilities,
         are extracted.
     """
     doc = class_obj.__doc__ or class_obj.__init__.__doc__
-    if hasattr(class_obj, "key"):
-        warnings.warn(f"{class_obj.__class__} implements `key` which is "
-                      f"deprecated. Please rename to `get_ppid_code`.",
-                      DeprecationWarning)
-        setattr(class_obj, "get_ppid_code", class_obj.key)
     info = {
         "code": class_obj.get_ppid_code(),
-        "key": class_obj.get_ppid_code(),  # Deprecated
         "doc": doc,
         "title": doc.split("\n")[0],
         }
@@ -116,11 +110,10 @@ def kwargs_to_ppid(cls: ClassWithPPIDCapabilities,
                    f"segmenter and had to implement `__init__`, make sure "
                    f"that it accepts all kwonly-arguments its super class "
                    f"accepts. If this is not the case, you are probably "
-                   f"passing bad kwargs to the segmenter!"
+                   f"passing invalid kwargs to the segmenter."
                    )
             if allow_invalid_keys:
-                warnings.warn(msg + " Please cleanup your code!",
-                              DeprecationWarning)
+                warnings.warn(msg, UserWarning)
             else:
                 raise KeyError(msg)
         kwannot = info["annotations"][method]

dcnum/read/const.py

@@ -1,10 +1,9 @@
-#: Scalar features that apply to all events in a frame
+#: Scalar features that apply to all events in a frame and which are
+#: not computed from image or image_bg data.
 PROTECTED_FEATURES = [
-    "bg_med",
     "flow_rate",
     "frame",
     "g_force",
-    "index_online",
     "pressure",
     "temp",
     "temp_amb",

dcnum/read/hdf5_data.py

@@ -162,20 +162,6 @@ class HDF5Data:
 
         if state["pixel_size"] is not None:
             self.pixel_size = state["pixel_size"]
-        else:
-            # Set known pixel size if possible
-            did = self.meta.get("setup:identifier", "EMPTY")
-            if (did.startswith("RC-")
-                    and (self.pixel_size < 0.255 or self.pixel_size > 0.275)):
-                warnings.warn(
-                    f"Correcting for invalid pixel size in '{self.path}'!")
-                warnings.warn(
-                    "Correcting the pixel size is deprecated in dcnum; please "
-                    "make sure your input data are clean before processing",
-                    DeprecationWarning
-                )
-                # Set default pixel size for Rivercyte devices
-                self.pixel_size = 0.2645
 
         self.image_cache_size = state["image_cache_size"]
 

dcnum/segm/segm_thresh.py

@@ -15,6 +15,10 @@ class SegmentThresh(CPUSegmenter):
 
         Parameters
         ----------
+        thresh: int
+            grayscale threhold value for creating the mask image;
+            For a background-corrected image, pixels with values below
+            this value are considered to be part of the mask.
         """
         super(SegmentThresh, self).__init__(thresh=thresh, *args, **kwargs)
 

dcnum/segm/segmenter.py

@@ -4,7 +4,6 @@ import functools
 import inspect
 import logging
 from typing import Dict
-import warnings
 
 import cv2
 import numpy as np
@@ -132,10 +131,10 @@ class Segmenter(abc.ABC):
         # Start with the default mask kwargs defined for this subclass
         kwargs_mask_used = copy.deepcopy(cls.mask_default_kwargs)
         kwargs_mask_used.update(kwargs_mask)
-        key = cls.get_ppid_code()
+        code = cls.get_ppid_code()
         csegm = kwargs_to_ppid(cls, "segment_approach", kwargs)
         cmask = kwargs_to_ppid(cls, "process_mask", kwargs_mask_used)
-        return ":".join([key, csegm, cmask])
+        return ":".join([code, csegm, cmask])
 
     @staticmethod
     def get_ppkw_from_ppid(segm_ppid):
@@ -280,13 +279,6 @@ class Segmenter(abc.ABC):
     def segment_batch(self, data, start=None, stop=None):
         """Return the integer labels for an entire batch"""
 
-    @classmethod
-    def get_ppid_from_kwargs(cls, *args, **kwargs):
-        warnings.warn(
-            "Please use get_ppid_from_ppkw instead of get_ppid_from_kwargs.",
-            DeprecationWarning)
-        return cls.get_ppid_from_ppkw(*args, **kwargs)
-
 
 @functools.cache
 def get_available_segmenters():

dcnum/segm/segmenter_gpu.py

@@ -1,5 +1,4 @@
 import abc
-import pathlib
 from typing import Dict
 
 import numpy as np
@@ -39,11 +38,6 @@ class GPUSegmenter(Segmenter, abc.ABC):
                                            debug=debug,
                                            **kwargs)
 
-    @staticmethod
-    def _get_model_path(model_file):
-        """Custom hook that may be defined by subclasses"""
-        return pathlib.Path(model_file)
-
     def segment_batch(self,
                       image_data: np.ndarray,
                       start: int = None,

{dcnum-0.16.8.dist-info → dcnum-0.17.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dcnum
-Version: 0.16.8
+Version: 0.17.1
 Summary: numerics toolbox for imaging deformability cytometry
 Author: Maximilian Schlögel, Paul Müller
 Maintainer-email: Paul Müller <dev@craban.de>

{dcnum-0.16.8.dist-info → dcnum-0.17.1.dist-info}/RECORD

@@ -1,11 +1,11 @@
 dcnum/__init__.py,sha256=hcawIKS7utYiOyVhOAX9t7K3xYzP1b9862VV0b6qSrQ,74
-dcnum/_version.py,sha256=9RDap9Epg0PWfAHpF1CbM0Nbp6dRrQKcwV8RmgVyzJs,413
+dcnum/_version.py,sha256=_lgKa5p_bLODIZJPNplciMDP-zYDU8I4ZC5LbeKWQ08,413
 dcnum/feat/__init__.py,sha256=JqlgzOgDJhoTk8WVYcIiKTWq9EAM16_jGivzOtN6JGo,325
 dcnum/feat/event_extractor_manager_thread.py,sha256=Ocid_t1awH6pOmurCmKYkC51XsXB0-DoN3fzjFDgE4c,7129
-dcnum/feat/gate.py,sha256=ZTV2tkNqJBGmwemZrI0IAaPXTLgWO_5ZVxnpqr2G1cI,7464
-dcnum/feat/queue_event_extractor.py,sha256=eacmcM_uHHW6GtqCCtDCZib9423TGvuqgxGKAxv0tgc,15686
+dcnum/feat/gate.py,sha256=svbObmqpYdqPawpfrsEjTiUPJXf24GrNi8PXTKT-z44,7225
+dcnum/feat/queue_event_extractor.py,sha256=3CIjZOwOD8JZZTgbE9_jC81B8lbNtVElSV371Q9zoSc,15005
 dcnum/feat/feat_background/__init__.py,sha256=OTmMuazHNaSrZb2XW4cnJ6PlgJLbKrPbaidpEixYa0A,341
-dcnum/feat/feat_background/base.py,sha256=IPHJN9Stdk7WZbbAn5VPNLMZmA2VTL_I0IdJNEgPFNw,8374
+dcnum/feat/feat_background/base.py,sha256=DKcNSQOSi0cuo4zFbqtgDJnRiYDwoKkw2GQxpnK14fA,8119
 dcnum/feat/feat_background/bg_copy.py,sha256=EbeIy28gyPJr01Xens881IC1BtaTS5q-BkXPd3b6cLk,726
 dcnum/feat/feat_background/bg_roll_median.py,sha256=HgiGoyfLkygIlCoo8cBbf3gQt5uvM2S6_ez_V1hhCb4,12834
 dcnum/feat/feat_background/bg_sparse_median.py,sha256=LbWbDxAruGagidHt9wybyqkXp9OKi3eWXceujirpsqY,17608
@@ -22,24 +22,25 @@ dcnum/logic/__init__.py,sha256=7J3GrwJInNQbrLk61HRIV7X7p69TAIbMYpR34hh6u14,177
 dcnum/logic/ctrl.py,sha256=7m1HL_kO62d8Kt_o4gX3bhxbI4pwOhv3HWHRmbCaMp0,27022
 dcnum/logic/job.py,sha256=M0Q-Rfcm-zkTXTQc79W6YSNUjUlgmRPG0Ikbdn1aOpY,4608
 dcnum/logic/json_encoder.py,sha256=dy44ArmdnxpUfxxONmKdIv-fde3aTXPjZDN0HPATaxs,467
-dcnum/meta/__init__.py,sha256=cQT_HN5yDKzMnZM8CUyNmeA68OhE3ENO_rvFmgDj95c,40
-dcnum/meta/ppid.py,sha256=_xUqJal4wBqgic2aRN3ZMMteTggHeYGs44nrYbTKlpQ,8107
+dcnum/meta/__init__.py,sha256=AVqRgyKXO1orKnE305h88IBvoZ1oz6X11HN1WP5nGvg,60
+dcnum/meta/paths.py,sha256=J_ikeHzd7gEeRgAKjuayz3x6q4h1fOiDadM-ZxhAGm4,1053
+dcnum/meta/ppid.py,sha256=f3xT6k9EMhrmk2T_e-2LHE9qdXeGMZJcNOIIpr-_eb4,7706
 dcnum/read/__init__.py,sha256=iV2wrBMdwJgpXaphNiiAVybndDzTTv0CAGRNXyvxcLY,157
 dcnum/read/cache.py,sha256=HXbRFyTNT08_imv2460hMKVrfRrU6WnbJoO71HR1j8E,5800
-dcnum/read/const.py,sha256=SVlvEJiRIHyTyUlWG24_ogcnT5nTxCi0CRslNuNP56I,282
-dcnum/read/hdf5_data.py,sha256=tRSfBmrAZo7yNAnFLMj9yfh26_23pHxkZclX6RyzcYg,18864
+dcnum/read/const.py,sha256=ccME3dOK7DEXNhkTD90I7KF8zagzZufnbFkrYwQeIUo,307
+dcnum/read/hdf5_data.py,sha256=dO2VZKBA7bOOku37sdv5SJgZ8vbAGHd1k5cmcylEonQ,18169
 dcnum/segm/__init__.py,sha256=iiq_1A9DU5wMUcKnsZ53E7NyzCkbZCJeUDimzunE-OM,247
-dcnum/segm/segm_thresh.py,sha256=aLVTydPjbrgKDkZFY3Ew5CX-miwOw71meHfxcO5EjCc,1176
-dcnum/segm/segmenter.py,sha256=g0sDBawObeMu4nhZ9rT8lqErsYYu3KApIKGW96aFvr8,10897
+dcnum/segm/segm_thresh.py,sha256=Z6buG3ia8uFJKTLE6BICM3n7Yw8IN-9f6_umIlx0xUk,1395
+dcnum/segm/segmenter.py,sha256=Y535ro4BTyE5Uj5lYIZ0xMbpKg2TIs5wCpv1Gg-yvTU,10625
 dcnum/segm/segmenter_cpu.py,sha256=tCY105rVr9_0RIq2618qnF1ueHRj7UtuK_nUBoAg-nY,10743
-dcnum/segm/segmenter_gpu.py,sha256=tL2X5BN0jKmhC7wgfG0hygd-6UpG1ZCVuKe5OP1qde0,2133
+dcnum/segm/segmenter_gpu.py,sha256=Au1MQdAalVsmJ-cmb3OcCmEMBfXSDuJjdXJTGqEIcG8,1962
 dcnum/segm/segmenter_manager_thread.py,sha256=2znDaKedSueomcU1pbHtFmVcGoHzp--sf494VgJF_Tk,5342
 dcnum/write/__init__.py,sha256=Cpn3LqL18hh8OScUnGp_AnNfpWPpKW-oAJZH6ot7aRA,241
 dcnum/write/deque_writer_thread.py,sha256=KpJ6po8JPlM696MITN-bhNnWQcy9E-qlhg9g-uzoPZg,1710
 dcnum/write/queue_collector_thread.py,sha256=YQ6pvKNmCDf1C6HVx6gOA-q-FBoI6nkhOo-tAVYnyag,11906
 dcnum/write/writer.py,sha256=QGYNda102f2_12YWXu5WEBEQaTXhNnuQ20g-Dej-cek,10535
-dcnum-0.16.8.dist-info/LICENSE,sha256=YRChA1C8A2E-amJbudwMcbTCZy_HzmeY0hMIvduh1MM,1089
-dcnum-0.16.8.dist-info/METADATA,sha256=OwayeBlT5wdvffELr7znBmnKvlS52I7sdeP8bOB10lo,2194
-dcnum-0.16.8.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-dcnum-0.16.8.dist-info/top_level.txt,sha256=Hmh38rgG_MFTVDpUDGuO2HWTSq80P585Het4COQzFTg,6
-dcnum-0.16.8.dist-info/RECORD,,
+dcnum-0.17.1.dist-info/LICENSE,sha256=YRChA1C8A2E-amJbudwMcbTCZy_HzmeY0hMIvduh1MM,1089
+dcnum-0.17.1.dist-info/METADATA,sha256=RLo_EIVokUSP35TZP2lBr_FjfeLGwzj4UMamaU0HMGE,2194
+dcnum-0.17.1.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+dcnum-0.17.1.dist-info/top_level.txt,sha256=Hmh38rgG_MFTVDpUDGuO2HWTSq80P585Het4COQzFTg,6
+dcnum-0.17.1.dist-info/RECORD,,