ArcMap

Agregar elemento

Disponible con una licencia Advanced.

Resumen

Agrega un nuevo espacio en blanco o cero a una tabla INFO nueva o ya existente.

Uso

  • Esta herramienta crea una tabla INFO nueva que es una copia de la tabla INFO de entrada con un nuevo elemento que contiene espacios en blanco o ceros. Los datos en otros elementos se copian de la tabla INFO de entrada a la tabla INFO de salida. Cuando la tabla INFO de entrada y la tabla INFO de salida tienen el mismo nombre, el elemento se agrega a la tabla INFO de entrada; de lo contrario se crea una tabla INFO de entrada como una tabla INFO interna nueva y la tabla INFO de entrada no se modifica.

  • No inserte los elementos antes del ID de cobertura en una tabla de atributos de entidades.

  • No inserte elementos antes del elemento COUNT en una cuadrícula VAT.

  • Si Tipo de elemento define un carácter, se insertan espacios en blanco en cada registro. Si Tipo de elemento define un elemento numérico, se insertan ceros en cada registro.

  • No se recomienda agregar elementos a los archivos de punto de relevancia de cobertura. Es posible que se produzcan resultados negativos en función de las operaciones realizadas en la cobertura. Limpiar, Copiar y otras herramientas conservan únicamente los elementos de punto de relevancia.

  • Existe una herramienta similar, Unir tablas Info, que agrega elementos mediante la combinación de dos tablas INFO. Agregar elemento es una herramienta diferente a Unir tablas Info y solo agrega un elemento cada vez. Además, los valores del elemento nuevo son siempre cero o un espacio en blanco. Es posible que sea preferible utilizar Unir tablas Info cuando se agregan muchos elementos desde una tabla INFO existente.

Sintaxis

arcpy.arc.AddItem(in_info_table, out_info_table, item_name, item_width, output_width, item_type, {decimal_places}, {start_item})
ParámetroExplicaciónTipo de datos
in_info_table

La tabla INFO a la que se va a agregar el elemento.

INFO Table
out_info_table

Tabla INFO que se va a crear.

INFO Table
item_name

El nuevo elemento que se va a agregar a la tabla INFO.

String
item_width

El ancho de la tabla INFO para el elemento que se ha agregado. Anchos compatibles:

  • BINARY: 2 o 4 bytes
  • CHARACTER: 1 a 320 caracteres
  • DATE: siempre 8 bytes, se almacena con el formato mm/dd/aa
  • FLOATING: 4 bytes (precisión simple) u 8 bytes (precisión doble)
  • NUMERIC: 1 a 16 dígitos
  • INTEGER: 1 a 16 dígitos
Long
output_width

El ancho de salida del elemento que se ha agregado. Es el número de caracteres que se utiliza para mostrar un valor del elemento.

Por ejemplo, en un entero de 2 bytes (tipo de elemento BINARY), los valores pueden llegar hasta 32767, lo cual requiere cinco caracteres para la visualización. Las fechas se pueden mostrar utilizando ocho (mm/dd/aa) o diez (mm/dd/aaaa) caracteres. Para las visualizaciones de fechas internacionales, los meses y días se pueden intercambiar (por ejemplo, mm/dd/aa).

Long
item_type

El tipo de elemento INFO del elemento que se ha agregado.

  • BINARY —El entero binario; requiere menos espacio de almacenamiento que el entero
  • CHARACTER —Texto
  • DATE —Fecha; almacena el día, el mes y el año
  • FLOATING —Número binario de punto flotante, ya sea de precisión simple o doble
  • NUMERIC —El número decimal que se almacenó como un byte por dígito
  • INTEGER —El número entero que se almacenó como un byte por dígito
String
decimal_places
(Opcional)

El número de posiciones decimales para el elemento agregado. Se debe especificar para los tipos de elemento INFO, es decir NUMERIC y FLOTATING.

Long
start_item
(Opcional)

El elemento en in_info_table tras el que se agrega el elemento nuevo. El elemento start_item predeterminado es el último elemento en in_info_table.

INFO Item

Muestra de código

Ejemplo de AddItem (secuencia de comandos independiente)

La siguiente secuencia de comandos independiente muestra cómo agregar un elemento binario a una tabla de atributos de punto de una cobertura. Utiliza la misma tabla de entrada y de salida, de forma que no se creen tablas nuevas. 

# Name: AddItem_Example.py
# Description: Adds an item to a coverage's polygon attribute table
# Requirements: ArcInfo Workstation

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inInfoTable = "tra_airport/polygon"
outInfoTable = inInfoTable
itemName = "sites"
itemWidth = 4
outputWidth = 5
itemType = "BINARY"

# Execute AddItem
arcpy.AddItem_arc(inInfoTable, outInfoTable, itemName, itemWidth, outputWidth, 
                  itemType, "", "")

Entornos

Información de licenciamiento

  • Basic: No
  • Standard: No
  • Advanced: Requiere ArcInfo Workstation instalado

Temas relacionados