Metadata-Version: 2.1
Name: camproject
Version: 0.41
Summary: a camera projection lib to calculate the ray direction of a pixel and vice versa
Home-page: UNKNOWN
Author: Martin Israel
Author-email: martin.israel@dlr.de
License: MIT license
Keywords: camera pin hole projection brown lut
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
Requires-Dist: numpy

# camproject
a python module for camera projection and reprojection

Maintainer
----------
  * Martin Israel <m.israel@thermaldrones.de>

Requirements
------------

  * python 2.6, 2.7, or 3.x
  * NumPy


Installation
------------
The easiest way is to install it from Pypi with:
    `$ pip install camproject`

To install system-wide from source distribution:
   `$ python setup.py install`

Quickstart-Usage
----------------

    import numpy as np
    import camproject

    P = np.array([[1],[0],[10],[1]]) # this is a point in 3D (e.g. in meters)
    cam = camproject.Camera()  
    cam.intrinsics(640,512,1000,320,260) # inner parameters: (in pixels)
    # (im_width,im_height, focal_length, centerpixel_x, centerpixel_y)
    cam.attitudeMat(np.eye(4))  # outer parameters: point to z-direction
    p = cam.project(P) # gives pixel coordinates on the image

to reproject it back to the 3D world we use this code

    Q = cam.reprojectToPlane(p) 



Documentation
-------------


* documentation can be found at https://camproject.readthedocs.io/en/latest/
* If you acquired this code via GitHub, then you can build the documentation using sphinx.
      From the documentation directory, run:
          `$ make html`



