openeuler/openlb repository overview

⁠Quick reference

• The official OpenLB docker image.

• Maintained by: openEuler CloudNative SIG⁠.

• Where to get help: openEuler CloudNative SIG⁠, openEuler⁠.

⁠OpenLB | openEuler

The OpenLB project is a C++ package for the implementation of lattice Boltzmann methods adressing a vast range of tansport problems.

⁠Supported tags and respective Dockerfile links

The tag of each openlb docker image is consist of the version of openlb and the version of basic image. The details are as follows

⁠Usage

In this usage, users can select the corresponding {Tag} and container startup options based on their requirements.

• Pull the openeuler/openlb image from docker

  docker pull openeuler/openlb:{Tag}
  

  Copy

• Start a openlb instance

  docker run -it --rm openeuler/openlb:{Tag}
  

  Copy

• Running Test Cases

  All test cases can be compiled by running the make samples command. For details about how to execute an independent test case, for example, cylinder2d, see Non-parallel Computing and Parallel Computing.

  • Non-parallel Computing Procedure

    1. Go to the directory where the test case is stored.

       cd examples/laminar/cylinder2d
       

       Copy
    2. Compile the test case.

       make
       

       Copy
    3. Run the program to perform the computing.

       ./cylinder2d
       

       Copy
       The generated VTK and gnuplot results are stored in the /tmp directory.

  • Parallel Computing Procedure

    1. Go to the directory where the test case is stored.

       cd examples/laminar/cylinder2d
       

       Copy
    2. Compile the test case.

       make
       

       Copy
    3. Run the program to perform the computing. The following uses -np=64 and OMP_NUM_THREADS=1 as an example.

       mpirun –allow-run-as-root –np 64 –x OMP_NUM_THREADS=1 ./cylinder2d
       

       Copy
       The generated VTK and gnuplot results are stored in the /tmp directory.

⁠Question and answering

If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images⁠.