#include <microstrip.h>

Inheritance diagram for MICROSTRIP:

Public Member Functions
	MICROSTRIP ()

void	Analyse () override
	Analyse track geometry parameters to output Z0 and Ang_L.

bool	Synthesize (SYNTHESIZE_OPTS aOpts) override
	Synthesis track geometry parameters to match given Z0.

double	GetSoldermaskDeltaQ (double aWOverH, double aCOverH) const override
	Microstrip soldermask incremental filling factor.

void	SetParameter (const TRANSLINE_PARAMETERS aParam, const double aValue)
	Sets the given calculation property.

double	GetParameter (const TRANSLINE_PARAMETERS aParam) const
	Gets the given calculation property.

double &	GetParameterRef (const TRANSLINE_PARAMETERS aParam)
	Adds a constant to the given parameter.

std::unordered_map< TRANSLINE_PARAMETERS, std::pair< double, TRANSLINE_STATUS > > &	GetAnalysisResults ()
	Gets the output parameters following analysis.

std::unordered_map< TRANSLINE_PARAMETERS, std::pair< double, TRANSLINE_STATUS > > &	GetSynthesisResults ()
	Gets the output parameters following synthesis.

virtual void	SetSynthesizeTarget (TRANSLINE_PARAMETERS aTarget)
	Hint from UI picking which geometry parameter is the unknown when Synthesize is called.

TRANSLINE_PARAMETERS	GetSynthesizeTarget () const
	Returns the parameter that will be solved for during synthesis.

void	UpdateDielectricModel ()
	Refit the Djordjevic-Sarkar model from the current parameter map.

double	GetDispersedEpsilonR (double aF) const
	Dispersed permittivity at aF. Returns raw EPSILONR when the model is inactive.

double	GetDispersedTanDelta (double aF) const
	Dispersed loss tangent at aF. Returns raw TAND when the model is inactive.

std::pair< double, double >	ApplySoldermaskCorrection (double aEpsEffUncoated, double aTanDeltaSubstrate, double aEpsRSubstrate, double aWOverH, double aF) const
	Apply a three-layer (substrate / soldermask / air) correction to an un-coated (eps_eff, tan_delta) pair using the air-replacement decomposition of Bahl and Stuchly 1980, with the mask filling factor computed from Svacina 1992 as improved by Wan and Hoorfar 2000.

Static Public Member Functions
static double	WanHoorfarQ2 (double aU, double aHBarTop)
	Wan-Hoorfar 2000 eq.

Protected Member Functions
void	InitProperties (const std::initializer_list< TRANSLINE_PARAMETERS > &aParams)
	Initialises the properties used (as inputs or outputs) by the calculation.

void	SetAnalysisResult (TRANSLINE_PARAMETERS aParam, const double aValue, const TRANSLINE_STATUS aStatus=TRANSLINE_STATUS::OK)
	Sets an analysis result.

void	SetSynthesisResult (TRANSLINE_PARAMETERS aParam, const double aValue, const TRANSLINE_STATUS aStatus=TRANSLINE_STATUS::OK)
	Sets a synthesis result.

bool	MinimiseZ0Error1D (TRANSLINE_PARAMETERS aOptimise, TRANSLINE_PARAMETERS aMeasure, bool aRecalculateLength=false)
	minimizeZ0Error1D

bool	MinimiseZ0Error2D (TRANSLINE_PARAMETERS aParam1, TRANSLINE_PARAMETERS aParam2)
	minimizeZ0Error2D

double	SkinDepth () const
	Calculate skin depth.

Static Protected Member Functions
static double	UnitPropagationDelay (double aEpsilonEff)
	Calculates the unit propagation delay (ps/cm) for the given effective permittivity.

static std::pair< double, double >	EllipticIntegral (double arg)
	Computes the complete elliptic integral of first kind K() and the second kind E() using the arithmetic-geometric mean algorithm (AGM) by Abramowitz and Stegun.

static double	coth (const double x)
	Calculates cosh of the given argument.

static double	sech (const double x)
	Calculates sech of the given argument.

Protected Attributes
std::unordered_map< TRANSLINE_PARAMETERS, double >	m_parameters
	All input and output properties used by the calculation.

