user_define_file
Description
Loads custom user waveform files
Syntax
Arguments
| filename | file name of custom user file |
| clock | frequency of the input clock |
Return Value
| numOfPoints | number of frequencies in user waveform file |
Example
unsigned numOfPoints;
Double clock = 2e9;
numOfPoints = dsm.user_define_file("user_defined_file.uwf", clock);
Notes
The user_define_file will chirp the contents of an external .uwf file provided that the file is formatted the correct way. The file gives you complete control of the frequencies to chirp. Chirping is not limited to linear chirps that are only available in built-in waveforms.
If you are using user_define_file and specify either #Type "1" or "2" then you must set the marker1 and marker2 properties in order to get the correct markers. If you are using user_define_file and specify either #Type "5" or "6", the marker1 and marker2 properties will be ignored and you must specify markers with the control bit words within the .uwf file.
If you are using user_define_file and specify either #Type "1" or "2" then you must set the RESET_T1, RESET_T2, and RESET_T3 properties in order to get the correct phase reset by memory options. If you are using user_define_file and specify either #Type "5" or "6", the RESET_T1, RESET_T2, and RESET_T3 properties will be ignored and you must specify phase reset with the control bit words within the .uwf file.
When you call the user_define_bulk method, the program will automatically download the data to the DSM. There is no need use the download method.
For more information regarding the .uwf file and how to format it please see the DSM Manual.