How RawCull Loads and Uses CLIP

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

How RawCull Loads and Uses CLIP

RawCull supports two CLIP models:

OpenAI CLIP ViT-B/32, which processes a 224 × 224 image;
OpenCLIP DataComp ViT-B-32-256, which processes a 256 × 256 image.

The user selects one model in Settings > AI. That one selection defines the vector space used for both image-to-image similarity and text-to-image semantic search. RawCull never mixes vectors from the two models.

This page starts with the basic idea behind CLIP and then follows the current source code from application startup, through model validation and Core AI inference, to search results, burst groups, and persisted artifacts.

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.

Similarity on RawCull

How RawCull Loads and Uses CLIP

How RawCull Loads and Uses CLIP

Burst Groups

Burst Groups

Source Map

End-to-End Flow