303248153 / sharp3dbinpacking

C# version of 3d bin packing algorithms translated from krris/3d-bin-packing

3D bin packing algorithms

Bin packing problem.

This library is translated from https://github.com/krris/3d-bin-packing.

Example

The coordinates are defined as:

       o--------o
      /|       /|
     / |      / |
  h o--------o  |
  e |  o-----|--o h
y i | /      | / t
  g |/       |/ p z
  h o--------o e
  t | width   d
    |  x
 (0, 0, 0)

Example code:

// Define the size of bin
var binWidth = 1000;
var binHeight = 1000;
var binDepth = 1000;

// Define the cuboids to pack
var parameter = new BinPackParameter(binWidth, binHeight, binDepth, new[]
{
	new Cuboid(150, 100, 150),
	new Cuboid(500, 500, 500),
	new Cuboid(500, 550, 700),
	new Cuboid(350, 350, 350),
	new Cuboid(650, 750, 850),
});

// Create a bin packer instance
// The default bin packer will test all algorithms and try to find the best result
// BinPackerVerifyOption is used to avoid bugs, it will check whether the result is correct
var binPacker = BinPacker.GetDefault(BinPackerVerifyOption.BestOnly);

// The result contains bins which contains packed cuboids whith their coordinates
var result = binPacker.Pack(parameter);
foreach (var bins in result.BestResult)
{
	Console.WriteLine("Bin:");
	foreach (var cuboid in bins)
	{
		Console.WriteLine(cuboid);
	}
}

Outputs:

Bin:
Cuboid(X: 0, Y: 0, Z:0, Width: 750, Height:850, Depth:650, Weight: 0, Tag: )
Cuboid(X: 0, Y: 0, Z:650, Width: 350, Height:350, Depth:350, Weight: 0, Tag: )
Cuboid(X: 750, Y: 0, Z:0, Width: 150, Height:150, Depth:100, Weight: 0, Tag: )
Bin:
Cuboid(X: 0, Y: 0, Z:0, Width: 700, Height:500, Depth:550, Weight: 0, Tag: )
Cuboid(X: 0, Y: 500, Z:0, Width: 500, Height:500, Depth:500, Weight: 0, Tag: )

License

MIT License
Copyright © 2018 303248153@github
If you have any license issue please contact [email protected].

sharp3dbinpacking's Issues

List of cuts for guillotine

Is there any way to get list of created cuts for guillotine, steps or similar?

don't rotate the item

Hi,
Thank you for your program.
I don't want to rotate the item.
Is it possible to put to container without rotating the item?

Specifying dead zones within the bin

Is there a way, to specify no-go zones when placing a Box inside the bin?

Alternatively, can I pre-place a box within the Bin, at a certain location?

My thought is that if you were able to do that then you can re-use this algorithm for fitting boxes in different shape boxes.

Any pointers on what I can do to achieve this?

Why was the property BinPackResult.AllResults dumped?

• This method allowed showing several solutions some of which were equally interesting?
• I have implemented the Sharp3DBinPacking algorithm in StackBuilder and I believe most users were interested in having several solutions with same pallet height to compare.
• Is there a workaround to this issue or should I create my own fork?
  Regards,

Find a way to apply orientation constraints on cuboids...

This is a critical issue for most people working in logistics: Some package can only be transported when sitting on their bottom. In this case, the user would only allow a Z sitting position (Z=true), setting other booleans X and Y to false.
Do you intend to implement such a feature in the near future?