std::unordered_map< TRANSLINE_PARAMETERS, std::pair< double, TRANSLINE_STATUS > >	m_analysisStatus
	Analysis results.

std::unordered_map< TRANSLINE_PARAMETERS, std::pair< double, TRANSLINE_STATUS > >	m_synthesisStatus
	Synthesis results.

TRANSLINE_PARAMETERS	m_synthesizeTarget { TRANSLINE_PARAMETERS::UNKNOWN_ID }
	Which geometry parameter is the unknown during synthesis (set by the UI)

std::optional< DIELECTRIC_DJORDJEVIC_SARKAR >	m_dsModel
	Fitted Djordjevic-Sarkar model. Empty unless DIELECTRIC_MODEL_SEL selects it.

Static Protected Attributes
static constexpr double	m_maxError { 0.000001 }
	The maximum error for Z0 optimisations.

Private Types
using	TCP = TRANSLINE_PARAMETERS

Private Member Functions
void	SetAnalysisResults () override
	Sets the output values and status following analysis.

void	SetSynthesisResults () override
	Sets the output values and status following synthesis.

double	SynthesizeWidth () const
	Calculates the width with the current set of parameters.

double	conductor_losses () const
	Calculate the microstrip conductor losses per unit.

double	dielectric_losses () const
	Calculates the microstrip dielectric losses per unit.

void	microstrip_Z0 ()
	Calculates the microstrip static impedance.

void	dispersion ()
	Calculates frequency dependent parameters of the microstrip.

void	attenuation ()
	Calculates the attenuation of the microstrip.

void	mur_eff_ms ()
	Calculates the effective magnetic permeability.

void	line_angle ()
	Calculates microstrip length in radians.

Static Private Member Functions
static double	Z0_dispersion (double, double, double, double, double)
	Calculates the dispersion correction factor for the characteristic impedance static.

static double	Z0_homogeneous (double)
	Calculates the impedance for a stripline in a homogeneous medium, without cover effects.

static double	delta_Z0_cover (double, double)
	Calculates the cover effect on impedance for a stripline in a homogeneous medium.

static double	filling_factor (double, double)
	Calculates the filling factor for a microstrip without cover and zero conductor thickness.

static double	delta_q_cover (double)
	Calculates the cover effect on filling factor.

static double	delta_q_thickness (double, double)
	Calculates the thickness effect on filling factor.

static double	e_r_effective (double, double)
	Calculates effective dielectric constant from material e_r and filling factor.

static double	delta_u_thickness (double, double, double)
	Calculates the thickness effect on normalized width.

static double	e_r_dispersion (double, double, double)
	Calculates the dispersion correction factor for the effective permeability.

Private Attributes
double	Z0_0 { 0.0 }
	static characteristic impedance

double	er_eff_0 { 0.0 }
	Static effective dielectric constant.

double	mur_eff { 0.0 }
	Effective mag. permeability.

double	w_eff { 0.0 }
	Effective width of line.

double	Z0_h_1 { 0.0 }
	homogeneous stripline impedance

Friends
class	COUPLED_MICROSTRIP

Detailed Description

Definition at line 33 of file common/transline_calculations/microstrip.h.

Member Typedef Documentation

◆ TCP

using MICROSTRIP::TCP = TRANSLINE_PARAMETERS

private

Definition at line 35 of file common/transline_calculations/microstrip.h.

Constructor & Destructor Documentation

◆ MICROSTRIP()

MICROSTRIP::MICROSTRIP ( )

inline

Definition at line 38 of file common/transline_calculations/microstrip.h.

References ANG_L, ATTEN_COND, ATTEN_DILECTRIC, DIELECTRIC_MODEL_SEL, EPSILON_EFF, EPSILONR, EPSILONR_SPEC_FREQ, FREQUENCY, H, H_T, MUR, MURC, PHYS_LEN, PHYS_WIDTH, ROUGH, SIGMA, SKIN_DEPTH, SOLDERMASK_EPSILONR, SOLDERMASK_PRESENT, SOLDERMASK_TAND, SOLDERMASK_THICKNESS, T, TAND, TRANSLINE_CALCULATION_BASE::TRANSLINE_CALCULATION_BASE(), UNIT_PROP_DELAY, and Z0.

