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,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: bdist_wheel (0.43.0)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1 @@
1
+