README.md 1.44 KB
Newer Older
metataro's avatar
metataro committed
1 2
# NeurIPS 2020 Flatland Challenge baselines

MasterScrat's avatar
MasterScrat committed
3
📈 [**Results**](https://app.wandb.ai/masterscrat/flatland/reports/Flatland-Baselines--Vmlldzo4OTc5NA) 
metataro's avatar
metataro committed
4

MasterScrat's avatar
MasterScrat committed
5 6
Setup
---
MasterScrat's avatar
MasterScrat committed
7 8 9 10 11 12 13

Tested with Python 3.6 and 3.7

```
conda create --name ray-env python=3.7 --yes
```

MasterScrat's avatar
MasterScrat committed
14
You may need to install/update bazel: [Ubuntu guide](https://docs.bazel.build/versions/master/install-ubuntu.html)
MasterScrat's avatar
MasterScrat committed
15

metataro's avatar
metataro committed
16 17 18 19 20 21 22 23
```
pip install ray[rllib]
pip install tensorflow # or tensorflow-gpu
pip install -r requirements.txt
```

## Usage
Training example:
MasterScrat's avatar
MasterScrat committed
24 25

`python ./train.py -f experiments/flatland_random_sparse_small/global_obs_conv_net/ppo.yaml`
metataro's avatar
metataro committed
26 27

Test example:
MasterScrat's avatar
MasterScrat committed
28 29 30

`python ./rollout.py /tmp/ray/checkpoint_dir/checkpoint-0 --run PPO --no-render
        --config '{"env_config": {"test": true}}' --episodes 1000 --out rollouts.pkl`
metataro's avatar
metataro committed
31 32 33 34 35

Note that -f overrides all other trial-specific command-line options.

## Experiment structure

MasterScrat's avatar
MasterScrat committed
36 37
Experiments consist of one or many RLlib YAML config files alongside a MARKDOWN file containing results, plots and a detailed description of the methodology.

metataro's avatar
metataro committed
38 39
All files are stored in a experiment folder under `experiments/<env-name>/<experiment-name>`.

MasterScrat's avatar
MasterScrat committed
40 41 42 43 44 45
- [Tree observations w/ fully connected network](master/experiments/flatland_random_sparse_small/tree_obs_fc_net)
- [Global observations w/ convnet](Global observation convnet experiments)


Notes
---
metataro's avatar
metataro committed
46

MasterScrat's avatar
MasterScrat committed
47
- The basic structure of this repository is adopted from [https://github.com/spMohanty/rl-experiments/](https://github.com/spMohanty/rl-experiments/)