DeepTelecom · DTUAV-V1 · v1.0.0

DeepTelecom UAV Wireless-Propagation Dataset

A reproducible simulation dataset built with Sionna RT and a moving UAV point-scatterer model, pairing NPZ tensors, micro-Doppler PNG spectrograms, and standardized JSON metadata.

Modeling scope This is simulated—not measured flight—data. It uses a point-scatterer monostatic-return approximation, not a full-wave simulation with a complete physical UAV mesh or calibrated RCS.

Frozen revisionde7fc35c…23b3v1.0.0 verified

Base station and complete cubic Bézier UAV flight corridor in the Sionna RT Étoile city scene
Figure 1 · Étoile scene configurationBase station, 70 m altitude, and the complete 88.914 m cubic Bézier corridor. This overview does not imply that one 0.1024 s sample traverses the entire route.
Micro-Doppler spectrogram for verified 30-degree pitched-flight sample DTUAV-V1-011252
Release sample DTUAV-V1-01125230° tilt · 10 m/s · 25 scatterers

Dataset at a glance

Dataset overview

44,988
released samples
4
simulation conditions
140
verified TAR shards
138.76 GiB
released payload
NPZ · PNG · JSON
three members per public ID

Release evidence

Real samples and data contents

These spectrogram PNGs come from the frozen v1.0.0 TARs. Their source files, TAR members, and public-manifest SHA-256 values were cross-checked; exact parameters are recorded in the machine-readable gallery manifest.

Micro-Doppler spectrogram for level-hover sample DTUAV-V1-000007
DTUAV-V1-000007Level hover0° · 0 m/s · 25 scatterers
Micro-Doppler spectrogram for 30-degree pitched-flight sample DTUAV-V1-011252
DTUAV-V1-01125230° pitched flight30° · 10 m/s · 25 scatterers
Micro-Doppler spectrogram for 45-degree pitched-flight sample DTUAV-V1-022488
DTUAV-V1-02248845° pitched flight45° · 10 m/s · 25 scatterers
Micro-Doppler spectrogram for isolated-blade baseline sample DTUAV-V1-033705
DTUAV-V1-033705Isolated blade baseline0° · 0 m/s · 1 scatterer

Simulation conditions

Four simulation conditions

The compact class_id remains machine-readable. The table states each condition's tilt, body translation speed, scatterer model, and sample count.

Label examplepitch30_v10 pitch30: 30° tilt about the simulation y-axis v10: translation at 10 m/s along the path

Level hover

level_v0

Full quadrotor point-scatterer model; the body does not translate while its rotors keep turning.

Tilt
Speed
0 m/s
Points
25
11,249samples · 25.0%

30° pitched flight

pitch30_v10

The full quadrotor model is tilted 30° about the simulation y-axis and translates along its path.

Tilt
30°
Speed
10 m/s
Points
25
11,236samples · 25.0%

45° pitched flight

pitch45_v10

The full quadrotor model is tilted to 45° while retaining the same 10 m/s translation speed.

Tilt
45°
Speed
10 m/s
Points
25
11,219samples · 24.9%

Isolated blade baseline

single_blade_v0

A control model retaining one rotating blade-tip scatterer; it does not represent a single-rotor aircraft.

Tilt
Speed
0 m/s
Points
1
11,284samples · 25.1%
Class-count rangelargest minus smallest: 65 samples

Format and schema

Data format and schema

Every public sample follows the outer NPZ + PNG + JSON protocol. The NPZ payload has two registered tensor schemas, so readers must inspect tensor_schema_id.

Record typeCountDescription
dtuav-etoile-32key-v144,948The primary v1 tensor structure with 32 array keys.
dtuav-floor-wall-24key-v140The 24-key structure used by early formal samples; missing arrays were not fabricated.
JSON sidecar44,988Public ID, class, schema, file hashes, and source metadata.

Reading constraints

  • 134,964 TAR members in total: three per sample.
  • The release defines no train, validation, or test split.
  • The sidecar and global allocation/provenance manifest are different record types.
  • Source machines remain in provenance and never appear in public paths or filenames.

Generation method

Simulation and data generation

