libCBDetect 1.0.0__cp313-cp313-win_amd64.whl

libCBDetect/__init__.py

@@ -0,0 +1,27 @@
+"""
+libCBDetect – Python bindings for the cbdetect C++ checkerboard detector.
+"""
+
+
+# start delvewheel patch
+def _delvewheel_patch_1_10_1():
+    import os
+    if os.path.isdir(libs_dir := os.path.abspath(os.path.join(os.path.dirname(__file__), os.pardir, 'libcbdetect.libs'))):
+        os.add_dll_directory(libs_dir)
+
+
+_delvewheel_patch_1_10_1()
+del _delvewheel_patch_1_10_1
+# end delvewheel patch
+
+from .Checkerboard import Checkerboard  # noqa: F401
+
+
+import os, sys
+from pathlib import Path
+
+# shipped DLLs are put in …/libCBDetect.libs by delvewheel
+_this_dir = Path(__file__).with_suffix('').parent
+libs = _this_dir.parent / (f"{_this_dir.name}.libs")
+if libs.exists() and hasattr(os, "add_dll_directory"):
+    os.add_dll_directory(libs)

libcbdetect-1.0.0.dist-info/DELVEWHEEL

@@ -0,0 +1,2 @@
+Version: 1.10.1
+Arguments: ['C:\\hostedtoolcache\\windows\\Python\\3.12.10\\x64\\Scripts\\delvewheel', 'repair', 'D:\\a\\libCBDetect\\libCBDetect\\wheelhouse\\libcbdetect-1.0.0-cp313-cp313-win_amd64.whl', '-w', 'wheelhouse\\repaired\\', '--add-path', 'C:\\opencv\\build\\x64\\vc16\\bin']

libcbdetect-1.0.0.dist-info/METADATA

