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 - RegistryResultsinstance 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.ImageFoundinstances. 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.