Python ArcGIS Raster.export_image用法及代碼示例

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

用法:

export_image(bbox=None, image_sr=None, bbox_sr=None, size=None, time=None, export_format='jpgpng', pixel_type=None, no_data=None, no_data_interpretation='esriNoDataMatchAny', interpolation=None, compression=None, compression_quality=None, band_ids=None, mosaic_rule=None, rendering_rule=None, f='image', save_folder=None, save_file=None, compression_tolerance=None, adjust_aspect_ratio=None, lerc_version=None)

返回：

原始柵格數據

export_image 操作在柵格圖層上執行以將其可視化。

Parameter	Description
bbox	可選的字典或字符串。導出圖像的範圍(邊界框)。除非指定了 bbox_sr 參數，否則假定 bbox 位於柵格圖層的空間參考中。 bbox 應指定為 arcgis.geometry.Envelope 對象，它是 json 表示形式或具有以下格式的列表或字符串：'<xmin>, <ymin>, <xmax>, <ymax>' 如果省略，則範圍使用柵格圖層
image_sr	可選字符串，空間參考。導出圖像的空間參考。空間參考可以指定為眾所周知的 ID、json 表示形式或 arcgis.geometry.SpatialReference 對象。如果未指定image_sr，圖像將在柵格的空間參考中導出。
bbox_sr	可選字符串，空間參考。 bbox 的空間參考。空間參考可以指定為眾所周知的 ID、json 表示形式或 arcgis.geometry.SpatialReference 對象。如果未指定 image_sr，則假定 bbox 位於柵格的空間參考中。 (僅當使用image_server引擎時可用)
size	可選列表。導出圖像的大小(寬度 * 高度)(以像素為單位)。如果不指定尺寸，將導出默認尺寸為400*450的圖像。語法：[寬度，高度]列表
time	可選 datetime.date、datetime.datetime 或時間戳字符串。導出圖像的時刻或時間範圍。指定為 datetime.date、datetime.datetime 或自紀元以來的毫秒數的時間戳語法：time=<timeInstant> 指定為 [<startTime>, <endTime>] 列表的時間範圍 對於 <startTime> 或 <endTime 之一的時間範圍> 可能是“無”。為開始時間或結束時間指定的“無”值將分別表示開始時間或結束時間為無窮大。語法：time=[<開始時間>, <結束時間>] ;指定為 datetime.date、datetime.datetime 或時間戳(僅當使用 image_server 引擎時可用)
export_format	可選字符串。導出圖像的格式。默認格式為 jpgpng。如果請求的範圍內沒有透明像素，則jpgpng格式返回JPG；否則，它返回 PNG (png32)。值：jpgpng、png、png8、png24、jpg、bmp、gif、tiff、png32、bip、bsq、lerc
pixel_type	可選字符串。像素類型也稱為數據類型，與存儲在柵格中的值的類型有關，例如有符號整數、無符號整數或浮點。整數是整數，而浮點數是小數。 (僅當使用image_server引擎時可用)
no_data	可選浮點數。不代表任何信息的像素值。 (僅當使用image_server引擎時可用)
no_data_interpretation	可選字符串。 no_data 設置的解釋。當no_data 是數字時，默認值為NoDataMatchAny；當no_data 是逗號分隔字符串時，默認值為NoDataMatchAll：NoDataMatchAny、NoDataMatchAll。 (僅當使用image_server引擎時可用)
interpolation	可選字符串。當柵格數據集發生扭曲或更改坐標空間時，在轉換柵格數據集時推斷像素值的重采樣過程。其中之一：RSP_BilinearInterpolation、RSP_CubicConvolution、RSP_Majority、RSP_NearestNeighbor(僅當使用image_server引擎時可用)
compression	可選字符串。控製導出為 TIFF 格式時如何壓縮圖像：無、JPEG、LZ77。它不控製其他格式的壓縮。 (僅當使用image_server引擎時可用)
compression_quality	可選整數。控製壓縮算法對圖像造成的損失程度。壓縮質量的有效取值範圍是0到100。(僅當使用image_server引擎時有效)
band_ids	可選列表。如果有多個波段，您可以指定要導出的單個波段，也可以通過指定波段編號來更改波段組合(紅、綠、藍)。頻段編號從 0 開始。指定為整數列表，例如[2,1,0](僅當使用image_server引擎時可用)
mosaic_rule	可選字典。在定義如何對單個圖像進行馬賽克時指定馬賽克規則。當未指定鑲嵌規則時，將使用圖像圖層的默認鑲嵌規則(如根資源中公布的：defaultMosaicMethod、mosaicOperator、sortField、sortValue)。
rendering_rule	可選字典。指定如何渲染所請求的圖像的渲染規則。
f	可選字符串。響應格式。默認為 json 值：json,image,kmz,numpy_array 注意：如果 f=”numpy_array” 並且柵格是單波段或多波段柵格，則數組的維度將為行、列和波段數。如果柵格是多維柵格，則數組的維度將是切片數、行數、列數和波段數。需要安裝 LERC 才能將圖像服務導出為 numpy 數組。 如果f=”image”，則返回導出圖像的字節，除非還傳遞了save_folder和save_file參數，這種情況下將圖像寫入指定文件(僅在使用image_server引擎時可用)
save_folder	可選字符串。 f=image時導出圖片的保存文件夾(僅當使用image_server引擎時可用)
save_file	可選字符串。 f=image時保存導出圖像的文件(僅當使用image_server引擎時可用)
compression_tolerance	可選浮點數。控製 lerc 壓縮算法的容差。容差定義了壓縮圖像中像素值的最大可能誤差。示例：compression_tolerance=0.5 對於 8 位和 16 位圖像來說是無損的，但對於浮點數據來說精度為 +-0.5。壓縮容差僅適用於 LERC 格式。 (僅當使用image_server引擎時可用)
adjust_aspect_ratio	可選布爾值。指示是否調整縱橫比。默認情況下adjust_aspect_ratio為true，這意味著實際的bbox將被調整以匹配尺寸參數的寬高比，並且響應圖像具有方形像素。 (僅當使用image_server引擎時可用)
lerc_version	可選整數。如果用戶將格式設置為 lerc，則為 Lerc 格式的版本。值：1 或 2 如果指定了版本，服務器將返回匹配的版本，否則返回可用的最高版本。 (僅當使用image_server引擎時可用)

例子：

# Usage Example: Creates Raster object from a local dataset location and exports the image.

raster_source = Raster(r"/path/to/raster")
raster_source.export_image(size=[1000, 1000])