Adding Catalogue Aliases

Along with the config, ATK supports Vizier catalogue aliases. These save you from having to remember the Vizier catalogue IDs in data queries, bulkdata queries and datatable entries.

As with the config, the easiest way to manages aliases is via the commandline. Upon first using ATK, a default aliases file will be generated which contains only the default data surveys that are supported by the package out of the box. We can have a look at these using the ATKalias command-line tool:

ATKaliases show

Current ATKAliases.ini values:

[default_catalogues]
gaia = I/355/gaiadr3
panstarrs = II/349/ps1
skymapper = II/379/smssdr4
galex = II/335/galex_ais
rosat = IX/11/rosatsrc
sdss = V/154/sdss16
wise = II/311/wise
twomass = II/246/out
erosita = J/A+A/682/A34/erass1-m
gaia_lc = I/355/epphot

[additional_catalogues]

Currently, the only aliases are those that are supported by default. We can add one using the ATKaddalias command. In this case, we will add an alias to the AllWISE catalogue:

ATKalias add allwise II/328/allwise

Added alias for II/328/allwise with label allwise.

If we now show our alias file again, we will see that our new alias has been added.

ATKalias add

Current ATKAliases.ini values:

[default_catalogues]
gaia = I/355/gaiadr3
panstarrs = II/349/ps1
skymapper = II/379/smssdr4
galex = II/335/galex_ais
rosat = IX/11/rosatsrc
sdss = V/154/sdss16
wise = II/311/wise
twomass = II/246/out
erosita = J/A+A/682/A34/erass1-m
gaia_lc = I/355/epphot

[additional_catalogues]
allwise = II/328/allwise

And we can now use this alias in a data query!

from AstroToolkit.Tools import query

query(kind="data",survey="allwise",source=6050296829033196032).showdata()

Running allwise data query
source = 6050296829033196032
pos = None
radius = 5.0

Note: allwise has no epoch definition. Proper motion has therefore not been corrected.

.kind:       data
.subkind:    data
.survey:     allwise
.catalogue:  ii/328/allwise
.source:     6050296829033196032
.pos:        [245.44706007515, -22.88644708704]
.identifier: J162147.29-225311.21
.dataname:   J162147.29-225311.21_6050296829033196032_allwise_ATKdata.fits
.trace:      None

.data:
    _r:        [0.485]
    _x:        [-0.01]
    _y:        [0.485]
    _p:        [358.8]
    AllWISE:   ['J162147.29-225310.7']
    RAJ2000:   [245.4470654]
    DEJ2000:   [-22.8863085]
    eeMaj:     [0.0367]
    eeMin:     [0.0343]
    eePA:      [97.]
    Im:        ['Im']
    W1mag:     [10.87300014]
    e_W1mag:   [0.023]
    W2mag:     [10.06299973]
    e_W2mag:   [0.022]
    W3mag:     [7.48899984]
    e_W3mag:   [0.023]
    W4mag:     [5.11399984]
    e_W4mag:   [0.038]
    ...

    Available Methods: .savedata(), .showdata()

Aliases will also be used when searching through all catalogues via bulkdata queries:

query(kind="bulkdata",source=6050296829033196032).showdata()

Running bulkdata query
source = 6050296829033196032
pos = None
radius = 3.0

.kind:       data
.subkind:    bulkdata
.survey:     all
.catalogue:  None
.source:     6050296829033196032
.pos:        [245.44701332846378, -22.886218247040002]
.identifier: J162147.28-225310.39
.dataname:   J162147.28-225310.39_6050296829033196032_all_ATKbulkdata.fits
.trace:      start -> extracted pos from source query, assumed [2016, 0]
                   -> panstarrs: [2012, 0] -> panstarrs query performed
                   -> skymapper: [2016, 0] -> skymapper query performed
                   -> galex: [2006, 8] -> galex query performed
                   -> rosat: [1991, 0] -> rosat query performed
                   -> sdss: [2017, 0] -> sdss query performed
                   -> wise: [2010, 5] -> wise query performed
                   -> twomass: [1999, 0] -> twomass query performed
                   -> erosita: [2022, 0] -> erosita query performed
                   -> allwise lacking epoch definition, proper motion correction failed
             -> [2000,0] -> end

.data:
    gaia:
        designation: ['Gaia DR3 6050296829033196032']
        ra:          [245.44706008]
        dec:         [-22.88644709]
        ...

    panstarrs:
        RAJ2000: [245.44705339]
        DEJ2000: [-22.88642441]
        objID:   [80532454470486736]
        ...

    skymapper:
        SMSS:   ['162147.30-225311.1']
        RAICRS: [245.447072]
        DEICRS: [-22.886438]
        ...

    wise:
        WISE:    ['J162147.30-225310.6']
        RAJ2000: [245.447087]
        DEJ2000: [-22.886283]
        ...


    twomass:
        RAJ2000: [245.447007]
        DEJ2000: [-22.886181]
        errMaj:  [0.06]
        ...

    erosita:
        .recno:  [4107]
        IAUName: ['1eRASS J162147.2-225311']
        DetUId:  ['em01_245114_020_ML00008_002_c010']
        ...

    allwise:
        AllWISE: ['J162147.29-225310.7']
        RAJ2000: [245.4470654]
        DEJ2000: [-22.8863085]
        ...

Any number of aliases can be added, and any that you no longer need can be deleted using the del mode of the ATKalias command:

ATKalias del allwise

Alternatively, the alias file can be reset entirely:

ATKalias reset

Just like the config, aliases can be viewed and edited at the same time by opening the alias file in the default text editor:

ATKalias open