CONSTRAINTS / WHAT MAKES A PLACEMENT LEGAL

Packing constraints: a placement is useful only while every rule holds.

Each rule is a request field, enforced during the search by every engine and recomputed afterwards by a validator that shares no code with it.

+
CONSTRAINT / 01

Geometry

inner_dimensions + clearance · made_to_measure · deformable_boundary · pallet_overhang_limit

Every placement stays inside the usable volume, on exact integers. A container can also be a cut-to-measure box, a mailer or an overhung pallet.

✓ enforced during search, recomputed from the result
REFERENCE / EVERY RULE
01

Geometry

EXPRESSED WITHinner_dimensions + clearance · made_to_measure · deformable_boundary · pallet_overhang_limit

Every placement stays inside the usable volume, on exact integers. A container can also be a cut-to-measure box, a mailer or an overhung pallet.

Open
02

Item shapes

EXPRESSED WITHshape_type · hull_vertices · compression_ratio

Two opt-in shapes beyond the rigid cuboid: a convex hull decided by exact integer geometry, and a compressible item that yields under load.

Open
03

Units and numerics

EXPRESSED WITHexact fixed-point ticks

Lengths and weights accept fractional, decimal or unit-suffixed input and are carried as exact ticks, with no floating point before the score.

Open
04

Rotations

EXPRESSED WITHallowed_rotations · keep_upright

Orientation is restricted per axis, not as a single on/off switch, and 'this side up' is expressible on the item that needs it.

Open
05

Obstacles and clearance

EXPRESSED WITHobstacles + additional_boxes

Reserved volumes are geometry: unions of exact boxes approximate a wheel arch, a post or a roof shelf, and placements route around them.

Open
06

Support

EXPRESSED WITHminimum_support_ratio · ground_contact_rule

The supporting footprint is computed as exact contact area against the floor or the items below, including loads bridged across two neighbours.

Open
07

Top load

EXPRESSED WITHmax_top_load · cumulative

Load is propagated through the contact graph, so a bearing limit is checked against the whole stack above an item rather than its direct neighbour.

Open
08

Stacking

EXPRESSED WITHstackable · max_stacked_items · nesting_height · max_stack_density · stacking_group

Stackability, stack counts, nesting height, density limits and stacking groups shape a legal column, checked at every level, not only the floor.

Open
09

Weight and payload

EXPRESSED WITHweight · max_payload · tare_weight

Item weight, container tare and payload capacity are exact, and a candidate that would overload the container is refused during the search.

Open
10

Centre of mass and axle load

EXPRESSED WITHcentre of mass · support polygon · axles

The aggregate centre of mass, the support polygon and exact gross two-axle reactions are enforced through the same constraint layer as geometry.

Open
11

Compatibility and policy

EXPRESSED WITHincompatible_tags · group · policy

Items can be required to stay together or apart, and versioned eligibility rules travel in the request with the context they select on.

Open
12

Load order

EXPRESSED WITHstop_index · access_directions

A reachable unloading sequence: nothing due later is buried under an earlier item, or parked between it and a door the container declares.

Open
13

Independent validation

EXPRESSED WITHrecompute from the result

A validator that shares no code with the solver recomputes the objective and every affected rule from the placements each runtime returned.

Open
14

Objectives

EXPRESSED WITHlexicographic exact integers

Seven selectable rankings, from fewest containers to most volume packed. Six rank the units left over first; one ranks the volume left over first.

Open

WHEN IT SAYS NO

A refusal carries the rule, the measurement and a proof level.

Every unpacked item comes back with a reason code, the details behind it, and how strongly that reason is backed. This is what support, a warehouse operator or a retry policy actually needs.

01
No permitted rotation fits · Proven rotation_restricted

ITEM 31

this side up

would only fit lying down, and the item may not be laid down

02
No free space left that it fits into · Measured no_feasible_placement

ITEM 08

support 0.42 / 0.65

every candidate position left the footprint below the required support ratio

03
Its group cannot be kept together · Inferred group_cannot_fit_together

KIT 04

2 of 2 units

the group travels whole or not at all, so neither unit was placed