Skip to content
Snippets Groups Projects
Select Git revision
  • main
  • main_backup
  • multi_out_example
  • python2
4 results

audio_utils

  • Clone with SSH
  • Clone with HTTPS
    • user avatar
    feat: Add ChannelFilter and SocketServer
    Sebastian Zach authored and Basti committed
    ad54f514
    History
    user avatar ad54f514
    History
    Name Last commit Last update
    msg
    scripts
    src
    .clang-format
    .gitignore
    .gitmodules
    CMakeLists.txt
    LICENSE
    README.md
    package.xml
    requirements.txt
    setup.py
    README.md

    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