FieldMap

Resumen

The FieldMap object provides a field definition and a list of input fields taken from a set of tables or feature classes.

Debate

Las propiedades del objeto FieldMap incluyen las posiciones inicial y final de un valor de texto de entrada, de tal forma que se pueda crear un valor de salida utilizando una porción de un valor de entrada. Si un objeto FieldMap contiene varios campos de entrada de la misma tabla o clase de entidad, los valores de cada registro se fusionan con la propiedad mergeRule. Ésta es una manera conveniente de unir valores, tales como un nombre de calle contenido en un campo y un tipo de calle contenido en otro, por ejemplo, Eureka y Street. La propiedad joinDelimiter de FieldMap se utiliza si se especifica el valor Join de mergeRule. Cualquier conjunto de caracteres, tal como un espacio, se puede utilizar como delimitador. En el ejemplo anterior, esto crearía el valor Eureka Street.

El objeto FieldMappings es una colección de objetos FieldMap y se utiliza como el valor de parámetro en las herramientas que realizan asignación de campos, por ejemplo, Fusionar. La forma más fácil de trabajar con estos objetos consiste en crear primero un objeto FieldMappings y, después, inicializar sus objetos FieldMap agregando las tablas o clases de entidad de entrada que se deben combinar. Una vez proporcionadas todas las entradas, el objeto FieldMappings contendrá un objeto FieldMap, o campo de salida, para cada nombre de campo único de todas las entradas. Puede modificar esta lista agregando campos nuevos, modificando las propiedades o el contenido de un campo de salida o quitando los campos de salida no deseados.

Sintaxis

 FieldMap  ()

Propiedades

PropiedadExplicaciónTipo de datos
inputFieldCount
(Sólo lectura)

The number of defined input fields.

Integer
joinDelimiter
(Lectura y escritura)

A string value used to separate input values from the same table if the output field type is string and the mergeRule is Join.

String
mergeRule
(Lectura y escritura)

Defines how values from two or more fields from the same input table are merged into a single output value. Valid choices are as follows:

  • FirstThe first input value is used.
  • LastThe last input value is used.
  • JoinMerge the values using the delimiter value to separate the values (only valid if the output field type is text).
  • MinThe smallest input value is used (only valid if the output field type is numeric).
  • MaxThe largest input value is used (only valid if the output field type is numeric).
  • MeanThe mean is calculated using the input values (only valid if the output field type is numeric).
  • MedianThe median is calculated using the input values (only valid if the output field type is numeric).
  • SumThe sum is calculated using the input values (only valid if the output field type is numeric).
  • StDevThe standard deviation is calculated using the input values (only valid if the output field type is numeric).
  • CountThe number of values included in statistical calculations. This counts each value except null values.
String
outputField
(Lectura y escritura)

The properties of the output field are either set or returned in a Field object.

Field

Descripción general del método

MétodoExplicación
addInputField (table_dataset, field_name, {start_position}, {end_position})

Adds input field to the field map.

findInputFieldIndex (table_dataset, field_name)

Finds an input field from the field map.

getEndTextPosition (index)

Returns the end text position from the field map.

getInputFieldName (index)

Returns the name of an input field from the field map, based on the field's index position.

getInputTableName (index)

Returns the name of an input table from the field map, based on the table's index position.

getStartTextPosition (index)

Returns the start text position from the FieldMap object.

removeAll ()

Removes all values and creates an empty object.

removeInputField (index)

Removes an input field from the FieldMap object.

setEndTextPosition (index, end_position)

Sets end text position for the field map.

setStartTextPosition (index, start_position)

Sets the start text position from the field map.

Métodos

addInputField (table_dataset, field_name, {start_position}, {end_position})
ParámetroExplicaciónTipo de datos
table_dataset

The table added to the field map.

String
field_name

The input field name.

String
start_position

The start position of an input text value.

(El valor predeterminado es -1)

Integer
end_position

The end position of an input text value.

(El valor predeterminado es -1)

Integer
findInputFieldIndex (table_dataset, field_name)
ParámetroExplicaciónTipo de datos
table_dataset

The table added to the field map.

String
field_name

The field name.

String
Valor de retorno
Tipo de datosExplicación
Integer

The index position of the field name.

getEndTextPosition (index)
ParámetroExplicaciónTipo de datos
index

The index position.

Integer
Valor de retorno
Tipo de datosExplicación
Integer

The end text position.

