neqsim-reciprocating-compressor-screening
Skill4 starsChanged 5 months agoApache-2.0View on GitHub
Educational reciprocating-compressor screening using the public clearance volumetric-efficiency relation (API 618 / API 619 style). USE WHEN: a task needs a public, screening-level estimate of volumetric efficiency, actual inlet capacity, staging, discharge temperature, and rod-load utilisation for a reciprocating compressor before detailed selection.
In this repository90 other files it gives its agents.
- neqsim-document-intelligence-extractionSkill
- neqsim-co2-emissions-screeningSkill
- neqsim-energy-emissions-screeningSkill
- neqsim-weather-dataSkill
- neqsim-anp-open-dataSkill
- neqsim-artificial-lift-screeningSkill
- neqsim-asset-value-npv-screeningSkill
- neqsim-capex-opex-screeningSkill
- neqsim-design-basis-screeningSkill
- neqsim-economy-basis-screeningSkill
- neqsim-ncs-infrastructure-networkSkill
- neqsim-ncs-ownership-equitySkill
- neqsim-ncs-value-chain-optimizationSkill
- neqsim-norwegian-continental-shelf-dataSkill
- neqsim-psc-bid-economics-screeningSkill
- neqsim-reservoir-depletion-screeningSkill
- neqsim-reservoir-facility-value-chainSkill
- neqsim-reservoir-model-builderSkill
- neqsim-resource-classification-screeningSkill
- neqsim-hydrate-margin-checkSkill
- neqsim-hydrate-screeningSkill
- neqsim-multiphase-flow-slug-screeningSkill
- neqsim-olga-multiphase-simulatorSkill
- neqsim-produced-water-scale-screeningSkill
- neqsim-surf-cooldown-screeningSkill
- neqsim-two-phase-flow-regime-screeningSkill
- neqsim-wax-margin-checkSkill
- neqsim-acoustic-induced-vibration-screeningSkill
- neqsim-adsorbent-capillary-condensation-screeningSkill
- neqsim-ageing-life-extension-screeningSkill
- neqsim-cfd-couplingSkill
- neqsim-compressor-antisurge-recycleSkill
- neqsim-compressor-operating-window-checkSkill
- neqsim-compressor-power-screeningSkill
- neqsim-continuous-improvement-toolkitSkill
- neqsim-control-authority-screeningSkill
- neqsim-control-valve-cv-screeningSkill
- neqsim-dry-gas-seal-screeningSkill
- neqsim-dynamic-instrument-controller-setupSkill
- neqsim-dynamic-process-preparationSkill
- neqsim-fem-couplingSkill
- neqsim-fired-heater-duty-screeningSkill
- neqsim-flow-induced-vibration-screeningSkill
- neqsim-gas-scrubber-sizing-screeningSkill
- neqsim-gas-turbine-performance-screeningSkill
- neqsim-heat-exchanger-fouling-assessmentSkill
- neqsim-line-velocity-checkSkill
- neqsim-noise-screeningSkill
- neqsim-pipe-wall-thickness-screeningSkill
- neqsim-piping-flexibility-screeningSkill
- neqsim-pressure-drop-screeningSkill
- neqsim-pump-hydraulics-screeningSkill
- neqsim-reliability-data-screeningSkill
- neqsim-sand-erosion-screeningSkill
- neqsim-separator-modellingSkill
- neqsim-teg-dehydration-modelingSkill
- neqsim-uncertainty-quantificationSkill
- neqsim-utility-balance-screeningSkill
- neqsim-water-dewpoint-dehydration-screeningSkill
- neqsim-benchmark-reference-dataSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Use this skill for public, educational reciprocating-compressor screening.
- Distinctive: line 20
When a user asks how many stages a reciprocating compressor needs or what its volumetric efficiency is.
- Distinctive: line 21
When an agent needs a quick actual-capacity and discharge-temperature estimate for a positive-displacement machine.
- Distinctive: line 22
When examples must run without confidential compressor data, vendor curves, or company specs.
- Distinctive: line 109
No proprietary compressor data, vendor curves, or company specs are included.
- Distinctive: line 110
No valve losses, pulsation, or real-gas property variation are modelled.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Reciprocating Compressor Screening
Use this skill for public, educational reciprocating-compressor screening. It estimates clearance volumetric efficiency, actual inlet capacity, the required number of stages, discharge temperature, and a rod-load utilisation ratio so an agent can scope a reciprocating-compression study before detailed selection.
When to Use
- When a user asks how many stages a reciprocating compressor needs or what its volumetric efficiency is.
- When an agent needs a quick actual-capacity and discharge-temperature estimate for a positive-displacement machine.
- When examples must run without confidential compressor data, vendor curves, or company specs.
Inputs
suction_pressure: stage suction pressureP1in bar absolute.discharge_pressure: final discharge pressureP2in bar absolute.suction_temperature: suction temperatureT1in kelvin.swept_volume_rate_m3_h: geometric (swept) volume rate in m3/h.clearance_fraction: cylinder clearance fractionC, default 0.12.specific_heat_ratio: ratio of specific heatsk, default 1.3.leakage_allowance: leakage/loss allowanceL, default 0.03.rated_rod_load_kn: optional rated rod load in kN for the rod-load comparison.piston_area_m2: optional piston area in m2 for the rod-load comparison.
Outputs
pressure_ratio: overallP2 / P1.stages: integer number of stages keeping each stage belowmax_stage_ratio.stage_pressure_ratio: per-stage pressure ratio.volumetric_efficiency: clearance volumetric efficiency.actual_inlet_capacity_m3_h: swept rate multiplied by volumetric efficiency.discharge_temperature_k: first-stage isentropic discharge temperature.rod_load_ratio: gas rod load divided by rated rod load, ornull.capacity_warning:ok,watch,low-volumetric-efficiency, ordischarge-temp-high.rod_load_warning:ok,watch,rod-load-exceeded, orno-rating.assumptions: public assumptions used by the placeholder model.
Engineering Method
The Python class ReciprocatingCompressorModel uses open positive-displacement relations only:
- staging splits the overall ratio so
stage_ratio = (P2 / P1)^(1/stages)stays belowmax_stage_ratio(default 4.0). - volumetric efficiency uses
VE = 1 - C (r^(1/k) - 1) - L. - actual inlet capacity uses
Q_actual = swept_rate * VE. - discharge temperature uses
T2 = T1 r^((k-1)/k). - gas rod load uses
F = dP * piston_area, compared to the rated rod load.
This is educational and screening-only logic. It assumes constant k, ideal staging, no valve or pulsation losses, and gas-only rod load. It is not a replacement for validated reciprocating-compressor sizing or qualified rotating-equipment review.
Python Usage Pattern
from reciprocating_compressor_screening import ReciprocatingCompressorModel
model = ReciprocatingCompressorModel()
result = model.evaluate(
suction_pressure=2.0,
discharge_pressure=120.0,
suction_temperature=313.15,
swept_volume_rate_m3_h=800.0,
rated_rod_load_kn=120.0,
piston_area_m2=0.04,
)
print(result.stages)
print(result.volumetric_efficiency)
print(result.rod_load_warning)Related NeqSim Functionality
For validated compression calculations, redirect to NeqSim classes:
neqsim.process.equipment.compressor.Compressor— rigorous polytropic compression with real-gas properties.neqsim.process.equipment.compressor.ReciprocatingCompressor— proposed reciprocating-compressor model (volumetric efficiency, valve losses, rod load); candidate NeqSim gap.neqsim.process.mechanicaldesign.compressor.CompressorMechanicalDesign— compressor mechanical design and feasibility.
This skill is a public triage layer that decides when to invoke a validated reciprocating-compressor model.
Validation Checklist
- Suction and discharge pressures are positive and
P2 > P1. - Clearance fraction is in
(0, 1)and leakage allowance in[0, 1). - Tests cover staging, volumetric efficiency, a rod-load comparison, and invalid input.
- Results are described as educational screening indicators.
- Real selection is redirected to validated NeqSim compressor classes and qualified review.
Common Mistakes
| Symptom | Cause | Fix |
| Volumetric efficiency near zero | Single high-ratio stage | Let the staging logic add stages |
| Discharge temperature too high | High stage ratio | Add stages or intercooling |
| Rod-load ratio missing | No rated rod load or piston area supplied | Provide both for the comparison |
Limitations
- No proprietary compressor data, vendor curves, or company specs are included.
- No valve losses, pulsation, or real-gas property variation are modelled.
- Rod load uses gas load only; inertia and load reversal are not included.
References
- API Standard 618, Reciprocating Compressors for Petroleum, Chemical, and Gas Industry Services.
- API Standard 619, Rotary-Type Positive-Displacement Compressors.
- NeqSim repository: https://github.com/equinor/neqsim
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

