Слой GA в точки (Geostatistical Analyst)

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

Сводка

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

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

  • Для форматов данных, которые поддерживают пустые значения (Null), например для классов пространственных объектов файловых баз геоданных, значение Null используется для указания того, что для данного местоположения не удалось выполнить интерполяцию, или что значение следует игнорировать при его использовании в качестве входного. Для форматов данных, которые не поддерживают пустые значения, например для шейп-файлов, используется значение -1,7976931348623158e+308 (это отрицательный вариант определенной в языке C++ константы DBL_MAX) для указания того, что для данного местоположения не удалось выполнить интерполяцию.

  • Если применяется проверка z-поля, интерполяции и стандартные ошибки вычисляются иначе, чем при отсутствии поля проверки. Для получения более подробной информации обратитесь к работе:

    • Krivoruchko, K., A. Gribov, and J. M. Ver Hoef, 2006, "A new method for handling the nugget effect in kriging," T. C. Coburn, J. M. Yarus, and R. L. Chambers, Eds., Stochastic modeling and geostatistics: Principles, methods, and case studies, volume II: AAPG Computer Applications and Geology 5, p. 81–89.

Синтаксис

arcpy.ga.GALayerToPoints(in_geostat_layer, in_locations, {z_field}, out_feature_class, {append_all_fields}, {elevation_field}, {elevation_units})
ParameterОбъяснениеТип данных
in_geostat_layer

Анализируемый геостатический слой.

Geostatistical Layer
in_locations

Точки, для которых будут проинтерполированы значения и выполнена проверка.

Feature Layer
z_field
(Дополнительный)

Если оставить это поле незаполненным, интерполяция будет выполнена для определенных точек. Если поле выбрано, интерполяция выполняется для определенных точек, а затем проинтерполированное значение сравнивается со значениями Z_value_field, и выполняется проверка.

Field
out_feature_class

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

Этот класс объектов может содержать следующие поля (где применимо):

  • Source_ID (Source ID) – Идентификатор объекта-источника из Местоположения входных точек наблюдения.
    • Идентификатор пространственного или непространственного объекта использованного входного набора данных.
  • Included (Включено) – показывает, вычислялось ли значение интерполяции для этого объекта. Значения в данном поле могут быть следующими:
    • Да – Выполнение интерполяции в этой точке не вызывает проблем.
    • Недостаточное число соседей – Количество соседей недостаточно для выполнения интерполяции.
    • Параметр веса слишком мал – параметр веса слишком мал.
    • Переполнение – переполнение при расчете значений с плавающей точкой.
    • Проблема с преобразованием данных – преобразуемое значение находится вне поддерживаемого диапазона для выбранного метода преобразования (только для кригинга).
    • Нет независимых растров – значение не может быть вычислено, т.к. одна из независимых переменных не задана. Точка может находиться вне экстента по крайне мере одного из растров независимой переменной, или она может быть поверх ячейки NoData в по крайне мере одном из растров независимой переменной. Данная опция применяется только к моделям Прогнозирование регрессии ЭБК.
  • Predicted (Проинтерполированное значение) – проинтерполированное значение в данном местоположении.
  • Error (Ошибка) – проинтерполированное значение минус значение поля проверки.
  • StdError (Стандартная ошибка) – стандартная ошибка кригинга.
  • Stdd_Error (Нормированная ошибка) – нормированные ошибки интерполяции. Теоретически, нормированные ошибки интерполяции подчиняются закону нормального распределения.
  • NormValue (Нормальное значение) – значение нормального распределения (ось x), соответствующее нормированным ошибкам интерполяции (ось y) в нормальном графике КК.
  • CRPS (Континуальное ранжированное значение вероятности) – континуальное ранжированное значение вероятности позволяет измерить отклонение от функции прогнозируемого совокупного распределения для каждого найденного значения данных. Это значение должно быть как можно меньше. Этот способ оценки имеет преимущества по сравнению с оценкой перекрестной проверки, потому что он сравнивает данные с полным распределением, а не с прогнозами для конкретной точки. Это поле создается только для моделей Эмпирический байесовский кригинг и Прогнозирование регрессии ЭБК.
  • Interval90 (В пределах интервала 90 процентов) – показывает, находится ли точка проверки в пределах 90 процентов доверительного интервала. Это поле создается только для моделей Эмпирический байессовский кригинг и Прогнозирование регрессии ЭБК. Если эта модель подходит под данные, приблизительно 90 процентов объектов должны входить в 90-процентный доверительный интервал. Это поле может содержать следующие значения:
    • Да – точка проверки находится в пределах 90-процентного доверительного интервала.
    • Нет – точка проверки не находится в пределах 90-процентного доверительного интервала.
    • Исключено – в указанном местоположении выполнить интерполяцию невозможно.
  • Interval95 (В пределах интервала 95 процентов) – показывает, находится ли точка проверки в пределах 95 процентов доверительного интервала. Это поле создается только для моделей Эмпирический байессовский кригинг и Прогнозирование регрессии ЭБК. Если эта модель подходит под данные, приблизительно 95 процентов объектов должны входить в 95-процентный доверительный интервал. Это поле может содержать следующие значения:
    • Да – точка проверки находится в пределах 95-процентного доверительного интервала.
    • Нет – точка проверки не находится в пределах 95-процентного доверительного интервала.
    • Исключено – в указанном местоположении выполнить интерполяцию невозможно.
  • QuanVal (Квантиль проверки) – квантиль измеряемого значения у объекта с учетом распределения прогнозирования. Это значение находится в диапазоне от 0 до 1. Значения, близкие к 0, указывают на то, что измеренное значение находится в крайней левой части кривой распределения, а значения, близкие к 1, указывают на то, что измеренное значение находится в крайней правой части кривой распределения. Если много значений расположены близко к одному из экстремумов, это может означать, что распределение проинтерполированных значений плохо подходит для модели данных и следует изменить некоторые параметры интерполяции. Это поле создается только для моделей Эмпирический байесовский кригинг и Прогнозирование регрессии ЭБК.