getInputFieldName (index)
ParámetroExplicaciónTipo de datos
index

The index position.

Integer
Valor de retorno
Tipo de datosExplicación
String

The input field name.

getInputTableName (index)
ParámetroExplicaciónTipo de datos
index

The index position.

Integer
Valor de retorno
Tipo de datosExplicación
String

The input table name.

getStartTextPosition (index)
ParámetroExplicaciónTipo de datos
index

The index position.

Integer
Valor de retorno
Tipo de datosExplicación
Integer

The start text position.

removeAll ()
removeInputField (index)
ParámetroExplicaciónTipo de datos
index

The index position.

Integer
setEndTextPosition (index, end_position)
ParámetroExplicaciónTipo de datos
index

The index position.

Integer
end_position

The end position of an input text value.

Integer
setStartTextPosition (index, start_position)
ParámetroExplicaciónTipo de datos
index

The index position.

Integer
start_position

The start position of an input text value.

Integer

Muestra de código

FieldMap example

A menudo, los objetos FieldMap se utilizan para fusionar datasets similares en un solo dataset que englobe todo. En este ejemplo, la clase de entidad Trees y el shapefile Plants.shp se fusionan en una sola clase de entidad: Vegetation. Ambas clases de entidad originales tienen dos atributos: Type y Diameter. Estos dos atributos se deben mantener en toda la fusión.

import arcpy
# Set the workspace
arcpy.env.workspace = 'c:/base'
in_file1 = 'data.gdb/Trees'
in_file2 = 'Plants.shp'
output_file = 'data.gdb/Vegetation'
# Create the required FieldMap and FieldMappings objects
fm_type = arcpy.FieldMap()
fm_diam = arcpy.FieldMap()
fms = arcpy.FieldMappings()
# Get the field names of vegetation type and diameter for both original
# files
tree_type = "Tree_Type"
plant_type = "Plant_Type"
tree_diam = "Tree_Diameter"
plant_diam = "Diameter"
# Add fields to their corresponding FieldMap objects
fm_type.addInputField(in_file1, tree_type)
fm_type.addInputField(in_file2, plant_type)
fm_diam.addInputField(in_file1, tree_diam)
fm_diam.addInputField(in_file2, plant_diam)
# Set the output field properties for both FieldMap objects
type_name = fm_type.outputField
type_name.name = 'Veg_Type'
fm_type.outputField = type_name
diam_name = fm_diam.outputField
diam_name.name = 'Veg_Diam'
fm_diam.outputField = diam_name
# Add the FieldMap objects to the FieldMappings object
fms.addFieldMap(fm_type)
fms.addFieldMap(fm_diam)
# Merge the two feature classes
arcpy.Merge_management([in_file1, in_file2], output_file, fms)
FieldMap example 2

Este ejemplo muestra la opción de utilizar objetos FieldMap para fusionar campos, a través de la herramienta FeatureClassToFeatureClass. En este ejemplo, una clase de entidad contiene información sobre el número de accidentes por intersección que se producen en una ciudad. Cada año de datos se conserva en un campo. El usuario desea encontrar el promedio de accidentes en cada intersección, sin modificar la tabla existente.

import arcpy
# Set the workspace arcpy.env.workspace = 'c:/base/data.gdb'
in_file = 'AccidentData' out_file = 'AverageAccidents'
# Create the necessary FieldMap and FieldMappings objects fm = arcpy.FieldMap() fm1 = arcpy.FieldMap() fms = arcpy.FieldMappings()
# Each field with accident data begins with 'Yr' (from Yr2007 to Yr2012). # The next step loops through each of the fields beginning with 'Yr', # and adds them to the FieldMap Object for field in arcpy.ListFields(in_file, 'Yr*'):
    fm.addInputField(in_file, field.name)
# Set the merge rule to find the mean value of all fields in the
# FieldMap object fm.mergeRule = 'Mean'
# Set properties of the output name. f_name = fm.outputField f_name.name = 'AvgAccidents' f_name.aliasName = 'AvgAccidents' fm.outputField = f_name
# Add the intersection field to the second FieldMap object fm1.addInputField(in_file, "Intersection")
# Add both FieldMaps to the FieldMappings Object fms.addFieldMap(fm) fms.addFieldMap(fm1)
# Create the output feature class, using the FieldMappings object arcpy.FeatureClassToFeatureClass_conversion(    in_file, arcpy.env.workspace, out_file, field_mapping=fms)

Temas relacionados