Add pcv.transform.mask_color_card function

[HaleySchuhl]

Describe your changes
Adds pcv.filters.color_card which takes an RGB image as input, uses the same algorithm as pcv.transform.detect_color_card by moving it into a helper function that gets called by both filters.color_card and transform.detect_color_card. The function returns a binary mask created by taking a bounding box of the detected color card chips. This aims to assist with object mask cleanup when regional filters are not sufficient for filtering out color card chips.

Type of update
Is this a:

• New feature or feature enhancement

Associated issues

• closes Add function pcv.filters.color_card for mask cleanup #1706

Additional context
This function might get used in the tripsacum seed head tutorial. It was used in the analysis of 2024 seedhead images taken at Shaw.

For the reviewer
See this page for instructions on how to review the pull request.

• PR functionality reviewed in a Jupyter Notebook
• All tests pass
• Test coverage remains 100%
• Documentation tested
• New documentation pages added to plantcv/mkdocs.yml
• Changes to function input/output signatures added to updating.md
• Code reviewed
• PR approved

[deepsource-io]

Here's the code health analysis summary for commits 89ea5ea..5dde1f0. View details on DeepSource ↗.

Analysis Summary

Analyzer	Status	Summary	Link
Python	✅ Success		View Check ↗
Test coverage	✅ Success		View Check ↗

Code Coverage Report

Metric	Aggregate	Python
Branch Coverage	100%	100%
Composite Coverage	100%	100%
Line Coverage	100%	100%
New Branch Coverage	100%	100%
New Composite Coverage	100%	100%
New Line Coverage	100%, ✅ Above Threshold	100%, ✅ Above Threshold

---

💡 If you’re a repository administrator, you can configure the quality gates from the settings.

[k034b363]

Tried on a couple of different color card layouts from bellwether and pi chambers, and it works the way I expect on all of them. Looks good to me!