File Loading and Visualization Example

This example demonstrates how to load EMG data from an Intan .rhd file and visualize it using the plotting utilities in the intan package.

Requirements: - An Intan .rhd data file (can be selected via file dialog) - matplotlib for plotting

You’ll see how to: - Load a file interactively - Print available channel names - Plot a multi-channel “waterfall” EMG visualization - Plot individual channels by name and index - Plot analog input channels

---

Example code:

"""
Example: Loading and visualizing EMG data from an Intan .rhd file.
"""

from intan.io import load_rhd_file, print_all_channel_names
from intan.plotting import waterfall, plot_channel_by_index, plot_channel_by_name, plot_figure

if __name__ == "__main__":
    # ==== Load the data (file dialog opens) ====
    result = load_rhd_file()

    # ==== Get some data from the file ====
    emg_data = result.get('amplifier_data')           # Shape: (num_channels, num_samples)
    fs = result['frequency_parameters']['amplifier_sample_rate']
    t_s = result.get('t_amplifier')                   # Time vector
    analog_data = result.get('board_adc_data')        # Analog inputs (if present)

    # ==== Print all available channel names ====
    print_all_channel_names(result)

    # ==== Multi-channel visualization: Waterfall plot ====
    waterfall(emg_data, range(64, 128), t_s, plot_title='Intan EMG data (Channels 64-127)')

    # ==== Single channel visualization ====
    ch_info = result.get('amplifier_channels')
    ch_name = ch_info[4].get('native_channel_name') if ch_info else None
    if ch_name:
        plot_channel_by_name(ch_name, result)       # By name
    plot_channel_by_index(8, result)                # By index

    # ==== Plot the first analog channel, if available ====
    if analog_data is not None:
        plot_figure(analog_data[0, :], t_s, 'Analog data (Channel 0)')

---

Expected outcome:

• A window will open to select your .rhd data file.

• Channel names are printed in the terminal.

• Plots of EMG and analog signals will be displayed for visual inspection.

Tip: You can modify the code to load specific files or to plot different channels. See the API Reference for all available plotting utilities.