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.
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 Probabilidad de 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 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 al introducir 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 solo las tres bandas 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 usa el cuadro de diálogo de la herramienta, vaya al ráster multibanda usando el botón Examinar
situado junto a Bandas del ráster de entrada, abra el ráster y seleccione las bandas que desee. - Si el ráster multibanda es una capa de la tabla de contenido, puede usar la herramienta Crear capa ráster para crear una nueva capa multibanda que solo contenga 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.
- Si usa el cuadro de diálogo de la herramienta, vaya al ráster multibanda usando el botón Examinar
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
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. 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.
| 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
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