Technical Documentation

Technical documentation of RawCull analysis implementation and result computation.

These tech docs describe how RawCull computes analysis results, stores evidence, and turns measurements into review recommendations. They are intended for readers who want implementation detail beyond the user guides.

The reference is the local RawCull source inspected on 6 October 2026, primarily the RawCull/RawCull application, RawCullCore, PhotoAnalysisKit, and PhotoAIKit. Defaults and algorithms describe that source snapshot; they do not establish which features are available in an App Store release. RawCullBrowse and RawCullFB have separate integrations and should not be assumed to behave identically.

Technical index

TypeTechnical themeContents
Tech docVisual walkthroughAnnotated example connecting pixels, focus evidence, indexes, bursts, and AI models
Tech docSharpness scoringLaplacian energy, robust statistics, regional blending, and calibration
Tech docFocus maskNative-pixel detail, region selection, adaptive thresholds, and overlay rendering
Tech docVision and CLIP indexesRepresentations, distance calculations, indexing, and compatibility
Tech docSubject evidenceSaliency, autofocus, masks, local detail, and Deep Review confidence
Tech docBurst groupsBoundaries, metadata checks, ranking weights, and recommendation confidence
Tech docCLIP modelImage/text inference, preprocessing, semantic search, and model identities
Tech docSAM 3 modelPrompted segmentation, union masks, object instances, and downstream scoring
Tech docQwen Vision modelVision-language generation, structured scores, and object assessment

The three principal AI model families are CLIP, SAM 3, and Qwen Vision. The AI tabs combine them: SAM 3 + CLIP uses segmentation and semantic evidence, Qwen Vision performs image assessment, and Objects combines SAM 3 instances with Qwen. Apple Vision also supplies feature prints, attention saliency, and classification. EfficientSAM has a separate provider in the source tree; it is not one of the three families documented here.

How the stages connect

  1. Decode a photograph into an analysis image and read available camera metadata.
  2. Measure sharpness and retain regional focus evidence.
  3. Index visual representations and compare adjacent photographs.
  4. Create burst boundaries and rank candidates using deterministic rules.
  5. Run optional subject-mask or vision-language review on a smaller candidate set.

A similarity distance, a sharpness scalar, a segmentation confidence, and a generated assessment score have different meanings. Their scales cannot be interchanged. The pages below identify the computation and its limits at each stage.

For operating instructions, start with Sharpness Scoring, Similarity, Bursts, and Search, and AI Step by Step.


How RawCull Analyzes a Photo

An illustrated connection between pixels, focus evidence, similarity, segmentation, burst ranking, and AI assessment.

Sharpness Scoring — Technical Detail

Technical documentation of RawCull analysis implementation and result computation.

Focus Mask — Technical Detail

Technical documentation of focus-mask edge detection, region selection, adaptive thresholds, and rendering.

Vision and CLIP Indexes — Technical Detail

Technical documentation of RawCull analysis implementation and result computation.

Subject Evidence — Technical Detail

Technical documentation of RawCull analysis implementation and result computation.

Burst Groups — Technical Detail

Technical documentation of RawCull analysis implementation and result computation.

CLIP Model — Technical Detail

Technical documentation of RawCull analysis implementation and result computation.

SAM 3 Model — Technical Detail

Technical documentation of RawCull analysis implementation and result computation.

Qwen Vision Model — Technical Detail

Technical documentation of RawCull analysis implementation and result computation.


Last modified October 6, 2026: burst groups (3539b30)