Слой 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.

Параметры

ПодписьОписаниеТип данных
Входной геостатистический слой

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

Geostatistical Layer
Местоположения входных точек наблюдения

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

Feature Layer
Поле проверки
(Дополнительный)

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

Field
Выходная статистика для точечного местоположения

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

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

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

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

  • Отмечено – все поля из входных пространственных объектов будут скопированы в выходной класс пространственных объектов. Используется по умолчанию.
  • Не отмечено – копируется только ID объекта под именем Source_ID в выходном классе объектов.
Boolean
Поле высоты
(Дополнительный)

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

Field
Единицы измерения поля высот
(Дополнительный)

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

  • Геодезические дюймы СШАВысоты выражаются в геодезических дюймах США.
  • Геодезические футы СШАВысоты выражаются в геодезических футах США.
  • Геодезические ярды СШАВысоты выражаются в геодезических ярдах США.
  • Геодезические мили СШАВысоты выражаются в геодезических милях США.
  • Геодезические морские мили СШАВысоты в морских геодезических милях США.
  • МиллиметрыВысоты в миллиметрах.
  • СантиметрыВысоты в сантиметрах.
  • ДециметрыВысоты в дециметрах.
  • МетрыВысоты в метрах.
  • КилометрыВысоты в километрах.
  • Международные дюймыВысоты выражаются в международных дюймах.
  • Международные футыВысоты в международных футах.
  • Международные ярдыВысоты в международных ярдах.
  • Сухопутные милиВысоты выражаются в сухопутных милях
  • Международные морские милиВысоты в международных морских милях.
String

arcpy.ga.GALayerToPoints(in_geostat_layer, in_locations, {z_field}, out_feature_class, {append_all_fields}, {elevation_field}, {elevation_units})
ИмяОписаниеТип данных
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 (Error) – проинтерполированное значение минус значение поля проверки.
  • StdError (Стандартная ошибка) – стандартная ошибка кригинга.
  • Stdd_Error (Нормированная ошибка) – нормированные ошибки интерполяции. Теоретически, нормированные ошибки интерполяции подчиняются закону нормального распределения.
  • NormValue (Нормальное значение) – значение нормального распределения (ось x), соответствующее нормированным ошибкам интерполяции (ось y) в нормальном графике КК.
  • CRPS (Непрерывная ранжированная оценка вероятности) – непрерывная ранжированная оценка вероятности позволяет измерить отклонение от функции прогнозируемого совокупного распределения для каждого найденного значения данных. Это значение должно быть как можно меньше. Этот способ оценки имеет преимущества по сравнению с оценкой перекрестной проверки, потому что он сравнивает данные с полным распределением, а не с прогнозами для конкретной точки. Это поле создается только для моделей Эмпирический байессовский кригинг и Прогнозирование регрессии ЭБК.
  • Interval90 (В пределах интервала 90 процентов) – обозначает, находится ли точка проверки в пределах 95 процентов доверительного интервала. Это поле создается только для моделей Эмпирический байессовский кригинг и Прогнозирование регрессии ЭБК. Если модель подходит к данным, приблизительно 95 процентов объектов должны находится в 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Высоты в километрах.
  • INCH_INTВысоты выражаются в международных дюймах.
  • FOOT_INTВысоты в международных футах.
  • YARD_INTВысоты в международных ярдах.
  • MILE_INTВысоты выражаются в сухопутных милях
  • NAUTICAL_MILE_INTВысоты в международных морских милях.
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

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