pycvcam 1.3.4__tar.gz

pycvcam-1.3.4/.bumpver.toml

@@ -0,0 +1,9 @@
+[bumpver]
+current_version = "1.3.4"
+version_pattern = "MAJOR.MINOR.PATCH"
+default_level = "patch"
+
+[bumpver.file_patterns]
+"pycvcam/__version__.py" = [
+    '__version__ = "{version}"'
+]

pycvcam-1.3.4/.github/workflows/sphinx.yml

@@ -0,0 +1,41 @@
+name: Deploy Documentation to GitHub Pages
+
+on:
+  push:
+    branches:
+      - master
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout the repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.10"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install sphinx pydata-sphinx-theme
+        pip install .
+
+    - name: Build documentation
+      run: sphinx-build -b html docs/source/ public/
+
+    - name: Deploy to GitHub Pages
+      uses: JamesIves/github-pages-deploy-action@v4
+      
+      with:
+        branch: gh-pages
+        folder: public
+        clean: true

pycvcam-1.3.4/.gitignore

@@ -0,0 +1,30 @@
+# Python cache files
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+
+# Virtual environment
+env/
+venv/
+*_pyvenv.cfg
+*.egg-info/
+
+# Laboratory
+laboratory/
+
+# Sphinx documentation
+build/
+
+# Distribution / packaging
+dist/
+*.egg
+
+# Jupyter Notebook checkpoints
+.ipynb_checkpoints/
+
+# IDE files
+.idea/
+.vscode/
+*.sublime-project
+*.sublime-workspace

pycvcam-1.3.4/.gitlab-ci.yml

@@ -0,0 +1,12 @@
+image: python:3.9
+
+before_script:
+  - pip install -r requirements.txt
+  - pip install sphinx pydata-sphinx-theme
+
+pages:
+  script:
+    - sphinx-build -b html docs/source/ public/
+  artifacts:
+    paths:
+      - public/

pycvcam-1.3.4/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2025 Artezaru
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

pycvcam-1.3.4/Makefile

@@ -0,0 +1,60 @@
+# 0. Setting default
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = docs/source
+BUILDDIR      = docs/build
+
+message ?= Default-commit-message
+level ?= patch
+
+# 1. Default help command to list available Sphinx options
+help:
+	@echo "Available commands:"
+	@echo "  help       - Show this help message"
+	@echo "  html       - Generate HTML documentation with sphinx-build (output at docs/build/html/)"
+	@echo "  latexpdf   - Generate LaTeX PDF documentation with Sphinx sphinx-build (output at docs/build/latex/)"
+	@echo "  clean      - Clean the documentation build directory docs/build/"
+	@echo "  bump       - Update the version of the package (default: patch, use level=major/minor/patch)"
+	@echo "  git        - Commit and push changes to master (use message='Your commit message')"
+	@echo "  app        - Build the application with PyInstaller (output at dist/)"
+	@echo "  test       - Run the tests of the package with pytest"
+
+.PHONY: help Makefile
+
+# 2. Generate HTML documentation
+html:
+	$(SPHINXBUILD) -b html $(SOURCEDIR) $(BUILDDIR)/html
+
+# 3. Generate LaTeX PDF documentation
+latexpdf:
+	$(SPHINXBUILD) -b latex $(SOURCEDIR) $(BUILDDIR)/latex
+	cd $(BUILDDIR)/latex && pdflatex pycvcam.tex && pdflatex pycvcam.tex
+
+# 4. Clean the documentation
+clean:
+	@$(SPHINXBUILD) -M clean "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O);
+	cd $(BUILDDIR); mkdir -p html; mkdir -p latex
+
+# 5. Update the version of the package
+bump:
+	bumpver update --$(level) --no-fetch
+
+# 6. Git Push origin Master
+git:
+	git checkout master
+	git add -A .
+	git commit -m "$(message)"
+	git push origin master
+
+# 7. Create the application
+app:
+	echo "from pycvcam.__main__ import __main_gui__" > run_gui.py
+	echo "__main_gui__()" >> run_gui.py
+	pyinstaller --name pycvcam --onefile --windowed run_gui.py
+	rm run_gui.py
+	rm -rf build
+	rm run_gui.spec
+
+# 8. Tests the package
+test:
+	pytest tests

