Skip to content

JavaScript solution for 3D bin packing problem - Ravioli Edition

License

Notifications You must be signed in to change notification settings

raviolishipping/bin-packing-3d

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 

Repository files navigation

3D bin packing (Ravioli Edition)

JavaScript solution for 3D bin packing problem adapted to our use case at Ravioli.

Basics

All interactions happen with 3 main object types:

Bin - space (rectangular cuboid) which is being filled with Items.

let myBin = new Bin(name, width, height, depth, max_weight);

Item - box (also a rectangular cuboid) which is being placed in Bin.

let myItem = new Item(name, width, height, depth, max_weight);

Packer - object through which packing is performed. Packer has three main methods:

let packer = Packer();       // Packer definition

packer.addBin(myBin);       // Adding bin to packer
packer.addItem(myItem);     // Adding item to bin

packer.pack();               // Packing items to bins. Returns true if all items fit into the bins

pack(bigger_first, distribute_items) props:

  • bigger_first (boolean) - By default all the bins and items are sorted from the smallest to the biggest.
  • distribute_items (boolean)
    • true => From a list of bins and items, put the items in the bins that at least one item be in one bin that can be fitted. That is, distribute all the items in all the bins so that they can be contained.
    • false (default) => From a list of bins and items, try to put all the items in each bin and in the end it show per bin all the items that was fitted and the items that was not.

Example

let packer = new Packer();

packer.addBin(new Bin('Big Box', 11.5, 6.125, 0.25, 10));

packer.addItem(new Item('Small Package of Ravioli', 10.2, 3, 15.8, 1));
packer.addItem(new Item('Big Package of Ravioli', 12, 6.2, 20.6, 2));

const packed = packer.pack();

console.log(`All items fit into the bin: ${packed}`);

Credits

License

MIT

About

JavaScript solution for 3D bin packing problem - Ravioli Edition

Resources

License

Stars

Watchers

Forks

Languages

  • JavaScript 100.0%