New plots (#11)

* new file to handle coordinate conversions

* moved most of the coordinate functions to .coordinates, some remain as they will require much more refactoring

* added several functions for use in plotUtils

* improved the brightness functions and added a gamma angle calculation

* updated the calculate_orbital_elements function

* added keplerian orbital element plots

* simply.py is a useful file to add functions that combine many other functionalities within ssapy.

* added points_on_circle for use in simply.py

* added ipython module for interactive plots

* added imageio for generation of gifs.

* added tqdm for progress bars

* added faster io functions and updated old io functions added by me

* added functions to calculate the position of lagrange points

* removed due to circular import conflicts, coordinates are all together in utils.py where they initially were

* added many more coordinate conversions useful for plotting

* added a gif writing function

* added built in plot to rotate_vector - used for validation

* fixed remaining circular imports

* cleaned up the get_times function, added weeks as a unit

* added doc string to ssapy_orbit()

* added plot_path as optional input to rotate_vector()

* added simply.py which will contain simplified functions for using ssapy

* adding a testing plot testing function

* changed the output of ssapy_orbit() to always give back the time array used.

* changed save directory of test plots

* added an ignore for the ssapy_test_plots/ folder which will be generated if user runs test_plots.py

* added docstrings to all plot functions

* added doc strings to all new functions

* added doc strings

* changed lagrange_point_lunar_frame() doc string

* more doc strings

* added doc strings

* added / after {save_folder}

* empty line at end

* doc string to DRO()

* new line added

* mentioned Kelerian in the doc string

* file_exists renamed

* renamed getAngle and moved get_angle to utils.py where a copy was already.

* renamed file_exists

* modified save_plot to accept any extension

* renamed write gif to save_animated_gif

* removed a comment

* removed get_angle()

* changed doc strings to lagrange point functions

* changed some function names that were changed in .utils and .compute

* merged make_black and make_white to set_color_theme

* renamed groundTrackPlot and added Keplerian to several dot strings

* drawmoon and drawearth renamed

* standardized npload and npsave and pload psave

* more renamed and changes

* lunar decapitalized

* bool instantly returned in exists

* index added to sortbynum to allow user to chose which number to sort by

* sortbynum renamed to _sortbynum

---------

Co-authored-by: yeager7 <[email protected]>

.gitignore

@@ -47,6 +47,9 @@ pytest.xml
 pytest_session.txt
 cover/
 
+# Ignore ssapy_test_plots folder in tests subfolder
+tests/ssapy_test_plots/
+
 # Sphinx documentation
 docs/_build/
 docs/source/api

setup.py

@@ -73,6 +73,8 @@ def build_extension(self, ext):
         'pandas',
         'h5py',
         'pypdf2',
+        'imageio',
+        'ipython',
         'ipyvolume',
         'ipython_genutils',
         'jplephem',
@@ -84,6 +86,7 @@ def build_extension(self, ext):
         'sphinx-autobuild',
         'sphinx-tabs',
         'sphinx-automodapi',
+        'tqdm',
         'myst-parser',
         'graphviz',
     ],

ssapy/__init__.py

@@ -39,6 +39,7 @@
 from . import plotUtils
 from . import io
 from . import utils
+from . import simple
 from astropy.time import Time, TimeDelta
 import astropy.units as u
 from datetime import timedelta