stella
Interface Assessing
public interface Assessing
Main interface for rating the qualtiy or success of a target execution
just taken.
After a target has been finished, it might instantly be clear that the
observation was not successful, e.g. because the target was not acquired
or irrevocably lost during observation. In these cases, a target may
raise a retry flag or leave the observation tagged as unsuccessful, if
it is unlikely that an immediate retry of the observation will be
successful. On the other hand, it may not be as obvious from the
pure execution, but may be deduced only by the data product of the
observation, which is normally a fits file. Here, this instances come into
play, which are intended for asynchronous validation of data quality.
No presumptions on time-consume for this validation process are made,
so the main method is started after the target has been finished, and
runs unaffected from further observations. Once the quality of the data
has been asset, though, the result should be reflected in the target's
history, allowing a possible re-observation, if the target failed.
Consequentially, instances of this interface may manipulate the
history database and may also put values into the observation table.
registerPick
void registerPick(HistoryAware.Pick pick)
- Registers the entry in the target"s history, for which assessment should
take place. Per default, this pick should read as successful to
block immediate retries of the target. If it is decided, however,
that this pick was not successful, it should be altered to the
new, unsuccessful state.