Describir archivo de modelo de estadística espacial (Estadística espacial)

Resumen

Describe el contenido y el diagnóstico de un archivo de modelo de estadística espacial.

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

Uso

  • Las salidas principales de esta herramienta son mensajes de salida de geoprocesamiento que describen las características y el contenido del archivo de modelo de entrada. Para acceder a los mensajes, pase el cursor sobre la barra de progreso y haga clic en el botón emergente o expanda la sección de mensajes del 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, de modo que puede confirmar que se alineen con las variables de predicción cuando use el modelo para hacer predicciones. Puede establecer la descripción y las unidades de la variable con la herramienta Establecer propiedades del archivo de modelo de estadística espacial.
    • 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.

    Nota:

    Si no se retenían datos de validación durante el proceso de entrenamiento del modelo, algunos de los diagnósticos no se mostrarán en los mensajes. Tenga cuidado antes de realizar predicciones con tales modelos.

    En el caso de la clasificación y regresión basadas en bosque, los errores fuera de bolsa (OOB) no aparecen en los mensajes porque no se guardan en el archivo de modelo. Para la predicción de solo presencia, los recuentos de puntos de presencia y de fondo utilizados para entrenar el modelo y los resultados de la validación cruzada no aparecen porque esta información podría ser confidencial.

    Precaución:

    Algunos diagnósticos de modelo (como la matriz de confusión) y el contenido del archivo de modelo podrían utilizarse para someter a ingeniería inversa a los datos de entrada que se utilizaron para crear el archivo. Comparta archivos de modelo con precaución si los datos utilizados para entrenar el modelo son confidenciales.

  • 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.

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

    • Comprenda las variables almacenadas en el archivo de modelo revisando su descripción y sus unidades. A continuación, utilice la herramienta Predecir con archivo de modelo de estadística espacial para las predicciones.
    • Vea los diagnósticos del modelo para evaluar la calidad del modelo.

Parámetros

EtiquetaExplicaciónTipo de datos
Archivo de modelo de entrada

El archivo de modelo de estadísticas espaciales que se describirá.

File

Salida derivada

EtiquetaExplicaciónTipo de datos
Variables de entrenamiento explicativas

Una lista de las variables de entrenamiento explicativas utilizadas para entrenar el archivo de modelo.

String
Entidades de distancia de entrenamiento explicativas

Una lista de las entidades de distancia de entrenamiento explicativas utilizadas para entrenar el archivo de modelo.

String
Rásteres de entrenamiento explicativos

Una lista de los rásteres de entrenamiento explicativos utilizados para entrenar el archivo de modelo.

String

arcpy.stats.DescribeSSMFile(input_model)
NombreExplicaciónTipo de datos
input_model

El archivo de modelo de estadísticas espaciales que se describirá.

File

Salida derivada

NombreExplicaciónTipo de datos
explanatory_variables

Una lista de las variables de entrenamiento explicativas utilizadas para entrenar el archivo de modelo.

String
explanatory_distance_features

Una lista de las entidades de distancia de entrenamiento explicativas utilizadas para entrenar el archivo de modelo.

String
explanatory_rasters

Una lista de los rásteres de entrenamiento explicativos utilizados para entrenar el archivo de modelo.

String

Muestra de código

Ejemplo 1 de DescribeSSMFile (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función DescribeSSMFile.

import arcpy
arcpy.stats.DescribeSSMFile("C:/MyData/input_modelfile.ssm")
Ejemplo 2 de DescribeSSMFile (script independiente)

El siguiente script independiente de Python muestra cómo utilizar la función DescribeSSMFile.

# Print the properties of a spatial statistics model file
# Import modules
import arcpy

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

# Run tool 
arcpy.stats.DescribeSSMFile("input_modelfile.ssm")

# Print geoprocessing messages
print(arcpy.GetMessages())

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.