Слой GA 3D в многомерный растр (Geostatistical Analyst)

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

Сводка

Экспортирует 3D геостатистический слой, созданный при помощи инструмента Эмпирический байесов кригинг 3D, в многомерный набор растровых данных в формате Cloud Raster Format (файл *.crf). Инструменты из группы инструментов Многомерный анализ набора инструментов Image Analyst предназначены для работы непосредственно с многомерными растрами и могут определять 3D-природу данных.

3D геостатистический слои хранят непрерывные результаты 3D интерполяции и отображаются в виде двухмерных горизонтальных срезов на заданной высоте. Текущая высота может быть изменена с помощью ползунка диапазона, и слой вычислит и отобразит прогнозируемые значения для новой высоты. С помощью инструмента Слой GA в растры можно извлечь растр интерполированных прогнозов для любой высоты. Инструмент Слой GA 3D в многомерный растр автоматизирует процесс извлечения растров для нескольких высот и сохраняет их в виде многомерного набора растровых данных.

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

  • Входной 3D геостатистический слой должен быть создан при помощи Эмпирического байесова кригинга 3D.

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

    • Указать значения высот с помощью итератора - Оставьте параметр Ввести точные значения высот не включенным и укажите значения параметров Минимальная высота, Максимальная высота и Интервал высот. Итерация начнется с минимального значения и будет увеличиваться на значение интервала до достижения максимума. Например, если задать минимальную высоту 0, максимальную 100 и интервал 20, выходные данные будут иметь шесть высот: 0, 20, 40, 60, 80 и 100.
    • Указать точные значения высот - Отметьте параметр Введите точные значения высот и укажите необходимые высоты в параметре Значения высот.
    Параметр Единицы высот задает единицы измерения каждого значения высоты.

  • Если заданный Интервал высот не разбивает диапазон высот на равные части (Максимальная высота минус Минимальная высота), будет использовано одно значение высоты, превышающее максимальную высоту. Например, если задать минимальную высоту 10, максимальную высоту 80, а интервал высот 20, выходные данные будут иметь пять высот: 10, 30, 50, 70 и 90.

  • Размер ячейки растра по умолчанию для параметра Выходной набор многомерных растровых данных является меньшим выходным экстентом измерений x и y, разделенным на 100. По умолчанию количество срезов высот равно 10. Это создаст многомерный растр с разрешением x и y, которое по крайней мере в 10 раз больше, чем z-разрешение. Следует учитывать эти значения, особенно если требуется приблизительно одинаковое разрешение во всех трех измерениях. Увеличение размера ячейки или количества срезов высот приведет к созданию выходных данных, которые имеют близкое разрешение во всех измерениях.

  • Время выполнения инструмента приблизительно пропорционально количеству всех прогнозов, которые необходимо сделать, и каждая ячейка растра для каждой высоты требует вычисления прогнозируемого значения. По умолчанию время выполнения инструмента примерно на 60% больше, чем при экспорте среза одной высоты при помощи инструмента Слой GA в растры с параметрами по умолчанию. Включение Дополнительных выходных типов не приведет к значительному увеличению времени выполнения инструмента, поскольку одновременно можно спрогнозировать несколько выходных типов.

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

  • Все инструменты в группе инструментов Многомерный анализ набора инструментов Image Analyst будут иметь повышенную производительность, если транспонирование построено на многомерном растре. Вы можете использовать параметр Построить многомерное транспонирование, чтобы построить его автоматически, но это увеличит время выполнения инструмента. Вы сможете использовать инструмент Построить многомерное транспонирование для построения транспонирования позже.

Синтаксис

arcpy.ga.GALayer3DToMultidimensionalRaster(in_3d_geostat_layer, out_multidimensional_raster, {cell_size}, {explicit_only}, {min_elev}, {max_elev}, {elev_interval}, {elev_values}, {elev_units}, {output_type}, {quantile_probability_value}, {additional_outputs}, {build_transpose})
ParameterОбъяснениеТип данных
in_3d_geostat_layer

Входной 3D геостатистический слой, представляющий модель, которая будет экспортирована в многомерный набор растровых данных.

Geostatistical Layer
out_multidimensional_raster

Выходной набор растровых данных, содержащий результаты экспорта геостатистической модели. Выходные данные должны быть сохранены как файл формата Cloud Raster Format (*.crf).

Raster Dataset
cell_size
(Дополнительный)

Размер ячейки выходного многомерного растра.

Analysis Cell Size
explicit_only
(Дополнительный)

Указывает, будут ли высоты задаваться в виде точного списка или будет использоваться итератор.

  • EXPLICIT_VALUESЗначения высот будут заданы как список.
  • NO_EXPLICIT_VALUESЗначения высот будут заданы при помощи итератора. Используется по умолчанию.
