Electrical N port s-parameter element
Keywords
electrical, bidirectional
Properties
General Properties
| Name | Default value | Default unit | Range |
|---|---|---|---|
|
name Defines the name of the element. |
Electrical N Port S-Parameter | - | - |
|
annotate Defines whether or not to display annotations on the schematic editor. |
true | - | [true, false] |
|
enabled Defines whether or not the element is enabled. |
true | - | [true, false] |
|
type Defines the element unique type (read only). |
Electrical N Port S-Parameter | - | - |
|
description A brief description of the elements functionality. |
Electrical N port s-parameter element | - | - |
|
prefix Defines the element name prefix. |
SPAR | - | - |
|
model Defines the element model name. |
- | - | - |
|
library Defines the element location or source in the library (custom or design kit). |
- | - | - |
|
local path Defines the local path or working folder $LOCAL for the element. |
- | - | - |
|
url An optional URL address pointing to the element online help. |
- | - | - |
Standard Properties
| Name | Default value | Default unit | Range |
|---|---|---|---|
|
s parameters A matrix editor for users to read the element current s-parameters. |
<9> [0, 0, 0,...] | - | - |
|
load from file Defines whether or not to load s-parameters from an input file or to use the currently stored s-parameters. |
false | - | [true, false] |
|
s parameters filename The file containing the s-parameters. Refer to the Implementation Details section for the format expected. |
- | - | - |
Numerical Properties
| Name | Default value | Default unit | Range |
|---|---|---|---|
|
s parameters convention Defines whether the s-parameters use 'physics' or 'engineering' convention.To convert from 'engineering' to the default 'physics' convention, the element uses the complex conjugate of the s-parameters instead. |
engineering | - | [physics, engineering |
Numerical/Digital Filter Properties
| Name | Default value | Default unit | Range |
|---|---|---|---|
|
digital filter type Defines the digital filter type used to fit the element transfer function in time domain. |
FIR | - | [single tap, FIR, IIR |
|
number of taps estimation Defines the method used to estimate the number of taps of the digital filter. |
fit tolerance | - | [disabled, fit tolerance, group delay |
|
filter fit tolerance Defines the mean square error for the fitting function. |
0.05 | - | (0, 1) |
|
filter fit number of iterations This determines the maximum number of iterations required before fitting reaches the tolerance error. |
50 | - | [1, +∞) |
|
filter fit rolloff Defines the frequency roll off for the fitting function. |
0.05 | - | [0, 1) |
|
window function Defines the window type for the digital filter. |
rectangular | - | [rectangular, hamming, hanning |
|
number of fir taps Defines the number of coefficients for digital filter. |
256 | - | [1, +∞) |
|
maximum number of fir taps Defines the number of coefficients for digital filter. |
4096 | - | [1, +∞) |
|
filter delay Defines the time delay equivalent to a number of coefficients for digital filter. |
0 | s | [0, +∞) |
|
number of iir taps Defines the number of coefficients for digital filter. |
4 | - | [2, +∞) |
|
maximum number of iir taps Defines the number of coefficients for digital filter. |
20 | - | [2, +∞) |
|
initialize filter taps Defines whether to use the initial input signal to initialize filter state values or to set them to zero values. |
false | - | [true, false] |
Diagnostic Properties
| Name | Default value | Default unit | Range |
|---|---|---|---|
|
run diagnostic Enables the frequency response of the designed filter implementation and the ideal frequency response to be generated as results. |
false | - | [true, false] |
|
diagnostic size The number of frequency points used when calculating the filter frequency response. |
1024 | - | [2, +∞) |
Results
| Name | Description |
|---|---|
| diagnostic/response #/transmission | The complex transmission vs. frequency corresponding to the ideal and designed filter. |
| diagnostic/response #/gain | The gain vs. frequency corresponding to the ideal and designed filter. |
| diagnostic/response #/error | Mean square error comparing the frequency response of the designed filter implementation with the ideal frequency response. |
====================================
Implementation Details
The file format follows the standard Touchstone file format, the following example is for a 4-port data magnitude angle file:
#magnitude angle
|S11| |S21| |S31| |S41|Real imaginary and dB angle formats are as shown below:
#Real Imaginary
Re{S11} Im{S11} Re{S21} Im{S21} Re{S12} Im{S12} Re{S22} Im{S22}
#dB Angle
20log10|S11|The option line is required at the beginning of the file to specify the format of the data in the file. The option line starts with a "#" and has the format of:
#where
= units of frequency data (options are Hz, KHz, MHz and GHz)
= type of file data
= S-parameter format (options are:
DB for dB-angle, MA for magnitude-angle, RI for real-imaginary)
= reference resistance in ohms, n is a positive numberThe example s-parameter file uses the RI format.
Other file formats such as .txt files could also be used.
Please see example files: