4.18 sddsanalyticsignal

• description: sddsanalyticsignal computes the analytic signal of selected real data columns using a Hilbert transform. It outputs the real and imaginary parts as well as the magnitude and phase (both wrapped and unwrapped).
• examples: Compute the analytic signal of column signal as a function of time:
  sddsanalyticsignal data.sdds result.sdds -columns=time,signal  
    

• synopsis:
  sddsanalyticsignal [inputfile] [outputfile] [-pipe=[input][,output]] \  
    [-columns=indep-variable,depen-quantity[,...]] \  
    [-unwrapLimit=value] \  
    [-majorOrder=row|column]  
    

• switches:
  • -pipe[=input][,output] — The standard SDDS Toolkit pipe option.
  • -columns=indep-variable,depen-quantity[, ...] — Specifies the independent variable and one or more dependent columns to analyze. Wildcards are permitted for the dependent quantity names.
  • -unwrapLimit=value — Sets the relative magnitude threshold for phase unwrapping. Unwrapping is applied only when the signal’s magnitude exceeds this fraction of its maximum.
  • -majorOrder=row|column — Specifies the binary SDDS layout of the output file.
• files: inputfile is an SDDS file containing real data columns. outputfile is an SDDS file that will receive the analytic signal.
• see also: sddsfft().
• author: H. Shang, R. Soliday, ANL/APS.