Python ArcGIS ImageryLayer.compute_stats_and_histograms用法及代碼示例

本文簡要介紹 python 語言中 arcgis.raster.ImageryLayer.compute_stats_and_histograms 的用法。

用法:

compute_stats_and_histograms(geometry, mosaic_rule=None, rendering_rule=None, pixel_size=None, time=None, process_as_multidimensional=False)

返回：

字典

compute_stats_and_histograms 方法計算給定範圍內 ImageryLayer 對象的統計數據和直方圖。

Parameter	Description
geometry	必需的 Geometry ( Polygon 或 Envelope )。定義幾何圖形的幾何圖形，在該幾何圖形中計算統計數據和直方圖。
mosaic_rule	可選字典。在定義應如何鑲嵌單個圖像時指定鑲嵌規則。未指定鑲嵌規則時，將使用影像圖層的默認鑲嵌規則(如根資源中所宣傳的：defaultMosaicMethod、mosaicOperator、sortField、sortValue)。
rendering_rule	可選字典。指定應如何呈現所請求圖像的呈現規則。
pixel_size	可選字符串或字典。正在使用的像素級別(或正在查看的分辨率)。如果未指定像素大小，則 pixel_size 將默認為數據集的基本分辨率。鑲嵌數據集中指定像素大小的柵格將用於直方圖計算。 用法: 字典結構：pixel_size={point} 點簡單語法：pixel_size='<x>,<y>' 例子： pixel_size={“x”: 0.18, “y”: 0.18} pixel_size='0.18,0.18'
time	可選 datetime.date、datetime.datetime 或時間戳字符串。計算統計數據和直方圖的時刻或時間範圍。指定為 datetime.date、datetime.datetime 或自紀元以來的毫秒數的時間戳語法：time=<timeInstant> 指定為 [<startTime>, <endTime>] 列表的時間範圍 對於時間範圍，<startTime> 或 <endTime> 之一可以為 None。為開始時間或結束時間指定的“無”值將分別表示開始時間或結束時間為無窮大。語法：time=[<開始時間>, <結束時間>] ;指定為 datetime.date、datetime.datetime 或時間戳 注意： 該參數是在 10.8 中添加的。
process_as_multidimensional	可選的布爾值。指定是否將影像服務作為多維影像服務進行處理。 False - Statistics and histograms of pixel values from only the first slice is computed. This is the default. True - The image service is treated as a multidimensional raster, and statistics and histograms of pixel values from all selected slices are computed. 注意： 在 10.9 中為使用 ArcObjects11 或 ArcObjectsRasterRendering 作為服務提供者的圖像服務添加。

示例 1：

# Usage Example 1: Compute the stats and histograms in the specified area of interest for a time instant.

aoi = {
        "spatialReference": {"wkid": 32610},
        "xmax": 725000,
        "xmin": 720000,
        "ymax": 4300000,
        "ymin": 4250000
      }

aoi_geometry = Geometry(aoi)

comp_stats_hist_01 = img_lyr.compute_stats_and_histograms(geometry=aoi,
                                                          rendering_rule={"rasterFunction":None},
                                                          time="1326650400000")

示例 2：

# Usage Example 2: Compute the stats and histograms in the specified area of interest for a time extent.

aoi = {
        "spatialReference": {"wkid": 32610},
        "xmax": 725000,
        "xmin": 720000,
        "ymax": 4300000,
        "ymin": 4250000
      }

aoi_geometry = Geometry(aoi)

# If the datetime object is not in the UTC timezone, the API will internally convert it to the UTC timezone.
start = datetime.datetime(2012,1,15,18,0,0, tzinfo=datetime.timezone.utc)
end = datetime.datetime(2012,1,15,21,0,0, tzinfo=datetime.timezone.utc)

comp_stats_hist_02 = img_lyr.compute_stats_and_histograms(geometry=aoi,
                                                          rendering_rule={"rasterFunction":None},
                                                          time=[start,end])