pycvcam-1.3.4/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: pycvcam
+Version: 1.3.4
+Summary: Python Computer Vision Cameras Operations and Models
+Author-email: Artezaru <artezaru.github@proton.me>
+License: Copyright 2025 Artezaru
+        
+        Licensed under the Apache License, Version 2.0 (the "License");
+        you may not use this file except in compliance with the License.
+        You may obtain a copy of the License at
+        
+            http://www.apache.org/licenses/LICENSE-2.0
+        
+        Unless required by applicable law or agreed to in writing, software
+        distributed under the License is distributed on an "AS IS" BASIS,
+        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+        See the License for the specific language governing permissions and
+        limitations under the License.
+Project-URL: Homepage, https://github.com/Artezaru/pycvcam
+Project-URL: Documentation, https://Artezaru.github.io/pycvcam
+Project-URL: Source, https://github.com/Artezaru/pycvcam
+Project-URL: Tracker, https://github.com/Artezaru/pycvcam/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.26
+Requires-Dist: opencv-python-headless>=4.9
+Requires-Dist: scipy>=1.12
+Requires-Dist: pyzernike-polynomials>=2.0.5
+Requires-Dist: py3dframe>=0.2.1
+Provides-Extra: dev
+Requires-Dist: sphinx; extra == "dev"
+Requires-Dist: pydata-sphinx-theme; extra == "dev"
+Requires-Dist: numpydoc; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: bumpver; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Dynamic: license-file
+
+# pycvcam
+
+## Description
+
+Python Computer Vision Cameras transformations and models.
+
+A computer vision camera is modeled by three main components:
+
+1. **Extrinsic**: The transformation from the world coordinate system to the normalized camera coordinate system (`world_points` to `normalized_points`)
+2. **Distortion**: The transformation from the normalized camera coordinate system to the distorted camera coordinate system (`normalized_points` to `distorted_points`)
+3. **Intrinsic**: The transformation from the distorted camera coordinate system to the image coordinate system (`distorted_points` to `image_points`)
+
+As described in the figure below, the package `pycvcam` uses the following notation:
+
+- `world_points`: The 3-D points **X_w** (`(..., 3)`) expressed in the world coordinate system *(Ex, Ey, Ez)*.
+- `normalized_points`: The 2-D points **x_n** (`(..., 2)`) expressed in the normalized camera coordinate system *(I, J)* with a unit distance along the optical axis *(K)*.
+- `distorted_points`: The distorted 2-D points **x_d** (`(..., 2)`) expressed in the normalized camera coordinate system *(I, J)* with a unit distance along the optical axis *(K)*.
+- `image_points`: The 2-D points **x_i** (`(..., 2)`) expressed in the image coordinate system *(ex, ey)* in the sensor plane.
+- `pixel_points`: The 2-D points **x_p** (`(..., 2)`) expressed in the pixel coordinate system *(u, v)* in the matrix of pixels.
+
+![Definition of quantities in pycvcam](./pycvcam/resources/definition.png)
+
+To convert the `image_points` to the `pixel_points`, a simple switch of coordinate system can be performed.
+
+The package provides several models and extrinsic, distortion, and intrinsic transformations.
+
+The functions `project_points`, `compute_rays`, ... can be used to easily process transformations from the 3D world frame of reference to the image plane.
+
+## Examples
+
+Create a simple example to project 3D points to 2D image points using the intrinsic and extrinsic parameters of the camera.
+
+```python
+import numpy
+from pycvcam import project_points, Cv2Distortion, Cv2Extrinsic, Cv2Intrinsic
+
+# Define the 3D points in the world coordinate system
+world_points = numpy.array([[0.0, 0.0, 5.0],
+                            [0.1, -0.1, 5.0],
+                            [-0.1, 0.2, 5.0],
+                            [0.2, 0.1, 5.0],
+                            [-0.2, -0.2, 5.0]])  # shape (5, 3)
+
+# Define the rotation vector and translation vector
+rvec = numpy.array([0.01, 0.02, 0.03])  # small rotation
+tvec = numpy.array([0.1, -0.1, 0.2])    # small translation
+extrinsic = Cv2Extrinsic.from_rt(rvec, tvec)
+
+# Define the intrinsic camera matrix
+K = numpy.array([[1000.0, 0.0, 320.0],
+                 [0.0, 1000.0, 240.0],
+                 [0.0, 0.0, 1.0]])
+
+intrinsic = Cv2Intrinsic.from_matrix(K)
+
+# Define the distortion model (optional)
+distortion = Cv2Distortion(parameters=[0.1, 0.2, 0.3, 0.4, 0.5])
+
+# Project the 3D points to 2D image points
+result = project_points(world_points, intrinsic=intrinsic, distortion=distortion, extrinsic=extrinsic)
+print("Projected image points:")
+print(result.image_points)  # shape (5, 2)
+```
+
+You can also compute the Jacobians of the image points with respect to the input 3D world points and the projection parameters by setting the **dx** and **dp** parameters to True.
+
+```python
+# Project the 3D points to 2D image points with Jacobians
+result = project_points(world_points, intrinsic=intrinsic, distortion=distortion, extrinsic=extrinsic, dx=True, dp=True)
+
+print("Jacobian with respect to 3D points:")
+print(result.jacobian_dx)  # shape (5, 2, 3)
+
+print("Jacobian with respect to projection parameters:")
+print(result.jacobian_dp)  # shape (5, 2, Nparams)
+
+print("Jacobian with respect to extrinsic parameters:")
+print(result.jacobian_dextrinsic)  # shape (5, 2, Nextrinsic)
+
+print("Jacobian with respect to distortion parameters:")
+print(result.jacobian_ddistortion)  # shape (5, 2, Ndistortion)
+
+print("Jacobian with respect to intrinsic parameters:")
+print(result.jacobian_dintrinsic)  # shape (5, 2, Nintrinsic)
+```
+
+## Authors
+
+- Artezaru <artezaru.github@proton.me>
+
+- **Git Plateform**: https://github.com/Artezaru/pycvcam.git
+- **Online Documentation**: https://Artezaru.github.io/pycvcam
+
+## Installation
+
+Install with pip
+
+```
+pip install git+https://github.com/Artezaru/pycvcam.git
+```
+
+Clone with git
+
+```
+git clone https://github.com/Artezaru/pycvcam.git
+```
+
+## License
+
+Copyright 2025 Artezaru
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

