Add a geometry from yaml constructor for Wing

NEWS.md

@@ -1,3 +1,35 @@
+## VortexStepMethod v2.0.1 2025-08-08
+### Changed
+#### 1. Core New Functionality: YAML Geometry Support
+- **New file:** `yaml_geometry.jl` (290+ lines) — Complete YAML-based wing geometry loading.
+- **New structs:** `WingSectionData`, `WingAirfoilData`, `WingAirfoilInfo` (with `@with_kw` macros).
+- **New function:** `load_polar_data()` — Robust CSV polar data loading with error handling.
+- **New constructors:**
+    - `Wing(geometry_file::String)` — Create wings from YAML files.
+    - `Wing(settings::VSMSettings)` — Create wings from settings.
+
+#### 2. Enhanced Settings System
+- Renamed `vs()` to `VSMSettings()` constructor.
+- Added convenience `Solver(body_aero, settings)` constructor.
+- Improved settings structure and validation.
+
+#### 3. Comprehensive Test Infrastructure
+- **Split tests:** Reorganized from monolithic files to modular structure (`test/module_name/test_*.jl`).
+- **New test module:** `yaml_geometry` with `test_load_polar_data.jl` and `test_wing_constructor.jl`.
+- **Test utilities:** `test_data_utils.jl` with shared helper functions.
+- **Test data:** Extensive YAML and CSV test files in `data`.
+
+#### 4. Data and Examples
+- **New data sets:** Complete `TUDELFT_V3_KITE` with CFD polars and literature results.
+- **Enhanced examples:** Updated examples to use YAML geometry (e.g., `pyramid_model.jl`, `V3_kite.jl`).
+- **Real-world configs:** Production-ready YAML geometry files for various kite configurations.
+
+#### 5. Core Module Improvements
+- **Path handling:** Robust file path resolution for relative/absolute paths.
+- **Error handling:** Comprehensive validation and graceful fallback to INVISCID mode.
+- **Memory management:** Improved file I/O and cleanup in tests.
+- **Documentation:** Added comprehensive docstrings and examples.
+
 ## VortexStepMethod v2.0.0 2025-07-11
 ### Changed
 - bump Interpolations to 0.16

Project.toml

@@ -23,6 +23,7 @@ SciMLBase = "0bca4576-84f4-4d90-8ffe-ffa030f20462"
 Serialization = "9e88b42a-f829-5b0c-bbe9-9e923198166b"
 StaticArrays = "90137ffa-7385-5640-81b9-e52037218182"
 Statistics = "10745b16-79ce-11e8-11f9-7d13ad32a3b2"
+StructMapping = "7c3b921d-20d6-4eba-ad57-605525e86ab2"
 Timers = "21f18d07-b854-4dab-86f0-c15a3821819a"
 Xfoil = "19641d66-a62d-11e8-2441-8f57a969a9c4"
 YAML = "ddb6d928-2868-570f-bddf-ab3f9cf99eb6"
@@ -55,10 +56,12 @@ Parameters = "0.12"
 Pkg = "1"
 PreallocationTools = "0.4.25"
 PrecompileTools = "1.2.1"
+Random = "1.10.0"
 SciMLBase = "2.77.0"
 Serialization = "1"
 StaticArrays = "1"
 Statistics = "1"
+StructMapping = "0.2.3"
 Test = "1"
 Timers = "0.1"
 Xfoil = "0.5"
@@ -72,7 +75,8 @@ CSV = "336ed68f-0bac-5ca0-87d4-7b16caf5d00b"
 ControlPlots = "23c2ee80-7a9e-4350-b264-8e670f12517c"
 DataFrames = "a93c6f00-e57d-5684-b7b6-d8193f3e46c0"
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c"
 Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
 
 [targets]
-test = ["Test", "DataFrames", "CSV", "Documenter", "BenchmarkTools", "ControlPlots", "Aqua"]
+test = ["Test", "DataFrames", "CSV", "Documenter", "BenchmarkTools", "ControlPlots", "Aqua", "Random"]

