docs: def _crossmatch_transients_against_catalogues(
              self,
              transientsMetadataListIndex,
              colMaps):
          """run the transients through the crossmatch algorithm in the settings file
  
           **Key Arguments:**
              - ``transientsMetadataListIndex`` -- the list of transient metadata lifted from the database.
              - ``colMaps`` -- dictionary of dictionaries with the name of the database-view (e.g. `tcs_view_agn_milliquas_v4_5`) as the key and the column-name dictary map as value (`{view_name: {columnMap}}`).
  
  
          **Return:**
              - ``crossmatches`` -- a list of dictionaries of the associated sources crossmatched from the catalogues database
  
          .. todo ::
  
              - update key arguments values and definitions with defaults
              - update return values and definitions
              - update usage examples and text
              - update docstring text
              - check sublime snippet exists
              - clip any useful text to docs mindmap
              - regenerate the docs and check redendering of this docstring
          """
  
          global theseBatches
  
          self.log.debug(
              'starting the ``_crossmatch_transients_against_catalogues`` method')
  
          # SETUP ALL DATABASE CONNECTIONS
  
          transientsMetadataList = theseBatches[transientsMetadataListIndex]
  
          dbConn = database(
              log=self.log,
              dbSettings=self.settings["database settings"]["static catalogues"]
          ).connect()
  
          self.allClassifications = []
  
          cm = transient_catalogue_crossmatch(
              log=self.log,
              dbConn=dbConn,
              transients=transientsMetadataList,
              settings=self.settings,
              colMaps=colMaps
          )
          crossmatches = cm.match()
  
          self.log.debug(
              'completed the ``_crossmatch_transients_against_catalogues`` method')
  
          return crossmatches