A comprehensive solar panel planning and analysis system with modern GUI
This project is developed for hobby purposes only. Calculations, prices, and recommendations are not accurate and should not be used for real investment decisions. Please seek professional consultation.
- Features
- Installation
- Usage
- Screenshots
- Technical Details
- Project Structure
- Market Pricing
- Contributing
- License
- Modern Dark UI: Clean and modern interface built with CustomTkinter
- Real-time Weather Data: Integration with OpenWeatherMap and NASA POWER APIs
- Economic Analysis: ROI calculations, payback period analysis
- Multiple Panel Types: Support for Monocrystalline, Polycrystalline, and Thin-film panels
- Live Preview: Real-time calculations as you type
- Market Research: Up-to-date pricing from Turkish solar panel market
- Comprehensive Reports: Detailed analysis with charts and recommendations
- Roof Optimization: Calculate optimal panel placement and configuration
-
Download the project:
cd solar-panel-planner -
Create virtual environment:
python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install dependencies:
pip install -r requirements.txt
-
Set up API keys (optional):
- Get free API key from OpenWeatherMap
- Edit
config/settings.pyand add your API key - Or use without API key (will use estimated values)
-
Run the application:
python3 -m src.gui.main_window
-
Enter your data:
- Location coordinates (latitude, longitude)
- Roof area and specifications
- Panel preferences
- Economic parameters
-
Analyze results:
- View live preview as you type
- Check detailed analysis in Analytics tab
- Read system recommendations
The application features a modern dark theme with:
- Input Panel: Easy-to-use forms for all parameters
- Live Preview: Instant calculations and warnings
- Analytics Dashboard: Comprehensive charts and metrics
- Recommendations: Smart suggestions for optimization
- Language: Python 3.10+
- GUI Framework: CustomTkinter 5.2.2
- APIs: OpenWeatherMap, NASA POWER
- Charts: Matplotlib
- Async Operations: aiohttp for non-blocking API calls
- Architecture: Modular design with services and models
solar-panel-planner/
├── src/
│ ├── models/ # Data models
│ ├── services/ # API and calculation services
│ └── gui/ # User interface
├── config/ # Configuration and settings
├── requirements.txt # Dependencies
└── README.md # This file
Last updated: August 2025
| Panel Type | Price | Efficiency |
|---|---|---|
| Monocrystalline | 14.5 TL/W | 18-22% |
| Polycrystalline | 12.0 TL/W | 15-18% |
| Thin-film | 10.5 TL/W | 10-12% |
This is a hobby project, but contributions are welcome!
This project is licensed under the MIT License - see the LICENSE file for details.
Please remember this is a hobby project. Do not use for actual solar panel investment decisions. Always consult with professional solar installers and engineers.
Bu proje tamamen hobi amaçlı geliştirilmiştir. Hesaplamalar, fiyatlar ve öneriler kesin değildir ve gerçek yatırım kararları için kullanılmamalıdır. Lütfen profesyonel danışmanlık alın.
- Özellikler
- Kurulum
- Kullanım
- Ekran Görüntüleri
- Teknik Detaylar
- Proje Yapısı
- Pazar Fiyatları
- Katkıda Bulunma
- Lisans
- Modern Koyu Arayüz: CustomTkinter ile yapılmış temiz ve modern arayüz
- Gerçek Zamanlı Hava Durumu: OpenWeatherMap ve NASA POWER API entegrasyonu
- Ekonomik Analiz: ROI hesaplamaları, yatırım geri dönüş analizi
- Çoklu Panel Türleri: Monokristalin, Polikristalin ve İnce film panel desteği
- Canlı Önizleme: Yazdığınız anda gerçek zamanlı hesaplamalar
- Pazar Araştırması: Türk güneş paneli pazarından güncel fiyatlandırma
- Kapsamlı Raporlar: Grafikler ve önerilerle detaylı analiz
- Çatı Optimizasyonu: Optimal panel yerleşimi ve konfigürasyon hesaplama
-
Projeyi indirin:
cd solar-panel-planner -
Sanal ortam oluşturun:
python3 -m venv venv source venv/bin/activate # Windows'ta: venv\Scripts\activate
-
Bağımlılıkları yükleyin:
pip install -r requirements.txt
-
API anahtarlarını ayarlayın (opsiyonel):
- OpenWeatherMap'ten ücretsiz API anahtarı alın
config/settings.pydosyasını düzenleyip API anahtarınızı ekleyin- Veya API anahtarı olmadan kullanın (tahmini değerler kullanılır)
-
Uygulamayı çalıştırın:
python3 -m src.gui.main_window
-
Verilerinizi girin:
- Konum koordinatları (enlem, boylam)
- Çatı alanı ve özellikleri
- Panel tercihleri
- Ekonomik parametreler
-
Sonuçları analiz edin:
- Yazdığınız anda canlı önizleme görün
- Analitik sekmesinde detaylı analizi kontrol edin
- Sistem önerilerini okuyun
Uygulama modern koyu tema ile şunları içerir:
- Giriş Paneli: Tüm parametreler için kullanımı kolay formlar
- Canlı Önizleme: Anlık hesaplamalar ve uyarılar
- Analitik Panosu: Kapsamlı grafikler ve metrikler
- Öneriler: Optimizasyon için akıllı öneriler
- Dil: Python 3.10+
- GUI Framework: CustomTkinter 5.2.2
- API'ler: OpenWeatherMap, NASA POWER
- Grafikler: Matplotlib
- Async İşlemler: Bloklamayan API çağrıları için aiohttp
- Mimari: Servisler ve modeller ile modüler tasarım
solar-panel-planner/
├── src/
│ ├── models/ # Veri modelleri
│ ├── services/ # API ve hesaplama servisleri
│ └── gui/ # Kullanıcı arayüzü
├── config/ # Konfigürasyon ve ayarlar
├── requirements.txt # Bağımlılıklar
└── README.md # Bu dosya
Son güncelleme: Ağustos 2025
| Panel Türü | Fiyat | Verimlilik |
|---|---|---|
| Monokristalin | 14.5 TL/W | %18-22 |
| Polikristalin | 12.0 TL/W | %15-18 |
| İnce Film | 10.5 TL/W | %10-12 |
Bu bir hobi projesidir, ancak katkılar memnuniyetle karşılanır!
Bu proje MIT Lisansı altında lisanslanmıştır - detaylar için LICENSE dosyasına bakın.
Lütfen bunun bir hobi projesi olduğunu unutmayın. Gerçek güneş paneli yatırım kararları için kullanmayın. Her zaman profesyonel güneş paneli kurulumcuları ve mühendislerle danışın.
Created by Mehmet Kahya