v1.6.2

Includes fixes to bugs introduced in matplotlib versions >= 3.7

v1.6.1

Includes fixes to bugs with dashed line scaling and stopline generation introduced by API changes in matplotlib and shapely.

v1.6.0

Adds easier method for generating a colorbar corresponding to a colorized trajectory. Now, a colorbar can be generated like so:

plt.colorbar(trajectories["vehicle_id"].mappable)

See the README and documentation for more information.

v1.5.2

Contains minor bugfixes for errors that occur when generating stopline geometry for short or unusually shaped lanes.

v1.5.1

Includes minor bugfix to avoid crashing when stopline generation fails (due to a very short lane).

Extensibility and Customization

This release consists of a number of enhancements to the extensibility and customizability of the library, including:

• Generic parameters
  • Loaded into respective objects from network, additionals, and FCD files
  • Can be used to implement custom functionality, or OOTB to control trajectory colorization, OBJ material, and OBJ extrude height
• Availability of Matplotlib Artists
  • All matplotlib artists generated by plotting functions are now returned by said functions (with an additional link to the generating object)
  • Enables custom animations and manipulation of plotted objects
  • Enables creating interactive figures
• netOffset support
  • When loading a network, the netOffset and projParameter values are read into the Net object. On plotting, the inverse of the netOffset can optionally be applied to transform the location of the network.

Performance Improvements

This release consists of the following improvements:

• Massive performance increase when loading large network files
• Replace print statements with warnings in Net class
• Fix incorrect OBJ material name for pedestrian_connection
• Fix crash when encountering a lane with bad geometry
• Fix crash when encountering a request object without a "cont" attribute

OBJ Export Enhancements

This release features two new features for OBJ export:

• Optional generation of a flat planar "terrain" mesh within a given buffer distance of network objects
• Ability to map default material names to user-defined ones via the material_mapping parameter

See full documentation and README for more information.

Bug Fixes

Contains the following fixes:

• Face normals in OBJ export are now properly oriented
• Catch exceptions when invalid or unexpected geometry is generated by the shapely parallel_offset function
• Allow passing of "color" kwarg to all plotting functions

Bug Fix

Fix API breakage due to circular import.