chao-jiang / astgcn

Attention Based Spatial-Temporal Graph Convolutional Networks for Traffic Flow Forecasting (ASTGCN) AAAI 2019

ASTGCN

Attention Based Spatial-Temporal Graph Convolutional Networks for Traffic Flow Forecasting (ASTGCN)

References

• Shengnan Guo, Youfang Lin, Ning Feng, Chao Song, Huaiyu Wan(*). Attention Based Spatial-Temporal Graph Convolutional Networks for Traffic Flow Forecasting. The 33rd AAAI Conference on Artificial Intelligence (AAAI'19) 2019.

Datasets

We validate our model on two highway traffic datasets PeMSD4 and PeMSD8 from California. The datasets are collected by the Caltrans Performance Measurement System (PeMS) (Chen et al., 2001) in real time every 30 seconds. The traffic data are aggregated into every 5-minute interval from the raw data. The system has more than 39,000 detectors deployed on the highway in the major metropolitan areas in California. Geographic information about the sensor stations are recorded in the datasets. There are three kinds of traffic measurements considered in our experiments, including total flow, average speed, and average occupancy.

We provide two dataset: PEMS-04, PEMS-08

1. PEMS-04:

   307 detectors
   Jan to Feb in 2018
   3 features: flow, occupy, speed.

2. PEMS-08:

   170 detectors
   July to Augest in 2016
   3 features: flow, occupy, speed.

Requirements

• python3
• mxnet >= 1.3.0
• mxboard
• numpy
• scipy
• pandas
• scikit-learn

To install MXNet correctly, you should follow the instruction provided by this page.

To run mxboard, you have to install tensorflow and tensorboard.

The other dependencies can be installed using the following command:

pip install -r requirements.txt

Usage

train model on PEMS04:

python train.py --config configurations/PEMS04.conf

train model on PEMS08:

python train.py --config configurations/PEMS08.conf

visualize training progress:

tensorboard --logdir logs --port 6006

then open http://127.0.0.1:6006 to visualize the training process.

load parameters and predict:

python predict.py --config configurations/PEMS04.conf

Improvements

1. We use convolutional operation to map the output of ASTGCN block to the label space because that can help the model achieve a better performance.

Configuration

The configuration file config.conf contains three parts: Data, Training and Predict:

Data

• adj_filename: path of the adjacency matrix file
• graph_signal_matrix_filename: path of graph signal matrix file
• num_of_vertices: number of vertices
• num_of_features: number of features
• points_per_hour: points per hour, in our dataset is 12
• num_for_predict: points to predict, in our model is 12

Training

• model_name: ASTGCN or MSTGCN
• ctx: set ctx = cpu, or set gpu-0, which means the first gpu device
• optimizer: sgd, RMSprop, adam, see this page for more optimizer
• learning_rate: float, like 0.0001
• epochs: int, epochs to train
• batch_size: int
• num_of_weeks: int, how many weeks' data will be used
• num_of_days: int, how many days' data will be used
• num_of_hours: int, how many hours' data will be used
• K: int, K-order chebyshev polynomials will be used
• prediction_filename: str, if you specify this parameter, it will save the prediction of current testing set into this file
• params_dir: the folder for saving parameters

Predict

• params_file: str, path of parameters
• data_file: str, path of input data, which should be in npz format, contain key "data"
• prediction_filename: str, the folder for saving prediction results