couplerBranchlineWideband

Create equal split multisection branchline coupler or quadrature hybrid

Since R2023a

Description

Use the couplerBranchlineWideband object to create an equal split multi-section branchline coupler or quadrature hybrid.

To analyze the behavioral model for the branchline coupler, set the Behavioral property in the sparameters function to true or 1.

Creation

Syntax

coupler = couplerBranchlineWideband

coupler = couplerBranchlineWideband(Name=Value)

Description

coupler = couplerBranchlineWideband creates an equal split multisection branchline coupler with properties for a frequency of 2.5 GHz.

coupler = couplerBranchlineWideband(Name=Value) sets Properties using one or more name-value arguments. For example, couplerBranchlineWideband(NumSections=4) creates a branch line coupler with four sections. Properties not specified retain their default values.

Properties

NumSections — Number of sections

2 (default) | positive scalar

Number of sections, specified as a positive scalar. The minimum number of sections you can specify is two and the maximum is six.

Example: coupler = couplerBranchlineWideband(NumSections=4)

Data Types: double

PortLineLength — Length of input and output line

0.0223 (default) | positive scalar

Length of the input and the output line in meters, specified as a positive scalar.

Example: coupler = couplerBranchlineWideband(PortLineLength=0.0286)

Data Types: double

PortLineWidth — Width of input and output line

0.0051 (default) | positive scalar

Width of the input and the output line in meters, specified as a positive scalar.

Example: coupler = couplerBranchlineWideband(PortLineWidth=0.0070)

Data Types: double

SeriesArmLength — Length of series arm

0.0223 (default) | positive scalar

Length of the series arm in meters, specified as a positive scalar.

Example: coupler = couplerBranchlineWideband(SeriesArmLength=0.0286)

Data Types: double

SeriesArmWidth — Width of series arm

0.0051 (default) | positive scalar | vector

Width of the series arm in meters, specified as a positive scalar or a vector.

Example: coupler = couplerBranchlineWideband(SeriesArmWidth=0.0096)

Data Types: double

ShuntArmLength — Length of shunt arm

0.0223 (default) | positive scalar

Length of the shunt arm in meters, specified as a positive scalar.

Example: coupler = couplerBranchlineWideband(ShuntArmLength=0.0286)

Data Types: double

ShuntArmWidth — Width of shunt arm

[0.00096,0.0029,0.00096] (default) | positive scalar | vector

Width of the shunt arm in meters, specified as a positive scalar or a vector.

Example: coupler = couplerBranchlineWideband(ShuntArmWidth=0.0096)

Data Types: double

Height — Height of branchline coupler from ground plane

0.0016 (default) | positive scalar

Height of the branchline coupler from the ground plane in meters, specified as a positive scalar.

In a multilayer substrate, you can use the Height property to create a branchline coupler where the two dielectrics interface.

Example: coupler = couplerBranchlineWideband(Height=0.0076)

Data Types: double

GroundPlaneWidth — Width of ground plane

0.0600 (default) | positive scalar

Width of the ground plane in meters, specified as a positive scalar.

Example: coupler = couplerBranchlineWideband(GroundPlaneWidth=0.046)

Example: double

Substrate — Type of dielectric material

dielectric object

Type of dielectric material used as a substrate, specified as a dielectric object. The default height of the substrate is 0.0016 meters. The dielectric material in a couplerBranchlineWideband object with default properties is Teflon.

Example: d = dielectric("FR4"); coupler = couplerBranchlineWideband(Substrate=d)

Conductor — Type of metal used in conducting layers

metal object

Type of metal used in the conducting layers, specified as a metal object. The metal used in the conducting layers of a couplerBranchlineWideband object with default properties is PEC.

Example: m = metal("Copper"); coupler = couplerBranchlineWideband(Conductor=m)

Data Types: string | char

IsShielded — Flag to add metal shielding

false or 0 (default) | true or 1

Flag to add a metal shielding to the PCB component, specified as a logical 0 or logical 1. The default value is logical 0.

Example: IsShielded = true or 1 add a metal shield.

Note

To enable FEM solver required for the metal shield property, download the Integro-Differential Modeling Framework for MATLAB. To download this add-on:

