Vizier Catalogs — astropop 0.9.4 documentation (2024)

The VizieR is an astronomical catalog service that provides standard astronomical catalogs and tables in a uniform format. The VizieR is a service of the Centre de Données astronomiques de Strasbourg (CDS) and is operated by the Strasbourg Astronomical Data Center (CDS) and is available at http://vizier.u-strasbg.fr.

Several VizieR catalogs are useful for astrometric and photometric calibration. However, they do not allways have the same column names. So, the vizier module provides a set of classes to access the VizieR catalogs and to return the data in a SourcesCatalog instance.

To access an specific pre-defined catalog, just use vizier.<<catalog_name>> with the query parameters. Like, if you want to query the UCAC4 catalog for the sources in a 2 arcmin radius around the coordinates of the Crab Nebula, you can do:

In [1]: from astropop.catalogs import vizierIn [2]: catalog = vizier.ucac4('M1', radius='2 arcmin', band=['B', 'V'])In [3]: catalog.table()Out[3]: <Table length=23> id ra ... V V_error deg ...  str16 float64 ... float64 float64---------------- ----------------- ... ------------------ -------UCAC4 561-018139 83.6304203 ... 14.621999740600586 0.02UCAC4 561-018138 83.6294474 ... nan nanUCAC4 561-018141 83.6330986 ... nan nanUCAC4 561-018143 83.6341021 ... 14.611000061035156 0.01UCAC4 561-018146 83.639245 ... nan nanUCAC4 561-018130 83.61766390000001 ... nan nanUCAC4 561-018128 83.6129668 ... nan nanUCAC4 561-018132 83.6183909 ... nan nanUCAC4 561-018134 83.6210812 ... nan nan ... ... ... ... ...UCAC4 560-017460 83.6442242 ... nan nanUCAC4 561-018162 83.6592556 ... nan nanUCAC4 560-017439 83.6130895 ... 16.08099937438965 0.01UCAC4 561-018147 83.6393589 ... nan nanUCAC4 561-018160 83.6564736 ... 14.77299976348877 0.03UCAC4 561-018125 83.6090483 ... 14.477999687194824 0.01UCAC4 561-018120 83.5978698 ... nan nanUCAC4 560-017448 83.6253689 ... 13.885000228881836 0.04UCAC4 561-018168 83.6635495 ... nan nanIn [4]: catalog.magnitude('B')Out[4]: <QFloat at 0x7f0ae51fab10>[15.30+-0.01, nan+-nan, nan+-nan, 15.35+-0.06, nan+-nan, nan+-nan, nan+-nan, nan+-nan, nan+-nan, nan+-nan, nan+-nan, nan+-nan, nan+-nan, 14.84+-0.06, nan+-nan, nan+-nan, 17.3+-0.4, nan+-nan, 15.70+-0.05, 15.15+-0.08, nan+-nan, 14.79+-0.05, nan+-nan] unit=magIn [5]: catalog.sources_id()Out[5]: array(['UCAC4 561-018139', 'UCAC4 561-018138', 'UCAC4 561-018141', 'UCAC4 561-018143', 'UCAC4 561-018146', 'UCAC4 561-018130', 'UCAC4 561-018128', 'UCAC4 561-018132', 'UCAC4 561-018134', 'UCAC4 561-018135', 'UCAC4 561-018155', 'UCAC4 560-017457', 'UCAC4 560-017458', 'UCAC4 561-018151', 'UCAC4 560-017460', 'UCAC4 561-018162', 'UCAC4 560-017439', 'UCAC4 561-018147', 'UCAC4 561-018160', 'UCAC4 561-018125', 'UCAC4 561-018120', 'UCAC4 560-017448', 'UCAC4 561-018168'], dtype='<U16')In [6]: catalog.skycoord()Out[6]: <SkyCoord (ICRS): (ra, dec) in deg [(83.6304203, 22.0167398), (83.6294474, 22.0172473), (83.6330986, 22.0144998), (83.6341021, 22.0155481), (83.639245 , 22.0162939), (83.6176639, 22.0085378), (83.6129668, 22.0132417), (83.6183909, 22.0274339), (83.6210812, 22.0304517), (83.6242106, 22.0322028), (83.6484359, 22.0103392), (83.6374206, 21.9976928), (83.6429703, 21.999397 ), (83.6430586, 22.0337381), (83.6442242, 21.9911687), (83.6592556, 22.0135156), (83.6130895, 21.9901239), (83.6393589, 22.0416298), (83.6564736, 22.0002848), (83.6090483, 22.0392714), (83.5978698, 22.0265187), (83.6253689, 21.98273 ), (83.6635495, 22.0182834)] (pm_ra_cosdec, pm_dec) in mas / yr [( 0. , 0. ), ( 0. , 0. ), ( nan, nan), ( nan, nan), ( nan, nan), ( nan, nan), ( nan, nan), ( nan, nan), ( nan, nan), ( nan, nan), ( nan, nan), ( nan, nan), ( nan, nan), ( nan, nan), (-12.7, 56.3), ( 0.9, 3.7), (-11.9, -15.9), ( 5.3, 27. ), ( nan, nan), ( nan, nan), ( nan, nan), ( -1.1, -1.7), ( -3.5, -1.7)]>

