Documentation
Welcome to the SolarAI Pro documentation. This guide will help you understand and use all 20 AI features of our comprehensive solar analysis platform.
SolarAI Pro is a comprehensive solar feasibility analysis tool powered by OpenAI GPT-4o, Google Gemini, and Groq AI. It combines satellite imagery, 20 AI-powered analysis features, and real-time vendor data to help you plan your solar installation.
Quick Start Guide
Follow these steps to get your first solar analysis in under 5 minutes:
Navigate to Dashboard
Click "Dashboard" in the navigation bar or the "Get Started" button to access the solar analysis tool.
Find Your Location
Use the search bar or zoom/pan the map to locate your property. The map uses HD satellite imagery.
Draw Your Rooftop
Click the polygon tool (pentagon icon) and draw around your rooftop. Click each corner, then close the shape.
Calculate Feasibility
Click "Calculate Solar Feasibility" to get instant results including capacity, cost, and savings estimates.
Explore AI Features
After calculation, use the AI Analysis Panel to detect obstacles, optimize layout, and get AI explanations.
System Requirements
| Component | Requirement |
|---|---|
| Browser | Chrome, Firefox, Edge (latest versions) |
| Internet | Stable connection for satellite imagery |
| JavaScript | Must be enabled |
| Screen | 1024px+ width recommended |
Map & Drawing Tools
The interactive map is powered by Leaflet.js with multiple satellite imagery providers.
Map Layers
- Google Satellite - High-resolution imagery (default)
- ESRI World Imagery - Alternative satellite view
- Bing Aerial - Microsoft's satellite imagery
- AI Enhanced - Super-resolution processing for clearer views
- Roof Edge AI - Sobel edge detection overlay
Drawing Controls
- Polygon Tool - Draw rooftop boundary (required for analysis)
- Rectangle Tool - Quick rectangular selection
- Edit - Modify existing drawings
- Delete - Remove drawn shapes
Draw accurately around your rooftop edges for best results. The calculated area directly affects all estimates.
Solar Analysis
The core calculation engine analyzes your drawn area and provides comprehensive results with location-based irradiance data for 10 Indian cities.
Output Metrics
| Metric | Description |
|---|---|
| Actual Area | Total rooftop area in square meters |
| Usable Area | 70% of actual area (accounting for spacing) |
| System Capacity | Kilowatt capacity based on panel technology |
| Daily Generation | Expected kWh per day with temperature derating |
| 25-Year Projection | Lifetime generation with degradation modeling |
| Monthly/Yearly Savings | Based on your electricity rate |
Panel Technologies
- Mono PERC - 21% efficiency, standard choice
- TOPCon - 22.5% efficiency, premium option
- HJT - 23% efficiency, best temperature performance
- Bifacial - 21.5% efficiency + 10% rear gain
Hardware Quote System
Get detailed Bill of Materials with real product pricing from verified vendors.
Components Included
- Solar Panels - 540-545W panels from Waaree, Adani, Jinko, Tata, Vikram
- Inverters - String inverters with MPPT configuration from Sungrow, GoodWe, Huawei
- Mounting Structure - HDG/Aluminum RCC mounting with cable sizing
- Electrical - DCDB, ACDB, cabling, earthing
- Battery Storage - Optional lithium battery backup
- Installation - Labor, commissioning, net-metering
AI Obstacle Detection
Uses AI to identify common rooftop obstacles that may affect panel placement.
Detected Obstacles
- Water tanks (overhead/underground)
- AC outdoor units
- Exhaust vents and chimneys
- Staircase headrooms
- Satellite dishes and antennas
- Parapet walls and skylights
API Reference
SolarAI Pro exposes RESTful API endpoints for all AI features and core functionality.
Core Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /coords | POST | Calculate solar feasibility from polygon |
| /hardware_quote | POST | Generate hardware BOM and pricing |
| /generate_rfq_email | POST | Generate vendor RFQ emails |
| /catalog | GET | Get product catalog |
| /realtime_products | GET | Fetch live product listings |
AI Analysis Endpoints
| Endpoint | Method | AI Feature |
|---|---|---|
| /detect_obstacles | POST | AI Obstacle Detection |
| /optimize_usable_area | POST | AI Usable Area Optimizer |
| /generate_panel_layout | POST | AI Panel Layout Generator |
| /tilt_advisor | POST | AI Tilt & Orientation Advisor |
| /explain_calculation | POST | AI Calculation Explainer |
| /validate_input | POST | AI Input Validation |
| /classify_roof_type | POST | AI Roof Type Classification |
| /estimate_structural_risk | POST | AI Structural Load Estimator |
| /analyze_shape_efficiency | POST | AI Shape Efficiency Analyzer |
| /estimate_shading | POST | AI Shading Probability Estimator |
| /seasonal_yield | POST | AI Seasonal Yield Adjuster |
| /optimize_spacing | POST | AI Panel Spacing Optimizer |
| /confidence_score | POST | AI Confidence Score Generator |
| /suitability_score | POST | AI Rooftop Suitability Score |
| /safety_compliance | POST | AI Safety & Compliance Reminder |
| /generate_summary | POST | AI Human-Readable Summary |
LLM Integration
SolarAI Pro supports multiple AI providers for intelligent analysis. Choose the best model for your needs.
Supported Providers
| Provider | Models | Best For |
|---|---|---|
| OpenAI | GPT-4o, GPT-4o Mini, GPT-4 Turbo, O1 Preview | Best quality & reasoning |
| Gemini | gemini-2.5-flash | Complex reasoning (default) |
| Groq | Llama 3.3 70B, DeepSeek R1, Mixtral 8x7B, Qwen 3 32B | Fast inference |
Use the "AI Provider" dropdown in the dashboard to switch between OpenAI, Gemini, and Groq. Each provider has different strengths - OpenAI for quality, Gemini for reasoning, Groq for speed.
Advanced AI Features
These advanced AI features provide deep analysis for professional solar installations.
Roof Type Classification
Classifies roof material (RCC flat, metal sheet, tile, asbestos) with mounting recommendations.
Structural Load Estimator
Calculates total system weight (23kg/panel + 15kg mounting) and estimates load risk.
Shape Efficiency Analyzer
Analyzes polygon rectangularity using bounding box ratio. Scores 0-100% efficiency.
Shading Probability Estimator
Estimates shading risk based on location type, orientation, with temporal analysis (morning/midday/afternoon).
Seasonal Yield Adjuster
Calculates generation variations across summer (+10%), monsoon (-25%), autumn (+5%), winter (-5%).
Panel Spacing Optimizer
Optimal row spacing using formula: panel_height x tan(90 - solar_altitude).
Confidence Score Generator
Rates analysis reliability 0-100% with component breakdown for area, layout, capacity, cost, generation.
Rooftop Suitability Score
Composite 0-100 score with letter grade (A+ to F) combining all factors.
Safety & Compliance Reminder
Safety reminders with clearance requirements: parapet height, edge setback, fire pathways.
Human-Readable Summary
Comprehensive summary with headline, quick stats, key findings, and actionable next steps.
All AI-generated analyses are estimates only. Always consult a certified structural engineer for load assessments and a licensed solar installer for final system design.