v3: resize-convolution upsampling — removes checkerboard artifacts

This commit is contained in:
2026-06-09 07:27:14 +08:00
parent d25fd5eaa8
commit daf3d68247
12 changed files with 195 additions and 186 deletions

1
.gitignore vendored
View File

@@ -9,3 +9,4 @@ __pycache__/
*.onnx *.onnx
checkpoints_diag/ checkpoints_diag/
checkpoints_v2/ checkpoints_v2/
checkpoints_v3/

Binary file not shown.

After

Width:  |  Height:  |  Size: 308 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 198 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 274 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 202 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 356 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 273 KiB

View File

@@ -1,45 +1,50 @@
""" """
export_onnx.py — export the trained U-Net to ONNX and verify it matches PyTorch. export_onnx.py — export a trained U-Net to ONNX, auto-detecting channels (v1=2, v2=3).
Run from the project root: python src\\export_onnx.py
python src\\export_onnx.py --ckpt checkpoints\\best.pt --out web\\radio_unet_v1.onnx
python src\\export_onnx.py --ckpt checkpoints_v2\\best.pt --out web\\radio_unet_v2.onnx
""" """
import argparse
import numpy as np import numpy as np
import torch import torch
from model import UNet from model import UNet
from dataset import RadioMapSeerDataset from dataset import RadioMapSeerDataset
CKPT = "checkpoints/best.pt"
OUT = "web/radio_unet.onnx"
# --- load the trained model --- def main():
ckpt = torch.load(CKPT, map_location="cpu", weights_only=False) p = argparse.ArgumentParser()
base = ckpt.get("args", {}).get("base", 64) p.add_argument("--ckpt", default="checkpoints/best.pt")
model = UNet(2, 1, base=base) p.add_argument("--out", default="web/radio_unet.onnx")
model.load_state_dict(ckpt["model_state"]) args = p.parse_args()
model.eval()
# --- export to ONNX (fixed 1x2x256x256 input) --- ckpt = torch.load(args.ckpt, map_location="cpu", weights_only=False)
dummy = torch.randn(1, 2, 256, 256) cargs = ckpt.get("args", {})
torch.onnx.export( base = cargs.get("base", 64)
model, dummy, OUT, add_dist = bool(cargs.get("distance", False))
in_ch = 3 if add_dist else 2
model = UNet(in_channels=in_ch, out_channels=1, base=base)
model.load_state_dict(ckpt["model_state"])
model.eval()
print(f"Loaded {args.ckpt} | in_channels={in_ch} | distance={add_dist}")
dummy = torch.randn(1, in_ch, 256, 256)
torch.onnx.export(model, dummy, args.out,
input_names=["input"], output_names=["coverage"], input_names=["input"], output_names=["coverage"],
opset_version=17, opset_version=17)
) print(f"Exported {args.out}")
print(f"Exported {OUT}")
# --- verify ONNX output matches PyTorch on a real test sample --- import onnxruntime as ort
import onnxruntime as ort ds = RadioMapSeerDataset(split="test", img_size=256, add_distance=add_dist)
x, _ = ds[0]
xb = x.unsqueeze(0).numpy().astype(np.float32)
with torch.no_grad():
t_out = model(x.unsqueeze(0)).numpy()
sess = ort.InferenceSession(args.out, providers=["CPUExecutionProvider"])
o_out = sess.run(["coverage"], {"input": xb})[0]
print(f"Max |PyTorch - ONNX|: {np.max(np.abs(t_out - o_out)):.2e}")
ds = RadioMapSeerDataset(split="test", img_size=256)
x, _ = ds[0]
xb = x.unsqueeze(0).numpy().astype(np.float32)
with torch.no_grad(): if __name__ == "__main__":
torch_out = model(x.unsqueeze(0)).numpy() main()
sess = ort.InferenceSession(OUT, providers=["CPUExecutionProvider"])
onnx_out = sess.run(["coverage"], {"input": xb})[0]
max_diff = float(np.max(np.abs(torch_out - onnx_out)))
print(f"Max |PyTorch - ONNX| on a test sample: {max_diff:.2e}")
print("OK — outputs match" if max_diff < 1e-3 else "WARNING: large mismatch, stop and check")

View File

