ENH: Added Crop and Clip Methods to Function Class

[Rickisterr]

Pull request type

• Code changes (enhancement, features)

Checklist

• Lint (black rocketpy/ tests/) has passed locally
• All tests (pytest tests --runslow) have passed locally
• CHANGELOG.md has been updated (if relevant)

Current behavior

RocketPy Function class has no methods to crop or clip the input and output values of a function to a specific range.

This PR is related to the following issue:
ENH: give me a scissor or apply Function.clip and Function.crop - #546

New behavior

It is now possible to specify a limited range of values for input or output variables for an object created from the Function class at any point after initialization of the object by using the crop and clip methods respectively. These methods work for any type of allowed Function source.

Breaking change

No

Additional information

To use the new methods, some examples are provided below to exemplify their syntax in brief:
f.crop([(-1, 1), (-2, 2)]) - For two input variables
f.clip([(-2, 2)]) - For output variable

[Gui-FernandesBR]

WE no longer use black, can you please run make format so we can review the PR faster?

[Rickisterr]

All required changes have been updated. Thank you!

[Gui-FernandesBR]

Great PR! We will review this implementation as soon as possible

[Rickisterr]

All required updates made to code; thank you for the reviews!

[Copilot]

Pull Request Overview

Adds crop and clip functionality to the Function class to restrict input domains and output values respectively. The crop method limits input domains by filtering data within specified ranges, while the clip method constrains output values to specified intervals.

Key changes:

• Added crop() method to restrict function input domains
• Added clip() method to restrict function output values
• Modified domain handling in set_discrete() and plotting methods to respect cropped domains

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 6 comments.

File	Description
rocketpy/mathutils/function.py	Implements crop and clip methods with helper functions for domain bounds determination and source manipulation
tests/unit/test_function.py	Adds comprehensive test coverage for crop and clip methods with different source types
CHANGELOG.md	Documents the enhancement addition
README.md	Adds DeepWiki badge

Comments suppressed due to low confidence (2)

tests/unit/test_function.py:274

• The parameter name 'array3dsource' is misleading as it suggests a 3D array, but it's actually a 2D array with 3 columns. Consider renaming to 'array2d_source' or 'source_array'.

def test_crop_ndarray(array3dsource, array3dcropped):  # pylint: disable=unused-argument

tests/unit/test_function.py:321

• The parameter name 'array3dsource' is misleading as it suggests a 3D array, but it's actually a 2D array with 3 columns. Consider renaming to 'array2d_source' or 'source_array'.

def test_clip_ndarray(array3dsource, array3dclipped):  # pylint: disable=unused-argument

[Gui-FernandesBR]

LGTM

[Gui-FernandesBR]

I believe this PR is now ready for production.
However, as I did some (many) changes yesterday, I believe it would be interesting if another code owner could review the function.py file again.
@phmbressan could you take a look at it for us pls?

[Gui-FernandesBR]

@codecov-ai-reviewer test