irdl 1.0.0b4

Python package to download, unpack and process impulse response datasets.

irdl: Impulse Response Downloader

Python package to download, unpack and process impulse response datasets in a unified way.

Highlights

• Returns data in a standardised format either
  • a dictionary of pyfar-objects (default) ('pyfar')
  • a dictionary of NumPy arrays ('numpy')
  • a path to an HDF5-file for partial data access not having to load the entire data into memory ('hdf5')
  • a path to a SOFA-file, the standardised format for spatially oriented acoustic data ('sofa')
  • a path to the unprocessed provider files as downloaded ('raw')
• Leverages pooch to download impulse response datasets and verifies their integrity with a checksum.
• Only downloads, extracts and processes what is actually needed.
• Adds pooch-support for dSpace repositories, such as TU Berlin depositonce.
• Data storage location can be set by the IRDL_CACHE_DIR environment variable (defaults to the user cache directory).
• Output can be processed and exported to a custom location via the export_dir argument.

Links

• Documentation
• Installation instructions
• Available datasets
• Adding a Dataset
• Reference (CLI & API)
• Changelog

Usage (Python API)

The package can be included in a Python script as simple as:

from irdl import MiracleDataset

data = MiracleDataset.get(scenario='D1')
print(data)

INFO     Downloading MIRACLE scenario D1
INFO     Downloading file 'D1.h5' from
         'https://api-depositonce.tu-berlin.de/server/api/core/bitstreams/4b6cb9e5-f1e4-42c6-9b41-0a85e6ee9422/cont
         ent' to '/home/pelling/.cache/irdl/MIRACLE/provider'.
D1.h5 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 302.3/302.3 MB 43.9 TB/s 0:00:00
INFO     Convention SingleRoomMIMOSRIR v1.0 is up to date
{'impulse_response': time domain energy Signal:
(1, 1089, 64) channels with 1024 samples @ 32000.0 Hz sampling rate and none FFT normalization
, 'source_coordinates': 1D Coordinates object with 1089 points of cshape (1089,)

Does not contain sampling weights, 'receiver_coordinates': 2D Coordinates object with 64 points of cshape (64, 1)

Does not contain sampling weights}

Usage (CLI)

Once installed, the package provides a convenient command line script which can be invoked with irdl.

 Usage: irdl [OPTIONS] COMMAND [ARGS]...

╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --install-completion          Install completion for the current shell.                                         │
│ --show-completion             Show completion for the current shell, to copy it or customize the installation.  │
│ --help                        Show this message and exit.                                                       │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ──────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ list   List all available datasets.                                                                             │
│ cache  Manage cache directory.                                                                                  │
│ get    Download datasets.                                                                                       │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