data/TUDELFT_V3_KITE/literature_results/CFD_RANS_Rey_10e5_Poland2025_alpha_sweep_beta_0.csv

@@ -0,0 +1,9 @@
+alpha,beta,CL,CD,CS,CMy
+1.02,0,0.2278625272194466,0.0490919571607997,-0.028991478200473,-0.0971304889257096
+4.02,0,0.4610104802890269,0.0516566817024969,-0.06116291297791359,-0.177995425157634
+7.02,0,0.6748642166054709,0.0643789856608573,-0.09170612013580448,-0.2399628564061313
+10.02,0,0.8685945393341531,0.0841781647387978,-0.12014981939630065,-0.2873743657009342
+13.02,0,1.042518829707241,0.1099699784207837,-0.14632493718395287,-0.3234126609849657
+15.02,0,1.147266423064987,0.1293063892392999,-0.16260131332214534,-0.3422906659660041
+17.02,0,1.248363457881334,0.1505397278170317,-0.17819835351371366,-0.3593648645427019
+19.02,0,1.340909392696446,0.172443901716702,-0.19275273990602687,-0.3729793258363525

data/TUDELFT_V3_KITE/literature_results/CFD_RANS_Rey_5e5_Poland2025_alpha_sweep_beta_0_NoStruts.csv

@@ -0,0 +1,19 @@
+CL,CD,alpha,CS
+-0.133333333,0.0728,-3.98,0
+-0.066666667,0.0672,-2.98,0
+0.073015873,0.0552,-0.98,0
+0.225396825,0.051,1.02,0
+0.384126984,0.052,3.02,0
+0.46031746,0.0536,4.02,0
+0.536507937,0.06,5.02,0
+0.673015873,0.07,7.02,0
+0.803174603,0.075,9.02,0
+0.873015873,0.085,10.02,0
+0.93015873,0.09,11.02,0
+1.041269841,0.115,13.02,0
+1.146031746,0.135,15.02,0
+1.24,0.151,17.02,0
+1.342857143,0.171,19.02,0
+0.88,0.31,21.02,0
+0.91,0.34,23.02,0
+0.93,0.38,25.02,0

data/TUDELFT_V3_KITE/literature_results/Python_VSM_Rey_5e5_Poland2025_alpha_sweep_beta_0.csv

