/SSMLearn

Data-driven reduced order modeling for nonlinear dynamical systems

Primary LanguageMATLABGNU Affero General Public License v3.0AGPL-3.0

SSMLearn

Data-driven Reduced Order Models for Nonlinear Dynamical Systems

This package perform data-driven identification of reduced order model based on spectral submanifolds (SSMs). The required input consists of trajectory data of generic system observables close to an SSM, the SSM dimension and the polynomial orders for approximation of the parametrization and reduced dynamics.

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. There are no constraints on the types of measurements, on the kind of nonlinearities or on the problem dimensions.

We have included a demonstration of SSM identification on the following examples.

  • Von Kármán straight beam in 2D: geometrically nonlinear finite element model from SSMTool, with reduced order models constructed using different observables;
  • Vortex Shedding behind a cylinder: data from CFD simulations, projected on a low-dimensional linear subspace of the phase space;
  • Liquid sloshing of a water tank: data from experimental measurements.

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.1: Computation of invariant manifolds & their reduced dynamics in high-dimensional mechanics problems https://github.com/haller-group/SSMTool-2.1

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. (optional) Figure specifications can be edited in the function customFigure.m located in the src folder.
  4. 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. arXiv:2201.04976, (2022).

Please report any issues/bugs to Mattia Cenedese (mattiac@ethz.ch) or Joar Axås (jgoeransson@ethz.ch)