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.
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.
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¶