omnilab/ned API reference

Omnilab\Ned

NedSource class

final class NedSource extends HttpSource NedSource.php:35

NED, the NASA/IPAC Extragalactic Database (Caltech/IPAC): an object beyond our galaxy - a galaxy, a quasar, a cluster, a radio source... - by any of its names, through NED's ObjectLookup service (its preferred name, type, J2000 position with its uncertainty, redshift with its uncertainty and quality), then its row of NED's object directory through its TAP service (galactic coordinates, and how many references, photometric points, redshifts, diameters, redshift-independent distances, images and spectra NED holds for it); cone() gives the objects around a point of the sky (outside the contract).

No key. Two calls an entity: one to resolve the name, one to read its row (a cone of one arcsecond at its position: the directory's name column is not indexed, a query by name runs past a minute).

const BASE_URI = 'https://ned.ipac.caltech.edu/'

const MAX_LIMIT = 1000

The most objects a cone gives (NED's ADQL has no OFFSET: one page).

const TYPES = ['G' => 'galaxy', 'GPair' => 'pair of galaxies', 'GTrpl' => 'triple galaxy', 'GGroup' => 'group of galaxies', 'GClstr' => 'cluster of galaxies', 'QSO' => 'qu…

NED's object types, the common ones: code => word.

NedSource::__construct()

public function __construct(HttpClientInterface $http, string $baseUri = self::BASE_URI, array $headers = [], float $throttle = 0.0)

NedSource::getName()

public function getName(): string

NedSource::capabilities()

public function capabilities(): array

NedSource::entity()

public function entity(Identifier|string $id): ?Entity

An object by any name NED resolves ("M31", "Messier 031", "3C 273", "NGC 4993"), an Identifier of the ned scheme, or of the simbad scheme (a name SIMBAD gives it, which NED resolves when it knows it); null when NED resolves none. Another base's identifier is refused before any call.

NedSource::cone()

public function cone(float $ra, float $dec, float $radius, int $limit = 50, ?string $type = null): Page

The objects of NED's directory within a radius of a point of the sky, the nearest first (outside the contract: the core's places are on the Earth), one page only - NED's ADQL has no OFFSET; Page::$next is always null, and Page::$total is known when fewer than the limit were found.

$ra

right ascension, degrees (J2000)

$dec

declination, degrees (J2000)

$radius

degrees

$type

only NED's type of that code ("G", "QSO", "GClstr")

NedSourceFactory class

final class NedSourceFactory extends SourceFactory NedSourceFactory.php:20

NED, the NASA/IPAC Extragalactic Database: galaxies, quasars, clusters and the other objects beyond our galaxy by any of their names, their type, position and redshift - no key needed.

options: mailto: 'support@glitchr.io' # in the User-Agent throttle: 0 # seconds between two calls: NED publishes no rate base_uri: 'https://ned.ipac.caltech.edu/'

Options