3D Bin Packing 项目使用与配置指南

3D Bin Packing 项目使用与配置指南

3d-bpp 3D bin packing solutions with layers and superitems, for Artificial Intelligence in Industry class at UNIBO 项目地址: https://gitcode.com/gh_mirrors/3d/3d-bpp

1. 项目的目录结构及介绍

3D Bin Packing 项目旨在解决三维装箱问题（3D-BPP），该项目包含以下几个主要目录：

• assets/：包含项目所需的资源文件。
• data/：存放数据集文件，如产品数据等。
• init/：初始化文件，包括项目依赖的安装列表。
• slides/：可能包含项目相关的演示文稿。
• src/：源代码目录，包含项目的核心实现。
• .gitignore：定义了git忽略的文件列表。
• LICENSE：项目使用的许可证文件。
• README.md：项目说明文件。
• TODO.md：记录项目待办事项。

2. 项目的启动文件介绍

项目的启动主要通过 src/ 目录下的 Python 脚本进行。以下是一个简单的启动示例：

from src import config, dataset, main

# 加载数据集
product_dataset = dataset.ProductDataset(
    "data/products.pkl",
    config.NUM_PRODUCTS,
    config.MIN_PRODUCT_WIDTH,
    config.MAX_PRODUCT_WIDTH,
    config.MIN_PRODUCT_DEPTH,
    config.MAX_PRODUCT_DEPTH,
    config.MIN_PRODUCT_HEIGHT,
    config.MAX_PRODUCT_HEIGHT,
    config.MIN_PRODUCT_WEIGHT,
    config.MAX_PRODUCT_WEIGHT,
    force_overload=False
)

# 获取随机订单
order = product_dataset.get_order(50)

# 使用指定的方法解决装箱问题
bin_pool = main.main(order, procedure="bl")

# 绘制装箱结果
bin_pool.plot()

这段代码首先加载了配置和数据集，然后获取一个随机订单，通过指定的算法解决问题，并最后绘制结果。

3. 项目的配置文件介绍

项目配置主要通过 src/config.py 文件进行。以下是配置文件中的一些关键配置项：

• NUM_PRODUCTS：产品数量。
• MIN/MAX_PRODUCT_WIDTH、MIN/MAX_PRODUCT_DEPTH、MIN/MAX_PRODUCT_HEIGHT：产品尺寸的最小和最大值。
• MIN/MAX_PRODUCT_WEIGHT：产品的最小和最大重量。

配置文件还可能包含其他与项目运行相关的参数，如算法参数、数据集路径等。确保在运行项目之前正确配置这些参数。

3d-bpp 3D bin packing solutions with layers and superitems, for Artificial Intelligence in Industry class at UNIBO 项目地址: https://gitcode.com/gh_mirrors/3d/3d-bpp