Industrial Benchmark for OpenAI Gym
Project description
Industrial Benchmark for Gym
gym-industrial
is a standalone Python re-implementation of the Industrial Benchmark (IB) for OpenAI Gym.
D. Hein et al., 2017
A benchmark environment motivated by industrial control problems.
In IEEE Symposium Series on Computational Intelligence (SSCI) (pp. 1-8).
Installation
pip install gym-industrial
Environments
To register the environments in Gym, simply import the package at any point before calling gym.make
.
import gym
import gym_industrial
env = gym.make(<environment id>, **kwargs)
The main environment is registered in Gym as IndustrialBenchmark-v0
. The IB's sub-dynamics have also been implemented as Gym environments. Each contributes with different challenges to the overall task.
System | Environment ID | Features |
---|---|---|
Industrial Benchmark | IndustrialBenchmark-v0 | All of the following |
Operational Cost | IBOperationalCost-v0 | Delayed, blurred, nonlinear rewards |
Mis-calibration | IBMisCalibration-v0 | Partial observability, non-stationary dynamics |
Fatigue | IBFatigue-v0 | Heteroscedatisc noise, self-amplifying processes |
Dynamics as Stochastic Computation Graphs
The following are views of the Industrial Benchmark sub-dynamics, plus the reward function, as stochastic computation graphs (SCG).
The graphical notation used and the SCG definition are taken from Gradient Estimation Using Stochastic Computation Graphs.
Definition 1 (Stochastic Computation Graph). A directed, acyclic graph, with three types of nodes:
- Input nodes, which are set externally, including the parameters we differentiate with respect to.
- Deterministic nodes, which are functions of their parents.
- Stochastic nodes, which are distributed conditionally on their parents. Each parent v of a non-input node w is connected to it by a directed edge (v, w).
Squares denote deterministic nodes and circles, stochastic nodes. A special type of deterministic node, denoted by diamonds, indicates that a variable is a cost/reward and thus not part of the observation/state.
Node labels use the notation from the Industrial Benchmark paper and correspond to the variables in the equations therein.
Operational cost
The sub-dynamics of operational cost are influenced by the external driver setpoint p and two of the three steerings, velocity v and gain g.
The observation of operational cost is delayed and blurred by a convolution of past operational costs. In the graph below, denotes a vector of the past 10 values of the hidden operational cost, .
The motivation for this dynamical behavior is that it is non-linear, it depends on more than one influence, and it is delayed and blurred. All those effects have been observed in industrial applications, like the heating process observable during combustion.
Mis-calibration dynamics
The sub-dynamics of mis-calibration are influenced by external driver setpoint p and steering shift h. The goal is to reward an agent to oscillate in h in a pre-defined frequency around a specific operation point determined by setpoint p. Thereby, the reward topology is inspired by an example from quantum physics, namely Goldstone’s ”Mexican hat” potential.
The Goldstone potential-inspired reward is denoted below by the node for ease of presentation. Details of the function can be found in the implementation or in Appendix B of the paper.
Below is a visual description, taken from the paper, of the penalty landscape and oscillating dynamics.
Fatigue dynamics
The sub-dynamics of fatigue are influenced by the same variables as the sub-dynamics of operational cost, i.e., setpoint p, velocity v, and gain g. The IB is designed in such a way that, when changing the steerings velocity v and gain g as to reduce the operational cost, fatigue will be increased, leading to the desired multi-criterial task, with two reward components showing opposite dependencies on the actions.
The following SCG highlights the complex stochasticity of the Fatigue dynamics. The random variables don't have dedicated equations in the paper, but are sampled as follows ( denotes the exponential distribution and , the logistic function).
Reward function
In the real-world tasks that motivated the IB, the reward function has always been known explicitly. In some cases it itself was subject to optimization and had to be adjusted to properly express the optimization goal. For the IB we therefore assume that the reward function is known and all variables influencing it are observable.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file gym-industrial-0.0.7.tar.gz
.
File metadata
- Download URL: gym-industrial-0.0.7.tar.gz
- Upload date:
- Size: 15.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.3.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | f986d2d4310e2819a86fd65335a75280ec9dd860900a9836962b11b7c055ad9a |
|
MD5 | 802a6d89228feb47d3ca51644e831ed6 |
|
BLAKE2b-256 | 2b9f053579b7ceb2e56e1d2efe6b675539f59b20e6c0681fafae0002cfd0d429 |