Metadata-Version: 2.1
Name: Heterogeneous-Highway-Env
Version: 0.0.2
Summary: Codebase for for our version of highway-way modified for iPLAN paper
Home-page: https://github.com/wuxiyang1996/HighwayEnv_iPLAN
Author: Xiyang Wu
Author-email: wuxiyang1996@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE

# Heterogeneous Highway-env for iPLAN
Our forked version of [highway-env](https://github.com/Farama-Foundation/HighwayEnv) used in our paper:

[iPLAN: Intent-Aware Planning in Heterogeneous Traffic via Distributed Multi-Agent Reinforcement Learning](https://arxiv.org/abs/2306.06236)

More details could be found in the main page of [highway-env](https://github.com/Farama-Foundation/HighwayEnv)
and [iPLAN](https://github.com/wuxiyang1996/iPLAN).

# Installation
```angular2html
pip install HighwayEnv-iPLAN
```

# Major Changes
* Add two behavior-driven vehicle models, `DefensiveVehicle` and `AggressiveVehicle` in `vehicle/behavior.py`.
* Add multi-agent support for `Highway` scenario given in `envs/highway_env.py`, modify the `MultiAgentWrapper`
in `vehicle/common/abstract.py`.
* Add three heterogeneous traffic scenarios, `HighwayEnvHetero`, `HighwayEnvHetero_H` and `HighwayEnvHetero_VH`
in `envs/highway_env.py`, with vehicle ID broadcasting and different behavior-driven vehicles.
* Add multi-agent support for visualization in `Highway` scenario that allows a camera following each agent
and visualize their surroundings from their respective viewpoints.

# Animation
The animation shows 5 such learning agents (Green) with their surroundings from their respective viewpoints. 
Behavior-driven vehicles in the environment include: Normal (Blue), Aggressive (Purple) and Defensive (Yellow).
Vehicles terminate (Red) when colliding with other vehicles.

<p align="center">
    <img src="Heterogeneous_Highway_Env/animation/iPLAN_Hetero_H_5_90.0_21.81.gif"><br/>
    <em> iPLAN in chaotic (hard) scenario of Heterogeneous Highway 
    (Num of agents succeed: 5, Avg. survival time: 90, Avg. speed: 21.81).</em>
</p>
