earthengine-api 1.7.4rc0__py3-none-any.whl → 1.7.6rc0__py3-none-any.whl

{earthengine_api-1.7.4rc0.dist-info → earthengine_api-1.7.6rc0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: earthengine-api
-Version: 1.7.4rc0
+Version: 1.7.6rc0
 Summary: Earth Engine Python API
 Author-email: Google LLC <noreply@google.com>
 License: Apache-2.0
@@ -17,6 +17,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python
 Classifier: Topic :: Multimedia :: Graphics :: Viewers
 Classifier: Topic :: Scientific/Engineering :: GIS

{earthengine_api-1.7.4rc0.dist-info → earthengine_api-1.7.6rc0.dist-info}/RECORD

@@ -1,12 +1,12 @@
-earthengine_api-1.7.4rc0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-ee/__init__.py,sha256=cAFwasoE1dRv4xMWbngK9cNyli40GXPu9Qd1qPdvww0,16761
+earthengine_api-1.7.6rc0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+ee/__init__.py,sha256=kJD90XMz4r8gPGSqpClIrCNlpR9hOWzy2PzuwRTXkPw,16762
 ee/_arg_types.py,sha256=nrJrnPFnAS8fzMxAGmG3TbUOi_yFVrnSGW5IP8ATzDQ,2662
 ee/_cloud_api_utils.py,sha256=5WPzP5bcBIbjA7yYN-Cwmht_HU-XobbTrZvRiOEn0e0,32890
 ee/_helpers.py,sha256=afDDqoz1WESKE-lzqLtrCbvoQ1yVpfvJIgFcmUjO4L8,4821
 ee/_state.py,sha256=y2hdq_ZEgFkO9a-DbWFSthehlAyTbp--cz4C04XS058,2754
 ee/_utils.py,sha256=ciocjvlvR73G07IV_iZjLi1IGowpEbT53NzFqqwSbDU,1356
 ee/apifunction.py,sha256=mCCsLhBs_MofvMW49OFjT5psQGMbXWQSpAlhiqMEc4k,8732
-ee/apitestcase.py,sha256=8N5y2-Tw7c5GjedbSA_HRpSjVUiVLoyM_FI2g5b9Tpc,13992
+ee/apitestcase.py,sha256=NjCqAcmM031zdFkBitLrJ4TbUV3lx1EKr8prZadzGKY,13614
 ee/batch.py,sha256=pyhSmwH6hApRgdA8x6qbFn-mMEM8G-zf3OHW5PMziQI,82694
 ee/blob.py,sha256=cnnqmrHl998U2zEmfKcxQglaGk14Ip6pjObk_Ody6Uk,3221
 ee/classifier.py,sha256=3STLrLT6Ddwzjs2324E02wRWM8VEpeifgOO81geTHJQ,23410
@@ -15,7 +15,7 @@ ee/collection.py,sha256=c8OFIX9OVLxTbu8HGYiHOS3Yg6QjnxaO_FAhDhDQpic,32588
 ee/computedobject.py,sha256=Cdlccd4vw2neeRQlo5Jn3Q5R-VpQcQufNuxOHfpd1FU,9186
 ee/confusionmatrix.py,sha256=e6vz-FcT6acWxk5pDEK0vLIN1pUjYMh5Gyn1QSGJT3I,4233
 ee/customfunction.py,sha256=Me_iHDnjkYR33JMttGA7pKJlPCjUk8rO_kgaIhDm27M,7408
-ee/data.py,sha256=TmtDZZXVJxKOVPNSabQ9DxtYALn1BXUHiZJKXzVL6w4,85371
+ee/data.py,sha256=nuebPtBm3rBZMHGqxakSZmskDGFA52aip-9zOmXwBL0,85374
 ee/daterange.py,sha256=nrRYkR2M2aVU0ZJyG7yiZStFt-W2TvYVuazoZK_WZqM,4948
 ee/deprecation.py,sha256=mAFdO7fBjOu9TJd8CJB_M_NsZ6VNSxtSe820QKJx8fE,6243
 ee/deserializer.py,sha256=TjhQjcBnFpz8Kodoj74eSbvkJ2zLjpTTfUpcNEoQR2o,8357
@@ -35,7 +35,7 @@ ee/featurecollection.py,sha256=XbDgzYEEyhim0_y2AOD5Wi-TRIl90OnB1DHtAJXgvg8,14424
 ee/filter.py,sha256=GKz3IqeZSrK4X26TjWaw_uOE8KjZgSx1pS1zM07PXfI,35321
 ee/function.py,sha256=X-Mz0AvF_l809NZXK8RM6fa2h-nP7YU2sUFp6hvIbdU,7049
 ee/geometry.py,sha256=D__UeT72DDaJFakmyaPnmfHwxNtDxLJW7Vbze0Hh2Y4,59517
-ee/image.py,sha256=LDidnOBIQaZ1Rv9X8H6DcNUzClRYxXcy2lHGoe5L6pA,170921
+ee/image.py,sha256=8ErloWEwLZZRHgwf5SHITnMvRAawPZtGC6Kfq-jCTK8,170923
 ee/image_converter.py,sha256=LblcmkWruE0BjItZ7ICv87XZlCCjZeX2HmGxf47HXyo,1469
 ee/imagecollection.py,sha256=5ZUUreU0iY23UC9sd8gh8fLapVZTruV3DGhsjmQF0xg,27102
 ee/join.py,sha256=idnuzRNFvKHRLHV5m9unp_xTsZb-E2kfgUCEYSg64ts,7578
@@ -59,7 +59,7 @@ ee/tests/_cloud_api_utils_test.py,sha256=p8kwehArlj_j4HWsx6vNEk2Dw17MlxYw0Xtzups
 ee/tests/_helpers_test.py,sha256=vyhbY9hE_zcSI692eAdjtM36P2vVXScDj_ENA-0tces,3991
 ee/tests/_state_test.py,sha256=AKe5Vopzt24FJPiPcEce_oOT861gOkd6mUOAWZr6C0g,1175
 ee/tests/_utils_test.py,sha256=bOarVj3U-VFo9Prog8WQN_hAOMwJOiWKJxevUbdFPBQ,2753
-ee/tests/algorithms.json,sha256=Vx1Kx_MhHv0z0B3WTeVAvchM8xVd3zYE7L-qT3gDGzA,729368
+ee/tests/algorithms.json,sha256=ZBtpcCEmCa7NMAIfdaqBSQgLOak1kca8nOuo7Md5lV4,731263
 ee/tests/apifunction_test.py,sha256=_6xpkJOd7hScYYQxzFR-8flraTQ6xfkm7gyER6JoBog,3779
 ee/tests/batch_test.py,sha256=NhR5CsNNSbuMgrmJWoc0grn7gjmlUY37oMIXCwA2T-0,65116
 ee/tests/blob_test.py,sha256=uCrM-ubRfAmNgHwhmUhWn7MiXqbNQutybcXIKdVsD_Q,3587
@@ -102,8 +102,8 @@ ee/tests/reducer_test.py,sha256=vqXpgLZ7fPyfZ12srpREgMpfrKYLcFQod3Qn1Niv7VM,3197
 ee/tests/serializer_test.py,sha256=d6IEW_dt-G900IRfQnZftrwjpc1wJ-ouaQQwaLO0FxI,9834
 ee/tests/table_converter_test.py,sha256=t4yIfy40R3U17I_2nVtKm_Q2Tae-UifwZLz8qOmoC9A,5091
 ee/tests/terrain_test.py,sha256=inZ2sy807nDG_HMutzGHaqcTUaLnZQOMdWyf0NrQzV0,4561
-earthengine_api-1.7.4rc0.dist-info/METADATA,sha256=zPP40I_9hFvGlmzpvwPbkZIFk1M-EUL1kKlwECKMrLg,2147
-earthengine_api-1.7.4rc0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-earthengine_api-1.7.4rc0.dist-info/entry_points.txt,sha256=-Ax4SCU-S474r8OD2LIxata6PRmkZoDrppQ4fP_exNc,50
-earthengine_api-1.7.4rc0.dist-info/top_level.txt,sha256=go5zOwCgm5lIS3yTR-Vsxp1gNI4qdS-MP5eY-7zMxVY,3
-earthengine_api-1.7.4rc0.dist-info/RECORD,,
+earthengine_api-1.7.6rc0.dist-info/METADATA,sha256=cbAGvMvXxaqqWiips3G4XthSK1iNGoIIF-2U-6PnsU0,2198
+earthengine_api-1.7.6rc0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+earthengine_api-1.7.6rc0.dist-info/entry_points.txt,sha256=-Ax4SCU-S474r8OD2LIxata6PRmkZoDrppQ4fP_exNc,50
+earthengine_api-1.7.6rc0.dist-info/top_level.txt,sha256=go5zOwCgm5lIS3yTR-Vsxp1gNI4qdS-MP5eY-7zMxVY,3
+earthengine_api-1.7.6rc0.dist-info/RECORD,,

ee/__init__.py

@@ -1,6 +1,6 @@
 """The EE Python library."""
 
-__version__ = '1.7.4rc0'
+__version__ = '1.7.6rc0'
 
 # Using lowercase function naming to match the JavaScript names.
 # pylint: disable=g-bad-name
@@ -179,7 +179,7 @@ def Initialize(
     credentials: OAuth2 credentials. 'persistent' (default) means use
       credentials already stored in the filesystem, or raise an explanatory
       exception guiding the user to create those credentials.
-    url: The base url for the EarthEngine REST API to connect to.
+    url: The base url for the Earth Engine REST API to connect to.
     cloud_api_key: An optional API key to use the Cloud API.
     http_transport: The http transport method to use when making requests.
     project: The client project ID or number to use when making API calls.

ee/apitestcase.py

@@ -89,7 +89,6 @@ class ApiTestCase(unittest.TestCase):
     ee.data.computeValue = lambda x: {'value': 'fakeValue'}
     ee.data.getMapId = self._MockMapId
     ee.data.getDownloadId = self._MockDownloadUrl
-    ee.data.getThumbId = self._MockThumbUrl
     ee.data.getTableDownloadId = self._MockTableDownload
     # pylint: disable-next=protected-access
     ee.deprecation._FetchDataCatalogStac = self._MockFetchDataCatalogStac
@@ -104,17 +103,6 @@ class ApiTestCase(unittest.TestCase):
     self.last_download_call = {'url': '/download', 'data': params}
     return {'docid': '1', 'token': '2'}
 
-  def _MockThumbUrl(
-      self,
-      params: dict[str, Any],
-      # pylint: disable-next=invalid-name
-      thumbType: str | None = None,
-  ) -> dict[str, str]:
-    del thumbType  # Unused.
-    # Hang on to the call arguments.
-    self.last_thumb_call = {'url': '/thumb', 'data': params}
-    return {'thumbid': '3', 'token': '4'}
-
   def _MockTableDownload(self, params: dict[str, Any]) -> dict[str, str]:
     self.last_table_call = {'url': '/table', 'data': params}
     return {'docid': '5', 'token': '6'}

ee/data.py

@@ -143,9 +143,9 @@ def initialize(
 
   Args:
     credentials: The OAuth2 credentials.
-    api_base_url: The EarthEngine REST API endpoint.
-    tile_base_url: The EarthEngine REST tile endpoint.
-    cloud_api_base_url: The EarthEngine Cloud API endpoint.
+    api_base_url: The Earth Engine REST API endpoint.
+    tile_base_url: The Earth Engine REST tile endpoint.
+    cloud_api_base_url: The Earth Engine Cloud API endpoint.
     cloud_api_key: The API key to use with the Cloud API.
     project: The client project ID or number to use when making API calls.
     http_transport: The http transport to use

ee/image.py

@@ -57,8 +57,8 @@ class Image(element.Element):
 
     Args:
       args: This constructor accepts a variety of arguments:
-          - A string - an EarthEngine asset id,
-          - A string and a number - an EarthEngine asset id and version,
+          - A string - an Earth Engine asset id,
+          - A string and a number - an Earth Engine asset id and version,
           - A number - creates a constant image,
           - An ee.Array - creates a constant array image,
           - A list - creates an image out of each element of the array and

ee/tests/algorithms.json

@@ -615,7 +615,7 @@
     }]
   }, {
     "name": "algorithms/TemporalSegmentation.C2c",
-    "description": "An implementation of the Composite 2 Change (C2C) algorithm. This algorithm segments a time series using a piecewise linear fit with the minimum of segments required to fit the data within the given maximum root mean squared error (RMSE).  For every band given the algorithm will return the following bands:\n    changeDate:A 1D array of doubles representing pairs of start and end dates for each fitted segment. The date format is determined by the dateFormat argument.\n    value: A 1D array of doubles of the value of the band at the changeDate.\n    magnitude: A 1D array of doubles providing the absolute difference between the values before and after a change date.  The first magnitude is always NaN.\n    duration: A 1D array of doubles of the duration of the segment preceding the change date.  The first duration is always NaN.\n    rate: A 1D array of doubles of the rate of change of the data preceding the. change date. The first rate is always NaN.\n    postMagnitude: A 1D array of doubles of the absolute difference between the values after the change date and the value at the change date.  The last postMagnitude is always NaN.\n    postDuration: The duration of the segment following the change date. The last postDuration is always NaN.\n    postRate: The rate of change of the data following the change date. The last postRate is always NaN.\n See Hermosilla et al. (2015) dx.doi.org/10.1016/j.rse.2014.11.005 for further details on the original algorithm.\n This algorithm is in preview and is subject to change.",
+    "description": "An implementation of the Composite 2 Change (C2C) algorithm. This algorithm segments a time series using a piecewise linear fit with the minimum of segments required to fit the data within the given maximum root mean squared error (RMSE).  For every band given the algorithm will return the following bands:\n    changeDate:A 1D array of doubles representing pairs of start and end dates for each fitted segment. The date format is determined by the dateFormat argument.\n    value: A 1D array of doubles of the value of the band at the changeDate.\n    magnitude: A 1D array of doubles providing the absolute difference between the values before and after a change date.  The first magnitude is always NaN.\n    duration: A 1D array of doubles of the duration of the segment preceding the change date.  The first duration is always NaN.\n    rate: A 1D array of doubles of the rate of change of the data preceding the. change date. The first rate is always NaN.\n    postMagnitude: A 1D array of doubles of the absolute difference between the values after the change date and the value at the change date.  The last postMagnitude is always NaN.\n    postDuration: The duration of the segment following the change date. The last postDuration is always NaN.\n    postRate: The rate of change of the data following the change date. The last postRate is always NaN.\n    indexRegrowth: The difference between the value in change date and the value five data points after.\n    recoveryIndicator: The indexRegrowth/magnitude ratio.\n    regrowth60: Time difference between breakpoint and the  data point where the series value is 60% of the pre-distrubance value.\n    regrowth60: Time difference between breakpoint and the  data point where the series value is 80% of the pre-distrubance value.\n    regrowth60: Time difference between breakpoint and the  data point where the series value is 100% of the pre-distrubance value.\n See: Hermosilla et al. (2015) dx.doi.org/10.1016/j.rse.2014.11.005 for further details on the original algorithm.\n Algorithm implementation can be found on GitHub: https://github.com/saveriofrancini/C2C-GEE\n Acknowledgements: FORWARDS and NextGenCarbon.\n Citation: Txomin Hermosilla, Michael A. Wulder, Joanne C. White, Nicholas C. Coops, Daniel Coelho, Giovanni Ciatto, Noel Gorelick, and Saverio Francini. In preparation. Image compositing, time-series change detection and temporal metrics: Implementation of the Composite2Change (C2C) algorithm on Google Earth Engine.   This algorithm is in preview and is subject to change.",
     "returnType": "Image\u003cunknown bands\u003e",
     "arguments": [{
       "argumentName": "collection",
@@ -657,6 +657,26 @@
       "type": "Float",
       "optional": true,
       "defaultValue": 0.85
+    }, {
+      "argumentName": "includePostMetrics",
+      "type": "Boolean",
+      "optional": true,
+      "defaultValue": true
+    }, {
+      "argumentName": "includeRegrowth",
+      "type": "Boolean",
+      "optional": true,
+      "defaultValue": false
+    }, {
+      "argumentName": "useRelativeRegrowth",
+      "type": "Boolean",
+      "optional": true,
+      "defaultValue": false
+    }, {
+      "argumentName": "negativeMagnitudeOnly",
+      "type": "Boolean",
+      "optional": true,
+      "defaultValue": false
     }]
   }, {
     "name": "algorithms/TemporalSegmentation.StructuralChangeBreakpoints",
@@ -9496,6 +9516,16 @@
       "type": "String",
       "description": "The Cloud Storage URI of the GeoTIFF to load. The bucket metadata must be accessible (requires the `storage.buckets.get` permission which is provided by the role \"Storage Legacy Bucket Reader\" among others, see https://cloud.google.com/storage/docs/access-control/iam-roles) and the bucket must be located in the US multi-region, a dual-region including US-CENTRAL1, or the US-CENTRAL1 region."
     }]
