RadGEEToolbox 1.6.10__tar.gz → 1.7.1__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 (24) hide show
  1. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/PKG-INFO +11 -7
  2. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/README.md +10 -6
  3. radgeetoolbox-1.7.1/RadGEEToolbox/GenericCollection.py +2711 -0
  4. radgeetoolbox-1.7.1/RadGEEToolbox/GetPalette.py +169 -0
  5. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/RadGEEToolbox/LandsatCollection.py +468 -37
  6. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/RadGEEToolbox/Sentinel1Collection.py +603 -18
  7. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/RadGEEToolbox/Sentinel2Collection.py +464 -30
  8. radgeetoolbox-1.7.1/RadGEEToolbox/VisParams.py +139 -0
  9. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/RadGEEToolbox/__init__.py +3 -1
  10. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/RadGEEToolbox.egg-info/PKG-INFO +11 -7
  11. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/RadGEEToolbox.egg-info/SOURCES.txt +1 -0
  12. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/pyproject.toml +1 -1
  13. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/setup.py +1 -1
  14. radgeetoolbox-1.6.10/RadGEEToolbox/GetPalette.py +0 -120
  15. radgeetoolbox-1.6.10/RadGEEToolbox/VisParams.py +0 -221
  16. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/LICENSE.txt +0 -0
  17. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/RadGEEToolbox/CollectionStitch.py +0 -0
  18. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/RadGEEToolbox.egg-info/dependency_links.txt +0 -0
  19. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/RadGEEToolbox.egg-info/requires.txt +0 -0
  20. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/RadGEEToolbox.egg-info/top_level.txt +0 -0
  21. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/setup.cfg +0 -0
  22. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/tests/test_landsat_collection.py +0 -0
  23. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/tests/test_sentinel1_collection.py +0 -0
  24. {radgeetoolbox-1.6.10 → radgeetoolbox-1.7.1}/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.10
3
+ Version: 1.7.1
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
@@ -43,6 +43,8 @@ Designed for both new and advanced users of Google Earth Engine, RadGEEToolbox m
43
43
 
44
44
  Although similar packages exist (eemont, geetools, etc.), `RadGEEToolbox` extends functionality and provides cohesive, chainable methods for research oriented projects working with Landsat TM & OLI, Sentinel-1 SAR, and/or Sentinel-2 MSI datasets (Table 1). The ultimate goal of `RadGEEToolbox` is to make satellite image processing easier and faster for real world applications relying on the most commonly utilized remote sensing platforms.
45
45
 
46
+ As of version `1.7.1`, `RadGEEToolbox` supports any generic image collection via the `GenericCollection` module which allows for utilization of the same data management, temporal reduction, zonal statistics, and data export tools available for the `LandsatCollection`, `Sentinel1Collection`, and `Sentinel2Collection` modules. This allows users to provide their own image collection of choice, such as PRISM or MODIS data, to benefit from the tools available with `RadGEEToolbox`.
47
+
46
48
  ***Table 1.*** *Comparison of functionality between RadGEEToolbox, eemont, and geetools.*
47
49
 
48
50
  | Capability | **RadGEEToolbox** | **eemont** | **geetools** |
@@ -134,7 +136,7 @@ _________
134
136
  - Efficient filtering, **cloud/shadow/water masking, threshold masking, spectral classification, and mosaicking** of Earth Engine image collections
135
137
  - Collection management such as **collection merging and band renaming**
136
138
  - Built-in support for computing **spectral indices** (see below for complete list)
137
- - **Temporal reductions** (mean, median, min, etc.) and **monthly median** functionality
139
+ - **Temporal reductions** (mean, median, min, etc.) and **monthly median/mean/min/max** functionality
138
140
  - Image anomaly calculation
139
141
  - SAR utilities for **multilooking**, **speckle filtering**, and **backscatter conversion**
140
142
  - Automated and flexible extraction of **transect and zonal statistics (supporting multiple coordinates or geometries)** across image collections
@@ -179,15 +181,15 @@ _____________
179
181
 
