mirror of
https://github.com/google/earthengine-api.git
synced 2025-12-08 19:26:12 +00:00
249 lines
9.2 KiB
Python
249 lines
9.2 KiB
Python
"""Test for the ee.geometry module."""
|
|
|
|
|
|
|
|
import unittest
|
|
|
|
import ee
|
|
from ee import apitestcase
|
|
|
|
|
|
class GeometryTest(apitestcase.ApiTestCase):
|
|
|
|
def testValid_Point(self):
|
|
"""Verifies Point constructor behavior with valid arguments."""
|
|
self.assertValid(1, ee.Geometry.Point, [1, 2])
|
|
self.assertValid(1, ee.Geometry.Point, 1, 2)
|
|
|
|
def testValid_MultiPoint(self):
|
|
"""Verifies MultiPoint constructor behavior with valid arguments."""
|
|
self.assertValid(2, ee.Geometry.MultiPoint, 1, 2, 3, 4, 5, 6)
|
|
|
|
def testValid_LineString(self):
|
|
"""Verifies LineString constructor behavior with valid arguments."""
|
|
self.assertValid(2, ee.Geometry.LineString, 1, 2, 3, 4, 5, 6)
|
|
|
|
def testValid_LinearRing(self):
|
|
"""Verifies LinearRing constructor behavior with valid arguments."""
|
|
self.assertValid(2, ee.Geometry.LinearRing, 1, 2, 3, 4, 5, 6)
|
|
|
|
def testValid_MultiLineString(self):
|
|
"""Verifies MultiLineString constructor behavior with valid arguments."""
|
|
self.assertValid(3, ee.Geometry.MultiLineString, 1, 2, 3, 4, 5, 6)
|
|
|
|
def testValid_Polygon(self):
|
|
"""Verifies Polygon constructor behavior with valid arguments."""
|
|
self.assertValid(3, ee.Geometry.Polygon, 1, 2, 3, 4, 5, 6)
|
|
|
|
def testValid_Rectangle(self):
|
|
"""Verifies Rectangle constructor behavior with valid arguments."""
|
|
self.assertValid(3, ee.Geometry.Rectangle, 1, 2, 5, 6)
|
|
|
|
def testValid_MultiPolygon(self):
|
|
"""Verifies MultiPolygon constructor behavior with valid arguments."""
|
|
self.assertValid(4, ee.Geometry.MultiPolygon, 1, 2, 3, 4, 5, 6)
|
|
|
|
def testInvalid_MultiPoint(self):
|
|
"""Verifies MultiPoint constructor behavior with invalid arguments."""
|
|
f = ee.Geometry.MultiPoint
|
|
self.assertInvalid(
|
|
f, 'Invalid number of coordinates: 5', 1, 2, 3, 4, 5)
|
|
self.assertInvalid(f, 'Invalid geometry', [1, 2, 3, 4, 5])
|
|
self.assertInvalid(f, 'Invalid geometry', [[1, 2], [3, 4], 5])
|
|
# Too many nesting levels.
|
|
self.assertInvalid(f, 'Invalid geometry', [[[1, 2], [3, 4]]])
|
|
|
|
def testInvalid_LineString(self):
|
|
"""Verifies LineString constructor behavior with invalid arguments."""
|
|
f = ee.Geometry.LineString
|
|
self.assertInvalid(
|
|
f, 'Invalid number of coordinates: 5', 1, 2, 3, 4, 5)
|
|
self.assertInvalid(f, 'Invalid geometry', [1, 2, 3, 4, 5])
|
|
self.assertInvalid(f, 'Invalid geometry', [[1, 2], [3, 4], 5])
|
|
# Too many nesting levels.
|
|
self.assertInvalid(f, 'Invalid geometry', [[[1, 2], [3, 4]]])
|
|
|
|
def testInvalid_LinearRing(self):
|
|
"""Verifies LinearRing constructor behavior with invalid arguments."""
|
|
f = ee.Geometry.LinearRing
|
|
self.assertInvalid(
|
|
f, 'Invalid number of coordinates: 5', 1, 2, 3, 4, 5)
|
|
self.assertInvalid(f, 'Invalid geometry', [1, 2, 3, 4, 5])
|
|
self.assertInvalid(f, 'Invalid geometry', [[1, 2], [3, 4], 5])
|
|
# Too many nesting levels.
|
|
self.assertInvalid(f, 'Invalid geometry', [[[1, 2], [3, 4]]])
|
|
|
|
def testInvalid_MultiLineString(self):
|
|
"""Verifies MultiLineString constructor behavior with invalid arguments."""
|
|
f = ee.Geometry.MultiLineString
|
|
self.assertInvalid(
|
|
f, 'Invalid number of coordinates: 5', 1, 2, 3, 4, 5)
|
|
self.assertInvalid(f, 'Invalid geometry', [1, 2, 3, 4, 5])
|
|
self.assertInvalid(f, 'Invalid geometry', [[1, 2], [3, 4], 5])
|
|
# Too many nesting levels.
|
|
self.assertInvalid(f, 'Invalid geometry', [[[[1, 2], [3, 4]]]])
|
|
# Bad nesting
|
|
self.assertInvalid(f, 'Invalid geometry', [[[1, 2], [3, 4]], [1, 2]])
|
|
|
|
def testInvalid_Polygon(self):
|
|
"""Verifies Polygon constructor behavior with invalid arguments."""
|
|
f = ee.Geometry.Polygon
|
|
self.assertInvalid(
|
|
f, 'Invalid number of coordinates: 5', 1, 2, 3, 4, 5)
|
|
self.assertInvalid(f, 'Invalid geometry', [1, 2, 3, 4, 5])
|
|
self.assertInvalid(f, 'Invalid geometry', [[1, 2], [3, 4], 5])
|
|
# Too many nesting levels.
|
|
self.assertInvalid(f, 'Invalid geometry', [[[[1, 2], [3, 4], [5, 6]]]])
|
|
# Bad nesting
|
|
self.assertInvalid(f, 'Invalid geometry', [[[1, 2], [3, 4]], [1, 2]])
|
|
|
|
def testInvalid_MultiPolygon(self):
|
|
"""Verifies MultiPolygon constructor behavior with invalid arguments."""
|
|
f = ee.Geometry.MultiPolygon
|
|
self.assertInvalid(f, 'Invalid number of coordinates: 5', 1, 2, 3, 4, 5)
|
|
self.assertInvalid(f, 'Invalid geometry', [1, 2, 3, 4, 5])
|
|
self.assertInvalid(f, 'Invalid geometry', [[1, 2], [3, 4], 5])
|
|
# Too many nesting levels.
|
|
self.assertInvalid(f, 'Invalid geometry', [[[[[1, 2], [3, 4], [5, 6]]]]])
|
|
# Bad nesting
|
|
self.assertInvalid(f, 'Invalid geometry', [[[[1, 2], [3, 4]], [1, 2]]])
|
|
|
|
def testArrayConstructors(self):
|
|
"""Verifies that constructors that take arrays fix nesting."""
|
|
get_coordinates_count = lambda g: len(g.toGeoJSON()['coordinates'])
|
|
|
|
point = ee.Geometry.Point([1, 2])
|
|
self.assertEquals(2, get_coordinates_count(point))
|
|
|
|
multipoint = ee.Geometry.MultiPoint([[1, 2], [3, 4], [5, 6]])
|
|
self.assertEquals(3, get_coordinates_count(multipoint))
|
|
|
|
line = ee.Geometry.LineString([[1, 2], [3, 4], [5, 6]])
|
|
self.assertEquals(3, get_coordinates_count(line))
|
|
|
|
ring = ee.Geometry.LinearRing([[1, 2], [3, 4], [5, 6]])
|
|
self.assertEquals(3, get_coordinates_count(ring))
|
|
|
|
multiline = ee.Geometry.MultiLineString(
|
|
[[[1, 2], [3, 4]],
|
|
[[5, 6], [7, 8]]])
|
|
self.assertEquals(2, get_coordinates_count(multiline))
|
|
|
|
polygon = ee.Geometry.Polygon([[[1, 2], [3, 4], [5, 6]]])
|
|
self.assertEquals(1, get_coordinates_count(polygon))
|
|
|
|
mpolygon = ee.Geometry.MultiPolygon(
|
|
[[[[1, 2], [3, 4], [5, 6]]],
|
|
[[[1, 2], [3, 4], [5, 6]]]])
|
|
self.assertEquals(2, get_coordinates_count(mpolygon))
|
|
|
|
def testGeodesicFlag(self):
|
|
"""Verifies that JSON parsing and generation preserves the geodesic flag."""
|
|
geodesic = ee.Geometry({
|
|
'type': 'LineString',
|
|
'coordinates': [[1, 2], [3, 4]],
|
|
'geodesic': True
|
|
})
|
|
projected = ee.Geometry({
|
|
'type': 'LineString',
|
|
'coordinates': [[1, 2], [3, 4]],
|
|
'geodesic': False
|
|
})
|
|
self.assertTrue(geodesic.toGeoJSON()['geodesic'])
|
|
self.assertFalse(projected.toGeoJSON()['geodesic'])
|
|
|
|
def testConstructor(self):
|
|
"""Check the behavior of the Geometry constructor.
|
|
|
|
There are 5 options:
|
|
1) A geoJSON object.
|
|
2) A not-computed geometry.
|
|
3) A not-computed geometry with overrides.
|
|
4) A computed geometry.
|
|
5) something to cast to geometry.
|
|
"""
|
|
line = ee.Geometry.LineString(1, 2, 3, 4)
|
|
|
|
# GeoJSON.
|
|
from_json = ee.Geometry(line.toGeoJSON())
|
|
self.assertEquals(from_json.func, None)
|
|
self.assertEquals(from_json._type, 'LineString')
|
|
self.assertEquals(from_json._coordinates, [[1, 2], [3, 4]])
|
|
|
|
# GeoJSON with a CRS specified.
|
|
json_with_crs = line.toGeoJSON()
|
|
json_with_crs['crs'] = {
|
|
'type': 'name',
|
|
'properties': {
|
|
'name': 'SR-ORG:6974'
|
|
}
|
|
}
|
|
from_json_with_crs = ee.Geometry(json_with_crs)
|
|
self.assertEquals(from_json_with_crs.func, None)
|
|
self.assertEquals(from_json_with_crs._type, 'LineString')
|
|
self.assertEquals(from_json_with_crs._proj, 'SR-ORG:6974')
|
|
|
|
# A not-computed geometry.
|
|
self.assertEquals(ee.Geometry(line), line)
|
|
|
|
# A not-computed geometry with an override.
|
|
with_override = ee.Geometry(line, 'SR-ORG:6974')
|
|
self.assertEquals(with_override._proj, 'SR-ORG:6974')
|
|
|
|
# A computed geometry.
|
|
self.assertEquals(ee.Geometry(line.bounds()), line.bounds())
|
|
|
|
# Something to cast to a geometry.
|
|
computed = ee.ComputedObject(ee.Function(), {'a': 1})
|
|
geom = ee.Geometry(computed)
|
|
self.assertEquals(computed.func, geom.func)
|
|
self.assertEquals(computed.args, geom.args)
|
|
|
|
def testComputedGeometries(self):
|
|
"""Verifies the computed object behavior of the Geometry constructor."""
|
|
line = ee.Geometry.LineString(1, 2, 3, 4)
|
|
bounds = line.bounds()
|
|
|
|
self.assertTrue(isinstance(bounds, ee.Geometry))
|
|
self.assertEquals(
|
|
ee.ApiFunction.lookup('Geometry.bounds'), bounds.func)
|
|
self.assertEquals(line, bounds.args['geometry'])
|
|
self.assertTrue(hasattr(bounds, 'bounds'))
|
|
|
|
def assertValid(self, nesting, ctor, *coords):
|
|
"""Checks that geometry is valid and has the expected nesting level.
|
|
|
|
Args:
|
|
nesting: The expected coordinate nesting level.
|
|
ctor: The geometry constructor function, e.g. ee.Geometry.MultiPoint.
|
|
*coords: The coordinates of the geometry.
|
|
"""
|
|
# The constructor already does a validity check.
|
|
geometry = ctor(*coords)
|
|
self.assertTrue(isinstance(geometry, ee.Geometry))
|
|
self.assertTrue(isinstance(geometry.toGeoJSON(), dict))
|
|
final_coords = geometry.toGeoJSON()['coordinates']
|
|
self.assertEquals(nesting, ee.Geometry._isValidCoordinates(final_coords))
|
|
|
|
def assertInvalid(self, ctor, msg, *coords):
|
|
"""Verifies that geometry is invalid.
|
|
|
|
Calls the given constructor with whatever arguments have been passed,
|
|
and verifies that the given error message is thrown.
|
|
|
|
Args:
|
|
ctor: The geometry constructor function, e.g. ee.Geometry.MultiPoint.
|
|
msg: The expected error message in the thrown exception.
|
|
*coords: The coordinates of the geometry.
|
|
"""
|
|
try:
|
|
ctor(*coords)
|
|
except ee.EEException as e:
|
|
self.assertTrue(msg in str(e))
|
|
else:
|
|
self.fail('Expected an exception.')
|
|
|
|
|
|
if __name__ == '__main__':
|
|
unittest.main()
|