+  }, {
+    "name": "algorithms/Image.loadMosaic",
+    "description": "Loads a mosaic metadata file as an Image.",
+    "returnType": "Image\u003cunknown bands\u003e",
+    "arguments": [{
+      "argumentName": "uri",
+      "type": "String",
+      "description": "The Cloud Storage URI of the mosaic metadata file to load."
+    }],
+    "hidden": true
   }, {
     "name": "algorithms/Image.loadZarrV2Array",
     "description": "Loads a Zarr v2 array as an Image. The array attributes (.zattrs) must contain the field \u0027_ARRAY_DIMENSIONS\u0027, which is a list of the names of each dimension (e.g., [\u0027time\u0027, \u0027y\u0027, \u0027x\u0027]). There must be at least two dimensions, with the final two representing Y and X respectively (e.g., [\u0027lat\u0027, \u0027lon\u0027]). The supported compression codecs are \u0027blosc\u0027, \u0027gzip\u0027, \u0027lz4\u0027, \u0027zlib\u0027, and \u0027zstd\u0027. The supported blosc meta-compression codecs are \u0027lz4\u0027, lz4hc\u0027, \u0027zlib\u0027, and \u0027zstd\u0027 (\u0027blosclz\u0027 is not supported).",
@@ -10404,7 +10434,7 @@
     }]
   }, {
     "name": "algorithms/Image.sldStyle",
-    "description": "Styles a raster input with the provided OGC SLD styling.\nPoints of note:\n * OGC SLD 1.0 and OGC SE 1.1 are supported.\n * The XML document passed in can be complete, or just the   SldRasterSymbolizer element and down.\n * Exactly one SldRasterSymbolizer is required.\n * Bands may be selected by their proper EarthEngine names or   using numeric identifiers (\"1\", \"2\", ...). Proper   EarthEngine names are tried first.\n * The Histogram and Normalize contrast stretch mechanisms are   supported.\n * The type\u003d\"values\", type\u003d\"intervals\" and type\u003d\"ramp\"   attributes for ColorMap element in SLD 1.0 (GeoServer   extensions) are supported.\n * Opacity is only taken into account when it is 0.0   (transparent). Non-zero opacity values are treated as   completely opaque.\n * The OverlapBehavior definition is currently ignored.\n * The ShadedRelief mechanism is not currently supported.\n * The ImageOutline mechanism is not currently supported.\n * The Geometry element is ignored.\nThe output image will have histogram_bandname metadata if histogram equalization or normalization is requested.",
+    "description": "Styles a raster input with the provided OGC SLD styling.\nPoints of note:\n * OGC SLD 1.0 and OGC SE 1.1 are supported.\n * The XML document passed in can be complete, or just the   SldRasterSymbolizer element and down.\n * Exactly one SldRasterSymbolizer is required.\n * Bands may be selected by their proper Earth Engine names or   using numeric identifiers (\"1\", \"2\", ...). Proper   Earth Engine names are tried first.\n * The Histogram and Normalize contrast stretch mechanisms are   supported.\n * The type\u003d\"values\", type\u003d\"intervals\" and type\u003d\"ramp\"   attributes for ColorMap element in SLD 1.0 (GeoServer   extensions) are supported.\n * Opacity is only taken into account when it is 0.0   (transparent). Non-zero opacity values are treated as   completely opaque.\n * The OverlapBehavior definition is currently ignored.\n * The ShadedRelief mechanism is not currently supported.\n * The ImageOutline mechanism is not currently supported.\n * The Geometry element is ignored.\nThe output image will have histogram_bandname metadata if histogram equalization or normalization is requested.",
     "returnType": "Image\u003cunknown bands\u003e",
     "arguments": [{
       "argumentName": "input",