科研 Skill
疲劳断裂寿命分析
fatigue-fracture-analysis
Estimates fatigue life and crack-growth life for metal parts from S-N data, load histories, and fracture-mechanics inputs. Use for Miner’s-rule damage, rainflow counting, or Paris-law crack growth.
SKILL.md
Fatigue and Fracture Analysis
Estimates how long a metal part will survive under cyclic loading, by two complementary
routes: S-N (stress-life) fatigue with cumulative-damage summation, and linear elastic
fracture mechanics (LEFM) crack-growth life. Use this when a part sees repeated loading
and the question is "how many cycles" or "how many crack-growth cycles to failure", not
a single static overload (use machine-element-sizing or quick-fea for that).
Purpose
- Turn a measured or assumed load history into a fatigue-damage estimate using Miner's rule, with proper cycle counting (rainflow) for variable-amplitude signals.
- Fit or apply an S-N curve (Basquin equation) for a material, including mean-stress correction (Goodman, Gerber, or Soderberg) and a stress-concentration (notch) factor.
- Estimate remaining life of a known or postulated crack with the Paris law, and compare the critical crack size against fracture toughness.
- Report a safety factor and the dominant source of uncertainty (material scatter, load measurement, or SCF/K estimate), not just a cycle count.
Prerequisites
numpy, scipy, and matplotlib (pip install numpy scipy matplotlib). A material
S-N dataset or standard parameters (references/material_fatigue_data.md has indicative
values for common steels and aluminum alloys — always prefer a dataset specific to the
actual material and surface condition when one is available). A load history (time series
of stress or strain) for variable-amplitude work, or a single stress amplitude and mean
stress for constant-amplitude work.
Workflow
-
Classify the problem.
- Constant-amplitude, high-cycle (elastic, >~10^4 cycles): use the S-N route directly.
- Variable-amplitude: rainflow-count the load history first, then apply S-N + Miner's rule to each counted cycle bin.
- Known or suspected crack (weld defect, inclusion, scratch, prior fatigue damage): use the Paris-law route, and check LEFM applies (small-scale yielding — see Limitations).
- Low-cycle fatigue (<~10^4 cycles, visible plastic strain each cycle): the Basquin S-N fit is not valid; use a strain-life (Coffin-Manson) approach instead — flag this to the user rather than silently applying S-N.
-
Get or fit the S-N curve.
python scripts/fatigue.py sn-fit --data cycles_stress.csvfitsS = S_f' * (2N)^b(Basquin) by log-log linear regression and reports the fatigue strength coefficient, exponent, and R². Without data, use literature values fromreferences/material_fatigue_data.md, state the source, and flag it as an estimate. -
Correct for mean stress if the cycle has a nonzero mean (most real loads do):
python scripts/fatigue.py mean-stress --amp 120 --mean 40 --ultimate 550 --method goodmanGoodman is conservative for brittle/typical cases; Gerber fits ductile metal data better but is non-conservative near zero mean stress — default to Goodman unless the user asks. -
Count cycles in a variable-amplitude history:
python scripts/fatigue.py rainflow --signal load.csv --col stressoutputs cycle ranges, means, and counts (ASTM E1049 rainflow algorithm). Never sum peak-to-peak ranges directly without rainflow counting — it over- or under-counts damage. -
Sum damage (Miner's rule):
python scripts/fatigue.py miner --cycles rainflow_output.csv --sn-b -0.1 --sn-sf 900reports total damageD = sum(n_i / N_i)and life in repeats-of-the-history if D < 1 (failure predicted when D ≥ 1). Report D itself, not just pass/fail — a D of 0.05 and a D of 0.9 both "pass" today but have very different margins. -
Crack-growth life (if applicable):
python scripts/fatigue.py paris --a0 0.5 --af 12 --C 6.9e-12 --m 3.0 --dK-func "constant" --dsigma 80integratesda/dN = C*(ΔK)^mfrom initial flaw sizea0to critical/final sizeaf(fromK_ICor a geometry limit) and reports cycles to failure.ΔK = Y*Δσ*sqrt(pi*a)with a geometry factor Y (1.0 for a simple through-crack is the default; use a handbook Y for the actual geometry — this changes the answer significantly and must not be left at 1.0 silently). -
Report: load classification, S-N or Paris-law parameters and their source, mean- stress or geometry correction used, damage sum or crack-growth life, safety factor against the design life, and the single biggest uncertainty in the estimate.
Limitations
- S-N/Miner's rule assumes no sequence effects (load order doesn't matter) and no retardation after overloads; this is known to be inaccurate for spectra with large occasional overloads (overload-induced crack retardation is not modeled).
- LEFM (Paris law) requires small-scale yielding — plastic zone small relative to crack length and remaining ligament. For thin sections or high-toughness/low-yield-strength materials this can be violated; this skill does not check it automatically, so state the assumption and flag when the initial crack is a large fraction of the section.
- Material fatigue data in
references/material_fatigue_data.mdis indicative only (typical literature values), not certified design data; always prefer a dataset or handbook value specific to the real material, heat treatment, and surface finish. - No corrosion-fatigue, fretting-fatigue, thermal-fatigue, or weld-specific (e.g. IIW FAT class) methods are included; flag these cases to the user instead of silently applying a plain S-N curve.
references/material_fatigue_data.mdand the scripts are illustrative; cross-check any load-bearing or safety-critical conclusion againststructural-analysis/quick-feastress results and, where relevant, a qualified fatigue engineer's sign-off.
Related skills
machine-element-sizing (static sizing and basic shaft fatigue of standard elements),
structural-analysis (FEA-based stress for pump casings/impellers, including its own
fatigue discussion), quick-fea (general stress field from a STEP part to feed this
skill's S-N route), reliability-engineering (Weibull life analysis at the population
level, versus this skill's single-part deterministic life estimate).
Quality checks
- Reported damage sum and crack-growth life always come with the input parameters and their source (measured, fitted, or literature) printed alongside, not just a bare number.
- Rainflow-counted cycle totals account for the entire input history (verify
sum(counts) * 0.5or1.0per half/full cycle matches the signal's peak-valley count). - The script's
--selftestmode (python scripts/fatigue.py --selftest) checks the Paris integration against a closed-form constant-ΔK solution and the rainflow counter against a hand-countable reference signal; run it once after any edit to the script.
示例提示词
这个轴承座承受交变载荷,帮我用雨流计数和迈纳法则估算疲劳寿命。
所属插件
安装该插件会一并获得同领域的 35 个 Skill / MCP。
同插件的其他科研 Skill
- FDM增材制造可制造性设计Checks an existing STEP part for FDM printability with the AgentsCAD method: overhang detection, reorientation, chamfers, and kernel plus visual verification. Use for DFAM review before 3D printing.
- 激光粉末床合金可打印性筛选Screens metal alloy compositions for laser powder bed fusion printability using CALPHAD or built-in thermophysical data and Rosenthal melt pools. Use when choosing or qualifying an AM alloy.
- 增材制造文献问答检索Answers additive-manufacturing questions from the user’s own PDF library with page-cited evidence via retrieval. Use for literature-grounded AM questions instead of relying on memory.
- CADSmith文本生成CADGenerates dimensionally exact CadQuery CAD from natural language using the CADSmith plan-code-validate-refine loop. Use when the user describes a part in words and wants a CAD model.
- OpenFOAM CFD仿真自动搭建Sets up, runs, diagnoses, and reports OpenFOAM CFD cases from a plain-language request using registered flow families and deterministic accept/reject validators. Use for guided OpenFOAM case setup.
- 机械设计评审文档汇编Assembles a mechanical design-review package: requirements traceability, design FMEA with RPN, costed multi-level BOM, risk register, and a PDR/CDR checklist. Use when preparing a design review.
- 面向制造的可制造性评审Reviews a part or assembly for CNC machining, sheet metal, injection molding, casting, or 3D printing manufacturability, flagging rule violations. Use when the user asks for a DFM/DFMA check.
- 工程图纸与GD&T审查Reviews mechanical drawings (PDF, image, or DXF) for dimensioning errors, GD&T misuse, datum problems, and ASME Y14.5/ISO GPS compliance. Use when checking a drawing before release.
- 工程计算报告生成Turns engineering calculations or scripts into a formal calculation report with objective, assumptions, equations, and unit-checked results. Use for a calc report ready for sign-off.
- LLM-SR方程发现Discovers interpretable equations from engineering data with the LLM-SR loop: skeleton proposals, constant fitting, and out-of-domain scoring. Use for symbolic regression on experimental data.
- 图像直接生成FDM G代码Converts a photo, sketch, or slice image of a flat or near-flat part directly into FDM G-code without CAD, via silhouette and toolpath extraction. Use for sketch-to-print without modeling.
- 点阵结构刚度逆向设计Designs 3D-printable lattice unit cells for a target stiffness using TPMS cells, printability checks, and voxel homogenization. Use for lattice infill or metamaterial design.
- 平面连杆机构综合Synthesizes planar four-bar or six-bar linkages whose end-effector traces a target curve, using graph-based topology and forward-kinematics search. Use for mechanism path-generation problems.
- LLM驱动FDM打印逐层监控Monitors an FDM print layer by layer through Klipper/Moonraker, diagnosing defects from camera images and applying safety-bounded G-code corrections. Use to watch or fix a live 3D print.
- LLM迭代桁架优化设计Designs and optimizes 2D trusses with an LLM-in-the-loop FEM workflow where proposed members are scored by an exact truss FEM. Use for iterative truss topology or sizing optimization.
- L-PBF缺陷区间预测Predicts L-PBF defect regime (keyholing, lack of fusion, balling, or none) from process parameters and checks melt-pool dimensions against standard criteria. Use when selecting LPBF parameters.
- L-PBF熔池图像超分辨率Upscales low-cost webcam images of an L-PBF build plate to high resolution via registration and a trained diffusion or CNN model. Use for in-situ L-PBF monitoring with cheap cameras.
- 机械零件强度校核Sizes and checks machine elements: bolted joints, shafts for fatigue, bearings for L10 life, springs, welds, and gears, with shown work and safety factors. Use to size or verify a machine element.
- Ashby材料选型Selects engineering materials with the Ashby method: translate function and constraints into a performance index, then screen and rank a shortlist. Use when choosing between candidate materials.
- 产品逆向拆解分析Reverse-engineers a physical product as an engineering system: function structure, costed BOM, DFA index, should-cost, FMEA, and a printable HTML report. Use when asked to tear down a product.
- 力学教学图绘制Produces mechanics teaching figures such as Mohr’s circle, shear/moment diagrams, S-N curves, and free-body diagrams as PNG/SVG. Use when asked to draw or plot a mechanics concept.
- 增材制造熔池几何预测Predicts metal AM melt-pool depth, width, length, and mode (keyhole, lack of fusion, balling, desirable) from laser power, speed, and beam size. Use for LPBF parameter prediction.
- 自然语言参数化CAD建模Turns a plain-English or dimensioned part description into a parametric CadQuery script and exports STEP, STL, and a mass/volume report. Use when asked to model or generate a CAD part.
- FreeCAD自然语言建模Generates FreeCAD models from natural-language queries using the Query2CAD self-refinement loop: macro generation, error repair, and image-text scoring. Use for text-to-CAD in FreeCAD.
常见问题
疲劳断裂寿命分析能做什么?
Estimates fatigue life and crack-growth life for metal parts from S-N data, load histories, and fracture-mechanics inputs. Use for Miner’s-rule damage, rainflow counting, or Paris-law crack growth。
如何安装疲劳断裂寿命分析?
在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「疲劳断裂寿命分析」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。
疲劳断裂寿命分析需要哪些权限?
该科研 Skill没有声明额外权限;执行具体操作时仍由 Agent 按自身规则请求确认。
疲劳断裂寿命分析经过官方审核吗?
是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。