Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

nPort RF Analysis

Jerome G WiltzJerome G Wiltz119 downloads

Analyze RF and microwave networks from Markdown and render SVG charts, tables, and Smith plots.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates4

nPort RF Analysis brings the nP RF and microwave analysis library into Obsidian. Its primary workflow is JavaScript: write or copy an npjs block, inspect the lint feedback, then select Run to calculate and render results in the note.

The plugin currently supports Obsidian desktop. Mobile support will be declared only after testing in Obsidian Mobile.

Install

After publication in the Obsidian Community Plugin directory:

  1. Open Settings → Community plugins.
  2. Select Browse, find nPort RF Analysis, then choose Install and Enable.
  3. Open Settings → Community plugins → nPort RF Analysis and install What's new and Examples. These can be installed independently.
  4. Close Settings and open nPort RF Analysis/Examples/Examples Home from the Files pane. The release note is in nPort RF Analysis/What's new in version 0.3.3/.

The plugin installs the current version's release note and the REPL examples into the current vault only. It creates missing files and never overwrites existing notes. Each example note contains one runnable npjs block and a link to the same example in the nP REPL. All 46 notes are directly inside one Examples folder and numbered in the REPL's order (01, 02, …).

For manual installation, download main.js, manifest.json, and styles.css from the GitHub release matching the version in manifest.json, and place them in:

<vault>/.obsidian/plugins/np-rf-analysis/

Restart Obsidian and enable the plugin in that vault. A manual installation is separate for each vault.

Write notes with Codex or Claude

The compiled plugin includes a self-contained nP code-writing agent. When the plugin loads, it creates AGENTS.md in its own installation folder, normally .obsidian/plugins/np-rf-analysis/. A different vault configuration folder is supported. AGENTS.sha256 tracks the last installed copy: future builds update unchanged installed copies and preserve files that were edited or supplied by the user. No vault-root AGENTS.md or CLAUDE.md is created or changed.

Start Codex or Claude at the vault root and explicitly ask it to read .obsidian/plugins/np-rf-analysis/AGENTS.md, then describe the circuit or provide a schematic image. The agent writes minimal Markdown npjs blocks. It does not run code unless asked. Open the note in Reading view and select Run. This file provides instructions; the plugin does not include or launch an AI service, send vault content to one, or require one for RF analysis.

Maintainers synchronize the canonical nP/nP-agents/obsidian/AGENTS.md with npm run agent:sync, then use npm run agent:check to compare the copies. An alternate source can be passed with -- --source /path/to/AGENTS.md. The checked copy and checksum in bundled-agent/ must be committed together. Normal builds and CI use that copy without the nP repository or network access. The production build rejects a missing or mismatched copy; release verification executes the built plugin against a vault stub and compares the installed text.

Run nP JavaScript

Use an npjs code block for the full nP JavaScript API:

```npjs
nP.global.fList = nP.global.fGen(1e9, 3e9, 5);

var r1 = nP.R(25);
var response = r1.out('s11dB', 's21dB');

nP.lineChart({
  inputTable: [response],
  title: 'Frequency sweep',
  metricPrefix: 'giga'
});

nP.schematic(r1);
```

Before execution, Run checks JavaScript syntax, suspicious line continuations, accidental comma expressions, and direct calls to unknown nP API names. Suggestions use the exact nP API bundled with the plugin. These checks show line and column locations; warnings do not block execution. They are static checks and do not run the code. Select Run to execute, Stop to terminate, or Reset to clear the result.

The nP website is the home for nP, and the nP REPL is the source of truth for the ordered example list and current guidance. The REPL runs the starter examples in a browser. The plugin's numbered notes are generated from that ordered list; they are a convenient offline, in-vault copy, not an independently maintained curriculum.

Optional declarative blocks

The plugin also accepts np blocks containing validated JSON. These blocks are automatically analyzed and rendered without executing JavaScript. Use this limited declarative format when automatic rendering is useful; use npjs for the full nP API and REPL examples.

Results and PDF export

Each npjs run uses an isolated execution context. Successful rendered results are saved as validated display data and restored when the note is rendered again, allowing Obsidian to include them in Export to PDF without rerunning JavaScript. Editing a block invalidates its saved result; run it again to save the new output.

Saved results are stored in the plugin's data.json, not inserted into Markdown. Their age and storage limits can be configured in plugin settings. Results can be cleared from settings or the command palette. Optional session-only mode clears them on a normal Obsidian quit; this is best-effort and cannot run after a crash or forced shutdown.

Security

npjs runs user-authored JavaScript only after Run is selected. It executes in a disposable Web Worker inside a sandboxed iframe. Network connections, remote resources, browser storage, and nested workers are blocked. The worker does not receive Obsidian's app or vault APIs, the real DOM, Node.js, Electron, require, or process.

Linting is static analysis outside the worker; it never evaluates user code. The worker remains the execution boundary. The np JSON workflow validates input and never executes JavaScript. The plugin has no telemetry, advertisements, self-update mechanism, or runtime code download.

Support and feedback

For questions, bug reports, or feature requests, open an issue on GitHub. Do not include private vault contents, credentials, or other sensitive information. Security reports and supported-version details are in SECURITY.md.

The plugin settings page includes Open documentation and Report an issue buttons. They open GitHub only after you select them; the plugin makes no background network requests.

HealthExcellent
ReviewSatisfactory
About
Embed RF and microwave network analysis in Obsidian Markdown notes. Run nP JavaScript on demand and render inline SVG line charts, Smith charts, or tables while saving JSON render instructions for safe, repeatable exports. Support Obsidian desktop; mobile pending testing.
ChartsCodeTables
Details
Current version
0.3.3
Last updated
Last week
Created
4 months ago
Updates
4 releases
Downloads
119
Compatible with
Obsidian 1.5.0+
Platforms
Desktop only
License
MIT
Report bugRequest featureReport plugin
Author
Jerome G WiltzJerome G Wiltzjerrywiltz
GitHubjerrywiltz
  1. Community
  2. Plugins
  3. Charts
  4. nPort RF Analysis

Related plugins

Notion Bases

Turn any folder into a database — table, kanban board, gallery, calendar, timeline and list views powered by frontmatter.

Sheet Plus

Create Excel-like spreadsheets and easily embed them in Markdown.

Macros

Nutrition and food tracker for your notes. Log meals, calories, macros and micronutrients. Search foods by name or barcode via FatSecret, USDA & Open Food Facts. Chart your diet & weight loss.

Dynamic Wide Content

Display wide tables, diagrams, images, and code blocks in scrollable wide frames while preserving normal readable prose width.

PennyWallet

Track expenses, income, transfers, and credit card repayments as Markdown tables in your vault.

Templater

Create and use dynamic templates.

Mermaid Tools

Improved Mermaid.js experience: visual toolbar with common elements and more.

Advanced Tables

Improved table navigation, formatting, and manipulation.

Tracker

Track occurrences and numbers in your notes.

CSV Table

Render CSV data as a table within your notes.