Сводка
Позволяет добавить поле в подслой слоя сетевого анализа.
Использование
Это инструмент, как правило, используется вместе с инструментом Добавить положения для переноса полей их объектов ввода на дочерние слои. Например, если необходимо перенести поле с именем UniqueID из входных объектов в дочерний слой Пункты обслуживания слоя Область обслуживания, используйте этот инструмент, чтобы сначала добавить поле UniqueID в дочерний слой Пункты обслуживания, а затем воспользуйтесь сопоставлением полей в инструменте Добавить положения для предоставления входных значений для поля UniqueID.
Поля можно добавлять в любой подслой слоев сетевого анализа.
Синтаксис
arcpy.na.AddFieldToAnalysisLayer(in_network_analysis_layer, sub_layer, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable})| Параметр | Объяснение | Тип данных |
in_network_analysis_layer | Слой сетевого анализа, к которому будет добавлено новое поле. | Network Analyst Layer |
sub_layer | Дочерний слой слоя сетевого анализа, к которому будет добавлено новое поле. | String |
field_name | Имя поля, добавляемого в указанный дочерний слой слоя сетевого анализа. | String |
field_type | Тип создаваемого поля.
| String |
field_precision (Дополнительный) | Число цифр, хранящихся в поле. Учитываются все цифры, независимо от их расположения относительно разделяющей запятой. Значение параметра действительно только для числовых типов полей. | Long |
field_scale (Дополнительный) | Количество знаков после запятой, хранящихся в поле. Этот параметр используется только с типами полей - с плавающей точкой и двойной точности. | Long |
field_length (Дополнительный) | Длина добавляемого поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Этот параметр доступен только для текстовых полей. | Long |
field_alias (Дополнительный) | Альтернативное имя, добавляемое в качестве псевдонима к имени поля. Это имя используется для описания непонятных имен полей. Данный параметр применяется только к базам геоданных. | String |
field_is_nullable (Дополнительный) | Определяет, может ли поле содержать пустые значения. Пустые (NULL) значения отличаются от 0 или пустых полей и поддерживаются только для полей в базе геоданных.
| Boolean |
Производные выходные данные
| Имя | Объяснение | Тип данных |
| output_layer | Обновленный слой сетевого анализа. | Слой Network Analyst |
Пример кода
AddFieldToAnalysisLayer, пример 1 (окно Python)
Следующий Скрипт в окне Python демонстрирует процедуру добавления поля UniqueID в подслой Пункты обслуживания слоя сетевого анализа Область обслуживания.
arcpy.na.AddFieldToAnalysisLayer("Service Area", "Facilities", "UniqueID",
"LONG")
AddFieldToAnalysisLayer, пример 2 (рабочий процесс)
Следующий автономный скрипт Python демонстрирует процесс использования функции AddFieldToAnalysisLayer для переноса поля StationID из входных объектов пожарных частей в объекты полигона зон 2-, 3- и 5-минутной доступности, вычисленные службой анализа площадей. Поле StationID может использоваться для объединения атрибутов объектов пожарных частей с объектами полигонов зон обслуживания.
# 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 occurred on line %i" % tb.tb_lineno
print str(e)
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да