[ana5]: add general thalweg extension & resampling

[PaulaSp3]

The goal is to derive a thalweg profile from very general thalweg data (containing x and y coordinates).

This changed in each file:

• ana5Utils/DFAPathGeneration.py:

  • black formatter
  • extendProfileTop : add extension option that extends the path to the top similar as the bottom extension that depends on the flow/ path direction
    (for option 2, the code is very similar as in extendProfileBottom, should we summarize both in one function with options/different handling for top nd bottom extension?)
  • extendProfileBottom: add possibility to consider lower left center when reading z values from DEM
  • resamplePath : add parameter in configfile that can change the degree of the spline

• ana5Utils/DFAPathGenerationCfg.ini:

  • add parameter in configfile that can change the degree of the spline (for resampling a path)

• ana5Utils/preparePathGeneral.py
  functions to prepare a path/thalweg that has only x and y coordinates:

  • extend path to top and bottom
  • resample path
  • read z values along path (from DEM)
  • compute s values along path

• out3Plot/outCom3Plots.py

  • black formatter
  • generateCom1DFAPathPlot: put the avalanche thalweg location plot into a separate function avalancheThalwegPlot

PR Checklist

Please confirm before requesting review:

• I ran pytest locally without fails
• I added/updated tests where needed
• I updated documentation where needed

Confirm before the final merge/rebase into master

• Commits are sensibly squashed and rebased onto latest master
• Standardtest run without difference (with recompiled cython code)

[qltysh]

All good ✅

[qltysh]

Coverage Impact

⬆️ Merging this pull request will increase total coverage on master by 0.1%.

Modified Components (1)

Rating	Component	% Diff
	com1DFA	90.0%

Modified Files with Diff Coverage (3)

Rating	File	% Diff	Uncovered Line #s
	avaframe/com1DFA/DFAtools.py	90.0%	190
	avaframe/ana5Utils/DFAPathGeneration.py	77.5%	54-133, 181-199...
	avaframe/ana5Utils/preparePathGeneral.py	82.1%	49-59
	Total	78.4%

🤖 Increase coverage with AI coding...

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

- `avaframe/ana5Utils/DFAPathGeneration.py` -- Lines 54-133, 181-199, 566-569, 607-609, 678-679, 704-705, 1036-1037, and 1107-1137
- `avaframe/ana5Utils/preparePathGeneral.py` -- Line 49-59
- `avaframe/com1DFA/DFAtools.py` -- Line 190

🚦 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.

[fso42]

Standardtests ok, apart from known com5