FieldMappings

Zusammenfassung

The FieldMappings object is a collection of FieldMap objects and it is used as the parameter value for tools that perform field mapping, such as Merge.

Diskussion

Die Eigenschaften des FieldMap-Objekts enthalten die Anfangs- und die Endposition eines Eingabetextwertes, sodass ein Ausgabewert mit einem Teil eines Eingabewertes erstellt werden kann. Wenn ein FieldMap-Objekt mehrere Eingabefelder aus derselben Tabelle oder Feature-Class enthält, werden die Werte aller Datensätze unter Verwendung der Eigenschaft mergeRule zusammengeführt. Dies ist eine benutzerfreundliche Möglichkeit zum Verbinden von Werten, beispielsweise eines Straßennamens in einem Feld und einer Straßenart, die in einem anderen Feld enthalten ist (z. B. "Eureka" und "Street"). Die Eigenschaft joinDelimiter von FieldMap wird verwendet, wenn für mergeRule der Wert Join angegeben wird. Als Trennzeichen können beliebige Zeichen verwendet werden, beispielsweise Leerzeichen. Im obigen Beispiel würde damit der Wert "Eureka Street" erstellt.

Das FieldMappings-Objekt ist eine Sammlung von FieldMap-Objekten und wird als Parameterwert für Werkzeuge für die Feldzuordnung verwendet, beispielsweise Zusammenführen (Merge). Sie können am einfachsten mit diesen Objekten arbeiten, indem Sie zuerst ein FieldMappings-Objekt erstellen und dann die zugehörigen FieldMap-Objekte initialisieren, indem Sie die zu kombinierenden Eingabe-Feature-Classes oder Tabellen hinzufügen. Wenn alle Eingaben bereitgestellt wurden, enthält das FieldMappings-Objekt ein FieldMap-Objekt (bzw. ein Ausgabefeld) für jeden eindeutigen Feldnamen aus allen Eingaben. Sie können diese Liste ändern, indem Sie neue Felder hinzufügen, die Eigenschaften oder den Inhalt von Ausgabefeldern ändern oder unerwünschte Ausgabefelder entfernen.

Syntax

 FieldMappings  ()

Eigenschaften

EigenschaftErläuterungDatentyp
fieldCount
(Schreibgeschützt)

The number of output fields.

Integer
fieldMappings
(Lesen und schreiben)

A list of FieldMap objects that make up the FieldMappings object.

FieldMap
fieldValidationWorkspace
(Lesen und schreiben)

The workspace type that defines the rules for attribute field naming. These rules are used when determining the output field names, which are based on the names of the input fields. For example, setting the fieldValidationWorkspace property to the path of a folder on disk containing the input shapefiles will result in the output field names being truncated to 10 characters. Setting the fieldValidationWorkspace property to the path of a file geodatabase will allow for much longer field names. The fieldValidationWorkspace property should be set with a consideration for the output format.

String
fields
(Schreibgeschützt)

A list of Field objects. Each field object represents the properties of each output field.

Field

Methodenübersicht

MethodeErläuterung
addFieldMap (field_map)

Add a field map to the field mappings.

addTable (table_dataset)

Adds a table to the field mappings object.

exportToString ()

Exports the object to its string representation.

findFieldMapIndex (field_map_name)

Find a field map within the field mappings by name.

getFieldMap (index)

Returns a FieldMap object from the FieldMappings object by index position.

loadFromString (string)

Restore or update the spatial reference object using a WKT string. The exportToString method can be used to export a WKT string representation of the spatial reference.

  • Using a WKT string with a horizontal coordinate system.
    # The following string is the WKT for the 
    # Geographic Coordinate system "WGS 1984" (factory code=4326)
    wkt = 'GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137.0,298.257223563]],\
                  PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]];\
                  -400 -400 1000000000;-100000 10000;-100000 10000;8.98315284119522E-09;\
                  0.001;0.001;IsHighPrecision'
    
    sr = arcpy.SpatialReference()
    sr.loadFromString(wkt)
  • Using a WKT string with a horizontal and vertical coordinate system. Note that the vertical coordinate system is defined in the VERTCS section of the WKT.
    # The following string is the WKT for the 
    # Geographic Coordinate system "WGS 1984" (factory code=4326), 
    # with a vertical coordinate system "WGS 1984" (factory code=115700)
    
    wkt = 'GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137.0,298.257223563]],\
                  PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],\
                  VERTCS["WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137.0,298.257223563]],\
                  PARAMETER["Vertical_Shift",0.0],PARAMETER["Direction",1.0],UNIT["Meter",1.0]];\
                  -400 -400 1000000000;-100000 10000;-100000 10000;8.98315284119522E-09;\
                  0.001;0.001;IsHighPrecision'
    
    sr = arcpy.SpatialReference()
    sr.loadFromString(wkt)

removeAll ()

Removes all values and creates an empty object.

removeFieldMap (index)

Removes a FieldMap object from the FieldMappings object.

replaceFieldMap (index, value)

Replace a FieldMap object within the FieldMappings object.

Methoden

addFieldMap (field_map)
ParameterErläuterungDatentyp
field_map

The field map to add to the field mappings

FieldMap
addTable (table_dataset)
ParameterErläuterungDatentyp
table_dataset

The table to add to the field mappings object.

String
exportToString ()
Rückgabewert
DatentypErläuterung
String

The WKT string representation of the object.

findFieldMapIndex (field_map_name)
ParameterErläuterungDatentyp
field_map_name

Find the field map by name.

String
Rückgabewert
DatentypErläuterung
Integer

The index position of the field map.

getFieldMap (index)
ParameterErläuterungDatentyp
index

The index position of the FieldMap object.

Integer
Rückgabewert
DatentypErläuterung
FieldMap

The FieldMap object from the FieldMappings object.

loadFromString (string)
ParameterErläuterungDatentyp
string

The WKT string representation of the object.

String
removeAll ()
removeFieldMap (index)
ParameterErläuterungDatentyp
index

The index position of the FieldMap.

Integer
replaceFieldMap (index, value)
ParameterErläuterungDatentyp
index

The index position of the FieldMap object to be replaced.

Integer
value

The replacement FieldMap object.

FieldMap

Codebeispiel

FieldMappings example

FieldMap-Objekte werden oft dazu verwendet, um ähnliche Datasets in ein einzelnes umfassendes Dataset zusammenzuführen. In diesem Beispiel werden die Feature-Class Trees und das Shapefile Plants.shp in eine Feature-Class namens Vegetation zusammengeführt. Die ursprünglichen Feature-Classes verfügen jeweils über zwei Attribute: Type und Diameter. Diese beiden Attribute müssen bei der Zusammenführung beibehalten werden.

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)
FieldMappings example 2

In diesem Beispiel wird eine Möglichkeit gezeigt: Mithilfe von FieldMap-Objekten und dem Werkzeug FeatureClassToFeatureClass können Felder zusammengeführt werden. In diesem Beispiel enthält eine Feature-Class Informationen zur Anzahl von Unfällen pro Kreuzung in einer Stadt. Ein Feld enthält dabei die Daten für ein Jahr. Der Benutzer möchte nun für jede Kreuzung die durchschnittliche Anzahl an Unfällen bestimmen, ohne die vorhandene Tabelle zu ändern.

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)

Verwandte Themen