Digital Model - Engineering Asset Lifecycle Management

Sustainable digital models for engineering assets built with sustainable engineering processes and solutions. Single source of truth for offshore, subsea, and marine engineering analysis.

Dedicated to Mark Cerkovnik - Chief Engineer, mentor, and inspiration.

🔍 Capabilities Snapshot

Lifecycle coverage: fatigue, stress, hydrodynamics, riser & mooring, metocean, vessel systems.
Digital thread: ASCII-first configs drive FE models, CAD/animations, reports, and QA workflows.
Data procurement: structured spec library for supplier intelligence across offshore domains.
Automation ready: modular APIs, CLI tooling, and integration hooks for pipelines & dashboards.
Validation tooling: cross-check analytical vs. numerical results with repeatable benchmarking.

🎯 Vision

Utilize a single source of ASCII inputs (promoting single source of truth) to generate equivalent analytical models encompassing the complete lifecycle operations of engineering assets:

Analytical Calculations - Fatigue, stress, hydrodynamics, structural capacity
Computational Analysis - FEA models, time-domain simulations, frequency analysis
3D CAD Models - Automated geometry generation
3D Animations - Visual representations of designs
Drawing Automation - Engineering documentation

📊 Repository Overview

| Category | Count | Description | |----------|-------|-------------| | Python Modules | 704+ | Core engineering libraries | | Test Files | 1,971+ | Comprehensive test coverage | | Examples | 12+ | Working demonstrations | | Documentation | 352+ | Technical guides and references | | Commits | 305+ | Active development history |

⚡ Power Generation Controls & Data Center Infrastructure

Engineering modules for power generation controls, microgrid systems, and mission-critical data center infrastructure — spanning generator sequencing, SCADA/EPMS protocol integration, and commissioning validation.

Generator Sequencing & Paralleling Logic

Deterministic state-machine for multi-generator paralleling per IEEE 1547 / NFPA 110.

Generator state machine: OFFLINE → CRANKING → IDLE → RATED → SYNCHRONIZED → ONLINE
Synchronization checker: voltage/frequency/phase-angle match within configurable tolerances
Parallel bus controller: load sharing computation, priority-based load-shed execution
Black-start sequencer: critical load definition, NFPA 110 compliance validation

Source: src/digitalmodel/power/controls/ | Tests: tests/power/controls/

SCADA & Protocol Integration

Protocol simulation and data-mapping toolkit for Modbus TCP/RTU, DNP3, OPC UA, and EPMS/BMS integration.

Modbus register map: CSV import, raw-to-engineering scaling, consistency validation
DNP3 point list: analog/binary inputs, SEL RTAC-compatible config export
OPC UA node model: device tree → namespace builder, XML export (Ignition/Wonderware)
EPMS data model: generator/switchgear/BMS points, template compliance, Excel-ready I/O list

Source: src/digitalmodel/power/protocols/ | Tests: tests/power/protocols/

Microgrid Energy Management System

Rule-based microgrid EMS for grid-connected and island-mode operation per IEEE 1547.4.

Merit-order DER dispatch (PV → BESS → genset)
BESS controller: SOC management with derating bands and island-mode reserve
Island detection: ROCOF via linear regression, vector shift detection
Mode transitions: grid-connected ↔ islanded ↔ black-start

Source: src/digitalmodel/power/microgrid/ | Tests: tests/power/microgrid/ — 29 tests

Data Center Power Topology

UPS/STS/N+1 redundancy modeling with single-point-of-failure detection and Uptime Institute Tier I–IV classification.

Redundancy schemes: N, N+1, 2N, 2N+1
Cascaded power path: utility → MV switchgear → transformer → UPS → STS → PDU → rack
SPOF detection across multiple power paths
Tier classification with availability computation

Source: src/digitalmodel/power/datacenter/ | Tests: tests/power/datacenter/ — 42 tests

Commissioning Validation (FAT/SAT/IST)

Test procedure generator and results validator for generator and switchgear commissioning.

