API

sensor positions with shape (3,) or (N, 3)

vectors aligned with a looking direction with shape (3,) or (N, 3)

altitude with respect to WGS84 ellipsoid, by default 0.0

ground points with shape (3,) or (N, 3), np.nan is a place-holder in case of impossible geocoding

sensor positions with shape (3,) or (N, 3)

sensor velocities with shape (3,) or (N, 3)

reference frames oriented so that look angles are measured relative to the nadir direction

look angles in radians, scalar or (N,)

altitude with respect to WGS84 ellipsoid, by default 0.0

ground points with shape (3,) or (N, 3), np.nan is a place-holder in case of impossible geocoding

sensor positions, with shape (3,) or (N, 3)

antenna reference frames as a numpy array, with shape (3, 3) or (N, 3, 3)

scalar or (N,), in radians

scalar or (N,), in radians

altitude with respect to WGS84 ellipsoid, by default 0.0

ground points (3,) or (N, 3) numpy array

position of the sensor with shape (3,) or (N, 3)

velocity of the sensor with shape (3,) or (N, 3)

range times scalar or (M,)

doppler frequencies scalar or array (M,)

carrier signal wavelength

geocoding side, "RIGHT" or "LEFT"

altitude with respect to WGS84 ellipsoid

initial guess for Newton method. If not provided a guess will be computed, by default None

ground points with shape (N, M, 3)

position of the receiver with shape (3,) or (N, 3)

velocity of the receiver with shape (3,) or (N, 3)

position of the transmitter with shape (3,) or (M, 3), where M is the number of range times

velocity of the transmitter with shape (3,) or (M, 3), where M is the number of range times

range times scalar or shape (M,)

doppler frequencies scalar or shape (M,)

carrier signal wavelength

geocoding side, "RIGHT" or "LEFT"

altitude with respect to the WGS84 ellipsoid

initial guess for Newton iterations. If not provided a guess will be computed, by default None

ground points with shape (N, M, 3)

sensor positions with shape (3,) or (N, 3)

sensor velocities with shape (3,) or (N, 3)

range distance

side where to perform geocoding, "RIGHT" or "LEFT"

guess ground points with shape (3,) or (N, 3)

sensor trajectory

ground points to inverse geocode in XYZ coordinates, in the form (3,) or (N, 3)

doppler frequencies centroid values to perform the inverse geocoding, in the form float or (N,). the number of frequencies must be 1 or equal to the number of points provided (if more than 1). If just 1 ground point is provided, several frequencies can be given to compute inverse geocoding at each different input value

carrier signal wavelength

azimuth times initial guesses to limit and guide the search of solutions, in the form (N,) or as a single time. If None, it is automatically computed, by default None

if an azimuth initial guess for the Newton method is not provided, this parameter will be used to generate a time axis with this time step and the same time domain as the input trajectory to automatically compute the guess, the same step is used for both trajectories, by default None

azimuth times array

range times array

sensor trajectory

sensor attitude

ground points to inverse geocode in XYZ coordinates, in the form (3,) or (N, 3)

doppler frequencies centroid values to perform the inverse geocoding, in the form float or (N,). the number of frequencies must be 1 or equal to the number of points provided (if more than 1). If just 1 ground point is provided, several frequencies can be given to compute inverse geocoding at each different input value

carrier signal wavelength

time step for computing the approximate derivative of the boresight normal unit vector, by default 0.1

azimuth times initial guesses to limit and guide the search of solutions, in the form (N,) or as a single time. If None, it is automatically computed, by default None

if an azimuth initial guess for the Newton method is not provided, this parameter will be used to generate a time axis with this time step and the same time domain as the input trajectory to automatically compute the guess, the same step is used for both trajectories, by default None

azimuth times array

range times array

sensor trajectory

ground points to inverse geocode in XYZ coordinates, in the form (3,) or (N, 3)

sensor trajectory time axis array

doppler frequencies centroid values to perform the inverse geocoding, in the form float or (N,). the number of frequencies must be 1 or equal to the number of points provided (if more than 1). If just 1 ground point is provided, several frequencies can be given to compute inverse geocoding at each different input value

carrier signal wavelength

azimuth times initial guesses, one for each input point

receiving sensor trajectory

transmitting sensor trajectory

ground points to inverse geocode in XYZ coordinates, in the form (3,) or (N, 3)

doppler frequencies centroid values to perform the inverse geocoding, in the form float or (N,). the number of frequencies must be 1 or equal to the number of points provided (if more than 1). If just 1 ground point is provided, several frequencies can be given to compute inverse geocoding at each different input value

carrier signal wavelength

azimuth times initial guesses to limit and guide the search of solutions, in the form (N,) or as a single time. If None, it is automatically computed, by default None

