Astrapeum

Astrapeum is a small Python workspace for modeling and tuning a reflective basin, mirror crown, and wall target system.

Quick Start

For local development, install the package in editable mode:

python -m pip install -e ".[dev]"

Then run the checks and CLI:

python -m pytest
python -m astrapeum simulate --az 93.11 --alt 19.3
python -m astrapeum mirrors --output draconic_mirrors.generated.json

Without installing, PowerShell can run the package with PYTHONPATH pointed at src:

$env:PYTHONPATH = "src"
python -m astrapeum simulate --az 93.11 --alt 19.3

Project Shape

• src/astrapeum/geometry.py: vector math and ray helpers.
• src/astrapeum/models.py: physical model dataclasses.
• src/astrapeum/simulation.py: basin-to-wall reflection simulation.
• src/astrapeum/tuning.py: mirror crown and lion-sector tuning helpers.
• src/astrapeum/data.py: packaged JSON data loading.
• src/astrapeum/cli.py: command-line entry points.
• tests/: executable guardrails for the scaffold.

The original src/astrapeum/wall.py remains as a compatibility facade.