{
    "info": {
        "author": "Chris Leaman",
        "author_email": "",
        "bugtrack_url": null,
        "classifiers": [
            "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
            "Programming Language :: Python :: 3",
            "Programming Language :: Python :: 3.5",
            "Programming Language :: Python :: 3.6",
            "Programming Language :: Python :: 3.7"
        ],
        "description": "=================\nPython Wave Runup\n=================\n::\n\n    Empirical wave runup models implemented in Python for coastal engineers and scientists.\n\n.. image:: https://zenodo.org/badge/180274721.svg\n   :target: https://zenodo.org/badge/latestdoi/180274721\n\n.. image:: https://img.shields.io/pypi/v/py-wave-runup.svg\n        :target: https://pypi.python.org/pypi/py-wave-runup\n\n.. image:: https://img.shields.io/travis/com/chrisleaman/py-wave-runup.svg\n        :target: https://travis-ci.com/chrisleaman/py-wave-runup\n\n.. image:: https://readthedocs.org/projects/py-wave-runup/badge/?version=latest\n    :target: https://py-wave-runup.readthedocs.io/en/latest/?badge=latest\n    :alt: Documentation Status\n\n.. image:: https://codecov.io/gh/chrisleaman/py-wave-runup/branch/master/graph/badge.svg\n    :target: https://codecov.io/gh/chrisleaman/py-wave-runup\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n    :target: https://github.com/ambv/black\n\n\nContents\n----------\n- `Background`_\n- `Installation`_\n- `Documentation`_\n- `Contributing`_\n- `Citation`_\n- `License`_\n- `References`_\n\n\nBackground\n----------\n\nWave runup refers to the final part of a wave's journey as it travels from offshore\nonto the beach. It is observable by anyone who goes to the beach and watches the edge\nof the water \"runup\" and rundown the beach. It is comprised of two components:\n\n    - **setup**: the height of the time averaged superelevation of the mean water level\n      above the Still Water Level (SWL)\n    - **swash**: the height of the time varying fluctuation of the instantaneous water\n      level about the setup elevation\n\nSetup, swash and other components of Total Water Level (TWL) rise are shown in this\nhandy figure below.\n\n.. image:: ./docs/_static/VitousekDoubling2017Fig1.jpg\n..\n\n    | Figure from Vitousek et al. (2017) [#vit17]_\n\nWave runup can contribute a significant portion of the increase in TWL in coastal\nstorms causing erosion and inundation. For example, Stockdon et al. (2006) [#sto06]_\ncollated data from numerous experiments, some of which showed wave runup 2% excedence\nheights in excess of 3 m during some storms.\n\nGiven the impact such a large increase in TWL can have on coastlines, there has been\nmuch research conducted to try improve our understanding of wave runup processes.\nAlthough there are many processes which can influence wave runup (such as nonlinear\nwave transformation, wave reflection, three-dimensional effects, porosity, roughness,\npermeability and groundwater) [#cem06]_, many attempts have been made to derive\nempirical relatinoships based on easily measurable parameters. Typically, empirical\nwave runup models include:\n\n    - **Hs**: significant wave height\n    - **Tp**: peak wave length\n    - **beta**: beach slope\n\nThis python package attempts to consolidate the work done by others in this field and\ncollate the numerous empirical relationships for wave runup which have been published.\n\nInstallation\n------------\n\nInstallation of ``py-wave-runup`` can be done with pip:\n\n.. code:: bash\n\n    pip install py-wave-runup\n\n\nUsage\n-----\n\nThe following `wave runup models`_ are available for use:\n\n- ``models.Stockdon2006``: The most commonly cited and widely used runup model.\n- ``models.Power2018``: Based on the Gene-Expression Programming technique.\n- ``models.Holman1986``: Incorporated wave setup using Duck, NC measurements.\n- ``models.Nielsen2009``: Based on runup measurements from NSW, Australia.\n\nTo get calculate runup, setup and swash, define your offshore conditions in your\nselected runup model then you can access each parameter:\n\n.. code:: python\n\n    from py_wave_runup import models\n\n    model_sto06 = models.Stockdon2006(Hs=4, Tp=12, beta=0.1)\n\n    model_sto06.R2     # 2.54\n    model_sto06.setup  # 0.96\n    model_sto06.sinc   # 2.06\n    model_sto06.sig    # 1.65\n\n.. _wave runup models: https://py-wave-runup.readthedocs.io/en/develop/models.html\n\nDocumentation\n-------------\nDocumentation is located at https://py-wave-runup.readthedocs.io.\n\n\nContributing\n------------\n\n1. Fork it (https://github.com/chrisleaman/py-wave-runup/fork)\n2. Create your feature branch (``git checkout -b feature/fooBar``)\n3. Commit your changes (``git commit -am 'Add some fooBar``)\n4. Push to the branch (``git push origin feature/fooBar``)\n5. Create a new Pull Request\n\n\nCitation\n--------\n\nIf this package has been useful to you, please cite the following DOI: https://doi.org/10.5281/zenodo.2667464\n\n\nLicense\n--------\n\nDistributed under the GNU General Public License v3.\n\n\nReferences\n----------\n\n.. [#vit17] Vitousek, Sean, Patrick L. Barnard, Charles H. Fletcher, Neil Frazer,\n       Li Erikson, and Curt D. Storlazzi. \"Doubling of Coastal Flooding Frequency\n       within Decades Due to Sea-Level Rise.\" Scientific Reports 7, no. 1 (May 18,\n       2017): 1399. https://doi.org/10.1038/s41598-017-01362-7.\n.. [#sto06] Stockdon, Hilary F., Robert A. Holman, Peter A. Howd, and Asbury H. Sallenger.\n       \"Empirical Parameterization of Setup, Swash, and Runup.\" Coastal Engineering 53,\n       no. 7 (May 1, 2006): 573-88. https://doi.org/10.1016/j.coastaleng.2005.12.005\n.. [#cem06] United States, Army, and Corps of Engineers. Coastal Engineering Manual.\n       Washington, D.C.: U.S. Army Corps of Engineers, 2006.\n",
        "description_content_type": "text/x-rst",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/chrisleaman/py-wave-runup",
        "keywords": "",
        "license": "GPL-3.0+",
        "maintainer": "Chris Leaman",
        "maintainer_email": "",
        "name": "py-wave-runup",
        "package_url": "https://pypi.org/project/py-wave-runup/",
        "platform": "",
        "project_url": "https://pypi.org/project/py-wave-runup/",
        "project_urls": {
            "Documentation": "https://py-wave-runup.readthedocs.io",
            "Homepage": "https://github.com/chrisleaman/py-wave-runup",
            "Repository": "https://github.com/chrisleaman/py-wave-runup"
        },
        "release_url": "https://pypi.org/project/py-wave-runup/0.1.4/",
        "requires_dist": [
            "numpy (>=1.16,<2.0)"
        ],
        "requires_python": ">=3.5,<4.0",
        "summary": "Empirical wave runup models implemented in Python",
        "version": "0.1.4"
    },
    "last_serial": 5249855,
    "releases": {
        "0.1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "174af41fa6c92a662c05f38b6b2bd727",
                    "sha256": "483fe8853555455dd9dff7fb13b7b486ec1c63937081f760ed032687060d20f5"
                },
                "downloads": -1,
                "filename": "py_wave_runup-0.1.0-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "174af41fa6c92a662c05f38b6b2bd727",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
                "size": 3993,
                "upload_time": "2019-04-09T11:40:56",
                "url": "https://files.pythonhosted.org/packages/af/51/d4c563323c597f462274c37bc59fb5b8c397652d66e6474c4a4256c6d04d/py_wave_runup-0.1.0-py2.py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "509d1604d673eb330d38f319c8a3daec",
                    "sha256": "cae72745358b2fa1edcf0c24866282a688bf293ee54cc3355b20b74388c820b5"
                },
                "downloads": -1,
                "filename": "py-wave-runup-0.1.0.tar.gz",
                "has_sig": false,
                "md5_digest": "509d1604d673eb330d38f319c8a3daec",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
                "size": 2364,
                "upload_time": "2019-04-09T11:40:54",
                "url": "https://files.pythonhosted.org/packages/35/45/261421dde45f04470e2115fd13ac69797fcb57384fb145276e5f3b6b5f6c/py-wave-runup-0.1.0.tar.gz"
            }
        ],
        "0.1.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "a8b921a2c4c2ede46889ad698da55cd6",
                    "sha256": "fa652cf0562c30f5d08b85f139e91c667bc161a3d56f0c08133608fdaef3be19"
                },
                "downloads": -1,
                "filename": "py_wave_runup-0.1.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "a8b921a2c4c2ede46889ad698da55cd6",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5,<4.0",
                "size": 3957,
                "upload_time": "2019-04-09T11:52:36",
                "url": "https://files.pythonhosted.org/packages/7a/c2/475345b9eb990f0305a00cde325a4273fbb56729796f4a30471a6f8817c6/py_wave_runup-0.1.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "6afff7babe0f9e44f5d66cf617716124",
                    "sha256": "d10373560c832446c2ce9a0bb54c43bca6b30ff1f133e9bec5fc7ce895ef5680"
                },
                "downloads": -1,
                "filename": "py-wave-runup-0.1.1.tar.gz",
                "has_sig": false,
                "md5_digest": "6afff7babe0f9e44f5d66cf617716124",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5,<4.0",
                "size": 2345,
                "upload_time": "2019-04-09T11:52:35",
                "url": "https://files.pythonhosted.org/packages/15/12/e8732c85db498e35db0ea03addf860d5aa8377e710bd684517d5afefbe1a/py-wave-runup-0.1.1.tar.gz"
            }
        ],
        "0.1.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "1f97140389d5725dc128273568557a1a",
                    "sha256": "c71d810a938774b80489a3a8705add14acc988c36615d382cdf3d3a58440b766"
                },
                "downloads": -1,
                "filename": "py_wave_runup-0.1.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "1f97140389d5725dc128273568557a1a",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5,<4.0",
                "size": 5238,
                "upload_time": "2019-05-04T04:10:50",
                "url": "https://files.pythonhosted.org/packages/7b/e9/667917912c309a83344853fcfc9ac67baa5171138e8cca6253addcef6cf0/py_wave_runup-0.1.2-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "466c5c6385a3df5e5b21961c314e9243",
                    "sha256": "3f3978d3d8638e6e2f0e070e09326edd7f9531b128a7dba175cbb807b9378b8d"
                },
                "downloads": -1,
                "filename": "py-wave-runup-0.1.2.tar.gz",
                "has_sig": false,
                "md5_digest": "466c5c6385a3df5e5b21961c314e9243",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5,<4.0",
                "size": 5389,
                "upload_time": "2019-05-04T04:10:49",
                "url": "https://files.pythonhosted.org/packages/69/50/5b5f02efd33d9b4073cae26c4c25b6608cc1c0c7910c4a8bb6553f29e982/py-wave-runup-0.1.2.tar.gz"
            }
        ],
        "0.1.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "3a5a2423dc0c021999a758054b48dc85",
                    "sha256": "2404424400a4c7aa9980ffb538d3d7864bafa807f1fc4e5f4a38731fc8876875"
                },
                "downloads": -1,
                "filename": "py_wave_runup-0.1.3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "3a5a2423dc0c021999a758054b48dc85",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5,<4.0",
                "size": 5257,
                "upload_time": "2019-05-05T05:01:19",
                "url": "https://files.pythonhosted.org/packages/04/7b/01924fee1b853ea127eed8be9d2d85ade8d86b201038b13cae8731ec8af2/py_wave_runup-0.1.3-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "ab71b59a702b6c1cbc2b7cf8f73e019f",
                    "sha256": "3f274d986f20f34aaf3d2d35ce61febf6e7d8566a64b5041ed01b6ec6e9ea500"
                },
                "downloads": -1,
                "filename": "py-wave-runup-0.1.3.tar.gz",
                "has_sig": false,
                "md5_digest": "ab71b59a702b6c1cbc2b7cf8f73e019f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5,<4.0",
                "size": 5405,
                "upload_time": "2019-05-05T05:01:18",
                "url": "https://files.pythonhosted.org/packages/af/ab/1ab6aa2f74688b9859b3e215c65bd19c837a3181b0ad2bed2fc329f13404/py-wave-runup-0.1.3.tar.gz"
            }
        ],
        "0.1.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "7db838d5764bff58c5054ba2ae2baae0",
                    "sha256": "5fc89e14077f4ccaf94608ef6703bfcfa9d5e6ff147ffe2caa222f414532c32b"
                },
                "downloads": -1,
                "filename": "py_wave_runup-0.1.4-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "7db838d5764bff58c5054ba2ae2baae0",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5,<4.0",
                "size": 7597,
                "upload_time": "2019-05-09T23:04:03",
                "url": "https://files.pythonhosted.org/packages/d8/52/d920163d4ef8c70084f594fb7bbb743cb13f6ba1f1d65a72ecd851760188/py_wave_runup-0.1.4-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "fd332405d7cbdd264af9d562271a9d04",
                    "sha256": "c458c6ec4d2b6b790b04416ffc93d3482467f28bab4132351c664f3e88235386"
                },
                "downloads": -1,
                "filename": "py-wave-runup-0.1.4.tar.gz",
                "has_sig": false,
                "md5_digest": "fd332405d7cbdd264af9d562271a9d04",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5,<4.0",
                "size": 8115,
                "upload_time": "2019-05-09T23:04:01",
                "url": "https://files.pythonhosted.org/packages/4a/8c/ac4683fb7190b22996393aff27e1052d5341a3dfbdfe5805eb6f5339de64/py-wave-runup-0.1.4.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "7db838d5764bff58c5054ba2ae2baae0",
                "sha256": "5fc89e14077f4ccaf94608ef6703bfcfa9d5e6ff147ffe2caa222f414532c32b"
            },
            "downloads": -1,
            "filename": "py_wave_runup-0.1.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7db838d5764bff58c5054ba2ae2baae0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.5,<4.0",
            "size": 7597,
            "upload_time": "2019-05-09T23:04:03",
            "url": "https://files.pythonhosted.org/packages/d8/52/d920163d4ef8c70084f594fb7bbb743cb13f6ba1f1d65a72ecd851760188/py_wave_runup-0.1.4-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "fd332405d7cbdd264af9d562271a9d04",
                "sha256": "c458c6ec4d2b6b790b04416ffc93d3482467f28bab4132351c664f3e88235386"
            },
            "downloads": -1,
            "filename": "py-wave-runup-0.1.4.tar.gz",
            "has_sig": false,
            "md5_digest": "fd332405d7cbdd264af9d562271a9d04",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.5,<4.0",
            "size": 8115,
            "upload_time": "2019-05-09T23:04:01",
            "url": "https://files.pythonhosted.org/packages/4a/8c/ac4683fb7190b22996393aff27e1052d5341a3dfbdfe5805eb6f5339de64/py-wave-runup-0.1.4.tar.gz"
        }
    ]
}