pycvcam-1.3.4/README.md

@@ -0,0 +1,122 @@
+# pycvcam
+
+## Description
+
+Python Computer Vision Cameras transformations and models.
+
+A computer vision camera is modeled by three main components:
+
+1. **Extrinsic**: The transformation from the world coordinate system to the normalized camera coordinate system (`world_points` to `normalized_points`)
+2. **Distortion**: The transformation from the normalized camera coordinate system to the distorted camera coordinate system (`normalized_points` to `distorted_points`)
+3. **Intrinsic**: The transformation from the distorted camera coordinate system to the image coordinate system (`distorted_points` to `image_points`)
+
+As described in the figure below, the package `pycvcam` uses the following notation:
+
+- `world_points`: The 3-D points **X_w** (`(..., 3)`) expressed in the world coordinate system *(Ex, Ey, Ez)*.
+- `normalized_points`: The 2-D points **x_n** (`(..., 2)`) expressed in the normalized camera coordinate system *(I, J)* with a unit distance along the optical axis *(K)*.
+- `distorted_points`: The distorted 2-D points **x_d** (`(..., 2)`) expressed in the normalized camera coordinate system *(I, J)* with a unit distance along the optical axis *(K)*.
+- `image_points`: The 2-D points **x_i** (`(..., 2)`) expressed in the image coordinate system *(ex, ey)* in the sensor plane.
+- `pixel_points`: The 2-D points **x_p** (`(..., 2)`) expressed in the pixel coordinate system *(u, v)* in the matrix of pixels.
+
+![Definition of quantities in pycvcam](./pycvcam/resources/definition.png)
+
+To convert the `image_points` to the `pixel_points`, a simple switch of coordinate system can be performed.
+
+The package provides several models and extrinsic, distortion, and intrinsic transformations.
+
+The functions `project_points`, `compute_rays`, ... can be used to easily process transformations from the 3D world frame of reference to the image plane.
+
+## Examples
+
+Create a simple example to project 3D points to 2D image points using the intrinsic and extrinsic parameters of the camera.
+
+```python
+import numpy
+from pycvcam import project_points, Cv2Distortion, Cv2Extrinsic, Cv2Intrinsic
+
+# Define the 3D points in the world coordinate system
+world_points = numpy.array([[0.0, 0.0, 5.0],
+                            [0.1, -0.1, 5.0],
+                            [-0.1, 0.2, 5.0],
+                            [0.2, 0.1, 5.0],
+                            [-0.2, -0.2, 5.0]])  # shape (5, 3)
+
+# Define the rotation vector and translation vector
+rvec = numpy.array([0.01, 0.02, 0.03])  # small rotation
+tvec = numpy.array([0.1, -0.1, 0.2])    # small translation
+extrinsic = Cv2Extrinsic.from_rt(rvec, tvec)
+
+# Define the intrinsic camera matrix
+K = numpy.array([[1000.0, 0.0, 320.0],
+                 [0.0, 1000.0, 240.0],
+                 [0.0, 0.0, 1.0]])
+
+intrinsic = Cv2Intrinsic.from_matrix(K)
+
+# Define the distortion model (optional)
+distortion = Cv2Distortion(parameters=[0.1, 0.2, 0.3, 0.4, 0.5])
+
+# Project the 3D points to 2D image points
+result = project_points(world_points, intrinsic=intrinsic, distortion=distortion, extrinsic=extrinsic)
+print("Projected image points:")
+print(result.image_points)  # shape (5, 2)
+```
+
+You can also compute the Jacobians of the image points with respect to the input 3D world points and the projection parameters by setting the **dx** and **dp** parameters to True.
+
+```python
+# Project the 3D points to 2D image points with Jacobians
+result = project_points(world_points, intrinsic=intrinsic, distortion=distortion, extrinsic=extrinsic, dx=True, dp=True)
+
+print("Jacobian with respect to 3D points:")
+print(result.jacobian_dx)  # shape (5, 2, 3)
+
+print("Jacobian with respect to projection parameters:")
+print(result.jacobian_dp)  # shape (5, 2, Nparams)
+
+print("Jacobian with respect to extrinsic parameters:")
+print(result.jacobian_dextrinsic)  # shape (5, 2, Nextrinsic)
+
+print("Jacobian with respect to distortion parameters:")
+print(result.jacobian_ddistortion)  # shape (5, 2, Ndistortion)
+
+print("Jacobian with respect to intrinsic parameters:")
+print(result.jacobian_dintrinsic)  # shape (5, 2, Nintrinsic)
+```
+
+## Authors
+
+- Artezaru <artezaru.github@proton.me>
+
+- **Git Plateform**: https://github.com/Artezaru/pycvcam.git
+- **Online Documentation**: https://Artezaru.github.io/pycvcam
+
+## Installation
+
+Install with pip
+
+```
+pip install git+https://github.com/Artezaru/pycvcam.git
+```
+
+Clone with git
+
+```
+git clone https://github.com/Artezaru/pycvcam.git
+```
+
+## License
+
+Copyright 2025 Artezaru
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

