commit 4f5a5bde6a04a144e35d2c02742633bf671e2b6c
parent edf5b41fbba0e2a2f6bddf365f229f64dbe41eea
Author: Vincent Forest <vincent.forest@meso-star.com>
Date: Wed, 16 Mar 2022 17:11:11 +0100
Publish Stardis 0.13.1
Diffstat:
5 files changed, 47 insertions(+), 22 deletions(-)
diff --git a/stardis/Makefile b/stardis/Makefile
@@ -16,7 +16,7 @@
include ../config.mk
-STARDIS_VERSION=0.12.3
+STARDIS_VERSION=0.13.1
STARTER_PACK_VERSION=0.1.0
STARDIS_DIR=Stardis-$(STARDIS_VERSION)-GNU-Linux64
@@ -28,7 +28,9 @@ STARDIS_PKG=\
./downloads/Stardis-0.11.0-r1-Sources.tar.gz\
./downloads/Stardis-0.11.0-r1-GNU-Linux64.tar.gz\
./downloads/Stardis-0.12.3-Sources.tar.gz\
- ./downloads/Stardis-0.12.3-GNU-Linux64.tar.gz
+ ./downloads/Stardis-0.12.3-GNU-Linux64.tar.gz\
+ ./downloads/Stardis-0.13.1-Sources.tar.gz\
+ ./downloads/Stardis-0.13.1-GNU-Linux64.tar.gz
STARDIS_SIG=$(STARDIS_PKG:=.sig)
STARTER_PACK_DIR=Stardis-Starter-Pack-$(STARTER_PACK_VERSION)
diff --git a/stardis/downloads/Stardis-0.13.1-GNU-Linux64.tar.gz b/stardis/downloads/Stardis-0.13.1-GNU-Linux64.tar.gz
@@ -0,0 +1 @@
+#$# git-wad 9421db41dfbce49ec99c140bf8db165cb787a9c9e22d5ff905a0c5c63b183b84 20552224
+\ No newline at end of file
diff --git a/stardis/downloads/Stardis-0.13.1-Sources.tar.gz b/stardis/downloads/Stardis-0.13.1-Sources.tar.gz
@@ -0,0 +1 @@
+#$# git-wad b64abb6bd4aaa97eb70cba20a268ed7c6b72bec5ceef46d6ae1a911df32502fa 952312
+\ No newline at end of file
diff --git a/stardis/stardis.html.in b/stardis/stardis.html.in
@@ -144,13 +144,18 @@ on the following hypothesis:</p>
their temperature may vary with time. This hypothesis relies on the
assumption of perfectly agitated fluids.</li>
- <li><b>Radiation</b>: local radiative transfer is <b>linearised</b>, i.e.
- instead of writing the spectrally integrated net flux as a difference of
- temperatures to the power 4, it is assumed of the same form as the convective
- flux (as a difference of temperatures, multiplied by a radiative exchange
- coefficient). In order to be valid, this representation of radiative
- transfer exchanges requires that the temperature at any position and time is
- close enough to a known reference temperature.</li>
+ <li><b>Radiation</b>: local radiative transfer is solved by an <a
+ href="https://hal.archives-ouvertes.fr/tel-03266863/">iterative numerical
+ method</a> (Picard algorithm) that requires the knowledge of a reference
+ temperature field. At the basic level (one level of recursion), and using a
+ uniform reference temperature field, this algorithm translates into the
+ hypothesis of a linearized radiative transfer. Using a higher order or
+ recursion makes possible to converge the result closer to the solution of a
+ rigorous spectrally-integrated radiative transfer (a difference of
+ temperatures to the power 4 when integrated over the whole spectrum). The
+ higher the recursion order, the better will be the convergence of the
+ algorithm.</li>
+
</ul>
<div class="img" style="width: 18em;">
@@ -276,8 +281,11 @@ simulation is the tremendous improvement on computation time.</p>
<h2>Quick start</h2>
-<p>Download the desired archive of Stardis and verify its integrity against its
-<a href=../misc/pgp_signatures.html>PGP signature</a>. Then extract it:</p>
+<p>Pre-compiled versions of Stardis are distributed for the GNU/Linux system
+but <b>to enable distributed parallelism via MPI, you must compile Stardis on the
+target machine</b> (see below). To use a precompiled version, first download the
+desired archive of Stardis and check its integrity against its <a
+href=../misc/pgp_signatures.html>PGP signature</a>. Then extract it:</p>
<pre class="code">
$ wget https://www.meso-star.com/projects/stardis/downloads/\
@@ -293,7 +301,7 @@ the Stardis installation for the current shell priorly to the invocation of the
<code>stardis</code> program.</p>
<pre class="code">
-$ source ~/Stardis-${VERSION}-GNU-Linux64/etc/stardis.profile
+$ . ~/Stardis-${VERSION}-GNU-Linux64/etc/stardis.profile
$ stardis -h # Launch stardis
</pre>
@@ -317,12 +325,16 @@ Stardis framework.</p>
<h2 id=build>Build from sources</h2>
-<p>The Stardis framework can be built directly from its source trees. Note
-that the whole Stardis framework was successfully built on Windows 10 with
-Visual Studio Community 2019. However, we only officially support GNU/Linux 64
-bits and the build procedure is thus only given for this system. The simplest
-way to build Stardis from its sources is to rely on the <code>stardis</code>
-branch of the <a
+<p>The Stardis framework can be built directly from its source tree. Note that
+it is actually the only way to enable distributed parallelism via the Message
+Passing Interface specification, precompiled version of Stardis does not
+support MPI. We point out that the whole Stardis framework was successfully
+built on Windows 10 with Visual Studio Community 2019. However, we only
+officially support GNU/Linux 64 bits and the build procedure is thus only given
+for this system.</p>
+
+<p>The simplest way to build Stardis from its sources is to rely on the
+<code>stardis</code> branch of the <a
href="https://gitlab.com/meso-star/star-engine/tree/stardis">Star-Engine</a>
project: it provides CMake scripts that automate the download, the compilation
and the installation of Stardis. This build procedure assumes the following
@@ -330,7 +342,7 @@ prerequisites:</p>
<ul>
<li><a href=https://git-scm.com>git</a> source control.</li>
- <li><a href=https://gcc.gnu.org>GNU Compiler Collection</a> in version 4.9.2
+ <li><a href=https://gcc.gnu.org>GNU Compiler Collection</a> in version 4.8.4
or higher.</li>
<li><a href="https://cmake.org">CMake</a> in version 3 or higher.</li>
<li>Optionally, the <a href=https://asciidoc.org/>AsciiDoc</a>
@@ -346,10 +358,15 @@ procedure is summed up to:</p>
~ $ git clone -b Stardis-${VERSION} \
https://gitlab.com/meso-star/star-engine.git Stardis-${VERSION}
~ $ mkdir Stardis-${VERSION}/build; cd Stardis-${VERSION}/build
-~/Stardis-${VERSION}/build $ cmake ../cmake -DDEPLOY_STARDIS_CLI=ON
+~/Stardis-${VERSION}/build $ cmake ../cmake -DDEPLOY_STARDIS_CLI=ON -DENABLE_MPI=ON
~/Stardis-${VERSION}/build $ make
</pre>
+<p>Note that on CMake configuration step, we define the variables
+<code>DEPLOY_STARDIS_CLI</code> and <code>ENABLE_MPI</code> to enable the
+installation of the Stardis CLI tools and support for distributed parallelism
+via MPI.</p>
+
<h3>Run</h3>
<p>By default Stardis is installed in the <code>local</code> subdirectory of
diff --git a/stardis/stardis_build.sh b/stardis/stardis_build.sh
@@ -65,10 +65,12 @@ downloads()
| sed -e '1d' -e '$d')
app_release_notes=$(${markdown} "$2" \
| sed -n '/^<h2>Release notes<\/h2>/,/^<h2>License<\/h2>/p' \
- | sed -e '1d' -e '$d')
+ | sed -e '1d' -e '$d' \
+ | sed 's/<h2>Version 0.8<\/h2>/<h3>Version 0.8<\/h3>/') # Fix formatting
green_release_notes=$(${markdown} "$3" \
| sed -n '/^<h2>Release notes<\/h2>/,/^<h2>License<\/h2>/p' \
- | sed -e '1d' -e '$d')
+ | sed -e '1d' -e '$d' \
+ | sed 's/<h2>Version 0.4<\/h2>/<h3>Version 0.4<\/h3>/') # Fix formatting
print_downloads Stardis "Linux"
echo "<h2>Stardis-Solver Library release notes</h2>"
