Figures

Library for simulating space-based VLBI missions (spacevlbi)

Copyright 2024 Ben Hudson

Licensed under the GNU General Public License, Version 3.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

spacevlbi.Figures.AttitudeSphere(spaceTelescopes, telescopeSelect=0, azim=45, elev=30, plotAntenna=1, plotSTR=1, plotRad=1, plotComms=1, plotPanels=1, plotEarth=1, plotSun=1, plotMoon=1)

Plot attitude sphere of spacecraft in the body-fixed frame. Earth, Sun and Moon positions depicted. Note. For systems that have different Sun, Earth and Moon exclusion angles (e.g. radiator), only the largest is plotted.

Parameters:

  • spaceTelescopes (list) – Array of SpaceTelescope objects, defaults to None

  • telescopeSelect (int) – Index of spaceTelescope array to plot attitude sphere of, defaults to 0

  • azim (float) – Plot viewing angle, azimuth in X-Y plane, defaults to 45 degrees

  • elev (float) – Plot viewing angle, elevation in Z plane, defaults to 30 degrees

  • plotAntenna (bool) – Plot antenna? Defaults to 1

  • plotSTR (bool) – Plot star trackers? Defaults to 1

  • plotRad (bool) – Plot radiators? Defaults to 1

  • plotComms (bool) – Plot comms systems? Defaults to 1

  • plotPanels (bool) – Plot solar panels? Defaults to 1

  • plotEarth (bool) – Plot Earth vector and limb? Defaults to 1

  • plotSun (bool) – Plot Sun vector and limb? Defaults to 1

  • plotMoon (bool) – Plot Moon vector and limb? Defaults to 1

spacevlbi.Figures.Cone3D(p0, p1, R0, R1, n)

Plot 3D cone. Used in AttitudeSphere figure.

Parameters:

  • p0 (list) – Unit vector of vertex position, defaults to None

  • p1 (list) – Unit vector of base position, defaults to None

  • R0 (float) – Radius at vertex, defaults to None

  • R1 (float) – Radius at base, defaults to None

  • n (int) – Number of radial steps used in cone surface generation, defaults to None

spacevlbi.Figures.ECEF_to_LLA(ecef)

Convert ECEF to LLA using WGS84 ellipsoid model.

Parameters:

ecef (np.array) – Earth-Centered Earth-Fixed vector in km, defaults to None

Returns:

latitude [deg], longitude [deg], altitude [km]

Return type:

np.array

spacevlbi.Figures.ElevationEarthMap(spaceTelescopes, groundStations, telescopeSelect=0)

Plot Earth map showing spacecraft ground track and visibility to ground stations.

Parameters:

  • spaceTelescopes (list) – Array of SpaceTelescope objects, defaults to None

  • groundStations (list) – Array of GroundStation objects, defaults to None

  • telescopeSelect (int) – Index of spaceTelescope array to plot ground station elevation of, defaults to 0

spacevlbi.Figures.GroundStationElevation(spaceTelescopes, groundStations, simTime, telescopeSelect=0)

Plot elevation angle of selected space telescope at each ground station as a function of the simulation time.

Parameters:

  • spaceTelescopes (list) – Array of SpaceTelescope objects, defaults to None

  • groundStations (list) – Array of GroundStation objects, defaults to None

  • simTime (list) – Timeseries of simulation time, defaults to None

  • telescopeSelect (int) – Index of spaceTelescope array to plot ground station elevation of, defaults to 0

spacevlbi.Figures.OrbitPlot(spaceTelescopes)

Plot orbits of space telescopes.

Parameters:

spaceTelescopes (list) – Array of SpaceTelescope objects, defaults to None

spacevlbi.Figures.SolarPanelIncidence(spaceTelescopes, simTime, telescopeSelect=0)

Plot angle of Sun incidence on the solar panels, measured with respect to the panel normal.

Parameters:

  • spaceTelescopes (list) – Array of SpaceTelescope objects, defaults to None

  • simTime (list) – Timeseries of simulation time, defaults to None

  • telescopeSelect (int) – Index of spaceTelescope array to plot solar panel incidence of, defaults to 0

spacevlbi.Figures.UvPlot(spaceTelescopes, groundTelescopes, allsky, frequency, plotLost=1)

Plot (u,v) coverage of a target source(s) generated by the simulated array.

Parameters:

  • spaceTelescopes (list) – Array of SpaceTelescope objects, defaults to None

  • groundTelescopes (list) – Array of GroundTelescope objects, defaults to None

  • frequency (list) – Observation frequencies in Hz, defaults to None

  • plotLost (bool) – Plot baselines lost due to functional constraints? Defaults to 1

  • allysky (bool) – Plot all-sky coverage? Should be equal to allsky parameter defined in the Timeloop() function