Feature Class
append_all_fields
(Дополнительный)

Определяет, будут ли все поля скопированы из входных пространственных объектов в выходной класс пространственных объектов.

  • ALL Все поля из входных пространственных объектов будут скопированы в выходной класс пространственных объектов. Используется по умолчанию.
  • FID_ONLY Копируется только ID объекта под именем Source_ID в выходном классе объектов.
Boolean
elevation_field
(Дополнительный)

Поле, содержащее высоту каждой входной точки. Этот параметр применяется только к геостатистическим 3D-моделям. Это поле рекомендуется использовать, если значения высоты сохранены как атрибуты геометрии в Shape.Z. Если высоты сохранены в поле атрибутов, то они должны показывать расстояние относительно уровня моря. Положительные значения показывают расстояние над уровнем моря, а отрицательные значения – ниже уровня моря.

Field
elevation_units
(Дополнительный)

Единицы поля высот. Этот параметр применяется только к геостатистическим 3D-моделям. Если в поле высот указан Shape.Z, то единицы будут автоматически соответствовать Z-единицам вертикальной системы координат.

  • INCHВысоты в дюймах.
  • FOOTВысоты в футах.
  • YARDВысоты в ярдах.
  • MILE_USВысоты в милях США.
  • NAUTICAL_MILEВысоты в морских милях.
  • MILLIMETERВысоты в миллиметрах.
  • CENTIMETERВысоты в сантиметрах.
  • DECIMETERВысоты в дециметрах.
  • METERВысоты в метрах.
  • KILOMETERВысоты в километрах.
String

Пример кода

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

Экспорт геостатистического слоя в точечный класс объектов.

import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
arcpy.GALayerToPoints_ga("C:/gapyexamples/data/kriging.lyr", 
                         "C:/gapyexamples/data/obs_pts.shp",                   
                         "", "C:/gapyexamples/output/krig_pts")
GALayerToPoints, пример 2 (автономный скрипт)

Экспорт геостатистического слоя в точечный класс объектов.

# Name: GALayerToPoints_Example_02.py
# Description: Exports a geostatistical layer to points.
# Requirements: Geostatistical Analyst Extension

# Import system modules
import arcpy

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

# Set local variables
inLayer = "C:/gapyexamples/data/kriging.lyr"
inPoints = "C:/gapyexamples/data/obs_pts.shp"
zField = ""
outPoints = "C:/gapyexamples/output/krig_pts"

# Execute GALayerToPoints
arcpy.GALayerToPoints_ga(inLayer, inPoints, zField, outPoints)

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

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

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