How RawCullCore Is Constructed

Thu, 30 Jul 2026 00:00:00 +0000

How RawCullCore Is Constructed

RawCullCore is the small domain layer at the center of RawCull. It does not decode or analyze photos. Instead, it receives file metadata and measurements already produced elsewhere, groups sequential files into bursts, and ranks the candidates using deterministic culling rules.

Its main architectural value is that a recommendation can be tested without opening a RAW file, running Vision, creating a Metal context, loading application settings, or constructing a view model.

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.

Burst on RawCull

How RawCullCore Is Constructed

How RawCullCore Is Constructed

Burst Groups

Burst Groups

Source Map

End-to-End Flow