All catalogs have the same input parameters, that are a field center, a search radius and the list of photometric band to query. They are derived from the VizierSourcesCatalog class, configured with a pre-defined configuration file to operate with the specific catalog. The list of all available pre-defined catalogs can be obtained with astropop.catalogs.vizier.list_vizier_catalogs method. Each catalog has a help method that returns a description of the catalog and the list of available photometric bands.

Currently available catalogs are:

• vizier.allwise

  In [7]: print(vizier.allwise.help())allwise: The AllWISE data Release (updated version, 16-Feb-2021)bibcode: 2014yCat.2328....0CAvailable filters are: - W1: WISE/W1 magnitude (3.35um) Red values correspond to upper limits (S/N<2) - W2: WISE/W2 magnitude (4.6um) Red values correspond to upper limits (S/N<2) - W3: WISE/W3 magnitude (11.6um) Red values correspond to upper limits (S/N<2) - W4: WISE/W4 magnitude (22.1um) Red values correspond to upper limits (S/N<2) - J: 2MASS J magnitude (1.25um) Red values correspond to upper limits (S/N<2) - H: 2MASS H magnitude (1.65um) Red values correspond to upper limits (S/N<2) - K: 2MASS Ks magnitude (2.17um) Red values correspond to upper limits (S/N<2)

• vizier.apass9

  In [8]: print(vizier.apass9.help())apass9: AAVSO Photometric All Sky Survey (APASS) DR9 (Henden+, 2016)bibcode: 2015AAS...22533616HAvailable filters are: - B: Johnson B-band magnitude - V: Johnson V-band magnitude - g_: g'-band AB magnitude, Sloan filter - r_: r'-band AB magnitude, Sloan filter - i_: i'-band AB magnitude, Sloan filter

  See Also

  VizieR Online Data Catalog: Distances to molecular clouds in SFR (Zucker+, 2020)Hitman 3 heeft zijn vizier op scherp staan

• vizier.denis

  In [9]: print(vizier.denis.help())denis: The DENIS database (DENIS Consortium, 2005)bibcode: 2005yCat.2263....0DThis catalog has no photometric informations.

• vizier.gsc242

  In [10]: print(vizier.gsc242.help())gsc242: The Guide Star Catalog, Version 2.4.2 (GSC2.4.2) (STScI, 2020)bibcode: 2008AJ....136..735LAvailable filters are: - G: Gaia G band magnitude - RP: Gaia Rp band magnitude - BP: Gaia Bp band magnitude - Bj: Photographic Blue magnitude - Fpg: Photographic Red magnitude - Epg: Photographic E band magnitude - Npg: Photographic Near-IR magnitude - U: U band magnitude - B: B band magnitude - V: V band magnitude - u: SDSS u band magnitude - g: SDSS g band magnitude - r: SDSS r band magnitude - i: SDSS i band magnitude - z: SDSS z band magnitude - y: PanSTARRS y band magnitude - J: 2MASS J band magnitude - H: 2MASS H band magnitude - Ks: 2MASS Ks band magnitude - Z: VISTA Z band magnitude - Y: VISTA Y band magnitude - W1: WISE W1 (3.4um) band magnitude - W2: WISE W2 (4.6um) band magnitude - W3: WISE W3 (12um) band magnitude - W4: WISE W4 (22um) band magnitude - FUV: GALEX FUV band magnitude - NUV: GALEX NUV band magnitude

• vizier.hip

  In [11]: print(vizier.hip.help())hip: The Hipparcos Main Catalogue (ESA 1997)bibcode: 1997HIP...C......0EThis catalog has no photometric informations.

