Function Repository Resource:

VizierCatalogData

Source Notebook

Import astronomical data from the VizieR database

Contributed by: Truman Tapia

ResourceFunction["VizierCatalogData"]["keywords"]

queries the VizieR database using keywords and returns all the tables found as one Dataset.

ResourceFunction["VizierCatalogData"]["keywords","prop"]

returns the property "prop" of the catalogues found by the query specified by "keywords".

ResourceFunction["VizierCatalogData"][list]

makes the query using a list of keywords.

ResourceFunction["VizierCatalogData"][list,"prop"]

returns the property "prop" of the catalogues found using a list of keywords.

Details and Options

ResourceFunction["VizierCatalogData"] retrieves data from VizieR using ASU.

ResourceFunction["VizierCatalogData"] has the following properties:

"Data"

actual data of the catalogs

"ColumnList"

List of all the columns

"ColumnDescription"

Dataset describing the columns

"Title"

titles of the catalogs

"CatalogSize"

number of rows of the catalogs

"Metadata"

Dataset showing the metadata

ResourceFunction["VizierCatalogData"] has the following options:

MaxItems

an Integer specifying the maximun number of rows in each table

"Columns"

"Default"

List containing the columns to retrieve, or All to get all columns of a catalog

"Filter"

None

a Select operator specifying a filter to apply in the query

"DataSource"

"France"

origin of the data

"AstroCenter"

Automatic

center of sky region

"AstroRange"

All

range of sky region

"AstroCenter" can be specified through Entity, keywords, or {ra,dec}.

"AstroRange" takes the following settings:

explicit radius of a circle

{r₁,r₂}

inner and outer radius of an annulus

{{ra₁,ra₂},{dec₁,dec₂}}

explicit limit for right ascension and declination

Angles in "AstroCenter" and "AstroRange" values can be numbers or Quantities. Numbers are interpreted as degrees.

ResourceFunction["VizierCatalogData"]["DataSource"] displays the supported values of the option "DataSource". Some data sources may fail to return the expected number of rows in certain cases.

"Filter" option supports only a small portion of the Select functionality (See the Options and Possible Issues sections).

The following modifiers can be used in ResourceFunction["VizierCatalogData"][…,prop,"modifier"]:

"Dataset"

a dataset with table names as keys and lists of associations as values

"Association"

an association with table names as keys and lists of associations as values

"RawData"

an association with table names as keys and lists as values

"Dataset" and "Association" modifers translate VizieR units to Wolfram units and use Quantity in the result.

Examples

Basic Examples (2)

Get the catalogues that match with the keyword Hipparcos:

In[1]:=

Out[1]=

Get just the first table of the last query with 200 rows:

In[2]:=

Out[2]=

Scope (3)

Get the metadata of the Fifth Fundamental Catalog using its table name "I/149A/catalog":

In[3]:=

Out[3]=

Get the whole catalog:

In[4]:=

Out[4]=

Or equivalently using just the one argument function:

In[5]:=

Out[5]=

Using "RawData" as the data modifier can reduce the memory consumption:

In[6]:=

Out[6]=

See memory consumption:

In[7]:=

Out[7]=

VizieR does not return all the columns in a catalog by default:

In[8]:=

Dimensions[
Values@ResourceFunction["VizierCatalogData"]["I/149A/catalog", "RawData", MaxItems -> 1, "Columns" -> "Default"]]

Out[8]=

To get all the columns in a catalog use "Columns"→All:

In[9]:=

Out[9]=

Calculate the time to get data from the VizieR mirror in China:

In[10]:=

Out[10]=

Using a different mirror can save time:

In[11]:=

Out[11]=

Options (11)

DataSource (1)

Get data from the VizieR mirror in China:

In[12]:=

Out[12]=

MaxItems (1)

Get the first 5 rows of a catalog:

In[13]:=

Out[13]=

Columns (2)

Get the list of columns of a catalog:

In[14]:=

Out[14]=

Get specific columns from the catalog:

In[15]:=

$ResourceFunction["VizierCatalogData"]["I/350/gaiaedr3", "Columns" -> {"RA_ICRS", "DE_ICRS"}]$

Out[15]=

Filter (4)

Data in tables can be filtered using the operator form of Select. For example, apply a filter in the "Plx" column of the table "I/350/gaiaedr3":

In[16]:=

Out[16]=

Test the filter:

In[17]:=

Out[17]=

Select the rows with non-missing value in the column "RVDR2":

In[18]:=

Out[18]=

Apply a filter in several columns at a time:

In[19]:=

Out[19]=

Test the filter:

In[20]:=

Out[20]=

In[21]:=

Out[21]=

Apply a filter on string values:

In[22]:=

Out[22]=

AstroCenter (1)

Get the objects of the table "I/350/gaiaedr3" within a circle centered at the position of and a radius :

In[23]:=

Out[23]=

AstroRange (2)

Get the objects of the table "I/350/gaiaedr3" within an annulus centered at the origin of the equatorial coordinates with inner radius of and outer radius of :

In[24]:=