3. Parameter File¶
System Assignment Distribution Network
3.1. Network¶
There are three groups of parameters under the network section: links, nodes & OSM. The first are basically responsible for the design of the network to be created in case a new project/network is to bre created from scratch, and for now each one of these groups contains only a single group of parameters called fields.
3.1.1. link fields¶
The section for link fields are divided into one-way fields and two-way fields, where the two-way fields will be created by appending _ab and _ba to the end of each field’s name.
There are 5 fields which cannot be changed, as they are mandatory fields for an AequilibraE network, and they are link_id, a_node, b_node, direction, length and modes. The field geometry is also default, but it is not listed in the parameter file due to its distinct nature.
The list of fields required in the network are enumerated as an array under either one-way or two-way in the parameter file, and each field is a dictionary/hash that has the field’s name as the only key and under which there is a field for description and a field for data type. The data types available are those that exist within the SQLite specification . We recommend limiting yourself to the use of integer, numeric and varchar.
For the case of all non-mandatory fields, two more parameters are possible: osm_source and osm_behaviour. Those two fields provide the necessary information for importing data from Open Street Maps in case such resource is required, and they work in the following way:
osm_source: The name of the tag for which data needs to be retrieved. Common tags are highway, maxspeed and name. The import result will contain a null value for all links that do not contain a value for such tag.
Within OSM, there is the concept of tags for each link direction, such as maxspeed:forward and maxspeed:backward. However, it is not always that a two-directional link contains tag values for both directions, and it might have only a tag value for maxspeed.
Although for maxspeed (which is the value for posted speed) we might want to copy the same value for both directions, that would not be true for parameters such as lanes, which we might want to split in half for both directions (cases with an odd number of lanes usually have forward/backward values tagged). For this reason, one can use the parameter osm_behaviour to define what to do with numeric tag values that have not been tagged for both directions. the allowed values for this parameter are copy and divide, as shown below.
The example below also shows that it is possible to mix fields that will be imported from OSM posted speed and number of lanes, and fields that need to be in the network but should not be imported from OSM, such as link capacities.
3.1.2. Node fields¶
The specification for node fields is similar to the one for link fields, with the key difference that it does not make sense to have fields for one or two directions and that it is not possible yet to import any tagged values from OSM at the moment, and therefore the parameter osm_source would have no effect here.
3.2. Open Street Maps¶
The OSM group of parameters has as its only there are further groups: modes and all_link_types.
List of key tags we will import for each mode. Description of tags can be found on Open-Street Maps, and we recommend not changing the standard parameters unless you are exactly sure of what you are doing.
For each mode to be imported there is also a mode filter to control for non-default behaviour. For example, in some cities pedestrians a generally allowed on cycleways, but they might be forbidden in specific links, which would be tagged as pedestrian:no. This feature is stored under the key mode_filter under each mode to be imported.
There is also the possibility that not all keywords for link types for the region being imported, and therefore unknown link type tags are treated as a special case for each mode, and that is controlled by the key unknown_tags in the parameters file.