Package org.matsim.lanes

This package contains classes to add lanes to links.

A link may contain one or more lanes, that may have the following layout (Dashes stand for the borders of the QueueLink, equal signs (===) depict one lane, plus signs (+) symbolize a decision point where one lane splits into several lanes): 

 ----------------
 ================
 ----------------

 ----------------
          =======
 ========+
          =======
 ----------------

 ----------------
         ========
 =======+========
         ========
 ----------------
The following layouts are not allowed: 
 ----------------
 ================
 ================
 ----------------

 ----------------
 =======
        +========
 =======
 ----------------

Adding lanes to a link means the following:

  • The link is split in two parts: The original lane at the beginning of the link and the lane part at it's end.
  • The original lane preserves the properties of the link without lanes.
  • The link may be widened or narrowed at its end due to the lanes.
  • Bottleneck is at the end of the original lane. This may have the consequence that spillback occurs faster.

All lane information is given by the top-level container Lanes. A lane is added to a link by adding a LaneToLinkAssignment instance to the container. For each link one LaneToLinkAssignment instance is needed, that holds all Lane instances for this specific link.

There is no extra test package for the lanes implementation. However tests for lanes can be found in the signals contrib test package.

Usage restrictions:

  • Each link's lanes must cover all toLinks of the link's toNode within the toLink information of the lanes.
  • Exactly one lane of each link has to have the link length, i.e. start at the beginning of the link ('original lane').
  • Each link's lanes except the original lane must have the same length.

Package Maintainer(s):

  • Theresa Thunig
Changes by non-maintainers are prohibited. Patches containing bugfixes or extensions however very welcome!