pink-noise-rl 2.0.1

Pink noise for exploration in reinforcement learning

Colored Action Noise for Deep RL

This repository contains easy-to-use implementations of pink noise and general colored noise for use as action noise in deep reinforcement learning. Included are the following classes:

• ColoredNoiseProcess and PinkNoiseProcess for general use, based on the colorednoise library
• ColoredActionNoise and PinkActionNoise to be used with deterministic policy algorithms like DDPG and TD3 in Stable Baselines3, both are subclasses of stable_baselines3.common.noise.ActionNoise
• ColoredNoiseDist, PinkNoiseDist to be used with stochastic policy algorithms like SAC in Stable Baselines3
• MPO_CN for using colored noise (incl. pink noise) with MPO using the Tonic RL library.

For more information, please see our paper: Pink Noise Is All You Need: Colored Noise Exploration in Deep Reinforcement Learning (ICLR 2023 Spotlight).

Installation

You can install the library via pip:

pip install pink-noise-rl

Note: In Python, the import statement is simply import pink.

Usage

We provide minimal examples for using pink noise on SAC, TD3 and MPO below. An example comparing pink noise with the default action noise of SAC is included in the examples directory.

Stable Baselines3: SAC, TD3

import gym
from stable_baselines3 import SAC, TD3

# All classes mentioned above can be imported from `pink`
from pink import PinkNoiseDist, PinkActionNoise

# Initialize environment
env = gym.make("MountainCarContinuous-v0")
seq_len = env._max_episode_steps
action_dim = env.action_space.shape[-1]

SAC

# Initialize agent
model = SAC("MlpPolicy", env)

# Set action noise
model.actor.action_dist = PinkNoiseDist(seq_len, action_dim)

# Train agent
model.learn(total_timesteps=100_000)

TD3

# Initialize agent
model = TD3("MlpPolicy", env)

# Set action noise
noise_scale = 0.3
model.action_noise = PinkActionNoise(noise_scale, seq_len, action_dim)

# Train agent
model.learn(total_timesteps=100_000)

Tonic: MPO

import gym
from tonic import Trainer
from pink import MPO_CN

# Initialize environment
env = gym.make("MountainCarContinuous-v0")
seq_len = env._max_episode_steps

# Initialize agent with pink noise
beta = 1
model = MPO_CN()
model.initialize(beta, seq_len, env.observation_space, env.action_space)

# Train agent
trainer = tonic.Trainer(steps=100_000)
trainer.initialize(model, env)
trainer.run()

Citing

If you use this code in your research, please cite our paper:

@inproceedings{eberhard-2023-pink,
  title = {Pink Noise Is All You Need: Colored Noise Exploration in Deep Reinforcement Learning},
  author = {Eberhard, Onno and Hollenstein, Jakob and Pinneri, Cristina and Martius, Georg},
  booktitle = {Proceedings of the Eleventh International Conference on Learning Representations (ICLR 2023)},
  month = may,
  year = {2023},
  url = {https://openreview.net/forum?id=hQ9V5QN27eS}
}

If there are any problems, or if you have a question, don't hesitate to open an issue here on GitHub.