@@ -42,19 +42,26 @@ class Down(nn.Module):
class Up(nn.Module): class Up(nn.Module):
"""Upsample, concatenate the skip connection, then DoubleConv.""" """Upsample, concatenate the skip connection, then DoubleConv."""
def __init__(self, in_ch, skip_ch, out_ch): def __init__(self, in_ch, skip_ch, out_ch, up_mode="deconv"):
super().__init__() super().__init__()
if up_mode == "resize":
# bilinear upsample + 1x1 conv — uniform, so no checkerboard artifacts
self.up = nn.Sequential(
nn.Upsample(scale_factor=2, mode="bilinear", align_corners=False),
nn.Conv2d(in_ch, in_ch // 2, kernel_size=1),
)
else: # "deconv" (v1/v2): transposed convolution
self.up = nn.ConvTranspose2d(in_ch, in_ch // 2, kernel_size=2, stride=2) self.up = nn.ConvTranspose2d(in_ch, in_ch // 2, kernel_size=2, stride=2)
self.conv = DoubleConv(in_ch // 2 + skip_ch, out_ch) self.conv = DoubleConv(in_ch // 2 + skip_ch, out_ch)
def forward(self, x, skip): def forward(self, x, skip):
x = self.up(x) x = self.up(x)
x = torch.cat([skip, x], dim=1) # skip connection x = torch.cat([skip, x], dim=1)
return self.conv(x) return self.conv(x)
class UNet(nn.Module): class UNet(nn.Module):
def __init__(self, in_channels=2, out_channels=1, base=64): def __init__(self, in_channels=2, out_channels=1, base=64, up_mode="deconv"):
super().__init__() super().__init__()
self.inc = DoubleConv(in_channels, base) # 256 self.inc = DoubleConv(in_channels, base) # 256
self.down1 = Down(base, base * 2) # 128 self.down1 = Down(base, base * 2) # 128
@@ -62,10 +69,10 @@ class UNet(nn.Module):
self.down3 = Down(base * 4, base * 8) # 32 self.down3 = Down(base * 4, base * 8) # 32
self.down4 = Down(base * 8, base * 8) # 16 (bottleneck) self.down4 = Down(base * 8, base * 8) # 16 (bottleneck)
self.up1 = Up(base * 8, base * 8, base * 4) self.up1 = Up(base * 8, base * 8, base * 4, up_mode)
self.up2 = Up(base * 4, base * 4, base * 2) self.up2 = Up(base * 4, base * 4, base * 2, up_mode)
self.up3 = Up(base * 2, base * 2, base) self.up3 = Up(base * 2, base * 2, base, up_mode)
self.up4 = Up(base, base, base) self.up4 = Up(base, base, base, up_mode)
self.outc = nn.Conv2d(base, out_channels, kernel_size=1) self.outc = nn.Conv2d(base, out_channels, kernel_size=1)

View File

@@ -53,6 +53,8 @@ def main():
help="v2: add a distance-to-transmitter input channel") help="v2: add a distance-to-transmitter input channel")
p.add_argument("--compile", action="store_true", p.add_argument("--compile", action="store_true",
help="wrap model in torch.compile (optional; flaky on Windows)") help="wrap model in torch.compile (optional; flaky on Windows)")
p.add_argument("--up-mode", default="deconv", choices=["deconv", "resize"],
help="v3: 'resize' = bilinear upsample + conv (removes checkerboard)")
args = p.parse_args() args = p.parse_args()
device = "cuda" if torch.cuda.is_available() else "cpu" device = "cuda" if torch.cuda.is_available() else "cpu"
@@ -72,7 +74,7 @@ def main():
val_loader = DataLoader(val_ds, shuffle=False, **dl_kwargs) val_loader = DataLoader(val_ds, shuffle=False, **dl_kwargs)
in_ch = 3 if args.distance else 2 in_ch = 3 if args.distance else 2
model = UNet(in_channels=in_ch, out_channels=1, base=args.base).to(device) model = UNet(in_channels=in_ch, out_channels=1, base=args.base, up_mode=args.up_mode).to(device)
net = torch.compile(model) if args.compile else model net = torch.compile(model) if args.compile else model
criterion = nn.MSELoss() criterion = nn.MSELoss()
optimizer = torch.optim.Adam(model.parameters(), lr=args.lr) optimizer = torch.optim.Adam(model.parameters(), lr=args.lr)

View File

@@ -34,8 +34,9 @@ def main():
cargs = ckpt.get("args", {}) cargs = ckpt.get("args", {})
base = cargs.get("base", 64) base = cargs.get("base", 64)
add_dist = bool(cargs.get("distance", False)) add_dist = bool(cargs.get("distance", False))
up_mode = cargs.get("up_mode", "deconv")
in_ch = 3 if add_dist else 2 in_ch = 3 if add_dist else 2
model = UNet(in_channels=in_ch, out_channels=1, base=base).to(device) model = UNet(in_channels=in_ch, out_channels=1, base=base, up_mode=up_mode).to(device)
model.load_state_dict(ckpt["model_state"]) model.load_state_dict(ckpt["model_state"])
model.eval() model.eval()
print(f"Loaded {args.ckpt} | in_channels={in_ch} | distance={add_dist} | " print(f"Loaded {args.ckpt} | in_channels={in_ch} | distance={add_dist} | "

View File

@@ -6,43 +6,40 @@
<title>Radio Coverage Prediction — Deep Learning Demo</title> <title>Radio Coverage Prediction — Deep Learning Demo</title>
<script src="https://cdn.jsdelivr.net/npm/onnxruntime-web/dist/ort.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/onnxruntime-web/dist/ort.min.js"></script>
<style> <style>
:root { --bg:#0f1115; --panel:#1a1d24; --line:#2a2e37; --fg:#e6e8eb; --muted:#9aa0a6; --accent:#3ddc84; } :root { --bg:#0f1115; --panel:#1a1d24; --line:#2a2e37; --fg:#e6e8eb; --muted:#9aa0a6; --accent:#3ddc84; --warn:#f0a93d; }
* { box-sizing:border-box; } * { box-sizing:border-box; }
body { margin:0; background:var(--bg); color:var(--fg); body { margin:0; background:var(--bg); color:var(--fg);
font-family: system-ui,-apple-system,"Segoe UI","PingFang SC","Microsoft YaHei",Roboto,sans-serif; line-height:1.6; } font-family: system-ui,-apple-system,"Segoe UI","PingFang SC","Microsoft YaHei",Roboto,sans-serif; line-height:1.6; }
.wrap { max-width:920px; margin:0 auto; padding:28px 20px 72px; } .wrap { max-width:920px; margin:0 auto; padding:28px 20px 72px; }
.topbar { display:flex; justify-content:flex-end; gap:6px; margin-bottom:18px; } .topbar { display:flex; justify-content:flex-end; gap:6px; margin-bottom:16px; }
.lang { cursor:pointer; border:1px solid var(--line); background:transparent; color:var(--muted); .lang { cursor:pointer; border:1px solid var(--line); background:transparent; color:var(--muted); padding:5px 12px; border-radius:20px; font-size:.85rem; }
padding:5px 12px; border-radius:20px; font-size:.85rem; } .lang.active { background:var(--accent); color:#0f1115; border-color:var(--accent); font-weight:500; }
.lang.active { background:var(--accent); color:#0f1115; border-color:var(--accent); font-weight:600; }
h1 { font-size:1.7rem; margin:0 0 6px; } h1 { font-size:1.7rem; margin:0 0 6px; }
.sub { color:var(--muted); margin:0 0 28px; font-size:1.05rem; } .sub { color:var(--muted); margin:0 0 24px; }
h2 { font-size:1.15rem; margin:36px 0 10px; } h2 { font-size:1.15rem; margin:34px 0 10px; }
p { margin:0 0 12px; } .vers { display:flex; gap:10px; flex-wrap:wrap; margin:0 0 14px; }
.metrics { display:flex; gap:14px; flex-wrap:wrap; margin:18px 0 8px; } .ver-btn { cursor:pointer; border:1px solid var(--line); background:var(--panel); color:var(--fg);
.metric { background:var(--panel); border-radius:10px; padding:12px 16px; flex:1 1 150px; } padding:10px 18px; border-radius:10px; font-size:.95rem; font-weight:500; }
.metric .v { font-size:1.5rem; font-weight:700; color:var(--accent); } .ver-btn.active { background:var(--accent); color:#0f1115; border-color:var(--accent); }
.metric .l { color:var(--muted); font-size:.85rem; } .ver-btn:disabled { opacity:.4; cursor:not-allowed; }
.demo { background:var(--panel); border-radius:14px; padding:20px; margin-top:14px; } .notice { background:var(--panel); border-left:3px solid var(--accent); border-radius:0 8px 8px 0;
padding:14px 16px; margin:0 0 18px; font-size:.95rem; }
.metricbar { display:flex; gap:14px; flex-wrap:wrap; margin:0 0 8px; }
.metric { background:var(--panel); border-radius:10px; padding:10px 16px; }
.metric .v { font-size:1.4rem; font-weight:500; color:var(--accent); }
.metric .l { color:var(--muted); font-size:.82rem; }
.demo { background:var(--panel); border-radius:14px; padding:20px; }
.row { display:flex; gap:24px; flex-wrap:wrap; align-items:flex-start; } .row { display:flex; gap:24px; flex-wrap:wrap; align-items:flex-start; }
.col { flex:1 1 256px; } .col { flex:1 1 256px; }
canvas { width:100%; max-width:340px; height:auto; image-rendering:pixelated; canvas { width:100%; max-width:340px; height:auto; image-rendering:pixelated; border-radius:8px; background:#000; cursor:crosshair; display:block; }
border-radius:8px; background:#000; cursor:crosshair; display:block; } .col h3 { font-size:.95rem; margin:0 0 8px; font-weight:500; }
.col h3 { font-size:.95rem; margin:0 0 8px; font-weight:600; }
.controls { margin:0 0 18px; display:flex; gap:12px; align-items:center; flex-wrap:wrap; } .controls { margin:0 0 18px; display:flex; gap:12px; align-items:center; flex-wrap:wrap; }
select { background:#0f1115; color:var(--fg); border:1px solid var(--line); border-radius:8px; padding:8px 10px; } select { background:#0f1115; color:var(--fg); border:1px solid var(--line); border-radius:8px; padding:8px 10px; }
.status { color:var(--muted); font-size:.9rem; margin-top:14px; min-height:1.2em; } .status { color:var(--muted); font-size:.9rem; margin-top:14px; min-height:1.2em; }
.hint { color:var(--muted); font-size:.85rem; } .hint { color:var(--muted); font-size:.85rem; }
.legend { height:12px; border-radius:6px; margin-top:6px; .legend { height:12px; border-radius:6px; margin-top:6px; background:linear-gradient(90deg,#440154,#3b528b,#21918c,#5ec962,#fde725); }
background:linear-gradient(90deg,#440154,#3b528b,#21918c,#5ec962,#fde725); }
.legend-labels { display:flex; justify-content:space-between; color:var(--muted); font-size:.75rem; } .legend-labels { display:flex; justify-content:space-between; color:var(--muted); font-size:.75rem; }
.specs { border-top:1px solid var(--line); margin-top:8px; } footer { margin-top:36px; color:var(--muted); font-size:.8rem; border-top:1px solid var(--line); padding-top:16px; }
.spec { display:flex; gap:16px; padding:11px 0; border-bottom:1px solid var(--line); }
.spec .k { flex:0 0 130px; color:var(--accent); font-size:.9rem; }
.spec .val { color:var(--fg); font-size:.95rem; }
.tags { display:flex; gap:8px; flex-wrap:wrap; margin-top:10px; }
.tag { background:var(--panel); border:1px solid var(--line); border-radius:20px; padding:5px 12px; font-size:.85rem; color:var(--muted); }
footer { margin-top:40px; color:var(--muted); font-size:.8rem; border-top:1px solid var(--line); padding-top:16px; }
</style> </style>
</head> </head>
<body> <body>
@@ -55,21 +52,18 @@
<h1 data-i18n="title"></h1> <h1 data-i18n="title"></h1>
<p class="sub" data-i18n="subtitle"></p> <p class="sub" data-i18n="subtitle"></p>
<div class="metrics"> <h2 data-i18n="ver_h"></h2>
<div class="metric"><div class="v">4.1 dB</div><div class="l" data-i18n="m_rmse"></div></div> <div class="vers">
<div class="metric"><div class="v">71%</div><div class="l" data-i18n="m_improve"></div></div> <button class="ver-btn" data-v="v1" data-i18n="btn_v1"></button>
<div class="metric"><div class="v">~13M</div><div class="l" data-i18n="m_params"></div></div> <button class="ver-btn" data-v="v2" data-i18n="btn_v2"></button>
<div class="metric"><div class="v">&lt;2 s</div><div class="l" data-i18n="m_speed"></div></div> <button class="ver-btn" data-v="v3" data-i18n="btn_v3" disabled></button>
</div>
<div class="notice" id="verNotice"></div>
<div class="metricbar">
<div class="metric"><div class="v" id="verMetric"></div><div class="l" data-i18n="m_error"></div></div>
</div> </div>
<h2 data-i18n="problem_h"></h2>
<p data-i18n="problem_p"></p>
<h2 data-i18n="how_h"></h2>
<p data-i18n="how_p"></p>
<h2 data-i18n="demo_h"></h2> <h2 data-i18n="demo_h"></h2>
<p data-i18n="demo_p"></p>
<div class="demo"> <div class="demo">
<div class="controls"> <div class="controls">
<label for="mapSel" data-i18n="select_label"></label> <label for="mapSel" data-i18n="select_label"></label>
@@ -91,23 +85,8 @@
<div class="status" id="status"></div> <div class="status" id="status"></div>
</div> </div>
<h2 data-i18n="results_h"></h2> <h2 data-i18n="how_h"></h2>
<p data-i18n="results_p"></p> <p data-i18n="how_p"></p>
<h2 data-i18n="hood_h"></h2>
<div class="specs">
<div class="spec"><div class="k" data-i18n="s_data_k"></div><div class="val" data-i18n="s_data_v"></div></div>
<div class="spec"><div class="k" data-i18n="s_eval_k"></div><div class="val" data-i18n="s_eval_v"></div></div>
<div class="spec"><div class="k" data-i18n="s_model_k"></div><div class="val" data-i18n="s_model_v"></div></div>
<div class="spec"><div class="k" data-i18n="s_train_k"></div><div class="val" data-i18n="s_train_v"></div></div>
<div class="spec"><div class="k" data-i18n="s_deploy_k"></div><div class="val" data-i18n="s_deploy_v"></div></div>
</div>
<h2 data-i18n="stack_h"></h2>
<div class="tags">
<span class="tag">Python</span><span class="tag">PyTorch</span><span class="tag">U-Net / CNN</span>
<span class="tag">ONNX</span><span class="tag">ONNX Runtime Web</span><span class="tag">NumPy</span>
</div>
<footer data-i18n="footer"></footer> <footer data-i18n="footer"></footer>
</div> </div>
@@ -116,88 +95,60 @@
const T = { const T = {
en: { en: {
title: "Predicting Wireless Coverage with Deep Learning", title: "Predicting Wireless Coverage with Deep Learning",
subtitle: "A U-Net neural network predicts a base station's downlink signal coverage across a city — running live in your browser.", subtitle: "A U-Net predicts a base station's signal coverage across a city — running live in your browser. Switch between model versions to see how it improved.",
m_rmse: "RMSE on unseen cities", m_improve: "lower error vs. classical model", ver_h: "Model version",
m_params: "parameters", m_speed: "in-browser inference", btn_v1: "v1 · baseline", btn_v2: "v2 · distance fix", btn_v3: "v3 · soon",
problem_h: "The problem", m_error: "RMSE on unseen cities",
problem_p: "Before building a base station, mobile operators need to know how its signal will spread across a city — where coverage is strong, and where buildings cast \"shadows\" that block it. Traditionally this is done either with fast but crude empirical formulas (like the Hata model) that ignore building geometry entirely, or with slow, physically accurate ray-tracing simulations that can take minutes per map. This project asks: can a neural network match the accuracy of the slow simulation, but in milliseconds?", notice_v1: "Baseline (2-channel input: buildings + transmitter). Known issue: coverage cuts off in a square around the transmitter — the far field stays blank because the network can't propagate the source that far.",
how_h: "How it works", notice_v2: "Adds a distance-to-transmitter input channel (3-channel). Fixed: the square cutoff — coverage now spans the whole map, with far-field rays and distant building shadows. Known issue: faint checkerboard texture in smooth areas, from transposed-convolution upsampling.",
how_p: "The model is a U-Net — a convolutional encoder-decoder with skip connections. It takes two inputs as image channels (the city's building layout and the transmitter's location) and outputs one image: the predicted coverage map, where bright means strong signal and dark means weak. The network was never given any propagation equations — it learned signal falloff with distance and shadowing behind buildings entirely from examples.", notice_v3: "In progress. Replaces transposed-convolution upsampling with resize-convolution to remove the checkerboard texture. Not yet available.",
demo_h: "Try it yourself", demo_h: "Try it yourself",
demo_p: "Pick a city layout and click anywhere to place a transmitter. The model runs entirely in your browser and renders the predicted coverage in a fraction of a second. Place it near buildings and watch the signal shadows form.",
select_label: "City layout:", click_hint: "Click the map to place a transmitter.", select_label: "City layout:", click_hint: "Click the map to place a transmitter.",
input_title: "City map — click to place transmitter", output_title: "Predicted coverage", input_title: "City map — click to place transmitter", output_title: "Predicted coverage",
legend_weak: "weak", legend_strong: "strong", legend_weak: "weak", legend_strong: "strong",
results_h: "Results", how_h: "How it works",
results_p: "Evaluated on test cities the model never saw during training, it reaches 4.1 dB RMSE — a 71% reduction in error compared to a classical log-distance path-loss model (14.3 dB), which can only model distance and is blind to buildings. That gap is exactly the value the network adds: it learned to account for the building shadowing the classical model cannot represent.", how_p: "The model takes the building layout and the transmitter location as image channels and outputs a coverage heatmap, learned from the public RadioMapSeer dataset (5.9 GHz urban propagation). It was given no propagation equations — it learned signal falloff and building shadowing from data. The model runs entirely in your browser via ONNX Runtime Web; nothing is sent to a server.",
hood_h: "Under the hood", footer: "Dataset: RadioMapSeer (Yapar et al., 2022), CC BY 4.0. Independent portfolio project. Error reported on held-out test cities.",
s_data_k: "Dataset", s_data_v: "RadioMapSeer — 56,000+ ray-traced coverage maps from real cities (Berlin, London, Tel Aviv…) at 5.9 GHz.", st_loading: "Loading model…", st_ready: "Pick a layout and click to place a transmitter.",
s_eval_k: "Evaluation", s_eval_v: "Train/test split by city, so the model is measured on building layouts it has never seen.",
s_model_k: "Model", s_model_v: "U-Net CNN, ~13M parameters, image-to-image regression with MSE loss and a sigmoid output.",
s_train_k: "Training", s_train_v: "PyTorch on a single NVIDIA RTX 2080, automatic mixed precision (AMP), Adam optimizer.",
s_deploy_k: "Deployment", s_deploy_v: "Exported to ONNX and run fully client-side via ONNX Runtime Web — no server required.",
stack_h: "Tech stack",
footer: "Dataset: RadioMapSeer (Yapar et al., 2022), CC BY 4.0. Independent portfolio project.",
st_loading: "Loading model… (downloads once, ~50 MB)",
st_ready: "Model ready. Pick a layout and click to place a transmitter.",
st_running: "Running inference…", st_running: "Running inference…",
st_done: (ms) => "Coverage predicted in " + ms + " ms. Click again to move the transmitter.", st_done: (ms) => "Predicted in " + ms + " ms. Click again to move the transmitter.",
st_error: (m) => "Error: " + m st_error: (m) => "Error: " + m
}, },
zh: { zh: {
title: "基于深度学习的无线信号覆盖预测", title: "基于深度学习的无线信号覆盖预测",
subtitle: "一个 U-Net 神经网络直接预测基站在城市中的下行信号覆盖——并在你的浏览器中实时运行。", subtitle: "一个 U-Net 在你的浏览器中实时预测基站的信号覆盖。切换不同模型版本,看看它是如何一步步改进的。",
m_rmse: "未见城市上的 RMSE", m_improve: "较经典模型误差降低", ver_h: "模型版本",
m_params: "参数量", m_speed: "浏览器端推理", btn_v1: "v1 · 基线", btn_v2: "v2 · 距离修复", btn_v3: "v3 · 即将推出",
problem_h: "问题背景", m_error: "未见城市上的 RMSE",
problem_p: "在建设基站之前,移动运营商需要预估信号在城市中的传播情况——哪里覆盖良好,哪里因建筑遮挡形成信号「阴影」。传统方法要么使用快速但粗糙的经验公式(如 Hata 模型),完全忽略建筑几何结构;要么使用物理精确但缓慢的射线追踪仿真,每张地图可能耗时数分钟。本项目要回答的问题是:神经网络能否在毫秒级时间内,达到接近慢速仿真的预测精度?", notice_v1: "基线模型2 通道输入:建筑 + 发射机)。已知问题:覆盖在发射机周围呈方形截断——远场为空白,因为网络无法将信号源的影响传播到远处。",
how_h: "实现原理", notice_v2: "新增「到发射机的距离」输入通道3 通道)。已修复:方形截断——覆盖现已贯穿整张地图,远场射线与远处建筑阴影都能呈现。已知问题:平滑区域出现轻微棋盘格纹理,来自转置卷积上采样。",
how_p: "模型是一个 U-Net——带跳跃连接的卷积编码器-解码器。它以两个图像通道作为输入(城市建筑布局与发射机位置),输出一张图像:预测的信号覆盖热力图,越亮表示信号越强,越暗表示越弱。网络从未被告知任何传播公式,它完全从样本数据中自行学会了信号随距离衰减、以及在建筑后方形成阴影的规律。", notice_v3: "开发中。用 resize 卷积替换转置卷积上采样,以消除棋盘格纹理。暂未上线。",
demo_h: "在线体验", demo_h: "在线体验",
demo_p: "选择一个城市布局,点击任意位置放置发射机。模型完全在你的浏览器中运行,不到一秒即可渲染出预测覆盖。把发射机放在建筑附近,观察信号阴影是如何形成的。",
select_label: "城市布局:", click_hint: "点击地图以放置发射机。", select_label: "城市布局:", click_hint: "点击地图以放置发射机。",
input_title: "城市地图——点击放置发射机", output_title: "预测覆盖", input_title: "城市地图——点击放置发射机", output_title: "预测覆盖",
legend_weak: "弱", legend_strong: "强", legend_weak: "弱", legend_strong: "强",
results_h: "实验结果", how_h: "实现原理",
results_p: "在训练中从未见过的测试城市上评估,模型达到 4.1 dB 的均方根误差RMSE——相比只能建模距离、对建筑「视而不见」的经典对数距离路径损耗模型14.3 dB误差降低了 71%。这一差距正是神经网络的价值所在:它学会了经典模型无法表达的建筑遮蔽效应。", how_p: "模型以建筑布局和发射机位置作为图像通道输入,输出覆盖热力图,训练自公开的 RadioMapSeer 数据集5.9 GHz 城市传播)。它没有被告知任何传播公式,完全从数据中学会了信号衰减与建筑遮蔽。模型通过 ONNX Runtime Web 完全在你的浏览器中运行,不会向服务器发送任何数据。",
hood_h: "技术细节", footer: "数据集RadioMapSeerYapar 等2022CC BY 4.0 许可。独立作品集项目。误差基于留出的测试城市。",
s_data_k: "数据集", s_data_v: "RadioMapSeer——基于真实城市柏林、伦敦、特拉维夫等、5.9 GHz、56,000+ 张射线追踪仿真覆盖图。", st_loading: "正在加载模型…", st_ready: "选择布局并点击放置发射机。",
s_eval_k: "评估方式", s_eval_v: "按城市划分训练/测试集,模型在从未见过的建筑布局上接受评估。",
s_model_k: "模型", s_model_v: "U-Net 卷积网络,约 1300 万参数图像到图像回归MSE 损失 + Sigmoid 输出。",
s_train_k: "训练", s_train_v: "PyTorch单张 NVIDIA RTX 2080混合精度AMPAdam 优化器。",
s_deploy_k: "部署", s_deploy_v: "导出为 ONNX通过 ONNX Runtime Web 完全在浏览器端运行,无需服务器。",
stack_h: "技术栈",
footer: "数据集RadioMapSeerYapar 等2022CC BY 4.0 许可。独立作品集项目。",
st_loading: "正在加载模型…(仅首次下载,约 50 MB",
st_ready: "模型已就绪。选择布局并点击放置发射机。",
st_running: "正在推理…", st_running: "正在推理…",
st_done: (ms) => "推理完成,用时 " + ms + " 毫秒。再次点击可移动发射机。", st_done: (ms) => "推理完成,用时 " + ms + " 毫秒。再次点击可移动发射机。",
st_error: (m) => "错误:" + m st_error: (m) => "错误:" + m
} }
}; };
let currentLang = (navigator.language || "en").toLowerCase().startsWith("zh") ? "zh" : "en"; const VERSIONS = {
v1: { model: "radio_unet_v1.onnx", channels: 2, available: true },
v2: { model: "radio_unet_v2.onnx", channels: 3, available: true },
v3: { model: "radio_unet_v3.onnx", channels: 3, available: false },
};
const METRICS = { v1: "0.052", v2: "0.034", v3: "—" };
function applyLang(lang){
currentLang = lang;
document.documentElement.lang = (lang === "zh") ? "zh" : "en";
document.querySelectorAll("[data-i18n]").forEach(el=>{
const v = T[lang][el.getAttribute("data-i18n")];
if (typeof v === "string") el.textContent = v;
});
document.querySelectorAll(".lang").forEach(b=>
b.classList.toggle("active", b.getAttribute("data-lang") === lang));
// refresh the status line in the new language
if (!session) statusEl.textContent = T[lang].st_loading;
else if (!txRC) statusEl.textContent = T[lang].st_ready;
}
document.querySelectorAll(".lang").forEach(b=>
b.addEventListener("click", ()=> applyLang(b.getAttribute("data-lang"))));
// ---------- demo logic ----------
const MAP_IDS = [600, 615, 630, 645, 660, 675];
const SIZE = 256; const SIZE = 256;
let session = null, buildings = null, txRC = null; let currentLang = (navigator.language || "en").toLowerCase().startsWith("zh") ? "zh" : "en";
let activeVersion = "v2";
const sessions = {};
let buildings = null, txRC = null;
const statusEl = document.getElementById("status"); const statusEl = document.getElementById("status");
const inCanvas = document.getElementById("inputCanvas"); const inCanvas = document.getElementById("inputCanvas");
@@ -215,22 +166,37 @@ function viridis(t){
return [a[0]+(b[0]-a[0])*f, a[1]+(b[1]-a[1])*f, a[2]+(b[2]-a[2])*f]; return [a[0]+(b[0]-a[0])*f, a[1]+(b[1]-a[1])*f, a[2]+(b[2]-a[2])*f];
} }
async function init(){ function applyLang(lang){
applyLang(currentLang); currentLang = lang;
MAP_IDS.forEach((id,i)=>{ document.documentElement.lang = (lang === "zh") ? "zh" : "en";
const o = document.createElement("option"); document.querySelectorAll("[data-i18n]").forEach(el=>{
o.value = id; o.textContent = (currentLang==="zh"?"布局 ":"Layout ")+(i+1); const v = T[lang][el.getAttribute("data-i18n")];
mapSel.appendChild(o); if (typeof v === "string") el.textContent = v;
}); });
mapSel.addEventListener("change", ()=> loadMap(mapSel.value)); document.querySelectorAll(".lang").forEach(b=> b.classList.toggle("active", b.dataset.lang === lang));
updateVersionInfo();
}
ort.env.wasm.wasmPaths = "https://cdn.jsdelivr.net/npm/onnxruntime-web/dist/"; function updateVersionInfo(){
ort.env.wasm.numThreads = 1; document.getElementById("verNotice").textContent = T[currentLang]["notice_" + activeVersion];
document.getElementById("verMetric").textContent = METRICS[activeVersion];
document.querySelectorAll(".ver-btn").forEach(b=> b.classList.toggle("active", b.dataset.v === activeVersion));
}
async function loadSession(v){
if (sessions[v]) return sessions[v];
statusEl.textContent = T[currentLang].st_loading; statusEl.textContent = T[currentLang].st_loading;
session = await ort.InferenceSession.create("radio_unet.onnx", { executionProviders: ["wasm"] }); sessions[v] = await ort.InferenceSession.create(VERSIONS[v].model, { executionProviders: ["wasm"] });
statusEl.textContent = T[currentLang].st_ready; return sessions[v];
await loadMap(MAP_IDS[0]); }
async function setVersion(v){
if (!VERSIONS[v].available) return;
activeVersion = v;
updateVersionInfo();
await loadSession(v);
if (txRC) await runPrediction();
else statusEl.textContent = T[currentLang].st_ready;
} }
function loadMap(id){ function loadMap(id){
@@ -249,35 +215,35 @@ function loadMap(id){
}); });
} }
inCanvas.addEventListener("click", async (e)=>{ function buildInput(){
if(!session || !buildings) return; const ch = VERSIONS[activeVersion].channels;
const rect = inCanvas.getBoundingClientRect(); const input = new Float32Array(ch*SIZE*SIZE);
const col = Math.floor((e.clientX-rect.left) / rect.width * SIZE); input.set(buildings, 0); // channel 0: buildings
const row = Math.floor((e.clientY-rect.top ) / rect.height * SIZE);
txRC = [row, col];
await predict();
drawTxMarker();
});
async function predict(){
statusEl.textContent = T[currentLang].st_running;
const input = new Float32Array(2*SIZE*SIZE);
input.set(buildings, 0);
const [r,c] = txRC; const [r,c] = txRC;
input[SIZE*SIZE + r*SIZE + c] = 1.0; input[SIZE*SIZE + r*SIZE + c] = 1.0; // channel 1: transmitter
const tensor = new ort.Tensor("float32", input, [1,2,SIZE,SIZE]); if (ch === 3){ // channel 2: distance to Tx (v2/v3)
const off = 2*SIZE*SIZE, norm = Math.SQRT2 * SIZE;
for(let yy=0; yy<SIZE; yy++)
for(let xx=0; xx<SIZE; xx++)
input[off + yy*SIZE + xx] = Math.sqrt((yy-r)*(yy-r)+(xx-c)*(xx-c)) / norm;
}
return new ort.Tensor("float32", input, [1, ch, SIZE, SIZE]);
}
async function runPrediction(){
statusEl.textContent = T[currentLang].st_running;
const session = await loadSession(activeVersion);
const t0 = performance.now(); const t0 = performance.now();
const out = await session.run({ input: tensor }); const out = await session.run({ input: buildInput() });
const dt = performance.now()-t0; const dt = performance.now()-t0;
const cov = out.coverage.data; const cov = out.coverage.data;
const imgData = outCtx.createImageData(SIZE,SIZE); const imgData = outCtx.createImageData(SIZE,SIZE);
for(let p=0; p<SIZE*SIZE; p++){ for(let p=0; p<SIZE*SIZE; p++){
const [rr,gg,bb] = viridis(cov[p]); const [rr,gg,bb] = viridis(cov[p]);
imgData.data[p*4]=rr; imgData.data[p*4+1]=gg; imgData.data[p*4+2]=bb; imgData.data[p*4+3]=255; imgData.data[p*4]=rr; imgData.data[p*4+1]=gg; imgData.data[p*4+2]=bb; imgData.data[p*4+3]=255;
} }
outCtx.putImageData(imgData, 0, 0); outCtx.putImageData(imgData, 0, 0);
drawTxMarker();
statusEl.textContent = T[currentLang].st_done(dt.toFixed(0)); statusEl.textContent = T[currentLang].st_done(dt.toFixed(0));
} }
@@ -289,6 +255,33 @@ function drawTxMarker(){
outCtx.lineWidth = 1; outCtx.strokeStyle = "#fff"; outCtx.stroke(); outCtx.lineWidth = 1; outCtx.strokeStyle = "#fff"; outCtx.stroke();
} }
inCanvas.addEventListener("click", async (e)=>{
if(!buildings) return;
const rect = inCanvas.getBoundingClientRect();
txRC = [Math.floor((e.clientY-rect.top)/rect.height*SIZE),
Math.floor((e.clientX-rect.left)/rect.width*SIZE)];
await runPrediction();
});
async function init(){
[600,615,630,645,660,675].forEach((id,i)=>{
const o = document.createElement("option");
o.value = id; o.textContent = (currentLang==="zh"?"布局 ":"Layout ")+(i+1);
mapSel.appendChild(o);
});
mapSel.addEventListener("change", ()=> loadMap(mapSel.value));
document.querySelectorAll(".lang").forEach(b=> b.addEventListener("click", ()=> applyLang(b.dataset.lang)));
document.querySelectorAll(".ver-btn").forEach(b=> b.addEventListener("click", ()=> setVersion(b.dataset.v)));
ort.env.wasm.wasmPaths = "https://cdn.jsdelivr.net/npm/onnxruntime-web/dist/";
ort.env.wasm.numThreads = 1;
applyLang(currentLang);
await loadMap(600);
await loadSession(activeVersion);
statusEl.textContent = T[currentLang].st_ready;
}
init().catch(err=>{ statusEl.textContent = T[currentLang].st_error(err.message); console.error(err); }); init().catch(err=>{ statusEl.textContent = T[currentLang].st_error(err.message); console.error(err); });
</script> </script>
</body> </body>