Установить Null (Spatial Analyst)

ArcGIS Pro 3.4 | | Архив справки

Доступно с лицензией Spatial Analyst.

Доступно с лицензией Image Analyst.

Краткая информация

Инструмент Установить ноль (Set Null) устанавливает идентифицированные ячейки на NoData на основании заданного критерия. Выдает значение NoData, если при выполнении оценки условия получено значение Истина, и выдает значение, определяемое другим растром, если получено значение Ложь.

Более подробно о присвоении ячейкам значений NoData с помощью инструмента Установить Null

Иллюстрация

Рисунок инструмента Установить Null
OutRas = SetNull(InRas1, InRas2, "Value = 4")

Использование

  • Если оценка выражения запроса истинна, ячейке на выходном растре будет присвоено значение NoData. Если оценка условия ложна, значения на выходном растре будут определены значением входного ложного растра или постоянным значением.

  • Если выражение запроса не определено, в тех случаях, когда значения растра условия не равны 0, значения выходного растра будут NoData.

  • Входной растр условия не влияет на тип выходных данных, которые могут быть представлены и целочисленным растром, и растром с плавающей точкой. Если входной ложный растр или постоянное значение содержат значения с плавающей точкой, выходной растр будет представлен числами с плавающей точкой. Если он содержит целочисленные значения, выходные данные будут представлены целочисленным растром.

  • Если Входной растр условия (in_conditional_raster в Python) является одноканальным, а Входной растр значения "ложь" или константа (in_false_raster_or_constant в Python) является константой, то результатом будет одноканальный растр.

  • Если все входные данные являются многоканальными растрами, результатом будет многоканальный растр. Выходной растр также будет многоканальным, если входные растровые данные типа ложь будут константой. Количество каналов в каждом входном многоканальном растре должно быть одинаковым.

  • Инструмент будет выполнять операцию для каждого канала из растра условий с использованием соответствующего канала из других входных данных. Если входные данные условия являются многоканальным растром, а входные данные «ложь» являются константой, то инструмент выполнит операцию с использованием значения константы для каждого канала в многоканальных входных данных.

  • Выражение использует SQL-запрос. Более подробно о создании запросов см. в следующих разделах:

  • Чтобы использовать в языке Python выражение условия {where_clause}, его следует заключить в кавычки. Например, "Value > 5000".

    Дополнительные сведения об указании запроса в Python см. в справке.

  • Максимальная длина логического выражения составляет 4096 знаков.

  • См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

ПодписьОписаниеТип данных
Входной растр, удовлетворяющий условиям

Входной растр, представляющий истинный или ложный результат заданного условия.

Может быть целочисленным или с плавающей точкой.

Raster Layer
Входной растр значения "ложь" или константа

Входные данные, значения которых будут использоваться в качестве выходных значений ячеек, если условие – false.

Это может быть целочисленный растр, растр с плавающей точкой или константное значение.

Raster Layer; Constant
Выражение
(Дополнительный)

Логическое выражение, которое определяет, какие из входных ячеек имеют значения true или false.

Условие Where следует общим правилам построения выражений SQL. Его можно ввести напрямую, например, VALUE> 100, если нажать кнопку перехода в режим Редактирование SQL SQL-запрос. Если вы находитесь в Режиме редактирования условия Редактировать условие, вы можете начать построение выражения, нажав кнопку Режим Добавить условие.

SQL Expression

Возвращаемое значение

ПодписьОписаниеТип данных
Выходной растр

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

Если условная оценка – Истина, выдается значение NoData. Если Ложь, выдается значение второго входного растра.

Raster

Информация о лицензиях

  • Basic: Обязательно Spatial Analyst или Image Analyst
  • Standard: Обязательно Spatial Analyst или Image Analyst
  • Advanced: Обязательно Spatial Analyst или Image Analyst

Связанные разделы