ViroCon is a software to compute environmental contours

pip install virocon==2.0.12



GitHub Actions - CI Codecov Documentation Status Black

virocon is a Python package to compute environmental contours (user guide).


virocon can support you to design marine structures, which need to withstand load combinations based on wave, wind and current. It lets you define extreme environmental conditions with a given return period using the environmental contour method.

The following methods are implemented in virocon:

  • Defining a joint probability distributions using a global hierarchical model structure
  • Estimating the parameters of a global hierarchical model ("Fitting")
  • Computing an environmental contour using either the
    • inverse first-order reliability method (IFORM),
    • inverse second-order reliability method (ISORM),
    • the direct sampling contour method or the
    • highest density contour method.
    • Futher, "AND" and "OR" exceedance contours can be calculated.

How to use virocon


Make sure you have installed Python 3.8 or 3.9 by typing

python --version

in your shell.

(Older version might work, but are not actively tested)


Install the latest version of virocon from PyPI by typing

pip install virocon

Alternatively, you can install from virocon repository’s Master branch by typing

pip install

virocon is also available as a conda package. We recommend to first create a new environment.

conda create --name virocon python=3.9

And then activate that new environment and install virocon.

conda activate virocon
conda install -c virocon-organization virocon


virocon is designed as an importable package.

The folder examples contains python files that show how one can import and use virocon.

As an example, to run the file, use your shell to navigate to the folder that contains the file. Make sure that you have installed matplotlib and run the Python file by typing



Learn. Our user guide covers installation, requirements and overall work flow.

Code. The code’s documentation can be found here.

Paper. Our SoftwareX paper "ViroCon: A software to compute multivariate extremes using the environmental contour method." provides a concise description of virocon (version 1).

Conference presentation. In a WESC 2021 presentation, we showed how virocon (version 2) can be used to support the design process of offshore wind turbines.


Issue. If you spotted a bug, have an idea for an improvement or a new feature, please open a issue. Please open an issue in both cases: If you want to work on it yourself and if you want to leave it to us to work on it.

Fork. If you want to work on an issue yourself please fork the repository, then develop the feature in your copy of the repository and finally file a pull request to merge it into our repository.

Conventions. We use PEP8.


This software is licensed under the MIT license. For more information, read the file LICENSE.