Skip to content

Commit

Permalink
Merge pull request #101 from virocon-organization/vc2_rebase
Browse files Browse the repository at this point in the history
vc2
  • Loading branch information
kawindme committed May 21, 2021
2 parents e4abb30 + ca1f669 commit ecffebc
Show file tree
Hide file tree
Showing 129 changed files with 337,374 additions and 199,142 deletions.
5 changes: 1 addition & 4 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,21 +1,18 @@
*.cpython-35.pyc
*.pyc
*.xml
*.cpython-35.*
*.aux
*.toc
*.synctex.gz
*.out
*.log
*.DS_Store
.idea/*
.DS_Store
.coverage*
*.pytest_cache/*
*_build
*_build/*
build/*
htmlcov/
dist/*
viroconcom.egg-info/*
virocon.egg-info/*
.vscode
2 changes: 1 addition & 1 deletion .python-version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
3.8
3.9
2 changes: 1 addition & 1 deletion .travis.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
language: python
python:
- "3.8"
- "3.9"

script:
- pytest
Expand Down
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
MIT License

Copyright (c) 2017-2018 Niklas Bergmann, Christian Castens, Andreas Haselsteiner, Martin Lechner, Jannik Lehmkuhl, Tjark Meyer, Felix Möller, Tobias Pape, Erik Rother, Kai-Lukas Windmeier
Copyright (c) 2017-2021 virocon developers

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
8 changes: 8 additions & 0 deletions MANIFEST.in
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
#include datasets
graft datasets
#include examples
graft examples
#include docs
graft docs
prune docs/__pycache__
prune docs/_build
286 changes: 143 additions & 143 deletions README.rst
Original file line number Diff line number Diff line change
@@ -1,143 +1,143 @@
ViroCon: viroconcom
===================

.. image:: https://travis-ci.org/virocon-organization/viroconcom.svg?branch=master
:target: https://travis-ci.org/virocon-organization/viroconcom
:alt: Build status

.. image:: https://coveralls.io/repos/github/virocon-organization/viroconcom/badge.svg?branch=master
:target: https://coveralls.io/github/virocon-organization/viroconcom?branch=master

ViroCon is a software to compute environmental contours. `User Guide`_

About
-----

viroconcom is a Python software package to compute environmental contours.

The software 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 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

.. code:: console
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

.. code:: console
pip install viroconcom
Alternatively, you can install from viroconcom repository’s Master branch
by typing

.. code:: console
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

.. code:: console
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
-------------
**Learn.** Our `User Guide`_ covers installation, requirementss 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 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`_.

.. _User Guide: https://virocon-organization.github.io/viroconcom/user_guide.html
.. _viroconweb: https://github.com/virocon-organization/viroconweb
.. _shell: https://en.wikipedia.org/wiki/Command-line_interface#Modern_usage_as_an_operating_system_shell
.. _pyenv: https://github.com/pyenv/pyenv
.. _www.python.org: https://www.python.org
.. _fit a distribution: https://virocon-organization.github.io/viroconcom/fitting.html
.. _compute environmental contours: https://virocon-organization.github.io/viroconcom/jointdistribution_and_contours.html
.. _examples: https://github.com/virocon-organization/viroconcom/tree/master/examples
.. _sea_state_iform_contour.py: https://github.com/virocon-organization/viroconcom/blob/master/examples/sea_state_iform_contour.py
.. _here: https://virocon-organization.github.io/viroconcom/
.. _Contribution Guide: https://virocon-organization.github.io/viroconcom/contributionguide.html
.. _LICENSE: https://github.com/virocon-organization/viroconcom/blob/master/LICENSE
.. _SoftwareX paper: https://github.com/ahaselsteiner/publications/blob/master/2018-10-25_SoftwareX_ViroCon_revised.pdf
ViroCon: viroconcom
===================

.. image:: https://travis-ci.org/virocon-organization/viroconcom.svg?branch=master
:target: https://travis-ci.org/virocon-organization/viroconcom
:alt: Build status

.. image:: https://coveralls.io/repos/github/virocon-organization/viroconcom/badge.svg?branch=master
:target: https://coveralls.io/github/virocon-organization/viroconcom?branch=master

ViroCon is a software to compute environmental contours. `User Guide`_

About
-----

viroconcom is a Python software package to compute environmental contours.

The software 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 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

.. code:: console
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

.. code:: console
pip install viroconcom
Alternatively, you can install from viroconcom repository’s Master branch
by typing

.. code:: console
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

.. code:: console
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
-------------
**Learn.** Our `User Guide`_ covers installation, requirementss 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 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`_.

.. _User Guide: https://virocon-organization.github.io/viroconcom/user_guide.html
.. _viroconweb: https://github.com/virocon-organization/viroconweb
.. _shell: https://en.wikipedia.org/wiki/Command-line_interface#Modern_usage_as_an_operating_system_shell
.. _pyenv: https://github.com/pyenv/pyenv
.. _www.python.org: https://www.python.org
.. _fit a distribution: https://virocon-organization.github.io/viroconcom/fitting.html
.. _compute environmental contours: https://virocon-organization.github.io/viroconcom/jointdistribution_and_contours.html
.. _examples: https://github.com/virocon-organization/viroconcom/tree/master/examples
.. _sea_state_iform_contour.py: https://github.com/virocon-organization/viroconcom/blob/master/examples/sea_state_iform_contour.py
.. _here: https://virocon-organization.github.io/viroconcom/
.. _Contribution Guide: https://virocon-organization.github.io/viroconcom/contributionguide.html
.. _LICENSE: https://github.com/virocon-organization/viroconcom/blob/master/LICENSE
.. _SoftwareX paper: https://github.com/ahaselsteiner/publications/blob/master/2018-10-25_SoftwareX_ViroCon_revised.pdf
Loading

0 comments on commit ecffebc

Please sign in to comment.