irradpy2 0.2.2__tar.gz

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.2.2
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,109 @@
1
+ # irrapy2
2
+
3
+ **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).
4
+
5
+ The package provides a unified interface to several international radiation networks:
6
+
7
+ - **BSRN** – Baseline Surface Radiation Network
8
+ - **MIDC (NREL)** – Measurement & Instrumentation Data Center
9
+ - **SAURAN** – Southern African Universities Radiometric Network
10
+ - **SRML** – Solar Radiation Monitoring Laboratory (UOregon)
11
+ - **SURFRAD (NOAA)** – Surface Radiation Budget Network
12
+ - **SOLRAD (NOAA)** – Solar Radiation Network
13
+
14
+ It also includes a built-in forecasting tool for solar irradiance time series.
15
+
16
+ ---
17
+
18
+ ## 📦 Installation
19
+
20
+ ```bash
21
+ pip install irrapy2
22
+ ```
23
+
24
+ ---
25
+
26
+ ## 🚀 Quick Start
27
+
28
+ ### Download BSRN data
29
+
30
+ ```python
31
+ from irrapy2 import download_bsrn
32
+
33
+ download_bsrn(
34
+ site="cab",
35
+ start="2023-01-01",
36
+ end="2023-01-31",
37
+ username="your_bsrn_username",
38
+ password="your_bsrn_password",
39
+ save_path="bsrn_out.csv"
40
+ )
41
+ ```
42
+
43
+ ### Download MIDC data
44
+
45
+ ```python
46
+ from irrapy2 import download_midc
47
+
48
+ download_midc(
49
+ site="BMS",
50
+ begin="20230101",
51
+ end="20230131",
52
+ save_path="midc_out.csv"
53
+ )
54
+ ```
55
+
56
+ ### Forecast Solar Radiation
57
+
58
+ ```python
59
+ from irrapy2 import run_forecast
60
+
61
+ metrics = run_forecast(
62
+ csv_path="bsrn_out.csv",
63
+ model="lstm", # rnn / lstm / informer
64
+ seq_len=72,
65
+ horizon=6,
66
+ epochs=10
67
+ )
68
+
69
+ print(metrics)
70
+ ```
71
+
72
+ ---
73
+
74
+ ## 📁 Supported Datasets
75
+
76
+ | Source | Region | Module | Time Handling |
77
+ |--------|--------|---------|---------------|
78
+ | BSRN | Global | `download_bsrn` | UTC |
79
+ | MIDC (NREL) | USA | `download_midc` | Local + DST + UTC |
80
+ | SAURAN | Africa | `download_sauran` | Local → UTC |
81
+ | SRML | USA | `download_srml` | America/Los_Angeles |
82
+ | SURFRAD | USA | `download_surfrad` | UTC |
83
+ | SOLRAD | USA | `download_solrad` | UTC + Local |
84
+
85
+ ---
86
+
87
+ ## 🔧 Requirements
88
+
89
+ ```
90
+ pandas
91
+ numpy
92
+ requests
93
+ pytz
94
+ torch
95
+ scikit-learn
96
+ ```
97
+
98
+ ---
99
+
100
+ ## 📄 License
101
+
102
+ This project is open-source and licensed under the **Apache License 2.0**.
103
+
104
+ ---
105
+
106
+ ## 🙌 Contributing
107
+
108
+ Issues and pull requests are welcome.
109
+ Feel free to open a PR if you want to add more stations, enhance parsing logic, or improve the forecasting module.
@@ -0,0 +1,126 @@
1
+ Metadata-Version: 2.1
2
+ Name: irradpy2
3
+ Version: 0.2.2
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,8 @@
1
+ README.md
2
+ setup.cfg
3
+ setup.py
4
+ irradpy2.egg-info/PKG-INFO
5
+ irradpy2.egg-info/SOURCES.txt
6
+ irradpy2.egg-info/dependency_links.txt
7
+ irradpy2.egg-info/requires.txt
8
+ irradpy2.egg-info/top_level.txt
@@ -0,0 +1,6 @@
1
+ pandas>=1.0
2
+ numpy>=1.18
3
+ requests>=2.25
4
+ pytz>=2020.1
5
+ torch>=1.9.0
6
+ scikit-learn>=1.0
@@ -0,0 +1,7 @@
1
+ [metadata]
2
+ description_file = README.MD
3
+
4
+ [egg_info]
5
+ tag_build =
6
+ tag_date = 0
7
+
@@ -0,0 +1,23 @@
1
+ from setuptools import setup, find_packages
2
+ setup(
3
+ name='irradpy2', # pip install irradpy2
4
+ version='0.2.2',
5
+ author='Peiyu Lin,Xixi Sun',
6
+ author_email='15958007542@163.com',
7
+ description='A unified multi-source solar radiation and ground meteorological data downloader with forecasting tools.',
8
+ long_description=open('README.md', 'r', encoding='utf-8').read(),
9
+ long_description_content_type='text/markdown',
10
+ url='https://github.com/raabitt/irradpy2',
11
+ packages=find_packages(),
12
+ license='Apache-2.0',
13
+ install_requires=[
14
+ 'pandas>=1.0',
15
+ 'numpy>=1.18',
16
+ 'requests>=2.25',
17
+ 'pytz>=2020.1',
18
+ 'torch>=1.9.0',
19
+ 'scikit-learn>=1.0',
20
+ ],
21
+ python_requires='>=3.8',
22
+ )
23
+