current

Current distribution on antenna or array surface

Syntax

current(object,frequency)

i = current(object,frequency)

[i,p] = current(object,frequency)

current(object,frequency,"dielectric")

[___] = current(object,frequency,"dielectric")

[___] = current(___,Name=Value)

Description

current(object,frequency) calculates and plots the absolute value of the current on the surface of the specified antenna or array object at the specified frequency.

i = current(object,frequency) returns the components of the antenna or array surface current at the specified frequency in a Cartesian coordinate system.

[i,p] = current(object,frequency) also returns the point at which the function performs the current calculation.

current(object,frequency,"dielectric") calculates and plots the absolute value of the current at the specified frequency on the dielectric face of the antenna or array.

[___] = current(object,frequency,"dielectric") returns the components of the current on the dielectric surface of the antenna or array at the specified frequency in a Cartesian coordinate system.

[___] = current(___,Name=Value) specifies additional options using one or more name-value arguments.

Examples

Calculate and Plot Current Distribution on Antenna Surface

Calculate and plot the current distribution for a circular loop antenna at 70MHz frequency.

 h = loopCircular;
 current(h,70e6);

Calculate Current Distribution of Array

Calculate the current distribution of a default rectangular array at 70MHz frequency.

h = rectangularArray;
i = current(h,70e6)

i = 3×160 complex

   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i   0.0000 + 0.0000i
   0.0010 + 0.0021i  -0.0010 - 0.0021i   0.0008 + 0.0019i  -0.0004 - 0.0014i  -0.0021 - 0.0036i   0.0031 + 0.0052i  -0.0008 - 0.0018i  -0.0017 - 0.0030i   0.0016 + 0.0029i  -0.0001 - 0.0013i   0.0001 + 0.0028i  -0.0015 - 0.0027i   0.0015 + 0.0028i  -0.0014 - 0.0025i   0.0013 + 0.0026i  -0.0012 - 0.0023i   0.0012 + 0.0023i   0.0003 + 0.0013i  -0.0005 - 0.0016i   0.0006 + 0.0016i  -0.0011 - 0.0023i   0.0012 + 0.0023i  -0.0013 - 0.0025i   0.0017 + 0.0030i   0.0001 + 0.0013i  -0.0001 - 0.0028i   0.0014 + 0.0025i   0.0004 + 0.0014i  -0.0003 - 0.0013i   0.0021 + 0.0035i  -0.0031 - 0.0052i   0.0006 + 0.0016i  -0.0005 - 0.0016i   0.0008 + 0.0019i  -0.0007 - 0.0018i   0.0010 + 0.0021i  -0.0009 - 0.0021i  -0.0017 - 0.0030i   0.0016 + 0.0028i  -0.0015 - 0.0028i   0.0010 + 0.0021i  -0.0009 - 0.0021i   0.0008 + 0.0019i  -0.0004 - 0.0014i  -0.0020 - 0.0036i   0.0031 + 0.0052i  -0.0007 - 0.0018i  -0.0017 - 0.0030i   0.0017 + 0.0029i  -0.0001 - 0.0013i
   0.0509 + 0.0922i   0.0549 + 0.1005i   0.0566 + 0.1044i   0.0643 + 0.1245i   0.0134 + 0.0228i   0.0031 + 0.0052i   0.0597 + 0.1118i   0.0239 + 0.0412i   0.0172 + 0.0293i   0.0661 + 0.1324i   0.0666 + 0.1406i   0.0333 + 0.0581i   0.0272 + 0.0470i   0.0416 + 0.0736i   0.0362 + 0.0634i   0.0488 + 0.0878i   0.0441 + 0.0785i   0.0656 + 0.1298i   0.0633 + 0.1215i   0.0611 + 0.1152i   0.0488 + 0.0879i   0.0441 + 0.0786i   0.0416 + 0.0737i   0.0239 + 0.0413i   0.0661 + 0.1324i   0.0666 + 0.1406i   0.0362 + 0.0636i   0.0643 + 0.1245i   0.0657 + 0.1298i   0.0134 + 0.0228i   0.0031 + 0.0052i   0.0611 + 0.1153i   0.0634 + 0.1216i   0.0567 + 0.1045i   0.0598 + 0.1119i   0.0510 + 0.0923i   0.0549 + 0.1006i   0.0172 + 0.0293i   0.0272 + 0.0471i   0.0334 + 0.0582i   0.0509 + 0.0922i   0.0548 + 0.1005i   0.0566 + 0.1044i   0.0642 + 0.1244i   0.0134 + 0.0228i   0.0031 + 0.0052i   0.0597 + 0.1117i   0.0239 + 0.0412i   0.0172 + 0.0293i   0.0661 + 0.1324i

