Задать свойства файла модели пространственной статистики (Пространственная статистика)

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

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

Более подробно о файлах модели пространственной статистики

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

  • Ниже приведены потенциальные варианты применения инструмента:

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

    Сообщения включают следующую информацию и таблицы:

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

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

    Для моделей, созданных с помощью инструмента Обобщенная линейная регрессия, в сообщениях будет отображаться тип используемой модели (непрерывная, бинарная или количественная). Для инструмента Классификация на основе леса, классификация с бустингом и регрессия в сообщениях отобразится, использовалась ли для регрессии и классификации модель на основе леса или модель регрессии с бустингом. Для инструмента Прогнозирование только присутствия сообщения отобразят, использовались ли фоновые точки.

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

    Примечание:

    Перед предоставлением общего доступа к файлу модели для прогнозирования с другими данными рекомендуется задать единицы измерения для переменных. Случайное несовпадение единиц измерения может привести к получению некорректных результатов анализа, поэтому важно документировать единицы измерения для каждой переменной. Например, если вы обучаете модель, используя доход, измеряемый в долларах США, но при прогнозировании указываете доход в индийских рупиях, диапазоны значений и значение коэффициентов будут несопоставимыми, что приведет к неправильным прогнозам.

Параметры

ПодписьОписаниеТип данных
Входной файл модели

Файл модели пространственной статистики

File
Переменная прогнозирования
(Дополнительный)

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

Value Table
Независимые переменные обучения
(Дополнительный)

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

Value Table
Независимые объекты расстояния обучения
(Дополнительный)

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

Value Table
Независимые обучающие растры
(Дополнительный)

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

Value Table

Производные выходные данные

ПодписьОписаниеТип данных
Обновленный файл модели

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

File

arcpy.stats.SetSSMFileProperties(input_model, {variable_predict}, {explanatory_variables}, {distance_features}, {explanatory_rasters})
ИмяОписаниеТип данных
input_model

Файл модели пространственной статистики

File
variable_predict
[[var1, desc1, unit1], [var2, desc2, unit2],...]
(Дополнительный)

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

Value Table
explanatory_variables
[[var1, desc1, unit1], [var2, desc2, unit2],...]
(Дополнительный)

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

Value Table
distance_features
[[var1, desc1, unit1], [var2, desc2, unit2],...]
(Дополнительный)

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

Value Table
explanatory_rasters
[[var1, desc1, unit1], [var2, desc2, unit2],...]
(Дополнительный)

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

Value Table

Производные выходные данные

ИмяОписаниеТип данных
updated_model_file

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

File

Пример кода

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

Пример скрипта в окне Python для использования функции SetSSMFileProperties.


arcpy.stats.SetSSMFileProperties ("C:/MyData/input_modelfile.ssm", 
      [["CORN", "Presence of Corn Prediction", "No Units"]], 
      [["RASTER1", "Rainfall", "millimeter"], ["RASTER2", "Temperature", "Celsius"], 
       ["RASTER3", "Crop Type", "No units']])
SetSSMFileProperties, пример 2 (автономный скрипт)

Следующий автономный Python скрипт демонстрирует, как использовать функцию SetSSMFileProperties.

# Set the properties of a spatial statistics model file 

# Import modules 
import arcpy 

# Set the current workspace 
arcpy.env.workspace = "C:/MyData" 

# Set Variable Description and units 
var_predict = [["FatalityPresence", "Binary value to show presence of fatality", "No Units"]]
var_exp = [["ALCOHOL_RELATED", "Number of accidents related to alcohol usage", "Count"], 
           ["SPEED", "Speed of the vehicle", "Miles per hour"]]
var_distance = [["INTERSECTION", "Distance to a road intersection", "Miles"]]

# Run tool  
arcpy.stats.SetSSMFileProperties("input_modelfile.ssm", var_predict, var_exp, 
          var_distance) 

# Print geoprocessing messages 
print(arcpy.GetMessages)

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

Этот инструмент не использует параметры среды геообработки

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

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