@@ -0,0 +1,189 @@
+Metadata-Version: 2.2
+Name: libCBDetect
+Version: 1.0.0
+Summary: Python bindings for a C++ Checkerboard detector
+Author-Email: =?utf-8?q?Micha=C3=ABl_Hillen?= <michael.hillen@uantwerpen.be>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: C++
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Project-URL: Homepage, https://github.com/InViLabUAntwerp/libCBDetect
+Requires-Python: >=3.10
+Requires-Dist: numpy<1.29.0,>=1.22.4
+Requires-Dist: opencv-python-headless
+Description-Content-Type: text/markdown
+
+# Libcbdetect
+
+- Unofficial implemention of [libcbdetect](http://www.cvlibs.net/software/libcbdetect/) in C++ based
+  on https://github.com/ftdlyc/libcbdetect.
+
+Libdetect is fully automatic sub-pixel checkerboard / chessboard / deltille pattern detection. The algorithm
+autmatically extracts corners to sub-pixel accuracy and combines them to (rectangular) checkerboards / chessboard-like.
+
+---
+
+# Development
+
+## 0. Setting up Windows environment
+
+- Install Visual Studio Build Tools:
+
+    1. Download the "Visual Studio Build Tools" installer from
+       Microsoft [(link)](https://aka.ms/vs/17/release/vs_BuildTools.exe)
+    2. During installation, select "Desktop development with C++"
+
+---
+
+## 1. Installing local dependencies
+
+### 1. OpenCV
+
+1. **Windows (prebuilt binaries)**
+    1. Download the latest Windows release ZIP from
+       the [OpenCV GitHub releases page](https://github.com/opencv/opencv/releases).
+    2. Extract it (e.g., to `C:\`).
+    3. Set `OPENCV_DIR` in **System > Environment Variables** to the `C:\opencv\build`
+       folder.  ([Integrating OpenCV with Visual Studio C++ Projects on Windows](https://christianjmills.com/posts/opencv-visual-studio-getting-started-tutorial/windows/?utm_source=chatgpt.com))
+
+   > [!TIP]
+   > Or use the following command in a PowerShell with administrator privileges to do everything at once
+   > ```shell
+   > $ver='4.11.0';$exe="$env:TEMP\opencv.exe";Invoke-WebRequest -Uri "https://github.com/opencv/opencv/releases/download/$ver/opencv-$ver-windows.exe" -OutFile $exe; Start-Process -FilePath $exe -ArgumentList "-y","-oC:\" -NoNewWindow -Wait; Remove-Item $exe; $base='C:\opencv'; $bin="$base\build\x64\vc16\bin"; $cfg="$base\build\x64\vc16\lib"; [Environment]::SetEnvironmentVariable('Path',[Environment]::GetEnvironmentVariable('Path','Machine')+';'+$bin,'Machine'); [Environment]::SetEnvironmentVariable('OpenCV_DIR',$cfg,'Machine'); $env:Path+=';'+$bin
+
+
+2. **Linux (Ubuntu/Debian)**
+   ```bash
+   sudo apt update
+   sudo apt install libopencv-dev -y
+   ```  
+   This installs both runtime and development headers/libraries for OpenCV
+   4.x.  ([How to Install opencv in C++ on Linux?—GeeksforGeeks](https://www.geeksforgeeks.org/how-to-install-opencv-in-c-on-linux/?utm_source=chatgpt.com))
+
+3. **macOS (Homebrew)**
+   ```bash
+   brew update
+   brew install opencv
+   ```  
+   After installation, headers are in `/usr/local/include/opencv4`, libs in
+   `/usr/local/lib`.  ([Getting started with Opencv with C++ - Nikhil Ramesh](https://nikku1234.github.io/2019-10-27-Getting-started-with-Opencv-with-C%2B%2B/?utm_source=chatgpt.com))
+
+### 2. pybind11
+
+1. **Windows**
+   ```powershell
+   pip install "pybind11[global]"
+   ```
+
+2. **Linux (Ubuntu/Debian)**
+   ```bash
+   sudo apt update
+   sudo apt install -y python3-pybind11
+   ```
+
+3. **macOS (Homebrew)**
+   ```bash
+   brew install pybind11
+   ```
+
+---
+
+## 2. Creating a Python virtual environment
+
+> [!NOTE]
+> This environment will be used for building the project.
+
+### Linux & macOS (bash/zsh)
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip wheel build pybind11 cibuildwheel
+```
+
+### Windows (PowerShell)
+
+```powershell
+py -3.10 -m venv .venv
+.venv\Scripts\Activate.ps1
+python -m pip install --upgrade pip wheel build pybind11 cibuildwheel
+```
+
+---
+
+## 3. Building the package
+
+### 3-a Local build
+
+```bash
+python -m build
+```
+
+`scikit-build-core` invokes **CMake + pybind11** to compile the C++ extension
+for **your** Python, then packages:
+
+```
+dist/
+  ├─ libCBDetect-0.1.0-cp313-cp313-macosx_15_0_arm64.whl
+  └─ libCBDetect-0.1.0.tar.gz
+```
+
+**Windows only**: Repair the wheel with delvewheel to include all required DLLs:
+
+```powershell
+pip install delvewheel
+$wheel = Get-ChildItem -Path .\dist\*.whl | Sort-Object LastWriteTime -Descending | Select-Object -First 1
+delvewheel repair $wheel.FullName -w .\dist\repaired\
+```
+
+Install:
+
+```bash
+pip install dist/checkerboard-*.whl --force-reinstall
+```
+
+**Windows**: Use the repaired wheel:
+
+```powershell
+pip install dist\repaired\*.whl --force-reinstall
+```
+
+### 3-b Editable installation for rapid iteration
+
+```bash
+pip install -e .[dev]
+```
+
+Builds the extension **once** and leaves the Python
+files linked to your working copy, so every code change is picked up
+immediately.
+
+---
+
+### Tips
+
+If using CLion (on Windows), change the default toolchain in the CMake Profiles to ***Visual Studio***.
+
+---
+
+### Original CPP code:
+
+https://github.com/ftdlyc/libcbdetect
+
+### Reference Papers
+
+[1] Geiger, A., Moosmann, F., Car, Ö., & Schuster, B. (2012, May). Automatic camera and range sensor calibration using
+a single shot. In Robotics and Automation (ICRA), 2012 IEEE International Conference on (pp. 3936-3943). IEEE.  
+[2] Schönbein, M., Strauß, T., & Geiger, A. (2014, May). Calibrating and centering quasi-central catadioptric cameras.
+In Robotics and Automation (ICRA), 2014 IEEE International Conference on (pp. 4443-4450). IEEE.  
+[3] Placht, S., Fürsattel, P., Mengue, E. A., Hofmann, H., Schaller, C., Balda, M., & Angelopoulou, E. (2014,
+September). Rochade: Robust checkerboard advanced detection for camera calibration. In European Conference on Computer
+Vision (pp. 766-779). Springer, Cham.  
+[4] Ha, H., Perdoch, M., Alismail, H., Kweon, I. S., & Sheikh, Y. (2017, October). Deltille Grids for Geometric Camera
+Calibration. In 2017 IEEE International Conference on Computer Vision (ICCV) (pp. 5354-5362). IEEE.  
+[5] Duda, A., & Frese, U. (2018, September). Accurate Detection and Localization of Checkerboard Corners for
+Calibration. In British Machine Vision Conference (BMCV), 2018.  
+[6] Sels, S., Ribbens, B., Vanlanduit, S., & Penne, R. (2019). Camera Calibration Using Gray Code. In Sensors (Vol. 19,
+Issue 2, p. 246). MDPI AG. https://doi.org/10.3390/s19020246
+[7] Hillen, M., De Boi, I., De Kerf, T., Sels, S., Cardenas De La Hoz, E., Gladines, J., Steenackers, G., Penne, R., & Vanlanduit, S. (2023). Enhanced Checkerboard Detection Using Gaussian Processes. Mathematics, 11(22), 4568. https://doi.org/10.3390/math11224568

libcbdetect-1.0.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+libCBDetect/Checkerboard.cp313-win_amd64.pyd,sha256=Ib3EuCssjZCWNqnhiRuXY0OEhD3-HERM_CaeJ87ZkVE,350720
+libCBDetect/__init__.py,sha256=XhNkFtfnRVz3G_ofxCNyjN7TxxMQR5WIzL-Cm_w1EJc,772
+libcbdetect-1.0.0.dist-info/DELVEWHEEL,sha256=aNWgwjNfCMG3wI07pNVI57SQiFy8cfoXV3hyf3GWA4U,288
+libcbdetect-1.0.0.dist-info/METADATA,sha256=wADuD5ZZOoc8tm2av3umjfystGEn02m0kQrUcRcQsiM,6700
+libcbdetect-1.0.0.dist-info/RECORD,,
+libcbdetect-1.0.0.dist-info/WHEEL,sha256=_PdgJ-W7uMAsWwnGnEdiicDU_PKcobRdffEM23gmN6g,106
+libcbdetect-1.0.0.dist-info/licenses/LICENSE,sha256=VYjJQNie7ZsjmGMD5hZVZCAHII10ono-c-YrsyLv3hA,1086
+libcbdetect.libs/concrt140-7ec2e462af9863fc63a36625cf0b5132.dll,sha256=Dm6TVVn83yDW6RYDuQPacndtQovedp4_DxX_JL_IwN0,304128
+libcbdetect.libs/msvcp140-3bb6fda0804f69805b472c303438e6c7.dll,sha256=pMIim9wqKmMKzcCVtNhgCOXD47x3cxdDVPPaT1vrnN4,575056
+libcbdetect.libs/opencv_world4110-3401ab4f818d41dccdb4b7e7dc8ec4fd.dll,sha256=zP1NqCThFMRzXuFo3KBDPymjsSsrrnF2bgiZNHlMoCQ,64825856

libcbdetect-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: scikit-build-core 0.11.5
+Root-Is-Purelib: false
+Tag: cp313-cp313-win_amd64
+

libcbdetect-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 UAntwerp InViLab research group
+
+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.