Add transform method to Detections class and documentation for the transform method

[nahcol10]

Add transform method to Detections class and documentation for the transform method

• Added the transform method to the Detections class to support remapping class names, filtering predictions, and remapping class IDs to match a dataset's classes.
• Added comprehensive documentation for the transform method in docs/detections.md, including a description, parameters, returns, raises, and an example usage.

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}