返回顶部

Render

在本主题中

  1. 摘要
  2. 说明
  3. 语法
  4. 代码示例

摘要

通过将符号系统应用于引用的栅格数据集来创建渲染的栅格对象。 在 Jupyter Notebook 中显示数据时，此函数很有用。

说明

使用 Render 函数修改栅格对象的显示以改进符号系统。在使用 Jupyter Notebook 工作时，此函数很有用，因为数据显示对 Notebook 环境至关重要。

该函数可创建应用了渲染规则或色彩映射表的栅格对象。必须至少指定一个渲染规则或色彩映射表。

栅格对象所引用的栅格数据集是临时性的。 要将其设置为永久，可以调用栅格对象的 save 方法。

生成的栅格数据集将包含已应用该函数的渲染规则。

语法

Render (in_raster, {rendering_rule}, {colormap})
参数说明数据类型
in_raster

The input raster dataset.

Raster
rendering_rule

应用于输入栅格的渲染规则。如果未指定色彩映射表，则必须指定渲染规则。

渲染规则可使用以下一种或多种格式：

  • bands - 要映射到 RGB 显示的波段指数列表。

    例如，要为 Landsat 8 影像创建自然色合成图，其中波段 4 显示为红色，波段 3 显示为绿色，波段 2 显示为蓝色，请使用 {'bands': [4, 3, 2]}。

  • min 和 max - 用于对栅格执行线性拉伸的值的范围。最小值和最大值将用作直方图拉伸的端点，且这些值可以是单个输入或值列表（每波段一对）。

    例如，要对单波段栅格执行从像素值 0 到 100 的线性拉伸，请使用 {'min': 0, 'max': 100}。要对三波段影像执行线性拉伸，并将每个影像从像素值 0 拉伸到不同的最大像素值，请使用 {'min': 0, 'max': [220,210,180]}。

  • numberOfStandardDeviations - 描述将用于线性拉伸的标准差数的单个值。拉伸将应用在最小像素值和最大像素值之间，这些值将由与平均值的标准差数进行定义。

    例如，要执行线性拉伸以移除与平均值的标准差超过两个的任何像素值，请使用 {'numberOfStandardDeviations': 2}。

  • gamma - 定义应用于控制栅格显示整体亮度的 Gamma 校正量的单个值或值列表（每波段一个）。此外，Gamma 还会影响显示中红色、绿色和蓝色的比率。

    例如，要执行 0.5 的 Gamma 拉伸，请使用 {'gamma': 0.5}。要对三波段栅格执行多种 Gamma 拉伸，请使用 {'gamma': [0.5, 2, 1.5]}。

  • rft - 栅格函数模板 (.rft.xml) 的路径，其中拉伸由栅格函数链进行定义；例如 {'rft': r"C:\StretchFunctions\Remap_and_Stretch.rft.xml"}。

Dictionary
colormap

定义用于渲染的颜色。如果未指定渲染规则，则必须指定色彩映射表。

该参数必须使用以下格式之一：

  • ArcGIS Pro 中受支持的色彩映射表或配色方案的名称；例如 colormap="Red to Green"。有关受支持配色方案的完整列表，请下载 ArcGIS_Pro_ColorSchemes.pdf PDF 文档。
  • 十六进制颜色代码和/或已命名颜色的列表。共有 16 种受支持的已命名颜色：
    • aqua
    • black
    • blue
    • fuchsia
    • gray
    • green
    • lime
    • maroon
    • navy
    • olive
    • purple
    • red
    • silver
    • teal
    • white
    • yellow

    例如，["#B0C4DE", "blue", "navy"]。

  • 含以下键值对的字典：
    • "values": [<pixel_value1>, <pixel_value2>, ... ]
    • "colors": ["<color1>", "<color2", ... ]
    • "labels": ["<label1>", "<label2>", ... ]

    例如，{"values": [11, 21, 30], "colors": ["#B0C4DE", "green", "gray"], "labels": ["water", "vegetation", "urban"]}

String
返回值
数据类型说明
Raster

输出已渲染栅格对象。

代码示例

Render 示例 1

使用线性拉伸和 NDVI 配色方案渲染单波段 NDVI 栅格。

import arcpy
from arcpy.ia import *

arcpy.CheckOutExtension("ImageAnalyst")

# Set input raster
in_Raster = arcpy.Raster(r"C:\Data\NDVI_Raster.tif")

# Render the raster with a linear stretch and the NDVI color scheme
rendered_raster = arcpy.ia.Render(inRaster, rendering_rule=
	{'min': 0, 'max': 0.8}, colormap='NDVI')
rendered_raster
Render 示例 2

使用已应用的拉伸以及每个波段的 Gamma 拉伸来渲染多波段 Landsat 7 影像伪彩色。

import arcpy
from arcpy.ia import *

arcpy.CheckOutExtension("ImageAnalyst")

# Set input raster
in_Raster = arcpy.Raster(r"C:\Data\Landsat7.tif")

# Render the Landsat 7 image in false color composite
# Include a linear standard deviation stretch, and a gamma stretch for each band
rendered_raster = arcpy.ia.Render(inRaster, rendering_rule=
	{'bands': [4,3,2], 'numberOfStandardDeviations': 2, 'gamma': [1,1.7,1.2]})
rendered_raster
Render 示例 3

使用自定义色彩映射表来渲染分类土地覆被栅格。

import arcpy
from arcpy.ia import *

arcpy.CheckOutExtension("ImageAnalyst")

# Set input raster
in_Raster = arcpy.Raster(r"C:\Data\Landcover.tif")

# Render the landcover dataset with a custom color map
rendered_raster = arcpy.ia.Render(inRaster, colormap=
	{"values": [11,21,31], "colors": ["#486DA2",  "gray",  "green"],
	"labels":["water", "urban", "forest"]})

rendered_raster
Render 示例 4

使用栅格函数模板和色彩映射表来渲染多维栅格。

import arcpy
from arcpy.ia import *

arcpy.CheckOutExtension("ImageAnalyst")

# Set input multidimensional raster
in_Raster = arcpy.Raster(r"C:\Data\Landsat8_Time_Series.crf", True)

# Render each slice in the imagery time series data with a stretched 
# Normalized Difference Water Index described in a raster function template
rendered_raster = arcpy.ia.Render(inRaster, rendering_rule=
	{'rft': r"C:\Data\NDWI.rft.xml"}, colormap="Red to Green")

rendered_raster

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 说明
  3. 语法
  4. 代码示例