Desktop Help 10.0 - Ajouter un champ à la couche d’analyse (Network Analyst)

Récapitulatif

Ajoute un champ à la sous-couche d'une couche d’analyse de réseau.

Utilisation

Cet outil s'utilise principalement avec l'outil Ajouter des localisations pour transférer des champs des entités en entrée aux sous-couches. Par exemple, si vous souhaitez transférer un champ appelé UniqueID de vos entités en entrée vers la sous-couche Ressources de la couche Zone de desserte, utilisez cet outil pour ajouter le champ UniqueID à la sous-couche Ressources, puis utilisez les appariements de champs dans l'outil Ajouter des localisations pour fournir des valeurs en entrée pour le champ UniqueID.
Il est possible d'ajouter des champs à l'une des sous-couches des couches d'analyse de réseau.

Syntaxe

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

Paramètre	Explication	Type de données
in_network_analysis_layer	Couche d'analyse de réseau à laquelle le nouveau champ sera ajouté.	Network Analyst Layer
sub_layer	Sous-couche de la couche d'analyse de réseau auquel le nouveau champ sera ajouté.	String
field_name	Nom du champ ajouté à la sous-couche spécifiée de la couche d'analyse de réseau.	String
field_type	Type de champ utilisé pour la création du nouveau champ. LONG —Valeurs numériques sans fractions appartenant à une plage particulière. TEXTE —Noms ou autres qualités textuelles. FLOAT —Valeurs numériques avec des fractions appartenant à une plage particulière. DOUBLE —Valeurs numériques avec des fractions appartenant à une plage particulière. SHORT —Valeurs numériques sans fractions appartenant à une plage particulière ; valeurs précodées. Date —Date et/ou heure. BLOB —Images ou autres séquences multimédia.	String
field_precision (Facultatif)	Décrit le nombre de chiffres pouvant être stockés dans le champ. Tous les chiffres sont comptabilisés, à gauche comme à droite de la virgule. La valeur de paramètre est valide uniquement pour les champs de type numérique.	Long
field_scale (Facultatif)	Définit le nombre de décimales possibles dans un champ. Ce paramètre est utilisé uniquement dans les champs de données de type Réel simple ou Réel double.	Long
field_length (Facultatif)	Longueur du champ en cours d'ajout. Définit le nombre maximal de caractères autorisés pour chaque enregistrement du champ. Cette option n'est applicable qu'aux champs de type texte ou blob.	Long
field_alias (Facultatif)	Autre nom donné au champ. Ce nom permet d'attribuer des noms plus explicites aux champs portant des noms sibyllins. Ce paramètre d'alias de champs ne s'applique qu'aux géodatabases et aux couvertures.	String
field_is_nullable (Facultatif)	Entité géographique à laquelle aucune information d'attribut n'est associée. Ces valeurs sont différentes de zéro ou de champs vides et sont uniquement valables pour les champs d'une géodatabase. NON_NULLABLE —Le champ n'autorise pas les valeurs Null. NULLABLE —Le champ autorise les valeurs Null. Il s'agit de l'option par défaut.	Boolean

Exemple de code

Exemple 1 d'utilisation de l'outil Ajouter un champ à la couche d'analyse (fenêtre Python)

Le script de fenêtre Python suivant montre comment ajouter un champ UniqueID à la sous-couche Ressources de la couche d'analyse de réseau Zone de desserte.

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

Exemple 2 d'utilisation de l'outil Ajouter un champ à la couche d'analyse (workflow)

Le script Python autonome ci-dessous montre comment l'outil Ajouter un champ à la couche d'analyse permet de transférer le champ StationID des entités de caserne de pompiers en entrée aux entités polygone de zone de desserte 2, 3 et 5 minutes calculées à partir d'une analyse des zones de desserte. Le champ StationID permet de joindre d'autres attributs des entités de caserne de pompiers aux entités polygones de zone de desserte.

# 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)

Environnements

Espace de travail courant

Rubriques connexes

Vue d'ensemble du jeu d'outils Analyse

Informations de licence

ArcView : Oui

ArcEditor : Oui

ArcInfo : Oui

7/10/2012