Installation with Python virtual environment

Supported Platforms

  • Windows 10 or newer
  • macOS 10.14 or newer (Apple Silicon only)
  • Ubuntu 20.04 or newer
  • CentOS 8.2 or alternatives ( Rocky Linux, AlmaLinux, … )
  • OpenSUSE Leap 15.4
  • Linux Mint 21 “Vanessa”

BARAM requires following installed software:

  • Python 3.11.x
  • MS-MPI 10.0 or newer ( Windows Only )
  • OpenMPI 4.1 or newer ( Linux, macOS )
  • GNU C Compiler or any other C Compiler ( Linux, macOS )

1) Clone the source code

git clone https://github.com/nextfoam/baram.git
cd baram

2) Setup Python virtual environment

Run following command in the top directory of downloaded source code.

Please don’t forget that Python 3.11.x is required.

You can check it with the command of python3 -V.

python3.11 -m venv venv

3) Enter into virtual environment

Run following command in the top directory of downloaded source code

Windows

.\venv\Scripts\activate.bat

Linux 또는 macOS

source ./venv/bin/activate

4) Upgrade pip version

pip install --upgrade pip

5) Install Python packages

pip install -r requirements.txt

6) Install PyQtGraph

pip install https://d3c6e16xufx1gb.cloudfront.net/wheels/pyqtgraph-0.13.5-py3-none-any.whl

7) Install QT Advanced Docking System package

Run following command in the top directory of downloaded source code

Windows

pip install https://d3c6e16xufx1gb.cloudfront.net/wheels/PySide6_QtAds-4.2.1.2.dev0-cp38-abi3-win_amd64.whl

Linux

pip install https://d3c6e16xufx1gb.cloudfront.net/wheels/PySide6_QtAds-4.2.1.2.dev0-cp38-abi3-linux_x86_64.whl

8) Copy Solver Executables

Download and uncompress solver executables into the top directory of downloaded source code.

The compressed files have solvers folder in it.

Put solvers folder into the top directory.

The final directory structure may look like following.

($BARAM)
|
+-- requirements.txt
+-- ...
+-- solvers/
|   |
|   +-- openfoam/
|       |
|       +-- bin/
|       +-- etc/
|       +-- ...
+-- ...

Windows

solvers_windows_25.3.0.zip

Linux

solvers_linux_25.3.0.tar.xz

You can download the file on command line with cURL or wget command like following.

wget https://d3c6e16xufx1gb.cloudfront.net/solvers_linux_25.3.0_20250910.tar.xz
curl -L https://d3c6e16xufx1gb.cloudfront.net/solvers_linux_25.3.0_20250910.tar.xz -o solvers_linux_25.3.0_20250910.tar.xz

macOS(Apple Silicon Only)

Not yet prepared due to the strict code signing policy from Apple.

9) Compile Daemonizer(Only Linux and macOS )

“solvers” directory was created when the compressed file was uncompressed.

gcc -o solvers/openfoam/bin/baramd misc/baramd.c

10) Compile Resource Files

python convertUi.py

Run BaramFlow

python -m baramFlow.main

Run BaramMesh

python -m baramMesh.main

Convenient Scripts that do not require manual venv activation

baramFlow.sh
baramMesh.sh

* If you encounter issues running baramFlow on a specific Linux distribution, try using the following command.

QT_QPA_PLATFORM="xcb" ./baramFlow

Azure market place

You can use BARAM Cloud service with Azure makret place!!

Visit below link and use BARAM cloud service!!

Azure market place link

Paraview

BaramFlow has a menu that can launch ParaView for post-process.

Users should download and install Paraview for post-process. And users can download it in ParaView Download Site.

If ParaView is installed in the system, this menu launches ParaView in the case foler.