Core Concepts

Binacle.Net answers one question: given some bins and some items, which bin holds them, and where does each item go. This page is what you need to know before calling it - the shape of the data, the two operations, and the algorithms behind them.

πŸ“ Dimensions

Every bin and every item is a box: a length, a width and a height. Binacle.Net knows nothing else about them.

🧩 Fit and Pack

Binacle.Net does two things, and every endpoint is one or the other.

Fitting answers yes or no: do these items fit in this bin? It stops as soon as it knows, which makes it the cheap call - the one to make at checkout, before offering a delivery option that depends on the answer.

Packing goes on to place every item and returns where each one sits. If not everything fits, it packs what it can and names what was left over. This is the call that draws a picture, feeds a packing station, or is stored as ViPaq.

A fit that says yes is reliable: the items were placed. A no is a no from that algorithm, not proof that no arrangement exists - see below.

🧠 Algorithms

Binacle.Net uses heuristics: rules that place items quickly rather than searching every possible arrangement. They do not always find the best packing that exists, and in rare cases one misses a fit that another would find. That is the trade for answering in milliseconds.

Every algorithm sorts the items largest first, then places them one by one. They differ in which space each item goes into.

βš–οΈ First Fit Decreasing (FFD)

Each item goes into the first space it fits in.

🧊 Worst Fit Decreasing (WFD)

Each item goes into the space that leaves the most room behind.

πŸ“ Best Fit Decreasing (BFD)

Each item goes into the space that leaves the least room behind.

πŸ† Best

Runs more than one of the three and keeps the best result. The response says which one produced it. Only V4 offers it, and its page says which heuristics each route runs.

Which algorithm is fastest, or packs tightest, depends on your bins and items. These descriptions say what each one does, not how they rank. If it matters to your workload, measure all of them on your own data.

➑️ Where to go next