i4h导管导航DRR渲染Skill i4h-catheter-navigation-render-drr

[“—”,“name: i4h-catheter-navigation-render-drr”,“version: "0.7.0"”,“description: 从CT缓存或合成体模渲染单个DRR透视帧。当需要渲染DRR、生成荧光图像或对Slang渲染器进行冒烟测试时使用。”,“license: Apache-2.0”,“metadata:”," author: "Isaac for Healthcare Team isaac-for-healthcare-support@nvidia.com"“,” tags:“,” - isaac-for-healthcare"," - i4h"," - catheter-navigation"," - drr"," - fluoroscopy",“—”,“”,“# i4h 导管导航 - 渲染DRR”,“”,“## 用途”,“”,“渲染单个数字重建放射图像（DRR）帧。可配合来自[[i4h-catheter-navigation-digital-twin]]的预处理CT缓存、直接NIfTI/DICOM路径或内置合成体模（无需数据）使用。”,“”,“## 基础代码”,“”,“bash","ROOT=\"${I4H_WORKFLOWS:-$(git rev-parse --show-toplevel 2>/dev/null)}\"","if [ ! -d \"$ROOT/workflows/catheter_navigation\" ]; then"," ROOT=\"${I4H_WORKFLOWS:-$HOME/i4h-workflows}\""," [ -d \"$ROOT/workflows/catheter_navigation\" ] || git clone https://github.com/isaac-for-healthcare/i4h-workflows \"$ROOT\"","fi","export I4H_WORKFLOWS=\"$ROOT\"; cd \"$ROOT\"","”,“”,“## 基础要点”,“”,“- 默认模式在metadata.json中；当未指定--cache时，自带合成体模。”,“- 实际渲染需要GPU + slangpy。”,“- 入口模式：./i4h run catheter_navigation render_drr（首选）。”,“”,“## 运行”,“”,“按顺序运行以下步骤。每个步骤都是一个独立的bash调用；变量在本地代理的tmux会话中持久存在。”,“”,“### 步骤1 - 解析运行目录”,“”,“bash","REPO_ROOT=\"${I4H_WORKFLOWS:-$(git rev-parse --show-toplevel 2>/dev/null)}\"; [ -d \"$REPO_ROOT/workflows/catheter_navigation\" ] || REPO_ROOT=\"$HOME/i4h-workflows\"","WF_ROOT=\"${REPO_ROOT}/workflows/catheter_navigation\"","RUN_DIR=\"${WF_ROOT}/runs/render_drr_$(date +%Y%m%d_%H%M%S)\"","mkdir -p \"${RUN_DIR}/logs\"","ln -sfn \"${RUN_DIR}\" \"${WF_ROOT}/runs/.latest\"","OUTPUT=\"${RUN_DIR}/drr.png\"","CACHE=\"${CACHE:-}\"","”,“”,“### 步骤2 - 渲染（选择以下一种变体）”,“”,“合成体模（最快的冒烟测试，无需数据）：”,“”,“bash","\"${REPO_ROOT}/i4h\" run catheter_navigation render_drr --local \\"," --run-args=\"--output ${OUTPUT}\" \\"," 2>&1 | tee \"${RUN_DIR}/logs/render_drr.log\"","”,“”,“从预处理缓存：”,“”,“bash","if [ ! -d \"${CACHE}\" ] || [ ! -f \"${CACHE}/mu_volume.npy\" ]; then"," echo \"render-drr: set CACHE to a preprocess_ct output dir (missing mu_volume.npy).\" >&2"," exit 1","fi","\"${REPO_ROOT}/i4h\" run catheter_navigation render_drr --local \\"," --run-args=\"--cache ${CACHE} --output ${OUTPUT}\" \\"," 2>&1 | tee \"${RUN_DIR}/logs/render_drr.log\"","”,“”,“## 验证”,“”,“bash","test -f \"${OUTPUT}\"","file \"${OUTPUT}\"","”,“”,“## 先决条件”,“”,“- 已完成[[i4h-catheter-navigation-setup]]。”,“- 需要带slangpy的NVIDIA GPU进行渲染（CPU冒烟测试不覆盖GPU渲染）。”,“”,“## 限制”,“”,“- 仅支持单帧渲染；批量多环境强化学习渲染需直接使用fluorosim Python API。”,“- DRR中的导管合成需要在自定义脚本中附加CatheterProvider（默认示例不包含）。”,“”,“## 故障排除”,“”,“- 错误： slangpy / CUDA 失败 - 修复：不使用--local运行以使用Docker，或验证GPU驱动>= 570且CUDA 12.8。”,“- 错误： 找不到缓存 - 修复：先运行[[i4h-catheter-navigation-digital-twin]]，或使用合成模式（不带--cache）。”,“”,“## 最终响应”,“”,“报告输出的PNG路径、使用的是合成数据还是患者缓存，以及日志路径。建议使用[[i4h-catheter-navigation-viewport]]进行交互式导航。”]