omnilab / vizier

1.x-dev 2026-10-17 10:28 UTC

Requires

• php: >=8.2
• omniscient/omnilab: ^1.0@dev
• symfony/http-client: ^6.4|^7.0|^8.0

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

• Marco Meyer

• science
• tap
• astronomy
• cds
• omnilab
• adql
• vizier
• catalogues

Published on Packagist.org on 2026-10-17 12:17 UTC

README

VizieR, the CDS's library of published astronomical catalogues (Strasbourg), for omniscient/omnilab: its tables by text, as datasets - each a Product whose id is the table's name (I/239/hip_main), with its catalogue, title, authors and number of rows -, and, outside the contract, the rows of a table around a point of the sky or an object, each column with its unit and description. Through TAPVizieR, in ADQL. No key.

$vizier = (new VizierSourceFactory($http))->create(['mailto' => '[e-mail]']);
$tables = $vizier->datasets(new Query('hipparcos', limit: 5));   // I/337/tgas, ..., I/239/hip_main (118,218 rows)
$rows = $vizier->rows('I/239/hip_main', 101.28715533, -16.71611586, 5 / 60);
$rows[0]->value('HIP');                        // 32349 (Sirius)
$rows[0]->value('Vmag');                       // -1.44 mag
$rows[0]->separation;                          // 11.72 (arcsec)
$vizier->rowsOf('I/355/gaiadr3', $simbad->entity("Barnard's star"), 200 / 3600, 1000);

omnilab:
    sources:
        vizier:
            factory: vizier
            options:
                mailto: '[e-mail]'   # in the User-Agent

See docs/ for what is read, how it maps, and what VizieR does not give here.

Terms of use

VizieR is a service of the CDS (Centre de Données astronomiques de Strasbourg, Université de Strasbourg / CNRS). The CDS asks that work using it acknowledge it: "This research has made use of the VizieR catalogue access tool, CDS, Strasbourg, France (DOI: 10.26093/cds/vizier). The original description of the VizieR service was published in Ochsenbein et al. 2000, A&AS 143, 23." Each catalogue is its authors' work, to be cited from its own reference (its VizieR page gives it). No rate is published for TAP; each call here took 1 to 6 s.

Responsibility

This package is an independent, unofficial client: it is not affiliated with, endorsed by or sponsored by the CDS, the Université de Strasbourg or the CNRS. It reaches their service on behalf of whoever runs it, and it does not redistribute their data beyond the short excerpts recorded as test fixtures. Its MIT licence covers this package's code only and grants no right to the service or to its data.

Whoever installs and runs this package is responsible for complying with the terms above, for obtaining whatever they require (an account, a key, a licence or subscription, an attribution or a citation, a rate limit to respect), and for any use made of what it returns. The authors publish it free of charge, make no commercial use of it, and accept no liability for how it is used (see LICENSE).

License: MIT.