View source for Read wave.m

{{DISPLAYTITLE:read_wave.m}}
Reads JCAMP-DX pulse waveform files. JCAMP-DX is a standard format in which pulse shaped are often distributed.

==Syntax==

     [A,phi,Cx,Cy]=read_wave(filename,npoints)

==Arguments==

   filename   -   a string containing the name of the file
 
   npoints    -   waveform upsampling or downsampling is
                  performed to this number of points

==Returns==

   A          -   polar amplitude at each slice
 
   phi        -   polar phase at each slice, radians
 
   Cx         -   Cartesian amplitude in X at each slice
 
   Cy         -   Cartesian amplitude in Y at each slice
 
   scaling factor -   scaling factor for a given pulse shape

==Examples==
A few examples are distributed with ''Spinach'', see /kernel/pulses/pk_files directory.

==Notes==
You can add your own pulse files to the same folder; please also consider sending them to us.

==See also==
[[shaped_pulse_af.m]], [[shaped_pulse_xy.m]], [[step.m]]

[[Kernel_functions#Shaped_pulses_and_gradients|Shaped pulses and gradients]]

''Version 2.2, authors: [[Ilya Kuprov]], [[Konstantin Pervushin]]''