images_globally

pyvo.discover.images_globally(*, space: tuple[float, float, float] | None = None, spectrum: Quantity | None = None, time: Time | None = None, inclusive: bool = False, watcher: Callable[[ImageDiscoverer, str], None] | None = None, timeout: float = 20, services: RegistryResults | None = None) tuple[list[ObsCoreMetadata], list[str]][source]

returns a collection of ObsCoreMetadata-s matching certain constraints and a list of log lines.

Parameters:
space

An optional tuple of ra, dec, and the search radius, all in degrees; images returned must intersect a spherical circle described in this way.

spectrum

An astropy quantity convertible to a (vacuum) wavelength; images must cover this point in the (electromagnetic) spectrum.

time

An astropy time that must be in the observation time of the image (if it declares a time).

inclusive

Set to True to incluse services that do not declare their STC coverage. As of 2024, it may be advisable to do that as many relevant archives do not do that.

watcher

A callable that will be called with the ImageDiscoverer instance and a string perhaps suitable for displaying to a human.

services

An optional RegistryResults instance to override automatic services detection.

When an image has insufficient metadata to evaluate a constraint, it
is excluded; this mimics the behaviour of SQL engines that consider
comparisons with NULL-s false.
Returns:
discovered_images, log_lines

The images found are returned in a list of pyvo.discover.ImageFound instances. log_lines is a list of strings reporting which services were queried with which result (and possibly more). So far, this is not considered machine-readable.