Топо в растр по параметрам—Справка

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

Краткая информация
Использование
Синтаксис
Пример кода
Параметры среды
Информация о лицензиях

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

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

Более подробно о том, как работает инструмент Топо в растр

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

Файл параметров структурирован следующим образом: сначала перечислены входные наборы данных, за которыми идут установки различных параметров, а затем – выходные опции.

Входные данные определяют входные наборы данных и, где это применимо, поля. Существует девять типов входных данных: Contours (изолинии), Points (точки), Sinks (локальные понижения), Streams (водотоки), Lakes (озера), Boundaries (границы), Cliffs (обрывы), Exclusion (исключения) и Coastal polygons (полигоны побережья). Вы можете воспользоваться любым количеством входных данных, в зависимости от их доступности. Порядок, в котором входные данные вводятся, не оказывает никакого влияния на результат. <Path> указывает на путь доступа к набору данных, <Item> указывает на имя поля и <#> определяет вводимое значение.

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

Параметр	Определение	Синтаксис
Входные наборы данных
Изолинии	Набор данных по горизонталям с полем, содержащим значения высот.	Изолиния <Путь> <Элемент>
Точки	Набор точечных данных с полем, содержащим значения высот.	Точка <Путь> <Элемент>
Локальные понижения	Набор точечных данных, содержащий информацию о положении локальных понижений. Если в наборе данных есть значения высот для локальных понижений, задайте его имя поля <Item>. Если будут использоваться только местоположения локальных понижений, укажите значение NONE (нет значения) для опции <Элемент>.	Локальное понижение <Путь> <Элемент>
Водотоки	Набор данных по водотокам. Значения высот не нужны.	Водоток <Путь>
Озера	Набор данных с полигонами озер. Значения высот не нужны.	Озеро <Путь>
Граница	Набор полигональных объектов границ. Значения высот не нужны.	Граница <Путь>
Обрыв	Линейный набор данных для скал. Для скал опция Поле не предусмотрена.	Обрыв <Путь>
Исключение	Полигональный набор данных исключения для областей, в которых входные данные будут игнорироваться. Для исключений опция Поле не предусмотрена.	Исключение <Путь>
Побережье	Набор данных берегового полигона, содержащий контур прибрежной области. Для Побережья опция Поле не предусмотрена.	Граница <Путь>
Настройки параметров
Принудительное заполнение	Контролирует применение принудительного заполнения локальных понижений.	ENFORCE <ON \| OFF \| ON_WITH_SINK>
Тип данных	Первичный тип входных данных.	DATATYPE <CONTOUR \| SPOT>
Итерации	Максимальное число итераций, выполняемых алгоритмом.	ITERATIONS <#>
Фактор шероховатости	Мера шероховатости поверхности.	ROUGHNESS_PENALTY <#>
Фактор шероховатости кривизны профиля	Коэффициент шероховатости кривизны профиля ― это локальный адаптивный фактор, который может использоваться для частичного замещения общей кривизны.	PROFILE_PENALTY <#>
Коэффициент погрешности дискретизации	Величина, определяющая сглаживание входных данных при преобразовании их в растр.	DISCRETE_ERROR_FACTOR <#>
Вертикальная стандартная погрешность	Размер случайной погрешности в z-значениях входных данных.	VERTICAL_STANDARD_ERROR <#>
Допуски	Первый отражает точность данных по высотам по отношению к стоку по поверхности, второй – препятствует стоку через нереально высокие барьеры.	TOLERANCES <#> <#>
Z-ограничения	Верхнее и нижнее ограничение по высоте.	ZLIMITS <#> <#>
Экстент	Границы координат: минимум по x, минимум по y, максимум по x и максимум по y.	EXTENT <#> <#> <#> <#>
Размер ячейки	Разрешение окончательного выходного растра.	CELL_SIZE <#>
Поле	Расстояние в ячейках, определяющее на сколько будет расширена интерполяция за пределы заданного выходного экстента и границы.	MARGIN <#>
Результаты
Выходные объекты водотоков	Выходной класс линейных объектов водотоков и хребтов (водоразделов).	OUT_STREAM
Выходные объекты локальных понижений	Выходной класс точечных объектов, состоящий из оставшихся точек локальных понижений.	OUT_SINK
Выходной файл диагностики	Место хранения на диске и название файла диагностики.	OUT_DIAGNOSTICS <Путь>
Выходные точечные объекты невязки	Класс выходных точечных объектов для всех больших невязок высот в масштабе по локальной погрешности дискретизации.	OUT_RESIDUALS
Выходные точечные объекты водотоков и скал	Выходной точечный класс объектов для расположений, в которых возможно появление ошибок для водотоков и скал.	OUT_STREAM_CLIFF_ERRORS
Выходные точечные объекты ошибок изолиний	Выходной точечный класс объектов для возможных ошибок, связанных с входными данными изолиний.	OUT_CONTOUR_ERRORS

Не задавайте пути для дополнительных выходных наборов данных объектов в файле параметров. Используйте Выходные полилинейные объекты водотоков и Выходные точечные объекты остаточных локальных понижений в диалоговом окне для определения этих выходных данных.

Примерное содержание файла параметров следующее:

     Contour D:\data\contours2\arc HEIGHT
     Point D:\data\points2\point SPOTS
     Sink D:\data\sinks_200.shp 
     Stream D:\data\streams\arc 
     Lake D:\data\lakes\polygon 
     Boundary D:\data\clipcov\polygon
     Cliff D:\data\cliffs.shp 
     ENFORCE ON
     DATATYPE CONTOUR
     ITERATIONS 40
     ROUGHNESS_PENALTY 0.0
     PROFILE_PENALTY 0.5
     DISCRETE_ERROR_FACTOR 1.0
     VERTICAL_STANDARD_ERROR 0.0
     TOLERANCES 2.5 100.0
     ZLIMITS -2000.0 13000.0
     EXTENT -810480.625 8321785.0 810480.625 10140379.0
     CELL_SIZE 1800.00000000000
     MARGIN 20
     OUT_DIAGNOSTICS D:\data\ttr_diag.txt

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

Синтаксис

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, содержащий входные данные и параметры, которые будут использоваться для интерполяции. Файл, как правило, изначально создан из предыдущего запуска инструмента Топо в растр с заданным дополнительно файлом выходного параметра. Для того, чтобы проверить результаты изменения параметров, легче внести изменения в этот файл и повторно запустить интерполяцию, чем каждый раз исправлять ошибку инструмента Топо в растр.	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

Название

Объяснение

Тип данных

out_surface_raster

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

Это всегда растр с плавающей точкой.

Raster

Пример кода

TopoToRasterByFile, пример 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")

TopoToRasterByFile, пример 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")

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

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

ArcGIS Desktop Basic: Требует Spatial Analyst или 3D Analyst
ArcGIS Desktop Standard: Требует Spatial Analyst или 3D Analyst
ArcGIS Desktop Advanced: Требует Spatial Analyst или 3D Analyst

ArcMap

Топо в растр по параметрам