Metadata-Version: 2.4
Name: solshade
Version: 0.1.0
Summary: Terrain-aware solar illumination modeling using DEMs and orbital sun geometry.
Project-URL: Documentation, https://solshade.readthedocs.io
Project-URL: Source, https://github.com/amanchokshi/solshade
Project-URL: Homepage, https://github.com/amanchokshi/solshade
Project-URL: Issues, https://github.com/amanchokshi/solshade/issues
Author-email: Aman Chokshi <aman.chokshi@mcgill.ca>
License: MIT
License-File: LICENSE
Keywords: DEM,GIS,geospatial,illumination,solar,terrain
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.13
Requires-Dist: cmasher>=1.9.2
Requires-Dist: joblib>=1.5.1
Requires-Dist: matplotlib>=3.10.5
Requires-Dist: more-itertools>=10.7.0
Requires-Dist: numba==0.61.2
Requires-Dist: numpy==2.2
Requires-Dist: pandas>=2.3.1
Requires-Dist: rasterio>=1.4.3
Requires-Dist: rich>=14.1.0
Requires-Dist: rioxarray>=0.19.0
Requires-Dist: scipy>=1.16.1
Requires-Dist: skyfield>=1.53
Requires-Dist: typer>=0.16.0
Description-Content-Type: text/markdown

![](https://github.com/user-attachments/assets/69bef1b9-10b1-44d9-9bf0-46eac1fda3ce)
---
`solshade` is a Python toolkit for simulating solar radiation across landscapes, accounting for terrain shadows, solar angles, and orbital geometry. It’s designed for interdisciplinary research at the intersection of astronomy, glaciology, botany, and geology.

---

## What does `solshade` do?

- Computes per-pixel solar exposure over time from a DEM
- Generates terrain-aware **horizon maps** to determine shadowing
- Uses precise **solar ephemerides** (via Skyfield)
- Calculates:
  - Total annual insolation
  - Date of maximum sunlight
  - Mean solar incidence angle
  - Terrain shading based on real orbital paths

---

## Example Applications

- Modeling plant growing seasons across topography
- Studying microhabitats in extreme environments
- Predicting snowmelt timing in complex terrain
- Understanding glacial melt and shadowed regions

---

## Project Status

This project is in early development.  
Expect breaking changes, experiments, and rapid iteration.

---

## License

MIT License — see `LICENSE` file.

---

## Acknowledgments

Inspired by many interesting conversations with Anna O'Flynn, Anthony Zerafa & Chris Omelon at the McGill Arctic Research Station (MARS) on Axel Heiberg Island, 2025.