Member Function Documentation

◆ Analyse()

void MICROSTRIP::Analyse ( )

overridevirtual

Analyse track geometry parameters to output Z0 and Ang_L.

Implements TRANSLINE_CALCULATION_BASE.

Definition at line 34 of file common/transline_calculations/microstrip.cpp.

References TRANSLINE_CALCULATION_BASE::ApplySoldermaskCorrection(), attenuation(), dispersion(), EPSILONR, er_eff_0, FREQUENCY, TRANSLINE_CALCULATION_BASE::GetDispersedEpsilonR(), TRANSLINE_CALCULATION_BASE::GetDispersedTanDelta(), TRANSLINE_CALCULATION_BASE::GetParameter(), H, line_angle(), microstrip_Z0(), mur_eff_ms(), PHYS_WIDTH, TRANSLINE_CALCULATION_BASE::SetParameter(), TAND, TRANSLINE_CALCULATION_BASE::UpdateDielectricModel(), Z0, and Z0_0.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), and Synthesize().

◆ ApplySoldermaskCorrection()

std::pair< double, double > TRANSLINE_CALCULATION_BASE::ApplySoldermaskCorrection	(	double	aEpsEffUncoated,
		double	aTanDeltaSubstrate,
		double	aEpsRSubstrate,
		double	aWOverH,
		double	aF ) const

inherited

Apply a three-layer (substrate / soldermask / air) correction to an un-coated (eps_eff, tan_delta) pair using the air-replacement decomposition of Bahl and Stuchly 1980, with the mask filling factor computed from Svacina 1992 as improved by Wan and Hoorfar 2000.

eps_eff_coated   = eps_eff_uncoated + Delta q_mask * (eps_mask - 1)
tan_delta_coated = [ q_sub * eps_sub * tan_delta_sub
                     + Delta q_mask * eps_mask * tan_delta_mask ] / eps_eff_coated

q_sub is inferred from eps_eff_uncoated using the standard filling factor relation q_sub = (eps_eff_uncoated - 1) / (eps_sub - 1), which is exact to within the quasi- TEM assumption that produces eps_eff in the first place. Returns the inputs unchanged when SOLDERMASK_PRESENT is 0, the mask thickness is 0, the mask parameters are non-physical, or the subclass reports Delta q_mask <= 0. aF is reserved for a future frequency-dependent mask model and currently unused.

Definition at line 274 of file transline_calculation_base.cpp.

References GetParameter(), GetSoldermaskDeltaQ(), H, SOLDERMASK_EPSILONR, SOLDERMASK_PRESENT, SOLDERMASK_TAND, and SOLDERMASK_THICKNESS.

Referenced by COPLANAR::Analyse(), COUPLED_MICROSTRIP::Analyse(), and MICROSTRIP::Analyse().

◆ attenuation()

void MICROSTRIP::attenuation ( )

private

Calculates the attenuation of the microstrip.

Definition at line 443 of file common/transline_calculations/microstrip.cpp.

References ATTEN_COND, ATTEN_DILECTRIC, conductor_losses(), dielectric_losses(), TRANSLINE_CALCULATION_BASE::GetParameter(), PHYS_LEN, TRANSLINE_CALCULATION_BASE::SetParameter(), SKIN_DEPTH, and TRANSLINE_CALCULATION_BASE::SkinDepth().

Referenced by Analyse().

◆ conductor_losses()

double MICROSTRIP::conductor_losses ( ) const

private

Calculate the microstrip conductor losses per unit.

Definition at line 339 of file common/transline_calculations/microstrip.cpp.

References TRANSLINE_CALCULATIONS::C0, delta, er_eff_0, FREQUENCY, TRANSLINE_CALCULATION_BASE::GetParameter(), M_PI, PHYS_WIDTH, ROUGH, SIGMA, SKIN_DEPTH, Z0_h_1, and TRANSLINE_CALCULATIONS::ZF0.

Referenced by attenuation().

◆ coth()

static double TRANSLINE_CALCULATION_BASE::coth ( const double x )

inlinestaticprotectedinherited

Calculates cosh of the given argument.

Definition at line 328 of file transline_calculation_base.h.

Referenced by COUPLED_STRIPLINE::calcZeroThicknessCoupledImpedances().

