RadGEEToolbox 1.6.8__tar.gz → 1.6.10__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.
Files changed (21) hide show
  1. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/PKG-INFO +22 -13
  2. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/README.md +21 -12
  3. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox/LandsatCollection.py +620 -13
  4. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox/Sentinel1Collection.py +153 -7
  5. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox/Sentinel2Collection.py +595 -15
  6. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox/__init__.py +1 -1
  7. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox.egg-info/PKG-INFO +22 -13
  8. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/pyproject.toml +1 -1
  9. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/setup.py +1 -1
  10. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/LICENSE.txt +0 -0
  11. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox/CollectionStitch.py +0 -0
  12. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox/GetPalette.py +0 -0
  13. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox/VisParams.py +0 -0
  14. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox.egg-info/SOURCES.txt +0 -0
  15. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox.egg-info/dependency_links.txt +0 -0
  16. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox.egg-info/requires.txt +0 -0
  17. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/RadGEEToolbox.egg-info/top_level.txt +0 -0
  18. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/setup.cfg +0 -0
  19. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/tests/test_landsat_collection.py +0 -0
  20. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/tests/test_sentinel1_collection.py +0 -0
  21. {radgeetoolbox-1.6.8 → radgeetoolbox-1.6.10}/tests/test_sentinel2_collection.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: RadGEEToolbox
3
- Version: 1.6.8
3
+ Version: 1.6.10
4
4
  Summary: Streamlined Multispectral & SAR Analysis for Google Earth Engine Python API
5
5
  Home-page: https://github.com/radwinskis/RadGEEToolbox
6
6
  Author: Mark Radwin
@@ -37,7 +37,7 @@ Dynamic: requires-python
37
37
 
38
38
  ### [See documentation here](https://radgeetoolbox.readthedocs.io/en/latest/)
39
39
 
40
- **RadGEEToolbox** is an open-source Python package that simplifies the processing and analysis of satellite imagery using the Google Earth Engine Python API. It provides ready-to-use tools for filtering, masking, mosaicking, spectral index calculations, and extracting statistics from multispectral (Landsat, Sentinel-2) and SAR (Sentinel-1) datasets.
40
+ **RadGEEToolbox** is an open-source Python package that **simplifies the processing and analysis of satellite imagery using the Google Earth Engine Python API**. It provides **ready-to-use tools for filtering, masking, mosaicking, image/band management, spectral index calculations, and extracting statistics** from multispectral (Landsat, Sentinel-2) and SAR (Sentinel-1) datasets.
41
41
 
42
42
  Designed for both new and advanced users of Google Earth Engine, RadGEEToolbox minimizes repetitive scripting, accelerates common remote sensing workflows, and aims to maximize efficiency within the constraints of the Google Earth Engine API. Whether you’re building a time series of vegetation indices or extracting surface properties along transects, this package helps get results faster.
43
43
 
@@ -53,13 +53,16 @@ Although similar packages exist (eemont, geetools, etc.), `RadGEEToolbox` extend
53
53
  | **Area Time-series Extraction** | **YES** | NO | NO |
54
54
  | **Transect Time-series Extraction** | **YES** | NO | NO |
55
55
  | **Comprehensive Preprocessing Operations** | **YES** | **YES** | **YES** |
56
- | **Reflectance Scaling (DN to ρ)** | **YES** | **YES** | **YES** |
56
+ | **Reflectance Scaling** | **YES** | **YES** | **YES** |
57
+ | **Land Surface Temperature Calculation (Landsat)** | **YES** | NO | NO |
57
58
  | **Narrowband to Broadband Albedo Calculation** | **YES** | NO | NO |
58
59
  | **Built-in Spectral Index Calculations** | **YES** | **YES** | **YES** |
59
- | **Land Surface Temperature Calculation (Landsat)** | **YES** | NO | NO |
60
+ | **Anomaly (Deviation from Mean) Calculations** | **YES** | NO | NO |
61
+ | **Image Masking for Classified Images** | **YES** | NO | NO |
62
+ | **Merging of Multiple Collections** | **YES** | NO | NO |
60
63
  | **Image Selection by Date or Index** | **YES** | **YES** | NO |
