遇见数据集

Isomorph2026/isomorph-supply-chain-benchmark

收藏
Hugging Face2026-05-19 更新2026-05-31 收录
官方服务:

资源简介:

# ISOMORPH Full The full ISOMORPH dataset release: 49 rollouts spanning two baselines, 27 mixture scenarios, and 20 Latin-hypercube UQ perturbations. We release multivariate logistics time-series data generated by a digital-twin (DT) simulator of a multi-echelon supply chain with an explicit routing network, with the underlying dynamics formulated as a Markov chain. All runs use seed 2025 and horizon T = 52,560. ## Overview The simulator advances a directed routing graph of factories, intermediate warehouses, and a customer-facing destination forward in discrete time. At each step, random Poisson customer demand arrives at the destination, is served from on-hand stock, and triggers replenishment along the network. The network is a directed graph $G=(\mathcal{N},\mathcal{E})$ with three node roles (factories, warehouses, destination), integer per-edge transit times $\tau_e$, and per-step volume capacities $K_e V_e$; Dijkstra's algorithm routes every shipment. The dynamics form a Markov chain $\xi_{t+1} = \Psi(\xi_t, y_t, L_t)$, where $\Psi$ is a deterministic transition map and $(y_t, L_t)$ are the only random inputs (Poisson customer demand and Gaussian source lead times). The demand intensity is a five-component sum: yearly seasonality, weekly seasonality, AR(1) drift, per-item bursts, and a shared macro shock that lifts every item's intensity simultaneously. The state vector $\xi_t$ records on-hand stock, backlog, outstanding orders, in-transit shipments, and a smoothed demand estimate at every location for every item. All released rollouts run on the same 13-node US topology (3 sources, 9 warehouses across 5 tiers, NYC destination). ## Contents | Item | Rollouts | Notes | |---------------------|---------:|--------------------------------------| | `manifest.csv` | 49 | One row per rollout | | `output_item50/` | 1 | Baseline, C = 50 | | `output_item200/` | 1 | Baseline, C = 200 | | `output_mixture/` | 27 | Scenario sweeps (see below) | | `output_uq/` | 20 | LHS perturbations (see below) | The C=50 baseline scenario is reachable via two manifest rows: `output_item50` (the standalone baseline) and `output_mixture/baseline` (the reference point for the mixture sweeps). Both describe the same simulator configuration. Approximate on-disk size: ~99 GB. ## Mixture scenarios (27) Six one-at-a-time sweeps plus two compound runs, all on the C = 50 catalogue. Each sweep varies one or two knobs; the rest stay at baseline. Per-row settings are in `manifest.csv`. | Sweep | Knobs perturbed | Settings (5 each) | |------------|----------------------------------------------|-----------------------------------------------| | 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 | The bold setting in each sweep is the baseline configuration for that knob (drift's baseline is φ^AR ≈ 0.9993; the other five sweeps have a 1.0 multiplier). All six baseline-equivalent settings produce the same simulation and share a single `output_mixture/baseline` rollout, so the 30 sweep cells materialise as 25 distinct sweep rollouts plus the shared baseline. With 2 compound scenarios, the mixture family contains 27 directories in total. Compound scenarios: | Scenario | Overrides | |------------------|------------------------------------------------------------------------| | `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` | ## UQ perturbations (20) K = 20 Latin-hypercube samples over three demand-side knobs: - `phi_AR` in [0.95, 0.999], applied to both `phi_lo` and `phi_hi` - `rho_G` in [0.5, 2.0], applied to both `shock_count_scale` and `shock_height_scale` - `rho_B` in [0.5, 2.0], applied to both `burst_rate_scale` and `burst_height_scale` Sampler: `scipy.stats.qmc.LatinHypercube(d=3, seed=2025)`. Per-sample values are in `manifest.csv` rows where `family = uq`. ## Manifest schema `manifest.csv` has one row per rollout and the following columns: | Column | Meaning | |------------------------|-------------------------------------------------------------| | `rollout` | Rollout name (matches the directory under this variant) | | `family` | One of `baseline`, `mixture`, `uq` | | `scenario` | Scenario label within the family | | `n_items` | Catalogue size C (50 or 200) | | `seed` | RNG seed (all released rollouts use 2025) | | `horizon` | Length T in days (52,560 for all released rollouts) | | `path` | Relative path to the rollout directory inside this variant | | `phi_lo`, `phi_hi` | AR(1) coefficient bounds for the demand process | | `shock_count_scale` | Multiplier on per-day shock count | | `shock_height_scale` | Multiplier on shock magnitude | | `burst_rate_scale` | Multiplier on burst arrival rate | | `burst_height_scale` | Multiplier on burst magnitude | | `containers_scale` | Multiplier on edge container counts (capacity) | | `ss_scale` | Multiplier on safety-stock thresholds | | `leadtime_scale` | Multiplier on edge lead times | Every cell is populated; knobs that the rollout did not perturb are filled with the simulator default (`1.0` for the `*_scale` knobs and the baseline `phi_lo = 0.999, phi_hi = 0.9996` for the AR(1) range). Each row is therefore a complete snapshot of the simulator configuration that produced the rollout. Three additional simulator knobs are held fixed across all 49 rollouts and are therefore omitted from the manifest: `seasonal_scale = 1.0`, `base_lambda_lo = 80.0`, `base_lambda_hi = 250.0`. The exact values used by each rollout are still recorded in its `scenario.json` file. ## File schema Directory layout: ``` isomorph_full/ ├── manifest.csv # one row per rollout ├── README.md ├── LICENSE ├── output_item50/ # baseline, C = 50 │ ├── daily_records.parquet │ ├── shipments.parquet │ ├── service_summary.parquet │ ├── inventory_history.parquet │ ├── backlog_history.parquet │ ├── intransit_history.parquet │ ├── demand_signals.npy │ ├── demand_signals_cols.txt │ ├── scenario.json │ ├── edge_list.parquet │ ├── edge_utilisation.npy │ └── edge_saturation.npy ├── output_item200/ # baseline, C = 200 (same files as above) ├── output_mixture/<scenario>/seed2025/ # 27 mixture rollouts (same files as above) └── output_uq/perturb_kNN/seed2025/ # 20 LHS rollouts (same files as above) ``` Each rollout directory contains the following files. `T` is the run horizon (52,560 for released rollouts), `C` is the catalogue size, and `E` is the number of edges in the network. | File | Shape / format | Contents | |----------------------------|-------------------------------|----------------------------------------------------------------------| | `daily_records.parquet` | rows: T x C | Per-day, per-item demand and service: `day, item, demand, served_from_stock, new_backlog_today, dest_on_hand_end_before_ship, dest_backlog_end_before_ship` | | `shipments.parquet` | rows: variable | One row per shipment: `day, arrival_day, from, to, item, units, path_nodes, edge_times` | | `service_summary.parquet` | rows: C | Per-item totals: `total_demand, served_from_stock, new_backlog_added, fill_rate_stock_only` | | `inventory_history.parquet`| rows: T | On-hand inventory over time | | `backlog_history.parquet` | rows: T | Backlog over time | | `intransit_history.parquet`| rows: T | In-transit units over time | | `demand_signals.npy` | array: T x C, float | Item-level demand series (same content as the `demand` column of `daily_records.csv`, dense form) | | `demand_signals_cols.txt` | text | Item IDs in column order of `demand_signals.npy` | | `scenario.json` | JSON | Exact CLI knobs used to produce the rollout | | `edge_list.parquet` | rows: E | Edge metadata: `edge_id, from, to, travel_time_days, container_volume, num_containers, cap_per_day` | | `edge_utilisation.npy` | array: T x E, float | Per-edge fractional utilisation | | `edge_saturation.npy` | array: T x E, float | Per-edge fractional saturation (cap-relative throughput) | ## Quick load ```python import pandas as pd manifest = pd.read_csv("manifest.csv") # Pull all mixture rollouts mix = manifest[manifest.family == "mixture"] # Pull all UQ rollouts uq = manifest[manifest.family == "uq"] # Load a rollout (tabular files are Parquet) row = mix.iloc[0] records = pd.read_parquet(f"{row.path}/daily_records.parquet") ``` ## Reproducing from source Each `manifest.csv` row maps to a single simulator CLI call. See `../../Isomorph_release/README.md` sections 1, 2, and 4. ## Licence CC-BY-4.0 (see `LICENSE`).

