Data frames

The diagnostics, trends and residuals as pandas data frames, for analysis and plotting (pip install lunaspace[pandas]). Times are UTC, in an index where a table has one; values in SI units, as the API gives them.

frame = lunaspace.frames.trends(client.runs.trends(“SWARM-B”)) frame[“drag_coefficient”].plot()

lunaspace.frames.trends(rows)

A satellite’s runs, one row each, indexed by the end of their arcs: the fit, the share edited, Cd and its sigma, the largest empirical accelerations, and the run before’s prediction at 1, 6, 12 and 24 h (error_24h_m, z_24h_along_track, …).

Parameters:

rows (list[Trend])

Return type:

pandas.DataFrame

lunaspace.frames.segments(diagnostics)

The residuals’ RMS and mean per segment [m], indexed by the segments’ starts.

Parameters:

diagnostics (Diagnostics)

Return type:

pandas.DataFrame

lunaspace.frames.parameter(diagnostics, name)

An estimate’s values with their sigmas (per segment for the empirical accelerations, indexed by the segments’ starts), and its a priori sigma.

Parameters:
Return type:

pandas.DataFrame

lunaspace.frames.correlations(diagnostics)

The correlation matrix with the columns’ names on both axes.

Parameters:

diagnostics (Diagnostics)

Return type:

pandas.DataFrame

lunaspace.frames.residuals(csv)

A run’s residuals product (run.download("residuals")): one row per fix, indexed by its epoch in the file’s time scale, with whether it was used and the residuals in the orbit’s axes, in metres (the file’s are in km).

Parameters:

csv (bytes | str)

Return type:

pandas.DataFrame

lunaspace.frames.ground_track(csv)

The ground track of a satellite’s orbit events (events.download("ground_track")): one row a point, indexed by its epoch (UTC), with the latitude and the longitude [deg, east of Greenwich], the height [km] and the share of the Sun’s disc in view (1: sunlit, 0: in the umbra).

Parameters:

csv (bytes | str)

Return type:

pandas.DataFrame

lunaspace.frames.prediction_series(points)

The run before’s prediction against a run’s fit (diagnostics.prediction()): one row every five minutes, indexed by its epoch (UTC), with the hours after the earlier arc’s end, this orbit minus that prediction along the orbit’s axes and the standard deviations that run predicted, in metres, and each error over its sigma (z_).

Parameters:

points (list[PredictionPoint])

Return type:

pandas.DataFrame

lunaspace.frames.drag_coefficients(rows)

The history of a satellite’s drag coefficient (client.orbits.drag_coefficients): one row an arc, indexed by the arcs’ ends, with the estimate and its sigma.

Parameters:

rows (list[DragCoefficient])

Return type:

pandas.DataFrame