docs: def ingest(self):
          """*Perform conesearches of the online NED database and import the results into a the sherlock-database*
  
          The code:
  
              1. uses the list of transient coordinates and queries NED for the results within the given search radius
              2. Creates the `tcs_cat_ned_stream` table if it doesn't exist
              3. Adds the resulting NED IDs/Names to the `tcs_cat_ned_stream` table
              4. Updates the NED query history table
              5. Queris NED via NED IDs for the remaining source metadata to be added to the `tcs_cat_ned_stream` table
  
          **Usage:**
  
              Having setup the NED object with a coordinate list and cone-search radius, run the `ingest()` method
  
              .. code-block:: python
  
                  stream.ingest()
  
          .. todo ::
  
              - check sublime snippet exists
              - clip any useful text to docs mindmap
              - regenerate the docs and check redendering of this docstring
          """
          self.log.debug('starting the ``ingest`` method')
  
          if not self.radiusArcsec:
              self.log.error(
                  'please give a radius in arcsec with which to preform the initial NED conesearch' % locals())
              sys.exit(0)
  
          # VARIABLES
          # SIZE OF NUMBER OF ROWS TO INSERT INTO DATABASE TABLE AT ANY ONE GO
          self.databaseInsertbatchSize = 10000
  
          # THE DATABASE TABLE TO STREAM THE NED DATA INTO
          self.dbTableName = "tcs_cat_ned_stream"
  
          dictList = self._create_dictionary_of_ned()
  
          tableName = self.dbTableName
  
          createStatement = """CREATE TABLE IF NOT EXISTS `%(tableName)s` (
    `primaryId` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'An internal counter',
    `ned_name` varchar(150) NOT NULL,
    `redshift` double DEFAULT NULL,
    `dateCreated` datetime DEFAULT CURRENT_TIMESTAMP,
    `dateLastModified` datetime DEFAULT CURRENT_TIMESTAMP,
    `updated` varchar(45) DEFAULT '0',
    `major_diameter_arcmin` double DEFAULT NULL,
    `ned_notes` varchar(700) DEFAULT NULL,
    `object_type` varchar(100) DEFAULT NULL,
    `redshift_err` double DEFAULT NULL,
    `redshift_quality` varchar(100) DEFAULT NULL,
    `magnitude_filter` varchar(10) DEFAULT NULL,
    `minor_diameter_arcmin` double DEFAULT NULL,
    `morphology` varchar(50) DEFAULT NULL,
    `hierarchy` varchar(50) DEFAULT NULL,
    `galaxy_morphology` varchar(50) DEFAULT NULL,
    `radio_morphology` varchar(50) DEFAULT NULL,
    `activity_type` varchar(50) DEFAULT NULL,
    `raDeg` double DEFAULT NULL,
    `decDeg` double DEFAULT NULL,
    `eb_v` double DEFAULT NULL,
    `htm16ID` bigint(20) DEFAULT NULL,
    `download_error` tinyint(1) DEFAULT '0',
    `htm10ID` bigint(20) DEFAULT NULL,
    `htm13ID` bigint(20) DEFAULT NULL,
    PRIMARY KEY (`primaryId`),
    UNIQUE KEY `ned_name` (`ned_name`),
    KEY `idx_htm16ID` (`htm16ID`),
    KEY `raDeg` (`raDeg`),
    KEY `downloadError` (`download_error`),
    KEY `idx_htm10ID` (`htm10ID`),
    KEY `idx_htm13ID` (`htm13ID`)
  ) ENGINE=MyISAM AUTO_INCREMENT=0 DEFAULT CHARSET=latin1;
  """ % locals()
  
          self.add_data_to_database_table(
              dictList=dictList,
              createStatement=createStatement
          )
  
          self._update_ned_query_history()
          self._download_ned_source_metadata()
  
          self.log.debug('completed the ``ingest`` method')
          return None