Skip to content

OpticalImagingConfiguration

OpticalImagingConfiguration Schema

Properties

Name Type Description
id Integer No description
observation_id Integer No description
tracking_mode Enum(sidereal, target) No description
repointing_strategy Enum(lock, fov_threshold) How a moving target's drift through the field is handled while imaging: 'lock' freezes the first-exposure coordinate (the target drifts through the FOV), 'fov_threshold' recenters once drift exceeds recentering_threshold. A no-op for a fixed sidereal target (no drift).
dither_strategy Enum(none, grid, snake, spiral, cross, jitter) The strategy used for dithering during observations. If set to 'none', no dithering is applied.
dither_step_size_deg Float (Optional) The step size in degrees for dithering. Used when dither_strategy is not 'none'.
dither_steps Integer (Optional) The number of steps in the dithering pattern. Used when dither_strategy is not 'none'.
dither_position_angle_deg Float (Optional) Rotation angle of the dithering pattern in degrees. Used when dither_strategy is not 'none'.
recentering_threshold Float (Optional) Maximum allowed displacement of the target from the center of the camera sensor while tracking, expressed as a percentage of the half-size of the sensor's dimensions. This value defines the threshold for triggering the recentering of the target within the sensor's field of view, ensuring the target remains optimally positioned for tracking and imaging. Default 50% (recenter once the target has drifted halfway to a sensor edge), which keeps recenters infrequent relative to a typical exposure.
temporal_offset_sec Float The number of seconds from the current time when the target's position should be calculated. This parameter allows for predictive adjustments to the telescope's pointing based on the target's future or past position.
field_locked_on DateTime (Optional) No description
min_fov_x_arcmin Float (Optional) Minimum field of view X size in arcminutes.
min_fov_y_arcmin Float (Optional) Minimum field of view Y size in arcminutes.
position_angle_deg Float (Optional) Rotation angle of the field of view X axis with respect to RA axis in degrees.
min_pixel_scale_arcsec_per_px Float (Optional) Minimum pixel scale in arcseconds per pixel.
max_pixel_scale_arcsec_per_px Float (Optional) Maximum pixel scale in arcseconds per pixel.
max_tiles Integer No description
tile_overlap Float No description
min_elevation_deg Float (Optional) Minimum allowed target elevation in degrees. Target must rise above this elevation before observation requests can be completed.
max_elevation_deg Float (Optional) Maximum allowed target elevation in degrees. Target must set below this elevation before observation requests can be completed.
min_sun_elevation_deg Float (Optional) Minimum allowed sun elevation in degrees. Sun must rise above this elevation before observation requests can be completed.
max_sun_elevation_deg Float (Optional) Maximum allowed sun elevation in degrees. Sun must set below this elevation before observation requests can be completed.
min_moon_separation_deg Float (Optional) No description
min_moon_phase_fraction Float (Optional) Lower bound on the moon's illuminated fraction (0..1). Combines with max_moon_phase_fraction to define a phase window.
max_moon_phase_fraction Float (Optional) No description
lunar_phase_direction Enum(any, waxing, waning) (Optional) Restrict scheduling to a specific side of the lunar cycle. NULL behaves like 'any' — no direction filter.
saturation_level_fraction Float The fraction of full-well capacity at which the sensor should be considered saturated.
brightness_model_id Integer (Optional) Brightness model used to size exposures so the target's signal is well above the noise floor.
saturation_model_id Integer (Optional) Saturation cap — exposure times are limited so sources at or below this brightness don't saturate the detector.

Relationships

Relationship Name Type
observation Observation
brightness_model BrightnessModel
saturation_model BrightnessModel