DPsim – Developer Guide

Docs: Architecture and Conventions

Mon, 01 Jan 0001 00:00:00 +0000

Start here. These pages describe the shape of the library, the modules it divides into and the class hierarchy underneath them, together with the conventions any change is expected to follow.

Docs: Attributes and Scheduling

Mon, 01 Jan 0001 00:00:00 +0000

Attributes are the unit of state in DPsim, and they are not only a way to expose a value: the scheduler builds the execution order from the dependencies that components declare over them. The two subjects are one subject, which is why they sit together.

This is also what logging and the co-simulation interfaces operate on, so a quantity that is not an attribute cannot be recorded or exchanged.

Docs: Writing a Model

Mon, 01 Jan 0001 00:00:00 +0000

The path from an empty file to a working component: what to declare, which hooks the solver calls and in what order, how a component built from other components is assembled, and how to debug one that runs but produces the wrong answer.

For the equations a model should implement, see Concepts. For worked examples of finished models, see model implementations.

Docs: Solvers

Mon, 01 Jan 0001 00:00:00 +0000

The MNA solver is the default and the one almost every simulation uses; a component’s side of it is under interfacing with the MNA solver. The remaining pages cover the powerflow solver, the alternatives to nodal analysis, the linear algebra backends, and the state-space model that can be recovered from a running simulation.

The methods themselves are derived under alternative solution methods.

Docs: Model Implementations

Mon, 01 Jan 0001 00:00:00 +0000

One page per model family, covering the class hierarchy, how the component interfaces with the solver, its attributes and state layout, and the traps in configuring it. The equations behind each are under Concepts, which names no class; these pages name nothing else.

Which domains implement which model is in model availability, generated from the headers.