agentleFS
equinorequinor/neqsim-community-skills/skills/process/neqsim-piping-flexibility-screening/SKILL.md

neqsim-piping-flexibility-screening

Skill4 starsChanged 5 months agoApache-2.0View on GitHub

Educational piping-flexibility screening using open ASME B31.3 / B16.5 style relations. USE WHEN: a task needs a public, screening-level check of hoop (sustained) stress, thermal expansion, displacement (expansion) stress range, and a flange-rating pressure check for a process pipe run before detailed pipe-stress analysis.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    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
  1. Distinctive:

    Use this skill for public, educational piping-flexibility screening.

    line 16
  2. Distinctive:

    When a user asks whether a hot pipe run needs an expansion loop or whether a flange class is adequate.

    line 20
  3. Distinctive:

    When an agent needs a quick hoop-stress and thermal-expansion estimate for a process line.

    line 21
  4. Distinctive:

    When examples must run without confidential isometrics, stress-analysis models, or company piping specs.

    line 22
  5. Distinctive:

    No proprietary isometrics, stress-analysis models, or company piping specs are included.

    line 115

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Piping Flexibility Screening

Use this skill for public, educational piping-flexibility screening. It estimates hoop (sustained) stress, free thermal expansion, displacement (expansion) stress range against a simplified allowable, and a flange-rating pressure check so an agent can scope a pipe-flexibility study before detailed pipe-stress analysis.

When to Use

  • When a user asks whether a hot pipe run needs an expansion loop or whether a flange class is adequate.
  • When an agent needs a quick hoop-stress and thermal-expansion estimate for a process line.
  • When examples must run without confidential isometrics, stress-analysis models, or company piping specs.

Inputs

  • outside_diameter_mm: pipe outside diameter in mm.
  • wall_thickness_mm: pipe wall thickness in mm.
  • design_pressure_bar: internal design pressure in bar gauge.
  • design_temperature_c: design (operating) temperature in degrees Celsius.
  • pipe_length_m: straight run length in m.
  • install_temperature_c: installation/ambient temperature in degrees Celsius, default 20.
  • anchor_to_anchor: whether the run is fully restrained anchor-to-anchor, default True.
  • youngs_modulus_mpa: Young's modulus in MPa, default 200000.
  • thermal_expansion_coeff_per_k: mean thermal expansion coefficient per K, default 1.2e-5.
  • allowable_stress_mpa: material allowable stress in MPa, default 138.
  • flange_rating_class: optional ASME B16.5 flange class (e.g. 150, 300, 600).
  • flange_allowable_pressure_bar: optional flange allowable pressure at temperature in bar.

Outputs

  • hoop_stress_mpa: Barlow hoop (sustained) stress.
  • hoop_stress_ratio: hoop stress divided by allowable stress.
  • delta_temperature_k: design minus install temperature difference.
  • free_thermal_expansion_mm: unrestrained thermal growth of the run.
  • displacement_stress_mpa: displacement (expansion) stress estimate.
  • allowable_stress_range_mpa: simplified allowable stress range.
  • displacement_stress_ratio: displacement stress divided by the allowable range.
  • flange_pressure_ratio: design pressure divided by flange allowable pressure, or null.
  • stress_warning: ok, watch, hoop-stress-exceeded, or expansion-stress-exceeded.
  • flange_warning: ok, flange-overpressure, or no-rating.
  • assumptions: public assumptions used by the placeholder model.

Engineering Method

The Python class PipingFlexibilityModel uses open piping relations only:

  • hoop stress uses the thin-wall Barlow relation S_h = P D / (2 t).
  • thermal strain uses epsilon = alpha |T_design - T_install|.
  • free thermal expansion uses dL = epsilon * L.
  • displacement stress uses the fully restrained worst case S_E = E alpha dT, with a fixed relief factor when the run is not anchor-to-anchor.
  • the allowable stress range uses a simplified S_A = 1.5 * S_allow (screening of f (1.25 S_c + 0.25 S_h)).
  • the flange check compares design pressure to a supplied flange allowable pressure.

This is educational and screening-only logic. It assumes thin-wall pressure stress, a single straight run, constant material properties, and a fully restrained worst-case expansion stress. It is not a replacement for validated pipe-stress/flexibility analysis or qualified piping-engineering review.

Python Usage Pattern

from piping_flexibility_screening import PipingFlexibilityModel

model = PipingFlexibilityModel()
result = model.evaluate(
    outside_diameter_mm=168.3,
    wall_thickness_mm=7.11,
    design_pressure_bar=50.0,
    design_temperature_c=180.0,
    pipe_length_m=40.0,
    flange_allowable_pressure_bar=49.6,
)

print(result.hoop_stress_mpa)
print(result.displacement_stress_mpa)
print(result.stress_warning)
print(result.flange_warning)

Related NeqSim Functionality

For validated mechanical-design calculations, redirect to NeqSim classes:

  • neqsim.process.mechanicaldesign.pipeline.PipelineMechanicalDesign — pipeline wall thickness and mechanical design.
  • neqsim.process.mechanicaldesign.pipeline.PipingFlexibilityCalculator — proposed pipe-stress/flexibility screening (sustained and displacement stress, flange checks); candidate NeqSim gap.
  • neqsim.process.equipment.pipeline.PipeBeggsAndBrills — hydraulic and thermal pipe model for line conditions.

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

Validation Checklist

  • Outside diameter and wall thickness are positive and t < D/2.
  • Design pressure, length, and material properties are positive.
  • Tests cover hoop stress, displacement stress, the flange check, and invalid input.
  • Results are described as educational screening indicators.
  • Real flexibility analysis is redirected to validated NeqSim classes and qualified review.

Common Mistakes

SymptomCauseFix
Displacement stress always highAnchor-to-anchor worst case usedRoute an expansion loop or set anchor_to_anchor=False
Flange ratio missingNo flange allowable pressure suppliedProvide flange_allowable_pressure_bar for the check
Hoop stress underestimatedThin-wall Barlow used on thick wallUse a validated thick-wall pipe-stress model

Limitations

  • No proprietary isometrics, stress-analysis models, or company piping specs are included.
  • A single straight run is modelled; bends, branches, and supports are not analysed.
  • Displacement stress uses a fully restrained worst case; real flexibility depends on routing.

References

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.