Difference between revisions of "Amp tanh.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Created page with "{{DISPLAYTITLE:amp_tanh.m}} __NOTOC__ Amplifier compression distortion model. Applies a saturating hyperbolic tangent distortion to the user-supplied waveform: y=a*tanh(...")
 
(Sync syntax/arguments/outputs with current Spinach source)
Line 1: Line 1:
 
{{DISPLAYTITLE:amp_tanh.m}} __NOTOC__
 
{{DISPLAYTITLE:amp_tanh.m}} __NOTOC__
 +
 
Amplifier compression distortion model. Applies a saturating hyperbolic tangent  
 
Amplifier compression distortion model. Applies a saturating hyperbolic tangent  
 
distortion to the user-supplied waveform:
 
distortion to the user-supplied waveform:
Line 10: Line 11:
 
==Syntax==
 
==Syntax==
  
−
    [w,J]=amp_tanh(w,sat_lvls)
+
[w,J]=amp_tanh(w,sat_lvls)
  
 
==Arguments==
 
==Arguments==
  
−
    w        - waveform in rad/s nutation frequency units,  
+
w        - waveform in rad/s nutation frequency units,
−
                 one time slice per column, and rows arranged
+
                 one time slice per column, and rows arran-
−
                 as XYXY... with respect to in-phase and  
+
                 ged as XYXY... with respect to in-phase and
 
                 quadrature parts on each control channel
 
                 quadrature parts on each control channel
−
+
 
−
     sat_lvls  - saturation levels beyond which the amplifier
+
     sat_lvls  - saturation levels beyond which the amplifi-
−
                 cannot go, one value per X,Y pair in w, giving
+
                 er cannot go, one value per X,Y pair in w,
−
                 the maximum output sqrt(X^2+Y^2)
+
                 giving the maximum output sqrt(X^2+Y^2)
  
 
==Outputs==
 
==Outputs==
  
−
    w        - distorted waveform in the same units and  
+
w        - distorted waveform in the same units and  
 
                 layout as the input
 
                 layout as the input
 
   
 
   
Line 32: Line 33:
  
 
==See also==
 
==See also==
 +
 
[[Optimal_control_module#Optimal_control_function_list:_distortions_and_penalties|Optimal_control_function_list:_distortions_and_penalties]]
 
[[Optimal_control_module#Optimal_control_function_list:_distortions_and_penalties|Optimal_control_function_list:_distortions_and_penalties]]
  
  
 
''Version 2.11, authors: [[Uluk Rasulov]], [[Ilya Kuprov]]''
 
''Version 2.11, authors: [[Uluk Rasulov]], [[Ilya Kuprov]]''

Revision as of 15:05, 5 April 2026


Amplifier compression distortion model. Applies a saturating hyperbolic tangent distortion to the user-supplied waveform:

   y=a*tanh(x/a)

Treats odd channels of multi-channel waveform as X and even ones as Y components; the autodiff Jacobian is returned for the vectorisation of the input array.

Syntax

[w,J]=amp_tanh(w,sat_lvls)

Arguments

w - waveform in rad/s nutation frequency units,

               one time slice per column, and rows arran-
               ged as XYXY... with respect to in-phase and
               quadrature parts on each control channel
   sat_lvls  - saturation levels beyond which the amplifi-
               er cannot go, one value per X,Y pair in w,
               giving the maximum output sqrt(X^2+Y^2)

Outputs

w - distorted waveform in the same units and

               layout as the input

   J         - distortion Jacobian matrix with respect 
               to the vectorisation of the input, sparse

See also

Optimal_control_function_list:_distortions_and_penalties


Version 2.11, authors: Uluk Rasulov, Ilya Kuprov