current
Current distribution on antenna or array surface
Syntax
Description
[___] = current(___,
specifies additional options using one or more name-value arguments.Name=Value
)
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
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
See Also
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)