Base Harvester Class

class tom_catalogs.harvester.AbstractHarvester

The AbstractHarvester provides an interface for implementing a harvester module to query catalogs.


Submits the specific query to the specified catalog.


term (str) – Value to search for within the catalog.


Instantiates a Target object with the data from the catalog search result.


Target representation of the catalog search result

Return type:



Gets the harvester classes available to this TOM as specified by TOM_HARVESTER_CLASSES in settings.py. If none are specified, returns the default set.


dict of harvester classes, with keys being the name of the catalog and values being the harvester class

Return type:



class tom_catalogs.harvesters.jplhorizons.JPLHorizonsHarvester

The JPLHorizonsHarvester is the interface to the JPL Horizons catalog. For information regarding the JPL Horizons catalog, please see https://ssd.jpl.nasa.gov/?horizons or https://astroquery.readthedocs.io/en/latest/jplhorizons/jplhorizons.html.

Minor Planet Center

Please note that there is an astroquery bug in 0.4.1 that breaks the MPCHarvester. In order to resolve this, either remove the MPC module from settings.TOM_HARVESTER_CLASSES, or install a pre-release version of astroquery using the following command:

pip install astroquery --upgrade --pre --use-deprecated=legacy-resolver
class tom_catalogs.harvesters.mpc.MPCHarvester

The MPCHarvester is the interface to the Minor Planet Center catalog. For information regarding the Minor Planet Center catalog, please see https://minorplanetcenter.net/ or https://astroquery.readthedocs.io/en/latest/mpc/mpc.html.


class tom_catalogs.harvesters.ned.NEDHarvester

The NEDHarvester is the interface to the NASA/IPAC Extragalactic Database. For information regarding the NED catalog, please see https://ned.ipac.caltech.edu/ or https://astroquery.readthedocs.io/en/latest/ned/ned.html.


class tom_catalogs.harvesters.simbad.SimbadHarvester(*args, **kwargs)

The SimbadHarvester is the interface to the SIMBAD catalog. At present, it is only queryable by identifier. For information regarding identifier format, please see http://simbad.u-strasbg.fr/simbad/sim-fid or https://astroquery.readthedocs.io/en/latest/simbad/simbad.html.

Transient Name Server

class tom_catalogs.harvesters.tns.TNSHarvester

The TNSBroker is the interface to the Transient Name Server. For information regarding the TNS, please see https://www.wis-tns.org/.