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)