Import & Export

V-Listen provides flexible tools for importing measurement data from various sources and exporting analysis results in multiple formats. This page covers the import and export workflows, drag-and-drop support, batch operations, and format conversion best practices.

Importing Data

File Menu Import

1. Select File → Import or press Ctrl+I.
2. In the file browser, select one or more files. Use the format filter dropdown to narrow the file list by type.
3. For formats that require configuration (CSV, TXT, Excel), an import dialog appears with column mapping, unit selection, and preview options.
4. Click Import. The data appears in the Data Explorer panel.

Drag-and-Drop

The fastest way to import files is to drag them directly from Windows Explorer into the V-Listen main window:

• Single file — dropped onto the main area, imported immediately. For CSV/TXT files, the import dialog opens automatically.
• Multiple files — select multiple files in Explorer and drop them together. All files are imported in sequence.
• Folder — dropping a folder imports all recognized files within it (non-recursive by default).

Import FRF

For pre-computed Frequency Response Function data, use File → Import FRF. This specialized import path handles:

• UFF/UNV Type 58 files with FRF function type identifiers
• HEAD HDF transfer function files
• Excel spreadsheets with frequency, magnitude, and phase columns

The import wizard maps each function to a response DOF and reference DOF, enabling immediate use in modal analysis and FRF overlay displays.

Batch Import

For importing large datasets from measurement campaigns, use the batch import feature:

1. Select File → Batch Import.
2. Choose the source folder containing measurement files.
3. Configure file filters (e.g., *.hdf, *.wav).
4. Optionally enable Recursive to include subfolders.
5. Preview the file list and deselect any files to exclude.
6. Click Import All. A progress bar shows the batch status.

Exporting Data

Single Export

1. Select one or more items in the Data Explorer.
2. Right-click and choose Export, or use File → Export.
3. Select the target format from the format dropdown.
4. Configure format-specific options (e.g., delimiter for CSV, sheet layout for Excel).
5. Choose the destination folder and filename.
6. Click Export.

Export Options by Format

Format Conversion Tips

HEAD HDF to WAV

When converting HEAD HDF time-domain recordings to WAV for sharing with audio software:

• Use 32-bit float to preserve the full dynamic range of 24-bit recordings.
• Calibration information is lost in WAV format; note the sensitivity and reference level separately.
• Channel names are preserved in the WAV metadata (BWF/iXML) when available.

UFF to Excel

When converting UFF frequency data to Excel for reporting:

• Each FRF is placed on a separate sheet with frequency, real, imaginary, magnitude, and phase columns.
• Header rows include function type, response DOF, reference DOF, and measurement date.

CSV Import Best Practices

• Ensure consistent decimal separators throughout the file (do not mix dots and commas).
• Include a header row with column names and units (e.g., "Frequency [Hz]", "Amplitude [Pa]").
• Use at least 6 significant digits for frequency values to avoid rounding artifacts.
• For large files (> 100 MB), consider binary formats (HDF, WAV) for faster loading.

Clipboard Operations

V-Listen supports copy-paste for quick data transfer:

• Ctrl+C on a chart — copies the chart image to the clipboard for pasting into documents or presentations.
• Ctrl+C on a data table — copies the selected cells as tab-separated text, compatible with Excel paste.
• Ctrl+V in the Data Explorer — imports tab-separated data from the clipboard as a new dataset.

© 2026 V-Listen. All Rights Reserved.