Crear firmas (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Crea un archivo de firma ASCII de clases definidas mediante datos de muestra de entrada y un conjunto de bandas de ráster.

Más información sobre cómo funciona Crear firmas

Uso

  • Cuando se especifica un ráster multibanda como una de las Bandas del ráster de entrada (in_raster_bands en Python), se utilizarán todas las bandas.

    Para procesar una selección de bandas a partir de un ráster multibanda, puede crear primero un dataset ráster nuevo formado por esas bandas concretas con la herramienta Bandas compuestas y utilizar el resultado en la lista de Bandas del ráster de entrada (in_raster_bands en Python).

  • Se debe utilizar una extensión .gsg para el archivo de firma de salida.

  • Las bandas de ráster de entrada y el ráster de entrada o los datos de muestra de entidades deben tener extensiones superpuestas. Las estadísticas se calcularán sólo para el área en común.

  • La cantidad válida mínima de muestras de clases en los datos de muestra es dos. No existe una cantidad máxima de clases.

  • Si debe utilizar el archivo de firma en más herramientas de análisis multivariado, como Clasificación de máxima verosimilitud y Probabilidad de clase, deben estar presentes las matrices de covarianza. Esta información se genera cuando activa la opción Calcular matrices de covarianza en el cuadro de diálogo o si especifica la opción COVARIANCE en el script. Tenga en cuenta que esta es la configuración predeterminada. Consulte Cómo funciona Crear firmas para comparar archivos de firma cuando se generan las matrices de covarianza versus los valores medios solamente.

  • No debe cambiar nada en el archivo de firma excepto que introduzca el nombre de las clases. Debe crear y alterar las estadísticas del archivo sólo mediante herramientas de multivariado.

  • Los nombres de las clases en el archivo de firma de salida son opcionales. Sólo se utilizan para referencia. Se pueden introducir los nombres de clase mediante el Campo de muestra o cualquier editor de texto se puede utilizar en el archivo de firma resultante para introducir los nombres de entrada. Cada nombre de clase debe constar de una sola cadena de caracteres de no más de 31 caracteres alfanuméricos.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Bandas del ráster de entrada

Las bandas de ráster de entrada para las que se crean las firmas.

Pueden ser de tipo entero o de punto flotante.

Raster Layer
Datos de muestra de ráster o entidad de entrada

La entrada que delinea el conjunto de muestras de clases.

La entrada puede ser un ráster entero o un dataset de entidades.

Raster Layer; Feature Layer
Archivo de firma de salida

Archivo de firma de salida.

Se debe especificar una extensión .gsg.

File
Calcular matrices de covarianza
(Opcional)

Especifica si se calculan las matrices de covarianza además de las medias.

  • Activado: se calcularán las matrices de covarianza y los valores medios de todas las clases de los datos de muestra de entrada. Esta es la opción predeterminada.
  • Desactivado: sólo se calcularán los valores medios de todas las clases de los datos de muestra de entrada.
Boolean
Campo de muestra de asignación de valores
(Opcional)

Campo del ráster de entrada o datos de muestra de entidades para asignar valores a las ubicaciones de muestra (clases).

Solo los campos de enteros o de cadena de caracteres son campos válidos. La cantidad especificada o de cadena de caracteres se utilizará como el nombre de clase en el archivo de firma de salida.

Field

CreateSignatures(in_raster_bands, in_sample_data, out_signature_file, {compute_covariance}, {sample_field})
NombreExplicaciónTipo de datos
in_raster_bands
[in_raster_band,...]

Las bandas de ráster de entrada para las que se crean las firmas.

Pueden ser de tipo entero o de punto flotante.

Raster Layer
in_sample_data

La entrada que delinea el conjunto de muestras de clases.

La entrada puede ser un ráster entero o un dataset de entidades.

Raster Layer; Feature Layer
out_signature_file

Archivo de firma de salida.

Se debe especificar una extensión .gsg.

File
compute_covariance
(Opcional)

Especifica si se calculan las matrices de covarianza además de las medias.

  • COVARIANCESe calcularán las matrices de covarianza y los valores medios de todas las clases de in_sample_data. Esta es la opción predeterminada.
  • MEAN_ONLYSólo se calcularán los valores medios de todas las clases de in_sample_data.
Boolean
sample_field
(Opcional)

Campo del ráster de entrada o datos de muestra de entidades para asignar valores a las ubicaciones de muestra (clases).

Solo los campos de enteros o de cadena de caracteres son campos válidos. La cantidad especificada o de cadena de caracteres se utilizará como el nombre de clase en el archivo de firma de salida.

Field

Muestra de código

Ejemplo 1 de CreateSignatures (ventana de Python)

Este ejemplo crea un archivo de firma para clases definidas por áreas de formación de ejemplo y un conjunto de bandas de ráster de entrada.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
CreateSignatures("sb", "sbtrain", "c:/sapyexamples/output/rbsig.gsg", 
                 "COVARIANCE", "")
Ejemplo 2 de CreateSignatures (secuencia de comandos independiente)

Este ejemplo crea un archivo de firma para clases definidas por áreas de formación de ejemplo y un conjunto de bandas de ráster de entrada.

# Name: CreateSignatures_Ex_02.py
# Description: Creates an ASCII signature file of classes defined by input 
#    sample data and a set of raster bands.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "sb"
inSamples = "sbtrain"
outSig = "c:/sapyexamples/output/rbsig02.gsg"
sampField = ""

# Execute CreateSignatures
CreateSignatures(inRaster, inSamples, outSig, "COVARIANCE", sampField)

Información de licenciamiento

  • Basic: Requiere Spatial Analyst
  • Standard: Requiere Spatial Analyst
  • Advanced: Requiere Spatial Analyst

Temas relacionados