resonatorRing

Create gap-coupled ring resonator in microstrip form

Since R2022b

Description

Use the resonatorRing object to create a gap-coupled ring resonator in the microstrip form. Resonant structures such as rectangular, circular, and ring resonators are used in oscillators and filters.

Creation

Syntax

resonator = resonatorRing

resonator = resonatorRing(Name=Value)

Description

resonator = resonatorRing creates a default gap-coupled ring resonator. The default properties of the ring resonator are for a design frequency of 1 GHz.

resonator = resonatorRing(Name=Value) sets Properties using one or more name-value arguments. For example, resonatorRing(RingWidth=0.045) creates a ring resonator with a ring width of 0.045 meters. Properties not specified retain their default values

Properties

PortLineLength — Length of port line

0.0100 (default) | positive scalar

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

Example: resonator = resonatorRing(PortLineLength=0.045)

Data Types: double

PortLineWidth — Width of port line

0.0050 (default) | positive scalar

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

Example: resonator = resonatorRing(PortLineWidth=0.0061)

Data Types: double

CouplingGap — Gap between port lines and ring

0.001 (default) | positive scalar

Gap between the port lines and the ring in meters, specified as a positive scalar.

Example: resonator = resonatorRing(CouplingGap=0.002)

Data Types: double

RingRadiusOuter — Outer radius of ring

0.0100 (default) | positive scalar

Outer radius of the ring in meters, specified as a positive scalar.

Example: resonator = resonatorRing(RingRadiusOuter=0.0481)

Data Types: double

RingWidth — Width of ring

0.0051 (default) | positive scalar

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

Example: resonator = resonatorRing(RingWidth=0.0061)

Data Types: double

Height — Height of resonator from ground plane

0.0016 (default) | positive scalar

Height of the resonator 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 resonator where the two dielectrics interface.

Example: resonator = resonatorRing(Height=0.020)

Data Types: double

GroundPlaneWidth — Width of ground plane

0.0400 (default) | positive scalar

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

Example: resonator = resonatorRing(GroundPlaneWidth=0.2241)

Data Types: double

Substrate — Type of dielectric material

dielectric("Teflon") (default) | dielectric object

Type of dielectric material used as a substrate, specified as a dielectric object. The thickness of the default dielectric material Teflon is 0.0016 m or the same value as the Height property.

Example: d = dielectric("FR4"); resonator = resonatorRing(Substrate=d)

Conductor — Type of metal used in conducting layers

metal("PEC") (default) | metal object

Type of metal used in the conducting layers, specified as a metal object.

Example: m = metal("Copper"); resonator = resonatorRing(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: boolian

Shielding — Metal shielding

Read-only: 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
current	Calculate and plot current distribution
design	Design ring resonator around specified frequency
feedCurrent	Calculate current at feed port
getZ0	Calculate characteristic impedance of transmission line
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 Ring Resonator

Create a default ring resonator.

resonator = resonatorRing

resonator = 
  resonatorRing with properties:

      PortLineLength: 0.0100
       PortLineWidth: 0.0050
         CouplingGap: 1.0000e-03
     RingRadiusOuter: 0.0100
           RingWidth: 0.0040
              Height: 0.0016
    GroundPlaneWidth: 0.0400
           Substrate: [1×1 dielectric]
           Conductor: [1×1 metal]
          IsShielded: 0

Visualize the resonator.

show(resonator)

Multilayer Dielectric Ring Resonator

Create a ring resonator at the interface of a multilayer dielectric.

resonator = resonatorRing;
resonator.Substrate = dielectric(Name={'Teflon','Teflon'},EpsilonR=[2.1 2.1],...
    LossTangent=[0 0],Thickness=[0.8e-3 0.8e-3]);
resonator.Height = 0.8e-3;

Visualize the ring resonator.

show(resonator)

References

[1] Pozar, David.M. Microwave Engineering Singapore; JohnWiley and Sons. Inc, 2012.

[2] Bogner, Andreas, Carsten Steiner, Stefanie Walter, Jaroslaw Kita, Gunter Hagen, and Ralf Moos. Planar Microstrip ring resonators for Microwave-Based Gas Sensing: Design Aspects and Initial Transducers for Humidity and Ammonia Sensing.

[3] Bernard, P.A., and J.M. Gautray. “Measurement of Dielectric Constant Using a Microstrip Ring Resonator.” IEEE Transactions on Microwave Theory and Techniques 39, no. 3 (March 1991): 592–95.

Version History

Introduced in R2022b

R2023b: Metal shielding for ring resonator

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