The public reference generator uses the Sionna RT 2.0.1 built-in Étoile scene. Its main configuration is 28 GHz, 20 kHz, and 2,048 snapshots.

  1. 01

    Class and trajectory

    Read tilt, body speed, initial state, and a linear or Bézier path.

  2. 02

    Moving scatterers

    Compute positions and velocities for body, rotor-center, and blade-radial points.

  3. 03

    Per-snapshot ray tracing

    Solve one-way CIRs from the base station to passive receiver probes.

  4. 04

    Monostatic return and STFT

    Approximate the round trip with a weighted coherent sum of squared complex channels, add AWGN, and compute the STFT.

  5. 05

    Research output and release

    The generator writes NPZ, PNG, and run metadata; the release builder separately creates sidecars, TARs, and integrity records.

Configurable now

After copying the complete configuration, change points_per_blade from 3 to 5 to raise the standard model from 25 to 41 points. Choose a fixed +x line or one four-control-point cubic Bézier segment.

Current implementation limits

One quadrotor is fixed. Waypoint/CSV input, multi-segment paths, and obstacle planning are not implemented. A new motion class requires code changes and tests, and model changes belong in a new experiment namespace.

Read setup, configuration, and extension details

Curation and integrity

Data quality and reproducibility

Three source environments were inventoried read-only before unified content, status, and release-policy checks. Legacy-ID conflicts with different content were retained under different public IDs.

  1. 01

    Read-only inventory

    Freeze file, class, size, and hash records.

  2. 02

    Curation decisions

    Identify local copies, invalid, incomplete, and non-release records.

  3. 03

    Global verification

    Review duplicates and legacy-ID conflicts by content hash.

  4. 04

    Continuous IDs

    Assign DTUAV-V1-000001–044988.

  5. 05

    Package and verify

    Build and verify 140 deterministic WebDataset TARs.

Pre-release decisionCountAction
Local physical copies39,240Repeated storage excluded; not independent training samples
Zero-byte invalid sample1Excluded
Incomplete records1,077Excluded
Test and non-release records5,109Excluded
Legacy-ID conflicts70 groups / 144 recordsDistinct content retained with distinct global IDs
Frozen release
v1.0.0
HF commit
de7fc35cb41af3d9c5b2f52dab5483e3ceb623b3
Integrity scope
140 TARs and release metadata
Unresolved conflicts
0

Access and usage

Download and quick start

These examples pin the immutable Hugging Face commit, so later main-branch updates cannot silently change experiment inputs.

Download the first four shards
python scripts/download_dataset.py \
  --output-dir DeepTelecom_Partial \
  --start 0 --end 3
Stream with WebDataset
import webdataset as wds

base = "https://huggingface.co/datasets/KYGOYUAN/DeepTelecom_Partial/resolve/de7fc35cb41af3d9c5b2f52dab5483e3ceb623b3"
urls = base + "/data/v1/shards/shard-{00000..00003}.tar"
samples = wds.WebDataset(urls, shardshuffle=False).to_tuple(
    "__key__", "npz", "png", "json"
)

Scope and limitations

Modeling scope and known limitations

  • Data sourceAll samples are simulated, not collected from real UAV flights or measured ground truth.
  • Electromagnetic modelA moving point-scatterer monostatic-return approximation—not a physical mesh, calibrated RCS, or full-wave solution.
  • Tensor structures44,948 samples use 32 keys and 40 early samples use 24 keys; readers cannot assume identical internal fields.
  • Data splitsv1.0.0 defines no train, validation, or test split.
  • Numerical reproductionCode, configuration, and seeds are traceable; byte-identical output across GPU, driver, and floating-point implementations is not promised.

Project organization

ISEE project team, Zhejiang University

DeepTelecom is organized for research in UAV wireless propagation, ray tracing, and micro-Doppler. This identifies the project organization and does not imply unclaimed institutional endorsement.

Visit the official ISEE website

License and citation

Code and documentation in the GitHub repository are Apache-2.0 licensed. This does not automatically grant a separate license for the Hugging Face dataset payload.

The repository currently provides no formal paper citation or DOI. A reference may record the dataset title, v1.0.0, and the immutable HF commit.