1. In the Home tab Environment section, click on Add-Ons. This opens the add-on explorer. You need an active internet connection to download the add-on.

2. Search for Integro-Differential Modeling Framework for MATLAB and click Install.

3. To verify if the download is successful, run

   matlab.addons.installedAddons

   in your MATLAB^® session command line.

4. On Windows, to run the IDMF add-on, you must install the Windows Subsystem for Linux (WSL). To install WSL, see Install Linux on Windows with WSL.

   The Windows Defender Firewall can block the PostgreSQL server when using the IDMF add-on. To resolve this issue, you can allow the server to communicate on desired networks if the firewall prompts. Alternatively, you can manually add the executable file of the PostgreSQL server located in <matlabroot>\sys\postgresql\win64\PostgreSQL\bin\postgres.exe. For more information, see https://support.microsoft.com/en-us/windows/risks-of-allowing-apps-through-windows-defender-firewall-654559af-3f54-3dcf-349f-71ccd90bcc5c.

Data Types: logical

Shielding — Metal shielding

shape.Box object

This property is read-only.

Metal shield for the PCB component, specified as a shape.Box object. The length and width of the box must be equal to the length and width of the ground plane. The center of the box is at [0 0 Shielding.Height].

Dependencies

To enable the Shielding property, set the IsShielded property to true or 1.

Connector — Type of RF connector

RFConnector object

Type of RF connector assembled at the feed locations of the PCB component, specified as a RFConnector object.

Example: Create connector from RFConnector object like this: coaxial = RFConnector adds a coaxial connector.

Dependencies

To enable the Connector property, set the IsShielded property to true or 1.

Object Functions

charge	Calculate and plot charge distribution
coupling	Calculate coupling factor of coupler
current	Calculate and plot current distribution
dgs	Create defected ground structure of PCB element
design	Design wideband branchline coupler around particular frequency
directivity	Calculate directivity of coupler
feedCurrent	Calculate current at feed port
isolation	Calculate isolation of coupler
layout	Plot all metal layers and board shape
mesh	Change and view mesh properties of metal or dielectric in PCB component
shapes	Extract all metal layer shapes of PCB component
show	Display PCB component structure or PCB shape
sparameters	Calculate S-parameters for RF PCB objects
RFConnector	Create RF connector

Examples

Default Wideband Branchline Coupler

Create a default wideband branchline coupler.

coupler = couplerBranchlineWideband

coupler = 
  couplerBranchlineWideband with properties:

         NumSections: 2
      PortLineLength: 0.0223
       PortLineWidth: 0.0051
     SeriesArmLength: 0.0223
      SeriesArmWidth: 0.0051
      ShuntArmLength: 0.0223
       ShuntArmWidth: [9.6000e-04 0.0029 9.6000e-04]
              Height: 0.0016
    GroundPlaneWidth: 0.0600
           Substrate: [1x1 dielectric]
           Conductor: [1x1 metal]
          IsShielded: 0

View the coupler.

show(coupler)

Two-Section Wideband Branchline Coupler

Create a default two-section wideband branchline coupler and visualize it.

coupler = couplerBranchlineWideband;
show(coupler);

Calculate the coupling at 2.5 GHz.

c = coupling(coupler,2.5e9)

c = 
-3.2275

Copyright 2022 The MathWorks, Inc.

Three-Section Wideband Branchline Coupler

Create a three-section wideband branchline coupler at the interface of a multi-layer dielectric.

coupler = couplerBranchlineWideband(NumSections=3,ShuntArmWidth=0.0051);
coupler.Substrate = dielectric(Name={'Teflon','Teflon'},EpsilonR=[2.1 2.1], ...
    LossTangent=[0 0],Thickness=[0.8e-3 0.8e-3]);
coupler.Height = 0.8e-3;

View the coupler.

show(coupler)

References

[1] Pozar, David M. Microwave Engineering. 4th ed. Hoboken, NJ: Wiley, 2012.

Version History

Introduced in R2023a

R2023b: Metal shielding for wideband branchline coupler

Use the IsShielded, Shielding, and Connector properties to add a metal shield to the couplerBranchlineWideband object.