Skip to content

Observation

Observation Schema

Properties

Name Type Description
id Integer Unique identifier of the observation.
uid UUID No description
target_id Integer (Optional) Unique identifier of the target associated with the observation.
status Enum(active, completed, canceled) No description
is_deleted Boolean Flag indicating if the target is deleted.
created_on DateTime Observation creation timestamp
updated_on DateTime Observation update timestamp
observability_last_updated_on DateTime (Optional) Timestamp of the last observability recalculation. Set to NULL to force a refresh.
tasks_last_materialized_on DateTime (Optional) Timestamp of the last task materialization pass. Set to NULL to force a re-materialization. See OBSERVATION_TASK_MATERIALIZATION_DESIGN.md §4.2.
name String(100) Name of the observation.
owner_id Integer Unique identifier of the entity whose observing accounts will be used to fund the observation.
creator_id Integer When the observation owner is an organization, the creator is the organization member who submitted/created the observation.
group_id Integer (Optional) Unique identifier of the group which should be associated with the observations. Group members with observation permissions will automatically be granted access without needing to explicitly share.
interrupt_lower_priority Boolean Flag indicating if the observation should interrupt an active observation of lower priority or wait until it is completed. This will only take effect if the observation is dispatched to a telescope account which allows interrupting observations.
start_after DateTime (Optional) No description
cancel_on DateTime (Optional) No description
priority Integer No description
epoch_count Integer Number of visits (was iterations). 0 = repeat indefinitely.
current_epoch Integer 1-based current epoch derived from the most recent task update for this observation.
cohesion_level Enum(frame, sample, segment, epoch, observation) Largest unit that must run without interruption.
sample_ordering Enum(request_major, sample_major) No description
cadence_kind Enum(asap, min_gap, period, calendar) No description
cadence_level Enum(frame, sample, segment, epoch, observation) (Optional) No description
cadence_gap_sec Float (Optional) No description
cadence_period_sec Float (Optional) No description
cadence_calendar_unit Enum(night, day) (Optional) No description
copies_mode Enum(single, all_eligible, count) No description
copies_count Integer (Optional) No description
coordination_kind Enum(independent, synchronized) (Optional) No description
coordination_start_tolerance_sec Float (Optional) No description
affinity_migrate_at Enum(frame, sample, segment, epoch, observation) Finest unit at which the assigned instrument may change.
affinity_handoff_after_sec Float (Optional) Idle time after which an interrupted unit is released for reassignment. NULL ⇔ migrate_at = observation (no migration).
interrupt_recovery Enum(resume, restart_unit) No description
completed_on DateTime (Optional) No description
last_activity_on DateTime (Optional) No description
render_settings JSONB (Optional) No description
progress_fraction Float Progress of the task execution (0.0 - 1.0).
is_public Boolean No description
afterglow_session_uid UUID (Optional) No description
instrument_mode Enum(none, include, exclude) Access mode for the instruments. If none, all instruments from the observing accounts are available.

Relationships

Relationship Name Type
role_grants ObservationRoleGrant
owner Entity
creator User
group Group
observing_grants ObservingGrant
instruments Instrument
target Target
requests ObservationRequest
assets ObservationAsset
gallery_items ObservationGalleryItem
processing_config_profiles ObservationAssetProcessingConfigProfile
analysis_config_profiles ObservationAssetAnalysisConfigProfile
render_config_profiles ObservationAssetRenderConfigProfile
projects Project
optical_imaging_configuration OpticalImagingConfiguration
radio_tracking_configuration RadioTrackingConfiguration
radio_mapping_configuration RadioMappingConfiguration