west_ic_antenna.antenna.WestIcrhAntenna

WEST ICRH Antenna circuit model.

Parameters:

frequency (scikit-rf skrf.frequency.Frequency or None, optional) – frequency object to build the circuit with. The default is None: frequency band is the one from antenna elements.
Cs (list or array) – antenna 4 capacitances [C1, C2, C3, C4] in [pF]. Default is [50,50,50,50] [pF]
front_face (str or :class: pathlib.Path or skrf.network.Network, optional) – path to the Touchstone file of the antenna front face. Default is None (Vacuum case). If the frequency band of the front_face Network is a unique point, as typically for TOPICA results for example, the s-parameters of the front_face Network is duplicated for all the frequencies defined by frequency.

Note

front face ports are defined as (view from behind, ie from torus hall):

port1  port2
port3  port4

Capacitor names are defined as (view from behind the antenna):

C1  C3
C2  C4

Voltages are defined the same way:

V1 V3
V2 V4

Examples

Building a WEST ICRH antenna model for a given frequency band:

>>> freq = rf.Frequency(50, 60, 101, unit='MHz')
>>> Cs = [50, 40, 60, 70]
>>> west_antenna = WestIcrhAntenna(freq, Cs)  # Vacuum loading case

Building a WEST ICRH antenna model for a given front-face configuration:

>>> # Here the s-param of the front_face are duplicated for all freq
>>> WestIcrhAntenna(front_face='./data/Sparameters/front_faces/TOPICA/S_TSproto12_55MHz_Profile1.s4p')

__init__(frequency: Frequency | None = None, Cs: Number | Sequence[Number] | ndarray = [50, 50, 50, 50], front_face: str | PathLike | Network | None = None)[source]

Methods

`Pr`(power, phase[, Cs])	Reflected power at antenna input.
`Rc`(power, phase[, Cs])	Coupling Resistances of both sides of the antenna.
`Rc_WEST`(power, phase[, Cs])	Coupling Resistances of both sides of the antenna - WEST Approximation.
`Z_T`(power, phase[, Cs])	Impedances Z_T at the T-junction.
`__init__`([frequency, Cs, front_face])
`b`(a[, Cs])	Reflected power-wave from a given input power-wave, defined by b=S x a.
`capa`(C[, R, L, R1, C1, L1, z0_bridge, ...])	Equivalent lumped Network model of a WEST ICRH antenna capacitor.
`capacitor_predictor`(power, phase, Cs[, ...])	Return a capacitance set toward matching.
`capacitor_velocities`(power, phase[, Cs, ...])	Velocity requests toward matching point.
`circuit`([Cs])	Build the antenna circuit for a given set of capacitance.
`currents`(power, phase[, Cs])	Currents at the antenna front face ports (after capacitors).
`currents_WEST`(power, phase[, Cs])	Currents at the capacitors as calculated in WEST.
`error_signals`(power, phase[, Cs, z_T_target])	Normalized Error Signals for left and right sides.
`front_face_Rc`([Is])	(Ideal) front-face coupling resistances.
`front_face_current_waves`([power, phase, Cs])	Calculate the forward and reflected current waves I+ and I-.
`front_face_powers_phases`([power, phase, Cs])	Calculate the forward powers and phases at the input of the 4-port front-face.
`front_face_voltage_waves`([power, phase, Cs])	Calculate the forward and reflected voltages waves.
`interpolate_front_face`(Rc[, source])	Return a TOPICA front-face rf.Network interpolated from the L or H mode data.
`load`(Rc[, Xs])	Load the antenna model with an ideal plasma load (no poloidal and toroidal cross coupling).
`match_both_sides`([f_match, power, phase, ...])	Match both sides at the same time for a given frequency target.
`match_both_sides_iterative`([f_match, power, ...])	Match both sides using the automatic matching alg.
`match_both_sides_separately`([f_match, ...])	Match both sides separately and returns capacitance values for each sides.
`match_one_side`([f_match, solution_number, ...])	Search for the best capacitance to match the specified side of the antenna.
`optimize`(fun, C0[, args, method, jac, hess, ...])	Optimize the capacitors for a given objective function.
`optimum_frequency`(power, phase[, Cs])	Optimum frequency with respect to active S-parameters for a given excitation.
`optimum_frequency_index`(power, phase[, Cs])	Array indexes of the optimum frequency with respect to active S-parameters for a given excitation.
`s_act`(power, phase[, Cs])	Active S-parameters for a given excitation.
`s_act_db`(power, phase[, Cs])	Active S-parameters magnitude in dB for a given excitation.
`swit_abcd`()	ABCD matrix of service Stub, Window and Impedance Transformer (aka "SWIT").
`voltages`(power, phase[, Cs])	Voltages at the antenna front face ports (after capacitors).
`vswr_act`(power, phase[, Cs])	Active VSWR for a given excitation.
`z_T`(power, phase[, Cs])	Input impedance at the T-junction (input of the bridge) for a given excitation.
`z_act`(power, phase[, Cs])	Active Z-parameters for a given excitation.
`z_coupler`(power, phase[, Cs])	Input impedance at the bidirective coupler for a given excitation.

Attributes

`Cs`	Antenna capacitance array [C1, C2, C3, C4] in [pF].
`f`	Antenna Frequency band values.
`f_scaled`	Antenna Frequency band scaled to the Frequency unit.
`frequency`	Antenna Frequency band.