Peer-Friendly Update: One-Command Entry, Script Cards, Recipes

🆕 What's New

This release turns the repo into a peer-friendly reference implementation — no paper needed, clone & run:

• One-command entry: new Makefile — make setup → make verify → make demo. All data & weights are synthetically generated in-code; nothing to download.
• Per-script usage cards: source_code/isac_sat/README.md documents all 25 scripts (purpose / command / output / runtime).
• Parameter recipes: configs/README.md — quick-reference table + 6 copy-paste experiment recipes (RIS modes, wideband vs narrowband, SNR, baselines, MOT).
• How-to-adapt guide in README: swap satellite / frequency band / target templates / your own model.
• Bug fix: run_demo.sh venv path (was pointing at a non-existent source_code/.venv).
• Bilingual README (EN / 中文) restructured with a 'For Peers (TL;DR)' section.

✅ Verified Locally

• make verify: physics ALL PASS (ISS altitude 418 km / 7.66 km/s / period 92.9 min)
• make demo: sensing–communication closed loop OK (+250% comm gain, 83.6% of oracle)

🎬 Demo Assets (attached)

• demo_animation.gif — sensing–communication closed-loop animation
• mot_animation.gif — 10-target 3D multi-object tracking animation
• demo_live.html — interactive multi-scene HTML player (double-click to open)
• mot_3d.html — interactive 3D MOT scene (rotate / zoom)

Made with Proma · GitHub

v1.0.0 — Space ISAC Engineering Showcase

🛰️ IRS-Diffu-ISAC v1.0.0 — Space ISAC Engineering Showcase

RIS 辅助通感一体化（ISAC）· 从扩散模型 3D 重建到太空 ISAC（ISAC-NTN）工程闭环

首个正式版本 🎉：从"室内近程理论仿真"升级为"真实轨道 + 动态 RIS + 感知-通信闭环 + 多目标 3D 追踪"的完整工程系统，全部物理验证可复现。

✨ 核心能力

能力	结果
🛰️ 真实 LEO 轨道仿真（SGP4）	ISS 高度 418 km / 速度 7.66 km/s，与真实值吻合
📡 动态 RIS 相位跟踪	逐帧跟踪功率 +283%；量化重构速率 vs 相干时间权衡
🎯 感知-通信闭环	分类 83%，通信增益 +233%（oracle 达成率 98%）
🚁 3D 多目标追踪（MOT）	10 目标 5 类，无人机空中 + 地面目标贴地锁定
📻 SDR 数据接口	IQ 格式 + 导入管线（保真 0.998），硬件预留
🧪 物理验证	轨道 / 多普勒 / 信道 / 多轨道 / Ka 频段全 PASS

🎬 快速体验

60 秒零配置体验：真实卫星轨道验证 → 感知-通信闭环 → 演示动画。

📦 安装

git clone https://github.com/ConradLu2740/IRS-Diffu-ISAC.git
cd IRS-Diffu-ISAC
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
cd source_code/isac_sat && ../../.venv/bin/python verify_sat.py

🔗 链接

• 设计文档：space_isac_design.md
• 交互式 3D 演示：mot_3d.html
• 贡献指南：CONTRIBUTING.md

---

Made with Proma · GitHub

v0.1.0 — Sensing-Communication Closed-Loop Demo

🛰️ 星-地 ISAC 感知-通信闭环 Demo 版

RIS 辅助通感一体化（ISAC）工程化第一版：真实 LEO 卫星轨道仿真 → 通信信号感知目标 → IRS 自动配置 → 通信质量提升，全流程可视化。

✨ 核心能力

• 真实轨道仿真：SGP4（ISS / Starlink TLE）、动态几何、多普勒/时延，物理验证与真实轨道吻合
• RIS 动态相位跟踪：解析对齐，逐帧跟踪功率 +283%；分段跟踪权衡（重构速率 vs 相干时间）
• 感知-通信闭环：分类 + 定位 → IRS 指向 → 通信增益 +233%（oracle 达成率 98%）
• 多目标感知：检测 + 定位，IRS 指向增益 +289%
• 实时演示：HTML 播放器（多场景/UTC 时间轴）+ GIF 动画

🚀 快速开始

pip install -r requirements.txt
cd source_code/isac_sat
../../.venv/bin/python verify_sat.py       # 物理验证
bash run_demo.sh                            # 一键闭环 demo
../../.venv/bin/python demo_live.py --n_scenes 3   # HTML 播放器

📂 结构

• source_code/isac_sat/：星-地 ISAC + 感知 + demo（活跃）
• source_code/legacy/：原项目（RIS + 扩散模型 3D 重建）
• space_isac_design.md：详细设计文档

⚠️ 诚实标注

星-地远场 + 简单对称模板下绝对姿态估计不可行（物理上界）；单站多目标分类受信号混合限制。