# Neqsim Gas Turbine Performance Screening

> Educational gas-turbine performance screening using open ISO 3977 / GL1029 style derate factors. USE WHEN: a task needs a public, screening-level estimate of site-rated shaft power, site heat rate, thermal efficiency, fuel heat input, exhaust mass flow, and exhaust temperature for a gas-turbine driver before detailed package selection.

- **Type:** Skill
- **Install:** `agentstack add skill-equinor-neqsim-community-skills-gas-turbine-performance-screening`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [equinor](https://agentstack.voostack.com/s/equinor)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [equinor](https://github.com/equinor)
- **Source:** https://github.com/equinor/neqsim-community-skills/tree/main/skills/process/gas-turbine-performance-screening
- **Website:** https://equinor.github.io/neqsimhome/

## Install

```sh
agentstack add skill-equinor-neqsim-community-skills-gas-turbine-performance-screening
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Gas Turbine Performance Screening

Use this skill for public, educational gas-turbine performance screening. It corrects an ISO base rating for ambient temperature, site elevation, and inlet/exhaust pressure losses to estimate site-rated shaft power, site heat rate, thermal efficiency, fuel heat input, exhaust mass flow, and exhaust temperature so an agent can scope a driver-selection study before detailed package review.

## When to Use

- When a user asks how much power a gas-turbine driver makes at site conditions versus its ISO rating.
- When an agent needs a quick site heat rate, fuel heat input, or exhaust mass flow estimate for waste-heat or HRSG scoping.
- When examples must run without confidential vendor performance maps or company package specs.

## Inputs

- `iso_base_power_kw`: ISO base-load shaft power rating in kW.
- `iso_heat_rate_kj_kwh`: ISO base-load heat rate in kJ/kWh.
- `ambient_temperature_k`: site ambient temperature in kelvin, default 288.15 (ISO reference).
- `site_elevation_m`: site elevation above sea level in m, default 0.
- `relative_humidity`: site relative humidity fraction, default 0.6 (small effect).
- `inlet_pressure_loss_mbar`: inlet system pressure loss in mbar, default 10.
- `exhaust_pressure_loss_mbar`: exhaust system pressure loss in mbar, default 10.
- `required_shaft_power_kw`: optional driven-equipment shaft power in kW for the margin check.

## Outputs

- `site_power_kw`: derated site shaft power.
- `ambient_derate_factor`: ambient-temperature power factor.
- `altitude_derate_factor`: site-elevation power factor.
- `pressure_loss_derate_factor`: combined inlet/exhaust pressure-loss power factor.
- `total_derate_factor`: product of all derate factors.
- `site_heat_rate_kj_kwh`: site heat rate after efficiency degradation.
- `thermal_efficiency`: shaft thermal efficiency from the site heat rate.
- `fuel_heat_input_kw`: fuel lower-heating-value heat input.
- `exhaust_mass_flow_kg_s`: screening exhaust mass flow.
- `exhaust_temperature_k`: screening exhaust temperature.
- `power_margin_ratio`: site power divided by required shaft power, or `null`.
- `power_warning`: `ok`, `watch`, `insufficient-power`, or `no-rating`.
- `assumptions`: public assumptions used by the placeholder model.

## Engineering Method

The Python class `GasTurbinePerformanceModel` uses open performance-derate relations only:

- ambient derate uses `f_amb = 1 - 0.007 (T_amb - 288.15)`, clamped at zero.
- altitude derate uses `f_alt = 1 - 1.1e-4 * elevation`, from reduced barometric pressure.
- pressure-loss derate uses `f_inlet = 1 - 0.002 * dP_inlet` and `f_exhaust = 1 - 0.001 * dP_exhaust`.
- site power uses `P_site = P_iso * f_amb * f_alt * f_inlet * f_exhaust * f_humidity`.
- site heat rate uses `HR_site = HR_iso (1 + 0.5 (1 - f_total))` so efficiency falls with derate.
- fuel heat input uses `Q_fuel = P_site * HR_site / 3600`.
- exhaust mass flow uses a fixed specific-flow factor `m_exh = P_site * 0.003`.

This is educational and screening-only logic. It assumes linear derates, a fixed specific exhaust flow, and a typical exhaust temperature. It is not a replacement for validated gas-turbine performance models or qualified package review.

## Python Usage Pattern

```python
from gas_turbine_performance_screening import GasTurbinePerformanceModel

model = GasTurbinePerformanceModel()
result = model.evaluate(
    iso_base_power_kw=30000.0,
    iso_heat_rate_kj_kwh=9500.0,
    ambient_temperature_k=303.15,
    site_elevation_m=50.0,
    required_shaft_power_kw=26000.0,
)

print(result.site_power_kw)
print(result.site_heat_rate_kj_kwh)
print(result.power_warning)
```

## Related NeqSim Functionality

For validated power-generation calculations, redirect to NeqSim classes:

- `neqsim.process.equipment.powergeneration.GasTurbine` — gas-turbine driver model with fuel and exhaust calculations.
- `neqsim.process.equipment.powergeneration.HRSG` — heat-recovery steam generator using turbine exhaust.
- `neqsim.process.equipment.powergeneration.CombinedCycleSystem` — combined-cycle integration of turbine and steam systems.

This skill is a public triage layer that decides when to invoke a validated gas-turbine model.

## Validation Checklist

- [ ] ISO base power and heat rate are positive.
- [ ] Ambient temperature is positive and elevation is non-negative.
- [ ] Tests cover ambient derate, the power margin, the fuel/efficiency estimate, and invalid input.
- [ ] Results are described as educational screening indicators.
- [ ] Real driver selection is redirected to validated NeqSim power-generation classes and qualified review.

## Common Mistakes

| Symptom | Cause | Fix |
| --- | --- | --- |
| Site power above ISO rating | Ambient below 288.15 K | Screening caps uprate; treat sub-ISO gains conservatively |
| Power margin missing | No required shaft power supplied | Provide `required_shaft_power_kw` for the margin check |
| Exhaust flow looks flat | Fixed specific-flow factor used | Use a validated gas-turbine model for HRSG sizing |

## Limitations

- No proprietary vendor performance maps, fuel composition effects, or company specs are included.
- Derates are linear screening factors; part-load, water injection, and DLE effects are not modelled.
- Exhaust mass flow and temperature use fixed screening assumptions, not a heat-and-mass balance.

## References

- ISO 3977, Gas turbines — Procurement.
- ISO 2314, Gas turbines — Acceptance tests.
- NeqSim repository: https://github.com/equinor/neqsim

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [equinor](https://github.com/equinor)
- **Source:** [equinor/neqsim-community-skills](https://github.com/equinor/neqsim-community-skills)
- **License:** Apache-2.0
- **Homepage:** https://equinor.github.io/neqsimhome/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-equinor-neqsim-community-skills-gas-turbine-performance-screening
- Seller: https://agentstack.voostack.com/s/equinor
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.