sardine-can

KO | EN

gitlite — search

#javascript #react #llm #golang #android #rust #deep-learning #linux #docker #macos #nodejs #vue #openai #open-source

(★ 111)

Humble 3D knapsack / bin packing solver

File Explorer

Download Latest Version (.zip)

- - build.yml
  - release.yml
- - sardines.png
  - sardines.svg
- - MasterThesis_MariusMerschformann.pdf
- - calculation.json
  - sample-calls.txt
- - CO2.png
- - convert.py
  - release.py
- .gitignore
- Executor.cs
- Program.cs
- README.md
- SC.CLI.csproj
- - Heuristic.cs
- - sardines.png
- - LinearModelBase.cs
  - LinearModelFLB.cs
  - LinearModelHybrid.cs
  - LinearModelSpaceIndexed.cs
  - LinearModelTetris.cs
- - COSolution.cs
  - InstanceCore.cs
  - InstanceIO.cs
  - MethodType.cs
- - CSVIO.cs
  - DualLogWriter.cs
  - EnumerableExtensions.cs
  - Helper.cs
  - ListExtensions.cs
  - MultiKeyDictionary.cs
  - ObjectArrayEqualityComparer.cs
  - RotationMatrices.cs
- qconvex
- qconvex.exe
- qhalf
- qhalf.exe
- README.md
- SC.Core.csproj
- - icon_arrow.png
  - icon_camera.png
  - icon_cancel.png
  - icon_clipboard.png
  - icon_disk.png
  - icon_folder.png
  - icon_generate.png
  - icon_generate_set.png
  - icon_import.png
  - icon_refresh.png
  - icon_rotate.png
  - icon_solve.png
  - icon_solve_fast.png
  - icon_validate.png
- - Handling_Fragile.png
  - Handling_Handle_with_care.png
  - Handling_This_side_up.png
  - HazMat_1_1_Explosives.png
  - HazMat_2_1_FlammableGas.png
  - HazMat_3_FlammableLiquid.png
  - HazMat_6_1_Toxic.png
- - Resources.Designer.cs
  - Resources.resx
- App.xaml
- App.xaml.cs
- AssemblyInfo.cs
- ColoringMode.cs
- Constants.cs
- HelixAdapter.cs
- Logo.ico
- MainWindow.xaml
- MainWindow.xaml.cs
- OptimizationRunner.cs
- packages.config
- README.md
- SC.GUI.csproj
- TextBoxWriter.cs
- - JsonHelpers.cs
  - PlaygroundFunctions.cs
- Program.cs
- SC.Playground.csproj
- - PackingController.cs
- - Calculation.cs
  - IJobManager.cs
  - JobManager.cs
- - launchSettings.json
- appsettings.Development.json
- appsettings.json
- docker-build.cmd
- docker-build.sh
- docker-run.cmd
- docker-run.sh
- Dockerfile
- libman.json
- Program.cs
- README.md
- SC.Service.csproj
- Startup.cs
- - sample_contained.json
  - sample_contained.json.golden
  - sample_offload.json
  - sample_offload.json.golden
- Golden.cs
- README.md
- SC.Tests.csproj
- SC.Toolbox.csproj
.dockerignore
.gitignore
LICENSE
README.md
SardineCan.sln
VERSION.txt

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SardineCan <img src='Material/Icon/sardines.svg' align="right" height="90" />

SardineCan is a humble 3D knapsack / bin packing solver with some special
constraints. It is a collection of constructive heuristics, meta-heuristic
attempts and linear models with CPLEX & Gurobi bindings.

![sample screenshot](https://raw.githubusercontent.com/merschformann/sardine-can/main/Material/Screenshots/CO2.png "Sample screenshot")

## Outline

- [SC.Service](SC.Service/)
  - Jobmanager/runner as a RESTful service for integration with other applications.
- [SC.GUI](SC.GUI/)
  - GUI for experimenting with the algorithms and rendering instances (download from [latest release](https://github.com/merschformann/sardine-can/releases/latest) - Windows only).
- [SC.CLI](SC.CLI/)
  - Command-line interface with a JSON-in/JSON-out style.

## Quickstart

Spin it up (requires [docker](https://docs.docker.com/get-docker/)):

```bash
docker run -d --restart always -p 4550:80 --name sardinecan ghcr.io/merschformann/sardinecan:latest
```

Swagger UI description of the RESTful service can be found here (or at the port
of your choice): [http://localhost:4550/swagger](http://localhost:4550/swagger)

## Remarks

The code mainly derives from my (Marius Merschformann) master thesis (2014) and
was primarily uploaded to enable colleagues to use it for their projects.
However, it would be great, if it is useful to even more people. :)

### Gurobi & CPLEX support

Unfortunately, I cannot ship the Gurobi and CPLEX libraries with the code.
I made an attempt of not relying on these during compile time by moving them to
a Nuget package (Atto.LinearWrap). Even though this part works, I had some
issues when supplying the dlls later on. Let me know, if you have ideas how to
overcome this.

I hope I can provide a solution for all who have access to Gurobi and/or CPLEX
in the future, so that the model formulations can also be tested.

### Contributors

The code mainly originated from the master-thesis of Marius Merschformann
(2014). Find a copy [here](./Material/MasterThesis/MasterThesis_MariusMerschformann.pdf).

The implementations around pre-processing were done by Daniel Erdmann and Simon
Moss during a university project. Further work on ALNS & some further extensions
were done in collaboration with Daniela Guericke.

sardine-can

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

sardine-can

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README