SICD Projection (sarkit.sicd.projection)

Objects and methods that implement the exploitation processing described in SICD Volume 3 Image Projections Description Document (IPDD).

Data Classes

To simplify interfaces, some collections of metadata parameters are encapsulated in dataclasses with attributes named as similar as feasible to the IPDD.

MetadataParams(*, Collect_Type, SCP, ...[, ...])

Parameters from IPDD Metadata Parameter List.

ErrorStatParams(*[, C_SCP_RGAZ, ...])

IPDD Error Statistics Parameters

ComponentErrorStatMono(*, C_AIF_APV, AIF, ...)

IPDD Error Statistics Parameters: Monostatic components

ComponentErrorStatBi(*, C_XIF_XPV, XIF, ...)

IPDD Error Statistics Parameters: Bistatic components

AdjustableParameterOffsets(*, ...[, ...])

Parameters from IPDD Adjustable Parameter Offsets List.

ApoErrorParams(*[, C_SCPAPO_RGAZ, C_APOM, ...])

Parameters from IPDD APO Error Parameters table

CoaPosVelsMono(*, ARP_COA, VARP_COA)

Ensemble of monostatic Center Of Aperture sensor positions and velocities.

CoaPosVelsBi(*, GRP_COA, tx_COA, tr_COA, ...)

Ensemble of bistatic Center Of Aperture sensor positions and velocities.

ProjectionSetsMono(*, t_COA, ARP_COA, ...)

Ensemble of monostatic Center of Aperture projection sets.

ProjectionSetsBi(*, t_COA, tx_COA, tr_COA, ...)

Ensemble of bistatic Center of Aperture projection sets.

ScenePointRRdotParams(*, R_Avg_PT, ...)

Ensemble of range and range rate parameters for a collection of scene points (PT).

ScenePointGpXyParams(*, uGX, uGY, ...)

Ensemble of scene point ground plane XY parameters for a collection of scene points (PT).

ProjGeomParamsMono(*, uPT, uPTDot)

Set of projection geometry parameters for Collect Type = Monostatic

ProjGeomParamsBi(*, R_Xmt_0coa, ...)

Set of projection geometry parameters for Collect Type = Bistatic

SlantPlaneSensitivityMatrices(*, M_SPXY_PT, ...)

Sensitivity matrices that relate changes in slant plane projection point.

ImageLocationSensitivityMatrices(*, M_IL_PT, ...)

Sensitivity matrices that relate changes in image grid location.

PVTSensitivityMatricesMono(*, ...)

Monostatic position/velocity/timing sensitivity matrices (Table 11-4)

PVTSensitivityMatricesBi(*, ...)

Bistatic position/velocity/timing sensitivity matrices (Table 11-5)

SensitivityMatricesMono(*, ...)

Sensitivity Matrices from IPDD for a monostatic image

SensitivityMatricesBi(*, M_RRdot_delta_Xmt, ...)

Sensitivity Matrices from IPDD for a bistatic image

Type Aliases

type CoaPosVelsLike = CoaPosVelsMono | CoaPosVelsBi

Represent either a monostatic or bistatic ensemble of COA positions and velocities

type ProjectionSetsLike = ProjectionSetsMono | ProjectionSetsBi

Represent either a monostatic or bistatic ensemble of COA projection sets

type SensitivityMatricesLike = SensitivityMatricesMono | SensitivityMatricesBi

Represent either a set of monostatic or bistatic ensemble sensitivity matrices

Image Plane Parameters

image_grid_to_image_plane_point(scp, urow, ...)

Convert image pixel grid locations to corresponding image plane positions.

image_plane_point_to_image_grid(scp, urow, ...)

Convert image plane positions to corresponding image pixel grid locations.

Image Grid to COA Positions & Velocities

compute_coa_time(ct_coa, image_grid_locations)

Compute Center of Aperture times for specified image grid locations.

compute_coa_pos_vel(proj_metadata, t_coa)

Compute Center of Aperture positions and velocities at specified COA times.

SCP Pixel Projection

compute_scp_coa_r_rdot(proj_metadata)

Compute COA range and range-rate for the Scene Center Point.

compute_scp_coa_slant_plane_normal(proj_metadata)

Compute the slant plane unit normal for the Scene Center Point at its COA.

compute_ric_basis_vectors(p_ric, v_ric)

Compute the orientation of an RIC coordinate frame relative to the input coordinate frame.

Image Grid to R/Rdot Contour

compute_coa_r_rdot(proj_metadata, ...)

Compute COA range and range-rate contours given other projection set components.

compute_projection_sets(proj_metadata, ...)

Compute Center of Aperture projection sets at specified image grid locations.

Precise R/Rdot to Ground Plane Projection

r_rdot_to_ground_plane_mono(look, ...)

Project along contours of constant range and range rate to an arbitrary plane.

r_rdot_to_ground_plane_bi(look, scp, ...[, ...])

Project along bistatic contours of constant average range and range rate to an arbitrary plane.

compute_pt_r_rdot_parameters(look, xmt_coa, ...)

Compute range and range rate parameters at specified scene point positions.

compute_gp_xy_parameters(scene_points, ugpn, ...)

Compute the basis vectors and sensitivity matrices for a ground plane coordinate system.

Scene To Image Grid Projection

scene_to_image(proj_metadata, scene_points, *)

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

Adjustable Parameters

apply_apos(proj_metadata, init_proj_set, ...)

Compute adjusted Center of Aperture projection set.

Precise R/Rdot to Constant HAE Surface Projection

r_rdot_to_constant_hae_surface(look, scp, ...)

Project along contours of constant range and range rate to a surface of constant HAE.

Precise R/Rdot to DEM Surface Projection

r_rdot_to_dem_surface(look, scp, ...[, ...])

Project along a contour of constant range and range rate to a surface described by a Digital Elevation Model.

Projection Sensitivity Parameters

compute_proj_geom_params_mono(proj_set_0, pt0)

Compute set of projection geometry parameters for Collect Type = Monostatic

compute_proj_geom_params_bi(proj_set_0, pt0, ...)

Compute set of projection geometry parameters for Collect Type = Bistatic

compute_slant_plane_sensitivity_matrices(...)

Compute the defined slant plane sensitivity matrices.

compute_image_location_sensitivity_matrices(...)

Compute the defined image location sensitivity matrices

compute_pvt_sensitivity_matrices_mono(...[, pt0])

Compute the defined monostatic position/velocity/timing sensitivity matrices.

compute_pvt_sensitivity_matrices_bi(...[, pt0])

Compute the defined bistatic position/velocity/timing sensitivity matrices.

compute_sensitivity_matrices(proj_metadata)

Compute the defined sensitivity matrices

Projection Error Propagation

compute_ecef_pv_transformation(p_ecef, ...)

Return the transformation matrix from frame to ECEF.

compute_composite_error_no_apo_mono(...)

Compute composite COA slant plane error covariance for monostatic with no APOs.

compute_composite_error_apo_mono(sens_mat, ...)

Compute composite COA slant plane error covariance for monostatic with APOs.

compute_composite_error_no_apo_bi(...)

Compute composite COA slant plane error covariance for bistatic with no APOs.

compute_composite_error_apo_bi(sens_mat, ...)

Compute composite COA slant plane error covariance for bistatic with APOs.

compute_i2s_error(c_ilpt_rgaz, c_il_sel, ...)

Compute the image-to-scene projection error statistics for a projection pair: IL0 and PT0

compute_s2i_error(c_ilpt_rgaz, c_pt_sel, ...)

Compute the scene-to-image projection error statistics for a projection pair: IL0 and PT0