Crear archivos de firma (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 archivos de firma

Uso

• 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 Capas de probabilidad para cada clase, deben estar presentes las matrices de covarianza. Esta información se genera cuando habilita la opción Calcular matrices de covarianza en el cuadro de diálogo o si especifica la opción COVARIANCE en la secuencia de comandos. Tenga en cuenta que esta es la configuración predeterminada. Consulte Cómo funciona Crear archivos de firma 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.

• Si la entrada es una capa creada desde un ráster multibanda con más de tres bandas, la operación considerará todas las bandas asociadas con el dataset de origen, no sólo las tres bandas que fueron cargadas (simbolizadas) por la capa.

• Hay varias maneras de especificar un subconjunto de bandas a partir de un ráster multibanda para utilizar como entrada en la herramienta.

  • Si utiliza el cuadro de diálogo de la herramienta, navegue hasta el ráster multibanda utilizando el botón junto a Bandas de ráster de entrada, abra el ráster y, a continuación, seleccione las bandas deseadas.
  • Si el ráster multibanda es una capa en la Tabla de contenido, puede utilizar la herramienta Crear capa ráster para crear una nueva capa multibanda que contiene solo las bandas deseadas.
  • También puede crear un nuevo dataset que contiene solo las bandas deseadas con Bandas compuestas y utilizar el dataset resultante como entrada para la herramienta.
  • En Python, las bandas deseadas se pueden especificar directamente en el parámetro de herramienta como una lista.

Sintaxis

CreateSignatures (in_raster_bands, in_sample_data, out_signature_file, {compute_covariance}, {sample_field})

Parámetro	Explicación	Tipo de datos
in_raster_bands [in_raster_band,...]	Las bandas de ráster de entrada para las que se crean las firmas.	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. Debe especificarse una extensión .gsg.	File
compute_covariance (Opcional)	Especifica si se calculan las matrices de covarianza además de las medias. COVARIANCE — Se 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_ONLY — Só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

Ejemplo 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 = ""

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

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

Entornos

Tamaño de celda, Espacio de trabajo actual, Sistema de coordenadas de salida, Extensión, Espacio de trabajo temporal

Información sobre licencias

ArcGIS for Desktop Basic: Requiere Spatial Analyst

ArcGIS for Desktop Standard: Requiere Spatial Analyst

ArcGIS for Desktop Advanced: Requiere Spatial Analyst