Metadata-Version: 2.4
Name: lupy
Version: 0.0.4
Summary: Python library for Audio Loudness measurements
Author-email: Matthew Reid <matt@nomadic-recording.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/nocarryr/lupy
Project-URL: Documentation, https://lupy-nocarryr.readthedocs.io/
Project-URL: PyPI, https://pypi.org/project/lupy/
Keywords: audio,loudness,r128,ebur128,bs1770,bs1771,tech3341,tech3342
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Requires-Python: >=3.11
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: LICENSE-SCIPY
Requires-Dist: numpy<=2.5.4
Requires-Dist: scipy<=1.18.1
Requires-Dist: typing-extensions; python_version < "3.13"
Dynamic: license-file

lupy
####

|uv badge| |actions badge| |codspeed badge| |PyPI version| |PyPI license| |PyPI pyversions| |PyPI download week|


Python library for `Audio Loudness`_ measurements.
Yet another implementation of `ITU-R BS.1770`_, `ITU-R BS.1771`_,
`EBU Tech 3341`_ and `EBU Tech 3342`_.


Purpose
=======

This library provides a way to measure audio loudness and true peak measurements
validated against the official EBU compliance test materials.

Its design focuses more on real-time processing, using a block-based approach
suitable for audio engines, rather than offline processing of entire audio files.



Features
========

* Historical tracking of all measurements over time
* Multi-channel audio support
* Compliance-based validation of measurements


Measurement Types
-----------------

* Integrated Loudness
* Short-Term Loudness
* Momentary Loudness
* Loudness Range (LRA)
* True Peak



Compliance
----------

This library is validated against comprehensive compliance test cases based on
the official EBU and ITU-R documents:

`EBU Tech 3341`_
  Integrated, Momentary, Short-Term and True Peak measurements

`EBU Tech 3342`_
  Loudness Range (LRA) measurements

`ITU-R BS.2217`_
  Integrated Loudness measurements for various channel configurations



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

Pip
---

.. code-block:: bash

  $ pip install lupy



Dependencies
============

* numpy
* scipy


Project Links
=============


Homepage
   https://github.com/nocarryr/lupy

PyPI
   https://pypi.org/project/lupy/

Documentation
   https://lupy-nocarryr.readthedocs.io/



License
=======

This project is licensed under the MIT License - see the `LICENSE`_ file for details.


Portions of the code (src/lupy/signalutils) are derived from the Scipy library, which is
licensed under the BSD License.  See the `LICENSE-SCIPY`_ file for details.



.. |uv badge| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json
  :alt: uv
  :target: https://docs.astral.sh/uv/

.. |actions badge| image:: https://img.shields.io/github/actions/workflow/status/nocarryr/lupy/test.yml
  :alt: GitHub Actions Workflow Status
  :target: https://github.com/nocarryr/lupy/actions

.. |codspeed badge| image:: https://img.shields.io/endpoint?url=https://codspeed.io/badge.json
  :alt: CodSpeed Badge
  :target: https://codspeed.io/nocarryr/lupy

.. |PyPI version| image:: https://img.shields.io/pypi/v/lupy.svg
  :alt: PyPI version
  :target: https://pypi.python.org/pypi/lupy/

.. |PyPI license| image:: https://img.shields.io/pypi/l/lupy.svg
  :alt: PyPI license
  :target: https://pypi.python.org/pypi/lupy/

.. |PyPI pyversions| image:: https://img.shields.io/pypi/pyversions/lupy.svg
  :alt: PyPI Python versions
  :target: https://pypi.python.org/pypi/lupy/

.. |PyPI download week| image:: https://img.shields.io/pypi/dw/lupy.svg
  :alt: PyPI download week
  :target: https://pypi.python.org/pypi/lupy/




.. _Audio Loudness: https://tech.ebu.ch/loudness
.. _ITU-R BS.1770: https://www.itu.int/rec/R-REC-BS.1770/en
.. _ITU-R BS.1771: https://www.itu.int/rec/R-REC-BS.1771/en
.. _EBU Tech 3341: https://tech.ebu.ch/publications/tech3341
.. _EBU Tech 3342: https://tech.ebu.ch/publications/tech3342
.. _ITU-R BS.2217: https://www.itu.int/pub/R-REP-BS.2217
.. _LICENSE: LICENSE
.. _LICENSE-SCIPY: LICENSE-SCIPY
