Metadata-Version: 2.4
Name: calcam
Version: 2.16.0
Summary: Spatial calibration tools for science & engineering camera systems.
Author-email: "Scott Silburn et. al." <scott.silburn@ukaea.uk>
License: EUPL-1.1
Project-URL: Documentation, https://euratom-software.github.io/calcam
Project-URL: Source, https://github.com/euratom-software/calcam/
Project-URL: Issue Tracker, https://github.com/euratom-software/calcam/issues
Project-URL: Zenodo, https://doi.org/10.5281/zenodo.1478554
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Environment :: Console
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Scientific/Engineering :: Image Processing
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: scipy
Requires-Dist: matplotlib
Requires-Dist: vtk!=9.1.*,>=7
Requires-Dist: PyQt5
Requires-Dist: opencv-python-headless
Requires-Dist: h5py
Requires-Dist: triangle

![Calcam logo](https://euratom-software.github.io/calcam/html/_images/logo.png)

Calcam Python Package
=====================

Calcam is a Python package providing tools for "spatial calibration" of cameras used in science & engineering, i.e. determining the mapping between pixel coordinates in an image and real-world 3D sight lines & coordinates. The calibration method is based on the user matching features between an image to be calibrated and a 3D mesh of the scene being viewed, then using OpenCV’s camera calibration routines to fit a model relating the image and real world coordinates.

It was written for use with camera-based plasma diagnostics on fusion experiments, but may be useful for other applications too. As well as calibrating existing cameras, it can also be used as part of a virtual diagnostic setup, e.g. to evaluate different possible viewing geometries during diagnostic design and/or  setting up synthetic imaging diagnostics for modeling codes. 

Calcam provides a set of GUI tools for calibrating images and doing some basic analysis using the results, and a Python API for making full use of the calibration information as part of a data analysis process.

Documentation
--------------
The full documentation for the latest release version is online at: https://euratom-software.github.io/calcam/

or can be found in the `docs/` directory in the source repo.

License
-------
Calcam is released under the European Union Public Licence (EUPL) v1.1, full details in the included LICENCE.txt

Citing
------
If using this software for published academic work, please cite it! It has a DOI issued by Zenodo; click the DOI badge below for full details of how to cite.

[![DOI](https://zenodo.org/badge/92296352.svg)](https://zenodo.org/badge/latestdoi/92296352)