pycvcam-1.3.4/docs/source/api.rst

@@ -0,0 +1,83 @@
+API Reference
+==============
+
+To set the type of the arrays in the package use the :class:`pycvcam.core.Package` class.
+
+Transformations
+----------------
+
+The package provides a set of transformations that can be applied to process the transformation from the ``world_points`` to the ``image_points``.
+The structure of objects is given by the abstract classes stored in the ``pycvcam.core`` module.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: pycvcam.core:
+
+   ./api_doc/package.rst
+   ./api_doc/transform.rst
+   ./api_doc/transform_result.rst
+   ./api_doc/intrinsic.rst
+   ./api_doc/distortion.rst
+   ./api_doc/extrinsic.rst
+   ./api_doc/rays.rst
+
+Some default ``Extrinsic``, ``Intrinsic``, and ``Distortion`` objects are provided in the package.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Extrinsic Models:
+
+   ./api_doc/cv2_extrinsic.rst
+   ./api_doc/no_extrinsic.rst
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Intrinsic Models:
+
+   ./api_doc/cv2_intrinsic.rst
+   ./api_doc/skew_intrinsic.rst
+   ./api_doc/no_intrinsic.rst
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Distortion Models:
+
+   ./api_doc/cv2_distortion.rst
+   ./api_doc/zernike_distortion.rst
+   ./api_doc/no_distortion.rst
+
+
+
+Transformation processes
+-------------------------
+
+The package provides a set of transformation processes that can be used to apply the transformations to the points.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Transformation Processes:
+
+   ./api_doc/undistort_image.rst
+   ./api_doc/undistort_points.rst
+   ./api_doc/project_points.rst
+   ./api_doc/compute_rays.rst
+   ./api_doc/distort_image.rst
+   ./api_doc/read_transform.rst
+   ./api_doc/write_transform.rst
+
+
+Optimisation processes
+----------------------
+
+The package provides a set of optimisation processes that can be used to estimate the parameters of the transformations.
+The optimisations are located in the ``pycvcam.optimize`` module.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Optimisation Processes:
+
+   ./api_doc/optimize_parameters.rst
+   ./api_doc/optimize_input_points.rst
+
+
+

