ViroCon's numerical core: computes n-dimensional environmental contours
Project description
ViroCon is a software to compute environmental contours.
About
viroconcom is a software package to compute environmental contours. It is written in Python 3.7.4 and belongs to the software ViroCon, which also offers a GUI for some functionality via the package viroconweb.
ViroCon helps 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 viroconcom:
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.
How to use viroconcom
Requirements
Make sure you have installed Python 3.8 by typing
python --version
in your shell.
(Older version might work, but are not actively tested)
Consider using the python version management pyenv.
Install
Install the latest version of viroconcom from PyPI by typing
pip install viroconcom
Alternatively, you can install from viroconcom repository’s Master branch by typing
pip install https://github.com/virocon-organization/viroconcom/archive/master.zip
Usage
viroconcom is designed as an importable package.
The folder examples contains python files that show how one can import and use viroconcom.
As an example, to run the file sea_state_iform_contour.py, 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
python sea_state_iform_contour.py
Our documentation contains a user guide, with examples how to fit a distribution to measurement data and how to compute environmental contours.
Documentation
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 the software.
Contributing
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 in 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. In our Contribution Guide we summarize our conventions, which are consistent with PEP8.
Cite
If you are using viroconcom in your academic work please cite it by referencing our SoftwareX paper.
Example: Environmental contours were computed using the package viroconcom (version 1.2.0) of the software ViroCon [1].
[1] A.F. Haselsteiner, J. Lemkuhl, T. Pape, K.-L. Windmeier, K.-D. Thoben: ViroCon: A software to compute multivariate extremes using the environmental contour method. Accepted by SoftwareX.
License
This software is licensed under the MIT license. For more information, read the file LICENSE.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.