Establecer propiedades del archivo de modelo de estadística espacial (Estadística espacial)

Resumen

Agrega descripciones y unidades a las variables almacenadas en un archivo de modelo de estadísticas espaciales.

Más información sobre los archivos de modelo de estadística espacial

Uso

• A continuación se describen aplicaciones potenciales de la herramienta:

  • Defina descripciones de variables para proporcionar contexto e información para las variables almacenadas en el archivo de modelo.
  • Agregue unidades a las variables para que se puedan hacer coincidir al utilizar el archivo de modelo de la herramienta Predecir con archivo de modelo de estadística espacial para hacer predicciones.

• Las salidas de esta herramienta incluyen mensajes de salida de geoprocesamiento que describen las características y el contenido del archivo de modelo de entrada. Puede acceder a los mensajes desplazándose sobre la barra de progreso, haciendo clic en el botón emergente o expandiendo la sección de mensajes en el panel Geoprocesamiento. También puede acceder a los mensajes de una ejecución anterior de la herramienta a través del Historial de geoprocesamiento.

  Los mensajes incluyen la siguiente información y tablas:

  • La herramienta y el método utilizados para crear el archivo de modelo de estadística espacial.
  • La tabla Parámetros de modelo describe la variable que se va a predecir y las variables explicativas utilizadas para crear el modelo. La tabla también contiene unidades para cada variable para ayudar a garantizar que se alineen con las variables de predicción cuando use el modelo para hacer predicciones.
  • Los mensajes y diagnósticos de modelo de la herramienta utilizada para crear el archivo de modelo. Consulte la documentación de la herramienta asociada para obtener explicaciones de los mensajes y diagnósticos.

• Puede crear el archivo de modelo con el parámetro Archivo de modelo entrenado de salida en las herramientas Regresión lineal generalizada, Clasificación y regresión basadas en bosques y aumentadas o Predicción de solo presencia.

  En el caso de los modelos creados mediante la Regresión lineal generalizada, los mensajes mostrarán el tipo de modelo que se utilizó (continuo, binario o recuento). En el caso de la herramienta Clasificación y regresión basadas en bosques y aumentadas, los mensajes mostrarán si se utilizó un modelo basado en bosque o de gradiente aumentado para la regresión o clasificación. En el caso de la herramienta Predicción de solo presencia, los mensajes mostrarán si se usaron puntos de fondo.

• La herramienta no puede editar las unidades de las entidades de distancia de entrenamiento explicativas. La unidad de distancia mostrada en el cuadro de diálogo de la herramienta viene determinada por las unidades de distancia utilizadas para entrenar el modelo.

  Nota:

  Se recomienda que defina las unidades para las variables antes de compartir el archivo de modelo para la predicción con datos diferentes. Las discrepancias accidentales de unidades pueden provocar resultados incorrectos del análisis, de modo que es importante documentar las unidades de cada variable. Por ejemplo, si entrena un modelo con ingresos medidos en dólares estadounidenses, pero utiliza ingresos medidos en rupias indias a la hora de realizar predicciones, los rangos de valores y el significado de los coeficientes serán incoherentes, lo que resultará en predicciones incorrectas.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Archivo de modelo de entrada	El archivo de modelo de estadística espacial.	File
Variable para predecir (Opcional)	El nombre, la descripción y la unidad de la variable que se predecirá en nuevas ubicaciones.	Value Table
Variables de entrenamiento explicativas (Opcional)	El nombre, la descripción y la unidad de las variables explicativas que se usarán para entrenar el modelo de entrada.	Value Table
Entidades de distancia de entrenamiento explicativas (Opcional)	El nombre, la descripción y la unidad de las entidades de distancia de entrenamiento explicativas que se usarán para entrenar el modelo de entrada.	Value Table
Rásteres de entrenamiento explicativos (Opcional)	El nombre, la descripción y la unidad de los rásteres de entrenamiento explicativos que se usarán para entrenar el modelo de entrada.	Value Table

Salida derivada

Etiqueta	Explicación	Tipo de datos
Archivo de modelo actualizado	El archivo de modelo de estadística espacial actualizado con descripciones de variables y unidades.	File

Python

arcpy.stats.SetSSMFileProperties(input_model, {variable_predict}, {explanatory_variables}, {distance_features}, {explanatory_rasters})

Nombre	Explicación	Tipo de datos
input_model	El archivo de modelo de estadística espacial.	File
variable_predict [[var1, desc1, unit1], [var2, desc2, unit2],...] (Opcional)	El nombre, la descripción y la unidad de la variable que se predecirá en nuevas ubicaciones.	Value Table
explanatory_variables [[var1, desc1, unit1], [var2, desc2, unit2],...] (Opcional)	El nombre, la descripción y la unidad de las variables explicativas que se usarán para entrenar el modelo de entrada.	Value Table
distance_features [[var1, desc1, unit1], [var2, desc2, unit2],...] (Opcional)	El nombre, la descripción y la unidad de las entidades de distancia de entrenamiento explicativas que se usarán para entrenar el modelo de entrada.	Value Table
explanatory_rasters [[var1, desc1, unit1], [var2, desc2, unit2],...] (Opcional)	El nombre, la descripción y la unidad de los rásteres de entrenamiento explicativos que se usarán para entrenar el modelo de entrada.	Value Table

Salida derivada

Nombre	Explicación	Tipo de datos
updated_model_file	El archivo de modelo de estadística espacial actualizado con descripciones de variables y unidades.	File

Muestra de código

Ejemplo 1 de SetSSMFileProperties (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función 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']])

Ejemplo 2 de SetSSMFileProperties (script independiente)

El siguiente script independiente de Python muestra cómo utilizar la función 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)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.