Skip to content

EMT Universal Line Model Documentation#451

Open
lukelowry wants to merge 20 commits into
developfrom
lukel/fd-line-dev
Open

EMT Universal Line Model Documentation#451
lukelowry wants to merge 20 commits into
developfrom
lukel/fd-line-dev

Conversation

@lukelowry

@lukelowry lukelowry commented Jun 13, 2026

Copy link
Copy Markdown
Collaborator

Description

Improves documentation for EMT line models and adds documentation for other models needed to implement the most capable version of the Universal Line Model (ULM).

Proposed changes

  • Rename to Line documentation for LineLumped and LineDistributed, replacing the old Branch line docs (existing model documentation functionally unchanged)
  • Enhanced version of LineLumped which is identical to the previous formulation but more general and future compatible
  • Add an Operators group for the reusable blocks the models build on
    • Rational (VectorFit, StateSpace) for empirical f.d. transmission line models
    • Shift (Delay, Propagation) for distributed parameter modeling
  • Reorganize into Component (Bus, Line, Load, Source) and Operators
  • Add diagrams for the line and operator models, and update the EMT README indexes and figure paths.

Checklist

  • N/A All tests pass.
  • N/A Code compiles cleanly with flags -Wall -Wpedantic -Wconversion -Wextra.
  • N/A The new code follows GridKit™ style guidelines.
  • N/A There are unit tests for the new code.
  • The new code is documented.
  • The feature branch is rebased with respect to the target branch.
  • I have updated CHANGELOG.md to reflect the changes in this PR.

Further comments

All the EMT models are now formulated as ODEs

@lukelowry lukelowry added the documentation Improvements or additions to documentation label Jun 13, 2026
@lukelowry lukelowry self-assigned this Jun 13, 2026
@lukelowry lukelowry force-pushed the lukel/fd-line-dev branch 3 times, most recently from 9f42d0c to a94de20 Compare June 16, 2026 09:53
@lukelowry lukelowry requested a review from pelesh June 16, 2026 10:41
@lukelowry

Copy link
Copy Markdown
Collaborator Author

@pelesh, I made this PR draft so you can see the range of complexity for the models and their needs.

An open-source ULM (LineDistributed) would be invaluable, especially if we scale well to large cases. What most authors call 'EMT' is LineLumped, which is just fancy phasor dynamics. ULM is where the prizes are! To my knowledge, no one has ever tried to model the ULM with adaptive stepping like this.

Discuss later.

@lukelowry lukelowry force-pushed the lukel/fd-line-dev branch from 53ed821 to 56330ec Compare June 20, 2026 07:42
@lukelowry lukelowry requested a review from abirchfield June 20, 2026 18:33
@lukelowry lukelowry marked this pull request as ready for review June 20, 2026 18:33
@lukelowry lukelowry force-pushed the lukel/fd-line-dev branch from 3d0daca to ec3b44b Compare June 22, 2026 16:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant