A comprehensive suite of environmental analysis tools for calculating solar positions, building shadows, and thermal comfort.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sun-path
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install sun-path using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Sun Path & Environmental Analysis?
This skill empowers architects, urban planners, and environmental designers to perform complex solar simulations directly within their AI-assisted workflow. By leveraging advanced Python libraries such as pysolar and matplotlib, it provides high-fidelity sun path diagrams, building shadow simulations, and annual sun hour calculations. As a specialized addition to the collection of Openclaw Skills, it bridges the gap between raw geographic data and actionable architectural insights.
Beyond basic solar tracking, the skill includes specialized modules for terrain shadow analysis using Digital Elevation Models (DEM) and thermal comfort evaluation via psychrometric charts. It is designed to work seamlessly with chat-based interfaces, allowing users to generate and view environmental visualizations in real-time.
Sun Path & Environmental Analysis Use Cases
- Determining optimal building orientation based on seasonal solar exposure.
- Simulating building shadows at specific dates and times to assess impact on neighboring structures.
- Calculating the total annual hours a specific point remains in direct sun versus building shadow.
- Analyzing large-scale terrain shadows for site planning using GeoTIFF data.
- Assessing outdoor thermal comfort by plotting temperature and humidity on psychrometric charts.
How Sun Path & Environmental Analysis Works
- The user provides geographic coordinates, temporal data, or building dimensions to the agent.
- The agent invokes the relevant Python script (e.g., sun_calc.py or shadow_calc.py) using the shell execution permission.
- The script processes calculations for solar azimuth, altitude, or geometric shadow polygons.
- Visual outputs such as PNG diagrams or GeoTIFF rasters are generated and saved to an authorized media directory.
- The agent retrieves the generated file and delivers it to the user along with a technical data summary.
Sun Path & Environmental Analysis Setup
To integrate this capability into your workflow, follow these installation steps:
- Install the skill via your terminal:
clawhub install sun-path
- Navigate to the skill directory and install the necessary Python dependencies:
pip install -r requirements.txt
- Ensure that an allowed media directory exists (e.g.,
~/.openclaw/media/) for the Openclaw Skills messaging tools to successfully send generated images.
Sun Path & Environmental Analysis Data Schema & Taxonomy
The skill generates and manages data across several formats to support environmental modeling:
| Data Type | Format | Description |
|---|---|---|
| Visual Charts | PNG/JPG | Polar sun path diagrams, monthly sun hour bars, and psychrometric comfort charts. |
| Shadow Maps | PNG | 2D building shadow simulations including rotation and footprint scaling. |
| Terrain Data | GeoTIFF | Binary shadow rasters generated from ray-casting against DEM files. |
| Analysis Parameters | CLI Arguments | Latitude, longitude, timezone, and ISO-8601 timestamps used for calculations. |
Sun Path & Environmental Analysis Advanced Features
- High-precision annual sun hour calculations with configurable sample intervals for long-term site analysis.
- Terrain-aware shadow casting that supports large-scale Digital Elevation Models for geographic planning.
- Integration with Openclaw Skills media tools for automated image delivery in Telegram or web interfaces.
- Psychrometric chart generation for localized thermal comfort assessment based on dry bulb temperature and relative humidity.
SKILL.md
Loading
Related Openclaw Skills
Map Grabber
Fetch and export OpenStreetMap vector data like street networks and building footprints directly into CAD-compatible formats.
DXF to Image / SVG Converter
A specialized conversion utility for Openclaw Skills that transforms technical DXF CAD files into web-friendly PNG, JPG, or SVG formats.
Color Palette
Extract dominant colors from images as HEX/RGB values and generate visual color swatches automatically.
SEO Competitor Analysis
An automated toolkit for identifying search competitors, analyzing keyword rankings, and generating strategic content gap reports.
SVG to Image Converter
A robust utility for converting vector SVG files into high-quality PNG or JPG raster images for seamless sharing and documentation within the Openclaw Skills ecosystem.
Wind & Site (Wind Rose & Data)
Fetch real-time wind data and generate professional wind roses for comprehensive site and urban climate assessments.
METADATA
Featured*
