Feature: Example Level-of-Detail

[fr1ll]

Excellent tool in a really important space for people to use to understand big datasets!

Feature idea: A new layer option that shows examples at sparse peaks of the density field.

This is a variant of Marker Clustering or Photo Marker Clustering.

Motivation: Like neural nets, we learn well by example. Sometimes, examples trump summaries. When looking at a crowd of people, we start to understand the distribution by seeing examples. Embedding visualizations leverage this way our brains work.

The user would be able to zoom around the density plot and scan lots of examples. LoD logic would mean you could see examples at various levels of detail without clicks.

Thinking about the implementation...
With some heuristic to find peaks in the density field, the embedding-atlas could show some number of examples (say, 15) at each level of zoom in a preview box. If the user clicks the preview box, it could open the full table associated with the example in the bottom panel.

I am sure this would require significant effort - you'd need an algorithm to find local peaks from the density, some zoom-level update logic, and a custom preview component. However, it seems interesting enough as an interaction pattern that I felt it's worth proposing. Let me know what you think! And thanks again for sharing this project.

[domoritz]

Could you create a few sketched of this idea? Embedding atlas already shows the actual points even when you look at density and it does show you individual points when you zoom in.

Screen.Recording.2025-10-09.at.12.49.48.mp4

I often don't like the clustering on maps since it's often too aggressive and shows data not where it actually is on the map.

Or are you suggesting that the table could maybe sync with the data that is currently in view (at least scrolling to it or highlighting it)?

[fr1ll]

@domoritz Yes, I will work on a few sketches.

For text, my suggestion is very close to what already exists. It would just replace the summary words with actual examples centered on that point. It's a good point that there's a tradeoff:

• Summary text can more faithfully represent a group of points - one example may be "central" to many points, but the full text can have features that aren't representative of it
• Summary text is terse, so you can still see details in the density plot behind it, and you can fit many summaries on the screen.
• However, example text avoids the summarization step which can sometimes miss style, etc. which might be influencing the neighborhood of points

For images, it's more obvious what this would add. If the images don't have captions, and if CLIP embeddings won't give meaningful captions, there's no great way to get summary text. Also, there's a "picture is worth 1000 words" thing going on here. Plotting example images (again, with similar zoom interactions to the summary text that gets plotted) would give a really powerful way to zoom around an image dataset. There is still the "over-implication" problem (related to your concern about over-aggressiveness) where one example may or may not be highly representative of its neighbors. There's also the challenge that plotting image previews will obscure the density map.

I'm not suggesting to dynamically filter the table to the view center. However, let's think about that. If you had an indicator on the density plot (e.g. highlighted points) to show where the table is filtered, it could give a nice way to zoom around. But there's a cognitive task to always relate the table to the densities. If you instead show examples on top of the density, you can give intuitions about the densities in their own spatial reference.

I'll work on sketches. Thanks for responding!

[domoritz]

I see. Yeah, for images I can see examples being useful. For text, we could maybe show the first n characters of a sample.