NF2FF

NF2FF

class openEMS.nf2ff.nf2ff(CSX, name, start, stop, **kw)

Create an nf2ff recording box. The nf2ff can either record in time-domain or frequency-domain. Further more certain directions and boundary condition mirroring can be enabled/disabled.

Parameters:
  • name – str – Name for this recording box.

  • start/stop – (3,) array – Box start/stop coordinates.

  • directions – (6,) bool array – Enable/Disables directions.

  • mirror – (6,) int array – 0 (Off), 1 (PEC) or 2 (PMC) boundary mirroring

  • frequency – array like – List of frequencies (FD-domain recording)

CalcNF2FF(sim_path, freq, theta, phi, radius=1, center=[0, 0, 0], outfile=None, read_cached=False, verbose=0)

CalcNF2FF(sim_path, freq, theta, phi, center=[0,0,0], outfile=None, read_cached=True, verbose=0):

Calculate the far-field after the simulation is done.

Parameters:
  • sim_path – str – Simulation path

  • freq – array like – list of frequency for transformation

  • theta/phi – array like – Theta/Phi angles to calculate the far-field

  • radius – float – Radius to calculate the far-field (default is 1m)

  • center – (3,) array – phase center, must be inside the recording box

  • outfile – str – File to save results in. (defaults to recording name)

  • read_cached – bool – enable/disable read already existing results (default off)

  • verbose – int – set verbose level (default 0)

Returns:

nf2ff_results class instance

NF2FF Results

class openEMS.nf2ff.nf2ff_results(fn)

nf2ff result class containing all results obtained by the nf2ff calculation. Usueally returned from nf2ff.CalcNF2FF

Available attributes:

  • fn : file name

  • theta: theta angles

  • phi : phi angles

  • r : radius

  • freq : frequencies

  • Dmax : directivity over frequency

  • Prad : total radiated power over frequency

  • E_theta : theta component of electric field over frequency/theta/phi

  • E_phi : phi component of electric field over frequency/theta/phi

  • E_norm : abs component of electric field over frequency/theta/phi

  • E_cprh : theta component of electric field over frequency/theta/phi

  • E_cplh : theta component of electric field over frequency/theta/phi

  • P_rad : radiated power (S) over frequency/theta/phi