PerseusLjf/Dynamics_Simulation_Dataset

1---2license: other3task_categories:4  - tabular-regression5  - time-series-forecasting6language:7  - en8pretty_name: Dynamics Simulation Dataset9size_categories:10  - 1K<n<10K11tags:12  - dynamics13  - simulation14  - multibody-systems15  - natural-coordinate-method16  - robotics17  - time-series18---19 20# Dynamics Simulation Dataset21 22## Dataset Summary23 24This dataset contains dynamics simulation trajectories computed with the Natural Coordinate Method (NCM). It is organized by benchmark case. Each case provides a training split and a test split, and each split contains multiple simulation runs with different initial conditions.25 26The dataset is intended for learning and evaluating dynamics models, trajectory prediction methods, control-aware models, and surrogate models for multibody mechanical systems.27 28## Directory Structure29 30Each top-level directory follows this naming pattern:31 32```text33<case_name>_<split>/34```35 36where `<split>` is either `train` or `test`.37 38Each split directory contains numbered subdirectories. Each numbered subdirectory corresponds to one simulation condition with a distinct initial state.39 40```text412p2d_train/42  1/43    dt.csv44    q.csv45    u.csv46    t.csv47    tu.csv48  2/49    dt.csv50    q.csv51    u.csv52    t.csv53    tu.csv54```55 56All simulation subdirectories contain:57 58- `dt.csv`: time step size.59- `q.csv`: natural coordinate trajectory.60- `u.csv`: driving input at each time step.61 62Some simpler benchmark cases additionally contain:63 64- `t.csv`: minimal coordinate trajectory, such as joint angles.65- `tu.csv`: driving input represented in the corresponding minimal coordinates.66 67## Benchmark Cases68 69| Case name   | Description                           |70| ----------- | ------------------------------------- |71| `2p2d`      | Two-link planar structure             |72| `3p2d`      | Three-link planar structure           |73| `4p2d`      | Four-link planar structure            |74| `disT_2p2d` | Dissipative two-link planar structure |75| `3arm2d`    | Three-section planar robotic arm      |76| `7arm2d`    | Seven-link planar structure           |77| `3Sp3d`     | Three-section 3D spine-like structure |78| `5Sp3d`     | Five-section 3D spine-like structure  |79 80## Splits81 82Each benchmark case has two splits:83 84- `train`: 64 simulation runs with different initial conditions.85- `test`: 100 simulation runs with different initial conditions.86 87The top-level directories are:88 89```text902p2d_train/        2p2d_test/913p2d_train/        3p2d_test/924p2d_train/        4p2d_test/93disT_2p2d_train/   disT_2p2d_test/943arm2d_train/      3arm2d_test/957arm2d_train/      7arm2d_test/963Sp3d_train/       3Sp3d_test/975Sp3d_train/       5Sp3d_test/98```99 100## Data Files101 102The CSV files store time-series simulation data. Rows correspond to time steps. The columns correspond to the coordinate components or input components used by the corresponding benchmark system.103 104Because the systems have different numbers of bodies, joints, and coordinates, the dimensionality of `q.csv`, `u.csv`, `t.csv`, and `tu.csv` may differ across benchmark cases.105 106## Dataset Creation107 108The trajectories were generated from dynamics simulations computed using the Natural Coordinate Method. Each numbered run corresponds to a different initial condition for the same benchmark case and split.109 110## Intended Use111 112This dataset may be useful for:113 114- training neural dynamics models;115- evaluating trajectory prediction accuracy;116- comparing natural-coordinate and minimal-coordinate representations;117- studying control inputs for simulated multibody systems;118- benchmarking data-driven models on planar and spatial mechanical systems.119 120## Limitations121 122The dataset contains simulated trajectories rather than real-world measurements. Model performance on this dataset may not directly transfer to physical systems without accounting for modeling assumptions, numerical integration details, sensing noise, actuation limits, and unmodeled dynamics.123 124## Citation125 126If you use this dataset in academic work, please cite the associated project, paper, or repository when available.127