CSpline - Fix segment function and add utils to constrain parameter calculations

[eslickj]

Fixes

There was a bug in the segment function in the parameter class. The function is just used for testing and plotting cubic splines, so it is not likely to have affected anything. It's fixed and tests are added that would catch similar future issues.

Summary/Motivation:

This fixes a bug and adds parameter calculation options that allow you to impose certain properties on the cubic spline.

Changes proposed in this PR:

• Fix bug in segments method in CsplineParameters class (use for plotting and testing)
• Add option to extend the curve to extrapolate linearly from the endpoints using endpoint slope
• Add function to add constraints to parameter calculation problem to encourage the cspline to be increasing
• Add function to add constraints to parameter calculation problem to encourage the cspline to be decreasing
• Add function to add constraints to parameter calculation problem to require the function to be convex
• Add function to add constraints to parameter calculation problem to require the function to be concave

Legal Acknowledgement

By contributing to this software project, I have read the contribution guide and agree to the following terms and conditions for my contribution:

1. I agree my contributions are submitted under the BSD license.
2. I represent I am authorized to make the contributions and grant the license. If my employer has rights to intellectual property that includes these contributions, I represent that I have received permission to make contributions and grant the required license on behalf of that employer.

[codecov]

Codecov Report

Attention: Patch coverage is 97.71689% with 5 lines in your changes missing coverage. Please review.

Project coverage is 88.85%. Comparing base (3d1bb30) to head (980abd7).
Report is 16 commits behind head on main.

Files with missing lines	Patch %	Lines
...omo/contrib/cspline_external/cspline_parameters.py	96.26%	5 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3593      +/-   ##
==========================================
+ Coverage   88.83%   88.85%   +0.01%     
==========================================
  Files         888      888              
  Lines      102172   102338     +166     
==========================================
+ Hits        90767    90932     +165     
- Misses      11405    11406       +1     

Flag	Coverage Δ
builders	26.64% <15.52%> (-0.03%)	⬇️
default	85.43% <97.71%> (?)
expensive	34.02% <15.52%> (?)
linux	86.66% <97.71%> (-1.94%)	⬇️
linux_other	86.66% <97.71%> (+0.02%)	⬆️
osx	82.95% <97.71%> (+0.02%)	⬆️
win	84.84% <97.71%> (+0.02%)	⬆️
win_other	84.84% <97.71%> (+0.02%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[mrmundt]

FYI that there is a pretty silly false positive in the typos check right now that I am hoping they'll do a hot patch to fix. I'm monitoring the PR that their team opened (crate-ci/typos#1311)

[mrmundt]

The new class CubicParametersModelData probably should have some more unit tests, but I won't let that hold up this PR.