Public Functions for Marconi

ArrayFactor

Stores the array factor due to N isotropic radiators located at locations with phasor excitations excitations. Calling an ArrayFactor object with the arguments ϕ,θ,and frequency will return in dB the value of the AF at that location in spherical coordinates.

The base Network type for representing n-port linear networks with characteristic impedance Z0. By default, the network is stored as S-Parameters with the corresponding frequency list.

The base Network type for representing n-port linear networks with characteristic impedance Z0. The S-Parameters for an EquationNetwork are defined by a function that returns a ports-square matrix and accepts kwargs Z0 and freq. Please provide default arguments for any input parameters.

RadiationPattern

Stores a 3D antenna radiation pattern in spherical coordinates. Φ and Θ are in degrees, pattern is in dBi

    RadiationPattern(AF,ϕ,θ,freq)

Constructs a RadiationPattern from an ArrayFactor sampled in ϕ and θ at freq

    +(Pattern1,Pattern2)

Adds two patterns of equal size together. Useful for arrays

    applyAF(pattern,AF,freq)

Applys an ArrayFactor to a RadiationPattern.

cascade(net1,net2,net3,...,netN)

Returns a new DataNetwork that is the cascaded result of net1,net2,net3,...netN where the nets are a mixture of 2-Port DataNetwork objects and 2-Port EquaionNetwork object. Optionally takes kwarg numpoints for how many points in the result.

See the docs for details of dealing with equation-driven networks

cascade(net1,net2,net3,...,netN)

Returns a new DataNetwork that is the cascaded result of net1,net2,net3,...netN where the nets are 2-Port DataNetwork objects. Optionally takes kwarg numpoints for how many points in the result.

cascade(net1,net2,net3,...,netN)

Returns a new EquationNetwork that is the cascaded result of net1,net2,net3,...netN where the nets are 2-Port EquationNetwork objects.

See the docs for details of dealing with equation-driven networks

equationToDataNetwork(equationNet,args=(arg1,arg2),freqs=[1,2,3])

Utility function to convert an equation network to a data network by evaluating it at every frequency in the list or range freqs.

    generateCircularAF(N,R,ϕ,θ,freq)

Creates an ArrayFactor object from a circular array with N excitations in a circle with radius R. The excitations are phased such that the main beam is in the ϕ, θ, direction at frequency freq.

    generateRectangularAF(Nx,Ny,Spacingx,Spacingy,ϕ,θ,freq)

Creates an ArrayFactor object from a rectangular array that is Nx X Ny big with spacing Spacingx and Spacingy. The excitations are phased such that the main beam is in the ϕ, θ, direction at frequency freq.

inputZ(Zr,Θ,Z0)

Calculates the input impedance of a lossless transmission line of length θ in degrees terminated with Zr. Z0 is optional and defaults to 50.

inputZ(Γ,Z0)

Calculates the input impedace from complex reflection coefficient Γ. Z0 is optional and defaults to 50.

interpolate(network,frequencies)

Returns a new network object that contains data from network reinterpolated to fit frequencies.

    phaseLocations(Locations,ϕ,θ,freq)

Given antennas at locations Locations which is a vector of 3-Tuples of cartesian coordinates, calculate the corresponding phases to steer the beam in ϕ and θ at frequency freq

plotLStabCircle!(sc,network,freq)

Plots the the load stability circle on Smith Chart sc from network at frequency freq.

    plotPattern2D(pattern,ϕ)

Plots the 2D Radiation Pattern of pattern at the phi cut ϕ. Optionally can set the minimum and maximum gain with kwargs gainMin and gainMax.

    plotPattern3D(pattern,ϕ)

Plots the 3D Radiation Pattern of pattern. Optionally can set the minimum and maximum gain with kwargs gainMin and gainMax.

plotSStabCircle!(sc,network,freq)

Plots the the source stability circle on Smith Chart sc from network at frequency freq.

plotSmithCircle!(sc, xc, yc, rad)

Plots a cricle with center coordinates (xc,yc) on the $\Gamma$ plane with radius rad on an existing Smith Chart object.

Returns the sc object

plotSmithData!(sc, network,(1,1))

Plots the S(1,1) parameter from network on an existing Smith Chart sc

Returns the sc object

plotSmithData(network,(1,1))

Plots the S(1,1) parameter from network on a Smith Chart.

Returns a PGFPlotsX.SmithChart object.

plotVSWR!(sc,VSWR)

Plots the circle that represents a VSWR of VSWR onto an existing Smith Chart.

    readHFSSPattern("myAntenna.csv")

Reads the exported fields from HFSS into a Marconi RadiationPattern object.

readTouchstone("myFile.sNp")

Reads the contents of myFile.sNp into a Network object. This will convert all file types to S-Parameters, Real/Imaginary

Currently does not support reference lines (Different port impedances) or noise parameters

    s2t(s)

Converts S-Parameters s to T-Parameters.

    s2y(s)

Converts S-Parameters s to Y-Parameters. Optionally include reference impedance with kwarg Z0 with s2z(s,Z0=50).

    s2z(s)

Converts S-Parameters s to Z-Parameters. Optionally include reference impedance with kwarg Z0 with s2z(s,Z0=50).

    t2s(t)

Converts T-Parameters t to S-Parameters.

testDelta(network)

Returns a vector of Δ, the determinant of the scattering matrix. Optionally, returns Δ for S-Parameters at position pos.

testK(network)

Returns a vector of the magnitude of K, the Rollet stability factor.

testMAG(network)

Returns a vector of the maximum available gain of a network.

testMSG(network)

Returns a vector of the maximum stable gain of a network.

testMUG(network)

Returns a vector of the maximum unilateral gain of a network.

testMagDelta(network)

Returns a vector of |Δ|, the magnitude of the determinant of the scattering matrix. Optionally, returns |Δ| for S-Parameters at position pos.

testμ(network)

Returns a vector of the magnitude of μ, the μ stability factor[1].

Definition

The network is unconditionally stable if μ > 1, for μ defined as:

[1]: M. L. Edwards and J. H. Sinsky, "A new criterion for linear 2-port stability using a single geometrically derived parameter," in IEEE Transactions on Microwave Theory and Techniques, vol. 40, no. 12, pp. 2303-2311, Dec. 1992. doi: 10.1109/22.179894

writeTouchstone(network,filename)

Writes a Touchstone file from a Marconi network.

    y2s(y)

Converts Y-Parameters y to S-Parameters. Optionally include reference impedance with kwarg Z0 with y2s(y,Z0=50).

    y2t(y)

Converts Y-Parameters y to T-Parameters. Optionally include reference impedance with kwarg Z0 with y2s(y,Z0=50).

    y2z(y)

Converts Y-Parameters y to Z-Parameters.

    z2s(z)

Converts Z-Parameters z to S-Parameters. Optionally include reference impedance with kwarg Z0 with z2s(z,Z0=50).

    z2t(z)

Converts Z-Parameters z to T-Parameters. Optionally include reference impedance with kwarg Z0 with z2s(z,Z0=50).

    z2y(z)

Converts Z-Parameters z to Y-Parameters.

Γ(Z,Z0)

Calculates the complex reflection coefficient Γ from impedance Z. Z0 is optional and defaults to 50.

∠(mag,angle)

A nice compact way of representing phasors. Angle is in degrees.

Internal function to process touchstone lines