Camera

Encaspulation of typical camera functionality.

Install

Dependencies

Install the following dependencies from the source, where the installation guide is provided in their respective repository.

improcessor

Install

git clone https://github.com/ivapylibs/camera.git
pip3 install -e camera[viz]

Note:

python -m camera.d435.testing.tabletop_plane

This testing file uses a 3d visualization package mayavi, which is for helping some undergrads understand the algorithm in a course. If you use the python 3.7 environment and want to run this file, 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.

Ubuntu Python Environment Setup

Use the default python for your system. Here we go through an installation for Python 3.7.

Install the Python 3.7

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.7

Verify the installation:

python3.7

Install the Pip 3.7. The command line installation often cause errors, so use the installation script

cd
curl "https://bootstrap.pypa.io/get-pip.py" -o "get-pip.py"
python3.7 get-pip.py
# should enter the python3.7 environment
# Ctrl-D to exit

Verify the installation:

pip3.7 -V
# should see something like below
# pip xx.x.x from /default/site-packages/path

Change the default python3 version pip3 version (optional)

Up until now every thing you run should be in the form of below (include the commands in the install section above). Because if your system have multiple python versions, the python3 or pip3 command might not be linked to the one you want.
```
pip3.7 install SOMEPACKAGE
python3.7 SOMESCRIPT.py
```
We can optionally create the symlink pip3 and python3 for our desired version so that you can use the following command instead:
```
pip3 install SOMEPACKAGE
python3 SOMESCRIPT.py
```
One way to do it is to use the update-alternatives command (change the python version in the first two lines accordingly, and similar for the pip) :
```
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.5 1
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.7 2

sudo update-alternatives --config python

sudo update-alternatives  --set python /usr/bin/python3.7
```
Alternatively, we can create an virtual environment using the venv or the Anaconda for the desired python version to avoid the this step.