bmi-example-c-docker

The C example for the Basic Model Interface, dockerized.

Build the image

Build this example locally with:

docker build --tag bmi-example-c .

The image is based on the csdms/bmi image. The OS is Linux/Ubuntu. conda and mamba are installed in CONDA_DIR=/opt/conda, and the base environment is activated. The C BMI specification and example, including the run_bmiheatc executable, are installed into it.

Run a container

Run a container from this image interactively:

docker run -it bmi-example-c

This starts a bash shell in the container. Run the example program run_bmiheatc with a configuration file:

cd /tmp
echo "1.5, 8.0, 6, 5" > config.txt
run_bmiheatc config.txt

View the program's output with:

cat bmiheatc.out

Developer notes

A versioned, multiplatform image built from this repository is hosted on Docker Hub at csdms/bmi-example-c. When this repository is tagged, an image is automatically built and pushed to Docker Hub by the release CI workflow. To manually build and push an update, run:

docker buildx build --platform linux/amd64,linux/arm64 -t csdms/bmi-example-c:latest --push .

A user can pull this image from Docker Hub with:

docker pull csdms/bmi-example-c

optionally with the latest tag or with a version tag.

What is the Basic Model Interface?

The Basic Model Interface (BMI) is a set of functions for querying, modifying, running, and coupling models. Learn more at https://bmi.readthedocs.io/.

Acknowledgment

This work is supported by the U.S. National Science Foundation under Award No. 2103878, Frameworks: Collaborative Research: Integrative Cyberinfrastructure for Next-Generation Modeling Science.