a11s11/keysight-ads-simulation-skill

Latest recorded source activity: July 16, 2026 at 07:22

SkillsMP catalog refreshed: November 12, 2026 at 12:52

skills collected: 1

GitHub stars: 9
GitHub forks: 0

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/a11s11/keysight-ads-simulation-skill.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# Keysight ADS Simulation Skill [中文](#中文) | [English](#english) A data-first Codex Agent Skill for Keysight PathWave ADS circuit, layout, EM, DRC, and fabrication workflows. <a id="中文"></a> ## 中文说明 ### 项目简介 `keysight-ads-simulation` 是一个面向 Keysight PathWave Advanced Design System（ADS）的 Codex Agent Skill。它为射频电路、非线性仿真、数据集分析、PCB 版图、电磁仿真、设计规则检查和制板文件验收提供经过实际 ADS 2026 Update 1 工作流验证的操作规范与辅助脚本。本项目强调“数据优先”：当 ADS 已经提供 `.ds`、设计数据库、SIO/Touchstone、Gerber、Excellon 或日志等结构化数据时，数值结论必须直接从这些数据中读取，不应通过 ADS 界面截图人工抄录。 > [!IMPORTANT] > 本仓库不包含 Keysight ADS 软件、许可证、厂商模型、PDK、DesignKit 或任何 Keysight 二进制文件。使用者必须自行获得合法的 ADS 安装、许可证以及任务所需模型。 ### 核心原则 | 原则 | 含义 | |---|---| | 官方接口优先 | 优先使用 `keysight.ads.de`、`db_uu`、Dataset、DDS、EDA Toolbox 和官方 AEL 接口。 | | 数据集是真值来源 | 采用 `simulate -> read .ds -> calculate -> CSV/JSON -> script plot` 的证据链。 | | 保护用户工程 | 默认创建新的工作空间和运行目录，拒绝覆盖已有 workspace、dataset、DDS、日志、版图或制板输出。 | | 分离验收门槛 | 原理图构建、求解器完成、数值性能、版图、EM、DRC 和制板导出是相互独立的验收项。 | | 明确模型边界 | 行为模型或理想模型不能替代厂商非线性模型和实物测量。 | | 无截图数值验收 | GUI 仅用于明确要求的视觉检查；结构化数据存在时不得从截图读取数值。 | ### 支持范围 | 领域 | 已覆盖能力 | |---|---| | 电路类型 | Mixer、Amplifier、Oscillator、Filter、RF Switch | | 电路分析 | DC、S 参数、Harmonic Balance、状态扫描、频谱与混频产物 | | 数据与显示 | `.ds` 数据块/变量检查、CSV/JSON、脚本绘图、原生 `.dds` 创建与结构化重开 | | 物理设计 | PCB layout、LineCalc 传输线综合、层与 LPP、衬底、焊盘栈、显式跨层过孔、端口和未布线检查 | | 电磁仿真 | Momentum/RFPro 配置、端口映射、求解状态、SIO/Touchstone 与网格收敛证据 | | 物理验证 | DVE DRC、同网络重叠与阻焊/丝印 DFM、规则加载、几何处理、错误与警告分类 | | 制板输出 | Gerber、Drill、PTH/NPTH、重复导出、CAM 往返和独立 Excellon 解析 | | 故障诊断 | ADS/Python 兼容性、许可证、模型解析、HB 收敛、启动模态窗口和日志分类 | ### `flow` 与 `release` 该 skill 明确区分两个验证级别： - `flow` 是默认级别，用最小但完整的运行证明构建、求解器或导出链路能够工作，并直接读取结果数据；不会自动施加用户没有提出的性能指标。 - `release` 是显式级别，在用户给出的指标基础上增加阈值、容差、重开/重跑复现、网格收敛、严格 DRC、Drill 对账、重复导出哈希或 CAM 往返等适用门槛。未执行但本应执行的门槛必须标为 `not verified`，不能因为某个文件存在或某个进程返回零就推断整体通过。 ### 已验证环境当前发布版本在以下环境完成验证： - Windows - Keysight ADS 2026 Update 1 - ADS Design Environment API 635 - ADS bundled CPython 3.13.2 - `keysight-edatoolbox` 1.2.5 其他 ADS、DE API、Python 或 EDA Toolbox 版本必须重新执行预检和相关工作流测试，不能直接视为兼容。 ### 仓库结构 ```text keysight-ads-simulation-skill/ ├── README.md ├── LICENSE ├── .gitignore └── keysight-ads-simulation/ ├── SKILL.md ├── agents/ │ └── openai.yaml ├── references/ ├── scripts/ └── tests/ ``` 仓库根目录用于面向用户的说明和许可；真正需要安装的 skill 是 `keysight-ads-simulation/` 子目录。 ### 安装 #### 1. 克隆仓库 ```powershell git clone https://github.com/a11s11/keysight-ads-simulation-skill.git Set-Location .\keysight-ads-simulation-skill ``` #### 2. 安装到 Codex 项目以下示例会在目标已存在时停止，避免覆盖已有 skill： ```powershell $projectRoot = 'C:\path\to\your-project' $skillsRoot = Join-Path $projectRoot '.agents\skills' $destination = Join-Path $skillsRoot 'keysight-ads-simulation' if (Test-Path -LiteralPath $destination) { throw "Destination already exists: $destination" } New-Item -ItemType Directory -Path $skillsRoot -Force | Out-Null Copy-Item -LiteralPath '.\keysight-ads-simulation' -Destination $destination -Recurse ``` #### 3. 安装为个人 skill ```powershell $codexRoot = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE '.codex' } $skillsRoot = Join-Path $codexRoot 'skills' $destination = Join-Path $skillsRoot 'keysight-ads-simulation' if (Test-Path -LiteralPath $destination) { throw "Destination already exists: $destination" } New-Item -ItemType Directory -Path $skillsRoot -Force | Out-Null Copy-Item -LiteralPath '.\keysight-ads-simulation' -Destination $destination -Recurse ``` 安装后，可以直接描述 ADS 任务让 Codex 自动匹配，也可以显式要求： ```text Use $keysight-ads-simulation to build and verify this ADS RF design. ``` ### 快速预检在仓库根目录执行： ```powershell $skill = (Resolve-Path '.\keysight-ads-simulation').Path powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\ads_preflight.py" ` -ScriptArgs @( '--require', 'de,dataset,simulator', '--output', '.\ads_preflight.json' ) ``` `invoke_ads_python.ps1` 会按显式 `-AdsRoot`、当前 `HPEESOF_DIR`、本机已安装 ADS 的顺序定位环境，并要求同一安装目录中存在 `ads.exe`、`hpeesofsim.exe` 和 ADS 自带 Python。若自动发现多个 ADS 版本，必须显式传入 `-AdsRoot`。针对不同任务可使用以下能力组合： - `de`：设计环境与数据库； - `dataset`：ADS Dataset； - `dds`：ADS Data Display； - `simulator`：电路求解器接口； - `ael`：AEL 桥接； - `em`：EM/RFPro/Momentum 工具。 ### 主要工具 | 工具 | 用途 | |---|---| | `invoke_ads_python.ps1` | 定位 ADS、设置进程级 `HPEESOF_DIR` 并调用匹配版本的 ADS Python。 | | `ads_preflight.py` | 只检查当前任务要求的 API、版本、可执行文件和许可证相关失败。 | | `run_circuit_simulation.py` | 从 ADS 设计或现有 netlist 运行电路仿真，并在新目录中保存数据和日志。 | | `analyze_dataset.py` | 直接读取 `.ds`，执行 inventory、voltage-spectrum、S 参数、振荡器或状态扫描分析。 | | `create_dds.py` | 创建原生 `.dds`，重新打开并检查数据集绑定、页面、曲线、公式和标记。 | | `verify_reopen.py` | 无强制覆盖地重开 workspace、重新生成 netlist、重跑并比较目标指标。 | | `diagnose_logs.py` | 不导入 ADS Python 即可分类 fatal、license、convergence、precision 和 optional-library 信息。 | | `inspect_layout.py` | 从设计数据库读取层、图形、端口、过孔、器件侧、网络和未布线证据。 | | `run_momentum.py` | 配置或运行 Momentum/RFPro，记录端口、频率计划、求解状态和输出。 | | `run_linecalc.py` | 运行 CPWG LineCalc 综合，等待稳定的原生 `.lcs`，解析固定参数并输出 JSON。 | | `export_layout_fabrication.py` | 通过官方 Gerber/Drill AEL 接口导出新的制板目录。 | | `verify_dve_drc.py` | 验证 DVE 规则/几何证据、AEL 绝对路径和应用模式生命周期。 | | `verify_cam_roundtrip.py` | 解析 Excellon 并评估 Gerber/Drill 往返证据。 | | `mixer_smoke_test.py` | 创建并运行参数化双音二极管混频器 smoke test。 | 每个 CLI 工具均可使用 `--help` 查看当前版本支持的完整参数。输出目录默认必须不存在，防止误覆盖旧结果。 ### 常见调用示例 #### 运行已有 netlist ```powershell $skill = (Resolve-Path '.\keysight-ads-simulation').Path powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\run_circuit_simulation.py" ` -ScriptArgs @( '--netlist', 'C:\path\to\design.net', '--output-dir', 'C:\path\to\runs\run_001', '--mode', 'flow' ) ``` #### 直接分析 Dataset ```powershell powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\analyze_dataset.py" ` -ScriptArgs @( '--dataset', 'C:\path\to\result.ds', '--kind', 'voltage-spectrum', '--variable', 'IF_OUT', '--target-frequency-hz', '100000000', '--csv', 'C:\path\to\analysis\spectrum.csv', '--output', 'C:\path\to\analysis\metrics.json' ) ``` #### 检查 PCB 版图数据库 ```powershell powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\inspect_layout.py" ` -ScriptArgs @( '--workspace', 'C:\path\to\board_wrk', '--design', 'Board_lib:Board:layout', '--stage', 'layout', '--mode', 'flow', '--output', 'C:\path\to\checks\layout_inventory.json' ) ``` Momentum 和制板导出使用 JSON 配置文件作为唯一输入： ```powershell powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\run_momentum.py" ` -ScriptArgs @('C:\path\to\momentum.json', '--mode', 'flow') powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\export_layout_fabrication.py" ` -ScriptArgs @('C:\path\to\fabrication.json') ``` 在执行物理设计任务前，请阅读 [`keysight-ads-simulation/references/layout-em-and-fabrication.md`](keysight-ads-simulation/references/layout-em-and-fabrication.md) 中的证据合同、配置字段和 ADS 2026 Update 1 限制。 ### 测试当前发布内容包含 82 项测试。在仓库根目录运行： ```powershell python -m unittest discover ` -s '.\keysight-ads-simulation\tests' ` -p 'test_*.py' ``` 测试覆盖 skill 结构、数据优先规则、通用 RF 工作流、版图/EM/制板证据、DVE DRC、ADS 应用生命周期和 CAM 往返等契约。测试通过不等于本机拥有所有 ADS 求解器许可证；实际任务仍须运行对应能力预检和求解器验收。 ### 常见问题和真实经验 #### `HPEESOF_DIR must be set` 必须在导入 `keysight.ads.de`、Dataset、DDS 或 AEL 之前设置进程级 `HPEESOF_DIR`。优先使用 `invoke_ads_python.ps1`，不要先导入再补设环境变量。 #### DDS 和 Dataset 同时使用时导入失败在 ADS 2026 Update 1 外部自动化中，同时需要两者时先导入 `keysight.ads.dds`，再导入 `keysight.ads.dataset`。 #### 外部 AEL 找不到 `dve_create_drc_job` 部分 DVE 词汇在外部 Python/AEL bridge 中不可用，但在完整 ADS 应用中可用。此时使用短生命周期的 `ads.exe -m <startup.ael>` 驱动，并保留 DVE job、报告和状态文件。 #### AEL `getenv()` 导致 `fopen(NULL)` 父进程存在的环境变量不保证 AEL `getenv()` 能读取。应用模式驱动应在启动前把 workspace、规则、job 和 status 的绝对路径写入本次 AEL 文件，不能把环境变量当作状态握手。 #### LineCalc 返回零但 `.lcs` 尚未生成 Windows 上的 `linecalc.exe` 可能只是异步启动 `linecalcui.exe`，因此返回码零不代表综合结果已经写完。应等待唯一输出目录中的 `.lcs` 非空且尺寸稳定，再解析原生数据；仅关闭窗口标题包含该输出绝对路径的本次子进程。固定参数以 `.lcs` 的 `PHYSICAL_FIXED` 记录为准，不能只相信宏中的请求值。 #### DVE 为零违规但器件焊盘仍重叠使用 `DifferentNetScope` 的间距规则不会发现同网络器件之间的焊盘重叠。制板发布还应程序化检查同网络跨器件焊盘、阻焊桥、丝印到焊盘、过渡铜皮、宽连接器焊盘附近的局部间距和地连续性，并在 LineCalc 改变线宽或间隙后全部重跑。 #### 出现 `Get Started` 或 `Swap Component` 这通常是 ADS 启动或退出生命周期问题，不是版图 DRC 错误。自动化只能隐藏本次进程新建的 ADS 主窗口，并且只能关闭已知、属于本次进程的新模态窗口；不得关闭用户原先打开的 ADS 或未知错误窗口。 #### File Browser 显示工程，但设计没有打开 ADS File Browser 显示目录不代表目标 workspace 或 cell/view 已打开。应检查 `de.workspace_is_open()`，记录实际 workspace 路径和 library/cell/view，并在需要时关闭、重开后检查设计数据库。 #### SystemVue `vtb.defs` 警告只有当设计不使用 SystemVue/VTB、模型解析成功、求解器无 fatal/license 错误、目标数据通过且需要的重开验证也通过时，才能把它分类为可选库定义警告。不要全局忽略未知的缺失库消息。 #### ADS 接受 Drill 文件但导入后是零图形 ADS 2026 Update 1 可能通过 `gbr_import_design` 接受 Excellon 输入，却不生成钻孔图形。这不能称为官方 Drill 往返通过。允许复合验收时，应使用独立 Excellon 解析、与源 `PCBVia` 对账、在专用验证层物化孔位，并明确披露官方导入限制。 ### 安全与结果边界 - 不把 ADS 许可证服务器、访问令牌、模型授权文件或 PDK 上传到仓库。 - 不因行为模型或理想对称模型产生的结果宣称真实硬件增益、隔离、噪声、P1dB 或 IP3。 - 不因 `.ds`、Gerber、Drill 或求解目录存在就自动判定成功。 - 不把 ADS 2026 Update 1 的实测经验无条件推广到其他版本。 - 不在未经确认的情况下覆盖用户工程或清理已有输出目录。 ### 贡献提交改动前，请保持 `SKILL.md` 简洁，把详细版本/API知识放入 `references/`，把可重复的机械检查放入 `scripts/`，并为新增或修改的契约添加测试。请勿提交 Keysight 软件、厂商模型、许可证内容、用户项目或生成的仿真数据。 ### 许可证与商标本仓库中的原创 skill 文档和脚本依据 [MIT License](LICENSE) 发布。 Keysight、PathWave 和 Advanced Design System（ADS）是其各自权利人的商标。本项目是独立的非官方社区项目，与 Keysight Technologies 不存在隶属、授权或背书关系。 --- <a id="english"></a> ## English ### Overview `keysight-ads-simulation` is a Codex Agent Skill for Keysight PathWave Advanced Design System (ADS). It provides workflows and reusable helpers validated against real ADS 2026 Update 1 tasks involving RF circuits, nonlinear simulation, dataset analysis, PCB layout, EM simulation, design-rule checking, and fabrication evidence. The project is data-first. When ADS provides structured artifacts such as `.ds`, design-database objects, SIO/Touchstone, Gerber, Excellon, or logs, numerical conclusions must come directly from those artifacts rather than being transcribed from ADS screenshots. > [!IMPORTANT] > This repository does not include Keysight ADS, a license, vendor models, PDKs, DesignKits, or any Keysight binary. Users must provide a legally licensed ADS installation and every model required by their task. ### Core principles | Principle | Meaning | |---|---| | Prefer official interfaces | Use `keysight.ads.de`, `db_uu`, Dataset, DDS, EDA Toolbox, and official AEL interfaces whenever applicable. | | Treat datasets as the source of truth | Follow `simulate -> read .ds -> calculate -> CSV/JSON -> script plot`. | | Protect user work | Create new workspaces and run directories by default and refuse to overwrite existing projects or results. | | Separate acceptance gates | Design construction, solver completion, numerical performance, layout, EM, DRC, and fabrication export are independent gates. | | State model limits | Behavioral and ideal models do not replace vendor nonlinear models or hardware measurements. | | Do not measure screenshots | Use the GUI only for an explicitly requested visual check when structured data cannot answer the criterion. | ### Supported scope | Area | Covered capabilities | |---|---| | Circuit families | Mixer, Amplifier, Oscillator, Filter, RF Switch | | Circuit analyses | DC, S-parameters, Harmonic Balance, state sweeps, spectra, and mixing products | | Data and displays | `.ds` block/variable inspection, CSV/JSON, scripted plots, native `.dds` creation and structural reopen | | Physical design | PCB layout, LineCalc transmission-line synthesis, layers and LPPs, substrates, padstacks, explicitly spanned vias, ports, and unroutes | | EM | Momentum/RFPro configuration, port maps, terminal solver status, SIO/Touchstone, and mesh-convergence evidence | | Physical verification | DVE DRC, same-net overlap and solder-mask/silkscreen DFM, rule loading, processed geometry, error and warning classification | | Fabrication | Gerber, Drill, PTH/NPTH, repeated export, CAM round trips, and independent Excellon parsing | | Troubleshooting | ADS/Python compatibility, licenses, model resolution, HB convergence, startup modals, and log classification | ### `flow` and `release` The skill separates two validation levels: - `flow` is the default. It uses the smallest complete run that proves the requested build, solver, or export path and reads the resulting data directly. It does not invent a performance threshold that the user did not request. - `release` is explicit. It adds applicable user-defined thresholds, tolerances, reopen/rerun reproducibility, mesh convergence, strict DRC, Drill reconciliation, repeated-export hashes, or CAM round trips. An applicable gate that was not executed must be reported as `not verified`. File existence or a zero process return code alone does not prove end-to-end success. ### Validated environment The current release has been validated with: - Windows - Keysight ADS 2026 Update 1 - ADS Design Environment API 635 - ADS-bundled CPython 3.13.2 - `keysight-edatoolbox` 1.2.5 Other ADS, DE API, Python, or EDA Toolbox versions require a fresh preflight and task-specific validation. Compatibility is not implied. ### Repository layout ```text keysight-ads-simulation-skill/ ├── README.md ├── LICENSE ├── .gitignore └── keysight-ads-simulation/ ├── SKILL.md ├── agents/ │ └── openai.yaml ├── references/ ├── scripts/ └── tests/ ``` The repository root contains user-facing documentation and licensing. Install the `keysight-ads-simulation/` subdirectory as the actual skill. ### Installation #### 1. Clone ```powershell git clone https://github.com/a11s11/keysight-ads-simulation-skill.git Set-Location .\keysight-ads-simulation-skill ``` #### 2. Install into a Codex project The following example stops if the destination exists, preventing accidental replacement: ```powershell $projectRoot = 'C:\path\to\your-project' $skillsRoot = Join-Path $projectRoot '.agents\skills' $destination = Join-Path $skillsRoot 'keysight-ads-simulation' if (Test-Path -LiteralPath $destination) { throw "Destination already exists: $destination" } New-Item -ItemType Directory -Path $skillsRoot -Force | Out-Null Copy-Item -LiteralPath '.\keysight-ads-simulation' -Destination $destination -Recurse ``` #### 3. Install as a personal skill ```powershell $codexRoot = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE '.codex' } $skillsRoot = Join-Path $codexRoot 'skills' $destination = Join-Path $skillsRoot 'keysight-ads-simulation' if (Test-Path -LiteralPath $destination) { throw "Destination already exists: $destination" } New-Item -ItemType Directory -Path $skillsRoot -Force | Out-Null Copy-Item -LiteralPath '.\keysight-ads-simulation' -Destination $destination -Recurse ``` After installation, describe an ADS task and let Codex discover the skill, or invoke it explicitly: ```text Use $keysight-ads-simulation to build and verify this ADS RF design. ``` ### Quick preflight Run from the repository root: ```powershell $skill = (Resolve-Path '.\keysight-ads-simulation').Path powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\ads_preflight.py" ` -ScriptArgs @( '--require', 'de,dataset,simulator', '--output', '.\ads_preflight.json' ) ``` `invoke_ads_python.ps1` resolves ADS from an explicit `-AdsRoot`, the current `HPEESOF_DIR`, or installed ADS directories. It requires `ads.exe`, `hpeesofsim.exe`, and the bundled Python to come from the same installation. If discovery finds multiple ADS versions, pass `-AdsRoot` explicitly. Available capability names are: - `de`: Design Environment and database; - `dataset`: ADS Dataset; - `dds`: ADS Data Display; - `simulator`: circuit-simulator interface; - `ael`: AEL bridge; - `em`: EM/RFPro/Momentum tools. ### Main tools | Tool | Purpose | |---|---| | `invoke_ads_python.ps1` | Locate ADS, set process-scoped `HPEESOF_DIR`, and launch the matching ADS Python. | | `ads_preflight.py` | Probe only the APIs, versions, executables, and license failures required by the current task. | | `run_circuit_simulation.py` | Run an ADS design or an existing netlist into a new output directory and retain data and logs. | | `analyze_dataset.py` | Read `.ds` directly for inventory, voltage-spectrum, S-parameter, oscillator, or state-sweep analysis. | | `create_dds.py` | Create a native `.dds`, reopen it, and verify dataset binding, pages, traces, equations, and markers. | | `verify_reopen.py` | Reopen a workspace without force, regenerate its netlist, rerun, and compare the requested metric. | | `diagnose_logs.py` | Classify fatal, license, convergence, precision, and optional-library messages without importing ADS Python. | | `inspect_layout.py` | Read layers, shapes, ports, vias, component sides, nets, and unroutes from the design database. | | `run_momentum.py` | Configure or run Momentum/RFPro and retain ports, frequency plan, terminal status, and outputs. | | `run_linecalc.py` | Run CPWG LineCalc synthesis, wait for a stable native `.lcs`, parse fixed parameters, and emit JSON. | | `export_layout_fabrication.py` | Export a new fabrication directory through official Gerber/Drill AEL functions. | | `verify_dve_drc.py` | Validate DVE rule/geometry evidence, absolute AEL paths, and the application-mode lifecycle. | | `verify_cam_roundtrip.py` | Parse Excellon and evaluate Gerber/Drill round-trip evidence. | | `mixer_smoke_test.py` | Build and run a parameterized two-tone diode-mixer smoke test. | Use `--help` on each CLI tool for the current argument list. Output directories are expected not to exist so that older evidence cannot be overwritten silently. ### Common command examples #### Run an existing netlist ```powershell $skill = (Resolve-Path '.\keysight-ads-simulation').Path powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\run_circuit_simulation.py" ` -ScriptArgs @( '--netlist', 'C:\path\to\design.net', '--output-dir', 'C:\path\to\runs\run_001', '--mode', 'flow' ) ``` #### Analyze a Dataset directly ```powershell powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\analyze_dataset.py" ` -ScriptArgs @( '--dataset', 'C:\path\to\result.ds', '--kind', 'voltage-spectrum', '--variable', 'IF_OUT', '--target-frequency-hz', '100000000', '--csv', 'C:\path\to\analysis\spectrum.csv', '--output', 'C:\path\to\analysis\metrics.json' ) ``` #### Inspect a PCB layout database ```powershell powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\inspect_layout.py" ` -ScriptArgs @( '--workspace', 'C:\path\to\board_wrk', '--design', 'Board_lib:Board:layout', '--stage', 'layout', '--mode', 'flow', '--output', 'C:\path\to\checks\layout_inventory.json' ) ``` Momentum and fabrication export use JSON configuration files as their single input: ```powershell powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\run_momentum.py" ` -ScriptArgs @('C:\path\to\momentum.json', '--mode', 'flow') powershell -ExecutionPolicy Bypass ` -File "$skill\scripts\invoke_ads_python.ps1" ` -Script "$skill\scripts\export_layout_fabrication.py" ` -ScriptArgs @('C:\path\to\fabrication.json') ``` Read [`keysight-ads-simulation/references/layout-em-and-fabrication.md`](keysight-ads-simulation/references/layout-em-and-fabrication.md) for the evidence contract, configuration fields, and ADS 2026 Update 1 limitations before running a physical-design task. ### Tests The current publication contains 82 tests. Run from the repository root: ```powershell python -m unittest discover ` -s '.\keysight-ads-simulation\tests' ` -p 'test_*.py' ``` The suite covers skill structure, data-first requirements, general RF flows, layout/EM/fabrication evidence, DVE DRC, ADS application lifecycle, and CAM round trips. Passing these tests does not prove that every ADS solver license is available on the current machine; run the corresponding capability preflight and solver acceptance for each real task. ### Troubleshooting and lessons from real runs #### `HPEESOF_DIR must be set` Set process-scoped `HPEESOF_DIR` before importing `keysight.ads.de`, Dataset, DDS, or AEL. Prefer `invoke_ads_python.ps1`; do not import first and set the variable afterward. #### DDS and Dataset fail when used together In ADS 2026 Update 1 external automation, import `keysight.ads.dds` before `keysight.ads.dataset` when both are needed in one process. #### External AEL cannot find `dve_create_drc_job` Some DVE vocabulary is unavailable through the external Python/AEL bridge but available in the full ADS application. Use a short-lived `ads.exe -m <startup.ael>` driver and retain its DVE job, report, and status file. #### AEL `getenv()` leads to `fopen(NULL)` An environment variable present in the parent process is not guaranteed to be available through AEL `getenv()`. Render absolute workspace, rule, job, and status paths into a run-specific AEL driver before launch. Do not use an environment lookup as the application-mode status handshake. #### LineCalc returns zero before `.lcs` exists On Windows, `linecalc.exe` can be an asynchronous launcher for `linecalcui.exe`, so return code zero does not prove that synthesis output is complete. Wait for a non-empty, size-stable `.lcs` in a unique output directory, then parse the native data and close only the run-owned child whose window title contains that absolute output path. Treat only parameters recorded under `PHYSICAL_FIXED` as fixed rather than trusting the macro request alone. #### DVE reports zero violations while component pads still overlap A clearance rule using `DifferentNetScope` does not detect same-net pad overlap between components. Fabrication release also needs programmatic checks for same-net inter-component pads, solder-mask web, silkscreen-to-pad clearance, transition copper, local clearance beside wide connector lands, and ground continuity. Rerun all of them after LineCalc changes a line width or gap. #### `Get Started` or `Swap Component` appears This is normally an ADS startup/exit lifecycle issue, not a layout DRC error. Automation may hide only new ADS windows owned by the launched process and may close only known, new, process-owned startup modals. It must not touch a user's pre-existing ADS window or an unknown error dialog. #### File Browser shows the project but no design is open The ADS File Browser is not proof that a workspace or cell/view is open. Check `de.workspace_is_open()`, record the actual workspace and library/cell/view identity, and close/reopen the saved database when the validation level requires it. #### SystemVue `vtb.defs` warning Classify this as an optional-library warning only if the design does not use SystemVue/VTB, required models resolve, the solver has no fatal/license error, the target dataset passes, and any required reopen check also passes. Never suppress unknown missing-library messages globally. #### ADS accepts Drill input but imports zero shapes ADS 2026 Update 1 may accept Excellon through `gbr_import_design` while materializing zero drill shapes. This is not an official Drill round-trip pass. When a composite gate is allowed, independently parse Excellon, reconcile it with source `PCBVia` objects, materialize holes on a dedicated verification layer, and disclose the official-import limitation. ### Safety and claim boundaries - Do not commit ADS license-server values, access tokens, licensed model files, or PDKs. - Do not turn results from a behavioral or perfectly symmetric ideal model into hardware claims for gain, isolation, noise, P1dB, or IP3. - Do not accept a run merely because a `.ds`, Gerber, Drill, or solver directory exists. - Do not generalize ADS 2026 Update 1 observations to other releases without revalidation. - Do not overwrite user projects or clean existing run directories without exact authorization. ### Contributing Keep `SKILL.md` concise, place detailed version/API knowledge in `references/`, put deterministic checks in `scripts/`, and add tests for every new or changed contract. Do not contribute Keysight software, vendor models, license data, user projects, or generated simulation results. ### License and trademarks Original skill documentation and scripts in this repository are released under the [MIT License](LICENSE). Keysight, PathWave, and Advanced Design System (ADS) are trademarks of their respective owners. This is an independent, unofficial community project and is not affiliated with, authorized by, or endorsed by Keysight Technologies.

Loading the repository README…

Skills in this repository

Electronics Engineers, Except Computer

1 occupation category · 100% classified

skill

occupation

description

updated

keysight-ads-simulation

Electronics Engineers, Except Computer

Use when working with Keysight PathWave ADS RF circuits or physical designs, including mixer, amplifier, oscillator, filter, RF switch, schematic, PCB layout, LineCalc transmission-line synthesis, Momentum or RFPro EM, DRC, Gerber, Drill, CAM round trips, .ds…

2026-07-16

Showing 1 of 1 collected skill.