sarkit.sicd.image_to_ground_plane

image_to_ground_plane(sicd_xmltree, image_grid_locations, gref, ugpn, *, method=None, bistat_delta_gp_gpp=0.01, bistat_maxiter=10)

Project image coordinates to an arbitrary plane.

Parameters:

sicd_xmltreelxml.etree.ElementTree

SICD XML metadata.

image_grid_locations(…, 2) array_like

N-D array of image coordinates with xrow/ycol in meters in the last dimension.

gref(3,) array_like

Ground plane reference point with WGS 84 cartesian X, Y, Z components in meters.

ugpn(3,) array_like

Unit normal vector to ground plane with WGS 84 cartesian X, Y, Z components in meters.

methodstr, optional

“monostatic” or “bistatic”. If omitted, selects based on sicd_xmltree metadata.

bistat_delta_gp_gppfloat, optional

(Bistatic only) Displacement threshold for ground plane points in meters.

bistat_maxiterint, optional

(Bistatic only) Maximum number of R/Rdot to Ground Plane iterations to perform.

Returns:

gpp_tgt(…, 3) ndarray

Array of ground plane points with WGS 84 cartesian X, Y, Z components in meters in the last dimension.

delta_gpndarray

Magnitude of the displacement from estimated point to the precise intersection of the target R/Rdot contour.

successbool

Whether or not all gpp_tgt points were properly determined. The criteria are dependent on the collect type.