About SyDEVS

The SyDEVS C++ library provides a framework for implementing complex systems simulation code in a modular and hierarchical fashion.

The framework combines three modeling paradigms: discrete event simulation, agent-based modeling, and dataflow programming. The discrete event simulation aspect is based on DEVS, a well-regarded modeling formalism involving two types of models that correspond with the atomic and composite nodes of SyDEVS. SyDEVS also includes collection nodes, which extend DEVS with agent-based modeling capabilities, and function nodes, for dataflow programming. Atomic, composite, collection, and function nodes communicate through flow ports as part of a dataflow programming network. Atomic, composite, and collection nodes also communicate in a DEVS-like fashion through message ports.

In addition to supporting multiple modeling paradigms, the SyDEVS library provides comprehensive and reusable Modern C++ implementations of multidimensional arrays, Standard International (SI) units, a multiscale time representation, and other technical computing elements.

The main SyDEVS website is at https://autodesk.github.io/sydevs.

The SyDEVS repository is at https://github.com/Autodesk/sydevs.

Main Classes

Namespace: sydevs

Core Classes (sydevs/core) - generic classes for a variety of applications
- scale (scale.h) - dimensionless power of 1000
  - number_types.h - related header file with number type aliases, pi constant
- quantity (quantity.h) - Standard International (SI) quantity (e.g. mass, acceleration)
  - units (units.h) - related template for SI units (e.g. grams, meters/second^2)
- identity (identity.h) - dimensioned integer for identifying items
- arraynd (arraynd.h) - multidimensional array
  - range (range.h) - related class for representing ranges of array indices
- qualified_type (qualified_type.h) - traits for types exchanged between system nodes
  - pointer (pointer.h) - related class for pointers to any type of data
  - string_builder (string_builder.h) - related class for value-to-string conversion
- timer (timer.h) - class that measures intervals of wall clock time
Time Classes (sydevs/time) - multiscale time representation
- time_point (time_point.h) - arbitrary-precision point in time
- time_sequence (time_sequence.h) - sequence of increasing time points
- time_queue (time_queue.h) - data structure tracking future event times
- time_cache (time_cache.h) - data structure tracking past event times
Systems Classes (sydevs/systems) - dataflow + message-passing networks
- system_node (system_node.h) - base class for all nodes
  - atomic_node (atomic_node.h) - derived from system_node, supports event handlers
  - composite_node (composite_node.h) - derived from system_node, supports fixed-structure compositions
  - collection_node (collection_node.h) - derived from system_node, supports variable-length collections
  - function_node (function_node.h) - derived from system_node, supports functions
    - parameter_node (parameter_node.h) - derived from function_node, handles parameter values
    - statistic_node (statistic_node.h) - derived from function_node, handles statistic values
  - interactive_system (interactive_system.h) - derived from collection_node, supports real time simulations
  - port<data_mode, data_goal> (port.h) - related classes for node ports
- simulation (simulation.h) - template for simulations based on a port-free system_node
  - real_time_simulation (real_time_simulation.h) - derived from simulation, supports real time simulations
    - real_time_buffer (real_time_buffer.h) - related class for linking simulated time with wall clock time
  - discrete_event_time (discrete_event_time.h) - related class for tracking progress through a simulation