mwdi


Namemwdi JSON
Version 0.72 PyPI version JSON
download
home_pagehttps://github.com/ladisk/mwdi
SummaryMorlet Wave Damping Identification.
upload_time2023-02-07 12:57:10
maintainerIvan Tomac, Janko Slavič
docs_urlNone
authorIvan Tomac, Longqi Wang, Janko Slavič
requires_python
licenseMIT license
keywords damping morlet-wave identification
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage No coveralls.
            MWDI - Morlet-Wave Damping Identification 
------------------------------------------
This is the Python implementation of the Morlet-Wave damping identification method, see [1]_ and [2]_ for details.

This package is based on the `MorletDamping`_ code developed by WANG Longqi and was created within the 
MSCA IF project `NOSTRADAMUS`_.


Simple example
---------------

A simple example how to identify damping using MWDI method:

.. code-block:: python

   import mwdi as mw
   import numpy as np

   # set time domain
   fs = 5000 # sampling frequency [Hz]
   N = 5000 # number of data points of time signal
   time = np.arange(N) / fs # time vector

   # generate a free response of a SDOF damped mechanical system
   w_n = 2*np.pi * 100 # undamped natural frequency
   d = 0.01 # damping ratio
   x = 1 # amplitude
   phi = 0.3 # phase
   response = x * np.exp(-d * w_n * time) * np.cos(w_n * np.sqrt(1 - d**2) * time - phi)

   # set MWDI object identifier
   identifier = mw.MorletWave(free_response=response, fs=fs)

   # identify damping
   dmp = identifier.identify_damping(w=w_n, root_finding='Newton')
   print(dmp)

References
----------
.. [1] J\. Slavič, M. Boltežar, Damping identification with the Morlet-wave, Mechanical Systems and Signal Processing, 25 (2011) 1632–1645, doi: `10.1016/j.ymssp.2011.01.008`_.
.. [2] I\. Tomac, J. Slavič, Damping identification based on a high-speed camera. Mechanical Systems and Signal Processing, 166 (2022) 108485–108497, doi: `10.1016/j.ymssp.2021.108485`_.

.. _NOSTRADAMUS: http://ladisk.si/?what=incfl&flnm=nostradamus.php
.. _MorletDamping: https://github.com/wanglongqi/MorletDamping
.. _10.1016/j.ymssp.2011.01.008: https://doi.org/10.1016/j.ymssp.2011.01.008
.. _10.1016/j.ymssp.2021.108485: https://doi.org/10.1016/j.ymssp.2021.108485

|Build Status| |Zenodo|

.. |Build Status| image:: https://travis-ci.com/ladisk/mwdi.svg?branch=main
   :target: https://travis-ci.com/ladisk/mwdi
   
