Skip to content

Latest commit

 

History

History
210 lines (142 loc) · 7.94 KB

README.md

File metadata and controls

210 lines (142 loc) · 7.94 KB

audio_utils

ROS nodes and utilities for audio streams.

Author(s): Marc-Antoine Maheux

Setup (Ubuntu)

The following subsections explain how to use the library on Ubuntu.

Install Dependencies

sudo apt-get install cmake build-essential gfortran texinfo libasound2-dev libpulse-dev libgfortran-*-dev

Install Python Dependencies

sudo pip install -r requirements.txt

or

sudo pip3 install -r requirements.txt

Setup Submodules

git submodule update --init --recursive

Nodes

capture_node

This node captures the sound from an ALSA or PulseAudio device and publishes it to a topic.

Parameters

  • backend (string): The backend to use (alsa or pulse_audio).
  • device (string): The device to capture (ex: hw:CARD=1,DEV=0 or default for ALSA, or alsa_input.usb-IntRoLab_16SoundsUSB_Audio_2.0-00.multichannel-input for PulseAudio).
  • format (string): The audio format ( see audio_utils/AudioFrame).
  • channel_count (int): The device channel count.
  • sampling_frequency (int): The device sampling frequency.
  • frame_sample_count (int): The number of samples in each frame.
  • merge (bool): Indicate to merge the channels or not. The default value is false.
  • gain (double): The gain to apply. The default value is 1.0.
  • latency_us (int): The capture latency in microseconds.
  • channel_map (Array of string): The PulseAudio channel mapping. If empty or omitted, the default mapping is used. This parameter must be set only with the PulseAudio backend. In launch files, use this syntax : <rosparam param="channel_map">[]</rosparam>.

Published Topics

playback_node

This node captures the sound from a topic and plays it to an ALSA or PulseAudio device.

Parameters

  • backend (string): The backend to use (alsa or pulse_audio).
  • device (string): The device to capture (ex: hw:CARD=1,DEV=0 or default for ALSA, or alsa_input.usb-IntRoLab_16SoundsUSB_Audio_2.0-00.multichannel-input for PulseAudio).
  • format (string): The audio format ( see audio_utils/AudioFrame).
  • channel_count (int): The device channel count.
  • sampling_frequency (int): The device sampling frequency.
  • frame_sample_count (int): The number of samples in each frame.
  • latency_us (int): The capture latency in microseconds.
  • channel_map (Array of string): The PulseAudio channel mapping. If empty or omitted, the default mapping is used. This parameter must be set only with the PulseAudio backend. In launch files, use this syntax : <rosparam param="channel_map">[]</rosparam>.

Subscribed Topics

beat_detector_node

This node estimates the song tempo and detects if the beat is in the current frame.

Parameters

  • sampling_frequency (int): The device sampling frequency. The default value is 44100.
  • frame_sample_count (int): The number of samples in each analysed frame. It must be a multiple of oss_fft_window_size. The default value is 128.
  • oss_fft_window_size (int): The onset strength signal window size. It must be greater than or equal to frame_sample_count. The default value is 1024.
  • flux_hamming_size (int): The flux hamming window size to calculate the onset strength signal. The default value is 15.
  • oss_bpm_window_size (int): The onset strength signal window size to calculate the BPM value. The default value is 1024.
  • min_bpm (double): The minimum valid BPM value. The default value is 50.
  • max_bpm (double): The maximum valid BPM value. The default value is 180.
  • bpm_candidate_count (int): The number of cross-correlations to perform to find the best BPM. The default value is 10.

Subscribed Topics

Published Topics

  • bpm (std_msgs/Float32): The tempo in bpm (beats per minute) for each frame.
  • beat (std_msgs/Bool): Indicate if the beat is in the current frame.

format_conversion_node.py

This node converts the format of an audio topic.

Parameters

Subscribed Topics

Published Topics

resampling_node.py

This node resamples an audio topic.

Parameters

  • input_format (string): The input audio format ( see audio_utils/AudioFrame).
  • output_format (string): The output audio format ( see audio_utils/AudioFrame).
  • channel_count (int): The device channel count.
  • input_sampling_frequency (int): The input sampling frequency.
  • output_sampling_frequency (int): The output sampling frequency.
  • input_frame_sample_count (int): The number of samples in each frame of the input.
  • dynamic_input_resampling (bool: default is false): If true, always adjust the input sampling informations ( format, sampling frequency and frame sample count) to the sampling informations of the reveiced frames, dynamically. In this mode, input_format, input_sampling_frequency and input_frame_sample_count are not required, but they can be used to save a recomputation if the starting input sampling informations are known.

Subscribed Topics

Published Topics

split_channel_node.py

This node split a multichannel audio topic into several mono audio topics.

Parameters

Subscribed Topics

Published Topics

raw_file_writer_node.py

This node writes the raw sound data to a file.

Parameters

  • output_path (string): The output file path.

Subscribed Topics

License

Sponsor

IntRoLab

IntRoLab - Intelligent / Interactive / Integrated / Interdisciplinary Robot Lab