Phase-specific templates: FAT (insulation, hi-pot, relay, breaker, control logic), SAT (cable megger, grounding, phase rotation, protection, interlocks), IST (load test, failover, SCADA, e-stop, performance)
Test results validation against generated sequences
Punch list export with severity classification (critical/major/minor)

Source: src/digitalmodel/power/commissioning/ | Tests: tests/power/commissioning/ — 32 tests

Protection Relay Coordination

IEEE C37.112 inverse-time relay curve modeling for overcurrent and differential protection coordination.

Overcurrent relay types: 50 (instantaneous), 51 (time-overcurrent)
Differential relay (87) with slope and minimum operate current settings
Curve types: moderately inverse, very inverse, extremely inverse, definite time
Coordination checker: upstream/downstream grading margin validation
Time-current intersection calculator for relay curves

Source: src/digitalmodel/power/protection/ | Tests: tests/power/protection/ — 23 tests

IEC 61850 GOOSE Messaging

IEC 61850-8-1 GOOSE publisher/subscriber model with SCL structure generation and logical node mapping.

Logical node types: XCBR, XSWI, CSWI, PTOC, PDIF, MMXU, CILO
GOOSE control block, dataset, and data attribute models
Publisher/subscriber binding validation
SCL-compatible structure output (IED → AccessPoint → LDevice → LN0)

Source: src/digitalmodel/power/protocols/iec61850_goose.py | Tests: tests/power/protocols/ — 25 tests

Power Flow / Load Flow Calculator

Newton-Raphson power flow solver for radial and simple-loop distribution networks.

Bus types: slack (reference), PV (generator), PQ (load)
Y-bus (admittance matrix) assembly with transformer tap ratio support
Jacobian-based Newton-Raphson iterative solver
Results: bus voltages/angles, branch active/reactive flows, system losses

Source: src/digitalmodel/power/analysis/ | Tests: tests/power/analysis/ — 32 tests

Droop Control Simulator

Frequency/voltage droop response modeling for parallel generator load sharing.

Governor droop: frequency→power output with configurable droop percentage
AVR droop: voltage→reactive power mapping
N-generator parallel load sharing solver (bisection method)
Isochronous + droop mix support
Droop setting recommender for target load split ratios

Source: src/digitalmodel/power/microgrid/droop_control.py | Tests: tests/power/microgrid/test_droop_control.py — 29 tests

🛡️ Cathodic Protection Design

Multi-standard cathodic protection design platform for offshore structures, pipelines, vessels, and generator fuel systems.

| Standard | Scope | Tests | |----------|-------|-------| | DNV-RP-B401 | Offshore structures — anode sizing, coating breakdown, zone-based design | 36 | | API RP 1632 | Underground pipelines — Dwight resistance, current demand, anode life | 16 | | ISO 15589-2 | Offshore pipelines — bracelet anodes, attenuation length | 20 | | Fuel System CP | Generator fuel piping — impressed current, ground bed, rectifier design | 22 | | ABS GN Ships/Offshore | Vessel hulls and floating structures | configured |

Structure types: submarine pipelines, vessel hulls, fixed offshore platforms
Anode materials: Al-Zn-In, zinc, magnesium (H-1 alloy)
16 worked example calculations: docs/domains/cathodic_protection/examples/
Standards inventory (21 standards audited): standards-inventory.md

Source: src/digitalmodel/cathodic_protection/ | Tests: tests/cathodic_protection/ — 72 tests

🌍 GIS & Infrastructure Asset Management

Geospatial analysis library for infrastructure asset management — 27 modules, ~5,000 lines.

Core: CRS transformation (UTM ↔ lat/long), spatial queries, geometry operations
I/O: GeoJSON, GeoTIFF, KML/KMZ, ESRI Shapefile
Visualization: Folium (web maps), Plotly (3D/2D), QGIS, Google Earth, Blender (3D mesh)
Layers: Feature, raster, temporal, well position

Source: [src/digitalmodel/gis/](sr

Digitalmodel

Install / Use

README