Skip to content

Home

Jump to bottom
L. Linkous edited this page Nov 6, 2024 · 40 revisions

Welcome to the AntennaCAT wiki!

What's New?

We're getting ready for the first code release! AntennaCAT V2024.0 will be posted to the main GitHub soon.

Before that, however, we're releasing documentation on how to get started, set up, and use AntennaCAT

Current AntennaCAT Version: 2024.0

Latest Documentation Update:

---

Table of Contents

What is AntennaCAT?

Past Releases

AntennaCAT has appeared in several publications during its development, however it was not publicly available until V2024.0. Some features have been replaced, or removed, during the development process. The first table below summarizes the development of AntennaCAT as it was published in early literature. Table 2 summarizes the major updates (including the staggered release) as the code has become public.

Table 1: A Summary of AntennaCAT Features from Early Publication + Collaborative Repos

Year Publication Reference Major Features
2022 Early work. Ansys HFSS scripting for automating the parameter sweep of rectangular patch antennas in a Python UI. The template fill -> script generate -> Ansys HFSS simulation -> report export -> data process -> template fill.... loop works for ONLY the patch antenna. All simulation plot options are integrated for S parameters.
Aug. 2022 "Have a SDR? - Design and make your own antennas" Dollarhyde's AntennaCalculator presented at DEF CON 30 RF Village
Jan. 2023 "Automated Antenna Calculation, Design and Tuning Tool for HFSS" First public mention of AntennaCAT in literature:
  • Ansys HFSS only automation, DIY integration
  • GUI interface
  • Integrated Antenna Calculator. Expands AntennaCAT from just Rectangular Patch parameter sweep
  • Batch data collection, report generation
  • Loading in existing scripts, automated parameter detection
  • Early ML attempts: SVM, Rule-Engine on the 3 topologies
Jan. 2023 "Generalized Machine-Learning Particle Swarm Optimization Antennas for CBRS" Demonstrated a binary grid-based genetic algorithm using an early version of an AntennaCAT branch called "GeneticCAT". This branch is not integrated into recent updates, but will likely be re-integrated after core features are released
June. 2023 "Patch Antenna Calculations and Fabrication Made Simple for Cyber Security Research" first educational conference publication of the Antenna Calculator
July 2023 "AntennaCAT: Automated Antenna Design and Tuning Tool"
  • Multi-EM simulation software unit testing started
  • binary grid-based genetic algorithm in official IEEE print
  • ML work: neural networks, Bayesian framework, fuzzy logic controller testing. rule-engines are being used, but they're highly restrictive. Looking for alternatives.
Jan. 2024 "Machine Learning Assisted Optimization Methods for Automated Antenna Design" Data mining the 60,000+ rectangular patch antenna parameter sweep data collection to create rule-engines, explore SVM, and work towards an on-line fuzzy logic controller. Features a repository with tutorials at 2024-URSI-NRSM-1265
July 2024 "Machine Learning Assisted Hyperparameter Tuning for Optimization"
  • First shift over to PSO as an optimizer.
  • Focusing on exploring regression-based machine learning model
  • Presentation was the first mention of the 12 optimizers being integrated into AntennaCAT and the focus to offline training for initial hyperparameter values based on known problem dimensionality

Table 2: A Summary of Features from Major Code Releases

Version Documentation Reference Major Features

Getting Started

I'm a Professional at GitHub and Everything Python

(same tutorial just further down the page)

I'm New at This or Need a Refresher

Where Can I Find More Information?

Documentation

Guides and Tutorials

Blog Pages

Video Tutorials and Examples

Publications and Related Projects

Dissertation

This is the 2024 dissertation with documented work and current progress of AntennaCAT:

[1] L. Linkous, “Machine Learning Assisted Optimization for Calculation and Automated Tuning of Antennas,” VCU Scholars Compass, 2024. https://scholarscompass.vcu.edu/etd/7841/ (accessed Oct. 21, 2024).

Other Publications

AntennaCAT first appeared in these conference papers:

[2] L. Linkous, E. Karincic, J. Lundquist and E. Topsakal, "Automated Antenna Calculation, Design and Tuning Tool for HFSS," 2023 United States National Committee of URSI National Radio Science Meeting (USNC-URSI NRSM), Boulder, CO, USA, 2023, pp. 229-230, doi: 10.23919/USNC-URSINRSM57470.2023.10043119. [Online:] https://ieeexplore.ieee.org/abstract/document/10043119

[3] E. Karincic, L. Linkous, and E. Topsakal , "Generalized Machine-Learning Particle Swarm Optimization Antennas for CBRS," 2023 United States National Committee of URSI National Radio Science Meeting (USNC-URSI NRSM), Boulder, CO, USA, 2023 https://www.usnc-ursi-archive.org/nrsm/2023/papers/1065.pdf. 1-page, non-indexed but presented.

[4] L. Linkous, J. Lundquist and E. Topsakal, "AntennaCAT: Automated Antenna Design and Tuning Tool," 2023 IEEE USNC-URSI Radio Science Meeting (Joint with AP-S Symposium), Portland, OR, USA, 2023, pp. 89-90, doi: 10.23919/USNC-URSI54200.2023.10289238. [Online:] https://ieeexplore.ieee.org/abstract/document/10289238

The following papers were part of the data collection and ML work that went into what would become the Hyperparamter Prediction Network & Dictionary:

[5] L. Linkous and E. Topsakal, "Machine Learning Assisted Optimization Methods for Automated Antenna Design," 2024 United States National Committee of URSI National Radio Science Meeting (USNC-URSI NRSM), Boulder, CO, USA, 2024, pp. 377-378, doi: 10.23919/USNC-URSINRSM60317.2024.10464597. [Online:] https://ieeexplore.ieee.org/abstract/document/10464597

[6] L. Linkous, J. Lundquist, M. Suche and E. Topsakal, "Machine Learning Assisted Hyperparameter Tuning for Optimization," 2024 IEEE INC-USNC-URSI Radio Science Meeting (Joint with AP-S Symposium), Florence, Italy, 2024, pp. 107-108, doi: 10.23919/INC-USNC-URSI61303.2024.10632482. [Online:] https://ieeexplore.ieee.org/abstract/document/10632482

The Antenna Calculator was first debuted at DEF CON 30, and then as an ASEE-presented teaching tool:

[7] "DEF CON 30 RF Village - Erwin Karincic - Have a SDR? - Design and make your own antennas" PDF link, and Dollarhyde's AntennaCalculator

[8] E. Karincic, E. Topsakal, and L. Linkous. "Patch Antenna Calculations and Fabrication Made Simple for Cyber Security Research," 2023 ASEE Annual Conference & Exposition, Baltimore , Maryland, 2023, June. ASEE Conferences, 2023. [Online:] https://peer.asee.org/43974

Supporting Repositories

Base Optimizer Alternate Version Quantum-Inspired Optimizer Surrogate Model Version
pso_python pso_basic pso_quantum
cat_swarm_python sand_cat_python cat_swarm_quantum
chicken_swarm_python - chicken_swarm_quantum
sweep_python *alternates in base repo - -
bayesian optimization_python - - *interchangeable surrogate models
included in base repo
multi_glods_python - -

The Objective Function Test Suite is now public. A subset of these functions were used to collect data on optimizer performance.

The stand-alone CLI Antenna Calculator repository by Dollarhyde.

Navigation

Home

Documentation

Guides-and-Tutorials

Updates & Errata

FAQs

Clone this wiki locally