Skip to main content

LumpedPortCoaxial

Description​

Defines a coaxial lumped port excitation and reference impedance on selected surfaces of the electromagnetic model.

The port is characterized by its inner and outer conductor radii, origin, excitation voltage, reference impedance, and power flow direction.

Construction​

port = LumpedPortCoaxial()port = LumpedPortCoaxial(boundary)port = LumpedPortCoaxial(boundary, property_name = property_value)

port = LumpedPortCoaxial()

port = LumpedPortCoaxial() Creates a coaxial lumped port with default parameters and without a boundary assignment.

port = LumpedPortCoaxial(boundary)

port = LumpedPortCoaxial(boundary) Creates a coaxial lumped port with the specified boundary and with default parameter.

port = LumpedPortCoaxial(boundary, property_name = property_value)

port = LumpedPortCoaxial(boundary, property_name = property_value) Creates a coaxial lumped port with the specified boundary and with specified property values.

Constructor Inputs​

NameTypeUnitRequiredDefaultDescription

boundary

int | list[int]

Optional

None

Mesh boundary IDs identifying the port surface.

inner_radius

float

m

Optional

1e-3

Radius of the inner conductor.

outer_radius

float

m

Optional

2e-3

Radius of the outer conductor.

origin

list[float]

m

Optional

0, 0, 0

Three-dimensional origin of the coaxial port.

impedance

float | complex

Ω

Optional

50.0

Reference impedance.

voltage

float

V

Optional

1.0

Excitation voltage.

power_flow_direction

list[float] | str

Optional

1, 0, 0

Positive power propagation direction toward the device under test.

Properties​

boundary

Type int | list[int]Access read/write

Mesh boundary IDs identifying the port surface.

inner_radius

Type floatAccess read/writeUnit m

Radius of the inner conductor. Must be positive.

outer_radius

Type floatAccess read/writeUnit m

Radius of the outer conductor. Must be positive.

origin

Type list[float]Access read/writeUnit m

Three-dimensional origin of the port.

impedance

Type float | complexAccess read/writeUnit Ω

Reference impedance.

voltage

Type floatAccess read/writeUnit V

Excitation voltage.

power_flow_direction

Type list[float] | strAccess read/write

Positive power propagation direction toward the device under test.

Examples​

from hado.boundary import LumpedPortCoaxial

port = LumpedPortCoaxial(
    boundary=5,
    inner_radius=0.5e-3,
    outer_radius=1.5e-3,
    origin=[0.0, 0.0, 0.0],
    power_flow_direction="z"
)

Errors / Exceptions​

Error / Exceptions List
tanager:validatormessage:mustBe3DVector
Condition

origin does not contain exactly three components.

Resolution

Specify origin as a list containing exactly three numeric coordinates.

tanager:validatormessage:mustBeValidDirection
Condition

power_flow_direction contains an unsupported direction string.

Resolution

Use “x”, “y”, “z”, “-x”, “-y”, or “-z”, or specify a numeric direction vector.

Notes​

The coaxial lumped port formulation assumes that outer_radius is greater than inner_radius. The current implementation validates that both radii are positive but does not enforce this relationship.

The power_flow_direction parameter accepts the axis strings "x", "y", "z", "-x", "-y", and "-z", in addition to direction vectors.