Краткая информация
Класс ArcPy, предназначенный для планирования маршрутов сбора отходов.
Обсуждение
Анализ сбора отходов дает возможность оптимизировать процесс сбора отходов в городе. Это можно использовать при планировании маршрутов для автопарка, выезжающего из одного и того же места и обслуживающего один район в течение одного дня.
Более подробно об анализе сбора отходов
Более подробно о том, как выполнить сетевой анализ с помощью arcpy.nax
Синтаксис
WasteCollection (in_network)
| Параметр | Описание | Тип данных |
in_network | Набор сетевых данных, который будет использоваться для сетевого анализа. Аргумент может быть задан с помощью одного из следующих значений:
Сеть должна иметь как минимум один режим передвижения, один атрибут стоимости с единицами времени и один атрибут стоимости с единицами расстояния. | String |
Свойства
| Свойство | Описание | Тип данных |
| allowAutoRelocate (чтение и запись) | Указывает, можно ли автоматически перемещать входные данные с существующими полями сетевого местоположения во время решения, чтобы обеспечить допустимые, маршрутизируемые поля местоположения для анализа. Если значение True, точки, расположенные на ограниченных элементах сети, и точки, на которые влияют барьеры, будут перемещены к ближайшему маршрутизируемому положению. Если значение False, поля сетевых местоположений будут использоваться как есть, даже если точки являются недостижимыми и могут привести к сбою расчета. Даже если значение False, входные данные без полей местоположений или с незаполненными полями местоположений будут расположены в процессе расчета. По умолчанию – True. Это свойство влияет на расположение всех входных типов. Для изменения этого свойства для отдельных входных типов используйте метод setLocateSettingsOverrides. Дополнительные сведения о полях местоположения сети и способе размещения входных данных в сети При задании этого свойства возникнет ошибка, если сетевой источник данных - ArcGIS Online, портал ArcGIS Enterprise, который не поддерживает использование сетевого полей местоположений, или портал, работающий под управлением ArcGIS Enterprise более ранней версии, чем 11.0. | Boolean |
| directionsLanguage (чтение и запись) | Язык, на котором будет отображаться выходной текст с указаниями пошаговых направлений. Свойство возвращается и устанавливается в виде строки с использованием одного из двух- или пятизначных кодов языков, представляющих поддерживаемые языки путевых листов. Список доступных языков путевых листов можно получить с помощью функции arcpy.nax.ListDirectionsLanguages. Значение по умолчанию - en (English) или язык активного в данный момент языкового пакета. | String |
| distanceUnits (чтение и запись) | Единицы, которые будут использоваться для расстояния перемещения в выходных данных анализа. Независимо от единиц измерения в стоимостных атрибутах набора сетевых данных выходные данные будут трансформированы в единицы, заданные в этом свойстве. Возвращается свойство и задается в качестве значения в перечислении DistanceUnits. По умолчанию – DistanceUnits.Kilometers. | Object |
| maxRouteTotalTime (чтение и запись) | Максимально допустимое общее время для каждого маршрута. Значением может быть любое положительное число. Значение используется для всех маршрутов, в которых поле MaxTotalTime в классе Routes имеет значение null. Если значение не указано, все строки класса Routes должны содержать значение в поле MaxTotalTime. Значение интерпретируется в единицах измерения, указанных в свойстве timeUnits. | Double |
| networkDataSource (только чтение) | Полный путь каталога к набору сетевых данных или URL сервиса, используемого для анализа. | String |
| overrides (чтение и запись) | Примечание:Это свойство только для внутреннего использования. | String |
| routeStartTime (чтение и запись) | Время начала маршрутов по умолчанию. Это время дня используется для всех маршрутов, у которых поле StartTime в классе Routes имеет значение null. Если значение не указано, все строки класса Routes должны содержать значение в поле StartTime. Используйте объект datetime.time для этого свойства. | DateTime |
| searchSources (чтение и запись) | При размещении входных данных в сети это свойство задает список используемых сетевых источников и, дополнительно, запрос на ограничение поиска поднабора объектов в классе исходных объектов. Значение по умолчанию — размещение на всех источниках ребер сети, исключая источники соединений сети. По умолчанию запрос не используется для любых источников. Внимание:Операция расчета завершится ошибкой, если на соединениях будут расположены какие-либо остановки.Значение параметра указывается как список с вложенными списками, не больше чем с одной записью на источник сети. Каждый внутренний список состоит из двух значений, указывающих имя сетевого источника и выражение SQL, используемое в качестве запроса для этого источника. Возможными значениями для компонента источника сети являются строковые имена классов объектов ребер и соединений, участвующих в сети. Источники в списке будут использоваться для размещения, источники вне списка - нет. Запросы полезны, если вы не хотите находить объекты, которые могут не подходить для сетевого положения. Например, если вы не хотите искать съезды с автомагистралей, можно задать запрос, исключающий их. Для корректного синтаксиса компонента запроса см. Основы SQL для выражений запроса, применяемых в ArcGIS. Пустая строка "" означает отсутствие запроса для определенного источника. Например, значение [["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]] указывает, что входные данные могут располагаться как в источниках Streets, так и в Streets_ND_Junctions. Выражение SQL для исходного класса пространственных объектов Streets запрещает входным данным находиться на улицах, где поле ROAD_CLASS имеет значение 3. Для исходного класса пространственных объектов Streets_ND_Junctions запрос не используется. Значение [["Streets", "ROAD_CLASS <> 3"]] указывает на то, что для поиска местоположений будет использоваться только исходный класс пространственных объектов Streets, и не будет использоваться Streets_ND_Junctions. Дополнительно, запрос применяется к Streets. Это свойство влияет на расположение всех входных типов. Для изменения этого свойства для отдельных входных типов используйте метод setLocateSettingsOverrides. Дополнительные сведения о способе размещения входных данных в сети | String |
| searchTolerance (чтение и запись) | Максимальный допуск поиска, который будет использоваться для расположения входных объектов в сети. Свойство возвращается и устанавливается как число двойной точности, и единицы этого значения доступны через свойство searchToleranceUnits. Значение по умолчанию равно 5000. Это свойство влияет на расположение всех входных типов. Для изменения этого свойства для отдельных входных типов используйте метод setLocateSettingsOverrides. Дополнительные сведения о способе размещения входных данных в сети | Double |
| searchToleranceUnits (чтение и запись) | Единицы измерения для свойства searchTolerance. Возвращается свойство и задается в качестве значения в перечислении DistanceUnits. По умолчанию – DistanceUnits.Meters. Это свойство влияет на расположение всех входных типов. Для изменения этого свойства для отдельных входных типов используйте метод setLocateSettingsOverrides. | Object |
| stopCollectionMode (чтение и запись) | Режим сбора для каждой остановки по умолчанию. Возвращается свойство и задается в качестве значения в перечислении StopCollectionMode. Значение используется для всех остановок, у которых поле CollectionMode в классе Stops имеет значение null. Если значение не указано, все строки класса Stops должны задавать значение в поле CollectionMode. | Object |
| timeUnits (чтение и запись) | Единицы, которые будут использоваться для времени перемещения в выходных данных анализа. Независимо от единиц измерения в стоимостных атрибутах набора сетевых данных выходные данные будут трансформированы в единицы, заданные в этом свойстве. Возвращается свойство и задается в качестве значения в перечислении TimeUnits. По умолчанию – TimeUnits.Minutes. | Object |
| travelMode (чтение и запись) | Режим передвижения, который будет использоваться в этом анализе. Атрибут импеданса режима передвижения должен содержать единицы измерения времени. Для анализа сбора отходов необходимо, чтобы в тупиках были разрешены развороты. Если режим передвижения не позволяет выполнять развороты, механизм расчета ослабит правила разворотов режима передвижения, чтобы разрешить развороты в тупиках. Выбор подходящего режима передвижения особенно важен для получения качественных результатов анализа сбора мусора, так как мусоровозы часто передвигаются по улицам, где запрещено движение личного транспорта, например, по частным дорогам, улицам с запретом сквозного проезда и дорогам, доступ к которым осуществляется через запертые ворота. Значение возвращается и устанавливается как объект arcpy.nax.TravelMode, но оно также может быть установлено с использованием текстового имени режима передвижения или строки, содержащей действительное представление JSON режима передвижения. По умолчанию используется режим передвижения, определенный в наборе сетевых данных, используемом для анализа. | Object |
Обзор метода
| Метод | Описание |
| addFields (input_type, field_description) | Добавляет пользовательские поля к заданному входному классу. Эти поля будут включены в словарь сопоставления полей, созданный методом fieldMappings, и будут также доступны для использования посредством метода insertCursor. Более подробно об использовании пользовательских полей во входных данных анализа |
| count (input_type) | Возвращает количество строк, добавленных к входному типу. |
| fieldMappings (input_type, {use_location_fields}, {list_candidate_fields}) | Создает словарь NAClassFieldMappings, который сопоставляет имена полей входного типа с объектами arcpy.nax.NAClassFieldMap, позволяющими вам сопоставлять поля входных данных свойствам механизма расчета. Словарь может использоваться в качестве входных данных аргумента field_mappings метода load. Более подробно об использовании сопоставления полей при загрузке входных данных |
| fieldNames (input_type, {use_location_fields}) | Получает список имен полей, поддерживаемых заданным входным типом. |
| insertCursor (input_type, field_names, {append}) | Задает курсор записи для заданного типа выходных данных. Этот курсор предназначен для добавления строк непосредственно во входных данных. |
| load (input_type, features, {field_mappings}, {append}, {max_features}) | Задает входные объекты для использования в анализе. |
| setLocateSettingsOverrides (input_type, {search_sources}, {allow_auto_relocate}, {search_tolerance}, {search_tolerance_units}) | Установите параметры поиска для назначенного входного класса, переопределяя параметры поиска, заданные по умолчанию для анализа. Это полезно, если вы хотите использовать разные правила для поиска разных входных данных. Например, в анализе матрицы стоимости Источник-Назначение вы можете использовать поисковый запрос, который применяется только к входным источникам, если этот запрос не должен применяться к входным пунктам назначения и барьерам. Используя этот метод, вы можете переопределить значения свойств searchSources, allowAutoRelocate, searchTolerance и searchToleranceUnits для назначенного входного класса. Дополнительные сведения о способе размещения входных данных в сети |
| solve () | Выполнить анализ сбора отходов с помощью свойств, заданных для объекта WasteCollection и загруженных входных данных. |
Методы
addFields (input_type, field_description)
| Параметр | Описание | Тип данных | ||||||||||||||||||||||||
input_type |
The type of input to which the fields will be added. Задайте этот параметр с помощью перечисления WasteCollectionInputDataType. | Object | ||||||||||||||||||||||||
field_description [field_description,...] | The fields and their properties that will be added to the input class. The value will be constructed as a list of lists with each row containing the following items:
Available field types are as follows:
Only the field name and type are required. Use None as a place holder for any of the other parameters to accept the default or if the parameter does not apply to the specified field type. The method will return an error if the field already exists in the table or if any of the field properties are invalid. | List |
count (input_type)
| Параметр | Описание | Тип данных |
input_type | Тип подсчитываемых входных объектов. Задайте этот параметр с помощью перечисления WasteCollectionInputDataType. | Object |
| Тип данных | Описание |
| Integer | Число строк. |
fieldMappings (input_type, {use_location_fields}, {list_candidate_fields})| Параметр | Описание | Тип данных |
input_type | The type of input for which the field mappings will be returned. Задайте этот параметр с помощью перечисления WasteCollectionInputDataType. | Object |
use_location_fields | Specifies whether network location fields will be included in the returned field mappings dictionary. Network location fields describe the point on the network where an object is located. You can use network location fields to more precisely control how analysis inputs locate on the network and to save time when calling the solve method because the solver will not have to calculate the location fields from the geometry of the inputs. You can calculate location fields for a feature class using the Calculate Locations tool. Learn more about network location fields and how inputs are located on the network When this argument is set to True, the returned field mappings dictionary will include network location fields. The default is False, which means the field mapping dictionary will not include network location fields. (Значение по умолчанию — False) | Boolean |
list_candidate_fields [list_candidate_fields,...] | Use this parameter to map additional, nondefault fields from the input data to the analysis inputs. For example, if the input feature class contains a field named MyField, and you want it to be included in the analysis inputs, pass the MyField field object to the list_candidate_fields parameter. MyField will be included in the returned field mapping dictionary and automatically mapped. When you call the load method using these field mappings, MyField will be included in the analysis inputs along with all the default fields. In many cases, these extra fields will be passed to the analysis output as well. Specify this parameter as a list of arcpy.Field objects, which can be obtained from a specified feature class or table using the arcpy.ListFields function. Learn more about best practices for setting up analysis inputs Прежние версии:If the network data source is an ArcGIS Enterprise portal, the method will return an error if any of the fields specified are of a type that is not supported by the portal version.(Значение по умолчанию — None) | Field |
| Тип данных | Описание |
| Dictionary | Словарь NAClassFieldMappings, в котором ключами являются имена полей, а значениями - объекты arcpy.nax.NAClassFieldMap. |
fieldNames (input_type, {use_location_fields})| Параметр | Описание | Тип данных |
input_type | Тип входных данных, для которых возвращаются поддерживаемые имена полей. Задайте этот параметр с помощью перечисления WasteCollectionInputDataType. | Object |
use_location_fields | Определяет, будут ли поля сетевого местоположения включены в возвращаемый список имён полей. Поля местоположения сети описывают точку сети, в которой расположен объект. Вы можете использовать поля местоположения сети для более точного контроля, как входные данные вашего анализа располагаются в сети в целях сохранения времени при вызове метода solve, поскольку механизм решения не будет вычислять поля местоположения из геометрии входных данных. Поле местоположения для класса объектов можно вычислить при помощи инструмента Вычислить местоположения. Дополнительные сведения о полях местоположения сети и способе размещения входных данных в сети Если значение аргумента - True, возвращаемый словарь сопоставления полей будет содержать только поля местоположения в сети. Значение по умолчанию - False; список имён полей не будет содержать поля местоположения в сети. (Значение по умолчанию — False) | Boolean |
| Тип данных | Описание |
| String | Список имен полей, поддерживаемых заданным входным типом. |
insertCursor (input_type, field_names, {append})| Параметр | Описание | Тип данных |
input_type | The type of input into which the cursor can be used to insert rows. Задайте этот параметр с помощью перечисления WasteCollectionInputDataType. | Object |
field_names [field_names,...] | A list of field names of the input type whose values you want to set when inserting rows using the cursor. You can get the names of the fields supported by an input type using the fieldNames method. Learn more about the fields available for each input type In addition to regular fields, you can also set the geometry of the input using one of the following geometry tokens:
The SHAPE@XY and SHAPE@XYZ tokens are only supported for point-based input types. When using the SHAPE@XY and SHAPE@XYZ tokens, specify the x-, y-, and z-values in the spatial reference of the network data source being used in the analysis. | String |
append | Specifies whether the features being inserted will be appended to the existing set of features for the input type. A value of True indicates that the new features will be appended; the existing features will be preserved. This is the default. A value of False indicates that any existing features for the input type will be deleted and replaced with the features being inserted. (Значение по умолчанию — True) | Boolean |
| Тип данных | Описание |
| Object | Объект SolverInsertCursor, который можно использовать для записи пространственных объектов. |
load (input_type, features, {field_mappings}, {append}, {max_features})| Параметр | Описание | Тип данных |
input_type | The type of input feature that will be loaded. Задайте этот параметр с помощью перечисления WasteCollectionInputDataType. | Object |
features | The input features that will be loaded. This parameter accepts the following input types:
For layer inputs, only selected features will be loaded. If a layer has a definition query, only the subset of features visible with the definition query will be loaded. The method also honors the Extent geoprocessing environment; only features in the specified extent will be loaded. | String |
field_mappings | An NAClassFieldMappings dictionary that maps the field names of the input type to arcpy.nax.NAClassFieldMap objects representing the mapping of fields from the input features. Valid input for this parameter can be constructed using the fieldMappings method. If no field mappings are specified, all fields from the input features that have the same name as the supported fields for the input type will be mapped. Learn more about the fields available for each input type (Значение по умолчанию — None) | Dictionary |
append | Specifies whether the features being loaded will be appended to the existing set of features for the input type. A value of True indicates that the new features will be appended, and existing features will be preserved. This is useful when loading inputs from multiple feature classes or tables to use in a single analysis. This is the default. A value of False indicates that any existing features for the input type will be deleted and replaced with the features currently being loaded. (Значение по умолчанию — True) | Boolean |
max_features | The maximum number of features that can be loaded into the input type. This is useful if you are creating a tool or service and want an error returned if the size of the input exceeds the available resources. The load method will return an arcpy.nax.LimitError if the number of input features exceeds the max_features limit. If no value is provided, no limit will be enforced for the count of the input features. (Значение по умолчанию — None) | Integer |
setLocateSettingsOverrides (input_type, {search_sources}, {allow_auto_relocate}, {search_tolerance}, {search_tolerance_units})| Параметр | Описание | Тип данных |
input_type | The type of input for which to override default locate settings. Задайте этот параметр с помощью перечисления WasteCollectionInputDataType. | Object |
search_sources [[Source, Expression],...] | The list of network sources to be used when locating inputs of the designated type on the network, and, optionally, a query to restrict the search to a subset of the features within a source feature class. See the documentation for the searchSources property for examples of proper syntax for this parameter. Specifying a value for this parameter overrides the default searchSources property value for the designated input type. If this parameter is not specified or is set to None, the searchSources value will be used for this input type. Внимание:The solve will fail if any stops are located on junctions. | String |
allow_auto_relocate | Specifies whether inputs of the designated type with existing network location fields can be automatically relocated at solve time to ensure valid, routable location fields for the analysis. If the value is True, points located on restricted network elements and points affected by barriers will be relocated to the closest routable location. If the value is False, network location fields will be used as is, even if the points are unreachable, and this may cause the solve to fail. Even if the value is False, inputs with no location fields or incomplete location fields will be located at solve time. Specifying a value for this parameter overrides the default allowAutoRelocate property value for the designated input type. If this parameter is not specified or is set to None, the allowAutoRelocate value will be used for this input type. The method returns an error if the network data source is ArcGIS Online. The method returns an error if the network data source is an ArcGIS Enterprise portal that does not support using network location fields. | Boolean |
search_tolerance | The maximum search distance to use when locating inputs of the designated type on the network. Specifying a value for this parameter overrides the default searchTolerance property value for the designated input type. If this parameter is not specified or is set to None, the searchTolerance value will be used for this input type. The units of this parameter value are set using the search_tolerance_units parameter; however, if no value is set for that parameter, the search_tolerance value will be interpreted in the units specified in the searchToleranceUnits property. This parameter does not apply to line and polygon barriers; the method will return an error if this parameter is specified when the input_type value is one of these barrier types. | Double |
search_tolerance_units | The units of the maximum search distance when locating inputs of the designated type of the network. The parameter is specified using a member of the DistanceUnits enumeration. Specifying a value for this parameter overrides the default searchToleranceUnits property value for the designated input type. If this parameter is not specified or is set to None, the searchToleranceUnits will be used for this input type. The value specified using the search_tolerance parameter is interpreted using these units. If that parameter is not specified, the value of the searchTolerance property will be interpreted using these units for the designated input type only. This parameter does not apply to line and polygon barriers; the method will return an error if this parameter is specified when the input_type value is one of these barrier types. | Double |
solve ()
| Тип данных | Описание |
| Object | Объект arcpy.nax.WasteCollectionResult, который можно использовать для доступа к выходным данным и сообщениям механизма расчета. |
Пример кода
Выполняет анализ сбора отходов с использованием входных данных классов объектов и таблиц.
# An example showing how to perform waste collection analysis using inputs
# from feature classes and tables.
import datetime
import arcpy
arcpy.CheckOutExtension("network")
# Define inputs
nds = "C:/data/MyCity.gdb/Routing/Routing_ND"
nd_layer_name = "Routing_ND"
input_stops = "C:/data/io.gdb/BinLocations"
input_depots = "C:/data/io.gdb/Depots"
input_routes = "C:/data/io.gdb/Trucks"
input_renewals = "C:/data/io.gdb/Landfill"
input_route_renewals = "C:/data/io.gdb/RouteRenewals"
# Define outputs
output_stops = "C:/data/io.gdb/OutputBins"
output_routes = "C:/data/io.gdb/OutputTrucks"
# Create a network dataset layer and get the desired travel mode for analysis
arcpy.nax.MakeNetworkDatasetLayer(nds, nd_layer_name)
nd_travel_modes = arcpy.nax.GetTravelModes(nd_layer_name)
# travel_mode = nd_travel_modes["Garbage Truck Time"]
travel_mode = nd_travel_modes["Driving Time"]
# Instantiate a WasteCollection solver object
waste_collection = arcpy.nax.WasteCollection(nd_layer_name)
# Set properties
waste_collection.travelMode = travel_mode
waste_collection.stopCollectionMode = arcpy.nax.StopCollectionMode.OneSide
waste_collection.routeStartTime = datetime.time(6, 0, 0)
waste_collection.timeUnits = arcpy.nax.TimeUnits.Hours
waste_collection.maxRouteTotalTime = 6 # hours
# Load inputs
waste_collection.load(arcpy.nax.WasteCollectionInputDataType.Stops, input_stops)
waste_collection.load(arcpy.nax.WasteCollectionInputDataType.Depots, input_depots)
waste_collection.load(arcpy.nax.WasteCollectionInputDataType.Routes, input_routes)
waste_collection.load(arcpy.nax.WasteCollectionInputDataType.Renewals, input_renewals)
waste_collection.load(arcpy.nax.WasteCollectionInputDataType.RouteRenewals, input_route_renewals)
# Solve the analysis
result = waste_collection.solve()
# Export the results to feature classes
if result.solveSucceeded:
result.export(arcpy.nax.WasteCollectionOutputDataType.Stops, output_stops)
result.export(arcpy.nax.WasteCollectionOutputDataType.Routes, output_routes)
else:
print("Solve failed")
print(result.solverMessages(arcpy.nax.MessageSeverity.All))