sdypy-EMA


Namesdypy-EMA JSON
Version 0.27.3 PyPI version JSON
download
home_page
SummaryExperimental and operational modal analysis.
upload_time2024-03-14 08:22:57
maintainer
docs_urlNone
author
requires_python>=3.10
license
keywords ema experimental modal analysis oma structural dynamics
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage No coveralls.
            sdypy-EMA
=========

Experimental and operational modal analysis

Check out the `documentation`_.

This project is successor of the `pyEMA`_ project. pyEMA is no longer developed after version 0.26.

Basic usage
-----------

Import ``EMA`` module:
~~~~~~~~~~~~~~~~~~~~~~

.. code:: python

    from sdypy import EMA


Make an instance of ``Model`` class:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code:: python

   a = EMA.Model(
       frf_matrix,
       frequency_array,
       lower=50,
       upper=10000,
       pol_order_high=60
       )

Compute poles:
~~~~~~~~~~~~~~

.. code:: python

   a.get_poles()

Determine correct poles:
~~~~~~~~~~~~~~~~~~~~~~~~

The stable poles can be determined in two ways: 

1. Display **stability chart**

.. code:: python
    
    a.select_poles()

The stability chart displayes calculated poles and the user can hand-pick the stable ones.

2. If the approximate values of natural frequencies are already known, it is not necessary to display the stability chart:

.. code:: python

    approx_nat_freq = [314, 864]     
    a.select_closest_poles(approx_nat_freq)

After the stable poles are selected, the natural frequencies and damping coefficients can now be accessed:

.. code:: python

   a.nat_freq # natrual frequencies
   a.nat_xi # damping coefficients

Reconstruction:
~~~~~~~~~~~~~~~

There are two types of reconstruction possible: 

1. Reconstruction using **own** poles (the default option):

.. code:: python

    H, A = a.get_constants(whose_poles='own')

where **H** is reconstructed FRF matrix and **A** is a matrix of modal constants.

2. Reconstruction on **c** using poles from **a**:

.. code:: python

    c = EMA.Model(frf_matrix, frequency_array, lower=50, upper=10000, pol_order_high=60)

    H, A = c.get_constants(whose_poles=a)

|DOI|

.. _documentation: https://sdypy-ema.readthedocs.io/en/latest/

.. |DOI| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.4016671.svg?
   :target: https://doi.org/10.5281/zenodo.4016671

.. _sdypy: https://github.com/sdypy/sdypy

.. _pyEMA: https://github.com/ladisk/pyEMA

