ashfordeOU/aero-agent-skills / skills/aerodynamics/airfoil/xfoil-analysis
xfoil-analysis
VerifiedUse when running XFOIL-style airfoil analysis for a given section: plan viscous and inviscid polar runs, validate lift and drag coefficient points against physical plausibility bands, and check NACA 0012 results at Reynolds number 6 million against the classic wind-tunnel anchor (lift coefficient about 0.82 at 10 degrees, zero-lift drag about 0.0079). Distinguishes inviscid runs (drag meaningless) from viscous runs and flags high-drag cases needing transition or mesh-density checks. Trigger: xfoil, airfoil, polar, lift coefficient, drag coefficient, naca, viscous analysis, reynolds number, transition.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.2 KB |
| scripts/test_xfoil_analysis.py | script | 3.5 KB |
| scripts/xfoil_analysis_logic.py | script | 3.2 KB |
scripts/xfoil_analysis_logic.py
View on GitHub#!/usr/bin/env python3
"""XFOIL airfoil polar analysis logic (paraphrase, common knowledge).
Common-knowledge summary (standards-map.yaml, naca-tr-824: public
domain): NACA Report 824 (Abbott, von Doenhoff, Stivers) is the classic
airfoil section data reference and the validation anchor for airfoil
analysis tools such as XFOIL. Its wind-tunnel polars, e.g. NACA 0012 at
Reynolds number 6 million (lift coefficient about 0.82 at 10 degrees
angle of attack, zero-lift drag coefficient about 0.0079), are used here
as the sanity band for XFOIL-style polar runs. XFOIL inviscid mode
produces no meaningful drag; viscous analysis with transition is
required for drag results.
"""
ALPHA_MIN = -25.0
ALPHA_MAX = 30.0
CL_MIN = -2.5
CL_MAX = 2.5
CD_MIN = 0.0
CD_MAX = 0.2
# NACA 0012 at Re = 6e6 anchor bands (NACA TR-824, brief 05 item 7).
NACA0012_CL_10DEG_MIN = 0.77
NACA0012_CL_10DEG_MAX = 0.87
NACA0012_CD0_MIN = 0.0069
NACA0012_CD0_MAX = 0.0089
def plausible_alpha(alpha_deg):
"""True if the angle of attack (deg) is within the polar band."""
return ALPHA_MIN <= alpha_deg <= ALPHA_MAX
def validate_polar_point(alpha_deg, cl, cd, re):
"""Structurally validate one polar point; True when plausible.
Raises ValueError for nonsense inputs: angle of attack outside the
polar band, lift coefficient outside [-2.5, 2.5], drag coefficient
outside [0, 0.2], or Reynolds number <= 0.
"""
if not plausible_alpha(alpha_deg):
raise ValueError(
"alpha %r deg outside polar band [%g, %g]" % (alpha_deg, ALPHA_MIN, ALPHA_MAX)
)
if not (CL_MIN <= cl <= CL_MAX):
raise ValueError("cl %r outside plausible band [%g, %g]" % (cl, CL_MIN, CL_MAX))
if not (CD_MIN <= cd <= CD_MAX):
raise ValueError("cd %r outside plausible band [%g, %g]" % (cd, CD_MIN, CD_MAX))
if re <= 0:
raise ValueError("Reynolds number must be > 0, got %r" % (re,))
return True
def naca0012_sanity(cl_at_10deg, cd0):
"""Check a polar against the NACA 0012 (Re = 6e6) anchor.
Returns a dict with cl_ok (0.77 <= cl <= 0.87), cd0_ok
(0.0069 <= cd0 <= 0.0089), is_sane (both ok), and a note string.
"""
cl_ok = NACA0012_CL_10DEG_MIN <= cl_at_10deg <= NACA0012_CL_10DEG_MAX
cd0_ok = NACA0012_CD0_MIN <= cd0 <= NACA0012_CD0_MAX
if cl_ok and cd0_ok:
note = "polar inside the NACA 0012 Re = 6e6 anchor band"
elif cl_ok:
note = "cl ok, but cd0 outside the NACA 0012 Re = 6e6 anchor band"
elif cd0_ok:
note = "cd0 ok, but cl at 10 deg outside the NACA 0012 Re = 6e6 anchor band"
else:
note = "cl at 10 deg and cd0 both outside the NACA 0012 Re = 6e6 anchor band"
return {"cl_ok": cl_ok, "cd0_ok": cd0_ok, "is_sane": cl_ok and cd0_ok, "note": note}
def cd0_hint(cd0):
"""Diagnostic hint for a zero-lift drag coefficient.
Near-zero cd0 suggests an inviscid run (XFOIL inviscid drag is
meaningless); high cd0 suggests transition or mesh-density problems.
Returns None when the value is unremarkable.
"""
if 0 < cd0 < 0.005:
return "likely inviscid run: XFOIL inviscid drag is meaningless; rerun viscous"
if cd0 > 0.02:
return "high drag: check transition and mesh density"
return None
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |