skycam
Camera-agnostic fisheye image projection library for ground-based sky observation
✨ Features
| Feature | Description |
|---|---|
| ⚡ Numba JIT | ~100x faster projection via compiled bilinear interpolation |
| 💾 Coordinate Cache | Sub-100ms init after first calibration load |
| 🏛️ Hexagonal Architecture | Clean separation of domain, adapters, and config |
| ✅ Pydantic v2 | Validated settings with environment variable support |
| 🔬 Scientific Accuracy | WGS84 geodesic calculations via GeographicLib |
🚀 Installation
uv add skycam
Or with pip:
pip install skycam
📖 Quick Start
from pathlib import Path
from skycam.adapters import JP2CalibrationLoader, load_jp2
from skycam.domain.models import ProjectionSettings
from skycam.domain.projection import ProjectionService
# Load calibration and create projector
loader = JP2CalibrationLoader(Path("calibration"))
calibration = loader.load("visible")
projector = ProjectionService(
calibration=calibration,
settings=ProjectionSettings(),
)
# Project fisheye → regular grid
projected = projector.project(load_jp2(Path("input.jp2")))
🏗️ Architecture
flowchart LR
subgraph Adapters["Adapters"]
CAL[JP2 Calibration]
IMG[Image I/O]
end
subgraph Domain["Domain"]
PROJ[ProjectionService]
INTERP[Numba Bilinear]
end
subgraph Config["Config"]
SETTINGS[SkycamSettings]
end
CAL --> PROJ
IMG --> PROJ
SETTINGS --> PROJ
PROJ --> INTERP
⚙️ Configuration
Environment variables (prefix: SKYCAM_):
| Variable | Default | Description |
|---|---|---|
SKYCAM_CALIBRATION_DIR |
calibration |
JP2 calibration files directory |
SKYCAM_CATEGORY |
visible |
Camera category (visible, infrarouge) |
SKYCAM_DATA_DIR |
data |
Input/output data directory |
🛠️ Development
git clone https://github.com/eurocontrol-asu/skycam.git
cd skycam
make install # uv sync --all-groups
make check # lint + audit + test
📚 Documentation
eurocontrol-asu.github.io/skycam
- 🚀 Tutorial — Project your first image in 5 minutes
- 🛠️ Guides — How-to recipes for common tasks
- 🧠 Concepts — Architecture and algorithm deep-dive
- 📚 Reference — Complete API documentation
🤝 Contributing
See CONTRIBUTING.md for guidelines.
📄 License
EUPL-1.2 — See LICENSE for details.
Metadata
Release files for skycam 0.1.0
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 |
|---|---|---|---|---|
| skycam-0.1.0.tar.gz | 18.2 MB | Without provenance | Details for skycam-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| skycam-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for skycam-0.1.0-py3-none-any.whl |
Total release size: 18.2 MB
Release files / skycam-0.1.0.tar.gz
| Download URL | skycam-0.1.0.tar.gz |
|---|---|
| Size | 18.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4a967da60275b08e1b3ca43fe946f8e252ed9f432ce4670547f110394b767f3a
|
|
BLAKE2b-256 checksum How to use checksums |
a7bbbe8f63a960f7edb37c7ff30a50d03f173771d1701db9eb56b9f26117913a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / skycam-0.1.0-py3-none-any.whl
| Download URL | skycam-0.1.0-py3-none-any.whl |
|---|---|
| Size | 19.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cd519a8d7c9d1a3c88b4112f1bd4626360513fd4a73c7b7c7483c39f314db24a
|
|
BLAKE2b-256 checksum How to use checksums |
3a2d2bbe862edb2339fa825fa3412aefda253b6324a97226d91c76e1ddfc2301
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for skycam 0.1.0
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.