Топо в растр по параметрам (Spatial Analyst)

Уровень лицензии:BasicStandardAdvanced

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

Интерполирует гидрологически корректную растровую поверхность по точечным, линейным и полигональным данным, используя параметры, заданные в файле.

Более подробно о том, как работает инструмент Топо в растр (Topo to Raster)

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

Синтаксис

TopoToRasterByFile (in_parameter_file, {out_stream_features}, {out_sink_features}, {out_residual_feature}, {out_stream_cliff_error_feature}, {out_contour_error_feature})
ПараметрОбъяснениеТип данных
in_parameter_file

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

Файл, как правило, изначально создан из предыдущего запуска инструмента Топо в растр (Topo to Raster) с заданным дополнительно файлом выходного параметра.

Для того, чтобы проверить результаты изменения параметров, легче внести изменения в этот файл и повторно запустить интерполяцию, чем каждый раз исправлять ошибку инструмента Топо в растр (Topo to Raster).

File
out_stream_features
(дополнительно)

Выходной класс полилинейных объектов водотоков.

Полилинейные объекты имеют следующие коды:

  1. Входная линия водотока не выше скалы.
  2. Входная линия водотока выше скалы (водопад).
  3. Принудительное заполнение, очищающее случайный сток.
  4. Линия водотока, определенная по углу изолинии.
  5. Линия гребня, определенная по углу изолинии.
  6. Код не используется.
  7. Дополнительные условия данных линии водотока.
  8. Код не используется.
  9. Линия, указывающая на большой промежуток в данных высоты.
Feature Class
out_sink_features
(дополнительно)

Выходной класс пространственных объектов остающихся точечных объектов локальных понижений.

Feature Class
out_residual_feature
(дополнительно)

Класс выходных точечных объектов для всех крупных остатков высоты с масштабом по локальной погрешности дискретизации.

Все измеренные остатки, имеющие значение больше 10, должны быть проверены на возможные ошибки во входных данных высоты и водотока. Крупномасштабные остатки указывают на конфликты между входными данными высоты и водотока. Они также могут быть связаны с ошибками, выявленными при автоматическом принудительном заполнении речного бассейна. Эти конфликты могут быть устранены при помощи дополнительной линии водотока и/или дополнительных значений высот точек, но сначала следует проверить и исправить ошибки в существующих входных данных. Большие остаточные смещения вне масштаба обычно указывают на ошибки в высотах входных данных.

Feature Class
out_stream_cliff_error_feature
(дополнительно)

Выходной точечный класс объектов для расположений, в которых возможно появление ошибок для водотоков и скал.

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

Точки кодируются следующим образом:

  1. Настоящий контур в сети данных водотока.
  2. Контур в сети водотока, закодированный в выходном растре.
  3. Контур в сети водотока через связующие озера.
  4. Точка рукавов.
  5. Водоток выше скалы (водопад).
  6. Точки, указывающие на множество точек выхода водотока из озер.
  7. Код не используется.
  8. Точки около скал, чья высота не соответствует направлению скал.
  9. Код не используется.
  10. Кольцевой рукав удален.
  11. Рукав без впадающего водотока.
  12. Растеризованный рукав в выходной ячейке, отличной от той, в которой разделилась линия водотока.
  13. Дополнительные условия ошибок обработки – индикатор очень сложных данных водотока.
Feature Class
out_contour_error_feature
(дополнительно)

Выходной точечный класс объектов для возможных ошибок, связанных с входными данными изолиний.

Изолинии с наклоном в высоте, в пять раз превышающим стандартное отклонение значений изолинии, как показано в выходном растре, заносятся в данный класс объектов. Изолинии, соединяющие другие изолинии с отличной высотой, отмечены в этом классе объектов кодом 1, это явный признак ошибки надписи изолинии.

Feature Class

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

ИмяОбъяснениеТип данных
out_surface_raster

Выходной растр интерполированной поверхности.

Raster

Пример кода

Топо в растр по параметрам. Пример 1 (окно Python)

В этом примере создается гидрологически корректный растр поверхности TIFF из файла параметров, определяющего входные точечные, линейные и полигональные данные.

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTTRByFile = TopoToRasterByFile("topotorasterbyfile.txt", 
                   "C:/sapyexamples/output/out_streams.shp", "#",
                   "C:/sapyexamples/output/out_resids.shp")
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout.tif")
Топо в растр по параметрам. Пример 2 (автономный скрипт)

В этом примере создается гидрологически корректный растр поверхности Grid из файла параметров, определяющего входные точечные, линейные и полигональные данные.

# Name: TopoToRasterByFile_Ex_02.py
# Description: Interpolates a hydrologically correct 
#    surface from point, line, and polygon data using
#    parameters specified in a file.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inParameterFile = "topotorasterbyfile.txt"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute TopoToRasterByFile
outTTRByFile = TopoToRasterByFile(inParameterFile, "#", "C:/sapyexamples/output/out_resids2.shp")

# Save the output 
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout02")

Параметры среды

Связанные темы

Обзор группы инструментов Интерполяция (Interpolation)
Основы анализа интерполяции
Сравнение методов интерполяции

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

ArcGIS for Desktop Basic: Требует Дополнительный модуль Spatial Analyst или 3D Analyst
ArcGIS for Desktop Standard: Требует Дополнительный модуль Spatial Analyst или 3D Analyst
ArcGIS for Desktop Advanced: Требует Дополнительный модуль Spatial Analyst или 3D Analyst
Copyright © 1995-2014 Esri. All rights reserved.
6/5/2014