61
64
  | **Visualization Presets/Tools** | **YES** | NO | NO |
62
-
65
+ | **Batch Export to GEE Asset** | **YES** | **YES** | **YES** |
63
66
  _________
64
67
  ## Getting Started with Google Earth Engine
65
68
 
@@ -128,12 +131,16 @@ _________
128
131
  ## Key Features
129
132
 
130
133
  - Modular tools for processing **Landsat, Sentinel-1 SAR, and Sentinel-2** imagery
131
- - Efficient filtering, masking, and mosaicking of Earth Engine image collections
134
+ - Efficient filtering, **cloud/shadow/water masking, threshold masking, spectral classification, and mosaicking** of Earth Engine image collections
135
+ - Collection management such as **collection merging and band renaming**
132
136
  - Built-in support for computing **spectral indices** (see below for complete list)
137
+ - **Temporal reductions** (mean, median, min, etc.) and **monthly median** functionality
138
+ - Image anomaly calculation
133
139
  - SAR utilities for **multilooking**, **speckle filtering**, and **backscatter conversion**
134
- - Automated and flexible extraction of **transect and zonal statistics** across image collections
140
+ - Automated and flexible extraction of **transect and zonal statistics (supporting multiple coordinates or geometries)** across image collections
135
141
  - Easy conversion between RadGEEToolbox and standard Earth Engine objects
136
142
  - Server-side–friendly workflows and caching for **faster, scalable** processing
143
+ - Automatically **batch export image collections to GEE assets**
137
144
 
138
145
  **List of all spectral index calculations available for
139
146
  Landsat (TM & OLI) and Sentinel-2 (MSI) imagery:**
@@ -158,7 +165,7 @@ Landsat (TM & OLI) and Sentinel-2 (MSI) imagery:**
158
165
 
159
166
  Features of `RadGEEToolbox` will be expanded in the future - if there is something you would like to see implemented in `RadGEEToolbox`, please open an issue or discussion on GitHub.
160
167
 
