Plot4GMNS: An open-source academic research tool for visualizing multimodal networks for transportation system modeling and optimization

Authors: Dr. Junhua Chen, Zanyang Cui

Email: cjh@bjtu.edu.cn, zanyangcui@outlook.com

Introduction

To enable rapid transportation modeling and optimization, as railroad management researchers, we provide this free open-source tool for visualizing multimodal networks. Based on GMNS data format by Zepha foundation, plot4gmns is designed for reading and plotting multimodal data sets including transportation network files, demand and agent trace files.

Requirements

• pandas
• shapely
• matplotlib<=3.3.0
• numpy
• seaborn
• scipy
• chardet

Installation

pip install plot4gmns

Note

• For Windows users, the pip method might fail to install some dependencies. If errors occur when you try to install any of those dependencies, try instead to pip install their .whl files, which can be downloaded from the Unoffical Windows Binaries for Python Extension Packages.

Simple Example

>>>import plot4gmns as pg

"""Step 1: Reading network files"""
net=pg.readNetwork('./data')

"""Step 2: Visualizing network of different modes"""
# show all modes network
pg.showNetByAllMode(net)
# show auto mode network
pg.showNetByAutoMode(net)

"""Step 3: Visualizing network by node attributes"""
# show network by node ‘ctrl_type’ for 1 as signalized intersection
pg.showNetByNodeAttr(net,{'ctrl_type':1})

"""Step 4: Visualizing network by link attributes"""
# show network by given link type names
pg.showNetByLinkAttr(net,{'link_type_name':'secondary'})

"""Step 5: Visualizing network by POI attributes"""
# show network by given POI building types
pg.showNetByPOIAttr(net,{'building':'parking'})

"""Step 6: Visualizing network by zone attributes"""
# show network by zone demand traces
pg.showNetByZoneDemandFlow(net)

"""Step 7: Visualizing network by agent traces"""
pg.showNetByAgentTrace(net,agent_id=1)

User guide

Users can check the user guide for detialed introduction of plot4gmns.