{"id":51171841,"url":"https://github.com/caalh/owen","last_synced_at":"2026-06-27T01:08:42.212Z","repository":{"id":361943924,"uuid":"1256553251","full_name":"caalh/owen","owner":"caalh","description":"OWEN — Open Workflow for Engineered Neutronics: a VS Code/Cursor extension for MCNP, OpenMC, Serpent \u0026 SCONE (syntax highlighting, lattice builder, 3D preview, validation, workflow automation). A BelvoirDynamics product.","archived":false,"fork":false,"pushed_at":"2026-06-22T23:34:22.000Z","size":764,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-23T00:09:43.116Z","etag":null,"topics":["mcnp","monte-carlo","neutronics","nuclear","openmc","scone","serpent","vscode-extension"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/caalh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-01T22:16:42.000Z","updated_at":"2026-06-22T23:34:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/caalh/owen","commit_stats":null,"previous_names":["caalh/owen"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/caalh/owen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caalh%2Fowen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caalh%2Fowen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caalh%2Fowen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caalh%2Fowen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caalh","download_url":"https://codeload.github.com/caalh/owen/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caalh%2Fowen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34838065,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcnp","monte-carlo","neutronics","nuclear","openmc","scone","serpent","vscode-extension"],"created_at":"2026-06-27T01:08:41.514Z","updated_at":"2026-06-27T01:08:42.203Z","avatar_url":"https://github.com/caalh.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eOWEN\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\u003cstrong\u003eOpen Workspace for Engineered Neutronics\u003c/strong\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003eCreated by \u003cstrong\u003eAaron W. Calhoun\u003c/strong\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003eThe nuclear reactor modeling toolkit for VS Code \u0026amp; Cursor — syntax highlighting, a visual lattice builder, geometry preview, deep input validation, and workflow automation for \u003cstrong\u003eMCNP\u003c/strong\u003e, \u003cstrong\u003eOpenMC\u003c/strong\u003e, \u003cstrong\u003eSerpent\u003c/strong\u003e, and \u003cstrong\u003eSCONE\u003c/strong\u003e.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://marketplace.visualstudio.com/items?itemName=belvoirdynamics.owen-neutronics\"\u003e\u003cimg alt=\"VS Code Marketplace Version\" src=\"https://img.shields.io/visual-studio-marketplace/v/belvoirdynamics.owen-neutronics?label=VS%20Marketplace\u0026logo=visualstudiocode\u0026color=0b1020\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://marketplace.visualstudio.com/items?itemName=belvoirdynamics.owen-neutronics\"\u003e\u003cimg alt=\"VS Code Marketplace Installs\" src=\"https://img.shields.io/visual-studio-marketplace/i/belvoirdynamics.owen-neutronics?label=installs\u0026color=f59e0b\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://open-vsx.org/extension/belvoirdynamics/owen-neutronics\"\u003e\u003cimg alt=\"Open VSX Version\" src=\"https://img.shields.io/open-vsx/v/belvoirdynamics/owen-neutronics?label=Open%20VSX\u0026color=0b1020\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/caalh/owen/releases/latest\"\u003e\u003cimg alt=\"GitHub release\" src=\"https://img.shields.io/github/v/release/caalh/owen?label=release\u0026color=f59e0b\"\u003e\u003c/a\u003e\n  \u003ca href=\"./LICENSE\"\u003e\u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/license-MIT-0b1020\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003eA \u003ca href=\"https://reactormc.net\"\u003eBelvoirDynamics\u003c/a\u003e product · part of \u003ca href=\"https://reactormc.net\"\u003eReactorMC\u003c/a\u003e\u003c/p\u003e\n\n---\n\nOWEN brings first-class editor support for the four major Monte Carlo neutron-transport\ncodes to VS Code and Cursor. Write decks faster with smart snippets, catch mistakes before\nyou run with language-aware validation, build lattices visually, and launch solvers without\nleaving your editor.\n\n## See it in action\n\n**Visual Lattice Builder → MCNP 17×17 assembly, with live syntax highlighting.** Pick fuel,\nguide-tube, and instrument-tube positions on a grid and OWEN writes the lattice deck for you.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"OWEN Lattice Builder generating an MCNP 17×17 PWR assembly deck with live syntax highlighting\" src=\"https://raw.githubusercontent.com/caalh/owen/main/media/demo-lattice-builder.gif\" width=\"900\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/caalh/owen/releases/download/v0.2.2/demo-lattice-builder.mp4\"\u003e▶ Watch full-quality MP4\u003c/a\u003e\u003c/p\u003e\n\n**3D geometry preview of a full Serpent core — component toggles, Disc/Layers fidelity, and\nX / Y / Z slice planes.** Inspect ~56,900 pins interactively: peel away vessel and guide tubes,\nswitch to concentric pin layers, and slice through the core.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"OWEN 3D geometry preview of a full Serpent core with component toggles and slice planes\" src=\"https://raw.githubusercontent.com/caalh/owen/main/media/demo-3d-preview.gif\" width=\"820\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/caalh/owen/releases/download/v0.2.2/demo-3d-preview.mp4\"\u003e▶ Watch full-quality MP4\u003c/a\u003e\u003c/p\u003e\n\n## Features\n\n| Feature | Description |\n|---------|-------------|\n| **Syntax highlighting** | TextMate grammars for MCNP (`.i`, `.mcnp`, `.inp`), Serpent (`.serp`), and SCONE (`.scone`). OpenMC is detected from Python files that `import openmc`. |\n| **Snippets** | Ready-to-edit decks: PWR pin cell, 17×17 PWR assembly, criticality array, and shielding slab for MCNP; full OpenMC pin/assembly Python scripts; SCONE fuel pin, 5×5 assembly, and shielding tutorials. |\n| **Lattice Builder** | A visual grid editor that generates MCNP / OpenMC / Serpent lattice code from a few clicks. |\n| **3D geometry preview** | Three.js webview rendering of MCNP `cz` cylinders, with graceful empty-states for other codes. |\n| **Deep validation** | Language-aware diagnostics with codes — ZAID format, density/fraction sign conventions, `mt`/S(α,β) hydrogen checks, macrobody parameter counts (MCNP); `IndependentSource`/`RectangularPrism` API checks (OpenMC); `cuboid` vs `rect`, `trcl`, CLI `omp` (Serpent); `aceNeutronDatabase`, temperature-suffix matching, `pinUniverse` radii/fills (SCONE). |\n| **Workflow automation** | One-command simulation runner that launches the right solver in a dedicated terminal. |\n| **Parametric sweep** | JSON-described parameter sweeps with per-run input mutation, output capture, k-eff parsing, and a manifest + TSV summary. |\n| **Material insertion (NRDP)** | Insert reactor materials from the Nuclear Reactor Data Project database — bundled snapshot with optional live refresh from reactormc.net, language-aware output. |\n| **Community Library** | Browse and insert community-approved models (opt-in via `owen.community.enabled`; you supply your own Supabase backend). |\n| **Tutorials** | Deep-links into the reactormc.net learning material via `OWEN: Open Tutorial`. |\n\n## Install\n\n**From the Marketplace** (once published):\n\n1. Open the Extensions view (`Ctrl+Shift+X` / `Cmd+Shift+X`).\n2. Search for **OWEN** and click **Install** — or install [`belvoirdynamics.owen-neutronics`](https://marketplace.visualstudio.com/items?itemName=belvoirdynamics.owen-neutronics).\n\n**From Open VSX** (Cursor, VSCodium, etc.): install [`belvoirdynamics/owen-neutronics`](https://open-vsx.org/extension/belvoirdynamics/owen-neutronics).\n\n**From a VSIX** (available now via [GitHub Releases](https://github.com/caalh/owen/releases/latest)):\n\n```bash\ncode --install-extension owen-neutronics-0.1.0.vsix\n# Cursor:\ncursor --install-extension owen-neutronics-0.1.0.vsix\n```\n\nOr in the editor: Extensions view → `...` menu → **Install from VSIX…**.\n\n## Commands\n\nOpen the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`) and type **OWEN**:\n\n| Command | Description |\n|---------|-------------|\n| `OWEN: Open Lattice Builder` | Visual lattice grid editor |\n| `OWEN: Validate Input File` | Deep MCNP / OpenMC / Serpent / SCONE checks |\n| `OWEN: Run Simulation` | Launch the appropriate solver in a dedicated terminal |\n| `OWEN: Run Parameter Sweep` | Generate and run a JSON-described sweep |\n| `OWEN: Open 3D Geometry Preview` | Three.js webview (MCNP cylinders) |\n| `OWEN: Open Tutorial` | Jump to a reactormc.net tutorial page |\n| `OWEN: Insert Material from Database` | NRDP material picker, language-aware |\n| `OWEN: Search Reactor Library` | Community Library browser (disabled by default) |\n\n## Configuration\n\nAll settings live under the **OWEN** section (`Ctrl+,` → search \"owen\"):\n\n| Key | Default | Notes |\n|-----|---------|-------|\n| `owen.mcnp.executable` | `mcnp6` | Path to the MCNP executable |\n| `owen.serpent.executable` | `sss2` | Path to the Serpent executable |\n| `owen.openmc.executable` | `openmc` | Non-Python OpenMC entry point only |\n| `owen.openmc.pythonExecutable` | `python` | Interpreter for OpenMC model scripts |\n| `owen.scone.executable` | `scone` | On Windows, SCONE typically requires WSL |\n| `owen.simulation.workingDirectory` | `\"\"` | Empty = the input file's directory |\n| `owen.nrdp.live` | `true` | Live-fetch NRDP snapshots when online |\n| `owen.nrdp.endpoint` | `https://reactormc.net/data` | Base URL for live NRDP JSON |\n| `owen.community.enabled` | `false` | Enable the Community Library browser |\n| `owen.supabase.url` | `\"\"` | Supabase project URL (you supply this) |\n| `owen.supabase.anonKey` | `\"\"` | Supabase anon/public key (you supply this) |\n\n\u003e The Community Library is **off by default** and ships with **no credentials**. To use it,\n\u003e point `owen.supabase.url` / `owen.supabase.anonKey` at your own Supabase project.\n\n## Requirements\n\nOWEN is an editor toolkit — it does not bundle the Monte Carlo solvers. To run simulations,\ninstall and point the settings above at your own builds of:\n\n- **MCNP** (Los Alamos National Laboratory — export-controlled, requires a license)\n- **OpenMC** (open source; run via the Python interpreter you configure)\n- **Serpent** (VTT — requires a license)\n- **SCONE** (University of Cambridge — open source; on Windows it typically runs under **WSL**)\n\nSyntax highlighting, snippets, validation, the lattice builder, and geometry preview all work\nwithout any solver installed.\n\n## Supported languages\n\n| Language | Highlighting | Snippets | Validation | Runner |\n|----------|--------------|----------|------------|--------|\n| MCNP | Yes | Yes | Yes (deep) | `mcnp6 inp=…` |\n| OpenMC (Python) | Via Python ext | Yes | Yes (deep) | `python \u003cfile\u003e` |\n| Serpent | Yes | Yes | Yes (deep) | `sss2 \u003cfile\u003e` |\n| SCONE | Yes | Yes | Yes (deep) | `scone \u003cfile\u003e` (WSL on Windows) |\n\n## Related\n\n- **[ReactorMC](https://reactormc.net)** — tutorials, the community library, and the NRDP material data that powers OWEN.\n- **GROVES** — the companion desktop editor for the same input languages.\n\n## License\n\n[MIT](./LICENSE) © 2026 BelvoirDynamics.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaalh%2Fowen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaalh%2Fowen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaalh%2Fowen/lists"}