transient_catalogue_crossmatch (class) ∞

class transient_catalogue_crossmatch(log, settings=False, colMaps=False, transients=[], dbSettings=False, dbConn=False)[source] ∞

Bases: object

crossmatch a list of transients against a suite of catalogues according to given search algorithm

Key Arguments

  • dbConn – mysql database connection for the catalogues

  • log – logger

  • settings – the settings dictionary

  • colMaps – maps of the important column names for each table/view in the crossmatch-catalogues database

  • transients – the list of transients

Usage

To setup your logger, settings and database connections, please use the fundamentals package (see tutorial here).

To initiate a transient_catalogue_crossmatch object, use the following:

from sherlock import transient_catalogue_crossmatch
xmatcher = transient_catalogue_crossmatch(
    log=log,
    settings=settings,
    colMaps=colMaps,
    transients=transients,
    dbSettings=settings["database settings"]["static catalogues"]
)

Then to run the transient through the search algorithm found in the settings file, use the match method:

classifications = xmatcher.match()

- 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

Methods

angular_crossmatch_against_catalogue(objectList)

perform an angular separation crossmatch against a given catalogue in the database and annotate the crossmatch with some value added parameters (distances, physical separations, sub-type of transient etc)

match()

match the transients against the sherlock-catalogues according to the search algorithm and return matches alongside the predicted classification(s)

physical_separation_crossmatch_against_catalogue(…)

perform an physical separation crossmatch against a given catalogue in the database
angular_crossmatch_against_catalogue(objectList, searchPara={}, search_name='', brightnessFilter=False, physicalSearch=False, classificationType=False)[source] ∞

perform an angular separation crossmatch against a given catalogue in the database and annotate the crossmatch with some value added parameters (distances, physical separations, sub-type of transient etc)

Key Arguments

  • objectList – the list of transient locations to match against the crossmatch catalogue

  • searchPara – the search parameters for this individual search as lifted from the search algorithm in the sherlock settings file

  • search_name – the name of the search as given in the sherlock settings file

  • brightnessFilter – is this search to be constrained by magnitude of the catalogue sources? Default False. [bright|faint|general]

  • physicalSearch – is this angular search a sub-part of a physical separation search

  • classificationType – synonym, association or annotation. Default False

Return

- matchedObjects -- any sources matched against the object

Usage

Take a list of transients from somewhere

transients = [
    {'ps1_designation': u'PS1-14aef',
     'name': u'4L3Piiq',
     'detection_list_id': 2,
     'local_comments': u'',
     'ra': 0.02548233704918263,
     'followup_id': 2065412L,
     'dec': -4.284933417540423,
     'id': 1000006110041705700L,
     'object_classification': 0L
     },

    {'ps1_designation': u'PS1-13dcr',
     'name': u'3I3Phzx',
     'detection_list_id': 2,
     'local_comments': u'',
     'ra': 4.754236999477372,
     'followup_id': 1140386L,
     'dec': 28.276703631398625,
     'id': 1001901011281636100L,
     'object_classification': 0L
     },

    {'ps1_designation': u'PS1-13dhc',
     'name': u'3I3Pixd',
     'detection_list_id': 2,
     'local_comments': u'',
     'ra': 1.3324973428505413,
     'followup_id': 1202386L,
     'dec': 32.98869220595689,
     'id': 1000519791325919200L,
     'object_classification': 0L
     }
]

Then run the angular_crossmatch_against_catalogue method to crossmatch against the catalogues and return results:

# ANGULAR CONESEARCH ON CATALOGUE
search_name = "ned_d spec sn"
searchPara = self.settings["search algorithm"][search_name]
matchedObjects = xmatcher.angular_crossmatch_against_catalogue(
    objectList=transients,
    searchPara=searchPara,
    search_name=search_name
)

- 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
match()[source] ∞

match the transients against the sherlock-catalogues according to the search algorithm and return matches alongside the predicted classification(s)

Return

  • classification – the crossmatch results and classifications assigned to the transients

See the class docstring for usage.

- 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
physical_separation_crossmatch_against_catalogue(objectList, searchPara, search_name, brightnessFilter=False, classificationType=False)[source] ∞

perform an physical separation crossmatch against a given catalogue in the database

This search is basically the same as the angular separation search except extra filtering is done to exclude sources outside the physical search radius (matched sources require distance info to calulate physical separations)

Key Arguments

  • objectList – transients to be crossmatched

  • searchPara – parameters of the search (from settings file)

  • search_name – the name of the search

  • brightnessFilter – is this search to be constrained by magnitude of the catalogue sources? Default False. [bright|faint|general]

  • classificationType – synonym, association or annotation. Default False

Return

  • matchedObjects – any sources matched against the object

To run a physical separation crossmatch, run in a similar way to the angular separation crossmatch:

Usage

search_name = "ned spec sn"
searchPara = self.settings["search algorithm"][search_name]
matchedObjects = xmatcher.physical_separation_crossmatch_against_catalogue(
    objectList=transients,
    searchPara=searchPara,
    search_name=search_name
)

- 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