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

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

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

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

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

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

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

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

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

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

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

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

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

  Примечание:

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входной файл модели	Файл модели пространственной статистики	File
Переменная прогнозирования (Дополнительный)	Имя, описание и единицы измерения переменной, которая будет предсказывать в новых местоположениях.	Value Table
Независимые переменные обучения (Дополнительный)	Имя, описание и единицы измерения независимых переменных, которые будут использоваться для обучения входной модели.	Value Table
Независимые объекты расстояния обучения (Дополнительный)	Имя, описание и единицы измерения независимых объектов расстояния обучения, которые будут использоваться для обучения входной модели.	Value Table
Независимые обучающие растры (Дополнительный)	Имя, описание и единицы измерения независимых обучающих растров, которые будут использоваться для обучения входной модели.	Value Table

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

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

Python

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: Да