• vizier.twomass

  In [12]: print(vizier.twomass.help())twomass: 2MASS All-Sky Catalog of Point Sources (Cutri+ 2003)bibcode: 2003yCat.2246....0CAvailable filters are: - J: 2MASS J magnitude (1.2um) - H: 2MASS H magnitude (1.6um) - K: 2MASS Ks magnitude (2.2um)

• vizier.tycho2

  In [13]: print(vizier.tycho2.help())tycho2: The Tycho-2 Catalogue (Hog+ 2000)bibcode: 2000A&A...355L..27HAvailable filters are: - BT: Tycho-2 BT magnitude - VT: Tycho-2 VT magnitude

• vizier.ucac4

  In [14]: print(vizier.ucac4.help())ucac4: UCAC4 Catalogue (Zacharias+, 2012)bibcode: 2012yCat.1322....0ZAvailable filters are: - J: 2MASS J magnitude (1.2um) - H: 2MASS H magnitude (1.6um) - K: 2MASS Ks magnitude (2.2um) - B: B magnitude from APASS - V: V magnitude from APASS - g: g magnitude from APASS - r: r magnitude from APASS - i: i magnitude from APASS

• vizier.ucac5

  In [15]: print(vizier.ucac5.help())ucac5: UCAC5 Catalogue (Zacharias+ 2017)bibcode: 2017yCat.1340....0ZAvailable filters are: - G: Gaia G magnitude - R: Photographic R magnitude from NOMAD - J: 2MASS J magnitude - H: 2MASS H magnitude - K: 2MASS K magnitude - f.: Means UCAC model magnitude

• vizier.vsx

  In [16]: print(vizier.vsx.help())vsx: AAVSO International Variable Star Index VSX (Watson+, 2006-)bibcode: 2015yCat....102027WThis catalog has no photometric informations.

• vizier.wise

  In [17]: print(vizier.wise.help())wise: WISE All-Sky Data Release (Cutri+ 2012)bibcode: 2012yCat.2311....0CAvailable filters are: - W1: WISE/W1 magnitude (3.35um) Red values correspond to upper limits (S/N<2) - W2: WISE/W2 magnitude (4.6um) Red values correspond to upper limits (S/N<2) - W3: WISE/W3 magnitude (11.6um) Red values correspond to upper limits (S/N<2) - W4: WISE/W4 magnitude (22.1um) Red values correspond to upper limits (S/N<2) - J: 2MASS J magnitude (1.25um) Red values correspond to upper limits (S/N<2) - H: 2MASS H magnitude (1.65um) Red values correspond to upper limits (S/N<2) - K: 2MASS Ks magnitude (2.17um) Red values correspond to upper limits (S/N<2)

---# caralog table in viziertable: 'I/322A/out'# small description for the catalogdescription: "UCAC4 Catalogue (Zacharias+, 2012)"# bibcode string referencebibcode: "2012yCat.1322....0Z"# list of columns to be downloaded in the query. Use '**' for all columns# Photometric columns will be added later based on selected# photometric bands.columns: ['+_r', 'UCAC4', 'RAJ2000', 'DEJ2000', 'pmRA', 'pmDE', 'EpRA']# dictionary of available photometric bands and their descriptionsavailable_filters: { 'J': '2MASS J magnitude (1.2um)', 'H': '2MASS H magnitude (1.6um)', 'K': '2MASS Ks magnitude (2.2um)', 'B': 'B magnitude from APASS', 'V': 'V magnitude from APASS', 'g': 'g magnitude from APASS', 'r': 'r magnitude from APASS', 'i': 'i magnitude from APASS'}# coordinates configurationcoordinates: ra_column: 'RAJ2000' # RA column name dec_column: 'DEJ2000' # DEC column name pm_ra_column: 'pmRA' # proper motion RA column name (optional) pm_dec_column: 'pmDE' # proper motion DEC column name (optional) frame: 'icrs' # coordinate frame, default is 'icrs'# photometric configuration. Use {band} where the band name should bemagnitudes: mag_column: '{band}mag' # magnitude column name err_mag_column: 'e_{band}mag' # magnitude error column name# epoch configuration. You can choose either column or value# but not bothepoch: column: 'EpRA' # epoch of coordinates column name # value = 'J2000.0' # fixed epoch of coordinates value format: 'jyear' # epoch format, default is 'jyear'# identifier configurationids: prepend: 'UCAC4' # prepend string to the identifier column: 'UCAC4' # identifier column name. # multiple columns can be used, as a list. In this case, set also a separator # column: ['UCAC4', 'UCAC4_2'] # separator: '-' # separator between columns