PhilippXXY / on-line-order-batching

Implementation of the paper "Algorithms for on-line order batching in an order picking warehouse" by Sebastian Henn (2012)

Home Page:https://doi.org/10.5445/ir/1000172331

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

On-line Order Batching Algorithm

Table of Contents

  1. Introduction
  2. Order Picking in Warehouse
  3. Project Details
  4. How to Run
  5. Inputs
  6. Outputs
  7. Testing and Debugging
  8. Useful Links

πŸ“˜ Introduction

This project is part of the 4D4L project at the Institute of Material Handling and Logistics (IFL) from the Karlsruhe Institute of Technology (KIT).

The algorithm addresses the on-line order batching problem in an order-picking warehouse, with the goal of minimizing the total completion time of customer orders arriving within a certain period. It modifies heuristic approaches used for static order batching to handle dynamic situations, based on the scientific paper by Sebastian Henn, which can be read here.

The detailed paper for this project is available directly on GitHub or in the KITopen Repository.

🏭 Order Picking in Warehouse

In manual order picking systems, order pickers walk or ride through a distribution warehouse to collect items required by customers. Order batching involves combining indivisible customer orders into picking orders. The choice of an appropriate batching method can significantly reduce the completion time of a set of customer orders.

πŸ“œ Project Details

  • Objective: Minimize the total completion time of customer orders.
  • Methodology: Modify heuristic approaches for static order batching to suit dynamic situations.
  • Application: Suitable for manual, single-person order picking systems in warehouses.

πŸ’» How to Run without git

  1. Download the repository
    • Click on the "Code" button and select "Download ZIP" or download the latest release.
    • Extract the ZIP file to the desired location.
  2. Navigate to the Project Directory
    cd path/to/extracted/on-line-order-batching
  3. Create and Activate a Virtual Environment:
    python -m venv env
    env\Scripts\activate # On MacOS use `env/bin/activate`
  4. Install the package
    pip install .
  5. Start the Program
    python -m src.main

⌨️ Inputs

  • Warehouse Layout: A CSV file where the positions of the items inside the warehouse are stored. Example file: warehouse_positions.csv.
  • Orders: A JSON file from which the CLI thread can take orders to be released to the core logic. Example file: test_orders.json.
  • Maximum Batch Size: The maximum number of items that can be picked in one batch (positive integers only).
  • Initial Order Release: The number of orders released when the program starts (positive integers only).
  • Tour Length Units per Second: Emulates the speed of how many tour length units per second get passed (positive integers only).
  • Rearrangement Parameter: Determines the perturbation level in the Iterated Local Search algorithm (values between 0 and 1).
  • Threshold Parameter: Difference a new best solution must have to be selected in the ILS algorithm (values between 0 and 1).
  • Release Parameter: Determines waiting time for new orders when only one batch is left (values between 0 and 1).
  • Time Limit: Sets the time to find a new optimum in the ILS algorithm (positive integers only).
  • Selection Rule:
    • FIRST: Sort by found batches ascending.
    • SHORT: Sort by batches with the lowest tour length.
    • LONG: Sort by batches with the longest tour length.
    • SAV: Sort by batches with the highest tour length savings compared to individual orders.

πŸ“¨ Outputs

