There is a newer version of the record available.

Published March 18, 2025 | Version v.0.1.0
Software Open

DesCartes Builder: Digital Twinning Machine-Learning Pipelines

Authors/Creators

  • 1. ROR icon Nanyang Technological University
  • 2. ROR icon CNRS@CREATE Ltd (Singapore)
  • 3. ROR icon Centre National de la Recherche Scientifique
  • 4. IPAL

Description

A Docker container with the DesCartes Builder and associated datasets. DesCartes Builder is a tool to create digital twin (DT) pipelines using the Function+Data Flow (FDF) domain-specific language for machine-learning-based DT modeling. It provides three high-level features:

  1. visual specification of the DT pipeline with implicit typing to detect common errors,
  2. automatic generation of executable models from the FDF specification,
  3. validation of design goals and ML models.

Docker image in `docker-descartes_builder.tar` and documentation in `BUILDER_DOC.pdf`.

The original sources are available at:

Acknowledgments
This research is part of the program DesCartes and is supported by the National Research Foundation, Prime Minister’s Office, Singapore under its Campus for Research Excellence and Technological Enterprise (CREATE) program.

Technical info

Here are instructions to use DesCartes Builder with the Docker container in this Zenodo storage. Alternatively, the Docker image in DockerHub: https://hub.docker.com/r/eduardoconto/descartes-builder.

1. Load the docker image `docker-descartes-builder.tar` (docker may require `sudo` root privileges):
```bash
docker load -i docker-descartes-builder.tar 
```
2. Ensure x11 is installed
```bash
sudo apt update && sudo apt install -y x11-apps xorg x11-xserver-utils
```
3. Run the container
```bash
docker run -it -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix descartes_builder:0.1
```
Note: You may need to use `xhost +local:docker` prior to `docker run` to authorize Docker to connect to your X server.

Details: 
- `-it` makes the container reactive to your input.
- `-e` forwards $DISPLAY to the container, enabling GUI applications to display on the host's screen.
- `-v` mounts the X11 Unix socket from the host to the container.

4. Run examples

Examples are available in `/app/deps/descartes-builder/app/examples` within the Docker image. Open with the UI: `File -> Open`. The tool is installed in `/app/build/bin`.

Files

BUILDER_DOC.pdf

Files (9.2 GB)

Name Size Download all
md5:ff1d2d78ddffcacca9ea80f1e861ac14
1.1 MB Preview Download
md5:b4cb5ab46feb58dabcd3b0ddcbdb6bc7
9.2 GB Download

Additional details

Related works

Is supplement to
Conference paper: 10.1145/3664646.3664759 (DOI)

Funding

National Research Foundation
DesCartes