Editar firmas (Spatial Analyst)

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.

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

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
  • 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).

  • 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.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a 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 editarán las firmas.

Pueden ser de tipo entero o de punto flotante.

Raster Layer
Archivo de firma de entrada

Archivo de firma de entrada cuyas firmas de clase se editarán.

Se requiere la extensión .gsg.

File
Archivo de nueva representación cartográfica de firma de entrada

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
Archivo de firma de salida

Archivo de firma de salida.

Se debe especificar una extensión .gsg.

File
Intervalo de Muestra
(Opcional)

Intervalo a utilizar para realizar el muestreo.

El valor predeterminado es 10.

Long

EditSignatures(in_raster_bands, in_signature_file, in_signature_remap_file, out_signature_file, {sample_interval})
NombreExplicaciónTipo 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 = ""

# Execute EditSignatures
EditSignatures(inRaster, oldSig, sigRemap, outNewSig, interval)

Información de licenciamiento

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

Temas relacionados