Metadata-Version: 2.1
Name: bbo-calibcam
Version: 1.2.0
Summary: Calibrate intrinsic and extrinsic parameters of cameras with charuco boards
Home-page: https://github.com/bbo-lab/calibcam
Author: BBO-lab @ caesar
Author-email: kay-michael.voit@caesar.de
License: BSD
Platform: UNKNOWN
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# calibcam
A charuco based calibrator for camera setups (intrinsic and extrinsic coordinates).

# Installation

## Windows

1. (If not already done:) [Install Anaconda](https://docs.anaconda.com/anaconda/install/windows/)
2. Create conda env `conda env create -f https://raw.githubusercontent.com/bbo-lab/calibcam/main/environment.yml`
3. Switch to multitrackpy environment: `conda activate calibcam`
4. Install with `pip install bbo-calibcam`


# Usage

## Windows

1. From `[repository]/calibcam/boards`, copy the appropriate board into the calibration video directory and rename to `board.npy`
2. Open Anaconda prompt via Start Menu
3. Switch to calibcam environment: `conda activate calibcam`
4. Run the program with `python -m calibcam`
5. In GUI, click "Perform calibration"
6. Select all calibration videos
7. After calibration, check reprojection in GUI

BBO internal MATLAB use only:

8. Run `multicalibration_matlab_mcl_gen.m` in the video directory in MATLAB
9. Save resulting mcl file into video directory

Alternatively, run purely commandline-based with
```
$ python -m calibcam --help
usage: __main__.py [-h] [--videos [VIDEOS [VIDEOS ...]]] [--board BOARD]

Calibrate set of cameras

optional arguments:
  -h, --help            show this help message and exit
  --videos [VIDEOS [VIDEOS ...]]
  --board BOARD
```


