GT-SUITE / GT-POWER Modeling (.gtm, .gtd, .gtx, .gt)

The @modelscript/gtsuite package (languages/gtsuite) provides native compilation, simulation, analysis, and multi-domain projections for Gamma Technologies GT-SUITE and GT-POWER 1D engine, powertrain, turbocharging, and thermo-fluid dynamic simulation models.

---

Supported File Specifications

Extension	Format	Key Structural Features
.gtm / .gtd	GT-SUITE Model Deck	ASCII and XML representations of cylinders, plenums, runners, valves, injectors, and turbochargers
.dat / .map	Tabular Component Maps	Compressor and turbine pressure ratio vs. corrected mass flow and efficiency performance maps
.gdx / .csv	Trajectory Results	Crank-resolved in-cylinder pressure, temperature, burn rate, and emissions time series

---

Architecture & Compilation Pipeline

Rendering diagram...

---

Pre-Flight Powertrain Linter Rules

15 rules8 warning7 error Run with msx lint

All severitieswarningerror

Code	Rule	Severity	Message
M9001	cfl-acoustic-violation	warning	Pipe '<pipeId>' cell length violates acoustic CFL condition: simulation dt (<value> \xB5s) exceeds stability limit (<value> \xB5s).
M9002	compressor-surge-hazard	warning	Compressor '<compId>' operating point (PR = <value>, \u1E41 = <value> kg/s) falls into the aerodynamic surge region.
M9003	compressor-choke-limit	warning	Compressor '<compId>' mass flow (<value> kg/s) exceeds maximum choke/stonewall sonic flow capacity.
M9004	valve-profile-overlap-error	error	Valve '<valveId>' kinematic profile defect: <reason>.
M9005	compression-ratio-invalid	error	Cylinder '<cylId>' compression ratio (<value>) is physically unrealistic (must be between 6.0 and 26.0).
M9006	unconnected-plenum-node	error	Flow split or plenum '<plenumId>' has no connected flow paths or boundary conditions.
M9007	discharge-coefficient-out-of-bounds	warning	Valve or orifice '<valveId>' discharge coefficient (<value>) is non-physical (must satisfy 0.0 < Cd <= 1.0).
M9008	knock-margin-deficit	warning	Cylinder '<cylId>' operates in severe autoignition/knock hazard (CR = <value>, ignition anchor = <value>\xB0 CA BTDC).
M9009	missing-boundary-pressure	error	Environment node '<envId>' has invalid or uninitialized static pressure (<= 0 Pa).
M9010	turbine-expansion-ratio-excess	warning	Turbine '<turbId>' expansion ratio (<value>) exceeds single-stage choked limit (> 4.5).
M9011	intercooler-effectiveness-invalid	warning	Intercooler '<icId>' thermal effectiveness (<value>) violates 2nd Law of Thermodynamics (must satisfy 0.0 < eff <= 1.0).
M9012	air-fuel-equivalence-out-of-bounds	error	Air-fuel equivalence ratio lambda (<value>) is outside combustible flammability limits (0.50 <= lambda <= 2.50).
M9013	negative-pipe-dimensions	error	Pipe '<pipeId>' has non-positive <dim> (<value> m).
M9014	injector-timing-conflict	error	Injector '<injId>' start of injection (<value>\xB0 CA) falls outside valid cycle window (-360\xB0 to +720\xB0).
M9015	isolated-shaft-inertia	warning	Turbocharger shaft '<shaftId>' has no linked compressor or turbine rotating components.

Generated from languages/gtsuite/src/lints/index.ts. All languages →

---

Headless CLI Operations (msx gtsuite)

# Print model summary
msx gtsuite summary cases/Turbo4Cyl.gtm

# Run pre-flight static analysis
msx gtsuite lint cases/Turbo4Cyl.gtm

# Run in-WASM transient thermodynamic simulation
msx gtsuite simulate cases/Turbo4Cyl.gtm --duration=0.5 --out=trajectories.csv

# Evaluate formal verification gates (BSFC, boost, emissions, knock)
msx gtsuite verify cases/Turbo4Cyl.gtm --max-bsfc=240.0 --max-boost=2.8 --max-nox=60.0

# Export vector schematic SVG diagram
msx gtsuite diagram cases/Turbo4Cyl.gtm --view=schematic --out=engine_schematic.svg

# Project to Modelica and SysML v2
msx gtsuite to-modelica cases/Turbo4Cyl.gtm --out=Engine.mo
msx gtsuite to-sysml2 cases/Turbo4Cyl.gtm --out=Engine.sysml