npTDMS is a cross-platform, NumPy-based Python module designed for reading TDMS files, a binary data format produced by LabVIEW and LabWindows/CVI from National Instruments. It provides efficient access to measurement data and metadata. The current version is 1.10.0, and the library maintains an active development cycle with frequent releases addressing bug fixes, performance improvements, and new features.
pip install nptdmsVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to open a TDMS file using `TdmsFile` and iterate through its groups and channels to access metadata and data. It includes error handling for `FileNotFoundError` as a common issue. Replace `example.tdms` with the actual path to your TDMS file.
Upgrade your Python environment to version 3.7 or higher.
Upgrade npTDMS to the latest version: `pip install --upgrade nptdms`. Ensure NumPy is also updated: `pip install --upgrade numpy`.
Upgrade npTDMS to the latest version (`pip install --upgrade nptdms`) to benefit from enhanced read performance.
Upgrade npTDMS to the latest version (`pip install --upgrade nptdms`) to ensure robust handling of various TDMS file structures and prevent data integrity issues.
Verify the exact group/channel names within your TDMS file. You can iterate through `tdms_file.groups()` and `group.channels()` to list all available names: `for group in tdms_file.groups(): print(group.name); for channel in group.channels(): print(channel.name)`.
Access groups and channels by their string names, for example, `tdms_file['GroupName']` and `group['ChannelName']`. To iterate, use `tdms_file.groups()` and `group.channels()` methods.
Upgrade npTDMS to the latest version (`pip install --upgrade nptdms`). Version 1.10.0 specifically addresses compatibility with NumPy 2.0.