Burst Groups

Wed, 15 Jul 2026 00:00:00 +0000

Burst Groups

Burst analysis turns a flat catalog into groups of adjacent, visually similar frames. It ranks each multi-frame group, presents review queues, and supports culling decisions such as keeping the best frame, keeping the top two, deferring a group, or setting a manual pick.

The implementation separates orchestration, Vision feature-print indexing, pure grouping and ranking engines, cache persistence, and the review UI.

Source Map

Area	Main files
Analysis orchestration and user actions	`sourcecode/RawCull/RawCull/Model/ViewModels/RawCullViewModel+BurstGrouping.swift`
Similarity indexing and grouping state	`sourcecode/RawCull/RawCull/Model/ViewModels/SimilarityScoringModel.swift`
Pure grouping and ranking	`sourcecode/RawCullCore/Sources/RawCullCore/BurstGroupingEngine.swift`, `BurstRankingEngine.swift`
Shared models	`sourcecode/RawCullCore/Sources/RawCullCore/BurstAnalysisModels.swift`, app `BurstAnalysisModels.swift`, `BurstReviewQueueModels.swift`
Cache	`sourcecode/RawCull/RawCull/Actors/BurstAnalysisCache.swift`
Ratings and manual overrides	`CullingModel.swift`, `SavedFiles.swift`
Burst home and review list	`BurstGroupsHomeView.swift`, `SimilarityGridSelectionView.swift`, `CullingGridView.swift`
Single-burst workspace and comparison	`BurstCullingWorkspaceView.swift`, `ComparisonGridView.swift`
Tests	`RawCullCore/Tests/RawCullCoreTests/BurstGroupingEngineTests.swift`, `BurstRankingEngineTests.swift`, app burst/culling tests

End-to-End Flow

flowchart TD
 A["Analyze Bursts"] --> B["RawCullViewModel.analyzeBursts"]
 B --> C{"Valid BurstAnalysisCache?"}
 C -->|"yes"| D["Remap cached IDs and apply snapshot"]
 C -->|"no"| E{"Sharpness scores missing?"}
 E -->|"yes"| F["Calibrate and score target files"]
 E -->|"no"| G["Reuse scores"]
 F --> H{"Similarity embeddings missing?"}
 G --> H
 H -->|"yes"| I["Index Vision feature prints"]
 H -->|"no"| J["Reuse embeddings"]
 I --> K["Group adjacent frames"]
 J --> K
 K --> L["Rank multi-frame groups"]
 L --> M["Apply manual winner overrides"]
 M --> N["Save cache and review-state snapshots"]
 N --> O["Show home dashboard and review queues"]

Every awaited phase is protected by the analysis generation and selected catalog. A cancelled or superseded run cannot publish late results into a newer catalog.

Grouping on RawCull

Burst Groups

Burst Groups

Source Map

End-to-End Flow