sun-path
by qrost
PDF & DocumentsBrief
Generates a sun path diagram, calculates solar position, performs building shadow analysis, and analyzes thermal.
Description
What This Skill Does
Calculates solar position, generates sun path diagrams, and simulates 2D building shadows for any location and time. Also computes annual sun and shadow hours at a given point, processes terrain shadow from GeoTIFF DEMs, and plots thermal comfort on a psychrometric chart.
Combines solar calculation, 2D shadow simulation, annual sun/shadow analysis, DEM-based terrain shadow, and thermal comfort assessment in one skill rather than requiring separate tools for each.
When to Use It
- Checking sun altitude and azimuth for a site before a photoshoot
- Generating a sun path diagram for an architectural site proposal
- Simulating building shadow at winter solstice to evaluate courtyard sunlight
- Calculating annual sun vs shadow hours at a specific outdoor point
- Assessing thermal comfort from current temperature and humidity readings
Example Workflow
User asks: Show me the shadow of a 20m tall, 10x10m building in Shanghai on winter solstice at 2 PM
- 1
Identifies Shanghai coordinates (lat 31.23, lon 121.47)
- 2
Sets time to 2024-12-21T14:00:00
- 3
Runs shadow_calc.py with building dimensions and an output path under an allowed directory
- 4
Sends the generated PNG to the user with a short summary
PNG image showing the building footprint and its shadow cast at the specified time and location
Installation
clawhub install qrost/sun-pathRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.