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.2.tar.gz (493.4 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.2-py3-none-any.whl (522.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: calcam-2.16.2.tar.gz
  • Upload date:
  • Size: 493.4 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.2.tar.gz
Algorithm Hash digest
SHA256 c557e31f69a9833695bb40d6ac861c99251f30aa82502d25f1353655e2291be0
MD5 c297b4dfa04f9876ded9d60d545e2d74
BLAKE2b-256 fa2221d833c5deef3fd2bff02aee8a5d4e29f19f07f81438e8beb23b8ca98e30

See more details on using hashes here.

File details

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

File metadata

  • Download URL: calcam-2.16.2-py3-none-any.whl
  • Upload date:
  • Size: 522.7 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 a645b082f59f1d9b2a17751667d41a2cad1b5a9cda30c13da143145071c41041
MD5 2dceb4218a6bff5300bc283d1d1c4e78
BLAKE2b-256 36f54ab2aeb90ea640e0e40601821ff357268288f3c25f0cacd6bfdf5e3b7200

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