InvertedFAntennaParams#

class simpleEMS.ifa_antenna.InvertedFAntennaParams(resonant_freq: float, span_freq: float, via_diameter_mm: float = 0.6, *, substrate_eps_r: float, substrate_tand: float, substrate_thickness_mm: float, substrate_cells: int = 7, unit: float = 0.001, num_points: int = 1000, backend_engine: str = 'FDTD', simulation_box: ndarray[tuple[Any, ...], dtype[_ScalarT]] | None = None, FEM_num_solve_points: int = 10, FEM_max_solve_points: int | None = None, FEM_boundary: str = 'silver_muller', FEM_symmetry: tuple | None = None, FEM_fe_order: int = 1, FEM_air_pad_frac: float = 0.25, FEM_air_pad_mm: float | tuple | None = None, FEM_elems_per_wavelength: float = 16.0, FEM_mesh_freq: float | None = None, FEM_mesh_fine_scale: float = 1.0, FEM_min_layers: int = 3, FEM_port_type: str = 'lumpedport', FEM_port_mode_modes: int = 6, FEM_port_mode_index: int = 0, FEM_port_mode_zc: float | None = None, FEM_port_mode_eps_eff: float | None = None, FEM_waveport_width_mm: float | None = None, FEM_waveport_height_mm: float | None = None, FDTD_timestep: int = 90000000, FDTD_end_criteria: float = 0.0001, FDTD_mesh_resolution_factor: int = 10, FDTD_metal_mesh_resolution_factor: int = 40, copper_thickness_mm: float = 0.035, min_trace_width_mm: float = 0.1, min_trace_spacing_mm: float = 0.089, fp_precision: int = 3, charac_imp: float = 50)#

Bases: SimParams

Parameters for a printed inverted-F antenna (IFA).

Extends SimParams and computes the derived geometric parameters (radiating tip, shorting leg, and feed line dimensions) required to build and simulate a printed IFA.

Parameters:
  • resonant_freq (float) – Target resonant frequency of the antenna in Hz.

  • span_freq (float) – Frequency span used to compute the simulation range around the resonant frequency in Hz.

  • via_diameter_mm (float, optional) – Finished outer diameter of the shorting via, in millimeters. Must fit inside the shorting leg’s overlap with the ground plane. Default 0.6.

rad_tip_length_mm#

Length of the radiating tip (x-direction) in millimeters.

Type:

float

rad_tip_width_mm#

Width of the radiating tip (y-direction) in millimeters.

Type:

float

short_tip_length_mm#

Length of the shorting leg (y-direction) in millimeters.

Type:

float

short_tip_width_mm#

Width of the shorting leg (x-direction) in millimeters; equal to rad_tip_width_mm.

Type:

float

feed_spacing_factor#

Divisor applied to rad_tip_length_mm to derive feed_spacing_mm.

Type:

int

feed_spacing_mm#

Distance in x between the shorting leg and the feed arm, in millimeters.

Type:

float

feed_line_length_mm#

Length of the feed line, in millimeters; equal to short_tip_length_mm.

Type:

float

lambda_eff#

Free-space wavelength at resonant_freq, in meters.

Type:

float

rad_tip_total_length_mm#

Total arm length (shorting leg, corner, and radiating tip) in millimeters, set to a quarter wavelength at resonant_freq.

Type:

float

substrate_width_mm#

Substrate width including margin (lambda0 padding).

Type:

float

substrate_length_mm#

Substrate length including margin (lambda0 padding).

Type:

float

Notes

short_tip_length_mm, rad_tip_width_mm, and feed_spacing_mm are fixed starting values; the feed spacing in particular sets the input match and is meant to be tuned.

As a subclass of SimParams, this class also accepts all of SimParams’s constructor arguments (e.g. substrate_eps_r, substrate_tand, substrate_thickness_mm, charac_imp); see that class’s docstring for details.

Attributes Summary

Attributes Documentation

FDTD_end_criteria: float = 0.0001#
FDTD_mesh_resolution_factor: int = 10#
FDTD_metal_mesh_resolution_factor: int = 40#
FDTD_timestep: int = 90000000#
FEM_air_pad_frac: float = 0.25#
FEM_air_pad_mm: float | tuple | None = None#
FEM_boundary: str = 'silver_muller'#
FEM_elems_per_wavelength: float = 16.0#
FEM_fe_order: int = 1#
FEM_max_solve_points: int | None = None#
FEM_mesh_fine_scale: float = 1.0#
FEM_mesh_freq: float | None = None#
FEM_min_layers: int = 3#
FEM_num_solve_points: int = 10#
FEM_port_mode_eps_eff: float | None = None#
FEM_port_mode_index: int = 0#
FEM_port_mode_modes: int = 6#
FEM_port_mode_zc: float | None = None#
FEM_port_type: str = 'lumpedport'#
FEM_symmetry: tuple | None = None#
FEM_waveport_height_mm: float | None = None#
FEM_waveport_width_mm: float | None = None#
backend_engine: str = 'FDTD'#
charac_imp: float = 50#
copper_thickness_mm: float = 0.035#
fem_options#

Bundle the flat FEM_* fields into a FEMOptions instance.

fp_precision: int = 3#
freq_range#

Compute the simulation frequency range.

Returns:

A tuple containing (f_min, f_max) calculated as (resonant_freq - span_freq, resonant_freq + span_freq).

Return type:

tuple of (float, float)

main_freq#

Return the primary frequency of interest for post-processing.

Returns:

The resonant frequency of the antenna.

Return type:

float

min_trace_spacing_mm: float = 0.089#
min_trace_width_mm: float = 0.1#
num_points: int = 1000#
simulation_bounds#

Return simulation_box as per-axis [min, max] bounds.

A (3,) box of sizes is centred on the origin.

Returns:

Array of shape (3, 2), [[xmin, xmax], [ymin, ymax], [zmin, zmax]] in mm, or None when no simulation box is defined.

Return type:

NDArray or None

simulation_box: ndarray[tuple[Any, ...], dtype[_ScalarT]] | None = None#
substrate_cells: int = 7#
substrate_length_mm#

Return the substrate length including lambda0 padding.

Returns:

Substrate length in mm.

Return type:

float

substrate_width_mm#

Return the substrate width including lambda0 padding.

Returns:

Substrate width in mm.

Return type:

float

unit: float = 0.001#
via_diameter_mm: float = 0.6#