@@ -0,0 +1,39 @@
+alpha,CL,CD,CL/CD,CS
+-12.0,-0.2382871512913027,0.10555351086138359,-2.2575009523295666,8.493387378390686e-14
+-11.0,-0.23078413996904473,0.10186112684362705,-2.265674326608765,6.616874649497016e-14
+-10.0,-0.22230140038021914,0.09806363640487119,-2.266909616347621,4.373272668096159e-14
+-9.0,-0.21585315982172304,0.0931590398953698,-2.317039334713575,2.739682786368477e-14
+-8.0,-0.20625706590216833,0.08814998331707347,-2.339842370250558,1.1046588689401156e-14
+-7.0,-0.1998343140258721,0.08290261953105998,-2.410470442987666,-2.389661935808156e-14
+-6.0,-0.18199775713691974,0.07765158375393942,-2.343773923705537,-3.872611350474041e-14
+-5.0,-0.14850648581010087,0.07109437185188841,-2.0888641666246923,-3.2393754503524565e-14
+-4.0,-0.10858858872468641,0.06522454108866148,-1.6648425103839215,-3.0271060429342046e-14
+-3.0,-0.06288342322853809,0.06000714503007155,-1.0479322620168838,-2.895668145826433e-14
+-2.0,-0.007429949914950523,0.055498453779690086,-0.13387670122207165,-3.2169539191587655e-14
+-1.0,0.05656004203302359,0.05159811771021331,1.0961648320327801,-3.44716398526909e-14
+0.0,0.12392449645064037,0.04839062569141725,2.5609194896733913,-3.597944298611074e-14
+1.0,0.19309362003485317,0.04593968204080192,4.203198878550238,-3.699581064093612e-14
+2.0,0.2625331911314792,0.044328371503610776,5.922464151657241,-3.6349856219703554e-14
+3.0,0.3323792213186091,0.04356996032047687,7.628632637574346,-3.6413469417385087e-14
+4.0,0.40297413442239444,0.04359394940688724,9.243808829092464,-3.773253515649088e-14
+5.0,0.4734826904404322,0.04438413803893367,10.667835658430365,-3.826806223929053e-14
+6.0,0.5430144326845379,0.04590240400649957,11.829760214903983,-4.0253505670851383e-14
+7.0,0.610689137470121,0.04806877475261435,12.704487281255428,-4.406262078692334e-14
+8.0,0.6758859112182876,0.05085291168580261,13.290997286336015,-4.723118897422392e-14
+9.0,0.7383699770457292,0.054242295408895566,13.612439729544315,-5.20455622927876e-14
+10.0,0.7982179068869607,0.05807229829781809,13.74524395079696,-5.5385868816441935e-14
+11.0,0.8557802537306283,0.062209616690946774,13.756398114170796,-5.702371714996311e-14
+12.0,0.8988323082495834,0.0690977304744752,13.008130687904623,-6.141415623852904e-14
+13.0,0.9147135983203839,0.08124056010481986,11.259321663220728,6.491282774779828e-13
+14.0,0.9112748609115651,0.0966853408597458,9.425160554933385,4.54748749597064e-13
+15.0,0.9085348699441353,0.11140779158846578,8.155038862095148,3.3836985824286487e-13
+16.0,0.9062580847970818,0.1257712798490804,7.2056043787146695,2.6754981159878576e-13
+17.0,0.8882638215990443,0.13985252773614038,6.3514320118327126,4.0927876403191203e-13
+18.0,0.8801641114980264,0.15426592918480644,5.7054990440800015,2.5988028226070375e-13
+19.0,0.8799535802082414,0.16798064710830107,5.238422373982847,1.821903726884496e-13
+20.0,0.8812698509369349,0.18370556270697425,4.797186530179459,1.3007693874618696e-13
+21.0,0.871379428960392,0.198621428734149,4.387137050185641,5.975307998613411e-15
+22.0,0.8680573492907033,0.21572711063981947,4.023867685040394,-1.822880946847326e-15
+23.0,0.8639910136639356,0.23075669712075686,3.7441644140529626,-5.408316146275571e-16
+24.0,0.8613474653095494,0.24594284553183446,3.5022261511488364,-4.729369019706576e-15
+25.0,0.8583553232582976,0.2571571564052344,3.3378628666498424,-7.613518753563846e-15

data/TUDELFT_V3_KITE/literature_results/Python_VSM_Rey_5e5_n36_CFD_PCHIP_polars_alpha_sweep.csv

