ISOMORPH
收藏资源简介:
ISOMORPH是由多机构联合创建的首个公开多级物流网络数字孪生数据集,旨在填补供应链物流领域时间序列预测基准的空白。该数据集通过模拟器生成,包含两种目录规模(C=50和C=200),时间分辨率为每日,覆盖13个节点网络,生成的数据量庞大,并整合了30个场景滚动和20个拉丁超立方扰动,以捕捉真实供应链动态。数据集创建过程基于用户可配置的拓扑结构、需求过程和库存策略,通过离散时间马尔可夫链模型精确模拟库存、在途运输及需求估计等状态轨迹。其核心应用领域为供应链时间序列预测基准测试,能够有效评估基础模型在方差放大、级联瓶颈和制度转换等复杂动态下的性能,并为参数不确定性下的前向不确定性量化提供支持。
ISOMORPH is the first publicly available digital twin dataset of multi-level logistics networks jointly developed by multiple institutions, aiming to fill the gap in time series forecasting benchmarks within the supply chain logistics domain. Generated via a dedicated simulator, this dataset includes two catalog scales (C=50 and C=200), features a daily time resolution, covers a 13-node network, and contains a massive volume of generated data. It integrates 30 scenario rollouts and 20 Latin Hypercube Sampling perturbations to capture realistic supply chain dynamics. The dataset is built on user-configurable network topologies, demand processes and inventory policies, and accurately simulates state trajectories including inventory levels, in-transit shipments and demand estimates via discrete-time Markov chain (DTMC) models. Its core application lies in supply chain time series forecasting benchmarking, where it can effectively evaluate the performance of baseline models under complex dynamic scenarios such as variance amplification, cascading bottlenecks and regime shifts, and provide support for forward uncertainty quantification under parameter uncertainty.
ISOMORPH 数据集概述
基本信息
ISOMORPH 是一个多层级物流网络的数字孪生系统,同时包含零样本基础模型评估工具。该数据集及配套代码源自论文 ISOMORPH: A Supply Chain Digital Twin for Simulation, Dataset Generation, and Forecasting Benchmarks(arXiv: 2605.12768)。
数据集构成
发布内容
- 模拟器(
simulator/):生成所有已发布数据集的核心组件 - 零样本评估脚本(
eval/):支持四种时间序列基础模型(Chronos、Moirai、TimesFM、Lag-Llama)的滚动原点推理和指标计算 - 不确定性量化管道(
uq/):基于拉丁超立方体采样的前向不确定性量化 - 验证与图表脚本(
analysis/):牛鞭效应分析、基线概览、场景族系
数据目录结构
data/ ├── output_item50/ # 基线数据集(C=50) ├── output_item200/ # 基线数据集(C=200) ├── output_mixture/<scenario>/ # 27个场景卷展(C=50) └── output_uq/ ├── manifest.csv # K=20 LHS配置 └── perturb_k01 ... k20/ # 每个LHS样本对应一个卷展
每个卷展包含的文件
daily_records.csvshipments.csvservice_summary.csvinventory_history.csvbacklog_history.csvintransit_history.csvdemand_signals.npy、demand_signals_cols.txtscenario.json(CLI参数记录)- 可选:
edge_list.csv、edge_utilisation.npy、edge_saturation.npy
数据集约定
- 时间步长:1步 = 1天
- 时间跨度:T = 52,560 天
- 随机种子:所有已发布运行使用种子 2025
- 管道乘数:release中使用
m = 7
场景设计
基线数据集
- C = 50 和 C = 200 两种配置
- 使用
pipeline_mult 7和seed 2025
场景扫描(6种单变量扫描 + 2种复合场景)
| 扫描类型 | 扰动的参数 | 设置范围 |
|---|---|---|
| 漂移 (Drift) | phi_lo, phi_hi |
0.71, 0.86, 0.96, 0.99, 0.9993 |
| 冲击 (Shock) | shock_count_scale, shock_height_scale |
(0,1), (0.5,0.7), (1,1), (2,2), (3,4) |
| 爆发 (Burst) | burst_rate_scale, burst_height_scale |
(1,1), (1.5,2), (2,3), (3,4), (5,8) |
| 边容量 (Edge cap) | containers_scale |
0.3, 0.6, 1.0, 1.5, 2.5 |
| 缓冲区 (Buffer) | ss_scale |
0.1, 0.2, 0.5, 0.75, 1.0 |
| 提前期 (Lead time) | leadtime_scale |
1.0, 2.0, 5.0, 10.0, 20.0 |
复合场景
- chaos_compound:
phi_lo=0.96, phi_hi=0.98, shock_count_scale=3, shock_height_scale=4 - chaos_burst:
phi_lo=0.96, phi_hi=0.98, burst_rate_scale=3, burst_height_scale=4
评估方法
零样本基础模型评估
- 支持模型:Chronos、Moirai、TimesFM、Lag-Llama
- 评估参数:L=512, H=30, stride=30, num_samples=20(TimesFM使用确定性分位数头)
- 聚合指标:GIFT-Eval风格的MASE
不确定性量化
- 使用K=20的拉丁超立方体采样
- 对需求侧三个参数进行扰动(phi_AR, rho_G, rho_B)
- 生成预测包络图
验证分析
- 牛鞭效应分析:按节点和层级计算牛鞭比
- 基线概览图:展示系统整体行为
- 场景族系图:对比不同场景的系统响应
技术环境
- Python 3.12
- PyTorch + CUDA
- 单张NVIDIA RTX 2080 Ti即可运行所有实验
- Lag-Llama在L=512配置下最长运行时间不超过5小时/数据集
许可协议
- 代码:MIT License
- 生成的数据集和图表:CC-BY-4.0 License

- 1ISOMORPH: A Supply Chain Digital Twin for Simulation, Dataset Generation, and Forecasting Benchmarks马萨诸塞大学阿默斯特分校; SRI国际研究院; 北卡罗来纳大学; 加州理工学院 · 2026年



