# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English version of the page.

# sparameters

S-parameter object

## Syntax

``sobj = sparameters(antenna,freq,Z0)``
``sobj = sparameters(array,freq,Z0)``

## Description

example

````sobj = sparameters(antenna,freq,Z0)` calculates the complex s-parameters for an `antenna` object over specified frequency values and for a given reference impedance, `Z0`.```

example

````sobj = sparameters(array,freq,Z0)` calculates the complex s-parameters for an `array` object over specified frequency values and for a given reference impedance, `Z0`.```

## Examples

collapse all

Calculate the complex s-parameters for a default dipole at 70MHz frequency.

` h = dipole`
```h = dipole with properties: Length: 2 Width: 0.1000 FeedOffset: 0 Tilt: 0 TiltAxis: [1 0 0] Load: [1x1 lumpedElement] ```
` sparameters (h, 70e6)`
```ans = sparameters: S-parameters object NumPorts: 1 Frequencies: 70000000 Parameters: 0.2001 + 0.0037i Impedance: 50 rfparam(obj,i,j) returns S-parameter Sij ```

Calculate the complex s-parameters for a default rectangular array at 70MHz frequency.

```h = rectangularArray; sparameters(h,70e6)```
```ans = sparameters: S-parameters object NumPorts: 4 Frequencies: 70000000 Parameters: [4x4 double] Impedance: 50 rfparam(obj,i,j) returns S-parameter Sij ```

## Input Arguments

collapse all

Antenna object, specified as a scalar handle.

Array object, specified as a scalar handle.

S-parameter frequencies, specified as a vector of positive real numbers, sorted from smallest to largest.

Reference impedance in ohms, specified as a positive real scalar. You cannot specify `Z0` if you are importing data from a file. The argument Z0 is optional and is stored in the `Impedance` property.

When making a deep copy of an S-parameter object, this input argument is not supported. To change the reference impedance of an S-parameters object, use `newref`.

## Output Arguments

collapse all

S-parameter data, returned as a scalar handle. `disp(hs)` returns the properties of the object:

• `NumPorts` — Number of ports, specified as an integer. The function calculates this value automatically when you create the object.

• `Frequencies` — S-parameter frequencies, specified as a K-by-1 vector of positive real numbers sorted from smallest to largest. The function sets this property from the `filename` or `freq` input arguments.

• `Parameters` — S-parameter data, specified as an N-by-N-by-K array of complex numbers. The function sets this property from the `filename` or `data` input arguments.

• `Impedance` — Reference impedance in ohms, specified as a positive real scalar. The function sets this property from the `filename` or `Z0` input arguments. If no reference impedance is provided, the function uses a default value of `50`.