Encapsulation of typical camera functionality.

Install

Dependencies

These dependencies are handled via setup.py dependency resolution. You may install them from source too by reading their corresponding README.

improcessor

Visualization

If you use the viz extras install, you must have a suitable gui backend for mayavi to work.

ImportError: Could not import backend for traitsui.  Make sure you
        have a suitable UI toolkit like PyQt/PySide or wxPython
        installed.

Install either pyqt5 (or wxpython) to resolve this error.

# upgrade pip, or you may get stuck on license agreement
# https://stackoverflow.com/questions/66546886/pip-install-stuck-on-preparing-wheel-metadata-when-trying-to-install-pyqt5
pip install --upgrade pip
pip install PyQt5

If you have issues with PyQt, you can try wxpython instead.

# https://github.com/wxWidgets/Phoenix/issues/2225

pip install "wxpython<4.2.0"

If a suitable ui backend is not found or there are other issues with mayavi, visualizations will fall back to matplotlib.

Install

git clone https://github.com/ivapylibs/camera.git
pip3 install -e camera[viz]
 
# or if inside of the checked out directory
pip3 install -e .[viz]

You may be interested in installing this in a virtual environment, which helps isolate packages from your system python.

python3 -m venv venv
source venv/bin/activate
pip3 install -e camera[viz]
 
# or if inside of the checked out directory
python3 -m venv venv
source venv/bin/activate
pip3 install -e .[viz]

Note:

<tt>python -m camera.d435.testing.tabletop_plane</tt>

This testing file uses a 3d visualization package mayavi, which is for helping some undergrads understand the algorithm in a course. Please install the dependency first:

pip install -e .[viz]

The test file visualize the extracted tabletop plane point cloud in the camera frame, which is a necessary step for the height estimation. You can skip that testing file and run python -m camera.d435.testing.height directly.