Difference between revisions of "Amp tanh.m"
(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) | |
==Arguments== | ==Arguments== | ||
| − | + | w - waveform in rad/s nutation frequency units, | |
| − | one time slice per column, and rows | + | 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 | + | sat_lvls - saturation levels beyond which the amplifi- |
| − | cannot go, one value per X,Y pair in w, | + | 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 | |
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