.. _pyUFF: https://pypi.org/project/pyuff/
            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "sdypy-EMA",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "\"Janko Slavi\u010d et al.\" <janko.slavic@fs.uni-lj.si>",
    "keywords": "EMA,Experimental Modal Analysis,OMA,Structural Dynamics",
    "author": "",
    "author_email": "\"Janko Slavi\u010d et al.\" <janko.slavic@fs.uni-lj.si>",
    "download_url": "https://files.pythonhosted.org/packages/91/26/a43082c69e442382d608a591af946c118165db02a728190794e5c752308d/sdypy_ema-0.27.3.tar.gz",
    "platform": null,
    "description": "sdypy-EMA\n=========\n\nExperimental and operational modal analysis\n\nCheck out the `documentation`_.\n\nThis project is successor of the `pyEMA`_ project. pyEMA is no longer developed after version 0.26.\n\nBasic usage\n-----------\n\nImport ``EMA`` module:\n~~~~~~~~~~~~~~~~~~~~~~\n\n.. code:: python\n\n    from sdypy import EMA\n\n\nMake an instance of ``Model`` class:\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n.. code:: python\n\n   a = EMA.Model(\n       frf_matrix,\n       frequency_array,\n       lower=50,\n       upper=10000,\n       pol_order_high=60\n       )\n\nCompute poles:\n~~~~~~~~~~~~~~\n\n.. code:: python\n\n   a.get_poles()\n\nDetermine correct poles:\n~~~~~~~~~~~~~~~~~~~~~~~~\n\nThe stable poles can be determined in two ways: \n\n1. Display **stability chart**\n\n.. code:: python\n    \n    a.select_poles()\n\nThe stability chart displayes calculated poles and the user can hand-pick the stable ones.\n\n2. If the approximate values of natural frequencies are already known, it is not necessary to display the stability chart:\n\n.. code:: python\n\n    approx_nat_freq = [314, 864]     \n    a.select_closest_poles(approx_nat_freq)\n\nAfter the stable poles are selected, the natural frequencies and damping coefficients can now be accessed:\n\n.. code:: python\n\n   a.nat_freq # natrual frequencies\n   a.nat_xi # damping coefficients\n\nReconstruction:\n~~~~~~~~~~~~~~~\n\nThere are two types of reconstruction possible: \n\n1. Reconstruction using **own** poles (the default option):\n\n.. code:: python\n\n    H, A = a.get_constants(whose_poles='own')\n\nwhere **H** is reconstructed FRF matrix and **A** is a matrix of modal constants.\n\n2. Reconstruction on **c** using poles from **a**:\n\n.. code:: python\n\n    c = EMA.Model(frf_matrix, frequency_array, lower=50, upper=10000, pol_order_high=60)\n\n    H, A = c.get_constants(whose_poles=a)\n\n|DOI|\n\n.. _documentation: https://sdypy-ema.readthedocs.io/en/latest/\n\n.. |DOI| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.4016671.svg?\n   :target: https://doi.org/10.5281/zenodo.4016671\n\n.. _sdypy: https://github.com/sdypy/sdypy\n\n.. _pyEMA: https://github.com/ladisk/pyEMA\n\n.. _pyUFF: https://pypi.org/project/pyuff/",
    "bugtrack_url": null,
    "license": "",
    "summary": "Experimental and operational modal analysis.",
    "version": "0.27.3",
    "project_urls": {
        "documentation": "https://sdypy-EMA.readthedocs.io/en/latest/index.html",
        "homepage": "https://github.com/sdypy/sdypy-EMA",
        "source": "https://github.com/sdypy/sdypy-EMA"
    },
    "split_keywords": [
        "ema",
        "experimental modal analysis",
        "oma",
        "structural dynamics"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "75495c99d69311fcbfa8200460ef9f97c1dabe8abcf6666ba239947c1f2e981d",
                "md5": "9a13ee5d16c64252047cafbe6b2c3307",
                "sha256": "65cb47d49b78589a53a99f0a598702b48e7a24f120a222a98390f1e35642b9cb"
            },
            "downloads": -1,
            "filename": "sdypy_ema-0.27.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9a13ee5d16c64252047cafbe6b2c3307",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 24746,
            "upload_time": "2024-03-14T08:22:55",
            "upload_time_iso_8601": "2024-03-14T08:22:55.481544Z",
            "url": "https://files.pythonhosted.org/packages/75/49/5c99d69311fcbfa8200460ef9f97c1dabe8abcf6666ba239947c1f2e981d/sdypy_ema-0.27.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9126a43082c69e442382d608a591af946c118165db02a728190794e5c752308d",
                "md5": "81cd07b0f8b316eb5541f1cf195849ba",
                "sha256": "4054d70dfb1264ccf760f745c596fa5daaf32606e26e5243ae359bba9670371f"
            },
            "downloads": -1,
            "filename": "sdypy_ema-0.27.3.tar.gz",
            "has_sig": false,
            "md5_digest": "81cd07b0f8b316eb5541f1cf195849ba",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 9359325,
            "upload_time": "2024-03-14T08:22:57",
            "upload_time_iso_8601": "2024-03-14T08:22:57.214282Z",
            "url": "https://files.pythonhosted.org/packages/91/26/a43082c69e442382d608a591af946c118165db02a728190794e5c752308d/sdypy_ema-0.27.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-14 08:22:57",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "sdypy",
    "github_project": "sdypy-EMA",
    "travis_ci": true,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "sdypy-ema"
}
        
Elapsed time: 0.29854s