display_images_ab

lsst.analysis.ap.display_images_ab(butler_a, butler_b, visit, detector, *, image_type='difference', labels=('A', 'B'), backend='firefly', reliability_threshold=0.1, show_unfiltered=True, show_trailed=True, show_rejected=True, show_standardized=True, show_marginal=True, show_kernel_sources=True, show_solar_system=True, show_apdb=True, show_reliability_labels=True, show_dipoles=True, show_trail_geometry=True, line_length_scale=1.0, label_size=3, color_by=None, unfiltered_style='footprint', mask_transparency=80, strip_metadata=True, skymap=None, skymap_ctype='green', skymap_label_size=1.5, image_datasets={'difference': 'difference_image', 'science': 'preliminary_visit_image', 'template': 'template_detector'}, use_fakes=False, dry_run=False)

Display one image type side-by-side from two butlers, with overlays.

Loads the same (visit, detector) from butler_a and butler_b, places them in two frames, and draws each butler’s catalog overlays on its own frame. Intended for A/B-testing pipeline-config changes that affect detection or subtraction quality.

Parameters

butler_a, butler_blsst.daf.butler.Butler

Two butlers, typically from different pipeline runs of the same data.

visit, detectorint

Visit and detector ids to load data for.

image_type{“science”, “template”, “difference”}, optional

Which image dataset to compare. Default "difference".

labelspair of str, optional

Short tags for the two frames; appear in the image title and the legend header. Default ("A", "B").

backendstr, optional

afw display backend (typically “firefly” or “ds9”).

reliability_threshold, show_unfiltered, show_trailed, show_rejected, show_standardized, show_marginal, show_kernel_sources, show_solar_system, show_apdb, show_reliability_labels, show_dipoles, show_trail_geometry, line_length_scale, label_size, color_by, unfiltered_style, mask_transparency, strip_metadata, skymap, skymap_ctype, skymap_label_size, image_datasets, use_fakes, dry_run

Same meaning as in display_images. Applied to both frames; the tract/patch overlay uses each frame’s own exposure WCS. Each frame’s unfiltered footprints get their own per-frame Firefly layers (keyed by labels), so the two frames don’t share layers.