@@ -0,0 +1,63 @@
+alpha,CL,CD,CS,CMx,CMy,CMz
+-5.0,-0.016639150841432696,0.06461257742824286,8.478187720501367e-17,-3.061887882386819e-16,0.28227103088648064,3.1640606750175953e-17
+-4.508196721311475,-0.15116141710337438,0.06813042331168648,1.6558287946512188e-16,-4.3472875316127167e-16,0.2448193040108129,2.741773931281523e-17
+-4.016393442622951,-0.12359435503424275,0.06467079023399522,2.22928996914706e-16,-5.896358903756748e-16,0.24394876629214812,1.3945762219966873e-17
+-3.5245901639344264,-0.0955075625757297,0.06140805998980694,2.3960563519741807e-16,-6.054561937507627e-16,0.2420546192298006,1.9095600558211657e-17
+-3.0327868852459017,-0.08614032786011963,0.059727576261926124,2.560670910506758e-16,-6.24901983315975e-16,0.24100968398007022,2.597578457810669e-17
+-2.540983606557377,-0.0552050539665637,0.05704706679467209,3.208907979237986e-16,-8.223261858509271e-16,0.23846691212426813,3.934476490419015e-17
+-2.0491803278688527,-0.023671564731756238,0.054662724982745055,2.9679036582491142e-16,-7.499812568752643e-16,0.23501881516673262,2.978666494840783e-17
+-1.557377049180328,0.008844196939017434,0.05251409193106237,3.002063868924993e-16,-7.601161387249302e-16,0.23045212739790363,2.5090012383928592e-17
+-1.0655737704918034,0.0415747891970653,0.05060381840435065,2.890169005608731e-16,-7.430804735020164e-16,0.22471056723584462,1.614989302873564e-17
+-0.5737704918032787,0.07502466254074833,0.04891798700234494,3.0738810047553817e-16,-7.754008589128406e-16,0.2177951282212764,2.830351150699333e-17
+-0.08196721311475397,0.10889694335333432,0.047464944609758454,2.84202193701832e-16,-7.096065243034252e-16,0.20978226669304198,2.2494493861453216e-17
+0.4098360655737707,0.14309203022027436,0.04622054569950249,2.4401687500123214e-16,-5.785946369784777e-16,0.20048986627783982,1.1103051457255748e-17
+0.9016393442622945,0.1780413579153343,0.04526384343079455,2.669338037381205e-16,-7.267451862931039e-16,0.19045131694925846,2.0985591228347496e-17
+1.3934426229508192,0.21395263479636484,0.04447997622080856,2.912494182664618e-16,-8.450678719526157e-16,0.17884135671129764,1.8766010904563983e-17
+1.885245901639344,0.250813572958965,0.04389188664361113,1.9097440614073512e-16,-4.643918219895616e-16,0.16568961707932453,1.408995769343773e-17
+2.3770491803278686,0.28895949644132035,0.04350125508066167,4.0626442680981155e-16,-1.014476953927516e-15,0.1508258269234812,4.0539527398662916e-17
+2.8688524590163933,0.3273497069332273,0.04329404509617653,1.2824872795479226e-16,-3.203611433455315e-16,0.1341391252119524,3.275297183123682e-17
+3.360655737704917,0.365700349792079,0.04337836667220271,1.9990447696309065e-16,-4.080319912158108e-16,0.11648263639587733,1.936339215180039e-17
+3.8524590163934427,0.40370330464829807,0.04368762204422157,2.816738001557434e-16,-7.916743480616941e-16,0.09735955183971143,1.9610584392036138e-17
+4.3442622950819665,0.4404116927505139,0.044306322502976996,1.6375382881475996e-16,-3.8232399823129283e-16,0.07791841285021213,2.315367316874855e-17
+4.836065573770492,0.4762504901989163,0.04515131620054717,2.369158548292387e-16,-6.24901983315975e-16,0.057514814009507295,2.0764148179802968e-17
+5.327868852459016,0.5109687991364886,0.04622052439565633,9.209807980646155e-17,-4.073728119085154e-16,0.03637335615544438,2.19177119675698e-17
+5.8196721311475414,0.5450872107517716,0.04742994878168534,2.5004198302595403e-16,-5.128415010757685e-16,0.013891257121196583,3.1640606750175953e-17
+6.311475409836065,0.578878803412755,0.04877085485214794,7.44531205912049e-17,-3.994626602209714e-16,-0.010208417088161864,9.558099955782319e-18
+6.803278688524589,0.6123151772132445,0.05025131667415033,7.316202601447877e-18,-2.412596264700915e-16,-0.03585800484077638,-1.153563787766831e-18
+7.295081967213115,0.6453702092431793,0.05185290775774244,1.441722277344141e-16,-2.9267561243912755e-16,-0.06310965707173499,2.6531967118637127e-17
+7.786885245901638,0.6779928516494528,0.053578842442153725,1.4115967372205322e-16,-4.60107156492142e-16,-0.09186632177777364,2.719114642593246e-17
+8.278688524590164,0.7101325624043433,0.055423228235985375,1.144770524697139e-16,-3.5991190178325145e-16,-0.12209448775203158,3.839719464995311e-17
+8.770491803278688,0.7417155678337713,0.057385003894413894,1.7386740299911437e-16,-5.840328662636646e-16,-0.15369844447316333,5.2075165276331265e-17
+9.262295081967213,0.7726715314550687,0.05945792991479041,-4.820086419777427e-17,1.4238273037579177e-16,-0.1866012863904165,4.7460910125263927e-17
+9.754098360655737,0.8029903119885894,0.06163976483762739,1.5364025463040542e-16,-5.589840525864415e-16,-0.2207509742279646,2.7026351599108612e-17
+10.245901639344263,0.8324426504335397,0.06391906277414598,6.842801256648311e-17,-1.8457020604269305e-17,-0.2559480287255108,6.92138272660099e-17
+10.737704918032787,0.8611093171365881,0.0662937719175855,1.4202040343987063e-17,-8.173823410462121e-17,-0.2921901366614442,5.899654800293225e-17
+11.229508196721312,0.8887836361849122,0.0687525912834733,-8.004786375701798e-17,3.4277323979357284e-17,-0.3292683490609791,3.065183778923295e-17
+11.721311475409834,0.9156238187652903,0.07131283332024405,2.1862534832561903e-16,-7.699214309209482e-16,-0.36712563062885384,7.481685137802022e-17
+12.21311475409836,0.9418984375156303,0.07399760347505731,-4.217575617305249e-17,1.6347646820924242e-16,-0.40580095808159955,4.218747566690127e-17
+12.704918032786885,0.9677215562567566,0.07682644632228418,-5.680816137594825e-17,6.328121350035191e-17,-0.4452567123584407,4.218747566690127e-17
+13.196721311475411,0.9931286743487212,0.0797870357773372,1.7386740299911434e-16,-2.794920262932209e-16,-0.48555212411561566,3.4277323979357284e-17
+13.688524590163933,0.9530080585289407,0.09372461800895182,2.0829659171181024e-16,-5.668942042739858e-16,-0.4388000351000014,2.900388952099462e-17
+14.180327868852459,0.9726783526633942,0.09816659918391062,-1.2910945767260968e-16,3.902341499188368e-16,-0.4701027130866711,5.471188250551259e-17
+14.672131147540984,0.9451834173522863,0.1086047928078909,9.667716190525011e-14,-2.2546832698452465e-13,-0.4434160867841825,2.5614389522882024e-14
+15.163934426229506,0.9274663982712807,0.1173860748560331,-1.4804551146459243e-16,1.318358614590665e-16,-0.42977676488265726,2.6696761945460965e-17
+15.655737704918032,0.9392161571013751,0.12364041059453318,3.5289918430513304e-17,-3.2431621918930353e-16,-0.4484146206820607,1.0217279263077651e-17
+16.147540983606557,0.917935061773152,0.13355092087700765,1.506277006180446e-16,-8.147456238170308e-16,-0.42684179208813605,1.100829443183205e-16
+16.639344262295083,0.9273175945900742,0.14012854861126456,-9.812318783118334e-17,1.7402333712596775e-16,-0.4427392153437181,1.4864493379509744e-16
+17.131147540983605,0.9372166929555599,0.14673903926860724,-1.2136289021225308e-15,2.6367172291813293e-15,-0.45960767742472114,-8.635248925568853e-17
+17.62295081967213,0.9212648752527602,0.15330902504856514,-7.40227557322962e-17,1.5556631652169844e-16,-0.45407537631807837,6.196285488576123e-17
+18.114754098360656,0.9042606944997617,0.1605440694312137,-5.164378306904386e-18,-2.2148424725123165e-16,-0.44298849768484955,8.701166856298387e-17
+18.606557377049178,0.9108034289591539,0.16749392814781805,1.3427383597951405e-16,-5.853512248782551e-16,-0.4553382010126988,9.492182025052785e-17
+19.098360655737704,0.8994884373576996,0.1727892443219773,7.74656746035658e-18,-2.3994126785550103e-16,-0.45765053247576365,1.1403802016209251e-16
+19.59016393442623,0.9044972557086793,0.18005479310901998,-1.7558886243474914e-16,9.492182025052785e-17,-0.4674021986963869,8.239741341191654e-17
+20.081967213114755,0.8880114648962718,0.1886092652486161,-4.2175756173052494e-17,-1.318358614590665e-16,-0.4503789890339498,1.1469719946938785e-16
+20.573770491803277,0.891661611947163,0.19581563053838055,1.7386740299911434e-16,-4.3505834281491935e-16,-0.4589643663993485,1.3315422007365713e-16
+21.065573770491802,0.8789204895652939,0.20176210132002587,2.3497921296414955e-16,-8.595698167131133e-16,-0.4538741523035905,1.9313953703753237e-16
+21.557377049180328,0.8817415797412202,0.20915497453029433,-6.283326940067003e-17,7.119136518789589e-17,-0.46087492648475836,5.5371061812807914e-17
+22.049180327868854,0.8849598383450349,0.21662460538438122,3.5289918430513304e-17,-2.610350056889516e-16,-0.46843312834521944,1.3513175799554314e-16
+22.540983606557376,0.8884516297495344,0.2240483324289815,1.807532407416535e-17,-2.610350056889516e-16,-0.47687031449324124,1.2919914422988513e-16
+23.0327868852459,0.8737106107104212,0.2339158168422375,-1.5837426807840117e-16,4.1660132221065e-16,-0.45610150036749486,7.053218588060056e-17
+23.524590163934427,0.8752551935225418,0.24200218248559524,-4.475794532650468e-17,1.2919914422988513e-16,-0.46002499798247176,2.0434558526155303e-17
+24.01639344262295,0.8768904716550766,0.24995893761794005,-8.349078262828758e-17,2.1357409556368767e-16,-0.46464194159845734,4.4824192896082596e-17
+24.508196721311474,0.8656263524743696,0.25664834099878914,-3.87328373017829e-17,4.218747566690127e-17,-0.4569579827789767,5.734859973469391e-17
+25.0,0.8663529251179094,0.2647858928603986,-1.101734038806269e-16,-5.273434458362659e-18,-0.45976462904136123,1.4567862691226844e-16

