Disponible con una licencia de Spatial Analyst.
Resumen
Edita y actualiza un archivo de firma fusionando, volviendo a numerar y eliminando las firmas de clase.
Uso
La herramienta Editar firmas le permite modificar un archivo de firma existente mediante todas o alguna de las siguientes operaciones:
- Fusionar firmas de un conjunto de clases
- Volver a numerar un Id. de clase de firma
- Eliminar firmas no deseadas
El archivo de firma de entrada debe ser un archivo de firma ASCII. El archivo puede ser la salida de cualquier herramienta de Multivariante que produce el archivo que contiene la información estadística requerida; por ejemplo, Cluster ISO y Crear firmas. El archivo debe incluir un mínimo de dos clases. Puede reconocer un archivo de este tipo por la extensión .gsg.
El archivo de firma de la nueva representación cartográfica de entrada es un archivo ASCII que consta de dos columnas de valores por línea, separados por dos puntos. La primera columna es el valor del Id. de clase original. La segunda columna contiene los nuevos Id. de clase para su actualización en el archivo de firma. Todas las entradas en el archivo se deben clasificar en orden ascendente con base en la primera columna
Para fusionar un conjunto de clases, coloque la misma Id. de clase nueva para el segundo valor para cada ID. de clase de ese conjunto. En el archivo de firma de la nueva representación cartográfica sólo se deben colocar las clases que deban editarse; cualquier clase no presente en el archivo de la nueva representación permanecerá sin cambio. Para borrar una firma de clase, use -9999 como el valor para la segunda columna de esa clase. También puede volver a numerar un Id. de clase a un valor que no exista en el archivo de firma de entrada.
El siguiente es un ejemplo del archivo de firma de la nueva representación cartográfica de entrada:
2 : 3 4 : 11 5 : -9999 9 : 3
Este ejemplo fusiona las clases 2 y 9 con la 3, fusiona la clase 4 con la 11 y elimina la clase 5.
Si el archivo de firma de entrada posee nombres para las firmas de clase y se fusionarán las firmas en el archivo de firma de la nueva representación cartográfica de entrada, los nombres asociados con el valor al que se fusionen se transferirán al archivo de firma de salida.
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
EditSignatures (in_raster_bands, in_signature_file, in_signature_remap_file, out_signature_file, {sample_interval})| Parámetro | Explicación | Tipo de datos |
in_raster_bands [in_raster_band,...] | Las bandas de ráster de entrada para las que se editarán las firmas. Pueden ser de tipo entero o de punto flotante. | Raster Layer |
in_signature_file | Archivo de firma de entrada cuyas firmas de clase se editarán. Se requiere la extensión .gsg. | File |
in_signature_remap_file | La tabla ASCII de la nueva representación cartográfica de entrada que contiene los Id. de clase que se fusionarán, volverán a numerar o eliminarán. La extensión puede ser .rmp, .asc o .txt. La predeterminada es .rmp. | File |
out_signature_file | Archivo de firma de salida. Se debe especificar una extensión .gsg. | File |
sample_interval (Opcional) | Intervalo a utilizar para realizar el muestreo. El valor predeterminado es 10. | Long |
Ejemplo de código
Ejemplo 1 de EditSignatures (ventana de Python)
En este ejemplo se modificará el archivo de firma en función del archivo de nueva representación de entrada.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
EditSignatures("redl123", "c:/sapyexamples/data/zsamp12.gsg",
"c:/sapyexamples/data/zsamp7.rmp",
"c:/sapyexamples/output/redlremap.gsg", "")
Ejemplo 2 de EditSignatures (secuencia de comandos independiente)
En este ejemplo se modificará el archivo de firma en función del archivo de nueva representación de entrada.
# Name: EditSignatures_Ex_02.py
# Description: Edits and updates a signature file by merging, renumbering,
# and deleting class signatures.
# 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 = "redl123"
oldSig = "c:/sapyexamples/data/zsamp12.gsg"
sigRemap = "c:/sapyexamples/data/zsamp7.rmp"
outNewSig = "c:/sapyexamples/output/redlsig.gsg"
interval = ""
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute EditSignatures
EditSignatures(inRaster, oldSig, sigRemap, outNewSig, interval)
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