pathsim.subsystem

class pathsim.subsystem.Interface

Bases: Block

Bare-bone block that serves as a data interface for the ‘Subsystem’ class.

It works like this:

• Internal blocks of the subsystem are connected to the inputs and outputs of this Interface block via the internal connections.

• It behaves like a normal block (inherits the main ‘Block’ class methods).

• It implements some special methods to get and set the inputs and outputs of the blocks, that are used to translate between the internal blocks of the subsystem and the inputs and outputs of the subsystem.

• Handles data transfer to and from the internal subsystem blocks to and from the inputs and outputs of the subsystem.

set_output(port, value)

get_input(port)

class pathsim.subsystem.Subsystem(blocks=None, connections=None)

Bases: Block

Subsystem class that holds its own blocks and connecions and can natively interface with the main simulation loop.

IO interface is realized by a special ‘Interface’ block, that has extra methods for setting and getting inputs and outputs and serves as the interface of the internal blocks to the outside.

The subsystem doesnt use its ‘inputs’ and ‘outputs’ dicts directly. It exclusively handles data transfer via the ‘Interface’ block.

This class can be used just like any other block during the simulation, since it implements the required methods ‘update’ for the fixed-point iteration (resolving algebraic loops with instant time blocks), the ‘step’ method that performs timestepping (especially for dynamic blocks with internal states) and the ‘solve’ method for solving the implicit update equation for implicit solvers.

Parameters:

• blocks (list[Block]) – internal blocks of the subsystem

• connections (list[Connection]) – internal connections of the subsystem

interface

internal interface block for data transfer to the outside

Type:

Interface

reset()

Reset the subsystem and all internal blocks

on()

Activate the subsystem and all internal blocks, sets the boolean evaluation flag to ‘True’.

off()

Deactivate the subsystem and all internal blocks, sets the boolean evaluation flag to ‘False’. Also resets the subsystem.

to_dict()

Custom serialization for Subsystem

classmethod from_dict(data)

Custom deserialization for Subsystem

get_events()

Recursively collect and return events spawned by the internal blocks of the subsystem, for discrete time blocks such as triggers / comparators, clocks, etc.

set(port, value)

The ‘set’ method of the ‘Subsystem’ sets the output values of the ‘Interface’ block.

Parameters:

• port (int) – input port to set value to

• value (numeric) – value to set at input port (of subsystem)

get(port)

The ‘get’ method of the ‘Subsystem’ retrieves the input values of the ‘Interface’ block.

Parameters:

port (int) – output port (of subsystem) to retrieve value from

sample(t)

Update the internal connections again and sample data from the internal blocks that implement the ‘sample’ method.

Parameters:

t (float) – evaluation time

update(t)

Update the instant time components of the internal blocks to evaluate the (distributed) system equation.

Parameters:

t (float) – evaluation time

Returns:

max_error – error tolerance of system equation convergence

Return type:

float

solve(t, dt)

Advance solution of implicit update equation for internal blocks.

Parameters:

• t (float) – evaluation time

• dt (float) – timestep

Returns:

max_error – maximum error of implicit update equaiton

Return type:

float

step(t, dt)

Explicit component of timestep for internal blocks including error propagation.

Notes

This is pretty much an exact copy of the ‘_step’ method from the ‘Simulation’ class.

Parameters:

• t (float) – evaluation time

• dt (float) – timestep

Returns:

• success (bool) – indicator if the timestep was successful

• max_error (float) – maximum local truncation error from integration

• scale (float) – rescale factor for timestep

set_solver(Solver, **solver_args)

Initialize all blocks with solver for numerical integration and additional args for the solver such as tolerances, etc.

If blocks already have solvers, change the numerical integrator to the ‘Solver’ class.

Parameters:

• Solver (Solver) – numerical solver definition

• solver_args (dict) – args to initialize solver with

revert()

revert the internal blocks to the state of the previous timestep

buffer(dt)

buffer internal states of blocks with internal integration engines

Parameters:

dt (float) – evaluation time for buffering