Render

Сводка

Создает визуализированный растровый объект, применяя символы к указанному набору растровых данных. Эта функция полезна при отображении данных в ноутбуке Jupyter.

Описание

Используйте функцию Render для изменения отображения растрового объекта и улучшения символов. Эта функция удобна при работе в Jupyter notebook, где основным преимуществом среды является отображение данных.

Функция создает растровый объект с примененным правилом отображения или цветовой картой. Необходимо задать хотя бы одно правило отображения или цветовую карту.

Указанный набор растровых данных является временным для растрового объекта. Чтобы сделать его постоянным, можно вызвать метод save растрового объекта.

Полученный набор растровых данных будет содержать правила отображения, примененные с помощь функции.

Синтаксис

Render (in_raster, {rendering_rule}, {colormap})
ParameterОбъяснениеТип данных
in_raster

Входной набор растровых данных.

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 - одно значение или список значений (по одному на канал), которое определяет объем применяемой гамма-коррекции для управления общей яркостью растрового изображения. Гамма также влияет на соотношение красного к зеленому и синему.

    Например, чтобы выполнить растяжку гаммы 0.5, используйте {'gamma': 0.5}. Чтобы применить различные растяжки гаммы к трехканальному растру, используйте {'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.
  • Список цветовых кодов hex, названий цветов или оба. Поддерживается 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

Отображает ложный цвет многоканального изображения 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