sunlight-analysis

Calculate solar position, sun path diagrams, and terrain shadow for architectural daylight design.

12|2|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/haomingz/kimi-skills --skill sunlight-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sunlight-analysis
Source: https://github.com/haomingz/kimi-skills/tree/main/skills/sunlight-analysis
Command: npx skills add https://github.com/haomingz/kimi-skills --skill sunlight-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pysolar, matplotlib, pytz, shapely, numpy, rasterio, and includes scripts (resource) components.

What problem does it solve?

Architects and designers often struggle to quantify how sun position, shadows, and terrain affect building performance and outdoor comfort across sites and times.

Core Features & Use Cases

  • Compute solar position (azimuth/elevation) for any location and time and generate sun-path diagrams.
  • Analyze building shadows and terrain shadow from DEM to inform massing and daylight design.
  • Assess annual sun hours, shadow hours, and nighttime periods at a point for energy and comfort planning.

Quick Start

Analyze a site by generating a sun-path diagram for a chosen location and time.

Frequently Asked Questions about sunlight-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I calculate solar position and generate a sun-path diagram for architectural daylight design?

To calculate solar position and generate a sun-path diagram, you need to specify your target location and time. The analysis outputs azimuth and elevation angles, which are then visualized to support site analysis and massing decisions for architectural daylight planning.

Can I analyze terrain shadow from a DEM for site analysis?

Yes, you can analyze terrain shadow from a DEM file for site analysis. By processing digital elevation models, the tool calculates terrain shadows to inform massing and daylight design, helping you assess outdoor comfort and building performance across different times.

How do I assess annual sun hours and shadow hours at a specific point for energy modeling?

You can assess annual sun hours and shadow hours at a specific point by running the solar position calculations across a full year. This outputs cumulative daylight and nighttime periods, directly supporting energy modeling and outdoor comfort planning for your site.

Do I need specific Python libraries to run solar position and shadow analysis?

Yes, you need specific Python libraries to run solar position and shadow analysis. The implementation relies on pysolar, matplotlib, numpy, pytz, shapely, and rasterio to execute the underlying calculations and generate visual diagrams.

What's the best way to visualize building shadows and sun paths across multiple locations?

The best way to visualize building shadows and sun paths across multiple locations is by using matplotlib to render the computed solar data. This approach generates sun-path diagrams and shadow projections, allowing you to compare daylight design impacts across various sites.

Why use rasterio and shapely for terrain shadow analysis?

You use rasterio and shapely for terrain shadow analysis because rasterio handles DEM file input and geospatial data, while shapely processes the resulting geometric boundaries. Together they compute terrain shadow geometry for architectural site analysis.