Skip to main content

interactive_camera_lidar_calibration

Python package scaffold for sensorcal.

Install (editable)

python -m pip install -e .

Install (pip)

python -m pip install sensorcal

Quickstart

sensorcal recalibrate --use-sample

If you run sensorcal recalibrate with no arguments, it defaults to the sample data. When installed via pip, sample data is bundled inside the package.

Usage

Single image + pcd:

sensorcal recalibrate \
  --config path/to/calibrate.yaml \
  --image path/to/img_001.png \
  --pcd path/to/pc_001.pcd

Single image + pcd with parameters (no config):

sensorcal recalibrate \
  --image path/to/img_001.png \
  --pcd path/to/pc_001.pcd \
  --intrinsic-k 600 0 640 0 600 360 0 0 1 \
  --lidar-camera 1 0 0 0 0 1 0 0 0 0 1 0 0 0 0 1

Folder mode:

sensorcal recalibrate \
  --config path/to/calibrate.yaml \
  --image-folder path/to/images \
  --pcd-folder path/to/pcds

Sample data (3 images + 3 PCDs bundled in samples/): use the quickstart above.

Input Structure

You can provide inputs in two ways:

  1. Direct CLI arguments
  • Single pair:
    • --image path/to/img.png
    • --pcd path/to/cloud.pcd
  • Folder mode (paired by sorted filename order):
    • --image-folder path/to/images
    • --pcd-folder path/to/pcds
  1. YAML config file (--config path/to/calibrate.yaml)

Expected YAML structure

transform:
  # 3x3 camera intrinsics in row-major order
  intrinsic_k: [fx, 0, cx, 0, fy, cy, 0, 0, 1]

  # 4x4 LiDAR-to-camera transform in row-major order
  lidar_camera: [r00, r01, r02, tx,
                 r10, r11, r12, ty,
                 r20, r21, r22, tz,
                 0,   0,   0,   1]

path:
  # Optional defaults for folder mode
  img_folder: /abs/or/relative/path/to/images
  pcd_folder: /abs/or/relative/path/to/pcds

Notes

  • If you pass --intrinsic-k or --lidar-camera on the CLI, those override the config file.
  • If you pass both --image/--pcd and folder paths, the single pair wins.
  • For folder mode, files are paired by sorted filename order, so keep names aligned.

Python (pip installed)

from sensorcal.app import SensorCalApp

app = SensorCalApp(
    config_path="path/to/calibrate.yaml",
    intrinsic_k=None,
    lidar_camera=None,
    image_path="path/to/img_001.png",
    pcd_path="path/to/pc_001.pcd",
    image_folder=None,
    pcd_folder=None,
    save_file="calibration_results.yaml",
)
app.process()

Controls

  • Single-window Tkinter app with live sliders, buttons, and dark mode toggle
  • Sliders: tx/ty/tz (meters), roll/pitch/yaw (degrees), alpha, point size
  • Density toggle: overlays a heatmap of point concentration (helps reveal clusters)
  • Keyboard: A/D (X-/X+), W/S (Y-/Y+), Q/E (Z-/Z+)
  • Rotate: J/L (roll-/+), I/K (pitch-/+), U/O (yaw-/+)
  • Buttons: Prev, Next, Original, Save
  • Save writes YAML plus a sibling .txt containing K and the transform.

Python API

Use the sensorcal.app.SensorCalApp class shown above.

Metadata

Release files for sensorcal 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sensorcal 0.1.2
File Size Uploaded Provenance Actions
sensorcal-0.1.2.tar.gz 12.8 MB Without provenance Details for sensorcal-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sensorcal 0.1.2
File Interpreter ABI Platform Actions
sensorcal-0.1.2-py3-none-any.whl Python 3 none any Details for sensorcal-0.1.2-py3-none-any.whl

Total release size: 25.7 MB

Release files / sensorcal-0.1.2.tar.gz

Download URL sensorcal-0.1.2.tar.gz
Size 12.8 MB
Tags Source
SHA-256 checksum
How to use checksums
e62bb97a0f3ff9a0e110db8f658f11d3ad10aa6f9d4cddfa6c742493b2fd92e9
BLAKE2b-256 checksum
How to use checksums
4d4b75c4a2526951d53317fe49e1f1eff4836337f77a7a229434da34666123fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.16

Release files / sensorcal-0.1.2-py3-none-any.whl

Download URL sensorcal-0.1.2-py3-none-any.whl
Size 12.8 MB
Tags Python 3
SHA-256 checksum
How to use checksums
d6ec4403d235cd1fc4a1cf5e01441cdb7692a58f7646dd5fa703ceda10d00d7f
BLAKE2b-256 checksum
How to use checksums
bf347dbda7d24c8e70f2cbd29960a09cbc820336f2e231542c560ad98b0bac3c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.16

Security for sensorcal 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page