Update documentation.

Author: mkelley

CHANGES.rst

@@ -13,6 +13,11 @@
 New Features
 ------------
 
+sbpy.data.ephem
+^^^^^^^^^^^^^^^
+
+- New command-line script: ``sbpy-ephem``.
+
 sbpy.utils
 ^^^^^^^^^^
 

docs/sbpy/data/ephem.rst

@@ -309,4 +309,55 @@ Telescope:
 The properties computed by pyoorb and listed in the resulting table are defined
 in the `pyoorb documentation
 <https://github.com/oorb/oorb/tree/master/python>`_. Note that this function
-requires pyoorb to be installed, which is not a requirement for `sbpy`.
+requires pyoorb to be installed, which is not a requirement for `sbpy`.
+
+
+Command line scripts
+--------------------
+
+Ephemerides may be generated from the command line using the ``sbpy-ephem``
+script installed during sbpy's installation.  The script supports ephemeris
+generation from Horizons, the Minor Planet Center, and Miriade.  A limited
+number of input parameters are supported.  Run with the ``--help`` option for
+more details.
+
+For example to get the ephemeris of comet 2P/Encke from the Minor Planet Center
+over the next month::
+
+    $ sbpy-ephem mpc 2P
+            Date               RA         Dec       r   Delta Phase Elongation  V   Proper motion Direction
+                                deg         deg       AU    AU   deg     deg     mag    arcsec / h     deg   
+    ----------------------- ----------- ----------- ----- ----- ----- ---------- ---- ------------- ---------
+    2024-06-27 00:00:00.000 22:46:17.90 -11:05:59.0 3.079 2.485  17.2      116.7 20.8         18.25     249.6
+    2024-06-28 00:00:00.000 22:45:49.30 -11:08:36.0 3.085 2.478  17.0      117.7 20.8         19.22     249.6
+    2024-06-29 00:00:00.000 22:45:19.10 -11:11:21.0 3.091  2.47  16.7      118.8 20.8         20.19     249.6
+    2024-06-30 00:00:00.000 22:44:47.50 -11:14:14.0 3.098 2.462  16.5      119.9 20.8         21.16     249.6
+    2024-07-01 00:00:00.000 22:44:14.40 -11:17:15.0 3.104 2.455  16.3      121.0 20.8         22.13     249.6
+    2024-07-02 00:00:00.000 22:43:39.80 -11:20:23.0  3.11 2.448  16.1      122.1 20.8         23.09     249.7
+    2024-07-03 00:00:00.000 22:43:03.80 -11:23:40.0 3.116 2.441  15.8      123.2 20.8         24.05     249.7
+    2024-07-04 00:00:00.000 22:42:26.20 -11:27:04.0 3.122 2.433  15.6      124.3 20.8         25.01     249.7
+    2024-07-05 00:00:00.000 22:41:47.20 -11:30:36.0 3.128 2.427  15.4      125.5 20.9         25.96     249.8
+    2024-07-06 00:00:00.000 22:41:06.60 -11:34:15.0 3.134  2.42  15.1      126.6 20.9         26.91     249.8
+    2024-07-07 00:00:00.000 22:40:24.70 -11:38:01.0  3.14 2.413  14.8      127.7 20.9         27.84     249.9
+    2024-07-08 00:00:00.000 22:39:41.20 -11:41:54.0 3.146 2.407  14.6      128.9 20.9         28.77     249.9
+    2024-07-09 00:00:00.000 22:38:56.40 -11:45:55.0 3.152 2.401  14.3      130.0 20.9         29.68     250.0
+    2024-07-10 00:00:00.000 22:38:10.10 -11:50:02.0 3.158 2.395  14.0      131.2 20.9         30.59     250.0
+    2024-07-11 00:00:00.000 22:37:22.40 -11:54:16.0 3.164 2.389  13.7      132.3 20.9         31.48     250.1
+    2024-07-12 00:00:00.000 22:36:33.30 -11:58:37.0  3.17 2.383  13.5      133.5 20.9         32.36     250.1
+    2024-07-13 00:00:00.000 22:35:42.80 -12:03:04.0 3.176 2.378  13.2      134.7 20.9         33.22     250.2
+    2024-07-14 00:00:00.000 22:34:51.00 -12:07:37.0 3.182 2.373  12.9      135.8 20.9         34.07     250.3
+    2024-07-15 00:00:00.000 22:33:57.80 -12:12:16.0 3.188 2.368  12.6      137.0 20.9         34.91     250.3
+    2024-07-16 00:00:00.000 22:33:03.40 -12:17:00.0 3.193 2.363  12.2      138.2 20.9         35.72     250.4
+    2024-07-17 00:00:00.000 22:32:07.60 -12:21:51.0 3.199 2.359  11.9      139.4 20.9         36.52     250.5
+    2024-07-18 00:00:00.000 22:31:10.60 -12:26:46.0 3.205 2.354  11.6      140.6 20.9          37.3     250.6
+    2024-07-19 00:00:00.000 22:30:12.40 -12:31:46.0 3.211  2.35  11.3      141.8 21.0         38.06     250.6
+    2024-07-20 00:00:00.000 22:29:12.90 -12:36:51.0 3.217 2.346  11.0      143.0 21.0          38.8     250.7
+    2024-07-21 00:00:00.000 22:28:12.30 -12:42:01.0 3.222 2.343  10.6      144.2 21.0         39.52     250.8
+    2024-07-22 00:00:00.000 22:27:10.50 -12:47:15.0 3.228 2.339  10.3      145.4 21.0         40.21     250.9
+    2024-07-23 00:00:00.000 22:26:07.60 -12:52:33.0 3.234 2.336   9.9      146.6 21.0         40.89     251.0
+    2024-07-24 00:00:00.000 22:25:03.70 -12:57:55.0 3.239 2.334   9.6      147.9 21.0         41.54     251.1
+    2024-07-25 00:00:00.000 22:23:58.60 -13:03:20.0 3.245 2.331   9.2      149.1 21.0         42.17     251.1
+    2024-07-26 00:00:00.000 22:22:52.60 -13:08:49.0  3.25 2.329   8.9      150.3 21.0         42.77     251.2
+    2024-07-27 00:00:00.000 22:21:45.60 -13:14:21.0 3.256 2.327   8.5      151.6 21.0         43.34     251.3
+
+Alternatively, the script may be run via ``python3 -m sbpy.data.ephem``.