Skip to main content

skycam

Camera-agnostic fisheye image projection library for ground-based sky observation

CI Coverage Python 3.12+ Pydantic v2 Typed Ruff uv PyPI License Docs


✨ 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

🤝 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)

Source distribution for skycam 0.1.0
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)

Table of built distributions (wheels) for skycam 0.1.0
File Interpreter ABI Platform Actions
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.

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