Add Dastcom5 Service

docs/sbpy/data/dastcom5.rst

@@ -0,0 +1,21 @@
+==============
+Using DASTCOM5
+==============
+
+
+For using the DASTCOM5 Module, you have to first download the databse locally.
+That can be done by:
+
+    >>> from sbpy.data.utils import dastcom5
+    >>> dastcom5.download_dastcom5()  # doctest: +SKIP
+
+After the database is downloaded, all the queries can be done easily.
+
+DASTCOM5 is a subset of Small Body Database provided by JPL, NASA.
+For querying the database, either name or record number for the object
+can be used.
+
+    >>> dastcom5.orbit_from_name('atira')  # doctest: +SKIP
+    >>> dastcom5.orbit_from_record(900001)  # doctest: +SKIP
+
+More information about the DASTCOM5 Database can be taken from it's README file.

docs/sbpy/data/index.rst

@@ -26,6 +26,7 @@ Content
 .. toctree::
    :maxdepth: 2
 
+   dastcom5.rst
    dataclass.rst	     
    ephem.rst
    obs.rst

sbpy/data/orbit.py

@@ -19,7 +19,9 @@
 
 from ..bib import cite
 from ..exceptions import SbpyException
-from . import conf, DataClass, QueryError, TimeScaleWarning
+from . import conf, utils, DataClass, QueryError, TimeScaleWarning
+
+
 
 __all__ = ['Orbit', 'OrbitError', 'OpenOrbError']
 
@@ -180,9 +182,37 @@ def from_horizons(cls, targetids, id_type='smallbody',
 
         return cls.from_table(all_elem)
 
+    @classmethod
+    def from_dastcom5(cls, name):
+        """Load orbital elements from the DASTCOM5 Database
+        (ftp://ssd.jpl.nasa.gov/pub/ssd/dastcom5.zip).
+
+        Parameters
+        ----------
+        name: str, mandatory
+            Name of NEO
+
+        Returns
+        -------
+        `~Orbit` object
+
+        Examples
+        --------
+        >>> from sbpy.data import Orbit
+        >>> orb = Orbit.from_dastcom5('atira') # doctest: +REMOTE_DATA
+        >>> orb  # doctest: +SKIP
+
+        """
+        dastcom5_dir = os.path.join(utils.dastcom5.SBPY_LOCAL_PATH, "dastcom5")
+        if not os.path.isdir(dastcom5_dir):
+            utils.dastcom5.download_dastcom5()
+
+        tb = utils.dastcom5.orbit_from_name(name=name)
+        return cls.from_table(tb)
+
     @classmethod
     @cite({'data source':
-           'https://minorplanetcenter.net/iau/MPEph/MPEph.html'})
+               'https://minorplanetcenter.net/iau/MPEph/MPEph.html'})
     @cite({'software: astroquery': '2019AJ....157...98G'})
     def from_mpc(cls, targetids, id_type=None, target_type=None, **kwargs):
         """Load latest orbital elements from the

sbpy/data/utils/__init__.py

@@ -0,0 +1,6 @@
+# Licensed under a 3-clause BSD style license - see LICENSE.rst
+
+# This sub-module is destined for common non-package specific utility
+# functions.
+
+from sbpy.data.utils import dastcom5