Disponible con una licencia de 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. | ArcGIS 10.1 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.
| String |
field_precision (Opcional) | Número 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) | Número de posiciones decimales almacenadas en un campo. Este parámetro solo 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) | Especifica si el campo puede contener valores nulos. Los valores nulos son diferentes de los campos vacíos o cero y solo son compatibles con los campos de una geodatabase.
| 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.
arcpy.na.AddFieldToAnalysisLayer("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 Address field from the input fire station
# features to the 2-,3-, and 5-minute service area polygon features
# calculated from a service area analysis. The Address 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"
outNALayerName = "FireStationsCoverage"
impedanceAttribute = "TravelTime"
defaultBreakValues = "2 3 5"
fieldName = "Address"
fieldType = "TEXT"
inFeatures = "Analysis/FireStations"
searchTolerance = "2 Miles"
outFeatures = outNALayerName + "Area"
saFacilities = "Facilities"
saPolygons = "SAPolygons"
#Create a new service area analysis layer. For this scenario, the default
#value for all the remaining parameters statisfies the analysis requirements
outNALayer = arcpy.na.MakeServiceAreaLayer(inNetworkDataset, outNALayerName,
impedanceAttribute,"",
defaultBreakValues)
#Get the layer object from the result object. The service layer can now be
#referenced using the layer object.
outNALayer = outNALayer.getOutput(0)
#Get the names of all the sublayers within the service area layer.
subLayerNames = arcpy.na.GetNAClassNames(outNALayer)
#Stores the layer names that we will use later
facilitiesLayerName = subLayerNames[saFacilities]
polygonLayerName = subLayerNames[saPolygons]
#Get the layer objects for all the sublayers within the service area layer
#The first layer returned by ListLayers is the Service area layer itself
#which we don't want to use.
subLayers = {}
for layer in arcpy.mapping.ListLayers(outNALayer)[1:]:
subLayers[layer.datasetName] = layer
#Store the layer objects that we will use later
facilitiesLayer = subLayers[saFacilities]
polygonLayer = subLayers[saPolygons]
#Add a Address field to the Facilities sublayer of the service area layer.
#This is done before loading the fire stations as facilities so that the
#Address values can be transferred from the input features to the
#Facilities sublayer. The service area layer created previously is
#referred by the layer object.
arcpy.na.AddFieldToAnalysisLayer(outNALayer,facilitiesLayerName,fieldName,
fieldType)
#Add the fire station features as Facilities and map the Name and the
#Address properties from the Name and Address fields from fire station
#features using the field mappings.
fieldMappings = arcpy.na.NAClassFieldMappings(outNALayer, facilitiesLayerName)
fieldMappings['Name'].mappedFieldName = "Name"
fieldMappings['Address'].mappedFieldName = "Address"
arcpy.na.AddLocations(outNALayer,facilitiesLayerName,inFeatures,
fieldMappings, searchTolerance)
#Solve the service area layer
arcpy.na.Solve(outNALayer)
#Transfer the Address field from Facilities sublayer to Polygons sublayer
#of the service area layer since we wish to export the polygons. The
#FacilityID field in Polygons sub layer is related to the ObjectID field in
#the Facilities sub layer.
arcpy.management.JoinField(polygonLayer, "FacilityID",facilitiesLayer,
"ObjectID", fieldName)
#Export the Polygons sublayer to a feature class on disk.
arcpy.management.CopyFeatures(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
Información sobre licencias
- ArcGIS for Desktop Basic: Sí
- ArcGIS for Desktop Standard: Sí
- ArcGIS for Desktop Advanced: Sí