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 permite modificar un archivo de firma existente con una de las siguientes operaciones o con todas ellas:
- 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 Multivariante que produzca el archivo que contiene la información estadística requerida, por ejemplo, Cluster ISO y Crear archivos de firma. 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
En ciertos casos, algunas de las clases deseadas pueden ser demasiado similares entre sí desde el punto de vista estadístico, por lo que la asignación de celdas a clases únicas podría no ser fiable. Por ejemplo, puede querer que haya una clase para humedal y otra diferente para humedal boscoso. Sin embargo, estas dos clases no son fácilmente distinguibles. En este caso, puede optar por fusionar la clase humedal boscoso en la clase humedal, más general. Como alternativa, si no hay diferencia estadística entre las clases, puede eliminar una de ellas, ya que las dos representan en esencia a la misma clase.
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 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 de examinar junto a Bandas de ráster de entrada, abra el ráster y, a continuación, 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.
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. El valor predeterminado 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 |
Muestra 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 Desktop Basic: Requiere Spatial Analyst
- ArcGIS Desktop Standard: Requiere Spatial Analyst
- ArcGIS Desktop Advanced: Requiere Spatial Analyst