diff --git a/skyfield/documentation/example-plots.rst b/skyfield/documentation/example-plots.rst index c8b7459..ebc3ec7 100644 --- a/skyfield/documentation/example-plots.rst +++ b/skyfield/documentation/example-plots.rst @@ -6,7 +6,18 @@ This section of the documentation will gradually accumulate example scripts for producing images from Skyfield computations. -For now there are two: + +Note that these example scripts +are written for fairly recent versions of `matplotlib`_. +If you try running them on a system +with an older version of the library, +you might see errors — in particular with how they specify colors, +in which case you can try omitting those parameters +to get the script running. +In any case, +these are only intended to be a starting point +for building your own scripts, +either with matplotlib or whatever other plotting library you prefer. Finder chart for comet NEOWISE ============================== @@ -43,8 +54,7 @@ Use the script as a starting point: os.rename('neowise-finder-chart.png', '_static/neowise-finder-chart.png') If you choose a different rendering engine -instead of the venerable but rather ornery and complicated -`matplotlib `_, +instead of the venerable but rather ornery and complicated `matplotlib`_, then of course the plotting calls you make will be completely different. But the basic data loading and filtering will be the same, @@ -59,8 +69,7 @@ and it re-entered the atmosphere above the Pacific Ocean: .. image:: _static/goce-reentry.png -The code to produce the diagram -using `matplotlib `_, +The code to produce the diagram using `matplotlib`_, including custom tick marks that are based on the date, is: @@ -125,3 +134,5 @@ is: import os os.rename('goce-reentry.png', '_static/goce-reentry.png') + +.. _matplotlib: https://matplotlib.org/