pycvcam-1.3.4/docs/source/api_doc/compute_rays.rst

@@ -0,0 +1,5 @@
+pycvcam.compute_rays
+=================================
+
+
+.. autofunction:: pycvcam.compute_rays

pycvcam-1.3.4/docs/source/api_doc/cv2_distortion.rst

@@ -0,0 +1,8 @@
+pycvcam.Cv2Distortion
+========================
+
+.. autoclass:: pycvcam.Cv2Distortion
+    :members:
+    :undoc-members:
+    :private-members:
+    :show-inheritance:

pycvcam-1.3.4/docs/source/api_doc/cv2_extrinsic.rst

@@ -0,0 +1,8 @@
+pycvcam.Cv2Extrinsic
+=============================
+
+.. autoclass:: pycvcam.Cv2Extrinsic
+    :members:
+    :undoc-members:
+    :private-members:
+    :show-inheritance:

pycvcam-1.3.4/docs/source/api_doc/cv2_intrinsic.rst

@@ -0,0 +1,8 @@
+pycvcam.Cv2Intrinsic
+=====================
+
+.. autoclass:: pycvcam.Cv2Intrinsic
+   :members:
+   :private-members:
+   :undoc-members:
+   :show-inheritance:

pycvcam-1.3.4/docs/source/api_doc/distort_image.rst

@@ -0,0 +1,4 @@
+pycvcam.distort_image
+==================================
+
+.. autofunction:: pycvcam.distort_image

pycvcam-1.3.4/docs/source/api_doc/distortion.rst

@@ -0,0 +1,10 @@
+pycvcam.core.Distortion
+=============================
+
+.. autoclass:: pycvcam.core.Distortion
+    :members:
+    :undoc-members:
+    :private-members:
+    :show-inheritance:
+
+

pycvcam-1.3.4/docs/source/api_doc/extrinsic.rst

@@ -0,0 +1,10 @@
+pycvcam.core.Extrinsic
+=============================
+
+.. autoclass:: pycvcam.core.Extrinsic
+    :members:
+    :undoc-members:
+    :private-members:
+    :show-inheritance:
+
+

pycvcam-1.3.4/docs/source/api_doc/intrinsic.rst

@@ -0,0 +1,10 @@
+pycvcam.core.Intrinsic
+=============================
+
+.. autoclass:: pycvcam.core.Intrinsic
+    :members:
+    :undoc-members:
+    :private-members:
+    :show-inheritance:
+
+

pycvcam-1.3.4/docs/source/api_doc/no_distortion.rst

@@ -0,0 +1,8 @@
+pycvcam.NoDistortion
+========================
+
+.. autoclass:: pycvcam.NoDistortion
+    :members:
+    :undoc-members:
+    :private-members:
+    :show-inheritance:

pycvcam-1.3.4/docs/source/api_doc/no_extrinsic.rst

@@ -0,0 +1,8 @@
+pycvcam.NoExtrinsic
+=============================
+
+.. autoclass:: pycvcam.NoExtrinsic
+    :members:
+    :undoc-members:
+    :private-members:
+    :show-inheritance:

pycvcam-1.3.4/docs/source/api_doc/no_intrinsic.rst

@@ -0,0 +1,8 @@
+pycvcam.NoIntrinsic
+=====================
+
+.. autoclass:: pycvcam.NoIntrinsic
+   :members:
+   :private-members:
+   :undoc-members:
+   :show-inheritance:

pycvcam-1.3.4/docs/source/api_doc/optimize_input_points.rst

@@ -0,0 +1,4 @@
+pycvcam.optimize.optimize_input_points
+=============================================
+
+.. autofunction:: pycvcam.optimize.optimize_input_points.optimize_input_points

pycvcam-1.3.4/docs/source/api_doc/optimize_parameters.rst

@@ -0,0 +1,4 @@
+pycvcam.optimize.optimize_parameters
+=============================================
+
+.. autofunction:: pycvcam.optimize.optimize_parameters.optimize_parameters

pycvcam-1.3.4/docs/source/api_doc/package.rst

@@ -0,0 +1,8 @@
+pycvcam.core.Package
+=============================
+
+.. autoclass:: pycvcam.core.Package
+    :members:
+    :undoc-members:
+    :private-members:
+    :show-inheritance:

pycvcam-1.3.4/docs/source/api_doc/project_points.rst

@@ -0,0 +1,5 @@
+pycvcam.project_points
+==========================
+
+.. autofunction:: pycvcam.project_points
+