Skip to main content

Spatial calibration tools for science & engineering camera systems.

Project description

Calcam logo

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

calcam-2.16.3.tar.gz (493.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

calcam-2.16.3-py3-none-any.whl (522.9 kB view details)

Uploaded Python 3

File details

Details for the file calcam-2.16.3.tar.gz.

File metadata

  • Download URL: calcam-2.16.3.tar.gz
  • Upload date:
  • Size: 493.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for calcam-2.16.3.tar.gz
Algorithm Hash digest
SHA256 4de71372becac7b026c867eb354a4dc8ccf269913394deaa887241669c6b176e
MD5 2aa317e8a21686e54de5afb7ef93325c
BLAKE2b-256 64824afb64c18ceba1f6a1543c91b33de30acad1cc881895000ae34148f18897

See more details on using hashes here.

File details

Details for the file calcam-2.16.3-py3-none-any.whl.

File metadata

  • Download URL: calcam-2.16.3-py3-none-any.whl
  • Upload date:
  • Size: 522.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for calcam-2.16.3-py3-none-any.whl
Algorithm Hash digest
SHA256 bea82c9f7595c49bd4a192867f0bf3e34dab5e3bce0d2889ca4ccfb19113c43d
MD5 a4b39b521ecf8bc1ba8e3ef4dd2f6226
BLAKE2b-256 9e012bf05ce8ad70a2d4048bbe8e6250e12ea78b10a80aa7d17b144c36f59918

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page