matlab-analyze-antenna-structures
GitHub使用MATLAB Antenna Toolbox设计分析大型天线结构,包括反射面、RIS及平台安装天线和RCS计算。适用于需要特定电磁求解器、网格控制和GPU加速的复杂天线场景。
Trigger Scenarios
Install
npx skills add matlab/matlab-agentic-toolkit --skill matlab-analyze-antenna-structures -g -y
SKILL.md
Frontmatter
{
"name": "matlab-analyze-antenna-structures",
"license": "https:\/\/www.mathworks.com\/content\/dam\/mathworks\/license\/pmrl\/license.md",
"metadata": {
"author": "MathWorks",
"version": "1.0"
},
"description": "Design and analyze electrically large antenna structures using MATLAB Antenna Toolbox. Covers reflector antennas (parabolic, Cassegrain, Gregorian, offset, corner, cylindrical, spherical, custom STL), reflectarrays and reconfigurable intelligent surfaces (RIS), antennas installed on platforms (vehicles, aircraft, ships, satellites), and radar cross section (RCS) analysis. Includes solver selection (MoM-PO, PO, MoM, FMM), mesh control, and GPU acceleration. Use when the user wants to design a dish\/reflector antenna, reflectarray, analyze an antenna on a platform, or compute RCS.\n"
}
Antenna Structure Design and Analysis
Design, analyze, and visualize electrically large antenna structures — reflector antennas, reflectarrays/RIS, platform-installed antennas, and radar cross section — using MATLAB Antenna Toolbox with appropriate EM solvers for each problem class.
When to Use
Reflector antennas
- Design a parabolic dish, satellite dish, or prime-focus reflector
- Design a Cassegrain or Gregorian dual-reflector system
- Design an offset-fed reflector (no blockage)
- Design a corner reflector, cylindrical or spherical reflector
- Use reflectorCalculator for trade studies
- Import custom reflector geometry from STL files
Reflectarrays and RIS
- Design a reflectarray antenna with unit cell phase control
- Design a reconfigurable intelligent surface (RIS) with quantized phases
- Characterize unit cell reflection phase (S-curve)
- Synthesize an aperture phase distribution for beam steering
- Verify pattern via pattern multiplication
Installed antennas on platforms
- Mount an antenna on a vehicle, aircraft, ship, satellite, or large structure
- Analyze installed antenna patterns, coupling, or efficiency
- Load platform geometry from STL/STEP/IGES files
- Generate platform geometry programmatically
Radar cross section
- Compute monostatic or bistatic RCS
- Analyze RCS of a platform, antenna, or array
- Compare RCS across polarizations (HH, VV, HV, VH)
- Compute RCS of a dielectric target
When NOT to Use
- Designing standalone antenna elements or arrays (no platform) — use
matlab-design-antenna - Optimizing antenna dimensions with SADEA/TR-SADEA — use
matlab-design-antenna - Impedance matching, measured antenna objects, RF propagation, or SAR — use
matlab-integrate-antenna - A flat
reflectorbacking a dipole — usematlab-design-antenna(catalog element)
Must-Follow Rules
Reflectors
- Set Exciter BEFORE design() —
design(obj, freq)takes two arguments only for reflectors cavityis NOT a valid exciter — it will errorreflectorCornerandreflectorCylindricalhave noSolverTypeproperty — always MoM- Array as exciter: design the array first, assign to Exciter, do NOT call design() on reflector afterward
Reflectarrays
infiniteArrayonly supports pcbStack with exactly 3 layers (metal-dielectric-metal)- Set
BoardThicknessbeforeLayerson pcbStack — order matters - Feed offset: Use
[Lp/4, 0, 1, 3]— not[0 0 1 3] - Always unwrap phase with
unwrap()and normalize magnitude (peak = 1) - Pattern multiplication adds dB — element pattern (dB) + array factor (dB), NOT linear multiplication
Installed Antennas
installedAntennaonly supports pure metal antennas — no dielectric substrates- Platform
Unitsmust be explicit — defaults to "mm" but ElementPosition is always in meters - Set
ElementPositionbeforeElementfor multi-element setups - Always mesh explicitly before analysis — uncontrolled density causes inaccurate results
RCS
- One of azimuth or elevation must be scalar for monostatic sweeps
- Dielectric targets require FMM solver — PO and MoM will error
UseFileAsMesh = truerequired for dielectric .mat files- PO fails at grazing incidence — returns artificially low values (~-250 dBsm)
Solver Selection (All Workflows)
- Default: MoM-PO for installed/reflectors, PO for RCS
- Use FMM for: closed bodies, concave features, dielectric targets
- Verify FMM convergence with
solver()thenconvergence()after analysis - Mesh density: lambda/10 for MoM/FMM, lambda/6 for MoM-PO, default for PO
Workflow
1. Reflector Antenna Design
- Parse — Identify reflector type, frequency, exciter, f/D ratio, constraints
- Create — Set exciter first (if non-default), then call
design(obj, freq) - Customize — Adjust Radius, FocalLength, FeedOffset for custom f/D
- Analyze — Pattern, gain, beamwidth, impedance
- Report — Key metrics with units, f/D ratio, aperture in wavelengths
For trade studies, use reflectorCalculator first (instant), then createAntenna for full-wave.
2. Reflectarray / RIS Design
- Design unit cell — Parameterized
pcbStack(3 layers) with variable patch size - Characterize S-curve — Sweep patch size via
planeWaveExcitation+infiniteArray+EHfields - Synthesize aperture phase — Compute required phase (path delay + beam steering gradient)
- Map phase to geometry — Invert S-curve via interpolation; quantize for RIS
- Build geometry —
conformalArraywith unique elements at each position - Verify pattern — Element pattern + array factor via
patternCustom
3. Installed Antenna Analysis
- Create platform — Load from STL/STEP/IGES or generate programmatically
- Install element(s) — Set Platform, ElementPosition, Element, SolverType
- Mesh —
mesh(ant, MaxEdgeLength=lambda/N)per solver guidelines - Analyze — Pattern, impedance, S-parameters (coupling), efficiency
- Report — Metrics with units; verify FMM convergence if used
4. RCS Analysis
- Create target — Load platform from file or use antenna/array object directly
- Select solver — PO (default, fast), MoM (small, accurate), FMM (dielectric/concave)
- Compute —
rcs(obj, freq, az, el, Polarization=..., Solver=...) - Report — Peak RCS (dBsm), angular location, polarization
Key Classes
| Class | Purpose |
|---|---|
reflectorParabolic |
Prime-focus parabolic dish |
cassegrain / gregorian |
Symmetric dual-reflector systems |
cassegrainOffset / gregorianOffset |
Offset dual-reflector (no blockage) |
reflectorCorner |
Corner reflector (90/60/45 deg) |
reflectorCylindrical / reflectorSpherical |
Fan-beam / wide-scan reflectors |
customDualReflectors |
Custom STL reflector surfaces |
reflectorCalculator |
Gaussian-beam analytical design (R2026a) |
installedAntenna |
Antenna mounted on conducting platform |
platform |
3D geometry loader (STL/STEP/IGES) |
infiniteArray |
Periodic boundary conditions for unit cells |
planeWaveExcitation |
Plane wave illumination for S-curve/RCS |
conformalArray |
Arbitrary element positions (reflectarray geometry) |
pcbStack |
Unit cell structure (3-layer for reflectarrays) |
rcs |
Radar cross section function |
Conventions
Coding Standards
- 4-space indentation, lowerCamelCase variables, UpperCamelCase Name-Value args
"double quotes"for strings,fprintffor formatted output- Do not add titles to Antenna Toolbox plots (
show,pattern,rcsauto-plot) - Do add titles to manual
plot,imagesc,subplot, andTitleToptopolarpattern - Show all plots in separate figures. Include units in all output.
Script-First Workflow
For design, analysis, or sweep tasks — write code to .m files, run via run_matlab_file, iterate by editing and re-running. Use inline evaluate_matlab_code for quick one-off checks.
References
| Load when... | Reference |
|---|---|
| Designing any reflector antenna (parabolic, dual, corner, custom STL) | references/reflector-antennas.md |
| Designing a reflectarray or RIS (unit cells, S-curve, phase synthesis) | references/reflectarrays.md |
| Installing antennas on platforms (STL loading, multi-element, conformalArray workaround) | references/installed-antennas.md |
| Computing monostatic/bistatic RCS (polarization, dielectric targets, GPU) | references/rcs-analysis.md |
| Choosing between MoM-PO, PO, MoM, FMM for any application | references/solver-selection.md |
Copyright 2026 The MathWorks, Inc.
Version History
- 2026.08.13 Current 2026-08-16 07:20


