Catalog Search

Query astronomical catalogs and overlay sources on images.

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

v0.1

Click toolbar icons to toggle different sidebars

Data Menu

×

Control data and subset layer order and visibility for each viewer. Toggle layer visibility, reorder layers by dragging, and manage which data appears in the viewer.

dm = jd.viewers[viewer].data_menu

Learn about API access

Learn more about Data Menu →

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