Coverage.compute_dop

giant.coverage.coverage_class:

Coverage.compute_dop()

This function computes the dilution of precision (DOP) metrics for all facets based off images where each facet visible as determined by the coverage analysis.

The following parameters are computed for each facet separately and then organized into arrays containing the results for all facets ordered by the index of the corresponding facet:

cnt – number of usable observation images

jac – SCP jacobian corresponding to a change in illumination given

a change to the surface normal and/or albedo

alb – DOP of local terrain relative brightness

xt – DOP of local terrain x slope, typically East/West

yt – DOP of local terrain y slope, typically North/South

tot – RSS (L2-norm) of xt, yt, and alb DOP values

The DOP values are dependent on the BRDF we are using to characterize surface illumination.

Returns:

A tuple of DOP metrics (cnt, alb, xt, yt, tot) which are each wrapped into their own dictionaries with keys denoted by an “all” label and any other labels for imaging time intervals if applicable

Return type:

Tuple[Dict[str, List[int]], Dict[str, List[Sequence[float64 | float]]], Dict[str, List[Sequence[float64 | float]]], Dict[str, List[Sequence[float64 | float]]], Dict[str, List[Sequence[float64 | float]]]]