# Packrift packingsolver integration brief

Generated: 2026-05-31T13:50:37.604Z

This maintainer-facing packet summarizes the Packrift packingsolver-compatible ecommerce cartonization fixture pack. It exists to make review easier for packingsolver-style box workflows without copying the generated data files into an upstream code repository.

## Counts

- Generated scenarios: 350
- Generated packingsolver input files: 1050
- Carton candidates: 120
- Order item lines: 803
- Converter validation status: pass

## Public URLs

- HTML brief: https://packrift-benchmark-navigator.vercel.app/packingsolver-fixtures-integration-brief.html
- JSON brief: https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/integration-brief.json
- Converter page: https://packrift-benchmark-navigator.vercel.app/packingsolver-converter.html
- Converter script: https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/convert_box_packrift.py
- Format map: https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/packingsolver-format-map.json
- Instance index: https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/instance-index.json
- Validation report: https://packrift-benchmark-navigator.vercel.app/data/packingsolver-fixtures/converter-validation-report.json

## Expected packingsolver files

- bins.csv: Packable container candidates. Columns: ID, X, Y, Z, COST, COPIES. Generated from Packrift carton candidates; optional packingsolver columns such as COPIES_MIN and MAXIMUM_WEIGHT are intentionally not claimed in the current fixture pack.
- items.csv: Generated ecommerce scenario item lines. Columns: ID, X, Y, Z, COPIES, PROFIT, ROTATION_XYZ, ROTATION_YXZ, ROTATION_ZYX, ROTATION_YZX, ROTATION_XZY, ROTATION_ZXY. Generated scenario dimensions with rotation flags present so parser behavior is explicit.
- parameters.csv: Instance-level solver settings. Columns: NAME, VALUE. Current generated instances declare the objective in a small parameters file instead of implying solver results.

## Review gates

- Check the integration brief and machine-readable JSON before reviewing individual scenario files.
- Use instance-index.json or instance-index.csv to select a small scenario family sample.
- Run convert_box_packrift.py against the fixture CSVs and compare outputs with the published converter-validation report.
- Treat bins/items/parameters CSVs as parser and workflow inputs, not as proof of optimal or quasi-optimal solutions.
- If accepting into an upstream project, link to the public fixture page plus the converter script rather than copying the whole generated data set into a code repository.

## Boundaries

- The scenarios are generated from public Packrift product records and are not real customer orders.
- No optimal, quasi-optimal, or benchmark-winning solution is claimed.
- No live Packrift inventory, live price, freight approval, or fulfillment promise is made.
- No third-party maintainer endorsement is claimed by this page.
- No separate open-data license is declared here; reuse requires Packrift approval unless a later publication venue declares a license.

## Upstream references

- packingsolver convert_box.py: https://github.com/fontanf/packingsolver/blob/master/scripts/convert_box.py
- packingsolver box instance parser: https://github.com/fontanf/packingsolver/blob/e3a91035cea0501a11edfb94235d0baa6a0213fd/src/box/instance_builder.cpp#L337-L542

Count treatment: owned public technical asset only. This is not a third-party backlink, upstream acceptance, or SEO-tool-visible referring-domain win.