irradpy2 0.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: irradpy2
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: A unified multi-source solar radiation and ground meteorological data downloader with forecasting tools.
|
|
5
|
+
Home-page: https://github.com/raabitt/irradpy2
|
|
6
|
+
Author: Peiyu Lin,Xixi Sun
|
|
7
|
+
Author-email: 15958007542@163.com
|
|
8
|
+
License: Apache-2.0
|
|
9
|
+
Requires-Python: >=3.8
|
|
10
|
+
Description-Content-Type: text/markdown
|
|
11
|
+
Requires-Dist: pandas >=1.0
|
|
12
|
+
Requires-Dist: numpy >=1.18
|
|
13
|
+
Requires-Dist: requests >=2.25
|
|
14
|
+
Requires-Dist: pytz >=2020.1
|
|
15
|
+
Requires-Dist: torch >=1.9.0
|
|
16
|
+
Requires-Dist: scikit-learn >=1.0
|
|
17
|
+
|
|
18
|
+
# irrapy2
|
|
19
|
+
|
|
20
|
+
**irrapy2** is a lightweight Python toolkit for downloading, parsing, and processing **multi-source ground-based solar radiation and meteorological datasets**, combined with a simple forecasting module (RNN / LSTM / Informer).
|
|
21
|
+
|
|
22
|
+
The package provides a unified interface to several international radiation networks:
|
|
23
|
+
|
|
24
|
+
- **BSRN** – Baseline Surface Radiation Network
|
|
25
|
+
- **MIDC (NREL)** – Measurement & Instrumentation Data Center
|
|
26
|
+
- **SAURAN** – Southern African Universities Radiometric Network
|
|
27
|
+
- **SRML** – Solar Radiation Monitoring Laboratory (UOregon)
|
|
28
|
+
- **SURFRAD (NOAA)** – Surface Radiation Budget Network
|
|
29
|
+
- **SOLRAD (NOAA)** – Solar Radiation Network
|
|
30
|
+
|
|
31
|
+
It also includes a built-in forecasting tool for solar irradiance time series.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 📦 Installation
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
pip install irrapy2
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 🚀 Quick Start
|
|
44
|
+
|
|
45
|
+
### Download BSRN data
|
|
46
|
+
|
|
47
|
+
```python
|
|
48
|
+
from irrapy2 import download_bsrn
|
|
49
|
+
|
|
50
|
+
download_bsrn(
|
|
51
|
+
site="cab",
|
|
52
|
+
start="2023-01-01",
|
|
53
|
+
end="2023-01-31",
|
|
54
|
+
username="your_bsrn_username",
|
|
55
|
+
password="your_bsrn_password",
|
|
56
|
+
save_path="bsrn_out.csv"
|
|
57
|
+
)
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Download MIDC data
|
|
61
|
+
|
|
62
|
+
```python
|
|
63
|
+
from irrapy2 import download_midc
|
|
64
|
+
|
|
65
|
+
download_midc(
|
|
66
|
+
site="BMS",
|
|
67
|
+
begin="20230101",
|
|
68
|
+
end="20230131",
|
|
69
|
+
save_path="midc_out.csv"
|
|
70
|
+
)
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### Forecast Solar Radiation
|
|
74
|
+
|
|
75
|
+
```python
|
|
76
|
+
from irrapy2 import run_forecast
|
|
77
|
+
|
|
78
|
+
metrics = run_forecast(
|
|
79
|
+
csv_path="bsrn_out.csv",
|
|
80
|
+
model="lstm", # rnn / lstm / informer
|
|
81
|
+
seq_len=72,
|
|
82
|
+
horizon=6,
|
|
83
|
+
epochs=10
|
|
84
|
+
)
|
|
85
|
+
|
|
86
|
+
print(metrics)
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## 📁 Supported Datasets
|
|
92
|
+
|
|
93
|
+
| Source | Region | Module | Time Handling |
|
|
94
|
+
|--------|--------|---------|---------------|
|
|
95
|
+
| BSRN | Global | `download_bsrn` | UTC |
|
|
96
|
+
| MIDC (NREL) | USA | `download_midc` | Local + DST + UTC |
|
|
97
|
+
| SAURAN | Africa | `download_sauran` | Local → UTC |
|
|
98
|
+
| SRML | USA | `download_srml` | America/Los_Angeles |
|
|
99
|
+
| SURFRAD | USA | `download_surfrad` | UTC |
|
|
100
|
+
| SOLRAD | USA | `download_solrad` | UTC + Local |
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## 🔧 Requirements
|
|
105
|
+
|
|
106
|
+
```
|
|
107
|
+
pandas
|
|
108
|
+
numpy
|
|
109
|
+
requests
|
|
110
|
+
pytz
|
|
111
|
+
torch
|
|
112
|
+
scikit-learn
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## 📄 License
|
|
118
|
+
|
|
119
|
+
This project is open-source and licensed under the **Apache License 2.0**.
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## 🙌 Contributing
|
|
124
|
+
|
|
125
|
+
Issues and pull requests are welcome.
|
|
126
|
+
Feel free to open a PR if you want to add more stations, enhance parsing logic, or improve the forecasting module.
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
irradpy2-0.1.0.dist-info/METADATA,sha256=RwNdZXfErY4tUiunBKJvP8Vnj3TihGDctEsS_QwY9QE,2987
|
|
2
|
+
irradpy2-0.1.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
|
|
3
|
+
irradpy2-0.1.0.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
|
|
4
|
+
irradpy2-0.1.0.dist-info/RECORD,,
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|