The full ISOMORPH dataset release: 49 rollouts spanning two baselines, 27 mixture scenarios, and 20 Latin-hypercube UQ perturbations. We release multivariate logistics time-series data generated by a digital-twin (DT) simulator of a multi-echelon supply chain with an explicit routing network, with the underlying dynamics formulated as a Markov chain. All runs use seed 2025 and horizon T = 52,560.

提供机构:
Isomorph2026
搜集汇总
数据集介绍
Isomorph2026/isomorph-supply-chain-benchmark 数据集图片
构建方式
在多级供应链数字孪生与随机物流系统建模领域,isomorph-supply-chain-benchmark 依托显式路由网络的仿真器构建。该仿真器以工厂、仓库与客户目的地组成有向图 G=(N,E),边配置整数运输时间和容量,并借 Dijkstra 算法安排装运。系统动力学被表述为马尔可夫链,状态向量记录各地点各物品的现货、积压、未完成订单、在途货物与平滑需求估计;随机输入仅包括泊松客户需求和高斯源提前期。需求强度由年季节性、周季节性、AR(1)漂移、单品突发与共享宏观冲击五部分叠加。全部发布运行使用同一 13 节点美国拓扑、种子 2025 及 T=52,560 的仿真期,形成 49 次 rollout 的多变量物流时序记录。
特点
面向复杂供应链网络中的不确定性量化与鲁棒决策研究,该数据集汇集 49 次 rollout,涵盖两个目录规模基线、27 个混合场景与 20 个拉丁超立方 UQ 扰动。混合场景围绕漂移、冲击、突发、边容量、缓冲与提前期六类旋钮进行单因素或双因素扫描,并包含 chaos_compound 与 chaos_burst 两个复合设置;UQ 样本在 phi_AR、rho_G、rho_B 三个需求侧参数空间内生成。所有 rollout 固定种子 2025、时域 52,560,并保持 seasonal_scale、base_lambda_lo、base_lambda_hi 不变。数据集约 99 GB,提供每日需求与服务、装运、库存、积压、在途、边利用率与饱和度等文件,manifest.csv 逐行记录完整仿真配置,具有较高可追溯性与基准测试价值。
使用方法
针对上述多变量物流时间序列的读取、复现与建模,使用者可先加载 manifest.csv,并按 family、scenario、n_items 等字段筛选 baseline、mixture 或 uq 运行。每行 path 指向 rollout 目录,表格文件可用 pandas.read_parquet 读取,如 daily_records.parquet、shipments.parquet、inventory_history.parquet 等;数组文件 demand_signals.npy、edge_utilisation.npy、edge_saturation.npy 可配合 demand_signals_cols.txt 与 edge_list.parquet 解析。scenario.json 记录精确 CLI 旋钮,manifest.csv 提供完整参数快照,便于复现、需求预测、服务率评估、边容量分析与不确定性传播实验。使用时需注意不同场景的旋钮差异与共享基线设置,遵守 CC-BY-4.0 许可。
背景与挑战
背景概述
在复杂供应链系统建模与不确定性量化日益受到关注的背景下,isomorph-supply-chain-benchmark以多级供应链数字孪生模拟器为核心,公开展示由马尔可夫链驱动的大规模多元物流时序数据。该数据集以2025为统一随机种子,在CC-BY-4.0许可下释出,具体创建时点及主要研究人员或机构于公开说明中未予详载。其核心研究问题聚焦于显式路由网络下的多级库存、补货、运输与客户需求交互,涵盖泊松需求、季节效应、AR(1)漂移、突发与宏观冲击。该基准为供应链数字孪生、不确定性量化、鲁棒优化与学习型决策方法提供了可复现的仿真试验场,对物流系统建模与基准评估具有推动作用。
当前挑战
在供应链管理面临需求波动、容量约束与长时程决策压力的背景下,该数据集所指向的领域挑战在于多级库存与运输路由的耦合优化、随机需求与提前期扰动下的服务率与积压权衡,以及高维状态空间中的鲁棒决策。构建层面的挑战包括:以数字孪生高保真刻画工厂、仓库与客户网络,将动态表述为马尔可夫链并融合Dijkstra路径选择,在49次rollout和约99GB体量下保证长时程数据的存储与读取效率,设计27类混合场景与20组拉丁超立方扰动以覆盖多样不确定性,维持统一种子与完整参数快照的可复现性,并校验仿真结果对真实供应链的泛化与解释力。
常用场景
经典使用场景
在供应链韧性研究与数字孪生仿真深度耦合的背景下,ISOMORPH Full以显式路由网络和马尔可夫链动力学为核心,构建了面向多级物流系统的长时程多变量时间序列基准。其经典使用场景在于,研究者依据manifest.csv筛选基线、混合情境与拉丁超立方不确定性扰动,利用daily_records、shipments、inventory_history及edge_utilisation等文件,开展需求预测、补货策略评估、路由调度比较与服务绩效诊断。该场景覆盖年周期与周周期、AR(1)漂移、逐品爆发及共同宏观冲击,并保留在途、积压与边容量真值,适合检验模型在复杂随机耦合下的稳健性。
解决学术问题
面对供应链随机动态建模中长期存在的可复现性不足、不确定性传播难刻画与分布外泛化评估薄弱等问题,该数据集提供了统一且可追溯的实验基底。其显式网络拓扑、整数边旅行时间、每步容量约束及马尔可夫状态转移,使学者能够研究需求冲击、提前期波动与容量收紧如何沿多级网络扩散,并评估缺货、积压、在途库存和填充率的动态响应。意义在于,它为不确定性量化、鲁棒库存控制、因果反事实推断及长时程概率预测建立了可比较的学术标尺,并借助多情境与LHS扰动增强结论的外部效度。
衍生相关工作
在数字孪生基准与供应链机器学习交叉演进的脉络中,该数据集所衍生的相关工作多围绕时空图神经网络、概率需求预测、深度强化学习库存控制、鲁棒优化与不确定性量化展开。其多情境滚动与拉丁超立方扰动为领域泛化、分布外检测、因果发现和反事实评估提供了实验土壤,也推动多级库存优化、网络流近似与排队模型在真实拓扑上的校准。相关经典方法脉络涵盖需求预测基础模型、多智能体仿真、随机规划与贝叶斯推断,该基准则为其提供了统一且可复现的验证场域。
以上内容由遇见数据集搜集并总结生成
二维码
社区交流群
二维码
科研交流群
商业服务