◆ delta_q_cover()

double MICROSTRIP::delta_q_cover ( double h2h )

staticprivate

Calculates the cover effect on filling factor.

Definition at line 278 of file common/transline_calculations/microstrip.cpp.

Referenced by microstrip_Z0().

◆ delta_q_thickness()

double MICROSTRIP::delta_q_thickness	(	double	u,
		double	t_h )

staticprivate

Calculates the thickness effect on filling factor.

Definition at line 296 of file common/transline_calculations/microstrip.cpp.

References M_PI.

Referenced by microstrip_Z0().

◆ delta_u_thickness()

double MICROSTRIP::delta_u_thickness	(	double	u,
		double	t_h,
		double	e_r )

staticprivate

Calculates the thickness effect on normalized width.

Definition at line 308 of file common/transline_calculations/microstrip.cpp.

References M_PI.

Referenced by microstrip_Z0().

◆ delta_Z0_cover()

double MICROSTRIP::delta_Z0_cover	(	double	u,
		double	h2h )

staticprivate

Calculates the cover effect on impedance for a stripline in a homogeneous medium.

Definition at line 237 of file common/transline_calculations/microstrip.cpp.

References atanh(), and Q.

Referenced by microstrip_Z0().

◆ dielectric_losses()

double MICROSTRIP::dielectric_losses ( ) const

private

Calculates the microstrip dielectric losses per unit.

Definition at line 368 of file common/transline_calculations/microstrip.cpp.

References TRANSLINE_CALCULATIONS::C0, EPSILONR, er_eff_0, FREQUENCY, TRANSLINE_CALCULATION_BASE::GetParameter(), M_PI, and TAND.

Referenced by attenuation().

◆ dispersion()

void MICROSTRIP::dispersion ( )

private

Calculates frequency dependent parameters of the microstrip.

Definition at line 421 of file common/transline_calculations/microstrip.cpp.

References D, e_r_dispersion(), EPSILON_EFF, EPSILONR, er_eff_0, FREQUENCY, TRANSLINE_CALCULATION_BASE::GetParameter(), H, PHYS_WIDTH, TRANSLINE_CALCULATION_BASE::SetParameter(), UNIT_PROP_DELAY, TRANSLINE_CALCULATION_BASE::UnitPropagationDelay(), Z0, Z0_0, and Z0_dispersion().

Referenced by Analyse().

◆ e_r_dispersion()

double MICROSTRIP::e_r_dispersion	(	double	u,
		double	e_r,
		double	f_n )

staticprivate

Calculates the dispersion correction factor for the effective permeability.

Definition at line 327 of file common/transline_calculations/microstrip.cpp.

Referenced by dispersion().

◆ e_r_effective()

double MICROSTRIP::e_r_effective	(	double	e_r,
		double	q )

staticprivate

Calculates effective dielectric constant from material e_r and filling factor.

Definition at line 302 of file common/transline_calculations/microstrip.cpp.

Referenced by microstrip_Z0().

◆ EllipticIntegral()

std::pair< double, double > TRANSLINE_CALCULATION_BASE::EllipticIntegral ( double arg )

staticprotectedinherited

Computes the complete elliptic integral of first kind K() and the second kind E() using the arithmetic-geometric mean algorithm (AGM) by Abramowitz and Stegun.

Returns: std::pair<K, E> where K = first kind integral, E = second kind integral

Definition at line 340 of file transline_calculation_base.cpp.

Referenced by COPLANAR::Analyse(), COUPLED_STRIPLINE::calcSingleStripImpedances(), and COUPLED_STRIPLINE::calcZeroThicknessCoupledImpedances().

◆ filling_factor()

double MICROSTRIP::filling_factor	(	double	u,
		double	e_r )

staticprivate

Calculates the filling factor for a microstrip without cover and zero conductor thickness.

Definition at line 267 of file common/transline_calculations/microstrip.cpp.

Referenced by microstrip_Z0().

◆ GetAnalysisResults()

std::unordered_map< TRANSLINE_PARAMETERS, std::pair< double, TRANSLINE_STATUS > > & TRANSLINE_CALCULATION_BASE::GetAnalysisResults ( )

inherited

Gets the output parameters following analysis.