161
- 🔍 For a full breakdown of available tools, see the [RadGEEToolbox documentation »](https://radgeetoolbox.readthedocs.io/en/latest/)
168
+ 🔍 For a full breakdown of available features and tools, see the [RadGEEToolbox documentation »](https://radgeetoolbox.readthedocs.io/en/latest/)
162
169
 
163
170
  _____________
164
171
 
@@ -172,15 +179,15 @@ _____________
172
179
 
173
180
  ### Installing via pip
174
181
 
175
- To install `RadGEEToolbox` version 1.6.8 using pip (NOTE: it is recommended to create a new virtual environment):
182
+ To install `RadGEEToolbox` version 1.6.9 using pip (NOTE: it is recommended to create a new virtual environment):
176
183
 
177
184
  ```bash
178
- pip install RadGEEToolbox==1.6.8
185
+ pip install RadGEEToolbox==1.6.9
179
186
  ```
180
187
 
181
188
  ### Installing via Conda
182
189
 
183
- To install `RadGEEToolbox` version 1.6.8 using conda-forge (NOTE: it is recommended to create a new virtual environment):
190
+ To install `RadGEEToolbox` version 1.6.9 using conda-forge (NOTE: it is recommended to create a new virtual environment):
184
191
 
185
192
  ```bash
186
193
  conda install conda-forge::radgeetoolbox
@@ -211,7 +218,7 @@ To verify that `RadGEEToolbox` was installed correctly:
211
218
  python -c "import RadGEEToolbox; print(RadGEEToolbox.__version__)"
212
219
  ```
213
220
 
214
- You should see `1.6.8` printed as the version number.
221
+ You should see `1.6.9` printed as the version number.
215
222
 
216
223
  ### Want to Visualize Data? Install These Too
217
224
 
@@ -288,6 +295,7 @@ water_classification_maps = cloud_masked_collection.ndwi_collection(
288
295
  threshold=0
289
296
  )
290
297
  ```
298
+ Then, explore images from `water_classification_maps` as shown below either by exporting to a GEE asset for download, or by using `geemap` 👇
291
299
 
292
300
  ![Visualization of true color and classified water (in blue) from one of the dates in the collection](LakePowellNDWI.png)
293
301
 
@@ -302,8 +310,9 @@ calculate_water_area = cloud_masked_NDWI_collection.PixelAreaSumCollection(
302
310
  scale=90 #pixel size for zonal statistics
303
311
  )
304
312
  water_area_time_series = calculate_water_area.ExtractProperties('ndwi')
305
- print('List of square meters of water in images:', water_area_time_series)
306
313
  ```
314
+ Then, directly plot `water_area_time_series` using Matplotlib as shown below 👇
315
+
307
316
 
308
317
  ![Plotted Results from Above Example - All Processed in Less Than 5 Seconds!](LakePowellPlot.png)
309
318
 
@@ -8,7 +8,7 @@
8
8
 
9
9
  ### [See documentation here](https://radgeetoolbox.readthedocs.io/en/latest/)
10
10
 
11
- **RadGEEToolbox** is an open-source Python package that simplifies the processing and analysis of satellite imagery using the Google Earth Engine Python API. It provides ready-to-use tools for filtering, masking, mosaicking, spectral index calculations, and extracting statistics from multispectral (Landsat, Sentinel-2) and SAR (Sentinel-1) datasets.
11
+ **RadGEEToolbox** is an open-source Python package that **simplifies the processing and analysis of satellite imagery using the Google Earth Engine Python API**. It provides **ready-to-use tools for filtering, masking, mosaicking, image/band management, spectral index calculations, and extracting statistics** from multispectral (Landsat, Sentinel-2) and SAR (Sentinel-1) datasets.
12
12
 
13
13
  Designed for both new and advanced users of Google Earth Engine, RadGEEToolbox minimizes repetitive scripting, accelerates common remote sensing workflows, and aims to maximize efficiency within the constraints of the Google Earth Engine API. Whether you’re building a time series of vegetation indices or extracting surface properties along transects, this package helps get results faster.
14
14
 
@@ -24,13 +24,16 @@ Although similar packages exist (eemont, geetools, etc.), `RadGEEToolbox` extend
24
24
  | **Area Time-series Extraction** | **YES** | NO | NO |
25
25
  | **Transect Time-series Extraction** | **YES** | NO | NO |
26
26
  | **Comprehensive Preprocessing Operations** | **YES** | **YES** | **YES** |
27
- | **Reflectance Scaling (DN to ρ)** | **YES** | **YES** | **YES** |
27
+ | **Reflectance Scaling** | **YES** | **YES** | **YES** |
28
+ | **Land Surface Temperature Calculation (Landsat)** | **YES** | NO | NO |
28
29
  | **Narrowband to Broadband Albedo Calculation** | **YES** | NO | NO |
29
30
  | **Built-in Spectral Index Calculations** | **YES** | **YES** | **YES** |
30
- | **Land Surface Temperature Calculation (Landsat)** | **YES** | NO | NO |
31
+ | **Anomaly (Deviation from Mean) Calculations** | **YES** | NO | NO |
32
+ | **Image Masking for Classified Images** | **YES** | NO | NO |
33
+ | **Merging of Multiple Collections** | **YES** | NO | NO |
31
34
  | **Image Selection by Date or Index** | **YES** | **YES** | NO |
32
35
  | **Visualization Presets/Tools** | **YES** | NO | NO |
33
-
36
+ | **Batch Export to GEE Asset** | **YES** | **YES** | **YES** |
34
37
  _________
35
38
  ## Getting Started with Google Earth Engine
36
39
 
@@ -99,12 +102,16 @@ _________
99
102
  ## Key Features
100
103
 
101
104
  - Modular tools for processing **Landsat, Sentinel-1 SAR, and Sentinel-2** imagery
102
- - Efficient filtering, masking, and mosaicking of Earth Engine image collections
105
+ - Efficient filtering, **cloud/shadow/water masking, threshold masking, spectral classification, and mosaicking** of Earth Engine image collections
106
+ - Collection management such as **collection merging and band renaming**
103
107
  - Built-in support for computing **spectral indices** (see below for complete list)
108
+ - **Temporal reductions** (mean, median, min, etc.) and **monthly median** functionality
109
+ - Image anomaly calculation
104
110
  - SAR utilities for **multilooking**, **speckle filtering**, and **backscatter conversion**
105
- - Automated and flexible extraction of **transect and zonal statistics** across image collections
111
+ - Automated and flexible extraction of **transect and zonal statistics (supporting multiple coordinates or geometries)** across image collections
106
112
  - Easy conversion between RadGEEToolbox and standard Earth Engine objects
107
113
  - Server-side–friendly workflows and caching for **faster, scalable** processing
114
+ - Automatically **batch export image collections to GEE assets**
108
115
 
109
116
  **List of all spectral index calculations available for
110
117
  Landsat (TM & OLI) and Sentinel-2 (MSI) imagery:**
@@ -129,7 +136,7 @@ Landsat (TM & OLI) and Sentinel-2 (MSI) imagery:**
129
136
 
130
137
  Features of `RadGEEToolbox` will be expanded in the future - if there is something you would like to see implemented in `RadGEEToolbox`, please open an issue or discussion on GitHub.
131
138
 
132
- 🔍 For a full breakdown of available tools, see the [RadGEEToolbox documentation »](https://radgeetoolbox.readthedocs.io/en/latest/)
139
+ 🔍 For a full breakdown of available features and tools, see the [RadGEEToolbox documentation »](https://radgeetoolbox.readthedocs.io/en/latest/)
133
140
 
134
141
  _____________
135
142
 
@@ -143,15 +150,15 @@ _____________
143
150
 
144
151
  ### Installing via pip
145
152
 
146
- To install `RadGEEToolbox` version 1.6.8 using pip (NOTE: it is recommended to create a new virtual environment):
153
+ To install `RadGEEToolbox` version 1.6.9 using pip (NOTE: it is recommended to create a new virtual environment):
147
154
 
148
155
  ```bash
149
- pip install RadGEEToolbox==1.6.8
156
+ pip install RadGEEToolbox==1.6.9
150
157
  ```
151
158
 
152
159
  ### Installing via Conda
153
160
 
154
- To install `RadGEEToolbox` version 1.6.8 using conda-forge (NOTE: it is recommended to create a new virtual environment):
161
+ To install `RadGEEToolbox` version 1.6.9 using conda-forge (NOTE: it is recommended to create a new virtual environment):
155
162
 
156
163
  ```bash
157
164
  conda install conda-forge::radgeetoolbox
@@ -182,7 +189,7 @@ To verify that `RadGEEToolbox` was installed correctly:
182
189
  python -c "import RadGEEToolbox; print(RadGEEToolbox.__version__)"
183
190
  ```
184
191
 
185
- You should see `1.6.8` printed as the version number.
192
+ You should see `1.6.9` printed as the version number.
186
193
 
187
194
  ### Want to Visualize Data? Install These Too
188
195
 
@@ -259,6 +266,7 @@ water_classification_maps = cloud_masked_collection.ndwi_collection(
259
266
  threshold=0
260
267
  )
261
268
  ```
269
+ Then, explore images from `water_classification_maps` as shown below either by exporting to a GEE asset for download, or by using `geemap` 👇
262
270
 
263
271
  ![Visualization of true color and classified water (in blue) from one of the dates in the collection](LakePowellNDWI.png)
264
272
 
@@ -273,8 +281,9 @@ calculate_water_area = cloud_masked_NDWI_collection.PixelAreaSumCollection(
273
281
  scale=90 #pixel size for zonal statistics
274
282
  )
275
283
  water_area_time_series = calculate_water_area.ExtractProperties('ndwi')
276
- print('List of square meters of water in images:', water_area_time_series)
277
284
  ```
285
+ Then, directly plot `water_area_time_series` using Matplotlib as shown below 👇
286
+
278
287
 
279
288
  ![Plotted Results from Above Example - All Processed in Less Than 5 Seconds!](LakePowellPlot.png)
280
289