Desktop Help 10.0 - Feld zu Analyse-Layer hinzufügen (Network Analyst)

Zusammenfassung

Fügt einem Sublayer eines Netzwerkanalyse-Layers ein Feld hinzu.

Verwendung

Das Werkzeug wird meistens zusammen mit dem Werkzeug Standorte hinzufügen verwendet, um Felder von den Eingabe-Features auf die Sublayer zu übertragen. Wenn Sie beispielsweise ein Feld mit dem Namen "UniqueID" von den Eingabe-Features in den Sublayer "Facilities" (Einrichtungen) des Layers "Service Area" (Einzugsgebiet) übertragen möchten, verwenden Sie zuerst dieses Werkzeug, um dem Sublayer "Facilities" das Feld "UniqueID" hinzuzufügen; anschließend verwenden Sie die Feldzuordnungen im Werkzeug Standorte hinzufügen, um Eingabewerte für das Feld "UniqueID" bereitzustellen.
Allen Sublayern der Netzwerkanalyse-Layer können Felder hinzugefügt werden.

Syntax

AddFieldToAnalysisLayer_na (in_network_analysis_layer, sub_layer, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable})

Parameter	Erläuterung	Datentyp
in_network_analysis_layer	Der Netzwerkanalyse-Layer, dem das neue Feld hinzugefügt wird.	Network Analyst Layer
sub_layer	Der Sublayer des Netzwerkanalyse-Layers, dem das neue Feld hinzugefügt wird.	String
field_name	Der Name des Felds, das dem ausgewählten Sublayer des Netzwerkanalyse-Layers hinzugefügt wird.	String
field_type	Der für die Erstellung des neuen Feldes verwendete Feldtyp. LONG —Numerische Werte ohne Bruchzahlen innerhalb eines bestimmten Bereichs. TEXT —Namen oder andere Textangaben. FLOAT —Numerische Werte mit Bruchzahlen innerhalb eines spezifischen Bereichs. DOUBLE —Numerische Werte mit Bruchzahlen innerhalb eines spezifischen Bereichs. SHORT —Numerische Werte ohne Bruchzahlen innerhalb eines spezifischen Bereichs; codierte Werte. Datum —Datum und/oder Uhrzeit. BLOB —Bilder oder andere Multimedia-Elemente.	String
field_precision (optional)	Bestimmt die Anzahl der Ziffern, die im Feld gespeichert werden können. Dabei werden alle Ziffern berücksichtigt, unabhängig davon, auf welcher Seite des Dezimalkommas sie sich befinden. Der Parameterwert ist nur für Zahlenfeldtypen gültig.	Long
field_scale (optional)	Legt die Anzahl der Dezimalstellen fest, die in einem Feld gespeichert werden können. Dieser Parameter wird nur für die Felddatentypen "Float" und "Double" verwendet.	Long
field_length (optional)	Die Länge des hinzugefügten Feldes. Dadurch wird die maximal zulässige Anzahl von Zeichen für jeden Datensatz des Feldes festgelegt. Diese Option ist nur in Feldern des Typs "Text" oder "Blob" anwendbar.	Long
field_alias (optional)	Der alternative Name für den Feldnamen. Dieser dient als aussagekräftigere Beschreibung für kryptische Feldnamen. Der Parameter "Feld-Alias" gilt nur für Geodatabases und Coverages.	String
field_is_nullable (optional)	Ein geographisches Feature, das keine zugehörigen Attributinformationen besitzt. Der Parameter unterscheidet sich von Nullfeldern oder leeren Feldern. Er wird nur für Felder in einer Geodatabase unterstützt. NON_NULLABLE —NULL-Werte sind für das Feld nicht zulässig. NULLABLE —NULL-Werte sind für das Feld zulässig. Dies ist die Standardeinstellung.	Boolean

Codebeispiel

AddFieldToAnalysisLayer – Beispiel 1 (Python-Fenster)

Im folgenden Skript im Python-Fenster wird veranschaulicht, wie dem Einrichtungen-Sublayer des Netzwerkanalyse-Layers "Einzugsgebiet" ein Feld "UniqueID" hinzugefügt wird.

import arcpy
arcpy.AddFieldToAnalysisLayer_na("Service Area","Facilities","UniqueID","LONG")

