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.