cip4/bambi repository overview

⁠CIP4 Bambi - JDF Device Simulator

Bambi is a CIP4 Tool for the simulation of JDF Devices and JDF Controllers. Originally, it was designed in order to provide a test framework for the development of Management Information Systems. Using configuration files, a set of individual JDF Devices can be defined and simulated such as presses, post press devices etc.

Another use case of Bambi is the simulation of production processes within a printing house. When configuring the Bambi Devices with the original characteristics of production devices, the affects of scenarios within a printing house can be simulated. This is useful especially for highly standardized production lines.

Here is an online version of CIP4 Bambi: https://bambi.cip4.org⁠

⁠Environment Variables

⁠Bambi Docker

Bambi is also available as Docker image on Docker Hub: https://hub.docker.com/r/cip4/bambi⁠. Here are the CLI commands to launch the image locally on your machine:

$ docker pull cip4/bambi:latest
$ docker run -p 8080:8080 cip4/bambi:latest

You can also run it with the GUI by setting an X11 display:

$ docker run -e DISPLAY="$DISPLAY" -p 8080:8080 bambi:latest

On some systems, e.g., WSL, you may need to mount the host's X11 Unix socket:

$ docker run -e DISPLAY="$DISPLAY" -v /tmp/.X11-unix:/tmp/.X11-unix -p 8080:8080 bambi:latest

⁠Usage

⁠Job Submission

There are multiple ways to submit jobs to Bambi. Besides the standardized JMF approach, Bambi also provides multiple simplifed ways to submit jobs. In the following is a list of the job submission methods. Sample JDF Jobs can be found in the project's sample-jdfs⁠ folder:

⁠Using the Command Line:

$ curl -X POST -H "Content-Type: application/vnd.cip4-jdf+xml" -d @sim003-sample.jdf http://localhost:8080/SimWorker/jmf/sim003

⁠Alces

CIP4 Alces can be used to submit jobs to Bambi using JMF SubmitQueueEntry messages. Here is the link to Alces: https://github.com/cip4/Alces⁠

⁠Issue Tracking

Don't write issues. Please provide Pull-Requests! https://github.com/cip4/Bambi⁠