180
182
  ### Installing via pip
181
183
 
182
- To install `RadGEEToolbox` version 1.6.9 using pip (NOTE: it is recommended to create a new virtual environment):
184
+ To install `RadGEEToolbox` version 1.7.1 using pip (NOTE: it is recommended to create a new virtual environment):
183
185
 
184
186
  ```bash
185
- pip install RadGEEToolbox==1.6.9
187
+ pip install RadGEEToolbox==1.7.1
186
188
  ```
187
189
 
188
190
  ### Installing via Conda
189
191
 
190
- To install `RadGEEToolbox` version 1.6.9 using conda-forge (NOTE: it is recommended to create a new virtual environment):
192
+ To install `RadGEEToolbox` version 1.7.1 using conda-forge (NOTE: it is recommended to create a new virtual environment):
191
193
 
192
194
  ```bash
193
195
  conda install conda-forge::radgeetoolbox
@@ -218,7 +220,7 @@ To verify that `RadGEEToolbox` was installed correctly:
218
220
  python -c "import RadGEEToolbox; print(RadGEEToolbox.__version__)"
219
221
  ```
220
222
 
221
- You should see `1.6.9` printed as the version number.
223
+ You should see `1.7.1` printed as the version number.
222
224
 
223
225
  ### Want to Visualize Data? Install These Too
224
226
 
@@ -258,7 +260,7 @@ from RadGEEToolbox import LandsatCollection
258
260
 
259
261
  # 2. Authenticate & Initialize GEE API
260
262
  ee.Authenticate()
