Compile from source

The installation of Stardis consists of compiling the solver and the command line tools directly on the target machine. A simple way is to rely on star-build, which automates the build and installation of stardis and its dependencies from source code.

Prerequisites

To build stardis with star-build, first make sure your system has the following prerequisites:

POSIX shell
POSIX make
curl
git
mandoc
pkg-config
sha512sum
GNU Compiler Collection in version 8.3 or higher
OpenMPI library and headers in version 2 or higher (optional)

Build

Assuming that the aforementioned prerequisites are available, the build procedure is summed up to:

git clone git://git.meso-star.com/star-build.git
cd star-build
make \
  PREFIX=/path/to/stardis/ \
  BUILD=src/therm-apps/stardis_0.12.sh

With PREFIX defining the path where Stardis will be installed and BUILD defining the installation script to be run.

By default, Stardis is built with MPI enabled, so OpenMPI is one of its requirements. To disable MPI support, simply set the DISTRIB_PARALLELISM parameter to NONE as follows:

make \
  PREFIX=/path/to/stardis/ \
  BUILD=src/therm-apps/stardis_0.12.sh \
  DISTRIB_PARALLELISM=NONE

Run

Evaluate the installed profile file in the current shell to register stardis against it. You can then run stardis and consult its manual pages:

. /path/to/stardis/etc/profile
stardis -h
man stardis

Refer to the Stardis: Starter Pack to quickly run a thermal simulation through the stardis CLI; this archive provides input data and scripts and is a good starting point to begin with the Stardis framework.