Module Reference

simframe.frame Package

This package contains the core infrastructure of simframe.



This is an abstract class that serves as template for other classes.

Field(owner, value[, updater, …])

Class for storing simulation quantities.

Frame([integrator, writer, updater, …])

This is the parent object of type Group that contains all other objects.

Group(owner[, updater, description])

Class for grouping data.

Heartbeat([updater, systole, diastole])

This class controls an update including systole and diastole.

IntVar(owner[, value, snapshots, updater, …])

Cclass for integration variables that behaves as Field but has additional functionality with respect to stepsize management for integration.


Class that manages how a Group or Field is updated.

simframe.integration Package

This package contains infrastructure for solving differential equations within simframe. The Integrator class is the basic class that advances the simulation from snapshot to snapshot by executing one integration Instruction at a time. Instructions contain a list of integration Scheme. The schemes package contains pre-defined integration schemes that are ready to use in simframe.


Instruction(scheme, Y[, fstep, controller, …])

Integration Instruction that controls the execution of an integration Scheme.

Integrator(var[, instructions, failop, …])

Integrator class that manages the integration instructions

Scheme(scheme[, controller, description])

Class for an integration Scheme that can be used as template for creating custom schemes.

simframe.integration.schemes Package

This package contains pre-defined instances of integration schemes that can be used in simframe. The naming convention is <expl/impl>_<order>_<name>(<_additonal>).

For example: The fifth-order adaptive Cash-Karp scheme is expl_5_cash_karp_adptv, the 1st-order implicit Euler scheme using a GMRES solver is impl_1_euler_gmres. Package

This package is for input/output operations. It contains template Writer and Reader classes that can be used to create customized writing and reading methods. The package writers contains pre-defined Writer instances for writing and reading simframe data. The package furthermore contains a method for reading dump files and for printing a progress bar in an interactive shell.



Reads dumpfile and returns Frame object


Reader(writer[, description])

General class for reading output files.

Writer(func[, datadir, filename, zfill, …])

General class for writing output files.

Progressbar([prefix, suffix, fill, empty, …])

Class for printing progress bar to terminal. Package

This package contains pre-defined Writer instances that can be used for writing and reading Frame objects. The hdf5writer writes data files in the HDF5 file format. The namespacewriter does not write output files (except for dump files if required). The data is stored locally in the Writer object itself.

simframe.utils Package

Package contains utility classes that facilitate the use of simframe

Color is a generic class that can be used to colorize text. colorize is an instance of Color, that can be called to add decorators to a string for colored output.



Class to decorate strings with color tags.