261
- ee.Initialize(project='my-cloud-project-ID) #replace with your Google Cloud project ID
263
+ ee.Initialize(project='my-cloud-project-ID') #replace with your Google Cloud project ID
262
264
 
263
265
  # 3. Define study area boundary - in this case Lake Powell, Utah
264
266
  study_area = ee.Geometry.Polygon(
@@ -320,6 +322,8 @@ Then, directly plot `water_area_time_series` using Matplotlib as shown below
320
322
 
321
323
  For details about Sentinel-1 SAR and Sentinel-2 MSI modules, and all other available Landsat or cross-module functions, please refer to the [RadGEEToolbox documentation](https://radgeetoolbox.readthedocs.io/en/latest/). You can also explore [`/Example Notebooks`](https://github.com/radwinskis/RadGEEToolbox/tree/main/Example%20Notebooks) for more usage examples.
322
324
 
325
+ > NOTE for those newer to Python: when you see ***`property`*** next to the function name in the [RadGEEToolbox documentation](https://radgeetoolbox.readthedocs.io/en/latest/), you do not need to add parentheses at the end of the function when calling the function. For example: ```my_image_collection.add_date_property``` calls the `add_date_property` property function upon the `my_image_collection` image collection - no parentheses needed. All other non-property functions require one or more arguments to be specified by the user, and will require the use of parentheses to define the function arguments.
326
+
323
327
  ________
324
328
 
325
329
 
@@ -14,6 +14,8 @@ Designed for both new and advanced users of Google Earth Engine, RadGEEToolbox m
14
14
 
15
15
  Although similar packages exist (eemont, geetools, etc.), `RadGEEToolbox` extends functionality and provides cohesive, chainable methods for research oriented projects working with Landsat TM & OLI, Sentinel-1 SAR, and/or Sentinel-2 MSI datasets (Table 1). The ultimate goal of `RadGEEToolbox` is to make satellite image processing easier and faster for real world applications relying on the most commonly utilized remote sensing platforms.
16
16
 
17
+ As of version `1.7.1`, `RadGEEToolbox` supports any generic image collection via the `GenericCollection` module which allows for utilization of the same data management, temporal reduction, zonal statistics, and data export tools available for the `LandsatCollection`, `Sentinel1Collection`, and `Sentinel2Collection` modules. This allows users to provide their own image collection of choice, such as PRISM or MODIS data, to benefit from the tools available with `RadGEEToolbox`.
18
+
17
19
  ***Table 1.*** *Comparison of functionality between RadGEEToolbox, eemont, and geetools.*
18
20
 
19
21
  | Capability | **RadGEEToolbox** | **eemont** | **geetools** |
@@ -105,7 +107,7 @@ _________
105
107
  - Efficient filtering, **cloud/shadow/water masking, threshold masking, spectral classification, and mosaicking** of Earth Engine image collections
106
108
  - Collection management such as **collection merging and band renaming**
107
109
  - Built-in support for computing **spectral indices** (see below for complete list)
108
- - **Temporal reductions** (mean, median, min, etc.) and **monthly median** functionality
110
+ - **Temporal reductions** (mean, median, min, etc.) and **monthly median/mean/min/max** functionality
109
111
  - Image anomaly calculation
110
112
  - SAR utilities for **multilooking**, **speckle filtering**, and **backscatter conversion**
111
113
  - Automated and flexible extraction of **transect and zonal statistics (supporting multiple coordinates or geometries)** across image collections
@@ -150,15 +152,15 @@ _____________
150
152
 
151
153
  ### Installing via pip
152
154
 
153
- To install `RadGEEToolbox` version 1.6.9 using pip (NOTE: it is recommended to create a new virtual environment):
155
+ To install `RadGEEToolbox` version 1.7.1 using pip (NOTE: it is recommended to create a new virtual environment):
154
156
 
155
157
  ```bash
156
- pip install RadGEEToolbox==1.6.9
158
+ pip install RadGEEToolbox==1.7.1
157
159
  ```
158
160
 
159
161
  ### Installing via Conda
160
162
 
161
- To install `RadGEEToolbox` version 1.6.9 using conda-forge (NOTE: it is recommended to create a new virtual environment):
163
+ To install `RadGEEToolbox` version 1.7.1 using conda-forge (NOTE: it is recommended to create a new virtual environment):
162
164
 
163
165
  ```bash
164
166
  conda install conda-forge::radgeetoolbox
@@ -189,7 +191,7 @@ To verify that `RadGEEToolbox` was installed correctly:
189
191
  python -c "import RadGEEToolbox; print(RadGEEToolbox.__version__)"
190
192
  ```
191
193
 
192
- You should see `1.6.9` printed as the version number.
194
+ You should see `1.7.1` printed as the version number.
193
195
 
194
196
  ### Want to Visualize Data? Install These Too
195
197
 
@@ -229,7 +231,7 @@ from RadGEEToolbox import LandsatCollection
229
231
 
230
232
  # 2. Authenticate & Initialize GEE API
231
233
  ee.Authenticate()
232
- ee.Initialize(project='my-cloud-project-ID) #replace with your Google Cloud project ID
234
+ ee.Initialize(project='my-cloud-project-ID') #replace with your Google Cloud project ID
233
235
 
234
236
  # 3. Define study area boundary - in this case Lake Powell, Utah
235
237
  study_area = ee.Geometry.Polygon(
@@ -291,6 +293,8 @@ Then, directly plot `water_area_time_series` using Matplotlib as shown below
291
293
 
292
294
  For details about Sentinel-1 SAR and Sentinel-2 MSI modules, and all other available Landsat or cross-module functions, please refer to the [RadGEEToolbox documentation](https://radgeetoolbox.readthedocs.io/en/latest/). You can also explore [`/Example Notebooks`](https://github.com/radwinskis/RadGEEToolbox/tree/main/Example%20Notebooks) for more usage examples.
293
295
 
296
+ > NOTE for those newer to Python: when you see ***`property`*** next to the function name in the [RadGEEToolbox documentation](https://radgeetoolbox.readthedocs.io/en/latest/), you do not need to add parentheses at the end of the function when calling the function. For example: ```my_image_collection.add_date_property``` calls the `add_date_property` property function upon the `my_image_collection` image collection - no parentheses needed. All other non-property functions require one or more arguments to be specified by the user, and will require the use of parentheses to define the function arguments.
297
+
294
298
  ________
295
299
 
296
300