Skip to content

gosila/Matcha

Repository files navigation

Matcha! — S-Parameter Analysis, Matching Network Synthesis & Optimization

Matcha! logo

Free for personal and commercial use  ·  Windows 10/11  ·  macOS 12+


Matcha! is a desktop app for RF engineers that combines a VNA controller, matching-network synthesizer, and optimizer in one tool. Connect your Keysight or R&S VNA over TCP, load any Touchstone S-parameter file, and let Matcha find the best LC matching network for your design goals.

No Python installation required — the app bundles everything.


Download

Platform Download
Windows 10 / 11 (64-bit) ➡️ MatchaSetup.exe — installer with Start Menu shortcut
macOS 12+ (Apple Silicon & Intel) ➡️ Matcha.dmg — drag Matcha.app to Applications

See the Releases page for all versions and release notes.


Features

  • Live VNA sweep — connects to Keysight PNA/ENA and R&S ZNB/ZNA over TCP (port 5025); imports .s1p, .s2p, .s3p, .s4p Touchstone files
  • Matching network synthesis — automatically discovers topology and component values (L, C, series/shunt, 1–6 elements) that meet your S11/S22 targets across one or more frequency bands simultaneously
  • Optimizer — fine-tunes an existing network's values with vendor component constraints and tolerance analysis
  • Vendor component libraries — Murata LQP03HQ, LQW15AN, GJM03, GRM03, and more; synthesis and optimization snap to real catalog values and use measured S2P data including ESR, parasitics, and self-resonance
  • Smith chart, VSWR, magnitude, phase, impedance, Q-factor plots
  • Max achievable bandwidth — computes the Bode–Fano bound for N = 2 networks from the Q-factor plot
  • Numba-accelerated SA engine — JIT-compiled simulated annealing with parallel tempering, frequency subsetting, and multi-start caching; 10–30× more iterations in the same wall time
  • MatchaCLI — headless JSON command-line interface included in every installation for scripting and automation workflows

Matcha! logo

Matcha! logo

Matcha! logo

Matcha! logo


Quick Start

Windows: run Matcha.exe from the Start Menu or install directory.

macOS: open Matcha.app from your Applications folder.

Then:

  1. Load a Touchstone file with File → Open SNP, or connect a live VNA with VNA → Connect.
  2. Open Synthesis from the toolbar, set your frequency bands and S11 targets, pick a component count, and press Run.
  3. Results appear ranked by cost score; click any row to overlay the matching network on the plot.

MatchaCLI — JSON Workflow

A headless CLI is included in every installation. It accepts JSON requests and returns JSON results — useful for batch processing, CI pipelines, or integration with other tools.

Windows (MatchaCLI.exe):

MatchaCLI.exe evaluate   request.json
MatchaCLI.exe optimize   request.json  -o result.json
MatchaCLI.exe synthesize spec.json     -o result.json

macOS (matcha_cli):

./matcha_cli evaluate   request.json
./matcha_cli optimize   request.json  -o result.json
./matcha_cli synthesize spec.json     -o result.json

A matcha_cli_examples/ folder with copy-paste JSON examples is included alongside the executables on both platforms.


System Requirements

Windows macOS
OS Windows 10 or 11 (64-bit) macOS 12 Monterey or later
CPU x86-64 Intel or Apple Silicon (via Rosetta 2)
RAM 4 GB min, 8 GB recommended 4 GB min, 8 GB recommended
Disk ~250 MB ~400 MB
VNA (optional) Keysight PNA/ENA or R&S ZNB/ZNA over TCP port 5025 same

License

Matcha! is freeware.

  • ✅ Free for personal and commercial use
  • ✅ Free to redistribute the unmodified installer (with this license)
  • ❌ Must not be sold or bundled in a paid product
  • ❌ Must not be rebranded or distributed in modified form

See LICENSE for the full terms.

About

RF matching network synthesizer, optimizer, and S-parameter analyzer with live VNA control

Topics

Resources

License

Stars

Watchers

Forks

Packages