def layer_metadata(self):
zoom = self.layer_zoom or 0
value_json = self.store.wrapper.readMetadata(self.layer_name, zoom)
if value_json:
metadata_dict = json.loads(value_json)
return Metadata.from_dict(metadata_dict)
else:
raise KeyError(self.store.uri, self.layer_name, self.layer_zoom, "layer metadata")
class MaskTest(BaseTestClass):
pysc = BaseTestClass.pysc
cells = np.zeros((1, 2, 2))
cells.fill(1)
layer = [(SpatialKey(0, 0), Tile(cells, 'FLOAT', -1.0)),
(SpatialKey(1, 0), Tile(cells, 'FLOAT', -1.0,)),
(SpatialKey(0, 1), Tile(cells, 'FLOAT', -1.0,)),
(SpatialKey(1, 1), Tile(cells, 'FLOAT', -1.0,))]
rdd = pysc.parallelize(layer)
extent = {'xmin': 0.0, 'ymin': 0.0, 'xmax': 4.0, 'ymax': 4.0}
layout = {'layoutCols': 2, 'layoutRows': 2, 'tileCols': 2, 'tileRows': 2}
metadata = {'cellType': 'float32ud-1.0',
'extent': extent,
'crs': 4326,
'bounds': {
'minKey': {'col': 0, 'row': 0},
'maxKey': {'col': 1, 'row': 1}},
'layoutDefinition': {
'extent': extent,
'tileLayout': layout}}
geoms = [box(0.0, 0.0, 2.0, 2.0), box(3.0, 3.0, 4.0, 4.0)]
raster_rdd = TiledRasterLayer.from_numpy_rdd(LayerType.SPATIAL, rdd, Metadata.from_dict(metadata))
@pytest.fixture(autouse=True)
def tearDown(self):
yield
BaseTestClass.pysc._gateway.close()
def test_geotrellis_mask(self):
result = self.raster_rdd.mask(geometries=self.geoms).to_numpy_rdd()
n = result.map(lambda kv: np.sum(kv[1].cells)).reduce(lambda a, b: a + b)
self.assertEqual(n, 2.0)
def test_rdd_mask_no_partition_strategy(self):
rdd = BaseTestClass.pysc.parallelize(self.geoms)
result = self.raster_rdd.mask(rdd, options=RasterizerOptions(True, 'PixelIsArea')).to_numpy_rdd()
n = result.map(lambda kv: np.sum(kv[1].cells)).reduce(lambda a, b: a + b)
self.assertEqual(n, 2.0)
def test_rdd_mask_with_partition_strategy(self):
rdd = BaseTestClass.pysc.parallelize(self.geoms)
result = self.raster_rdd.mask(rdd, partition_strategy=SpatialPartitionStrategy()).to_numpy_rdd()
n = result.map(lambda kv: np.sum(kv[1].cells)).reduce(lambda a, b: a + b)
self.assertEqual(n, 2.0)
def collect_metadata(self,
extent=None,
layout=None,
crs=None,
tile_size=256):
"""Iterate over RDD records and generates layer metadata desribing the contained
rasters.
Args:
extent (:class:`~geopyspark.geotrellis.Extent`, optional): Specify layout extent, must
also specify ``layout``.
layout (:obj:`~geopyspark.geotrellis.TileLayout`, optional): Specify tile layout, must
also specify ``extent``.
crs (str or int, optional): Ignore CRS from records and use given one instead.
tile_size (int, optional): Pixel dimensions of each tile, if not using ``layout``.
Note:
``extent`` and ``layout`` must both be defined if they are to be used.
Returns:
:class:`~geopyspark.geotrellis.Metadata`
Raises:
TypeError: If either ``extent`` and ``layout`` is not defined but the other is.
"""
if extent and not isinstance(extent, dict):
extent = extent._asdict()
if layout and not isinstance(layout, dict):
layout = layout._asdict()
if not crs:
crs = ""
if isinstance(crs, int):
crs = str(crs)
if extent and layout:
json_metadata = self.srdd.collectMetadata(extent, layout, crs)
elif not extent and not layout:
json_metadata = self.srdd.collectMetadata(str(tile_size), crs)
else:
raise TypeError("Could not collect metadata with {} and {}".format(
extent, layout))
return Metadata.from_dict(json.loads(json_metadata))
def read_layer_metadata(geopysc,
rdd_type,
uri,
layer_name,
layer_zoom,
options=None,
**kwargs):
"""Reads the metadata from a saved layer without reading in the whole layer.
Args:
geopysc (:cls:`~geopyspark.GeoPyContext`): The ``GeoPyContext`` being used this session.
rdd_type (str): What the spatial type of the geotiffs are. This is
represented by the constants: ``SPATIAL`` and ``SPACETIME``.
uri (str): The Uniform Resource Identifier used to point towards the desired GeoTrellis
catalog to be read from. The shape of this string varies depending on backend.
layer_name (str): The name of the GeoTrellis catalog to be read from.
layer_zoom (int): The zoom level of the layer that is to be read.
options (dict, optional): Additional parameters for reading the layer for specific backends.
The dictionary is only used for ``Cassandra`` and ``HBase``, no other backend requires
this to be set.
numPartitions (int, optional): Sets RDD partition count when reading from catalog.
**kwargs: The optional parameters can also be set as keywords arguments. The keywords must
be in camel case. If both options and keywords are set, then the options will be used.
Returns:
:class:`~geopyspark.geotrellis.Metadata`
"""
if options:
options = options
elif kwargs:
options = kwargs
else:
options = {}
_construct_catalog(geopysc, uri, options)
cached = _mapped_cached[uri]
if rdd_type == SPATIAL:
metadata = cached.store.metadataSpatial(layer_name, layer_zoom)
else:
metadata = cached.store.metadataSpaceTime(layer_name, layer_zoom)
return Metadata.from_dict(json.loads(metadata))
def read_layer_metadata(layer_type,
uri,
layer_name,
layer_zoom,
options=None,
**kwargs):
"""Reads the metadata from a saved layer without reading in the whole layer.
Args:
layer_type (str or :class:`geopyspark.geotrellis.constants.LayerType`): What the spatial type
of the geotiffs are. This is represented by either constants within ``LayerType`` or by
a string.
uri (str): The Uniform Resource Identifier used to point towards the desired GeoTrellis
catalog to be read from. The shape of this string varies depending on backend.
layer_name (str): The name of the GeoTrellis catalog to be read from.
layer_zoom (int): The zoom level of the layer that is to be read.
options (dict, optional): Additional parameters for reading the layer for specific backends.
The dictionary is only used for ``Cassandra`` and ``HBase``, no other backend requires
this to be set.
**kwargs: The optional parameters can also be set as keywords arguments. The keywords must
be in camel case. If both options and keywords are set, then the options will be used.
Returns:
:class:`~geopyspark.geotrellis.Metadata`
"""
options = options or kwargs or {}
_construct_catalog(get_spark_context(), uri, options)
cached = _mapped_cached[uri]
if layer_type == LayerType.SPATIAL:
metadata = cached.store.metadataSpatial(layer_name, layer_zoom)
else:
metadata = cached.store.metadataSpaceTime(layer_name, layer_zoom)
return Metadata.from_dict(json.loads(metadata))
def layer_metadata(self):
"""Layer metadata associated with this layer."""
return Metadata.from_dict(json.loads(self.srdd.layerMetadata()))