Definition at line 40 of file transline_calculation_base.cpp.

References m_analysisStatus, and SetAnalysisResults().

◆ GetDispersedEpsilonR()

double TRANSLINE_CALCULATION_BASE::GetDispersedEpsilonR ( double aF ) const

inherited

Dispersed permittivity at aF. Returns raw EPSILONR when the model is inactive.

Definition at line 200 of file transline_calculation_base.cpp.

References EPSILONR, GetParameter(), and m_dsModel.

Referenced by COAX::Analyse(), COPLANAR::Analyse(), COUPLED_MICROSTRIP::Analyse(), COUPLED_STRIPLINE::Analyse(), MICROSTRIP::Analyse(), RECTWAVEGUIDE::Analyse(), STRIPLINE::Analyse(), TWISTEDPAIR::Analyse(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), COAX::Synthesize(), and RECTWAVEGUIDE::Synthesize().

◆ GetDispersedTanDelta()

double TRANSLINE_CALCULATION_BASE::GetDispersedTanDelta ( double aF ) const

inherited

Dispersed loss tangent at aF. Returns raw TAND when the model is inactive.

Definition at line 209 of file transline_calculation_base.cpp.

References GetParameter(), m_dsModel, and TAND.

Referenced by COAX::Analyse(), COPLANAR::Analyse(), COUPLED_MICROSTRIP::Analyse(), COUPLED_STRIPLINE::Analyse(), MICROSTRIP::Analyse(), RECTWAVEGUIDE::Analyse(), STRIPLINE::Analyse(), TWISTEDPAIR::Analyse(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), and RECTWAVEGUIDE::Synthesize().

◆ GetParameter()

double TRANSLINE_CALCULATION_BASE::GetParameter ( const TRANSLINE_PARAMETERS aParam ) const

inlineinherited

Gets the given calculation property.

Definition at line 165 of file transline_calculation_base.h.

References m_parameters.

◆ GetParameterRef()

double & TRANSLINE_CALCULATION_BASE::GetParameterRef ( const TRANSLINE_PARAMETERS aParam )

inlineinherited

Adds a constant to the given parameter.

Definition at line 168 of file transline_calculation_base.h.

References m_parameters.

Referenced by MinimiseZ0Error1D().

◆ GetSoldermaskDeltaQ()

double MICROSTRIP::GetSoldermaskDeltaQ	(	double	aWOverH,
		double	aCOverH ) const

inlineoverridevirtual

Microstrip soldermask incremental filling factor.

Wan-Hoorfar 2000 improved Svacina 1992 q_2 evaluated between h_2 = h (no mask) and h_2 = h + C (mask on top of substrate). Subtracting the C = 0 baseline cancels the formula's non-zero offset at h_2 = h so the correction is continuous at the no-mask limit.

Reimplemented from TRANSLINE_CALCULATION_BASE.

Definition at line 61 of file common/transline_calculations/microstrip.h.

References TRANSLINE_CALCULATION_BASE::WanHoorfarQ2().

◆ GetSynthesisResults()

std::unordered_map< TRANSLINE_PARAMETERS, std::pair< double, TRANSLINE_STATUS > > & TRANSLINE_CALCULATION_BASE::GetSynthesisResults ( )

inherited

Gets the output parameters following synthesis.

Definition at line 48 of file transline_calculation_base.cpp.

References m_synthesisStatus, and SetSynthesisResults().

◆ GetSynthesizeTarget()

TRANSLINE_PARAMETERS TRANSLINE_CALCULATION_BASE::GetSynthesizeTarget ( ) const

inlineinherited

Returns the parameter that will be solved for during synthesis.

Definition at line 192 of file transline_calculation_base.h.

References m_synthesizeTarget.

◆ InitProperties()

void TRANSLINE_CALCULATION_BASE::InitProperties ( const std::initializer_list< TRANSLINE_PARAMETERS > & aParams )

protectedinherited

Initialises the properties used (as inputs or outputs) by the calculation.

Definition at line 32 of file transline_calculation_base.cpp.

References m_parameters.

Referenced by TRANSLINE_CALCULATION_BASE().

◆ line_angle()

void MICROSTRIP::line_angle ( )

private

Calculates microstrip length in radians.

