Segmentation settings and limits

Segmentation settings control how RasterForge turns a render and profile into layers. These values matter because they affect output quality, run cost, and whether a run is allowed to start.

Workflows

WorkflowScopeUse when
Find things (multi-image)Active image, selected images, or all images depending on run target.The same class or object type should be found across imagery.
Select objects (single image)Active image only.You need point or box guided segmentation on one image.
Auto masks (object candidates)Active image, selected images, or all images depending on run target.You want class-agnostic object candidates before assigning meaning through review or downstream cleanup.

In the current app, SAM 3 flow labels include pcs, pcs_ref, pvs, and amg. User-facing workflows should be understood as Find things, Select objects, and Auto masks; the model flow label is the current backend mode used to run that workflow.

Profile and guidance limits

LimitDefault beta value
Text prompt length100 characters
Saved examples per segmentation profile5
Image guidance points plus boxes20

The app blocks runs that exceed these limits. It also blocks Find things with saved examples when no example is attached.

Find and select run settings

SettingDefaultPurpose
Detection threshold0.5Raises or lowers which detections are accepted in Find things workflows.
Mask threshold0.5Controls mask confidence cutoff.
Max instances200Limits object count returned by a run.
Box inferenceMulti-forwardControls how multiple boxes are sent to the model.
Reference margin100 pxAdds context around saved examples.
Pack gap8 px when examples are usedSeparates packed references.

Auto masks presets

Auto masks uses automatic mask generation settings. The preset is a starting point, not a quality guarantee.

PresetUse whenBehavior
BalancedYou want general object candidates without making the run too dense.Uses the default candidate density and cleanup settings.
DenseYou want more candidates and are willing to review more fragments.Increases grid density and keeps more masks.
CleanYou want fewer, stronger candidates.Raises quality and area thresholds and keeps fewer masks.

Advanced Auto masks controls include points per side, points per batch, predicted IoU threshold, mask threshold, stability score threshold, minimum mask region area, max masks, NMS IoU threshold, and postprocess settings.

Postprocess defaults

SettingDefault
Minimum score0.5
Minimum area100 px
Maximum areaOff
Keep top KOff
IoU deduplication threshold0.85
Simplify tolerance1.5

Postprocess settings are especially important for GeoJSON export. Use them to remove tiny fragments, deduplicate overlapping objects, and simplify vector geometry. Auto masks uses related postprocess defaults but may set different minimum score, minimum area, and keep-top-K values through its presets.

Patch accounting

SAM 3 runs are charged in 256 by 256 pixel patches. RasterForge estimates patches from the rendered input dimensions and sums patches across multi-image runs. Smaller AOIs and appropriate full render sizes reduce daily patch usage.