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:
- 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
- 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-kor--lidar-cameraon the CLI, those override the config file. - If you pass both
--image/--pcdand 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
.txtcontaining 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.