Import/Export of TDM Files¶
The addin converts TDM and TDMS files to UniPlot-netCDF data files and netCDF files to TDM files.
TDM files are created by DIAdem or Labview (National Instruments). The addin is
based on the DIAdem Connectivity Library nilibddc.dll
of National
Instruments.
Installation¶
- Choose Tools=>Add-In Manager.
- Check the “TDM-Import/Export” addin.
- Choose OK. Restart UniPlot.
Usage¶
TDM Import¶
- Choose File=>Import Data.
- Choose Type “TDM File (*.tdm; *.tdms)”.
- Select one or more TDM files.
TDM Export¶
- Open an NC file using the File=>Import Data command.
- click on the “>>” button.
- Right click in the data grid and choose Export=>Save AS TDM File.
- Choose a name for the TDM file.
Configuration¶
Use the Tools=>TDM Import Configuration to set the option for creating the channel names in the NC file.
Format¶
In TDM format, channels are organized in groups. In netCDF files the group
is replaced by a group number, for example: G1_ZWSTAT
. The group
number is only used for TDM files containing more than one group.
The following parameters are read from the Windows-Registry:
Key | Type | Default Value | Description |
---|---|---|---|
"Settings\TDM_StripGroupName" |
Number | 0 | Flag for TDM import. If the flag is set to 1, the channel name in the
netCDF files does not contain the group name, e.g. G1_ . |
WriteProfileInt("Settings", "TDM_StripDeviceName", 1)
See also UniPlot’s Use of the Windows Registry.
Programming Interface¶
The programming interface is similar to the interface documented by National
Instruments. The following table contains all supported functions. An example
can be found in the uniplot\addin\rs_tdm\rs_tdm.ic
file.
Original-Function | UniScript-Function |
---|---|
DDC_CreateFile | _DDC_CreateFile |
DDC_AddChannelGroup | _DDC_AddChannelGroup |
DDC_AddChannel | _DDC_AddChannel |
DDC_SaveFile | _DDC_SaveFile |
DDC_CloseFile | _DDC_CloseFile |
DDC_OpenFileEx | _DDC_OpenFileEx |
DDC_RemoveChannelGroup | _DDC_RemoveChannelGroup |
DDC_RemoveChannel | _DDC_RemoveChannel |
DDC_CloseChannelGroup | _DDC_CloseChannelGroup |
DDC_CloseChannel | _DDC_CloseChannel |
DDC_OpenFile | Verwenden Sie _DDC_OpenFileEx |
DDC_SetDataValues | _DDC_SetDataValues |
DDC_AppendDataValues | _DDC_AppendDataValues |
DDC_ReplaceDataValues | _DDC_ReplaceDataValues |
DDC_GetNumChannelGroups | - |
DDC_GetChannelGroups | _DDC_GetChannelGroups |
DDC_GetNumChannels | - |
DDC_GetChannels | _DDC_GetChannels |
DDC_GetNumDataValues | _DDC_GetNumDataValues |
DDC_GetDataValues | _DDC_GetDataValues |
DDC_GetDataType | _DDC_GetDataType |
DDC_SetFileProperty | _DDC_SetProperty |
DDC_GetFileProperty | _DDC_GetProperty |
DDC_GetFileStringPropertyLength | Not necessary. |
DDC_CreateFileProperty | _DDC_CreateProperty |
DDC_FilePropertyExists | _DDC_PropertyExists |
DDC_GetNumFileProperties | - |
DDC_GetFilePropertyNames | _DDC_GetPropertyNames |
DDC_GetFilePropertyType | _DDC_GetPropertyType |
DDC_SetChannelGroupProperty | _DDC_SetProperty |
DDC_GetChannelGroupProperty | _DDC_GetProperty |
DDC_GetChannelGroupStringPropertyLength | Not necessary. |
DDC_CreateChannelGroupProperty | _DDC_CreateProperty |
DDC_ChannelGroupPropertyExists | _DDC_PropertyExists |
DDC_GetNumChannelGroupProperties | - |
DDC_GetChannelGroupPropertyNames | _DDC_GetPropertyNames |
DDC_GetChannelGroupPropertyType | _DDC_GetPropertyType |
DDC_SetChannelProperty | _DDC_SetProperty |
DDC_GetChannelProperty | _DDC_GetProperty |
DDC_GetChannelStringPropertyLength | Not necessary. |
DDC_CreateChannelProperty | _DDC_CreateProperty |
DDC_ChannelPropertyExists | _DDC_PropertyExists |
DDC_GetNumChannelProperties | - |
DDC_GetChannelPropertyNames | _DDC_GetPropertyNames |
DDC_GetChannelPropertyType | _DDC_GetPropertyType |
DDC_GetLibraryErrorDescription | Not necessary. |
DDC_FreeMemory | Not necessary. |
Licensing Conditions¶
Portions used under license from National Instruments Corporation; copyright (c) 2007 National Instruments Corporation.
The complete license text can be found in EmbeddedUSICopyrights.chm
and
license.rtf
in the addin/rs_tdm
directory.
History
Version | Description |
---|---|
R2023.0 | Source library update - National Instruments TDM DLL (V17) |
R2012.11 | Group name can be added to channel name. |
R2012.9 | New DLLs with TDM Streaming (.tdms) 2.0 file format support added. |
5.5.0 | New. |
id-1404633