Space-to-Space RSO Image Data

Physical image ownership, complete delivery, and centralized RSO service reward.

class RSOImageData(captures=None, deliveries=None)[source]

Bases: Data

Index immutable acquisition and completed-delivery records by record ID.

class RSOImageStore(satellite, initial_data=None, scenario=None)[source]

Bases: DataStore

Constructor configuration works identically inside composed rewards.

data_type

alias of RSOImageData

get_log_state()[source]

Read physical storage and this observer’s confirmed captures.

compare_log_states(old_state, new_state)[source]

Account for transmitted bits, including several products in a step.

class RSOImageReward(acquisition_reward_fn=None, delivery_reward_fn=None, quality_threshold=0.5, cooldown_s=0.0, multi_imager_credit=None)[source]

Bases: GlobalReward

Configure stage callbacks, mean hold illumination, and cooldown.

Parameters:
  • acquisition_reward_fn – Callable (record, target) -> float for a useful physically acquired image. Defaults to zero.

  • delivery_reward_fn – Callable with the same signature for a useful complete delivery. Defaults to current priority.

  • quality_threshold – Minimum mean illuminated fraction in [0, 1].

  • cooldown_s – Global cooldown from capture time, in seconds.

  • multi_imager_credit – "shared" splits each callback’s value across simultaneous qualified records, while "per_imager" gives each owner its callback’s full value. Required for multiple imagers.

data_store_type

alias of RSOImageStore

Pass configuration through constructor kwargs, including composition.

Return type:

None

reset_overwrite_previous() → None[source]

Reset per-episode uniqueness accounting.

Return type:

None

calculate_reward(new_data_dict)[source]

Update centralized eligibility; credit the actual acquisition/delivery owner.