Skip to main content

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:

  1. Input nodes, which are set externally, including the parameters we differentiate with respect to.
  2. Deterministic nodes, which are functions of their parents.
  3. 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, \overrightarrow{\theta} denotes a vector of the past 10 values of the hidden operational cost, \theta.

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 m_{t+1} 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 (\exp denotes the exponential distribution and \sigma, 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.

Metadata

Release files for gym-industrial 0.0.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gym-industrial 0.0.7
File Size Uploaded Provenance Actions
gym-industrial-0.0.7.tar.gz 15.2 kB Without provenance Details for gym-industrial-0.0.7.tar.gz

Release files / gym-industrial-0.0.7.tar.gz

Download URL gym-industrial-0.0.7.tar.gz
Size 15.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f986d2d4310e2819a86fd65335a75280ec9dd860900a9836962b11b7c055ad9a
BLAKE2b-256 checksum
How to use checksums
2b9f053579b7ceb2e56e1d2efe6b675539f59b20e6c0681fafae0002cfd0d429
Upload date
Uploaded using Trusted Publishing?
What is 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

Security for gym-industrial 0.0.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page