All documentation
Layouts and grouping/02

Clustering Dimensions

Pro

Every heuristic FenSight can group by, and how each is computed.

Clustering dimensions are the metadata, file facts, and visual signals FenSight uses to split a board into labeled buckets. You can apply many of them directly from the layout dropdown, or combine any Custom Cluster Layout heuristic with a group shape, item shape, ordering, and label style.

How to choose a dimension

Toolbar

Layout dropdown -> Cluster: ...

Applies a one-click built-in cluster mode immediately.

Toolbar

Layout dropdown -> Custom Cluster Layout... -> Clustering Heuristic

Builds a reusable Pro preset from a heuristic, Group Shape, Shape, sort order, neutral threshold, and label colors.

Two surfaces, one grouping model

The built-in layout dropdown exposes ready-made modes such as Cluster: Extension, Cluster: Color Hue, Group: Width, and AI: Visual Similarity. The Custom Cluster Layout dialog exposes a Clustering Heuristic list for reusable presets. When the names differ, the custom heuristic maps to the built-in mode shown in the technical note.

  • One-click modes are fastest when the grouping dimension and packing style are already what you want.
  • Custom Cluster Layout is for repeatable board recipes: choose the dimension, choose how groups are placed, choose how items pack inside each group, then save the preset.
  • Normal is available as a custom heuristic row for normal-map detection, but it does not map to a separate built-in layout mode.

Dimensions

This table includes every Clustering Heuristic visible in the custom dialog plus the built-in-only dimensions exposed by the layout dropdown.

NameWhat it groups byMode and technical note
Folder PathPro
Groups items by their containing folder.Custom heuristic maps to Cluster: Parent Folders. Paths are normalized and the largest path buckets are kept up to the path bucket cap.
Sort by NamePro
Groups filenames alphabetically, with non-alpha names handled as neutral.Custom heuristic maps to Cluster: Alphabetical. Alphabetical is also accepted by the mode map; alpha buckets are capped separately from granular numeric buckets.
ExtensionPro
Groups by file extension.Custom heuristic maps to Cluster: Extension using lowercase extension categories.
Date CreatedPro
Groups by file creation time.Custom heuristic maps to Cluster: Created Date and builds date/time range buckets from cached signatures or file creation times.
Date ModifiedPro
Groups by last modified time.Custom heuristic maps to Cluster: Modified Date and builds date/time range buckets from cached signatures or file last-write times.
File SizePro
Groups by size on disk.Custom heuristic maps to Cluster: File Size and builds numeric size ranges from cached size signatures or file lengths.
Dimension WidthPro
Groups by pixel width.Custom heuristic maps to Group: Width, which builds width buckets and lays those groups out sequentially.
Dimension HeightPro
Groups by pixel height.Custom heuristic maps to Group: Height, which builds height buckets and lays those groups out sequentially.
DPIPro
Groups images by DPI.Custom heuristic maps to Cluster: DPI and uses the larger bitmap DPI axis for numeric range buckets.
Color HuePro
Groups by dominant hue, with low-saturation items treated as neutral.Custom heuristic maps to Cluster: Color Hue. The engine uses 8 hue buckets; mixed or neutral colors are separated by hue and saturation thresholds.
BrightnessPro
Groups by average brightness.Custom heuristic maps to Cluster: Brightness and samples thumbnail pixels into percentage brightness buckets.
EntropyPro
Groups by visual complexity.Custom heuristic maps to Cluster: Entropy and computes Shannon entropy from sampled thumbnails, capped at 50 entropy buckets.
Duration (Audio/Video)Pro
Groups media by playback length.Custom heuristic maps to Cluster: Duration (Audio/Video) and builds range buckets from media duration metadata.
Audio LoudnessPro
Groups audio by perceived loudness.Custom heuristic maps to Cluster: Audio Loudness and buckets an RMS loudness score from waveform data.
Audio Dynamic RangePro
Groups audio by dynamic range.Custom heuristic maps to Cluster: Audio Dynamic Range and buckets a waveform quartile range score.
PBRPro
Groups physically based rendering texture maps by role.Custom heuristic maps to Cluster: PBR Tags for roles such as packed ORM, normal, albedo, roughness, metallic, AO, height, and IBL.
NormalPro
Identifies normal-map-oriented assets when used from the custom dialog.This custom heuristic has no separate built-in layout mode. Use PBR when you want the broader Cluster: PBR Tags role grouping.
Geo LocationPro
Groups photos by GPS location.Custom heuristic maps to Cluster: Geo Location using EXIF GPS metadata through the geo bucket provider; items without GPS fall into a no-location bucket.
Star RatingPro
Groups by item rating when rating metadata is available on the board.Custom heuristic maps to Cluster: Star Rating. Availability can depend on surfaced board metadata; custom cluster layouts are Pro-gated.
TagsPro
Groups by assigned tags.Built-in-only mode: Cluster: Tags. It uses the first sorted item tag as the bucket, marks multi-tag items, and sends untagged items to an Untagged bucket.
Aspect RatioPro
Groups by image or media orientation and width-to-height ratio.Built-in-only mode: Cluster: Aspect Ratio. Ratios are labeled into orientation buckets such as Tall, Squareish, Wide, Cinematic, and UltraWide.
Edge DensityPro
Groups by the amount of edge detail in the thumbnail.Built-in-only mode: Cluster: Edge Density. Thumbnail contrast changes are sampled and labeled as Flat, Soft, Textured, or Busy.
AI: Visual SimilarityPro
Groups visually related items by learned similarity rather than a single file fact.Built-in-only mode: AI: Visual Similarity. Compatible stored embeddings are clustered with K-means; when semantic clustering is unavailable, FenSight falls back to the fast visual-signature layout.

Bucket limits keep dense boards readable: granular buckets cap at 150, categorical buckets cap at 50, and path buckets cap at 100. The lower-level cluster engine also uses ClusterBucketCount=12, MaxClusterBucketCount=150, MaxAlphabetBucketCount=50, and MaxEntropyBucketCount=50.

Neutral thresholds

The Custom Cluster Layout Neutral slider only affects Color Hue and Sort by Name. It ranges from 0 to 0.5, ticks by 0.01, and displays 0.18 by default.

  • For Color Hue, low-saturation items below the neutral threshold are separated from saturated hue buckets. The engine constants include HueBucketCount=8, HueMixedThreshold=0.55, and HueNeutralSaturation=0.18.
  • For Sort by Name, non-alpha filename starts are treated as neutral using the alphabetical neutral threshold. The engine constant AlphabetNeutralThreshold is 0.18.
  • Changing the neutral threshold does not change date, file size, folder, extension, audio, geo, tag, PBR, or AI similarity grouping.

Connected guides

Follow these related pages when the workflow crosses into setup, search, organization, export, security, or another board-level system.