pyppbox 3.5b2__tar.gz → 3.6b2__tar.gz

{pyppbox-3.5b2 → pyppbox-3.6b2}/GETSTARTED.md

@@ -1,24 +1,28 @@
 # 🚀 Getting Started
 
-Installing `pyppbox` is very easy and straightforward. You can install it from [PyPI](https://pypi.org/project/pyppbox/) directly or use the prebuilt `.whl` files on [GitHub releases](https://github.com/rathaumons/pyppbox/releases) or install from GitHub directly or build it from source on your own machine. However, in order to get it work, you need to install all the necessary dependencies or requirements for the modules you needs.
+Installing `pyppbox` is very easy and straightforward. You can install it from [PyPI](https://pypi.org/project/pyppbox/) directly or use the prebuilt `.whl` files on [GitHub releases](https://github.com/rathaumons/pyppbox/releases) or install from GitHub directly or build it from source on your own machine. However, in order to get it work, you need to install all the necessary dependencies or requirements for the modules you need.
 
-🆕 `pyppbox` `v3.0b2+` supports all Windows, Linux and macOS. ***Use the most recent version of `pyppbox` for smoother experience!***
 
 ## ⚙️ Requirements
 
 All requirements are not strictly limited. However, some specific modules might need some special dependencies. For example, `YOLO_Classic` (With `.weights` model) relies on [OpenCV DNN](https://docs.opencv.org/4.x/d2/d58/tutorial_table_of_content_dnn.html) in order to make use of GPU power. In this case, you might need to build OpenCV from source by yourself or use our [`pyppbox-opencv`](https://github.com/rathaumons/opencv-for-pyppbox) instead of the official `opencv-contrib-python` which does not include GPU support.
 
 * Prerequisite: 
-  - (Optional) For NVIDIA GPU: [CUDA Toolkit 11.x/12.x](https://developer.nvidia.com/cuda-downloads) with default installation path
-  - (Optional) For NVIDIA GPU: [cuDNN 8.x.x](https://developer.nvidia.com/rdp/cudnn-download) with default installation path
   - Python [[3.9-3.12]](https://www.python.org/downloads/)
   - Local pyppbox repo: `git clone https://github.com/rathaumons/pyppbox.git`
 
 * Before you install dependencies/requirements:
   - For Linux, recommend changing `python3` to `python`: `sudo apt install python-is-python3`
   - If you prefer conda + Python [3.9-3.12]: `conda create --name pyppbox_env python=3.11`
-  - If you don't know whether to install only Tensorflow or PyTorch or both -> Check [Supported Modules](https://rathaumons.github.io/pyppbox/pyppbox/modules.html)
-  - For Tensorflow with GPU support -> [See here](https://www.tensorflow.org/install/pip)
+  - Upgrade `pip` and `setuptools`:
+    ```
+    python -m pip install --upgrade pip
+    pip install "setuptools>=67.2.0"
+    ```
+  - Recommend removing the official `ultralytics`:
+    ```
+    pip uninstall -y ultralytics
+    ```
 
 * Install dependencies/requirments under `pyppbox/requirements/`: 
   - On Windows, recommend using the `cmd` installer:
@@ -27,17 +31,11 @@ All requirements are not strictly limited. However, some specific modules might
   - On Linux:
     - For GPU:
       ```
-      python -m pip install --upgrade pip
-      pip uninstall -y ultralytics # Remove the official ultralytics
-      pip install "setuptools>=67.2.0"
       pip install torch torchvision torchaudio
       pip install -r requirements.txt
       ```
     - For CPU-only:
       ```
-      python -m pip install --upgrade pip
-      pip uninstall -y ultralytics # Remove the official ultralytics
-      pip install "setuptools>=67.2.0"
       pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
       pip install -r requirements.txt
       ```
@@ -45,9 +43,6 @@ All requirements are not strictly limited. However, some specific modules might
     - For GPU: Not available
     - For CPU:
       ```
-      python -m pip install --upgrade pip
-      pip uninstall -y ultralytics # Remove the official ultralytics
-      pip install "setuptools>=67.2.0"
       pip install torch torchvision torchaudio
       pip install -r requirements.txt
       ```
@@ -59,9 +54,8 @@ All requirements are not strictly limited. However, some specific modules might
   - If there is no error, then you are all good and ready to go.
   - For OpenCV, the official `opencv-contrib-python` (No GPU support) is set in the `requirements.txt` file. If you need GPU support, check our [`pyppbox-opencv`](https://github.com/rathaumons/opencv-for-pyppbox) or build one from source by yourself.
 
-* ⚠️ ***Notes:***
-  - For CPU-Only, YOLO Ultralytics uses GPU by default, you must set `cpu` as string for the parameter `device` in its configuration.
-  - For GPU on Windows, [Tensorflow 2.11+ no long provides native GPU support](https://www.tensorflow.org/install/pip#windows-native). 
+* ***ATTENTION*** ⚠️⚠️⚠️
+  - If you use YOLO Ultralytics without GPU, you need to set `cpu` as string for the parameter `device` in its configuration.
 
 
 ## 💽 Setup
@@ -79,11 +73,8 @@ You need to install the main package which is `pyppbox` and the data for the mod
     ```
   - Or build from source:
     ```
-    pip install "setuptools>=67.2.0"
     pip install wheel build PyYAML
     python -m build --wheel --skip-dependency-check --no-isolation
-    cd dist
-    pip install pyppbox-xxx.whl
     ```
 
 * Install [`pyppbox-data-xxx`](https://github.com/rathaumons/pyppbox-data/)
@@ -104,15 +95,15 @@ You need to install the main package which is `pyppbox` and the data for the mod
     pip install https://github.com/rathaumons/PoseTReID_DATASET/releases/download/v2.0/pyppbox_data_gta5-2.0-py3-none-any.whl
     ```
 
-* (Optional) Quick Test
-  - On your terminal or CMD:
+* Quick Test
+  - In your Python terminal:
     ```
-    python
     import pyppbox
     pyppbox.launchGUI()
     ```
-  - Now you should see the GUI of pyppbox for easy demo.
-    <details><summary><ins>Show GUI example!</ins></summary><img src="https://raw.githubusercontent.com/rathaROG/screenshot/master/pyppbox/pyppbox_gui.jpg"></details>
+    Now you should see the GUI demo like this screenshot:
+    <img src="https://raw.githubusercontent.com/rathaROG/screenshot/master/pyppbox/pyppbox_gui.jpg">
+  - For related GUI functions and other configurations, check the [Configurations page](https://rathaumons.github.io/pyppbox/pyppbox/config.html).
   - For ***Linux***, if the GUI does not work, you might need to install these:
     ```
     sudo apt-get install '^libxcb.*-dev' libx11-xcb-dev libglu1-mesa-dev libxrender-dev libxi-dev libxkbcommon-dev libxkbcommon-x11-dev

{pyppbox-3.5b2/pyppbox.egg-info → pyppbox-3.6b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyppbox
-Version: 3.5b2
+Version: 3.6b2
 Summary: Toolbox for people detecting, tracking, and re-identifying.
 Home-page: https://github.com/rathaumons/pyppbox
 Author: Ratha SIV
@@ -55,8 +55,6 @@ Requires-Dist: torchvision
 Requires-Dist: torchaudio
 Requires-Dist: filterpy
 Requires-Dist: lapx
-Requires-Dist: pyunpack
-Requires-Dist: patool
 Requires-Dist: PyQt6
 Requires-Dist: pyppbox-torchreid
 Requires-Dist: pyppbox-ultralytics>=8.0.218
@@ -79,8 +77,8 @@ Requires-Dist: pyppbox-ultralytics>=8.0.218
 
 * ` pyppbox = Python + People + Toolbox `
 * Design for both short and long term people detecting, tracking, and re-identifying.
-* Integrate GUI for easy configurations and demo.
-* Support dictionary and YAML/JSON configurations.
+* Integrate GUI for easy configuration and demo.
+* Support dictionary and YAML/JSON configuration.
 * Support [[GTA_V_Dataset]](https://github.com/rathaumons/PoseTReID_DATASET) -> Real-time online and offline evaluation.
 * Check our papers: 1 [[IEEE]](https://ieeexplore.ieee.org/document/9271712) | 2 [[IEEE]](https://ieeexplore.ieee.org/document/9946587) [[arxiv]](https://doi.org/10.48550/arxiv.2205.10086)
 

{pyppbox-3.5b2 → pyppbox-3.6b2}/README.md

@@ -16,8 +16,8 @@
 
 * ` pyppbox = Python + People + Toolbox `
 * Design for both short and long term people detecting, tracking, and re-identifying.
-* Integrate GUI for easy configurations and demo.
-* Support dictionary and YAML/JSON configurations.
+* Integrate GUI for easy configuration and demo.
+* Support dictionary and YAML/JSON configuration.
 * Support [[GTA_V_Dataset]](https://github.com/rathaumons/PoseTReID_DATASET) -> Real-time online and offline evaluation.
 * Check our papers: 1 [[IEEE]](https://ieeexplore.ieee.org/document/9271712) | 2 [[IEEE]](https://ieeexplore.ieee.org/document/9946587) [[arxiv]](https://doi.org/10.48550/arxiv.2205.10086)
 

{pyppbox-3.5b2 → pyppbox-3.6b2}/RELEASENOTES.md

@@ -1,7 +1,35 @@
 # Release Notes 
 
+## **pyppbox V4 - Even Smaller**
+
+* `pyppbox` v4.0b1 (COMING SOON 🚀)
+
+  - `pyppbox` will leverage [`vsensebox`](https://github.com/rathaumons/vsensebox) for detection and tracking
+  - `pyppbox.utils.persontools` will change to adapt [`vsensebox`](https://github.com/rathaumons/vsensebox)
+  - `pyppbox.ppb` will replace `pyppbox.standalone`
+  - All configuration files will also change
+  - More changes will be added here! Stay tuned!
+
 ## **pyppbox V3 - Make Simpler and Faster**
 
+* `pyppbox` [v3.6b2](https://github.com/rathaumons/pyppbox/tree/v3.6b2)
+
+  - Add a warning for the changes in the coming major version 4
+  - Update documentations
+  - **Known issue/limitation**:
+    - You tell me :)
+
+* `pyppbox` [v3.6b1](https://github.com/rathaumons/pyppbox/tree/v3.6b1)
+
+  - Replace `pyunpack` & `patool` with `shutil`
+  - Improve Example 9 - example_09_eva_offline.py
+  - Add `pyppbox.gui.guitools` to the documentations
+  - Fix `useInternalConfigDir()` in `pyppbox.gui.guitools`
+  - Fix sphinx-build warning for utils.rst
+  - Fix and improve documentations
+  - **Known issue/limitation**:
+    - You tell me :)
+
 * `pyppbox` [v3.5b2](https://github.com/rathaumons/pyppbox/tree/v3.5b2)
 
   - Increase default random ID range in evatools

{pyppbox-3.5b2 → pyppbox-3.6b2}/pyppbox/__init__.py

@@ -47,7 +47,7 @@ from pyppbox.gui.guitools import (
 )
 
 
-__version__ = '3.5b2'
+__version__ = '3.6b2'
 __author__ = 'Ratha SIV'
 __description__ = 'Toolbox for people detecting, tracking, and re-identifying.'
 __homepage__ = 'https://rathaumons.github.io/pyppbox'

{pyppbox-3.5b2 → pyppbox-3.6b2}/pyppbox/gui/guitools.py

@@ -23,7 +23,7 @@ import os
 import sys
 import subprocess as sp
 
-from pyppbox.utils.logtools import add_warning_log, add_error_log
+from pyppbox.utils.logtools import add_info_log, add_warning_log, add_error_log
 from pyppbox.config.configtools import PYPPBOXStructure, loadDocument, loadListDocument
 from pyppbox.utils.commontools import getAbsPathFDS, joinFPathFull, isExist
 from pyppbox.gui.guihub import writeUITMP
@@ -52,8 +52,9 @@ def useThisConfigDir(cfg_dir):
 def useInternalConfigDir():
     """Use the internal config directory, :code:`{pyppbox root}/confog/cfg` inside pyppbox package.
     """
-    global pyppbox_struct
+    global pyppbox_struct, __cfgdir__
     pyppbox_struct = PYPPBOXStructure()
+    __cfgdir__ =  pyppbox_struct.cfg_dir
     add_warning_log("FYI: This basic method only serves GUI submodule `pyppbox.gui`.")
 
 def showMainConfig():
@@ -85,9 +86,10 @@ def resetInternalConfig():
     """
     global pyppbox_struct
     pyppbox_struct = PYPPBOXStructure()
-    from pyunpack import Archive
-    Archive(os.path.join(pyppbox_struct.cfg_dir, 'cfg.7z')).extractall(pyppbox_struct.cfg_dir)
-    print("Reset successfully!")
+    cfg_zip = os.path.join(pyppbox_struct.cfg_dir, 'cfg.zip')
+    import shutil
+    shutil.unpack_archive(cfg_zip, pyppbox_struct.cfg_dir)
+    add_info_log("Reset successfully!")
     add_warning_log("FYI: This basic method only serves GUI submodule `pyppbox.gui`.")
 
 def launchGUI():
@@ -112,15 +114,12 @@ def generateConfig(cfg_dir, auto_launch_gui=True):
         An indication of whether to load and launch GUI from the :obj:`config_dir`.
     """
     if isExist(cfg_dir):
-        abspath = getAbsPathFDS(cfg_dir)
         global pyppbox_struct
+        abspath = getAbsPathFDS(cfg_dir)
+        cfg_zip = os.path.join(pyppbox_struct.cfg_dir, 'cfg.zip')
         try:
-            from pyunpack import Archive
-            Archive(os.path.join(pyppbox_struct.cfg_dir, 'cfg.7z')).extractall(abspath)
-            try:
-                os.remove(joinFPathFull(abspath, 'strings.yaml'))
-            except Exception:
-                pass
+            import shutil
+            shutil.unpack_archive(cfg_zip, abspath)
             if auto_launch_gui:
                 useThisConfigDir(abspath)
                 launchGUI()

{pyppbox-3.5b2 → pyppbox-3.6b2}/pyppbox/modules/detectors/yolocls/__init__.py

@@ -56,25 +56,25 @@ class MyYOLOCLS(object):
         self.model = cv2.dnn_DetectionModel(net)
         self.model.setInputParams(size=cfg.model_resolution, scale=1/255.0)
 
-    def detect(self, img, visual=True, class_filter=0, min_width_filter=35):
+    def detect(self, img, visual=True, class_filter=[0], min_width_filter=35):
         """Detect general object with object's class filter :obj:`class_filter` in a 
-        given cv :obj:`Mat` image.
+        given :obj:`Mat` like image.
 
         Parameters
         ----------
         img : Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         visual : bool, default=True
             An indication of whether to visualize the detected objects.
-        class_filter : int, defualt=0
-            Object's class filter, 0 means person only
+        class_filter : list[int, ...], defualt=0
+            Object's class filter, [0] = Person only.
         min_width_filter : int, default=35
             Mininum width filter of a detected object.
 
         Returns
         -------
         Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         list[ndarray[int, int, int, int], ...]
             A list of bounding box :code:`ndarray[x, y, width, height]`.
         list[ndarray[int, int, int, int], ...]
@@ -93,7 +93,7 @@ class MyYOLOCLS(object):
                                                         nmsThreshold=float(self.cfg.nms))
         if len(classes) > 0:
             for class_id, conf, box_xywh in zip(classes.flatten(), confidences, boxes):
-                if class_id == class_filter and box_xywh[2] >= min_width_filter:
+                if class_id in class_filter and box_xywh[2] >= min_width_filter:
                     box_xywh = box_xywh.astype(int)
                     pboxes_xywh.append(box_xywh)
                     box_xyxy = to_xyxy(box_xywh)
@@ -109,12 +109,12 @@ class MyYOLOCLS(object):
         return img, pboxes_xywh, pboxes_xyxy, repspoints, confs
 
     def detectPeople(self, img, visual=True, min_width_filter=35, alt_repspoint=False, alt_repspoint_top=True):
-        """Detect person(s) in a given cv :obj:`Mat` image.
+        """Detect person(s) in a given :obj:`Mat` like image.
 
         Parameters
         ----------
         img : Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         visual : bool, default=True
             An indication of whether to visualize the detected people.
         min_width_filter : int, default=35
@@ -129,7 +129,7 @@ class MyYOLOCLS(object):
         list[Person, ...]
             A list of detected :class:`Person` object.
         Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         """
         people = []
         classes, confidences, boxes = self.model.detect(

{pyppbox-3.5b2 → pyppbox-3.6b2}/pyppbox/modules/detectors/yoloult/__init__.py

@@ -117,12 +117,12 @@ class MyYOLOULT(object):
 
     def detect(self, img, visual=True, classes=0, min_width_filter=35):
         """Detect general object with object's class filter :obj:`class_filter` 
-        in a given cv :obj:`Mat` image.
+        in a given :obj:`Mat` like image.
 
         Parameters
         ----------
         img : Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         visual : bool, default=True
             An indication of whether to visualize the detected objects.
         classes : int, defualt=0
@@ -133,7 +133,7 @@ class MyYOLOULT(object):
         Returns
         -------
         Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         list[ndarray[int, int, int, int], ...]
             A list of bounding box :code:`ndarray[x, y, width, height]`.
         list[ndarray[int, int, int, int], ...]
@@ -205,12 +205,12 @@ class MyYOLOULT(object):
         return img, pboxes_xywh, pboxes_xyxy, repspoints, keypoints, confs
 
     def detectPeople(self, img, visual=True, min_width_filter=35, alt_repspoint=False, alt_repspoint_top=True):
-        """Detect person(s) in a given cv :obj:`Mat` image.
+        """Detect person(s) in a given :obj:`Mat` like image.
 
         Parameters
         ----------
         img : Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         visual : bool, default=True
             An indication of whether to visualize the detected people.
         min_width_filter : int, default=35
@@ -225,7 +225,7 @@ class MyYOLOULT(object):
         list[Person, ...]
             A list of detected :class:`Person` object.
         Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         """
         numpy_dets = []
         people = []

{pyppbox-3.5b2 → pyppbox-3.6b2}/pyppbox/modules/reiders/facenet/__init__.py

@@ -120,7 +120,7 @@ class MyFaceNet(object):
         Parameters
         ----------
         img : Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         is_bgr : bool, default=True
             An indication of whether the color channel of given :obj:`img` is BGR.
 

{pyppbox-3.5b2 → pyppbox-3.6b2}/pyppbox/modules/reiders/torchreid/__init__.py

@@ -85,7 +85,7 @@ class MyTorchreid(object):
         Parameters
         ----------
         img : Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         is_bgr : bool, default=True
             An indication of whether the color channel of given :obj:`img` is BGR.
 

{pyppbox-3.5b2 → pyppbox-3.6b2}/pyppbox/modules/trackers/deepsort/__init__.py

@@ -94,7 +94,7 @@ class MyDeepSORT(object):
         person_list : list[Person, ...]
             A list of :class:`Person` object which stores the detected people in the given :obj:`img`.
         img : any, default=None
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         max_spread : int, default=5
             Max spread or max margin used to decide whether 2 bounding boxes are the same by comparing 
             the differences between the elements in the bounding box given by the embedded SORT and the 

{pyppbox-3.5b2/pyppbox/standalone → pyppbox-3.6b2/pyppbox/ppb}/__init__.py

@@ -23,7 +23,7 @@
 Standalone is designed for easy detect, track, and reid people in a single thread 
 enviroment or in command line. 
 
-For multithreading application, see :py:class:`pyppbox.standalone.mt.MT`.
+For multithreading application, see :py:class:`pyppbox.ppb.mt.MT`.
 
 Example:
 
@@ -69,27 +69,27 @@ Example:
 
 from .mt import MT
 
-__stdmt__ = MT()
+_mt = MT()
 
 def setConfigDir(config_dir=None, load_all=False):
-    """See :func:`pyppbox.standalone.mt.MT.setConfigDir`"""
-    __stdmt__.setConfigDir(config_dir=config_dir, load_all=load_all)
+    """See :func:`pyppbox.ppb.mt.MT.setConfigDir`"""
+    _mt.setConfigDir(config_dir=config_dir, load_all=load_all)
 
 def setMainModules(main_yaml=None, load_all=True):
-    """See :func:`pyppbox.standalone.mt.MT.setMainModules`"""
-    __stdmt__.setMainModules(main_yaml=main_yaml, load_all=load_all)
+    """See :func:`pyppbox.ppb.mt.MT.setMainModules`"""
+    _mt.setMainModules(main_yaml=main_yaml, load_all=load_all)
 
 def getConfig():
-    """See :func:`pyppbox.standalone.mt.MT.getConfig`"""
-    return __stdmt__.getConfig()
+    """See :func:`pyppbox.ppb.mt.MT.getConfig`"""
+    return _mt.getConfig()
 
 def forceFullGTMode():
-    """See :func:`pyppbox.standalone.mt.MT.forceFullGTMode`"""
-    __stdmt__.forceFullGTMode()
+    """See :func:`pyppbox.ppb.mt.MT.forceFullGTMode`"""
+    _mt.forceFullGTMode()
 
 def setMainDetector(detector=""):
-    """See :func:`pyppbox.standalone.mt.MT.setMainDetector`"""
-    __stdmt__.setMainDetector(detector=detector)
+    """See :func:`pyppbox.ppb.mt.MT.setMainDetector`"""
+    _mt.setMainDetector(detector=detector)
 
 def detectPeople(img, 
                  img_is_mat=False, 
@@ -99,8 +99,8 @@ def detectPeople(img,
                  min_width_filter=35, 
                  alt_repspoint=False, 
                  alt_repspoint_top=True):
-    """See :func:`pyppbox.standalone.mt.MT.detectPeople`"""
-    return __stdmt__.detectPeople(img, 
+    """See :func:`pyppbox.ppb.mt.MT.detectPeople`"""
+    return _mt.detectPeople(img, 
                                   img_is_mat=img_is_mat, 
                                   visual=visual, 
                                   save=save, 
@@ -110,24 +110,24 @@ def detectPeople(img,
                                   alt_repspoint_top=alt_repspoint_top)
 
 def setMainTracker(tracker=""):
-    """See :func:`pyppbox.standalone.mt.MT.setMainTracker`"""
-    __stdmt__.setMainTracker(tracker=tracker)
+    """See :func:`pyppbox.ppb.mt.MT.setMainTracker`"""
+    _mt.setMainTracker(tracker=tracker)
 
 def trackPeople(img, people, img_is_mat=False):
-    """See :func:`pyppbox.standalone.mt.MT.trackPeople`"""
-    return __stdmt__.trackPeople(img, people, img_is_mat=img_is_mat)
+    """See :func:`pyppbox.ppb.mt.MT.trackPeople`"""
+    return _mt.trackPeople(img, people, img_is_mat=img_is_mat)
 
 def setMainReIDer(reider="", auto_load=True):
-    """See :func:`pyppbox.standalone.mt.MT.setMainReIDer`"""
-    __stdmt__.setMainReIDer(reider=reider, auto_load=auto_load)
+    """See :func:`pyppbox.ppb.mt.MT.setMainReIDer`"""
+    _mt.setMainReIDer(reider=reider, auto_load=auto_load)
 
 def reidPeople(img, people, deduplicate=True, img_is_mat=False):
-    """See :func:`pyppbox.standalone.mt.MT.reidPeople`"""
-    return __stdmt__.reidPeople(img, people, deduplicate=deduplicate, img_is_mat=img_is_mat)
+    """See :func:`pyppbox.ppb.mt.MT.reidPeople`"""
+    return _mt.reidPeople(img, people, deduplicate=deduplicate, img_is_mat=img_is_mat)
 
 def trainReIDClassifier(reider="Default", train_data="", classifier_pkl=""):
-    """See :func:`pyppbox.standalone.mt.MT.trainReIDClassifier`"""
-    __stdmt__.trainReIDClassifier(reider=reider, train_data=train_data, classifier_pkl=classifier_pkl)
+    """See :func:`pyppbox.ppb.mt.MT.trainReIDClassifier`"""
+    _mt.trainReIDClassifier(reider=reider, train_data=train_data, classifier_pkl=classifier_pkl)
 
 __all__ = ['setConfigDir', 'setMainModules', 'getConfig', 'forceFullGTMode', 
            'setMainDetector', 'detectPeople', 'setMainTracker', 'trackPeople', 

{pyppbox-3.5b2/pyppbox/standalone → pyppbox-3.6b2/pyppbox/ppb}/mt.py

@@ -424,9 +424,9 @@ class MT(object):
         Parameters
         ----------
         img : str or Mat
-            Set an image file or a cv :obj:`Mat`.
+            Set an image file or a :obj:`Mat` like image.
         img_is_mat : bool, default=False
-            Speed up the function by telling whether the :obj:`img` is cv :obj:`Mat`.
+            Speed up the function by telling whether the :obj:`img` is :obj:`Mat` like image.
         visual : bool, default=False
             Decide whether to visualize like drawing bounding boxes and keypoints to the 
             return :obj:`img`.
@@ -446,7 +446,7 @@ class MT(object):
         list[Person, ...]
             A  list of :class:`Person` object.
         Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         """ 
         people = []
         if self.__dt_is_set__: 
@@ -619,11 +619,11 @@ class MT(object):
         Parameters
         ----------
         img : str or Mat
-            Set an image file or a cv :obj:`Mat`.
+            Set an image file or a :obj:`Mat` like image.
         people : list[Person, ...]
             Set a list of :class:`Person` object which stores the detected people in the input :obj:`img`.
         img_is_mat : bool, default=False
-            Speed up the function by telling whether the :obj:`img` is cv :obj:`Mat`.
+            Speed up the function by telling whether the :obj:`img` is :obj:`Mat` like image.
         
         Returns
         -------
@@ -791,14 +791,14 @@ class MT(object):
         Parameters
         ----------
         img : str or Mat
-            Set an image file or a cv :obj:`Mat`.
+            Set an image file or a :obj:`Mat` like image.
         people : list[Person, ...]
             Set a list of :class:`Person` object which stores the detected or tracked people in 
             the input :obj:`img`.
         deduplicate : bool, default=True
             Indicate whether to re-reid people who have the same face ids or deep ids.
         img_is_mat : bool, default=False
-            Speed up the function by telling whether the :obj:`img` is cv :obj:`Mat`.
+            Speed up the function by telling whether the :obj:`img` is :obj:`Mat` like image.
         
         Returns
         -------

pyppbox-3.6b2/pyppbox/standalone/__init__.py

@@ -0,0 +1,37 @@
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#                                                                           #
+#   pyppbox: Toolbox for people detecting, tracking, and re-identifying.    #
+#   Copyright (C) 2022 UMONS-Numediart                                      #
+#                                                                           #
+#   This program is free software: you can redistribute it and/or modify    #
+#   it under the terms of the GNU General Public License as published by    #
+#   the Free Software Foundation, either version 3 of the License, or       #
+#   (at your option) any later version.                                     #
+#                                                                           #
+#   This program is distributed in the hope that it will be useful,         #
+#   but WITHOUT ANY WARRANTY; without even the implied warranty of          #
+#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           #
+#   GNU General Public License for more details.                            #
+#                                                                           #
+#   You should have received a copy of the GNU General Public License       #
+#   along with this program.  If not, see <https://www.gnu.org/licenses/>.  #
+#                                                                           #
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+
+from pyppbox.ppb import *
+from pyppbox.utils.logtools import add_warning_log
+
+msg = ("\n! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !\n"
+       "!                                                                       !\n"
+       "!  For the coming major version 4:                                      !\n"
+       "!   * 'pyppbox' will leverage 'vsensebox' for detection and tracking    !\n"
+       "!   * 'pyppbox.utils.persontools' will change to adapt 'vesensebox'     !\n"
+       "!   * 'pyppbox.ppb' will replace 'pyppbox.standalone'                   !\n"
+       "!   * All configuration files will also change                          !\n"
+       "!   * More changes will be added to release notes                       !\n"
+       "!                                                                       !\n"
+       "! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !\n")
+
+add_warning_log(msg)
+

{pyppbox-3.5b2 → pyppbox-3.6b2}/pyppbox/utils/gttools.py

@@ -273,7 +273,7 @@ class GTInterpreter(object):
         Parameters
         ----------
         img : Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         visual : 
             An indication of whether to draw bounding boxes on the return :obj:`img`.
 
@@ -282,7 +282,7 @@ class GTInterpreter(object):
         list[Person, ...]
             A list of :class:`Person` object.
         Mat
-            A cv :obj:`Mat` image.
+            A :obj:`Mat` like image.
         """
         people = []
         tmp_id = 0

{pyppbox-3.5b2 → pyppbox-3.6b2}/pyppbox/utils/visualizetools.py

@@ -107,7 +107,7 @@ def visualizePeople(img, people, show_box=True, show_skl=(True,True,5), show_ids
     Parameters
     ----------
     img : str or Mat
-        An image file or a cv :obj:`Mat`.
+        An image file or a :obj:`Mat` like image.
     people : list[Person, ...]
         Set a list of :class:`Person` object found in the input :obj:`img`.
     show_box : bool, default=True
@@ -128,12 +128,12 @@ def visualizePeople(img, people, show_box=True, show_skl=(True,True,5), show_ids
     show_repspoint : bool, default=True
         Indicate whether to show the :obj:`repspoint` of :class:`Person` object.
     img_is_mat : bool, default=True
-        Speed up the function by telling whether the :obj:`img` is cv :obj:`Mat`.
+        Speed up the function by telling whether the :obj:`img` is :obj:`Mat` like image.
     
     Returns
     -------
     Mat
-        A visualized cv :obj:`Mat`.
+        A visualized :obj:`Mat` like image.
     """
     # Overwrite `img_is_mat` to False when `img` is a file.
     if img_is_mat and isinstance(img, str): img_is_mat = False

{pyppbox-3.5b2 → pyppbox-3.6b2/pyppbox.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyppbox
-Version: 3.5b2
+Version: 3.6b2
 Summary: Toolbox for people detecting, tracking, and re-identifying.
 Home-page: https://github.com/rathaumons/pyppbox
 Author: Ratha SIV
@@ -55,8 +55,6 @@ Requires-Dist: torchvision
 Requires-Dist: torchaudio
 Requires-Dist: filterpy
 Requires-Dist: lapx
-Requires-Dist: pyunpack
-Requires-Dist: patool
 Requires-Dist: PyQt6
 Requires-Dist: pyppbox-torchreid
 Requires-Dist: pyppbox-ultralytics>=8.0.218
@@ -79,8 +77,8 @@ Requires-Dist: pyppbox-ultralytics>=8.0.218
 
 * ` pyppbox = Python + People + Toolbox `
 * Design for both short and long term people detecting, tracking, and re-identifying.
-* Integrate GUI for easy configurations and demo.
-* Support dictionary and YAML/JSON configurations.
+* Integrate GUI for easy configuration and demo.
+* Support dictionary and YAML/JSON configuration.
 * Support [[GTA_V_Dataset]](https://github.com/rathaumons/PoseTReID_DATASET) -> Real-time online and offline evaluation.
 * Check our papers: 1 [[IEEE]](https://ieeexplore.ieee.org/document/9271712) | 2 [[IEEE]](https://ieeexplore.ieee.org/document/9946587) [[arxiv]](https://doi.org/10.48550/arxiv.2205.10086)
 

{pyppbox-3.5b2 → pyppbox-3.6b2}/pyppbox.egg-info/SOURCES.txt

@@ -16,12 +16,13 @@ pyppbox/config/__init__.py
 pyppbox/config/configtools.py
 pyppbox/config/myconfig.py
 pyppbox/config/unifiedstrings.py
-pyppbox/config/cfg/cfg.7z
+pyppbox/config/cfg/cfg.zip
 pyppbox/config/cfg/detectors.yaml
 pyppbox/config/cfg/main.yaml
 pyppbox/config/cfg/reiders.yaml
 pyppbox/config/cfg/trackers.yaml
 pyppbox/config/strings/strings.yaml
+pyppbox/config/strings/strings.zip
 pyppbox/data/datasets/.gitignore
 pyppbox/data/logs/.gitignore
 pyppbox/data/modules/.gitignore
@@ -74,8 +75,9 @@ pyppbox/modules/trackers/deepsort/origin/tracker.py
 pyppbox/modules/trackers/deepsort/origin/voc_classes.txt
 pyppbox/modules/trackers/sort/__init__.py
 pyppbox/modules/trackers/sort/origin/sort.py
+pyppbox/ppb/__init__.py
+pyppbox/ppb/mt.py
 pyppbox/standalone/__init__.py
-pyppbox/standalone/mt.py
 pyppbox/utils/__init__.py
 pyppbox/utils/commontools.py
 pyppbox/utils/evatools.py

{pyppbox-3.5b2 → pyppbox-3.6b2}/pyppbox.egg-info/requires.txt

@@ -22,8 +22,6 @@ torchvision
 torchaudio
 filterpy
 lapx
-pyunpack
-patool
 PyQt6
 pyppbox-torchreid
 pyppbox-ultralytics>=8.0.218

{pyppbox-3.5b2 → pyppbox-3.6b2}/requirements/requirements.txt

@@ -34,9 +34,6 @@ torchaudio
 ### Tracker: SORT
 filterpy
 lapx
-### Compression
-pyunpack
-patool
 ### GUI
 PyQt6
 ### Customized pyppbox-torchreid