Module: trajectory_explorer#

class kbmod.trajectory_explorer.TrajectoryExplorer(img_stack, config=None)[source]#

A class to interactively run test trajectories through KBMOD.

Attributes:
configSearchConfiguration

The configuration parameters.

searchkb.StackSearch

The search object (with cached data).

Methods

apply_sigma_g(result)

Apply sigma G clipping to a single ResultRow.

evaluate_angle_trajectory(ra, dec, v_ra, ...)

Evaluate a single linear trajectory in angle space.

evaluate_around_linear_trajectory(x, y, vx, vy)

Evaluate all the trajectories within a local neighborhood of the given trajectory.

evaluate_linear_trajectory(x, y, vx, vy)

Evaluate a single linear trajectory in pixel space.

initialize_data([config])

Initialize the data, including applying the configuration parameters.

apply_sigma_g(result)[source]#

Apply sigma G clipping to a single ResultRow. Modifies the row in-place.

Parameters:
resultResults

A table of results to test.

evaluate_angle_trajectory(ra, dec, v_ra, v_dec, wcs)[source]#

Evaluate a single linear trajectory in angle space. Skips all the filtering steps and returns the raw data.

Parameters:
rafloat

The right ascension at time t0 (in degrees)

decfloat

The declination at time t0 (in degrees)

v_rafloat

The velocity in RA at t0 (in degrees/day)

v_decfloat

The velocity in declination at t0 (in degrees/day)

wcsastropy.wcs.WCS

The WCS for the images.

Returns:
resultResults

The results table with a single row and all the columns filled out.

evaluate_around_linear_trajectory(x, y, vx, vy, pixel_radius=5, max_ang_offset=0.2618, ang_step=0.035, max_vel_offset=10.0, vel_step=0.5)[source]#

Evaluate all the trajectories within a local neighborhood of the given trajectory. No filtering is done at all.

Parameters:
xint

The starting x pixel of the trajectory.

yint

The starting y pixel of the trajectory.

vxfloat

The x velocity of the trajectory in pixels per day.

vyfloat

The y velocity of the trajectory in pixels per day.

pixel_radiusint

The number of pixels to evaluate to each side of the Trajectory’s starting pixel.

max_ang_offsetfloat

The maximum offset of a candidate trajectory from the original (in radians)

ang_stepfloat

The step size to explore for each angle (in radians)

max_vel_offsetfloat

The maximum offset of the velocity’s magnitude from the original (in pixels per day)

vel_stepfloat

The step size to explore for each velocity magnitude (in pixels per day)

Returns:
resultResults

The results table with a single row and all the columns filled out.

evaluate_linear_trajectory(x, y, vx, vy)[source]#

Evaluate a single linear trajectory in pixel space. Skips all the filtering steps and returns the raw data.

Parameters:
xint

The starting x pixel of the trajectory.

yint

The starting y pixel of the trajectory.

vxfloat

The x velocity of the trajectory in pixels per day.

vyfloat

The y velocity of the trajectory in pixels per day.

Returns:
resultResults

The results table with a single row and all the columns filled out.

initialize_data(config=None)[source]#

Initialize the data, including applying the configuration parameters.

Parameters:
configSearchConfiguration, optional

Any custom configuration parameters to use for this run. If None uses the default configuration parameters.