data/TUDELFT_V3_KITE/literature_results/WindTunnel_Re_5e5_Poland2025_alpha_sweep_beta_0.csv

@@ -0,0 +1,18 @@
+CL,CL_ci,CD,CD_ci,alpha
+-0.28023315356081796,0.011070533538875897,0.09785297775939765,0.012935829196785585,-11.568121157001665
+-0.2144913736143728,0.012287227041809052,0.06853577957407217,0.015525138484707877,-6.099059501611582
+-0.0007680391233001299,0.01068508564308875,0.04885867739007862,0.0076696455159627275,-1.9996385577164184
+0.07398995139159774,0.00953159417113588,0.05739081465627228,0.008889911090057321,-1.3348199670846914
+0.46519267467797903,0.009475707060472788,0.05616787766119728,0.009084810793467887,3.0810784665258444
+0.610180915884597,0.0045250228316688484,0.07431024337243476,0.004621689815286087,5.412846420261046
+0.7430356350927991,0.009465755795905533,0.08664306372317211,0.009633413459228232,7.350324457982788
+0.887298865863501,0.010638047578235603,0.10233695227784106,0.00900521264610847,9.382433604529174
+0.9255655151637727,0.014238431399063743,0.17599439630813363,0.01507120428946693,11.464425166301869
+0.9327251987983486,0.015877506028324398,0.18888674805756867,0.01693686866633114,12.461055790544702
+0.9512282813613351,0.014573344990978988,0.2127454401843595,0.018047053186439406,13.352348165878231
+0.9770715203611249,0.018103047941433924,0.22788683966364287,0.0204637541133525,14.540186234231973
+1.008562675819161,0.016658847313704747,0.24447585438450992,0.018378234971297258,16.225366370508798
+1.0681034642531901,0.0154900038338791,0.319919197381967,0.02298889264565519,18.29734623730859
+1.0099938012961718,0.015447658557709807,0.3573016324548397,0.015144711790384626,20.224692877134817
+0.9979635604848679,0.01181112128634061,0.4199851182071093,0.011605298627928523,23.03035435658158
+0.9749275179241531,0.01301729603627638,0.43498425522432616,0.012174929509637398,24.54119521035482