The optimizeposition command calculates the x shift, y shift, and z shift resulting in maximum overlap between the specified mode and d-card when using the FDE solver.
The x shift, y shift, and z shift correspond to the offset in the d-card profile in x, y, and z.
This function also populates the overlap and power coupling as well as the x shift, y shift, and z shift positions in the Overlap analysis tab of the Eigensolver Analysis window, similarly to when you click on the "Optimize position" button in the GUI.
See the overlap function for more details about overlap and coupling calculations.
out = optimizeposition(mode number, d-card number);
Note that the "shift d-card center" option must be selected in order to use this function.
This example shows how to use the optimizeposition command to calculate the x shift, y shift, and z shift between a specified mode and d-card resulting in maximum overlap, print out the shift values and the optimal overlap and power coupling with the applied shift.
setanalysis("shift d-card center",1);
shift = optimizeposition(4,1); # find x, y, z shift resulting in optimal overlap between
# the 4th mode in the mode list and the 1st mode in the deck
out = overlap("mode4","global_mode1",shift(1),shift(2),shift(3));
?"maximum power coupling:"+num2str(out(2));