Current Distribution on Microstrip Patch Antenna

Create a microstrip patch antenna with a FR4 dielectric substrate.

d = dielectric("FR4");
pm = patchMicrostrip(Length=75e-3,Width=37e-3,...
        GroundPlaneLength=120e-3,GroundPlaneWidth=120e-3,...
        Substrate=d)

pm = 
  patchMicrostrip with properties:

               Length: 0.0750
                Width: 0.0370
               Height: 0.0060
            Substrate: [1x1 dielectric]
    GroundPlaneLength: 0.1200
     GroundPlaneWidth: 0.1200
    PatchCenterOffset: [0 0]
           FeedOffset: [-0.0187 0]
            Conductor: [1x1 metal]
                 Tilt: 0
             TiltAxis: [1 0 0]
                 Load: [1x1 lumpedElement]

show(pm)

Plot the current distribution on the antenna at a frequency of 1.67 GHz.

figure
current(pm,1.67e9,"dielectric")

Logarithmic Current Distribution on Antenna Surface

Create a default pifa (planar inverted F antenna).

ant = pifa;

Visualize the current distribution on the pifa antenna using log function scale.

current(ant,1.75e9,Scale="log")

View Sliced Current Distribution Plot of Antenna

Create Minkowski's island fractal antenna with an FR4 dielectric substrate. Plot the current distribution of the antenna at 1 GHz with the Slicer argument set to "on".

ant = fractalIsland(Substrate=dielectric("FR4"));
show(ant)

current(ant,1e9,Slicer="on",Scale="log10")

Select Enable slicer Mode. Then select a plane for the slice under Orientation.

Click on the plot and select a region to hide.

Click Hide Selected Region to view the desired slice.

Input Arguments

object — Antenna or array

antenna object | array object | custom antenna object | custom array object | pcbStack object | installedAntenna object | planeWaveExcitation object

Antenna or array to calculate the current distribution, specified as either of these objects:

• antenna catalog element

• array catalog element

• customAntennaMesh

• customArrayMesh

• customAntennaGeometry

• customArrayGeometry

• customAntennaStl

• customAntenna

• pcbStack

• installedAntenna

• planeWaveExcitation

Example: dipole

Example: linearArray(Element=dipole)

frequency — Frequency used to calculate current distribution

scalar in Hz

Frequency to calculate current distribution, specified as a scalar in Hz.

Example: 70e6

Data Types: double

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: Scale="log10"

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'Scale','log10'

Region — Layer to plot current distribution

"metal" (default) | "dielectric"

Layer to plot the current distribution, specified as either "metal" or "dielectric". Use this argument to choose between metal and dielectric layers and plot the current distribution at the chosen layer.

Example: "dielectric"

Data Types: string

Scale — Scale to visualize current distribution

"linear" (default) | "log" | "log10"

Scale of the current distribution plot to visualize the current distribution on the surface of the antenna, specified as a string or a logarithmic function. The default scale is "linear".

Example: "log10"

Data Types: string | function

Slicer — Option to enable or disable plot interactivity

0 (default) | 1 | false | true | "off" | "on"

Option to enable or disable plot interactivity, specified as "on" or "off", or as numeric or logical 1(true) or 0(false). Set this argument to 1 or "on" to open the plot with the slicer panel, and to slice and view the desired cross section of the plot along the xy-, yz-, and xz- planes. Set this argument to 0 or "off" to open the plot without the slicer panel.

Example: "on"

Example: 1

Example: true

Data Types: string | logical

Type — Type of current distribution plot

"absolute" (default) | "real" | "imaginary"

Type of the current distribution plot, specified as "absolute", "real", or "imaginary". The default type is "absolute". Use this name-value argument to choose between absolute, real, and imaginary values of the current against which to plot the current distribution.

Example: "imaginary"

Data Types: string

Direction — Option to display direction of current vector

"off" (default) | "on"

Option to display the direction of the current vector, specified as "on" or "off". To display the direction of the current vector on the current distribution plot, specify this argument as "on". Otherwise, specify this argument as "off".

Example: "on"

Data Types: string

Output Arguments

i — Components of current distribution in Cartesian coordinate system

3-by-n complex matrix in A/m

x, y, z components of the current distribution, returned as a 3-by-n complex matrix in A/m. The value of the current is calculated on every triangle mesh or every dielectric tetrahedron face on the surface of an antenna or array.

p — Cartesian coordinates representing center of each triangle in mesh

3-by-n real matrix

Cartesian coordinates representing the center of each triangle in the mesh, returned as a 3-by-n real matrix.

Version History

Introduced in R2015a