AntennaSim in the Spotlight: A Comprehensive Review of Recent Updates in the Free, Browser‑Based Antenna Simulator
Introduction
For the modern ham, the ability to design, analyze, and fine‑tune an antenna quickly and accurately is as essential as a reliable transceiver or a good set of shack accessories. While seasoned operators still rely on hand‑crafted calculations, the last decade has seen a surge in web‑based simulation tools that bring sophisticated electromagnetic analysis to the browser. Among these, AntennaSim has carved out a niche as a fully browser‑based, open‑source solution powered by the venerable NEC2 engine.
Over the past three months, the AntennaSim project has released a series of updates that enhance usability, performance, and feature set. These changes make the tool a practical companion for hobbyists, contesters, and even educators who want to bring antenna theory to life without the overhead of commercial software. In this post we’ll dive deep into the technical, community, and regulatory dimensions of AntennaSim’s recent updates, compare it to other free and open‑source simulators, and give you practical guidance on how to weave it into your own design workflow.
1. AntennaSim at a Glance: Architecture and Core Concepts
AntennaSim is a web application that couples a user‑friendly 3‑D editor with a backend that runs the NEC2 method‑of‑moments (MoM) solver. Its architecture can be summarized as follows:
| Layer | Function | Implementation |
| ------- | ---------- | ---------------- |
| Frontend | Interactive 3‑D editor, visualization, UI controls | React, Three.js, D3, WebAssembly (NEC2 compiled to WASM) |
| Backend | Job queue, NEC2 execution, result parsing | Node.js, Redis cache, Dockerized NEC2 binary |
| Deployment | Docker stack or static GitHub Pages | Docker Compose, nginx reverse proxy, GitHub Actions CI |
1.1 Why NEC2?
NEC2 (Numerical Electromagnetics Code, version 2) is a time‑honored, open‑source MoM solver that has been the workhorse of amateur antenna design for decades. It models antennas as a series of thin wires, solves the integral equations for current distribution, and outputs far‑field patterns, input impedance, SWR, and more. By compiling NEC2 to WebAssembly, AntennaSim brings the full NEC2 pipeline to the browser, allowing you to run a complete simulation without installing any software on your machine.
1.2 Full NEC2 Pipeline
AntennaSim automates the entire NEC2 workflow:
1. Geometry Definition – Drag‑and‑drop or draw wire segments in 3‑D space.
2. Card Deck Generation – The editor automatically translates your geometry into NEC2 cards (e.g., GW, GE, EX).
3. NEC2 Execution – The solver runs either in the browser (static mode) or on the backend (Docker mode).
4. Result Parsing – The raw NEC2 output is parsed into JSON and visualized in real time.
Because the pipeline is fully automated, you can focus on the design rather than on file manipulation.
2. Update Timeline: From January to March 2024
The most recent series of updates spans roughly three months, reflecting a steady cadence of feature additions and bug fixes. The timeline below highlights the major commits and their impact:
| Date | Commit | Feature / Fix |
| ------ | -------- | --------------- |
| 2024‑01‑12 | feat: 3D radiation pattern | Real‑time 3‑D pattern rendering with interactive slicing |
| 2024‑01‑25 | feat: SWR & Smith chart | Dynamic SWR plots and Smith chart overlay |
| 2024‑02‑05 | fix: ground model selection | Corrected dielectric constant handling for custom ground |
| 2024‑02‑18 | feat: NanoVNA overlay | Overlay of simulated impedance onto NanoVNA trace |
| 2024‑03‑01 | feat: dark/light theme | Theme toggling and improved UI contrast |
| 2024‑03‑10 | refactor: WebAssembly build | Optimized WASM bundle size by 25 % |
| 2024‑03‑20 | feat: optimizer | Automatic tuning of antenna length for target frequency |
| 2024‑03‑28 | docs: updated README | Comprehensive usage guide and API reference |
Each change is accompanied by a detailed changelog entry in CHANGELOG.md. The release cycle demonstrates the project’s responsiveness to user feedback and the modularity of its codebase.
3. New Features in Detail
3.1 3‑D Radiation Patterns
Prior to the January update, AntennaSim offered only 2‑D polar plots. The new 3‑D pattern viewer uses Three.js to render the full radiation sphere, allowing operators to inspect sidelobes, nulls, and beamwidth in three dimensions. You can rotate the sphere, slice it at any elevation, and overlay multiple frequency results side‑by‑side.
Practical Tip: When designing a 20 m vertical for DX, use the 3‑D viewer to confirm that the main lobe is directed upward and that the horizontal beamwidth is narrow enough to avoid excessive radiation toward the ground. A narrow beamwidth on a vertical is a good indicator of a well‑matched, low‑loss feedline.
3.2 SWR and Smith Charts
The SWR plot now updates in real time as the geometry changes, providing immediate feedback on impedance matching. The integrated Smith chart overlay offers a visual representation of the complex impedance trajectory across frequency sweeps, helping operators identify resonant points and assess bandwidth.
Practical Tip: For contest operators, a quick visual check of the Smith chart can reveal whether your antenna will stay within the 1.5 :1 SWR limit required by many contest rules. If the curve dips below the 1.5 :1 circle at your target frequency, you’re good to go.
3.3 NanoVNA Overlay
The NanoVNA is a popular handheld vector network analyzer among amateur operators. AntennaSim’s NanoVNA overlay feature maps the simulated impedance onto a virtual NanoVNA trace, enabling a direct comparison between simulation and measurement. This alignment is invaluable when validating a design on the field or in the lab.
Equipment Recommendation: Pair the NanoVNA with a 1 m coaxial cable and a 50 Ω balun for dipole measurements. The overlay will help you spot discrepancies caused by cable loss or connector mismatch.
3.4 Dark / Light Theme
Accessibility and ergonomics are addressed through a theme toggle. The dark theme reduces eye strain during nighttime operation, while the light theme improves visibility in bright environments. The UI contrast ratios comply with WCAG 2.1 AA standards, ensuring readability for all users.
4. Performance Enhancements
4.1 WebAssembly Optimization
The March 10 refactor reduced the WASM bundle from ~1.2 MB to ~0.9 MB, cutting load times by approximately 25 %. This improvement is particularly noticeable on mobile devices and in regions with slower broadband. By leveraging the wasm-opt toolchain, the project also reduced CPU usage during simulation, enabling smoother interaction even during high‑frequency sweeps.
Practical Tip: If you’re running AntennaSim on a Raspberry Pi 4 or a low‑end laptop, the optimized WASM bundle will make the difference between a laggy experience and a responsive one.
4.2 Redis Caching
AntennaSim’s backend uses Redis to cache simulation results keyed by SHA‑256 hashes of the geometry and simulation parameters. Subsequent runs with identical inputs retrieve results instantly, dramatically reducing wait times for iterative design. This caching strategy is especially beneficial for operators who perform multiple frequency sweeps on a single design.
4.3 Ground Models and Lumped Loads
The updated ground model handling corrects the dielectric constant for custom ground settings, ensuring accurate simulation of antennas deployed on varied terrain (e.g., saltwater, rocky, or average ground). The addition of lumped load cards (series RLC, parallel RLC, fixed impedance) extends the simulator’s applicability to more complex matching networks, allowing operators to model baluns, ferrite cores, or simple resistive loads without leaving the browser.
Practical Tip: When modeling a 10 m dipole on a saltwater beach, select the “saltwater” ground model (εr ≈ 80) to capture the high conductivity of the sea. This will give you a more realistic SWR curve and radiation pattern.
5. Community Contributions and Governance
AntennaSim thrives on an active GitHub community. As of the latest release, the repository hosts over 80 commits from 30 distinct contributors. The project follows a clear contribution workflow:
1. Issue Reporting – Users submit bugs or feature requests via GitHub Issues. The maintainers triage based on impact and feasibility.
2. Pull Requests – Contributors fork the repo, make changes, and submit PRs. The CI pipeline (GitHub Actions) automatically runs unit tests and linting.
3. Code Review – Maintainers review PRs, often requesting minor adjustments before merging. The CONTRIBUTING.md file outlines coding standards and documentation expectations.
The project’s license (MIT) encourages reuse and modification, and the open‑source nature has attracted contributors from across the amateur radio spectrum, including experienced engineers, hobbyists, and academic researchers. This collaborative environment has accelerated the release cadence and ensured that AntennaSim remains aligned with operator needs.
6. Deployment Options: Docker vs. Static WebAssembly
6.1 Docker‑Based Self‑Hosted Mode
For operators or institutions requiring high‑throughput simulation or offline access, the Docker deployment offers a robust solution. The docker-compose.dev.yml file orchestrates the backend, Redis cache, and nginx reverse proxy, while the Dockerfile ensures reproducible builds. The backend can be scaled horizontally by replicating the NEC2 service, allowing multiple users to run concurrent simulations without performance degradation.
Hardware Recommendation: A modest server with 4 CPU cores and 8 GB RAM will comfortably handle 10–20 concurrent simulations. If you’re running a contest‑grade rig, consider a 16 CPU, 32 GB RAM machine for peak loads.
6.2 Static GitHub Pages (WebAssembly)
The static deployment mode is ideal for casual use or for sharing designs on a website. By building the frontend with npm run build and deploying the resulting dist/ folder to GitHub Pages, users can host AntennaSim without any server infrastructure. This mode is fully client‑side, meaning all NEC2 calculations occur in the browser, which eliminates latency but limits simulation speed on low‑end devices.
Practical Tip: If you’re a club president wanting to give members a quick way to prototype antennas, host the static site on your club’s GitHub Pages and provide a link in the club newsletter.
Both deployment modes are documented in the repository’s README, with step‑by‑step instructions and troubleshooting tips.
7. Integration with Other Tools
AntennaSim’s design files are stored in a JSON format that can be exported and imported into other NEC2‑compatible tools. The export feature generates a standard NEC2 card deck, allowing users to run the simulation in command‑line NEC2 or other GUIs such as EZNEC or MMANA. Conversely, users can import NEC2 decks by pasting them into the editor, which parses the cards and reconstructs the geometry.
This interoperability facilitates a hybrid workflow:
1. Rapid Prototyping – Use AntennaSim to sketch a design and get instant feedback.
2. Detailed Analysis – Export the deck and run a full‑scale simulation in EZNEC or OpenEMS for fine‑tuning.
3. Field Validation – Bring the design to the shack, measure with a NanoVNA, and compare the trace to the simulated overlay.
8. Practical Use Cases
8.1 Designing a 40 m QRP Dipole
An operator planning a 40 m QRP operation can use AntennaSim to:
1. Create a half‑wave dipole (≈ 3.75 m total length).
2. Run a frequency sweep from 7.0 MHz to 7.3 MHz.
3. Inspect the 3‑D radiation pattern to ensure a broad beamwidth.
4. Overlay the NanoVNA trace to confirm SWR < 1.5 :1 at the target frequency.
5. Adjust the length in real time until the resonant point aligns with 7.150 MHz.
The entire workflow completes in under a minute on a modern laptop, enabling rapid iteration.
Equipment Recommendation: Pair the dipole with a 50 Ω coaxial cable and a 1 m length of RG‑58. Use a 1 m coaxial cable to minimize loss and keep the SWR measurement accurate.
8.2 Vertical Antenna for 20 m DX
For a 20 m vertical, operators can:
1. Model a quarter‑wave vertical with a ferrite core (modeled as a lumped load).
2. Use the ground model “salt water” to simulate a coastal deployment.
3. Visualize the vertical’s 3‑D pattern to confirm a narrow beamwidth suitable for DX.
4. Export the NEC2 deck and run a detailed simulation in HFSS for final validation.
This process showcases how AntennaSim serves as an early‑stage design tool that reduces the need for costly commercial software.
8.3 Contest‑Ready Band‑Stack
Contesters often need to switch between multiple bands quickly. AntennaSim’s optimizer feature (March 20 update) automatically tunes antenna length for a target frequency. By setting the optimizer to “auto‑tune” and specifying a band (e.g., 20 m, 40 m, 80 m), the tool will adjust the wire length to bring the resonant frequency within ±0.5 % of the band center. This saves valuable contest time and reduces the risk of operating on a poorly matched antenna.
9. Comparative Landscape
| Tool | Platform | License | Core Engine | Key Strengths |
| ------ | ---------- | --------- | ------------- | --------------- |
| AntennaSim | Browser / Docker | MIT | NEC2 (WASM) | Real‑time 3‑D, SWR, NanoVNA overlay |
| EZNEC | Windows / Mac | Commercial (free demo) | NEC2 | GUI, commercial support |
| MMANA | Windows | Free | NEC2 | Batch processing, scripting |
| OpenEMS | Desktop | GPL | FDTD | Full 3‑D EM, complex geometries |
| Qucs | Desktop | GPL | Various | Circuit + antenna simulation |
AntennaSim distinguishes itself by offering a browser‑based experience with real‑time visualization and zero‑server static deployment. While tools like EZNEC provide a polished GUI, they require licensing and are limited to desktop platforms. OpenEMS and Qucs deliver more advanced EM capabilities but involve steeper learning curves and higher computational demands. For many operators, AntennaSim offers the sweet spot between accessibility and functionality.
10. Regulatory and Licensing Considerations
The MIT license under which AntennaSim is released allows unrestricted use, modification, and redistribution, provided the license text is retained. This permissiveness makes the tool suitable for integration into contest software or educational curricula without legal entanglements.
From a regulatory standpoint, the simulator itself does not interfere with FCC or ITU regulations. However, operators should be mindful that simulation results may not fully capture real‑world propagation effects or antenna mis‑alignments. The FCC’s Part 88 rules governing amateur radio stations do not impose restrictions on the use of simulation software, but operators must still ensure that any deployed antenna complies with local zoning, safety, and licensing requirements.
Practical Tip: When designing an antenna that will be installed on a tower or a building, check your local building codes and obtain any necessary permits. Even a well‑simulated antenna can violate structural or safety regulations if not properly installed.
11. Future Roadmap and Community Input
The AntennaSim maintainers have outlined several forthcoming features:
1. Higher‑Frequency Support – Extending the NEC2 engine to handle frequencies up to 6 GHz for HF‑satellite and VHF/UHF applications.
2. 3‑D CAD Integration – Allowing import of STL or DXF files to generate wire geometries automatically.
3. Batch Simulation – Enabling users to submit multiple designs for parallel processing on the backend.
4. Enhanced Matching Network Library – Pre‑built balun, tuner, and matching network templates.
Community feedback has already spurred the addition of a “ground model picker” and the NanoVNA overlay. The maintainers encourage users to contribute by filing issues, submitting PRs, or participating in the project’s Discord channel.
12. Conclusion
Over the past few months, AntennaSim has evolved from a basic web‑based NEC2 wrapper into a feature‑rich, high‑performance antenna design platform. The integration of real‑time 3‑D radiation patterns, SWR and Smith chart visualization, and NanoVNA overlays transforms the tool from a simple simulator into a comprehensive design companion. Its dual deployment model—Docker for scalable, self‑hosted use and static WebAssembly for zero‑server accessibility—caters to a wide spectrum of operators, from contesters who need rapid iteration to educators who wish to embed the tool in classroom labs.
By positioning itself within the broader ecosystem of open‑source simulators, AntennaSim offers a compelling alternative to commercial software, lowering the barrier to entry for advanced antenna design. The project’s active community, clear governance, and responsive development cycle ensure that it will continue to adapt to the evolving needs of the amateur radio community.
For operators looking to streamline their antenna design workflow, AntennaSim represents a powerful, free, and browser‑based solution that bridges the gap between theory and practice. As the project matures, its impact on the hobby is likely to grow, empowering more operators to experiment, learn, and ultimately improve the quality of their QSO experiences.