Python ArcGIS RasterCollection.filter_by_calendar_range用法及代码示例

本文简要介绍 python 语言中 arcgis.raster.RasterCollection.filter_by_calendar_range 的用法。

用法:

filter_by_calendar_range(calendar_field, start, end=None, time_field_name='StdTime', date_time_format=None, context=None)

返回：

仅包含满足过滤器的项目的 RasterCollection 对象

filter_by_calendar_range 方法通过 calendar_field 及其开始值和结束值(含)过滤 RasterCollection。

例如，如果您想选择所有具有星期一时间戳的栅格，请将 calendar_field 指定为“DAY_OF_WEEK”并将 start 和 end 设置为 1。

Parameter	Description
calendar_field	必需的字符串，“YEAR”、“MONTH”、“QUARTER”、“WEEK_OF_YEAR”、“DAY_OF_YEAR”、“DAY_OF_MONTH”、“DAY_OF_WEEK”、“HOUR”之一
start	必需的整数。 calendar_field 的起始值。例如，要过滤 1 月份收集的所有项目， filtered_rc = rc.filter_by_calendar_range(calendar_field=”MONTH”, start=1)。
end	可选整数。 calendar_field 的结束值。例如，要过滤每年前 5 天收集的所有项目， filtered_rc = rc.filter_by_calendar_range(calendar_field=”DAY_OF_YEAR”，开始=1，结束=5)
time_field_name	可选字符串。包含集合中每个项目的时间属性的字段的名称。默认为标准时间。
date_time_format	可选字符串。时间字段中值的时间格式。例如，如果输入时间值为“1990-01-31”，则date_time_format为“%Y-%m-%d”。
context	可选字典。用于控制 RasterCollection 创建的其他属性。上下文参数的默认值将与应用于父集合的上下文设置的默认值相同。 目前可用： query_boundary: This boolean value set to this option determines whether to add SHAPE field to the RasterCollection. The value in the SHAPE field represents the boundary/geometry of the raster. The query_boundary parameter is honoured only when the RasterCollection is created from a list of Rasters. True: Set query_boundary to True to add the SHAPE field to the RasterCollection. False: Set query_boundary to False to not add the SHAPE field to the RasterCollection. (Creation of RasterCollection would be faster) Example: {“query_boundary”:True}

例子：

# Usage Example 1: Filters the raster collection to hold rasters from the month of January.

filtered_rc_month = rc2.filter_by_calendar_range(calendar_field="MONTH", start=1)

# Usage Example 2: Filter the raster collection over the years 2015-2020.

filtered_rc_years = rc2.filter_by_calendar_range(calendar_field="YEAR",
                                                 start=2015,
                                                 end=2020)