The program provides a detailed table showcasing batches and their respective orders, along with all necessary information. The arrival time is calculated based on the predefined parameter for tour length units per second. For tour length calculations, the S-Shape Routing method is used, ensuring orders are sorted in a way that allows the picker to follow the routing scheme directly.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Batch ID: 31b7c880111a4336a3221ea7c012ee4d β”‚ Order ID: 4f157778550442f6984026080494fefd β”‚
β”‚                                            β”‚ Item ID: 321, X: 6, Y: 4, Z: 0             β”‚
β”‚                                            β”‚ Item ID: 432, X: 8, Y: 6, Z: 1             β”‚
β”‚                                            β”‚ Item ID: 543, X: 10, Y: 8, Z: 2            β”‚
β”‚                                            β”‚ Item ID: 654, X: 13, Y: 0, Z: 3            β”‚
β”‚                                            β”‚ Item ID: 765, X: 15, Y: 2, Z: 4            β”‚
β”‚                                            β”‚                                            β”‚
β”‚                                            β”‚ Order ID: 07b1cc984117410d9878c0913ab867bb β”‚
β”‚                                            β”‚ Item ID: 135, X: 2, Y: 6, Z: 4             β”‚
β”‚                                            β”‚ Item ID: 246, X: 4, Y: 9, Z: 0             β”‚
β”‚                                            β”‚ Item ID: 357, X: 7, Y: 1, Z: 1             β”‚
β”‚                                            β”‚ Item ID: 468, X: 9, Y: 3, Z: 2             β”‚
β”‚                                            β”‚ Item ID: 579, X: 11, Y: 5, Z: 3            β”‚
β”‚                                            β”‚                                            β”‚
β”‚                                            β”‚ Order ID: 39e8e66100d548b59ed8c8376b7e0aac β”‚
β”‚                                            β”‚ Item ID: 680, X: 13, Y: 5, Z: 4            β”‚
β”‚                                            β”‚ Item ID: 790, X: 15, Y: 7, Z: 4            β”‚
β”‚                                            β”‚ Item ID: 801, X: 16, Y: 0, Z: 0            β”‚
β”‚                                            β”‚ Item ID: 912, X: 18, Y: 2, Z: 1            β”‚
β”‚                                            β”‚ Item ID: 102, X: 2, Y: 0, Z: 1             β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Items sorted by S-Shape-Routing:           β”‚ Item ID: 102, X: 1, Y: 0, Z: 1             β”‚
β”‚                                            β”‚ Item ID: 135, X: 1, Y: 6, Z: 4             β”‚
β”‚                                            β”‚ Item ID: 246, X: 2, Y: 9, Z: 0             β”‚
β”‚                                            β”‚ Item ID: 321, X: 3, Y: 4, Z: 0             β”‚
β”‚                                            β”‚ Item ID: 432, X: 4, Y: 6, Z: 1             β”‚
β”‚                                            β”‚ Item ID: 357, X: 4, Y: 1, Z: 1             β”‚
β”‚                                            β”‚ Item ID: 468, X: 5, Y: 3, Z: 2             β”‚
β”‚                                            β”‚ Item ID: 543, X: 5, Y: 8, Z: 2             β”‚
β”‚                                            β”‚ Item ID: 579, X: 6, Y: 5, Z: 3             β”‚
β”‚                                            β”‚ Item ID: 654, X: 7, Y: 0, Z: 3             β”‚
β”‚                                            β”‚ Item ID: 680, X: 7, Y: 5, Z: 4             β”‚
β”‚                                            β”‚ Item ID: 790, X: 8, Y: 7, Z: 4             β”‚
β”‚                                            β”‚ Item ID: 765, X: 8, Y: 2, Z: 4             β”‚
β”‚                                            β”‚ Item ID: 801, X: 8, Y: 0, Z: 0             β”‚
β”‚                                            β”‚ Item ID: 912, X: 9, Y: 2, Z: 1             β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Amount of Orders:                          β”‚ 3                                          β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Amount of Items:                           β”‚ 15                                         β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Tour Length in warehouse units:            β”‚ 104                                        β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Start Time:                                β”‚ 11:56:42.3                                 β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Arrival Time:                              β”‚ 11:56:47.5                                 β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Tour Time in seconds:                      β”‚ 00:05.2                                    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ§ͺ Testing and Debugging

To get more information for debugging purposes, switch to the develop branch and run the program with:

python -m src.main -d

In this branch, test files are available to check the functions separately.

πŸ”— Useful Links

About

Implementation of the paper "Algorithms for on-line order batching in an order picking warehouse" by Sebastian Henn (2012)

https://doi.org/10.5445/ir/1000172331

License:Other


Languages

Language:Python 100.0%