Definition at line 460 of file common/transline_calculations/microstrip.cpp.

References ANG_L, TRANSLINE_CALCULATIONS::C0, EPSILON_EFF, FREQUENCY, TRANSLINE_CALCULATION_BASE::GetParameter(), M_PI, mur_eff, PHYS_LEN, and TRANSLINE_CALCULATION_BASE::SetParameter().

Referenced by Analyse().

◆ microstrip_Z0()

void MICROSTRIP::microstrip_Z0 ( )

private

Calculates the microstrip static impedance.

Definition at line 378 of file common/transline_calculations/microstrip.cpp.

References delta_q_cover(), delta_q_thickness(), delta_u_thickness(), delta_Z0_cover(), e_r_effective(), EPSILONR, er_eff_0, filling_factor(), TRANSLINE_CALCULATION_BASE::GetParameter(), H, H_T, PHYS_WIDTH, TRANSLINE_CALCULATION_BASE::SetParameter(), T, w_eff, Z0, Z0_0, Z0_h_1, and Z0_homogeneous().

Referenced by Analyse().

◆ MinimiseZ0Error1D()

bool TRANSLINE_CALCULATION_BASE::MinimiseZ0Error1D	(	TRANSLINE_PARAMETERS	aOptimise,
		TRANSLINE_PARAMETERS	aMeasure,
		bool	aRecalculateLength = false )

protectedinherited

minimizeZ0Error1D

Tries to find a parameter that minimizes the error on Z0. This function only works with a single parameter. Calls Analyse several times until the error is acceptable.

This function does not change Z0 / Angl_L

Parameters

aOptimise	Parameter to optimise
aMeasure	The parameter to measure / optimise against
aRecalculateLength	True if the angular length should be recalculated (not for differential pair usage)

Returns: true if error < MAX_ERROR, otherwise false

Definition at line 69 of file transline_calculation_base.cpp.

References Analyse(), ANG_L, TRANSLINE_CALCULATIONS::C0, EPSILON_EFF, FREQUENCY, GetParameter(), GetParameterRef(), m_maxError, M_PI, PHYS_LEN, and SetParameter().

Referenced by COPLANAR::Synthesize(), COUPLED_MICROSTRIP::Synthesize(), COUPLED_STRIPLINE::Synthesize(), MICROSTRIP::Synthesize(), STRIPLINE::Synthesize(), and TWISTEDPAIR::Synthesize().

◆ MinimiseZ0Error2D()

bool TRANSLINE_CALCULATION_BASE::MinimiseZ0Error2D	(	TRANSLINE_PARAMETERS	aParam1,
		TRANSLINE_PARAMETERS	aParam2 )

protectedinherited

minimizeZ0Error2D

Tries to find the parameters that minimizes the error on Z_Diff. This function only works with two parameters. Calls Analyse several times until the error is acceptable. While the error is unacceptable, changes slightly the parameter.

This function does not change Z0 / Angl_L

Parameters

aParam1	First parameter to optimise
aParam2	Secpmd parameter to optimise

Returns: true if error < MAX_ERROR, otherwise false

◆ mur_eff_ms()

void MICROSTRIP::mur_eff_ms ( )

private

Calculates the effective magnetic permeability.

Definition at line 451 of file common/transline_calculations/microstrip.cpp.

References TRANSLINE_CALCULATION_BASE::GetParameter(), H, MUR, mur_eff, and PHYS_WIDTH.

Referenced by Analyse().

◆ sech()

static double TRANSLINE_CALCULATION_BASE::sech ( const double x )

inlinestaticprotectedinherited

Calculates sech of the given argument.

Definition at line 331 of file transline_calculation_base.h.

Referenced by COUPLED_STRIPLINE::calcSingleStripImpedances().

◆ SetAnalysisResult()

void TRANSLINE_CALCULATION_BASE::SetAnalysisResult	(	TRANSLINE_PARAMETERS	aParam,
		const double	aValue,
		const TRANSLINE_STATUS	aStatus = TRANSLINE_STATUS::OK )

protectedinherited

Sets an analysis result.

Definition at line 55 of file transline_calculation_base.cpp.

References m_analysisStatus.

