Awesome

Long-Horizon Visual Planning with Goal-Conditioned Hierarchical Predictors

[Project Website]

Karl Pertsch^*1, Oleh Rybkin^*2, Frederik Ebert³, Chelsea Finn⁴, Dinesh Jayaraman², Sergey Levine³<br/> (* equal contribution)

¹University of Southern California ²University of Pennsylvania ³UC Berkeley ⁴Stanford

This is the official Pytorch implementation for our paper Long-Horizon Visual Planning with Goal-Conditioned Hierarchical Predictors.

Installation

To install the module, run the following commands:

git clone --recursive git@github.com:orybkin/video-gcp.git
cd video-gcp

virtualenv -p $(which python3) ./venv
source ./venv/bin/activate
pip3 install -r requirements.txt
python3 setup.py develop

Model Training

To train a tree-structured prediction model start by setting paths for data and experiment logs:

export GCP_DATA_DIR=./data
export GCP_EXP_DIR=./experiment_logs

Note that the data will be automatically downloaded upon first running the model training code.

To start training the GCP model on the 25-room navigation dataset, run:

cd gcp
python3 prediction/train.py --path=../experiments/prediction/25room/gcp_tree/ --skip_first_val=1

The training logs get written into GCP_EXP_DIR and can be displayed by opening a Tensorboard in this folder: tensorboard --logdir=$GCP_EXP_DIR.

Planning Experiments

For running planning experiments we need to set up a virtual display for rendering (skip this step if you are not running on a headless machine).

Xvfb -screen 0 320x240x24 &
export DISPLAY=:0

Next, we need to install the gym-miniworld submodule:

cd gym-miniworld
python3 setup.py develop

To run a planning evaluation run with the previously trained model, execute:

cd gcp
python3 planning/run.py ../experiments/control/25room/gcp_tree/mod_hyper.py

To compute the control performance metrics (success rate and trajectory cost), run:

python evaluation/compute_control_perf.py --path=${GCP_EXP_DIR}/control/25room/gcp_tree/scores_0to99.pkl --n_rooms=25

Modifying the Code

Running on a new dataset

If you want to run our model on a new dataset, the easiest is to subclass FolderSplitVarLenVideoDataset and overwrite the __getitem__() method to load your data. Then just point to your custom data loader in the config file. Our code expects the data loader's __getitem__() function to output a dictionary with the following structure:

dict({
    'traj_seq': (time, channels, heigth, width) # zero-padded sequence of max_seq_len
    'pad_mask': (time,)                         # one for all time steps that are zero-padded, 0 otherwise
    'I_0': (channels, height, width)            # start image
    'I_g': (channels, height, width)            # goal image
    'end_ind': int                              # index of goal image in the demo sequence
    'states': (time, state_dim)                 # (optional) state sequence corresponding to image sequence, for training state regressor
    'actions': (time, action_dim)               # (optional) action sequence for training inverse model
})

Further your dataset folder is expected to have the following structure:

< dataset_path >
       |-- dataset_spec.py      # specifies state/action dimensions + sequence length
       |-- train/               # training trajectory files
       |-- val/                 # validation trajectory files
       |-- test/                # test trajectory files

You can find an example dataset_spec.py file here. By default the data loader will search for all .h5 files in the train/val/test subfolders to compile the list of filenames. If you want to load from a different file format or have a different folder structure you need to adjust the get_filenames() function accordingly.

Modifying the predictive model

The proposed goal-conditioned predictors are implemented in the prediction directory. Below we describe the functionality implemented in the different files to allow for quick adjustments.

A significant amount of utils developed by us for this and other projects are in the blox repo, including tools for quick fully connected, convolutional, and recurrent architectures, operations on nested tensor dictionaries, tools for probabilistic deep learning, and tools to interface numpy and torch code.

Modifying the planning algorithm

The code that implements the image-based planning and control approach described in the paper is in the planning directory. Below we describe the functionality implemented in the different files to allow for quick adjustments.

Most of the infrastructure for the planning experiments (start / goal loading, logging, interaction between environment and agent) directly builds on the Visual Foresight codebase and can be found in the infra directory.

Generating navigation data with new layout

We provide an example script for using a PRM planner to generate a new navigation dataset in an environment with 16 rooms. The layout can be further adjusted here. The nworkers argument allows for parallelized data generation.

cd recursive_planning
python3 planning/run.py ../experiments/data_gen/nav_16rooms/mod_hyper.py --nworkers=4

Downloading the datasets

The training code automatically downloads the required datasets if they are not already in the expected folders. However, if you want to download the datasets independently, you can find the zip files here:

Bibtex

If you find this work useful in your research, please consider citing:

@article{pertsch2020gcp,
    title={Long-Horizon Visual Planning with Goal-Conditioned Hierarchical Predictors},
    author={Karl Pertsch and Oleh Rybkin and Frederik Ebert 
    and Chelsea Finn and Dinesh Jayaraman and Sergey Levine},
    year={2020},
    journal={arXiv preprint arXiv:2006.13205},
}

Acknowledgements

Parts of the planning code are based on the Visual Foresight codebase.

In parallel with this method, we developed the blox python module, which contains many useful utilities and architectures for pytorch. Check it out and let us know if it was useful!