Wave Analysis for Fatigue and Oceanography
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Per A Brodtkorb 8140ec785b Fixed failing doctests 8 years ago
docs [WIP] add first iteration and incomplete packaging files generated with pyscaffold 9 years ago
wafo Fixed failing doctests 8 years ago
.checkignore added .checkignore for quantifycode 9 years ago
.codeclimate.yml added files: 9 years ago
.coveragerc Try to compile fortran extensions again 9 years ago
.gitignore add *.mod to .gitignore 9 years ago
.landscape.yml added .landscape.yml file 9 years ago
.travis.yml Updated .travis.yml 8 years ago
AUTHORS.rst [WIP] add first iteration and incomplete packaging files generated with pyscaffold 9 years ago
CHANGES.rst [WIP] add first iteration and incomplete packaging files generated with pyscaffold 9 years ago
LICENSE.txt [WIP] add first iteration and incomplete packaging files generated with pyscaffold 9 years ago
README.rst Updated linkts again 9 years ago
appveyor.yml Added numba_misc.py 8 years ago
conftest.py Added more options to setup.cfg 9 years ago
requirements.txt removed tox.ini 9 years ago
setup.cfg Added Getting started section to readme. 9 years ago
setup.py updated help header 9 years ago

README.rst

|wafo_logo|
==========================================
Wave Analysis for Fatigue and Oceanography
==========================================

|pkg_img| |tests_img| |docs_img| |health_img| |coverage_img| |versions_img| |depsy_img|


Description
===========

WAFO is a toolbox Python routines for statistical analysis and simulation of
random waves and random loads. WAFO is freely redistributable software, see WAFO
icence, cf. the GNU General Public License (GPL) and contain tools for:

Fatigue Analysis
----------------

- Fatigue life prediction for random loads
- Theoretical density of rainflow cycles

Sea modelling
-------------

- Simulation of linear and non-linear Gaussian waves
- Estimation of seamodels (spectrums)
- Joint wave height, wave steepness, wave period distributions

Statistics
------------

- Extreme value analysis
- Kernel density estimation
- Hidden markov models

Classes
-------

* TimeSeries:
    Data analysis of time series. Example: extraction of turning points,
    estimation of spectrum and covariance function. Estimation transformation
    used in transformed Gaussian model.

* CovData:
    Computation of spectral functions, linear and non-linear time series
    simulation.

* SpecData:
    Computation of spectral moments and covariance functions, linear and
    non-linear time series simulation. Ex: common spectra implemented,
    directional spectra, bandwidth measures, exact distributions for wave
    characteristics.

* CyclePairs:
    Cycle counting, discretization, and crossings, calculation of damage.
    Simulation of discrete Markov chains, switching Markov chains,
    harmonic oscillator. Ex:  Rainflow cycles and matrix, discretization of
    loads. Damage of a rainflow count or matrix, damage matrix, S-N plot.


Subpackages
-----------

* TRANSFORM
    Modelling with linear or transformed Gaussian waves.
* STATS
    Statistical tools and extreme-value distributions. Ex: generation of random
    numbers, estimation of parameters, evaluation of pdf and cdf
* KDETOOLS
    Kernel-density estimation.
* MISC
    Miscellaneous routines.
* DOCS
    Documentation of toolbox, definitions. An overview is given in the routine
    wafomenu.
* DATA
    Measurements from marine applications.

WAFO homepage: <http://www.maths.lth.se/matstat/wafo/>
On the WAFO home page you will find:
- The WAFO Tutorial
- List of publications related to WAFO.

Installation
============

WAFO contains some Fortran and C extensions that require a properly configured
compiler and NumPy/f2py.

Create a binary wheel package and place it in the dist folder as follows::

    python setup.py bdist_wheel -d dist

And install the wheel package with::

    pip install dist/wafo-X.Y.Z+abcd123-os_platform.whl

Getting started
===============

A quick introduction to some of the many features of wafo can be found in the Tutorial IPython notebooks in the 
`tutorial scripts folder`_:

* Chapter 1 - `Some applications of WAFO`_

* Chapter 2 - `Modelling random loads and stochastic waves`_

* Chapter 3 - `Demonstrates distributions of wave characteristics`_

* Chapter 4 - `Fatigue load analysis and rain-flow cycles`_

* Chapter 5 - `Extreme value analysis`_

-- _tutorial scripts folder: http://nbviewer.jupyter.org/github/wafo-project/pywafo/tree/master/wafo/doc/tutorial_scripts/

.. _Some applications of WAFO: http://nbviewer.jupyter.org/github/wafo-project/pywafo/blob/master/wafo/doc/tutorial_scripts/WAFO%20Chapter%201.ipynb

.. _Modelling random loads and stochastic waves: http://nbviewer.jupyter.org/github/wafo-project/pywafo/blob/master/wafo/doc/tutorial_scripts/WAFO%20Chapter%202.ipynb

.. _Demonstrates distributions of wave characteristics: http://nbviewer.jupyter.org/github/wafo-project/pywafo/blob/master/wafo/doc/tutorial_scripts/WAFO%20Chapter%203.ipynb

.. _Fatigue load analysis and rain-flow cycles: http://nbviewer.jupyter.org/github/wafo-project/pywafo/blob/master/wafo/doc/tutorial_scripts/WAFO%20Chapter%204.ipynb

.. _Extreme value analysis: http://nbviewer.jupyter.org/github/wafo-project/pywafo/blob/master/wafo/doc/tutorial_scripts/WAFO%20Chapter%205.ipynb


Unit tests
==========

To test if the toolbox is working paste the following in an interactive
python session::

   import wafo as wf
   wf.test(coverage=True, doctests=True)


Note
====

This project has been set up using PyScaffold 2.4.2. For details and usage
information on PyScaffold see http://pyscaffold.readthedocs.org/.

.. |wafo_logo| image:: https://github.com/wafo-project/pywafo/blob/master/wafo/data/wafoLogoNewWithoutBorder.png
    :target: https://github.com/wafo-project/pywafo


.. |pkg_img| image:: https://badge.fury.io/py/wafo.png
    :target: https://pypi.python.org/pypi/wafo/

.. |tests_img| image:: https://travis-ci.org/wafo-project/pywafo.svg?branch=master
    :target: https://travis-ci.org/wafo-project/pywafo

.. |docs_img| image:: https://readthedocs.org/projects/pip/badge/?version=latest
    :target: http://pywafo.readthedocs.org/en/latest/

.. |health_img| image:: https://codeclimate.com/github/wafo-project/pywafo/badges/gpa.svg
   :target: https://codeclimate.com/github/wafo-project/pywafo
   :alt: Code Climate

.. |coverage_img| image:: https://coveralls.io/repos/wafo-project/pywafo/badge.svg?branch=master
   :target: https://coveralls.io/github/wafo-project/pywafo?branch=master

.. |versions_img| image:: https://img.shields.io/pypi/pyversions/wafo.svg
   :target: https://github.com/wafo-project/pywafo


.. |depsy_img| image:: http://depsy.org/api/package/pypi/wafo/badge.svg
   :target: http://depsy.org/package/python/wafo