Desktop Help 10.0 - Agregar campo a la capa de análisis (Network Analyst)

Resumen

Agrega un campo a una subcapa de una capa de análisis de red.

Uso

La herramienta se utiliza generalmente junto con la herramienta Agregar ubicaciones para transferir campos de las entidades de entrada a las subcapas. Por ejemplo, si desea transferir un campo llamado UniqueID desde las entidades de entrada a la subcapa Instalaciones de la capa de Área de servicio, utilice esta herramienta para agregar primero el campo UniqueID a la subcapa Instalaciones y después utilice la asignación de campos en la herramienta Agregar ubicaciones para proporcionar valores de entrada para el campo UniqueID.
Los campos se pueden agregar a cualquiera de las subcapas de las capas de análisis de red.

Sintaxis

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

Parámetro	Explicación	Tipo de datos
in_network_analysis_layer	La capa de análisis de red a la que se agregará el nuevo campo.	Network Analyst Layer
sub_layer	La subcapa de la capa de análisis de red a la que se agregará el nuevo campo.	String
field_name	El nombre del campo que se agregará a la subcapa especificada de la capa de análisis de red.	String
field_type	El tipo de campo utilizado en la creación del nuevo campo. LONG —Valores numéricos sin valores fraccionales dentro de un rango específico. TEXT —Nombres u otras cualidades textuales. FLOAT —Valores numéricos con valores fraccionales dentro de un rango específico. DOUBLE —Valores numéricos con valores fraccionales dentro de un rango específico. CORTO —Valores numéricos sin valores fraccionales dentro de un rango específico; valores codificados. DATE —Fecha u hora. BLOB —Imágenes u otra información multimedia.	String
field_precision (Opcional)	Describe la cantidad de dígitos que se pueden almacenar en el campo. Se cuentan todos los dígitos, independientemente del lado de la coma en que se encuentren. El valor de parámetro es válido sólo para tipos de campos numéricos.	Long
field_scale (Opcional)	Establece el número de posiciones decimales almacenadas en un campo. Este parámetro sólo se utiliza en los campos de datos de tipo flotante y doble.	Long
field_length (Opcional)	La longitud del campo que se está agregando. Esto establece el número máximo de caracteres permitidos para cada registro del campo. Esta opción sólo puede aplicarse a campos de tipo texto o blob.	Long
field_alias (Opcional)	El nombre alternativo dado al nombre de campo. Este nombre se utiliza para dar nombres más descriptivos a los nombres de campos crípticos. El parámetro de alias de campo sólo se aplica a geodatabases y coberturas.	String
field_is_nullable (Opcional)	Una entidad geográfica donde no hay información de atributos asociada. Son diferentes de los campos vacíos o cero y sólo son compatibles con los campos de una geodatabase. NON_NULLABLE —El campo no permitirá valores nulos. NULLABLE —El campo permitirá valores nulos. Esta es la opción predeterminada.	Boolean

Ejemplo de código

Ejemplo 1 de AddFieldToAnalysisLayer (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo agregar un campo UniqueID a la subcapa Instalaciones de una capa de análisis de red de Área de servicio.

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

Ejemplo 2 de AddFieldToAnalysisLayer (flujo de trabajo)

La siguiente secuencia de comandos independiente de Python muestra cómo se puede utilizar la función AddFieldToAnalysisLayer para transferir el campo StationID desde las entidades de estación de bomberos de entrada hasta las entidades poligonales de área de servicio de 2, 3 y 5 minutos calculadas a partir de un análisis del área de servicios. El campo StationID se puede utilizar para unir otros atributos de las entidades de estación de bomberos con las entidades poligonales de área de servicio.

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

Entornos

Espacio de trabajo actual

Temas relacionados

Información general sobre el conjunto de herramientas de análisis

Información de licencia

ArcView: Sí

ArcEditor: Sí

ArcInfo: Sí

7/11/2012