if an azimuth initial guess for the Newton method is not provided, this parameter will be used to generate a time axis with this time step and the same time domain as the input trajectory to automatically compute the guess, the same step is used for both trajectories, by default None

azimuth times array

range times array

if the input sensors' trajectories are overlapping

sensor positions with shape (3,) or (N, 3)

sensor velocities with shape (3,) or (N, 3)

range times with shape float or (M,)

frequency_doppler_centroid value, single value or array (M,)

carrier signal wavelength

altitude with respect to WGS84 ellipsoid

initial guess for the Newton method, with shape (3,) or (N, 3) or (M, 3)

ground points with shape (N, M, 3)

sensor positions with shape (3,) or (N, 3)

sensor velocities with shape (3,) or (N, 3)

range times with shape float or (M,)

frequency_doppler_centroid value, single value or array (M,)

carrier signal wavelength

altitude with respect to WGS84 ellipsoid

initial guess for the Newton method, with shape (3,) or (N, 3) or (M, 3)

ground points with shape (N, M, 3)

position of the receiver, with shape (3,) or (N, 3)

velocities of the receiver, with shape (3,) or (N, 3)

position of the transmitter, with shape (3,) or (M, 3), where M is the number of range times

velocities of the transmitter, with shape (3,) or (M, 3), where M is the number of range times

range times with shape float or (M,)

frequency_doppler_centroid value, single value or array (M,)

carrier signal wavelength

altitude with respect to WGS84 ellipsoid

initial guess for Newton method, with shape (3,), (N, 3) or (M, 3)

ground points with shape (N, M, 3)

sensor trajectory

ground points to inverse geocode in XYZ coordinates, in the form (3,) or (N, 3)

azimuth times initial guesses to limit and guide the search of solutions, in the form (N,) or as a single time

doppler frequencies centroid values to perform the inverse geocoding, in the form float or (N,). the number of frequencies must be 1 or equal to the number of points provided (if more than 1). If just 1 ground point is provided, several frequencies can be given to compute inverse geocoding at each different input value

carrier signal wavelength

ground scene velocity. If None, it's set to the default value of 0, by default None

absolute time tolerance for newton convergence criteria, by default 1e-8

maximum number of iterations for newton method, by default 8

azimuth times array

range times array

ambiguous association between N ground points and M init guesses

ambiguous association between N ground points and M frequencies

Newton method could not converge

receiving sensors trajectory

transmitting sensor trajectory

ground points to inverse geocode in XYZ coordinates, in the form (3,) or (N, 3)

azimuth times initial guesses to limit and guide the search of solutions, in the form (N,) or as a single time

doppler frequencies centroid values to perform the inverse geocoding, in the form float or (N,). the number of frequencies must be 1 or equal to the number of points provided (if more than 1). If just 1 ground point is provided, several frequencies can be given to compute inverse geocoding at each different input value

carrier signal wavelength

absolute time tolerance for newton convergence criteria, by default 1e-8

maximum number of iterations for newton method, by default 8

azimuth times array

range times array

ambiguous association between N ground points and M init guesses

ambiguous association between N ground points and M frequencies

Newton method could not converge

sensor trajectory

trajectory's time axis array

ground points to inverse geocode in XYZ coordinates, in the form (3,) or (N, 3)

doppler frequencies centroid values to perform the inverse geocoding, in the form float or (N,). the number of frequencies must be 1 or equal to the number of points provided (if more than 1). If just 1 ground point is provided, several frequencies can be given to compute inverse geocoding at each different input value

carrier signal wavelength

list of azimuth times initial guesses arrays, one for each input ground point

receiving sensor trajectory

transmitting sensor trajectory

receiving sensor trajectory time axis array

transmitting sensor trajectory time axis array

ground points to inverse geocode in XYZ coordinates, in the form (3,) or (N, 3)

doppler frequencies centroid values to perform the inverse geocoding, in the form float or (N,). the number of frequencies must be 1 or equal to the number of points provided (if more than 1). If just 1 ground point is provided, several frequencies can be given to compute inverse geocoding at each different input value

carrier signal wavelength

azimuth times initial guesses

ambiguous association between N ground points and M frequencies

if orbit rx and orbit tx are not overlapped

sensor trajectory

sensor attitude

earth points to inverse geocode in XYZ coordinates, in the form (3,) or (N, 3)

initial guesses for newton resolution method, initial guess can be a single PDT value or an array of PDT (N,)

time step for computing the approximate derivative of the boresight normal unit vector, by default 0.1

absolute time tolerance for newton convergence criteria, by default 1e-8

maximum number of iterations for newton method, by default 8

azimuth times array

range times array

ambiguous association between N input guesses and M earth points

Newton method could not converge