harm-analysis


Nameharm-analysis JSON
Version 1.1.1 PyPI version JSON
download
home_page
SummaryA Python library for Q format representation and overflow handling.
upload_time2024-02-05 13:17:32
maintainer
docs_urlNone
author
requires_python
licenseMIT
keywords dsp fixed-point signal-processing snr
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
Introduction
------------
The harmonic analysis function uses an FFT to estimate the following parameters from a signal containing a tone:

* THD and THD+N
* Fundamental power and frequency location
* Noise power
* SNR, SINAD
* DC level
* Total integrated noise (everything except DC and the fundamental)

The full documentation is hosted on ReadTheDocs:`Harmonic Analysis <https://harm-analysis.readthedocs.io/en/latest/index.html>`_.

Installation
------------
The harm_analysis package is available via PIP install:

.. code-block:: python

   python3 -m venv pyenv
   source pyenv/bin/activate

   pip install harm_analysis

After installing the package, the harm_analysis function should be available via import:

.. code-block:: python

    from harm_analysis import harm_analysis

Documentation on how to use the function can be found `here <https://harm-analysis.readthedocs.io/en/latest/harm_analysis.html>`_.

Command line interface
----------------------

Installing the package also installs a command line interface, that allows the user to
run the function for text files with time domain data:

The command is `harm_analysis`:

.. code-block::

    harm_analysis --help

Output:

.. code-block::

    Usage: harm_analysis [OPTIONS] FILENAME

      Runs the harm_analysis function for a file containing time domain data

    Options:
      --fs FLOAT      Sampling frequency.
      --plot          Plot the power spectrum of the data
      --sep TEXT      Separator between items.
      --sfactor TEXT  Scaling factor. The data will be multiplied by this number,
                      before the function is called. Examples: 1/8, 5, etc
      --help          Show this message and exit.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "harm-analysis",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "DSP,Fixed-point,Signal-Processing,SNR",
    "author": "",
    "author_email": "Eric Macedo <ericsmacedo@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/43/b2/807ef2e8a1505913e07507c0e95e010e38e41142b181504e66a748c3e62c/harm-analysis-1.1.1.tar.gz",
    "platform": null,
    "description": "\nIntroduction\n------------\nThe harmonic analysis function uses an FFT to estimate the following parameters from a signal containing a tone:\n\n* THD and THD+N\n* Fundamental power and frequency location\n* Noise power\n* SNR, SINAD\n* DC level\n* Total integrated noise (everything except DC and the fundamental)\n\nThe full documentation is hosted on ReadTheDocs:`Harmonic Analysis <https://harm-analysis.readthedocs.io/en/latest/index.html>`_.\n\nInstallation\n------------\nThe harm_analysis package is available via PIP install:\n\n.. code-block:: python\n\n   python3 -m venv pyenv\n   source pyenv/bin/activate\n\n   pip install harm_analysis\n\nAfter installing the package, the harm_analysis function should be available via import:\n\n.. code-block:: python\n\n    from harm_analysis import harm_analysis\n\nDocumentation on how to use the function can be found `here <https://harm-analysis.readthedocs.io/en/latest/harm_analysis.html>`_.\n\nCommand line interface\n----------------------\n\nInstalling the package also installs a command line interface, that allows the user to\nrun the function for text files with time domain data:\n\nThe command is `harm_analysis`:\n\n.. code-block::\n\n    harm_analysis --help\n\nOutput:\n\n.. code-block::\n\n    Usage: harm_analysis [OPTIONS] FILENAME\n\n      Runs the harm_analysis function for a file containing time domain data\n\n    Options:\n      --fs FLOAT      Sampling frequency.\n      --plot          Plot the power spectrum of the data\n      --sep TEXT      Separator between items.\n      --sfactor TEXT  Scaling factor. The data will be multiplied by this number,\n                      before the function is called. Examples: 1/8, 5, etc\n      --help          Show this message and exit.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A Python library for Q format representation and overflow handling.",
    "version": "1.1.1",
    "project_urls": {
        "Documentation": "https://harm-analysis.readthedocs.io/en/latest/",
        "Source Code": "https://github.com/ericsmacedo/harm_analysis"
    },
    "split_keywords": [
        "dsp",
        "fixed-point",
        "signal-processing",
        "snr"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ea9f19529fcccb522e13d8f2c82f28e92e58ac172bd4d2476b9eece66268c7a3",
                "md5": "3714e2b5c5df7b9f8b7a39882e9a6ca0",
                "sha256": "47fa30dbb111751c4b39c85099239e5fe46aac23daf0c306fd964fdd18393e7b"
            },
            "downloads": -1,
            "filename": "harm_analysis-1.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3714e2b5c5df7b9f8b7a39882e9a6ca0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 9048,
            "upload_time": "2024-02-05T13:17:30",
            "upload_time_iso_8601": "2024-02-05T13:17:30.550692Z",
            "url": "https://files.pythonhosted.org/packages/ea/9f/19529fcccb522e13d8f2c82f28e92e58ac172bd4d2476b9eece66268c7a3/harm_analysis-1.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "43b2807ef2e8a1505913e07507c0e95e010e38e41142b181504e66a748c3e62c",
                "md5": "ebdc5f0dc280baa34d743427e3b0ea27",
                "sha256": "ed63adb0b5305a2f0267199f72cb138d1c004828e86835ba15a27d1f31153475"
            },
            "downloads": -1,
            "filename": "harm-analysis-1.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "ebdc5f0dc280baa34d743427e3b0ea27",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 90090,
            "upload_time": "2024-02-05T13:17:32",
            "upload_time_iso_8601": "2024-02-05T13:17:32.623912Z",
            "url": "https://files.pythonhosted.org/packages/43/b2/807ef2e8a1505913e07507c0e95e010e38e41142b181504e66a748c3e62c/harm-analysis-1.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-05 13:17:32",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ericsmacedo",
    "github_project": "harm_analysis",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "harm-analysis"
}
        
Elapsed time: 0.17535s