cartopy.io.img_nest.NestedImageCollection

class cartopy.io.img_nest.NestedImageCollection(name, crs, collections, _ancestry=None)

表示ImageCollections的复杂嵌套。

在施工时，扫描图像集以寻找祖先，从而实现快速图像查找功能。

一个复杂的（创建起来很耗时的）NestedImageCollection实例可以保存为pickle文件，然后（快速）恢复。

NestedImage Collection有一个简化的创建界面 from_configuration 了解更多细节。

参数:

• name -- 嵌套图像集合的名称。

• crs -- 天然 Projection 在所有图像收藏中。

• collections -- 一列一个或多 ImageCollection 实例.

find_images(target_domain, target_z, start_tiles=None)

一个生成器，查找与有界目标位置重叠的所有图像。

参数:

• target_domain -- A LineString 指定需要图像覆盖的目标位置的实例。

• target_z -- 目标的名称 ImageCollection 它指定所需图像的目标缩放级别（分辨率）。

• start_tiles (optional) -- 一个或多个二元组对的列表，由 ImageCollection 名称和 Img 例如，从中搜索目标图像。

返回:

generator --由一个 ImageCollection 名称和 Img instance.

classmethod from_configuration(name, crs, name_dir_pairs, glob_pattern='*.tif', img_class=<class 'cartopy.io.img_nest.Img'>)

创建一个 NestedImageCollection 给定图像集合名称和目录路径对列表的实例。

对于这个复杂对象的简单配置级别创建来说，这是非常方便的功能。

例如，要生成OS地图切片的嵌套集合：：

files = [['OS 1:1,000,000', '/directory/to/1_to_1m'],
         ['OS 1:250,000', '/directory/to/1_to_250k'],
         ['OS 1:50,000', '/directory/to/1_to_50k'],
        ]
r = NestedImageCollection.from_configuration('os',
                                             ccrs.OSGB(),
                                             files)

参数:

• name -- 的名称 NestedImageCollection instance.

• crs -- 的 Projection 图像收藏的。

• name_dir_pairs -- 图像集合名称和目录路径对的列表。

• glob_pattern (optional) -- 图像集文件名球状模式。默认为 '*.tif' .

• img_class (optional) -- 在图像集合中创建的图像类别。

返回:

A NestedImageCollection instance.

警告

图像集合名称和目录路径对的列表必须按照分辨率增加的顺序给出，即从低分辨率到高分辨率。

get_image(collection_image)

从文件中卸载目标图像的数据。

参数:

collection_image -- 包含目标的多元组对 ImageCollection 名称和 Img instance.

返回:

img_data, img.extent, img.origin --包含三个项目的元组，包括相关的图像文件数据、图像的（x_lower，x_upper，y_lower，y_upper）范围和图像原点。

备注

检索到的图像文件数据的格式由 desired_tile_form ，默认为“RB”格式。

image_for_domain(target_domain, target_z)

确定提供完全覆盖目标位置的图像。

合成图像是从覆盖目标位置的一个或多个图像区块合并并提供目标位置的完整图像覆盖。

参数:

• target_domain -- A LineString 指定需要图像覆盖的目标位置的实例。

• target_z -- 目标名称：类'~cartopy.io.IMG_nest. IMAGE Collection '，指定所需图像的目标缩放级别（分辨率）。

返回:

img, extent, origin --包含三个项的多元组，由目标位置组成 numpy.ndarray 图像数据、图像的（x-下、x-上、y-下、y-上）范围以及目标位置的原点。

subtiles(collection_image)

查找构成此父图像切片的较高分辨率图像切片。

参数:

collection_image -- 包含父对象的元组对 ImageCollection 名称和 Img instance.

返回:

iterator --包含更高分辨率子序列的多元组对的迭代器 ImageCollection 名称和 Img 组成父级的实例。