[core, tests, docs] add remaining multi-layer support

[fso42]

Make AIMEC, ana4Stats, probAna, and downstream tools aware of multi-layer result files (e.g. from com8MoTPSA).

• AIMEC: add runoutLayer config parameter, layer-aware column resolution, mixed single/multi-layer support, explicit error when multi-layer data lacks runoutLayer
• ana4Stats: layer-suffixed keys in extractMaxValues, layer column in makeSimDF
• probAna: add layer config option in probAnaCfg.ini; update plotContours and related methods with layer parameter for filtering and labeling; improve logging
• runPlotProfile: fix hardcoded pfv (pre-existing bug), strip layer suffixes for unit lookups, full multi-layer result support
• com8MoTPSA: replace MoTGenerateConfigs with com1DFAPreprocess; add batchCfgDir check; add modName for sim filtering
• Update AIMEC and ana4Stats documentation with multi-layer filename format

Step	Status	Notes
ana4Stats extractMaxValues layer-suffixed key	Done	getStats.py — uses layer column from makeSimDF to build ppr_l1/ppr_l2 dict keys
makeSimDF layer column	Done	fileHandlerUtils.py — added layer column populated from parseSimName
Tests for makeSimDF layer column	Done	2 tests in test_fileHandlerUtils.py — multi-layer and single-layer
Tests for extractMaxValues multi-layer	Done	1 test in test_getStats.py — L1/L2 keyed separately with correct values
ana5Utils audit	Done	Not affected — uses com1DFA.readFields(), not peak file DataFrames
Remaining tools audit	Done	5 tools verified: rotationTest, outParticlesAnalysis, transformFields, runPlotAreaRefDiffs already work
Fix runPlotProfile.py hardcoded pfv	Done	Pre-existing bug fixed; full multi-layer support added
probAna multi-layer support	Done	layer config option, plotContours layer param, logging improvements
com8MoTPSA refactor	Done	MoTGenerateConfigs removed, batchCfgDir check added, modName filtering

[qltysh]

Coverage Impact

This PR will not change total coverage.

Modified Components (1)

Rating	Component	% Diff
	com1DFA	100.0%

Modified Files with Diff Coverage (8)

Rating	File	% Diff	Uncovered Line #s
	avaframe/out3Plot/statsPlots.py	13.0%	68-78, 160-342
	avaframe/com1DFA/com1DFA.py	100.0%
	avaframe/ana4Stats/probAna.py	100.0%
	avaframe/com8MoTPSA/com8MoTPSA.py	0.0%	38
	avaframe/in3Utils/cfgHandling.py	100.0%
	avaframe/in3Utils/fileHandlerUtils.py	100.0%
	avaframe/ana4Stats/getStats.py	89.8%	93-94, 107, 110-116
	avaframe/com9MoTVoellmy/com9MoTVoellmy.py	0.0%	57
	Total	73.1%

🤖 Increase coverage with AI coding...

In the `multiLayerP4` branch, add test coverage for this new code:

- `avaframe/ana4Stats/getStats.py` -- Lines 93-94, 107, and 110-116
- `avaframe/com8MoTPSA/com8MoTPSA.py` -- Line 38
- `avaframe/com9MoTVoellmy/com9MoTVoellmy.py` -- Line 57
- `avaframe/out3Plot/statsPlots.py` -- Lines 68-78 and 160-342

🚦 See full report on Qlty Cloud »

🛟 Help

• Diff Coverage: Coverage for added or modified lines of code (excludes deleted files). Learn more.

• Total Coverage: Coverage for the whole repository, calculated as the sum of all File Coverage. Learn more.

• File Coverage: Covered Lines divided by Covered Lines plus Missed Lines. (Excludes non-executable lines including blank lines and comments.)

  • Indirect Changes: Changes to File Coverage for files that were not modified in this PR. Learn more.

[awirb]

For the ana4Prob results for com8MoTPSA - now for the peakVar in probAnaCfg.ini all available peakFiles are included, not aware of layer information - would it be better to also have to chose a layer here (similar to aimec) so that only results of one layer are compared - then also in the plots the info from which layer the results come should be stated

[qltysh]

1 new issue

Tool	Category	Rule	Count
qlty	Structure	Function with high complexity (count = 15): plotContours	1

[fso42]

Standardtests ident