updated optv installation by default

Author: alexlib

README.md

@@ -7,20 +7,21 @@ Python version of the OpenPTV library - this is *a work in progress*
 `openptv-python` keeps the Python API as the main interface and combines three
 execution modes behind that API:
 
-- Pure Python: the reference implementation and the easiest path for reading,
-  debugging, and extending the code.
-- Python + Numba: several hot kernels are JIT-compiled automatically on first
+- **Pure Python**: the reference implementation and the easiest path for reading,
+  debugging, and extending the code. Always available as fallback.
+- **Python + Numba**: several hot kernels are JIT-compiled automatically on first
   use, so the Python implementation still benefits from acceleration.
-- Native `optv` bindings: selected operations reuse the native OpenPTV
-  implementation when the `optv` package is available.
-- PyPTV GUI: packaged in the same repository and installed as an optional
-  application package.
+- **Native `optv` bindings** (default): selected operations reuse the native OpenPTV
+  implementation. Installed by default on supported platforms (Linux, macOS, Windows).
 
 At the moment, automatic native delegation is implemented for image
 preprocessing and full-frame target recognition. The rest of the library keeps
 the same Python API and remains usable even when those native paths are not in
 use.
 
+If `optv` is not available on your platform, the package automatically falls back
+to pure Python/Numba implementations without any configuration needed.
+
 ## How this is started
 
 This work started from the https://github.com/OpenPTV/openptv/tree/pure_python branch. It now serves as the single repository for the Python core library and the GUI layer.
@@ -43,15 +44,7 @@ source .venv/bin/activate
 uv sync
 ```
 
-This gives you the standard runtime stack: NumPy, SciPy, Numba, and YAML
-support.
-
-If you also want native `optv` delegation when bindings are available for your
-platform and Python version, install the optional extra:
-
-```bash
-uv sync --extra native
-```
+This gives you the standard runtime stack: NumPy, SciPy, Numba, YAML, and the native `optv` bindings for accelerated image preprocessing and target recognition.
 
 If you also want the GUI application, install the GUI extra:
 
@@ -67,12 +60,6 @@ conda activate openptv-python
 pip install .
 ```
 
-Optional native bindings:
-
-```bash
-pip install ".[native]"
-```
-
 Optional GUI application:
 
 ```bash
@@ -99,14 +86,10 @@ pip install -e ".[dev]"
 
 ### What gets installed
 
-- The default install contains the runtime dependencies only.
-- The optional `native` extra adds `optv` bindings for automatic native
-  delegation on supported platforms.
+- The default install includes `optv` bindings for automatic native delegation on supported platforms (Linux, macOS, Windows).
 - The optional `gui` extra adds the PyPTV GUI and its runtime dependencies.
-- The optional `dev` extra adds test, docs, typing, pre-commit, and GUI
-  tooling for contributors.
-- The public API stays the same regardless of which backend extras are
-  installed.
+- The optional `dev` extra adds test, docs, typing, pre-commit, and GUI tooling for contributors.
+- If `optv` fails to install on your platform, the package falls back to pure Python/Numba implementations automatically.
 
 ## Backend Behavior
 
@@ -161,13 +144,9 @@ Use one of the installation methods above.
 uv run python - <<'PY'
 import openptv_python
 import numba
-try:
-  import optv
-except ImportError:
-  print("optv not installed; native delegation disabled")
-else:
-  print("optv ok", optv.__version__)
+import optv
 
+print("optv ok", optv.__version__)
 print("openptv_python ok")
 print("numba ok", numba.__version__)
 PY

pyproject.toml

@@ -17,6 +17,7 @@ classifiers = [
 dependencies = [
   "numba>=0.64.0",
   "numpy>=2.4.2",
+  "optv>=0.3.2",
   "pyyaml>=6.0.3",
   "scipy>=1.17.1"
 ]
@@ -38,7 +39,6 @@ docs = [
   "sphinx-autoapi>=3.7.0"
 ]
 gui = [
-  "optv>=0.3.2",
   "traits>=6.4.0",
   "traitsui>=7.4.0",
   "enable>=6.1.0",
@@ -55,17 +55,13 @@ gui = [
   "pyparsing>=3.0.0",
   "marimo>=0.19.10"
 ]
-native = [
-  "optv>=0.3.2"
-]
 test = [
   "pytest>=9.0.2",
   "pytest-cov>=7.0.0"
 ]
 dev = [
   "mypy>=1.19.1",
   "myst-parser>=5.0.0",
-  "optv>=0.3.2",
   "pre-commit>=4.5.1",
   "pydata-sphinx-theme>=0.16.1",
   "pytest>=9.0.2",

src/pyptv/__main__.py

@@ -1,3 +1,3 @@
-from . import cli
+from .pyptv_gui import main
 
-cli()
+main()

src/pyptv/detection_gui.py

@@ -285,7 +285,7 @@ class DetectionGUI(HasTraits):
     # Buttons to apply range changes
     button_update_ranges = Button(label="Update Slider Ranges")
 
-    def __init__(self, working_directory=Path("tests/test_cavity")):
+    def __init__(self, working_directory=Path("tests/testing_folder/test_cavity")):
         super(DetectionGUI, self).__init__()
 
         self.working_directory = Path(working_directory)
@@ -810,7 +810,7 @@ def _button_update_ranges_fired(self):
 if __name__ == "__main__":
     if len(sys.argv) == 1:
         # Default to test_cavity directory
-        working_dir = Path().absolute() / "tests" / "test_cavity"
+        working_dir = Path().absolute() / "tests" / "testing_folder" / "test_cavity"
     else:
         # Use provided working directory path
         working_dir = Path(sys.argv[1])

src/pyptv/pyptv_gui.py

@@ -1530,6 +1530,7 @@ def main():
         # Fallback to a bundled test directory if no argument is given.
         # Prefer the repository copy when available, otherwise use the GUI test data.
         candidate_paths = [
+            software_path / "tests" / "testing_folder" / "test_cavity",
             software_path / "tests" / "test_cavity",
             software_path / "src" / "pyptv" / "tests" / "test_cavity",
         ]

tests/testing_folder/test_cavity/parameters_Run1.yaml

@@ -130,6 +130,7 @@ ptv:
   pix_y: 0.012
   tiff_flag: true
   splitter: false
+  negative: false
 sequence:
   base_name:
   - img/cam1.%d