sarkit.sicd.projection.scene_to_image

scene_to_image(proj_metadata, scene_points, *, adjust_param_offsets=None, delta_gp_s2i=0.001, maxiter=10, bistat_delta_gp_gpp=0.01, bistat_maxiter=10)

Map geolocated points in the three-dimensional scene to image grid locations.

Parameters:

proj_metadataMetadataParams

Metadata parameters relevant to projection.

scene_points(…, 3) array_like

Array of scene points with ECEF (WGS 84 cartesian) X, Y, Z components in meters in the last dimension.

adjust_param_offsetsAdjustableParameterOffsets, optional

Used to compute the offsets to be added to the initial COA projection set to form the adjusted COA projection set.

delta_gp_s2ifloat, optional

Ground plane displacement threshold for final ground plane point in meters.

maxiterint, optional

Maximum number of iterations to perform.

bistat_delta_gp_gppfloat, optional

(Bistatic only) Ground plane displacement threshold for intermediate ground plane points in meters.

bistat_maxiterint, optional

(Bistatic only) Maximum number of intermediate bistatic R/Rdot to Ground Plane iterations to perform per scene-to-image iteration.

Returns:

image_grid_locations(…, 2) ndarray

Array of image coordinates with xrow/ycol in meters in the last dimension. Coordinates are NaN where there is no projection solution.

delta_gpndarray

Ground-plane to scene displacement magnitude. Values are NaN where there is no projection solution.

successbool

Whether or not all displacement magnitudes, delta_gp are less than or equal to the threshold, delta_gp_s2i. For bistatic projections, success also requires convergence of all intermediate ground plane points.