Referenced by COUPLED_STRIPLINE::publishResults(), COAX::SetAnalysisResults(), COPLANAR::SetAnalysisResults(), COUPLED_MICROSTRIP::SetAnalysisResults(), MICROSTRIP::SetAnalysisResults(), RECTWAVEGUIDE::SetAnalysisResults(), STRIPLINE::SetAnalysisResults(), and TWISTEDPAIR::SetAnalysisResults().

◆ SetAnalysisResults()

void MICROSTRIP::SetAnalysisResults ( )

overrideprivatevirtual

Sets the output values and status following analysis.

Implements TRANSLINE_CALCULATION_BASE.

Definition at line 122 of file common/transline_calculations/microstrip.cpp.

References ANG_L, ATTEN_COND, ATTEN_DILECTRIC, EPSILON_EFF, TRANSLINE_CALCULATION_BASE::GetParameter(), L, OK, PHYS_LEN, PHYS_WIDTH, TRANSLINE_CALCULATION_BASE::SetAnalysisResult(), SKIN_DEPTH, TS_ERROR, UNIT_PROP_DELAY, WARNING, and Z0.

◆ SetParameter()

void TRANSLINE_CALCULATION_BASE::SetParameter	(	const TRANSLINE_PARAMETERS	aParam,
		const double	aValue )

inlineinherited

Sets the given calculation property.

Definition at line 162 of file transline_calculation_base.h.

References m_parameters.

◆ SetSynthesisResult()

void TRANSLINE_CALCULATION_BASE::SetSynthesisResult	(	TRANSLINE_PARAMETERS	aParam,
		const double	aValue,
		const TRANSLINE_STATUS	aStatus = TRANSLINE_STATUS::OK )

protectedinherited

Sets a synthesis result.

Definition at line 62 of file transline_calculation_base.cpp.

References m_synthesisStatus.

Referenced by COUPLED_STRIPLINE::publishResults(), COAX::SetSynthesisResults(), COPLANAR::SetSynthesisResults(), COUPLED_MICROSTRIP::SetSynthesisResults(), MICROSTRIP::SetSynthesisResults(), RECTWAVEGUIDE::SetSynthesisResults(), STRIPLINE::SetSynthesisResults(), and TWISTEDPAIR::SetSynthesisResults().

◆ SetSynthesisResults()

void MICROSTRIP::SetSynthesisResults ( )

overrideprivatevirtual

Sets the output values and status following synthesis.

Implements TRANSLINE_CALCULATION_BASE.

Definition at line 147 of file common/transline_calculations/microstrip.cpp.

References ANG_L, ATTEN_COND, ATTEN_DILECTRIC, EPSILON_EFF, TRANSLINE_CALCULATION_BASE::GetParameter(), L, OK, PHYS_LEN, PHYS_WIDTH, TRANSLINE_CALCULATION_BASE::SetSynthesisResult(), SKIN_DEPTH, TS_ERROR, UNIT_PROP_DELAY, WARNING, and Z0.

◆ SetSynthesizeTarget()

virtual void TRANSLINE_CALCULATION_BASE::SetSynthesizeTarget ( TRANSLINE_PARAMETERS aTarget )

inlinevirtualinherited

Hint from UI picking which geometry parameter is the unknown when Synthesize is called.

Coax picks Din or Dout; coupled stripline picks W or S; rectangular waveguide picks width or height, etc. Subclasses may override to reject unsupported targets; the default implementation simply stores the value.

Reimplemented in COAX, COPLANAR, RECTWAVEGUIDE, and TWISTEDPAIR.

Definition at line 189 of file transline_calculation_base.h.

References m_synthesizeTarget.

◆ SkinDepth()

double TRANSLINE_CALCULATION_BASE::SkinDepth ( ) const

protectedinherited

Calculate skin depth.

$\frac{1}{\sqrt{ \pi \cdot f \cdot \mu \cdot \sigma }}$

Definition at line 151 of file transline_calculation_base.cpp.

References FREQUENCY, GetParameter(), M_PI, TRANSLINE_CALCULATIONS::MU0, MURC, and SIGMA.

