couplerDirectional

Create single section or multi-section directional coupler in microstrip form

Since R2022b

Description

Use the couplerDirectional object to create a single section or a multi-section coupler in the microstrip form.

Creation

Syntax

coupler = couplerDirectional

coupler = couplerDirectional(Name=Value)

Description

coupler = couplerDirectional creates a single section coupler in the microstrip form with default property values for a resonating frequency of 1 GHz for a 21 dB coupling.

coupler = couplerDirectional(Name=Value) sets Properties using one or more name-value arguments. For example, couplerDirectional(PortLineWidth=0.0286) creates a directional coupler with a port line width of 0.0286 meters. Properties not specified retain their default values.

Properties

Length — Length of coupled line in each section

0.0397 (default) | positive scalar

Length of the coupled line in each section, specified as a positive scalar.

Example: coupler = couplerDirectional(Length=0.0096)

Data Types: double

Width — Width of coupled line in each section

0.0028 (default) | positive scalar | vector

Width of the coupled line in each section, specified as a positive scalar or vector.

Example: coupler = couplerDirectional(Width=0.0036)

Data Types: double

Spacing — Spacing between coupled lines in each section

0.0013 (default) | positive scalar | vector

Spacing between the coupled lines in each section, specified as a positive scalar or vector.

Example: coupler = couplerDirectional(Spacing=0.0016)

Data Types: double

NumSections — Number of coupled line sections

1 (default) | positive scalar

Number of coupled line sections, specified as a positive scalar. To create a multi-section directional coupler, the number of sections must be greater than one.

Example: coupler = couplerDirectional(NumSections=2)

Data Types: double

Corner — Bend type at corners of coupler

'Mitered' (default) | 'Curved' | 'RightAngle'

Bend type at the corners of the coupler for extending the ports, specified as 'Mitered', 'Curved', or 'RightAngle'.

Example: coupler = couplerDirectional(Corner='Curved')

Data Types: char

Height — Height of directional coupler from ground plane

0.0016 (default) | positive scalar

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

In the case of a multilayer substrate, you can use the Height property to create a branch line coupler line where the two dielectrics interface.

Example: coupler = couplerDirectional(Height=0.0026)

Data Types: double

PortLineWidth — Width of port line

0.0029 (default) | positive scalar

Width of the port line in meters, specified as a positive scalar.

Example: coupler = couplerDirectional(PortLineWidth=0.0070)

Data Types: double

GroundPlaneLength — Length of ground plane

0.0697 (default) | positive scalar

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

Example: coupler = couplerDirectional(GroundPlaneLength=0.046)

Example: double

GroundPlaneWidth — Width of ground plane

0.0345 (default) | positive scalar

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

Example: coupler = couplerDirectional(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.

Example: d = dielectric("FR4"); coupler = couplerDirectional(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 type of metal in a couplerBranchline object with default properties is Copper.

Example: m = metal("PEC"); coupler = couplerDirectional(Conductor=m)

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
directivity	Calculate directivity of coupler
feedCurrent	Calculate current at feed port
getZ0	Calculate characteristic impedance of transmission line
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 Coupler Directional

Create a default directional coupler.

coupler = couplerDirectional

coupler = 
  couplerDirectional with properties:

               Length: 0.0397
                Width: 0.0028
              Spacing: 0.0013
          NumSections: 1
               Corner: 'Mitered'
               Height: 0.0016
        PortLineWidth: 0.0029
    GroundPlaneLength: 0.0697
     GroundPlaneWidth: 0.0345
            Substrate: [1x1 dielectric]
            Conductor: [1x1 metal]
           IsShielded: 0

View the coupler.

show(coupler)

Three-Section Symmetrical Directional Coupler

Create a three-section symmetrical directional coupler on a Teflon substrate.

 coupler = couplerDirectional(Length=18.15e-3, Width=[4.942e-3,...
    4.813e-3,4.942e-3],Spacing=[10.95e-3,1.295e-3,10.95e-3],...
    NumSections=3 ,Substrate=dielectric(EpsilonR=2.2,LossTangent=0.005,...
    Thickness=0.0016),PortLineWidth=4.942e-3,...
    GroundPlaneLength=75.5e-3,GroundPlaneWidth=50e-3 )

coupler = 
  couplerDirectional with properties:

               Length: 0.0181
                Width: [0.0049 0.0048 0.0049]
              Spacing: [0.0109 0.0013 0.0109]
          NumSections: 3
               Corner: 'Mitered'
               Height: 0.0016
        PortLineWidth: 0.0049
    GroundPlaneLength: 0.0755
     GroundPlaneWidth: 0.0500
            Substrate: [1x1 dielectric]
            Conductor: [1x1 metal]
           IsShielded: 0

View the coupler.

show(coupler)

References

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

Version History

Introduced in R2022b

R2023b: Metal shielding for directional coupler

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