feedtwin.solve.network Namespace Reference

Classes
class	NetworkError
class	Node
class	Branch
class	DeadEnd
class	Network

Detailed Description

The network: nodes that hold a pressure, branches that carry a flow.

A feed system is a graph. Nodes are places where pressure is defined -- a tank
outlet, a tee, an injector face -- and branches are the components between them.
Every unknown is one of two things: a node pressure or a branch mass flow.

Two kinds of equation close the system, and between them they are the whole
steady solve:

* **Mass balance** at every free node -- what flows in flows out.
* **A pressure relation** on every branch -- ``p_up - p_dn = dp(mdot)``, where
  ``dp`` is whatever the component says.

Boundary conditions are nodes whose pressure is *fixed*: a pressurised tank, an
ambient vent, a chamber. They contribute no mass balance, because whatever they
need flows in or out of them by definition. A network with no fixed node has no
reference pressure and is singular -- which is checked and reported, rather than
discovered as a linear algebra failure.

Scope, stated plainly: this is **steady, isothermal, single-phase** flow. Node
temperatures are given rather than solved, so there is no energy equation here.
Phase 05 adds the gas side and tank thermodynamics; Phase 07 makes it transient.
A network that boils inside a line is outside what this can say.