Clean and document ball filter

[dstansby]

Here's some general cleaning and documenting of the ball filter part of cell detection. Please be critical and don't hesitate to add suggestions on review, would be good to get a close second pair of eyes on this.

[github-advanced-security[bot]]

You have successfully added a new SonarCloud configuration ``. As part of the setup process, we have scanned this repository and found no existing alerts. In the future, you will see all code scanning alerts on the repository Security tab.

[dstansby]

All done, thanks for the suggestions! Worth double checking the new docstrings I've added.