Catalog Search

Query astronomical catalogs and overlay sources on images.

Warning

This plugin will be deprecated in a future version of Jdaviz. Please transition to using the loaders (e.g., the astroquery loader) with the catalog format to search and load catalogs, and the table viewer to view and interact with the results.

Description

The Catalog Search plugin queries online astronomical catalogs (e.g., Gaia, 2MASS, SDSS) and displays sources as markers on image viewers. This helps identify known objects and cross-match with observations.

Key Features:

• Query multiple catalog services

• Cone search around image center

• Configurable search radius

• Marker overlay on images

• Export catalog results

• Source table display

Details

The plugin uses Virtual Observatory (VO) services to query catalogs. Search radius can be adjusted, and results are displayed both as markers on the image and in a sortable table.

UI Access

Click the Catalog Search icon in the plugin toolbar to:

1. Select catalog (Gaia, 2MASS, SDSS, etc.)

2. Set search radius

3. Click Search to query catalog

4. View results as markers and table

API Access

plg = imviz.plugins['Catalog Search']
plg.catalog = 'Gaia DR3'
plg.radius = 30  # arcseconds
plg.search()

# Export results
table = plg.export_table()

API References

Only the following attributes and methods are available through the public plugin API:

• show()

• open_in_tray()

• close_in_tray()

• clear_table()

• export_table()

• import_catalog()

• zoom_to_selected()

• select_rows()

• select_all()

• select_none()

• search()

• max_sources Maximum number of catalog sources to retrieve.

• catalog (SelectPluginComponent)

• table (Table): Table containing all search results.

• table_selected (Table): Table containing all selected search results.

For detailed API documentation, see Catalogs.

See Also

• Catalog Search - Detailed Imviz catalog documentation