Reorganize and potentially rename the `clean` package

[leewujung]

The clean package has a mixture of locations of the noise removal functions: Some existing functions sit entirely within api.py and some in a separate .py file. The newly added transient noise functions (fieldings and matecho algorithms) are in a different submodule transient_noise and call by a dispatcher in api.py. Since there are multiple type noises and for each type there are multiple algorithms, we should reorganize where things sit and how they are imported.

I like the dispatcher approach @LOCEANlloydizard implemented since it is easy to follow, and the parallel with other functionalities like seafloor and shoal detection. Perhaps we can follow that to organize all noise removal functions.

Another consideration is to rename the subpackage. I am not super happy with the clean naming. Should we go with the more standard remove_noise? Am trying to use a verb here since all other subpackages are verbs.

@LOCEANlloydizard @ctuguinay : Thoughts?

This is related to #1544.

[LOCEANlloydizard]

Hi @leewujung @ctuguinay

• Yes, I’d also go with the dispatcher to keep things more modular, especially as we’re adding more filters and algorithms. I’ll get to that soon-ish (after the single-target detection!).

• On the name: happy with “remove_noise” as well! I was just wondering whether it excludes cases like attenuated signals that we still want to drop but wouldn’t necessarily call “noise” (or maybe we do?). Another candidate that might be broader is “filter”?

Thanks for bringing this up!