Welcome to lupy’s documentation!

A Python library for Loudness measurements of audio signals.

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

$ pip install lupy

Dependencies

• numpy

• scipy

• typing-extensions (for python_version < “3.13”)

Project Links

Homepage

https://github.com/nocarryr/lupy

PyPI

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

Documentation

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

Contents

Contents:

• Usage
  • Setup
  • Configuring Measurements
  • Handling Input
  • Processing
  • Channel Layout
  • Measurement Data
• Reference
  • lupy.meter
  • lupy.processing
  • lupy.sampling
  • lupy.filters
  • lupy.types
  • lupy.arraytypes
  • lupy.typeutils
  • lupy.signalutils
• Glossary

Indices and tables

• Index

• Module Index

• Search Page