pyppbox 3.5b2__tar.gz → 3.6b1__tar.gz

{pyppbox-3.5b2 → pyppbox-3.6b1}/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.6b1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyppbox
-Version: 3.5b2
+Version: 3.6b1
 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.6b1}/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.6b1}/RELEASENOTES.md

@@ -2,6 +2,17 @@
 
 ## **pyppbox V3 - Make Simpler and Faster**
 
+* `pyppbox` [v3.6b1](https://github.com/rathaumons/pyppbox/tree/v3.5b2)
+
+  - 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.6b1}/pyppbox/__init__.py

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

{pyppbox-3.5b2 → pyppbox-3.6b1}/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.6b1/pyppbox.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyppbox
-Version: 3.5b2
+Version: 3.6b1
 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.6b1}/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

{pyppbox-3.5b2 → pyppbox-3.6b1}/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.6b1}/requirements/requirements.txt

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