AddFieldToAnalysisLayer – Beispiel 2 (Workflow)

Im folgenden eigenständigen Python-Skript wird veranschaulicht, wie die Funktion "AddFieldToAnalysisLayer" verwendet werden kann, um das Feld "StationID" in den Eingabe-Features "Feuerwachen" auf die Polygon-Features für die 2-, 3- und 5-Minuten-Einzugsgebiete zu übertragen, die in einer Einzugsgebiet-Analyse berechnet werden. Das Feld "StationID" kann verwendet werden, um andere Attribute in den Feuerwachen-Features mit den Einzugsgebiet-Polygon-Features zu verbinden.

# Name: AddFieldToAnalysisLayer_Workflow.py
# Description: Transfers the StationID field from the input fire station 
#              features to the 2,3,5 minute service area polygon features
#              calculated from a service area analysis. The StationID field can 
#              be used to join other attributes from the fire station features 
#              to the service area polygon features.
# Requirements: Network Analyst Extension 

#Import system modules
import arcpy
from arcpy import env

try:
    #Check out the Network Analyst extension license
    arcpy.CheckOutExtension("Network")

    #Set environment settings
    env.workspace = "C:/data/SanFrancisco.gdb"
    env.overwriteOutput = True
    
    #Set local variables
    inNetworkDataset = "Transportation/Streets_ND"
    outNALayer = "FireStationsCoverage"
    impedanceAttribute = "TravelTime"
    defaultBreakValues = "2 3 5"   
    fieldName = "StationID"
    fieldType = "LONG"
    inFeatures = "Analysis/FireStations"
    fieldMappings = "Name StationName #; StationID StationID #"
    searchTolerance = "2 Miles"
    polygonLayer = outNALayer + "/" + "Polygons"
    facilitiesLayer = outNALayer + "/" + "Facilities"
    calculateField = "SAPolygons." + fieldName    
    expression = "!Facilities." + fieldName + "!"
    outFeatures = outNALayer + "Area"
    
    #Create a new service area analysis layer. For this scenario, the default 
    #value for all the remaining parameters statisfies the analysis requirements
    arcpy.MakeServiceAreaLayer_na(inNetworkDataset, outNALayer,
                                  impedanceAttribute,"",defaultBreakValues)
    
    #Add a StationID field to the Facilities sublayer of the service area layer.
    #This is done before loading the fire stations as facilities so that the 
    #StationID values can be transferred from the input features to the 
    #Facilities sublayer. The service area layer created previously is 
    #referred by its name.
    arcpy.AddFieldToAnalysisLayer_na(outNALayer,"Facilities",fieldName,
                                     fieldType)
    
    #Add the fire station features as Facilities and map the Name and the 
    #StationID properties from the StationName and StationID fields.
    arcpy.AddLocations_na(outNALayer,"Facilities",inFeatures,fieldMappings,
                          searchTolerance)
    
    #Solve the service area layer
    arcpy.Solve_na(outNALayer)
    
    #Transfer the StationID field from Facilities sublayer to Polygons sublayer 
    #of the service area layer since we wish to export the polygons.
    #First add "StationID" field to the Polygons sublayer
    arcpy.AddFieldToAnalysisLayer_na(outNALayer,"Polygons",fieldName,fieldType)
    
    #Join Facilities to Polygons based on FacilityID and ObjectID fields
    arcpy.AddJoin_management(polygonLayer,"FacilityID",facilitiesLayer,
                            "ObjectID")
    
    #Calculate the StationID field in Polygons based on the StationID field from
    #facilities.
    arcpy.CalculateField_management(polygonLayer,calculateField,expression,
                                    "PYTHON")
    
    #Remove the join so that the Polygons sublayer will not have all the fields 
    #from the Facilities sublayer when Polygons are exported to a feature class.
    arcpy.RemoveJoin_management(polygonLayer,"Facilities")
    
    #Export the Polygons sublayer to a feature class on disk.
    arcpy.CopyFeatures_management(polygonLayer, outFeatures)
    
    print "Script completed successfully"
    
except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    print "An error occured on line %i" % tb.tb_lineno
    print str(e)

Umgebungen

Aktueller Workspace

Lizenzinformationen

ArcView: Ja

ArcEditor: Ja

ArcInfo: Ja

7/10/2012