Boolean
min_elev
(Дополнительный)

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

Double
max_elev
(Дополнительный)

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

Double
elev_interval
(Дополнительный)

Шаг, с которым будет увеличиваться высота с каждой итерацией.

Double
elev_values
[elev_values,...]
(Дополнительный)

Значения высот для экспорта.

Double
elev_units
(Дополнительный)

Задает единицы измерения значений высот.

  • INCHЗначения высот указаны в дюймах.
  • FOOTЗначения высот указаны в футах.
  • YARDЗначения высот указаны в ярдах.
  • MILE_USЗначения высот указаны в милях США.
  • NAUTICAL_MILEЗначения высот указаны в морских милях.
  • MILLIMETERЗначения высот указаны в ярдах.
  • CENTIMETERЗначения высот указаны в сантиметрах.
  • DECIMETERЗначения высот указаны в дециметрах.
  • METERЗначения высот указаны в метрах.
  • KILOMETERЗначения высот указаны в километрах.
String
output_type
(Дополнительный)

Задает основной выходной тип выходного многомерного растра. Параметр Дополнительные выходные типы можно использовать для указания дополнительных переменных в выходном многомерном растре.

Для дополнительной информации см. Какие типы выходных поверхностей создают модели интерполяции?

  • PREDICTIONМногомерный растр прогнозируемых значений. Используется по умолчанию.
  • PREDICTION_STANDARD_ERRORМногомерный растр стандартных ошибок прогнозирования.
  • PROBABILITYМногомерный растр расчета вероятности превышения порогового значения.
  • QUANTILEМногомерный растр расчета квантиля прогнозируемого значения.
String
quantile_probability_value
(Дополнительный)

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

Double
additional_outputs
[[output_type, quantile_probability_value],...]
(Дополнительный)

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

Для дополнительной информации см. Какие типы выходных поверхностей создают модели интерполяции?

Value Table
build_transpose
(Дополнительный)

Указывает, будут ли многомерные транспонирования построены на выходном многомерном растре.

  • BUILD_TRANSPOSEМногомерные транспонирования будут построены на выходном многомерном растре.
  • DO_NOT_BUILD_TRANSPOSEМногомерные транспонирования не будут построены на выходном многомерном растре. Используется по умолчанию.
Boolean

Пример кода

GALayer3DToMultivariateRaster, пример 1 (окно Python)

Интерполирует 3D-точки и конвертирует выходные данные в многомерный растр.

import arcpy
arcpy.ga.EmpiricalBayesianKriging3D("my3DLayer", "Shape.Z", "myValueField", "my3DGALayer")
arcpy.ga.GALayer3DToMultivariateRaster("my3DGALayer", r"C:\\gapydata\\outputMDRD.crf", 1000,
                                       "NO_EXPLICIT_VALUES", 0, 500, 50, "","METERS",
                                       "PREDICTION", "", [["PREDICTION_STANDARD_ERROR",""]],
                                       "BUILD_TRANSPOSE")
GALayer3DToMultivariateRaster, пример 2 (автономный скрипт)

Интерполирует 3D-точки и конвертирует выходные данные в многомерный растр с несколькими выходными типами и транспонированиями.

# Name: GALayer3DToMDR_Example_02.py
# Description: Interpolates 3D points and exports to a multidimensional raster dataset.
# Requirements: Geostatistical Analyst Extension
# Author: Esri

# Import system modules
import arcpy

# Set local variables
in3DPoints = "C:/gapyexamples/input/my3DPoints.shp"
elevationField = "Shape.Z"
valueField = "myValueField"
outGALayer = "myGALayer"


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

# Execute Empirical Bayesian Kriging 3D
arcpy.ga.EmpiricalBayesianKriging3D(in3DPoints, elevationField, valueField, outGALayer)


# Export predictions and standard errors to multidimensional raster with tranposes.

# Set up variables
outMDRaster = r"C:\\gapydata\\outputMDRD.crf"
explicitVals = "NO_EXPLICIT_VALUES"
cell_size = 1000
min_elev = 0
max_elev = 500
elev_interval = 50
elev_list = ""
elev_units = "METERS"
out_type = "PREDICTION"
quan_value = ""
add_outputs = [["PREDICTION_STANDARD_ERROR",""]]
transpose = "BUILD_TRANSPOSE"

# Additionally output prediction standard errors.
arcpy.ga.GALayer3DToMultivariateRaster(outGALayer, outMDRaster, cell_size, explicitVals,
                                       min_elev, max_elev, elev_interval, elev_list,
                                       elev_units, out_type, quan_value, add_outputs,
                                       transpose)

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

  • Basic: Требуется Geostatistical Analyst
  • Standard: Требуется Geostatistical Analyst
  • Advanced: Требуется Geostatistical Analyst

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