.. |Zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.7002813.svg
   :target: https://doi.org/10.5281/zenodo.7002813

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/ladisk/mwdi",
    "name": "mwdi",
    "maintainer": "Ivan Tomac, Janko Slavi\u010d",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "janko.slavic@fs.uni-lj.si",
    "keywords": "damping, morlet-wave, identification",
    "author": "Ivan Tomac, Longqi Wang, Janko Slavi\u010d",
    "author_email": "ivan.tomac@fs.uni-lj.si, janko.slavic@fs.uni-lj.si",
    "download_url": "https://files.pythonhosted.org/packages/58/7c/86c83d264c3c37b4d1655e952017bbf0c1a37c59bc6d5741209d22febeaf/mwdi-0.72.tar.gz",
    "platform": null,
    "description": "MWDI - Morlet-Wave Damping Identification \n------------------------------------------\nThis is the Python implementation of the Morlet-Wave damping identification method, see [1]_ and [2]_ for details.\n\nThis package is based on the `MorletDamping`_ code developed by WANG Longqi and was created within the \nMSCA IF project `NOSTRADAMUS`_.\n\n\nSimple example\n---------------\n\nA simple example how to identify damping using MWDI method:\n\n.. code-block:: python\n\n   import mwdi as mw\n   import numpy as np\n\n   # set time domain\n   fs = 5000 # sampling frequency [Hz]\n   N = 5000 # number of data points of time signal\n   time = np.arange(N) / fs # time vector\n\n   # generate a free response of a SDOF damped mechanical system\n   w_n = 2*np.pi * 100 # undamped natural frequency\n   d = 0.01 # damping ratio\n   x = 1 # amplitude\n   phi = 0.3 # phase\n   response = x * np.exp(-d * w_n * time) * np.cos(w_n * np.sqrt(1 - d**2) * time - phi)\n\n   # set MWDI object identifier\n   identifier = mw.MorletWave(free_response=response, fs=fs)\n\n   # identify damping\n   dmp = identifier.identify_damping(w=w_n, root_finding='Newton')\n   print(dmp)\n\nReferences\n----------\n.. [1] J\\. Slavi\u010d, M. Bolte\u017ear, Damping identification with the Morlet-wave, Mechanical Systems and Signal Processing, 25 (2011) 1632\u20131645, doi: `10.1016/j.ymssp.2011.01.008`_.\n.. [2] I\\. Tomac, J. Slavi\u010d, Damping identification based on a high-speed camera. Mechanical Systems and Signal Processing, 166 (2022) 108485\u2013108497, doi: `10.1016/j.ymssp.2021.108485`_.\n\n.. _NOSTRADAMUS: http://ladisk.si/?what=incfl&flnm=nostradamus.php\n.. _MorletDamping: https://github.com/wanglongqi/MorletDamping\n.. _10.1016/j.ymssp.2011.01.008: https://doi.org/10.1016/j.ymssp.2011.01.008\n.. _10.1016/j.ymssp.2021.108485: https://doi.org/10.1016/j.ymssp.2021.108485\n\n|Build Status| |Zenodo|\n\n.. |Build Status| image:: https://travis-ci.com/ladisk/mwdi.svg?branch=main\n   :target: https://travis-ci.com/ladisk/mwdi\n   \n.. |Zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.7002813.svg\n   :target: https://doi.org/10.5281/zenodo.7002813\n",
    "bugtrack_url": null,
    "license": "MIT license",
    "summary": "Morlet Wave Damping Identification.",
    "version": "0.72",
    "split_keywords": [
        "damping",
        " morlet-wave",
        " identification"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "234a8e23aacf5b9d2d47e2926e613761eb4142f51115da1a91da56bf1502f36a",
                "md5": "09b5442c9b845e7cb5ae3f416f37d92c",
                "sha256": "7e65659c672d499f716b0ba74d87c6621f6fb2e8ae87bae75883e037787ae642"
            },
            "downloads": -1,
            "filename": "mwdi-0.72-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "09b5442c9b845e7cb5ae3f416f37d92c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 6178,
            "upload_time": "2023-02-07T12:57:08",
            "upload_time_iso_8601": "2023-02-07T12:57:08.316716Z",
            "url": "https://files.pythonhosted.org/packages/23/4a/8e23aacf5b9d2d47e2926e613761eb4142f51115da1a91da56bf1502f36a/mwdi-0.72-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "587c86c83d264c3c37b4d1655e952017bbf0c1a37c59bc6d5741209d22febeaf",
                "md5": "bee6d97385e3c0120bc58f7bc47e1665",
                "sha256": "9479e861409e45c556024ba65105592802e1d6d07f5d200d0205c8f24c4f23b1"
            },
            "downloads": -1,
            "filename": "mwdi-0.72.tar.gz",
            "has_sig": false,
            "md5_digest": "bee6d97385e3c0120bc58f7bc47e1665",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 6049,
            "upload_time": "2023-02-07T12:57:10",
            "upload_time_iso_8601": "2023-02-07T12:57:10.411718Z",
            "url": "https://files.pythonhosted.org/packages/58/7c/86c83d264c3c37b4d1655e952017bbf0c1a37c59bc6d5741209d22febeaf/mwdi-0.72.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-02-07 12:57:10",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "ladisk",
    "github_project": "mwdi",
    "travis_ci": true,
    "coveralls": false,
    "github_actions": false,
    "requirements": [],
    "lcname": "mwdi"
}
        
Elapsed time: 0.04850s