Improve docstrings for coverage_checker plugins

[jsolbrig]

Requested Update

Description

I was very confused about a coverage issue today because the docstrings in the coverage_checker plugins are sorely lacking. It is not apparent, from either the module-level or the call function-level docstrings what the coverage_checkers actually do and how they differ from one another.

For example, the center_radius checker just has:

• module-level: Coverage check routine for center radius coverage checks.
• call function: Coverage check routine for xarray objects with masked projected arrays.

Neither of these say what the checker actually does.

Background and Motivation

• [ OPTIONAL: Provide additional detailed information and background related to this issue ]

Alternative Solutions

• [ OPTIONAL: If appropriate, list alternative fixes that could be considered]

Environment

• [ IF APPROPRIATE: Corresponding repository versions ]

Code to demonstrate issue

• [ IF APPROPRIATE: Can include steps here to identify/demonstrate bug fix or desired feature ]

Checklist for Completion

• [ ] <!--- Include a list of steps that must be complete in order to close this Issue --->

[evrose54]

This is probably an issue that is better suited for @mindyls. Looking at the coverage checkers right now, and they seem to do similar things, though I'm not sure of the nuances between one and another. For center_radius coverage checker, we are given some 2D array of geospatial data, center coordinates, and a radius in KM. Given those parameters, we create a dumby_arr, which essentially is a masked array, where any value equal to 1 would be inside the circle based on the radius value and the center points. We then run an np.where call, combining points within the circle and non-masked data found within temp_arr, count the pixels which are in the circle and exist, and divide that by the total number of pixels within the circle. We then multiply this value by 100, which gives us the percentage of coverage based on the provided parameters. This is similar for all coverage checkers.