empyrean.Session¶

class Session(source, config=None)[source]

Bases: object

Stateful orbit-determination handle.

Methods

`__init__`(source[, config])	Construct a session from a path, PSV content, or quivr table.
`diff`(prior_idx)	Diff the current fit against the `prior_idx`-th history entry.
`from_ades`(path[, config])	Construct a session from an ADES PSV / MPC80 file path.
`from_observations`(observations[, config])	Construct a session from an `ADESObservations` table.
`history`(idx)	Retrieve the i-th history entry.
`is_masked`(idx)	Whether the observation at `idx` is masked.
`mask`(idx)	Mask the observation at the given index.
`refine`()	Run an OD refine using the current mask state.
`unmask`(idx)	Unmask the observation at the given index.
`unmask_all`()	Clear all masks.

Attributes

`history_len`	Number of fits stored in the session history.
`n_active`	Number of observations active in the next refine.
`n_masked`	Number of currently masked observations.
`n_observations`	Total observations in the session, masked or not.

Parameters:

source (str | Path | ADESObservations)
config (ODConfig | None)

classmethod from_ades(path, config=None)[source]

Construct a session from an ADES PSV / MPC80 file path.

Return type:

Session

Parameters:

path (str | Path)
config (ODConfig | None)

classmethod from_observations(observations, config=None)[source]

Construct a session from an ADESObservations table.

Return type:

Session

Parameters:

observations (ADESObservations)
config (ODConfig | None)

property n_observations: int: Total observations in the session, masked or not.

property n_masked: int: Number of currently masked observations.

property n_active: int: Number of observations active in the next refine.

mask(idx)[source]

Mask the observation at the given index.

Return type:: None
Parameters:: idx (int)

unmask(idx)[source]

Unmask the observation at the given index.

Return type:: None
Parameters:: idx (int)

unmask_all()[source]

Clear all masks.

Return type:: None

is_masked(idx)[source]

Whether the observation at idx is masked.

Return type:: bool
Parameters:: idx (int)

refine()[source]

Run an OD refine using the current mask state.

On the first call runs the full IOD → DC pipeline. On subsequent calls reuses the previously-fit orbit as the IOD seed (skipping the IOD step). Pushes the new fit onto the session’s history.

Return type:: DetermineResult

property history_len: int: Number of fits stored in the session history.

history(idx)[source]

Retrieve the i-th history entry.

Return type:: DetermineResult
Parameters:: idx (int)

diff(prior_idx)[source]

Diff the current fit against the prior_idx-th history entry.

Return type:: SessionDiff
Parameters:: prior_idx (int)