Referenced by COAX::Analyse(), COPLANAR::Analyse(), COUPLED_STRIPLINE::Analyse(), RECTWAVEGUIDE::Analyse(), STRIPLINE::Analyse(), TWISTEDPAIR::Analyse(), COUPLED_MICROSTRIP::attenuation(), MICROSTRIP::attenuation(), and RECTWAVEGUIDE::Synthesize().

◆ Synthesize()

bool MICROSTRIP::Synthesize ( SYNTHESIZE_OPTS aOpts )

overridevirtual

Synthesis track geometry parameters to match given Z0.

Implements TRANSLINE_CALCULATION_BASE.

Definition at line 92 of file common/transline_calculations/microstrip.cpp.

References Analyse(), ANG_L, TRANSLINE_CALCULATIONS::C0, EPSILON_EFF, FREQUENCY, TRANSLINE_CALCULATION_BASE::GetParameter(), M_PI, TRANSLINE_CALCULATION_BASE::MinimiseZ0Error1D(), mur_eff, PHYS_LEN, PHYS_WIDTH, TRANSLINE_CALCULATION_BASE::SetParameter(), SynthesizeWidth(), and Z0.

Referenced by BOOST_AUTO_TEST_CASE().

◆ SynthesizeWidth()

double MICROSTRIP::SynthesizeWidth ( ) const

private

Calculates the width with the current set of parameters.

Definition at line 172 of file common/transline_calculations/microstrip.cpp.

References EPSILONR, TRANSLINE_CALCULATION_BASE::GetParameter(), H, M_PI, Z0, and TRANSLINE_CALCULATIONS::ZF0.

Referenced by Synthesize().

◆ UnitPropagationDelay()

double TRANSLINE_CALCULATION_BASE::UnitPropagationDelay ( double aEpsilonEff )

staticprotectedinherited

Calculates the unit propagation delay (ps/cm) for the given effective permittivity.

@aEpsilonEff is the effective permittivity of the material

Definition at line 160 of file transline_calculation_base.cpp.

Referenced by COPLANAR::Analyse(), STRIPLINE::Analyse(), TWISTEDPAIR::Analyse(), COUPLED_STRIPLINE::calcDielectrics(), MICROSTRIP::dispersion(), and COUPLED_MICROSTRIP::er_eff_freq().

◆ UpdateDielectricModel()

void TRANSLINE_CALCULATION_BASE::UpdateDielectricModel ( )

inherited

Refit the Djordjevic-Sarkar model from the current parameter map.

Clears the fitted model when DIELECTRIC_MODEL_SEL is CONSTANT or the spec frequency is non-positive so the accessors fall through to the raw EPSILONR / TAND values.

Definition at line 166 of file transline_calculation_base.cpp.

References DIELECTRIC_MODEL_SEL, DJORDJEVIC_SARKAR, EPSILONR, EPSILONR_SPEC_FREQ, DIELECTRIC_DJORDJEVIC_SARKAR::Fit(), GetParameter(), m_dsModel, and TAND.

Referenced by COAX::Analyse(), COPLANAR::Analyse(), COUPLED_MICROSTRIP::Analyse(), COUPLED_STRIPLINE::Analyse(), MICROSTRIP::Analyse(), RECTWAVEGUIDE::Analyse(), STRIPLINE::Analyse(), TWISTEDPAIR::Analyse(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), COAX::Synthesize(), and RECTWAVEGUIDE::Synthesize().

◆ WanHoorfarQ2()

double TRANSLINE_CALCULATION_BASE::WanHoorfarQ2	(	double	aU,
		double	aHBarTop )

staticinherited

Wan-Hoorfar 2000 eq.

(12) / (13): filling factor q_2 for the second dielectric layer of a multilayer microstrip with normalised strip width aU = w/h and normalised cumulative layer boundary aHBarTop = h_2/h (so aHBarTop = 1 corresponds to the top of the substrate and aHBarTop > 1 means a mask of thickness (aHBarTop - 1) * h sits on top). This is the corrected form valid for any number of layers, replacing Svacina's original eq (3) / (7) which is only correct for two-layer structures.

Definition at line 218 of file transline_calculation_base.cpp.

References correction, and M_PI.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), COPLANAR::GetSoldermaskDeltaQ(), COUPLED_MICROSTRIP::GetSoldermaskDeltaQ(), and MICROSTRIP::GetSoldermaskDeltaQ().