Constellation Handle

class huira.swir8.ConstellationHandle

Satellites, many of them, each placed by SGP4 from its element set, as a node in the scene’s TEME frame would be, and seen as an instance of one unresolved object. A scene view places them all at once, each with the temporal samples its motion needs, and leaves out, with a warning, any SGP4 can’t place during its exposure.

__init__(*args, **kwargs)
add(*args, **kwargs)

Overloaded function.

  1. add(self: huira._huira.swir8.ConstellationHandle, element_sets: list[huira._huira.SatRec]) -> huira._huira.ConstellationReport

Add satellites from their element sets (SatRecs), or replace the element sets of those it holds. A satellite something else places is left out. Returns a ConstellationReport.

  1. add(self: huira._huira.swir8.ConstellationHandle, catalog: huira._huira.ElementSetCatalog) -> huira._huira.ConstellationReport

Add the satellites of a catalog read (ElementSetCatalog), or replace the element sets of those it holds, reporting the entries the read left out too

clear(self: huira._huira.swir8.ConstellationHandle) → None

Remove every satellite

contains(self: huira._huira.swir8.ConstellationHandle, catalog_number: int) → bool

Whether it holds a satellite

element_set(self: huira._huira.swir8.ConstellationHandle, catalog_number: int) → huira._huira.SatRec

The element set (SatRec) it holds for a satellite; raises if it holds none

element_sets(self: huira._huira.swir8.ConstellationHandle) → list[huira._huira.SatRec]

The element sets it holds, one for each satellite, in no particular order

get_unresolved_object(self: huira._huira.swir8.ConstellationHandle) → huira._huira.swir8.UnresolvedObjectHandle

The unresolved object each satellite is seen as

id(self: huira._huira.swir8.ConstellationHandle) → int
is_visible(self: huira._huira.swir8.ConstellationHandle) → bool

Whether its satellites are shown

load(self: huira._huira.swir8.ConstellationHandle, path: os.PathLike, *, format: Optional[huira._huira.ElementSetFormat] = None, mode: huira._huira.Sgp4Mode = <Sgp4Mode.AFSPC: 0>, include: list[int] = [], exclude: list[int] = [], reference_time: Optional[huira._huira.Time] = None, max_age: object = None, strict: bool = False) → huira._huira.ConstellationReport

Read a catalog of element sets from a file, and add its satellites, or bring those it holds up to date. Returns a ConstellationReport.

format: an ElementSetFormat, or None to work it out from the text. mode: the Sgp4Mode to propagate them in; leave it AFSPC unless you have a reason not to. include: keep only the satellites with these catalog numbers, or every one if it is empty. exclude: leave out the satellites with these catalog numbers. reference_time: when the element sets are to be used. Of a satellite’s element sets, the one whose epoch is nearest it is kept, or with none, the newest. max_age: leave out element sets whose epoch is further than this from reference_time, as a duration such as huira.units.Day(14). strict: raise on the first entry that isn’t an element set SGP4 can propagate, rather than skip it.

name(self: huira._huira.swir8.ConstellationHandle) → str
remove(self: huira._huira.swir8.ConstellationHandle, catalog_number: int) → bool

Remove a satellite, which something else can then place; False if it held none

set_unresolved_object(self: huira._huira.swir8.ConstellationHandle, unresolved_object: huira._huira.swir8.UnresolvedObjectHandle) → None

Set the unresolved object each satellite is seen as

set_visible(self: huira._huira.swir8.ConstellationHandle, visible: bool) → None

Show or hide its satellites: a scene view leaves out a hidden constellation’s

size(self: huira._huira.swir8.ConstellationHandle) → int

The number of satellites it holds

type(self: huira._huira.swir8.ConstellationHandle) → str
valid(self: huira._huira.swir8.ConstellationHandle) → bool