SSMLearn

Data-driven Reduced Order Models for Nonlinear Dynamical Systems

This package identifies reduced-order models on spectral submanifolds (SSMs) from data. The required input consists of trajectory data of generic system observables close to an SSM, the SSM dimension, and the polynomial orders of approximation for the parametrization and reduced dynamics. In addition, an alternative simplified method, fastSSM, is included. See the fastSSM subfolder for documentation.

The computational steps for achieving a reduced-order model are:

1. Embedding of the measurements in a suitable observable space;
2. Computation of the invariant manifold parametrization and its reduced order coordinates;
3. Identification of the reduced dynamics and its normal form.

Once the normal form dynamics has been determined, the code can run analytics and predictions on the reduced-order model, such as backbone curves and forced responses, as shown in our examples. We have included demonstrations of SSM identifications on the following examples.

• Oscillator chain: n degrees of freedom with trajectories on or off specific SSMs;
• Von Kármán straight beam in 2D: geometrically nonlinear finite element model from SSMTool, with reduced order models constructed using different observables;
• Brake-Reuss beam: benchmark system for the dynamics of jointed structures, data from experimental measurements (DIC and accelerometers);
• Resonant double beam: structure with a 1:2 internal resonance, data from laser vibrometry;
• Vortex Shedding behind a cylinder: data from CFD simulations, projected on a low-dimensional linear subspace of the phase space;
• Plane Couette flow: reduced order modeling of transitions between exact coherent states;
• Liquid sloshing of a water tank: data from experimental measurements;
• Buckling beam: finite-element simulation of an axially loaded beam undergoing mechanical failure;
• Prismatic beam in 3D: geometrically nonlinear finite element model from SSMTool with 1:3 internal resonance;
• Von Kármán shell: geometrically nonlinear finite element model from SSMTool, with and without internal resonance between the two slowest modes;
• Von Kármán plate: geometrically nonlinear finite element model from SSMTool with internal resonance on an intermediate SSM;
• Inverted flag: inverted flag water tunnel experiments, with reductions to 2D and 4D SSMs, the latter showing a chaotic flapping regime;
• Non smooth mechanical systems: data-driven SSM reductions are shown for models with contact and friction.

This package uses the following external open-source packages for some of the examples and post-processing capabilities:

1. Continuation core (coco) https://sourceforge.net/projects/cocotools/
2. SSMTool 2.4 or greater: Computation of invariant manifolds & their reduced dynamics in high-dimensional mechanics problems https://github.com/haller-group/SSMTool-2.4

Installation

1. Once located in the main folder, install the package:

   install

2. If external packages are not yet installed, download SSMTool from the link above, which also include coco, and install it.
3. Download the folder data that contains heavy data sets to run high-dimensional examples (i.e., Von Kármán shells and plates) at this link and place it in the main folder of the local repository.
4. (optional) Figure specifications can be edited in the function customFigure.m located in the src folder.
5. You are ready.

References

Please consider to cite this article when using this code:

• M. Cenedese, J. Axås, B. Bäuerlein, K. Avila and G. Haller. Data-driven modeling and prediction of non-linearizable dynamics via spectral submanifolds. Nature Communications, 13 (2022) 872. [PDF] [Supplementary Information]

Additional works appear in the references:

• M. Cenedese, J. Axås, H. Yang, M. Eriten and G. Haller. Data-driven nonlinear model reduction to spectral submanifolds in mechanical systems, Philosophical Transactions of the Royal Society A: Mathematical, Physical and Engineering Sciences 380 (2022) 20210194. [PDF]

• G. Haller, S. Jain and M. Cenedese. Dynamics-based machine learning for nonlinearizable phenomena. Data-driven reduced models on spectral submanifolds, SIAM News 55/5 (2022) 20210194. [PDF]

• B. Kaszás, M. Cenedese & G. Haller, Dynamics-based machine learning of transitions in Couette flow, Physical Review Fluids 7 (2022) L082402. [PDF] [Supplemental Material]

• J. Axås, M. Cenedese & G. Haller, Fast data-driven model reduction for nonlinear dynamical systems, Nonlinear Dynamics 111 (2023) 7941–7957. [PDF]

• J. Axås & G. Haller, Model reduction for nonlinearizable dynamics via delay-embedded spectral submanifolds, Nonlinear Dynamics 111 (2023) 22079–22099. [PDF]

• A. Liu, J. Axås & G. Haller, Data-Driven Modeling and Forecasting of Chaotic Dynamics on Inertial Manifolds Constructed as Spectral Submanifolds, Chaos 34 (2024) 033140. [PDF]

• Z. Xu, B. Kaszás, M. Cenedese, G. Berti, F. Coletti & G. Haller, Data-driven modelling of the regular and chaotic dynamics of an inverted flag from experiments, Journal of Fluid Mechanics 987 (2024) R7. [PDF]

• L. Bettini, M. Cenedese & G. Haller, Model Reduction to Spectral Submanifolds in Non-Smooth Dynamical Systems, International Journal of Non-Linear Mechanics 163 (2024) 104753. [PDF]

• M. Cenedese, J. Marconi, G. Haller, & S. Jain, Data-assisted non-intrusive model reduction for forced nonlinear finite elements models, arXiv: 2311.17865 (2023). [PDF]