Saw settings explorer

Linear stock is cut to length — there is no layout to arrange, so it takes no cut type and no cut direction at all. Roll stock rips one way, across the roll (w).

1. 1 linear.no-cut-type-or-preference coerce info

   Linear stock has no cut type or cut preference

   Linear stock (bars, profiles, lengths) is cut to length; the optimiser arranges nothing on it, so a cut type or cut preference sent with linear stock is dropped rather than applied.

   reads stockType → writes cutTypecutPreference

2. 2 cut-type.default default info

   cutType defaults to the first cut type the stock type accepts

   cutType is optional. When omitted, the stock type's first accepted cut type is used (sheet and roll: guillotine; linear stock takes none).

   reads stockTypecutType → writes cutType

3. 3 cut-type.valid-for-stock clamp warning

   cutType must be one the stock type accepts

   Each stock type accepts a fixed set of cut types (sheet: guillotine, efficiency, beam, nesting; roll: guillotine, efficiency, nesting; linear: none). A cutType outside that set resolves to the first accepted one.

   reads stockTypecutType → writes cutType

4. 4 cut-preference.valid-for-stock-cut-type clamp warning

   cutPreference must be one the (stock type, cut type) pair accepts

   Only the guillotine family (guillotine, beam) has a cut direction: sheet stock accepts l, w or flex; roll stock rips one way (w). Efficiency, nesting and linear have no direction, so a value sent for them is cleared.

   reads stockTypecutTypecutPreference → writes cutPreference

5. 5 cut-preference.default default info

   cutPreference defaults to length-first

   A guillotine-family saw with no cut preference cuts length-first (l), or the only direction the stock allows (roll: w).

   reads stockTypecutTypecutPreference → writes cutPreference

6. 6 stacking-mode.none-for-roll coerce warning

   Roll stock cannot stack

   Roll stock is a single continuous length; there are no sheets to stack, so any stacking mode is forced to none.

   reads stockTypeoptions.stackingMode → writes options.stackingMode

7. 7 min-spacing.efficiency-only coerce warning

   Part spacing only applies to efficiency packing

   Part-to-part spacing is an efficiency-packing concept. The guillotine family and nesting derive their gaps from the blade width (kerf), so a spacing value sent for them is zeroed rather than carried as a setting the layout never honours.

   reads cutTypeoptions.minSpacingoptions.minSpacingDimension.dimensionoptions.minSpacingDimension.minSpacing → writes options.minSpacingoptions.minSpacingDimension.dimensionoptions.minSpacingDimension.minSpacing

8. 8 strategy.time-ignored-for-beam coerce warning

   Beam saws ignore guillotineOptions.strategy 'time'

   'time' trades material efficiency for layouts whose strips share cut positions, so a manual operator moves the fence fewer times. A beam saw positions its fence automatically for every cut, so the trade buys it nothing (and it used to suppress stacking, the beam saw's headline economy). Normalised rather than rejected because live callers send beam + time today.

   reads cutTypeguillotineOptions.strategy → writes guillotineOptions.strategy

9. 9 maxPhase.two-stage-normalised-for-beam coerce warning

   Beam saws cannot cut 2-stage (guillotineOptions.maxPhase 1)

   maxPhase counts the TURNS a board may take: 1 is 2-stage cutting (rip, turn, crosscut, no recut), 2 is three-stage. 2-stage is rare on the beam saws our customers run, and the cut derivation cannot yet build a dense layout inside that cap — it refuses the cuts that would free the parts, and the job spills onto boards that a three-stage cap fits comfortably. So a beam saw asking for 1 is normalised to 2 rather than run into that: nothing is rejected, the caller is told which rule fired, and 0 (unlimited) and every value from 2 up are left exactly as sent. Guillotine (table-saw) cutting still expresses 1 — the normalisation is beam-only.

   reads cutTypeguillotineOptions.maxPhase → writes guillotineOptions.maxPhase

10. 10 algorithm.ineligible ignore info

    The chosen optimisation model does not fit this saw

    The Max tiers are gated per family (rectangle-guillotine-max-* need a beam saw with a recognised profile and a part cap; irregular-nesting-max-* need a nesting saw). A model that does not fit the job safely falls back to the default — it never errors.

    reads algorithmcutType → writes nothing (the value is accepted, it just has no effect)

11. 11 profile.max-nested-cut-depth-sets-max-phase derive info

    A saw profile with a nesting-depth limit sets maxPhase

    When a recognised saw (vendor + model) declares a maximum nested cut depth and the request leaves maxPhase at 0 (no limit), the profile's depth is applied so the optimiser never plans a pattern the saw's controller rejects.

    reads guillotineOptions.maxPhase → writes guillotineOptions.maxPhase

12. 12 profile.cut-preference-clamped derive warning

    A saw profile's supported cut directions clamp cutPreference

    A saw that physically cannot rip short-side-first must not be handed a 'w' job. When a recognised profile declares supportedCutPreferences, a direction outside the set is steered to 'flex' if allowed (the optimiser then chooses per board within the set), else the first allowed direction.

    reads cutPreference → writes cutPreference

Kinds: default fills an unset value · clamp replaces a value the matrix does not allow · coerce rewrites a value another setting makes meaningless · ignore changes nothing and explains why the value will not take effect · derive means a recognised saw profile supplied or narrowed the value.

† marks a constraint tightened by the export format rather than by the saw: the machine could do more, but the file we write for it cannot yet describe it. "Validated" means output for that saw has been checked against the saw's own control software.

The full request reference — every endpoint, every field, runnable samples — is in the v3 API reference, and the narrative walkthrough is in the API guide.