meso-web

Sources of the |Méso|Star> website
git clone git://git.meso-star.fr/meso-web.git
Log | Files | Refs | README | LICENSE

commit 78ac7820876b58f4c21c3570425517a494431609
parent 44b3cfed2a86fe93a975c8cdeed229a4c72d3443
Author: Vincent Forest <vincent.forest@meso-star.com>
Date:   Fri, 24 May 2019 16:10:52 +0200

Add a components menu to the Star-Engine section

Diffstat:
M.gitignore | 6++++++
Mart/hr_ppart.html.in | 6+++++-
Mart/karine.html.in | 6+++++-
Mart/kdistribution.html.in | 6+++++-
Mart/kspectrum.html.in | 6+++++-
Mart/ppart_lw.html.in | 6+++++-
Mart/ppart_sw.html.in | 5++++-
Mhigh-tune/high-tune.html.in | 6+++++-
Mmeso-menu.sh | 21+++++++++++++++++++++
Mmeso.css | 8++++++++
Mschiff/schiff.html.in | 6+++++-
Msolstice/solstice.html.in | 6+++++-
Astar-engine/star-2d.html.in | 46++++++++++++++++++++++++++++++++++++++++++++++
Mstar-engine/star-3d.html.in | 29++++++++++++++++++++---------
Mstar-engine/star-engine.html.in | 73++++++++++++++++---------------------------------------------------------
Mstar-engine/star-engine.sh | 63+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Astar-engine/star-geom.html.in | 71+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Astar-engine/star-sf.html.in | 48++++++++++++++++++++++++++++++++++++++++++++++++
Astar-engine/star-sp.html.in | 58++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Astar-engine/star-vx.html.in | 48++++++++++++++++++++++++++++++++++++++++++++++++
Mstardis/stardis.html.in | 6+++++-
21 files changed, 454 insertions(+), 76 deletions(-)

diff --git a/.gitignore b/.gitignore @@ -19,6 +19,12 @@ solstice-pp-release-notes.html.in star-engine.html star-engine-downloads.html star-engine-release-notes.html.in +star-2d.html +star-3d.html +star-geom.html +star-sf.html +star-sp.html +star-vx.html downloads/ .htaccess *.sw[po] diff --git a/art/hr_ppart.html.in b/art/hr_ppart.html.in @@ -1,5 +1,9 @@ <header> - <h1>High-Resolution Plane-Parallel atmospheric radiative transfer</h1> + <h1>HR PPart + <div class=subtitle> + High-Resolution Plane-Parallel atmospheric radiative transfer + </div> + </h1> </header> <div class="news"> diff --git a/art/karine.html.in b/art/karine.html.in @@ -1,5 +1,9 @@ <header> - <h1>Karine - K-distribution Atmospheric Radiation & Infrared Net Exchanges</h1> + <h1>Karine + <div class=subtitle> + K-distribution Atmospheric Radiation & Infrared Net Exchanges + </div> + </h1> </header> <div class="news"> diff --git a/art/kdistribution.html.in b/art/kdistribution.html.in @@ -1,5 +1,9 @@ <header> - <h1>Kdistribution - production of k-distribution data sets</h1> + <h1>Kdistribution + <div class=subtitle> + Production of k-distribution data sets + </div> + </h1> </header> <div class="news"> diff --git a/art/kspectrum.html.in b/art/kspectrum.html.in @@ -1,5 +1,9 @@ <header> - <h1>Kspectrum - molecular absorption spectra for arbitrary gas mixtures.</h1> + <h1>Kspectrum + <div class=subtitle> + Molecular absorption spectra for arbitrary gas mixtures + </div> + </h1> </header> <div class="news"> diff --git a/art/ppart_lw.html.in b/art/ppart_lw.html.in @@ -1,5 +1,9 @@ <header> - <h1>Plane-Parallel atmospheric radiative transfer&nbsp;- LongWave</h1> + <h1>PPart LW + <div class=subtitle> + Plane-Parallel atmospheric radiative transfer - LongWave + </div> + </h1> </header> <div class="news"> diff --git a/art/ppart_sw.html.in b/art/ppart_sw.html.in @@ -1,5 +1,8 @@ <header> - <h1>Plane-Parallel atmospheric radiative transfer&nbsp;- ShortWave + <h1>PPart SW + <div class=subtitle> + Plane-Parallel atmospheric radiative transfer - ShortWave + </div> </h1> </header> diff --git a/high-tune/high-tune.html.in b/high-tune/high-tune.html.in @@ -1,5 +1,9 @@ <header> - <h1>HTRDR - Image renderer of cloudy atmospheres</h1> + <h1>High Tune: RenDeRer + <div class=subtitle> + Image renderer of cloudy atmospheres + </div> + </h1> </header> <div class="news"> diff --git a/meso-menu.sh b/meso-menu.sh @@ -275,6 +275,13 @@ print_solstice_sub_menu() { print_star_engine_sub_menu() { local root=$1 local name=$2 + local components=( + "Star-3D Star-3D" + "Star-VX Star-VoXel" + "Star-2D Star-2D" + "Star-SP Star-SamPling" + "Star-SF Star-ScatteringFunctions" + "Star-Geom Geometric&nbsp;data") echo ' <div id=sub-menu>' echo ' <ul>' @@ -283,6 +290,20 @@ print_star_engine_sub_menu() { else echo " <li><a href=${root}star-engine/star-engine.html>Overview</a></li>" fi + echo ' <li>Components</li>' + echo ' </ul>' + echo ' <ul id=lvl2>' + local i + for((i=0; i < ${#components[@]}; ++i)); do + local entry=(${components[$i]}) + if [ "$name" == "${entry[0]}" ]; then + echo " <li id=cur>${entry[1]}</li>" + else + echo " <li><a href=${root}star-engine/$(echo ${entry[0]} | tr [:upper:] [:lower:]).html>${entry[1]}</a></li>" + fi + done + echo ' </ul>' + echo ' <ul>' if [ "$name" == "Downloads" ]; then echo ' <li id=cur>Downloads</li>' else diff --git a/meso.css b/meso.css @@ -10,9 +10,17 @@ body { h1 { /*text-align: right; */ + /*font-variant: small-caps;*/ padding-bottom: 0.3em; } +.subtitle { + font-variant: normal; + font-weight: normal; + font-size: 70%; + color: #777777; +} + h2 { border-bottom: 1px solid #aaaaaa; padding-top: 0.3em; diff --git a/schiff/schiff.html.in b/schiff/schiff.html.in @@ -1,5 +1,9 @@ <header> - <h1>Schiff - Radiative properties of soft particles</h1> + <h1>Schiff + <div class=subtitle> + Radiative properties of soft particles + </div> + </h1> </header> <div class="news"> diff --git a/solstice/solstice.html.in b/solstice/solstice.html.in @@ -1,5 +1,9 @@ <header> - <h1>Solstice - The solar plant simulation tool</h1> + <h1>Solstice + <div class=subtitle> + The solar plant simulation tool + </div> + </h1> </header> <div class="news"> diff --git a/star-engine/star-2d.html.in b/star-engine/star-2d.html.in @@ -0,0 +1,46 @@ +<header> + <h1>Star-2D + <div class=subtitle> + Manage 2D geometries + </div> + </h1> +</header> + +<div class="news"> + <p><b>Star-2D ${VERSION} is available</b></p> + <ul> + <li>Get source code: + <a href=https://gitlab.com/meso-star/star-2d/tree/${VERSION}>git</a> + </li> + </ul> +</div> + +<p>The Star-2D library implements the functionalities provided by <a +href="star-3d.html">Star-3D</a> for <b>2D shapes represented by a list of +segments</b>. It is actually the counterpart of Star-3D for 2D geometries. Its +main targets are programmers that have to deal with <b>complex 2D +environments</b>.</p> + +<p>The Star-2D API is roughly the same of the <a +href="star-3d.html">Star-3D</a> one. It provides <b>uniform sampling</b> and +<b>ray-tracing</b> operators while still relying on <a +href="https://software.intel.com/en-us/rendering-framework">Intel(R) Rendering +Framework:</a> <a href=https://embree.github.io>Embree</a> to ensure high +ray-tracing efficiency.</p> + +<p>It also supports multiple scene <b>views</b>. Each view stores the current +data of a scene that can be then sampled and ray-traced. A view is insensitive +to scene updates following its creation. This means that several views can +store different state of a same scene, giving to the caller a great flexibility +to manage its geometric data.</p> + +${RELEASE_NOTES} + +<h2>License</h2> + +<p>Copyright &#169; 2015-2019 <a +href="https://www.meso-star.com">|Meso|Star&gt;</a>. Star-3D is free software +released under CeCILL v2.1 license. You are welcome to redistribute it under +certain conditions; refer to the <a +href="https://cecill.info/licences/Licence_CeCILL_V2.1-en.html">license</a> for +details.</p> diff --git a/star-engine/star-3d.html.in b/star-engine/star-3d.html.in @@ -1,15 +1,26 @@ <header> - <h1>Star-3D</h1> + <h1>Star-3D + <div class=subtitle>Manage 3D geometries</div> + </h1> </header> -<p>The Star-3D library <b>manages surfacic geometries</b> and provides +<div class="news"> + <p><b>Star-3D ${VERSION} is available</b></p> + <ul> + <li>Get source code: + <a href=https://gitlab.com/meso-star/star-3d/tree/${VERSION}>git</a> + </li> + </ul> +</div> + +<p>The Star-3D C library <b>manages surfacic geometries</b> and provides operators to access them efficiently like <b>uniform sampling</b> or <b>ray-tracing</b>. To ensure high ray-tracing efficiency, Star-3D internally relies on <a href="https://software.intel.com/en-us/rendering-framework">Intel(R) Rendering -Framework]():</a><a href=https://embree.github.io>Embree</a> that provides +Framework:</a> <a href=https://embree.github.io>Embree</a> that provides highly optimized ray-tracing kernels for a wide range of data workloads. The -main target of Star-3D are programmers that want to efficiently handle +main targets of Star-3D are programmers that want to efficiently handle <b>complex and arbitrary 3D content</b>.</p> <p>The main concept exposed in Star-3D is the <b>shape</b>. A shape represents a @@ -17,14 +28,14 @@ main target of Star-3D are programmers that want to efficiently handle and can be updated at any time. A virtual environment is built by attaching one or several shapes to a <b>scene</b>. A scene can be <b>instantiated</b> into one or several shapes that can be then attached to a scene as any regular -shapes. Each instance has its own position and orientation while the +shapes. Each instance has its own position and orientation while the instantiated geometry is stored once even though it is instantiated several times. This feature can thus be used to create extremely complex environment with a low memory footprint.</p> <p>To access the scene data through uniform sampling or ray-tracing, one has to create a <b>view</b> of the scene. On its creation, the view internally builds -data structures required by the aforementionned access operators. This data +data structures required by the aforementioned access operators. This data structure are built from the scene geometry as defined at the moment of the view creation; a view is thus insensitive to scene updates following its creation. This means that several views can be used to register different @@ -36,8 +47,8 @@ ${RELEASE_NOTES} <h2>License</h2> <p>Copyright &#169; 2015-2019 <a -href="https://www.meso-star.com">|Meso|Star&gt;.</a> Star-3D is free software -released under CeCILL v2.1 license. You are also welcome to redistribute it -under certain conditions; refer to the <a +href="https://www.meso-star.com">|Meso|Star&gt;</a>. Star-3D is free software +released under CeCILL v2.1 license. You are welcome to redistribute it under +certain conditions; refer to the <a href="https://cecill.info/licences/Licence_CeCILL_V2.1-en.html">license</a> for details.</p> diff --git a/star-engine/star-engine.html.in b/star-engine/star-engine.html.in @@ -1,5 +1,9 @@ <header> - <h1>Star-Engine - A framework for Monte-Carlo solvers</h1> + <h1>Star-Engine + <div class=subtitle> + A framework for Monte-Carlo solvers + </div> + </h1> </header> <div class="news"> @@ -19,7 +23,7 @@ for engineers and researchers who wish to use the <b>Monte-Carlo</b> method in order to perform numerical simulations. The Monte-Carlo method is indeed the only numerical method suitable to solve <b>high-dimensional</b> integrals even -if an <b>higly complex 3D scene</b> or many <b>coupled phenomena</b> have to be +if an <b>highly complex 3D scene</b> or many <b>coupled phenomena</b> have to be considered. <p>On paper, such complex situations are easily handled: physicists will @@ -37,64 +41,13 @@ between a Monte-Carlo algorithm that exists only as a mathematical expression and the actual numerical simulation code that uses this algorithm in order to evaluate the solution.</p> -<h2>Star-Engine components</h2> - -<p>Star-Engine is a collection of <b>C libraries</b> available for the x86-64 -architecture on GNU/Linux as well as Microsoft Windows 7 and later. It is -<b>free software</b> released under <a -href=https://en.wikipedia.org/wiki/Copyleft>copyleft</a> licenses. You are -welcome to redistribute them under certain conditions. Refer to their -associated license for details.</p> - -<p>The core components of the Star-Engine framework and their functionalities -are briefly described below:</p> - -<ul> - <li> - The <a href=https://gitlab.com/meso-star/star-sp.git>Star-SamPling</a> - library implements a set of [Pseudo] <b>Random Number Generators</b> and - <b>random variates</b> useful in the development of Monte-Carlo solvers - which heavily rely on distributions of random variables. - </li><li> - <a href="https://gitlab.com/meso-star/star-mc.git">Star-MonteCarlo</a> - makes simpler the development of efficient Monte-Carlo solvers by providing - multi-threaded integration of user defined integrands. - </li><li> - The <a href=https://gitlab.com/meso-star/star-3d.git>Star-3D</a> and - <a href=https://gitlab.com/meso-star/star-2d.git>Star-2D</a> libraries - manage <b>3D</b> or <b>2D</b> geometries and provide functionalities to - efficiently access them through <b>ray-tracing</b> or <b>sampling</b>. The - ray-tracing functionalities are internally powered by <a - href=https://software.intel.com/sdvis>Intel® Rendering Framework</a>: <a - href=http://embree.github.io/>Embree</a>. - </li><li> - <a href="https://gitlab.com/meso-star/star-3daw.git">Star-3DAW</a> - and <a href="https://gitlab.com/meso-star/star-3dstl.git">Star-3DSTL</a> - generate Star-3D shapes from geometries saved in the Alias Wavefront obj - and <b>ST</b>ereo <b>L</b>ithography file formats, respectively. This - simplifies the use of Star-3D with geometries exported from CAD software. - </li><li> - <a - href="https://gitlab.com/meso-star/star-3dut.git">Star-3DUtilityToolkit</a> - provides functions to generate the triangular mesh of several shapes, like - cylinder, sphere, supershapes <i>etc.</i> - </li><li> - <a href="https://gitlab.com/meso-star/star-vx.git">Star-VoXel</a> manages - volume elements hierarchically structured as a set of axis aligned cuboids, - that can be efficiently accessed and ray-traced. - </li><li> - <a - href="https://gitlab.com/meso-star/star-sf.git">Star-ScatteringFunctions</a> - implements a set of <b>B</b>idirectional <b>S</b>cattering - <b>D</b>istribution <b>F</b>unctions and phase functions to describe - angular distribution of light relected from an interface or a body when - illuminated from a specific direction. - </li> -</ul> +<p>Star-Engine is <b>a collection of C libraries</b> available for the x86-64 +architecture on GNU/Linux as well as Microsoft Windows 7 and later. Refer to +the <code>Components</code> menu for an overview of its main libraries.</p> <h2>Related projects</h2> -<p>The following software make use of Star-Engine to implement Monte-Carlo +<p>The following applications make use of Star-Engine to implement Monte-Carlo solvers for a wide range of purposes. Refer to the their associated documentation for more informations.</p> @@ -115,6 +68,12 @@ documentation for more informations.</p> <h2>Quick start</h2> +While +one can install and use each component separately, the canonical way is to +deploy them through a <a href="star-engine-downloads.html">specific version</a> +of the Star-Engine that packages the different libraries to ensure their +reciprocal compatibilities.<p> + <p>Download the desired Star-Engine binary archive and check its integrity against its <a href=../misc/pgp_signatures.html>PGP signature</a>. Then extract it. You can alternatively install Star-Engine directly from source. Visit the diff --git a/star-engine/star-engine.sh b/star-engine/star-engine.sh @@ -81,6 +81,15 @@ $markdown $2 \ > star-engine-release-notes.html.in ################################################################################ +# Extract the current archive +################################################################################ +cd $dir_temp +arch=Star-Engine-$1-GNU-Linux64 +cp "$dir_curr/downloads/$arch.tar.gz" . +tar xzf $arch.tar.gz +cd $dir_curr + +################################################################################ # Generate the overview page ################################################################################ unset win @@ -98,6 +107,60 @@ echo "Write star-engine.html" } > star-engine.html ################################################################################ +# Generate the components pages +################################################################################ +components=( + "Star-2D star/s2d_version.h" + "Star-3D star/s3d_version.h" + "Star-SP star/ssp_version.h" + "Star-SF star/ssf_version.h" + "Star-VX star/svx_version.h") + +print_version() { + local header=$1 + major=$(cat $dir_temp/$arch/include/$header | sed -n 's/.*MAJOR \(.*\)$/\1/1p') + minor=$(cat $dir_temp/$arch/include/$header | sed -n 's/.*MINOR \(.*\)$/\1/1p') + patch=$(cat $dir_temp/$arch/include/$header | sed -n 's/.*PATCH \(.*\)$/\1/1p') + [[ $patch == "0" ]] && echo $major.$minor || echo $major.$minor.$patch +} + +for ((i=0; i< ${#components[@]}; ++i)); do + entry=(${components[$i]}) + entry_low=$(echo ${entry[0]} | tr [:upper:] [:lower:]) + + release_notes=$($markdown $dir_temp/$arch/share/doc/$entry_low/README.md \ + | sed '/^<h2>Release notes<\/h2>/,$!d' \ + | sed '/^<h2>License[s]*<\/h2>/,$d') + version=$(print_version ${entry[1]}) + + echo "Write $entry_low.html" + { + print_header Star-Engine ${entry[0]} + VERSION=$version RELEASE_NOTES="$release_notes" envsubst < $entry_low.html.in; + print_footer + } > $entry_low.html +done + + +aw_version=$(print_version aw_version.h) +s3daw_version=$(print_version star/s3daw_version.h) +s3dstl_version=$(print_version star/s3dstl_version.h) +s3dut_version=$(print_version star/s3dut_version.h) +sstl_version=$(print_version star/sstl_version.h) + +echo "Write star-geom.html" +{ + print_header Star-Engine Star-Geom + AW_VERSION=$aw_version \ + S3DAW_VERSION=$s3daw_version \ + S3DSTL_VERSION=$s3dstl_version \ + S3DUT_VERSION=$s3dut_version \ + SSTL_VERSION=$sstl_version \ + envsubst < star-geom.html.in; + print_footer +} > star-geom.html + +################################################################################ # Generate the Downloads page ################################################################################ echo "Write star-engine-downloads.html" diff --git a/star-engine/star-geom.html.in b/star-engine/star-geom.html.in @@ -0,0 +1,71 @@ +<header> + <h1>Geometric data + <div class=subtitle>Generate and load geometric data</div> + </h1> +</header> + +<div class="news"> + <p><b>Repositories</b></p> + <ul> + <li> + AW ${AW_VERSION}: + <a href=https://gitlab.com/vaplv/loader_aw/tree/${AW_VERSION}>git</a> + </li><li> + Star-3DAW ${S3DAW_VERSION}: + <a href=https://gitlab.com/meso-star/star-3daw/tree/${S3DAW_VERSION}>git</a> + </li><li> + Star-3DSTL ${S3DSTL_VERSION}: + <a href=https://gitlab.com/meso-star/star-3dstl/tree/${S3DSTL_VERSION}>git</a> + </li><li> + Star-3DUT ${S3DUT_VERSION}: + <a href=https://gitlab.com/meso-star/star-3dut/tree/${S3DUT_VERSION}>git</a> + </li><li> + Star-STL ${SSTL_VERSION}: + <a href=https://gitlab.com/meso-star/star-stl/tree/${SSTL_VERSION}>git</a> + </li> + </ul> +</div> + +<p>To help in dealing with complex geometric data, Star-Engine provides a set +of <b>utility libraries</b> to generate shapes or to load them from files.</p> + +<p><a href="https://gitlab.com/meso-star/star-3dut">Star-3DUtilityToolkit</a> +is a C library that provides a collection of functions to <b>generate +triangular meshes</b> of several shapes. For instance one can build +[hemi]spheres, cylinders, cuboids or super shapes, all with an optional +thickness, <i>etc.</i>. The resulting triangular meshes are structured as a +list of <b>indexed vertices</b> that can be directly accessed by the +caller.</p> + +<p>The <a href="https://gitlab.com/vaplv/loader_aw">AW</a> and <a +href="https://gitlab.com/meso-star/star-stl">Star-STL</a> libraries load meshes +saved in the Alias Wavefront <b>OBJ</b> file format and <b>STereo +Lithography</b> file format, respectively. The loaded data are exposed to the +user according to the file format logic: the OBJ meshes are grouped with +respect to different criteria (material group, smooth group, <i>etc.</i>) while +the mesh of an STL is exposed as a list of triangles. + +<p>The <a href="https://gitlab.com/meso-star/star-3daw">Star-3DAW</a> and <a +href="https://gitlab.com/meso-star/star-3dstl">Star-3DSTL</a> libraries use the +two aforementioned libraries to load geometric data from an OBJ or an STL file, +respectively, to create <a href="star-3d.html">Star-3D</a> shapes. These shapes +can then be directly used in Star-3D to be ray-traced or sampled.</p> + +<h2>Licenses</h2> + +<ul> + <li>AW copyright &#169; 2013-2016 Vincent Forest.</li> + <li>Star-3DAW copyright &#169; 2015-2016 |Meso|Star&gt;.</li> + <li>Star-3DSTL copyright &#169; 2015-2018 |Meso|Star&gt;.</li> + <li>Star-3DUT copyright &#169; 2016-2017 |Meso|Star&gt;.</li> + <li>Star-STL copyright &#169; 2015-2016 |Meso|Star&gt;.</li> +</ul> + +<p>These libraries are free software: Star-STL, Star-3DAW and Star-STL are +released under the <a +href="https://cecill.info/licences/Licence_CeCILL_V2.1-en.html">CeCILL v2.1</a> +license while Star-3DUT and AW are release under the <a +href="https://www.gnu.org/licenses/gpl-3.0.html">GPLv3</a> and <a +href="https://www.gnu.org/licenses/lgpl-3.0.en.html">LGPLv3</a> licenses, +espectively. You are welcome to redistribute them under certain conditions; +refer to their license for details.</p> diff --git a/star-engine/star-sf.html.in b/star-engine/star-sf.html.in @@ -0,0 +1,48 @@ +<header> + <h1>Star-ScatteringFunctions + <div class=subtitle> + Simulate scattering effects at surfaces and in volumes + </div> + </h1> +</header> + +<div class="news"> + <p><b>Star-SF ${VERSION} is available</b></p> + <ul> + <li>Get source code: + <a href=https://gitlab.com/meso-star/star-sf/tree/${VERSION}>git</a> + </li> + </ul> +</div> + +<p>Star-ScatteringFunctions is a C library that provides abstraction to +describe <b>scattering effects at a surface</b> through Bidirectional +Scattering Distribution Functions (BSDF), microfacet distributions and fresnel +terms, and in a volume with <b>phase functions</b>. The main target of Star-SF +are programmers that have to evaluate or sampled these scattering effects.</p + +<p>The Star-SF API makes no reference to the implementation of the +aforementionned data structures. In addition, it publicly exposes their +<b>interface</b>. Consequently, the user can not only switch the BSDF, +microfacet distribution, fresnel term or phase function without any impact on +the application source code, but also he can provide its own implementations of +these structures while still relying on Star-SF in its simulation code.</p> + +<p>Beyond the legacy <b>specular</b> and <b>lambertion</b> reflections, Star-SF +implements several scattering functions, from the ones simulating <b>glossy +reflections</b> through microfacet distributions to BSDFs that handle specular +effects of an interface between <b>dieliectric media</b>. For volumetric +scattering, Star-SF provides built-in implementation of the Henyey &amp; +Greenstein and Rayleigh phase functions.</p> + +${RELEASE_NOTES} + +<h2>License</h2> + +<p> Copyright &#169; 2016-2018 <a +href="https://www.meso-star.com">|Meso|Star&gt;</a>. +Star-ScatteringFunctions is free software released under the GPL v3+ license: +GNU GPL version 3 or later. You are welcome to redistribute it under certain +conditions; refer to the <a +href="https://www.gnu.org/licenses/gpl-3.0.html">license</a> for details.</p> + diff --git a/star-engine/star-sp.html.in b/star-engine/star-sp.html.in @@ -0,0 +1,58 @@ +<header> + <h1>Star-SamPling + <div class=subtitle> + Random number generators &amp; random variates + </div> + </h1> +</header> + +<div class="news"> + <p><b>Star-SP ${VERSION} is available</b></p> + <ul> + <li>Get source code: + <a href=https://gitlab.com/meso-star/star-sp/tree/${VERSION}>git</a> + </li> + </ul> +</div> + +<p>The Star-SamPling library provides a set of <b>random number generators</b> +as well as a large collection of <b>random variates</b>. Its API is pure C and +the exposed functions make no reference to the actual generator used. One can +thus easely switch the generator without any impact on the application source +code.</p> + +<p>Star-SamPling proposes generators <b>well suited for use in simulation</b>: +they have extremely long periods and low correlation. In addition of regular +generators such as Mersen Twister or RANLUX, it relies on the <a +href="https://www.deshawresearch.com/resources_random123.html">Random123 +library</a> to provide <b>"counter based" generators</b> that satisfy rigourous +statistical testing.</p> + +<p>Beyond uniform distribution, Star-SamPling can be used to generate random +variates from exponental, gaussian or lognormal distributions. It also +implements uniform sampling of a triangle, a disk, a sphere, an hemisphere or a +circle as well as the cosine weighted sampling of an hemisphere or the sampling +of a sphere with respect to the Henyey &amp; Greenstein function.</p> + +<p>Star-SamPling provides the notion of <b>proxy</b> of a random number +generator. A proxy is used to split the random numbers of a generator in a set +of <code>N</code> partitions, where <code>N</code> is a user defined parameter. +Each partition is assigned to a generator that is actually a regular generator +regarding the Star-SamPling API. The main benefit is that such generators can +be used by different processes that <b>concurrently</b> participate to the same +simulation since in such situation each process must ensure that it relies on +its own set of random numbers. Star-SamPling is thus well suited to parallel +computations that use <b>message passing</b> and/or <b>shared memory</b> +communication models. + +${RELEASE_NOTES} + +<h2>License</h2> + +<p>Copyright &#169; 2015-2019 <a +href="https://www.meso-star.com">|Meso|Star&gt;</a>. Star-SamPling is free +software released under CeCILL v2.1 license. You are also welcome to +redistribute it under certain conditions; refer to the <a +href="https://cecill.info/licences/Licence_CeCILL_V2.1-en.html">license</a> for +details.</p> + diff --git a/star-engine/star-vx.html.in b/star-engine/star-vx.html.in @@ -0,0 +1,48 @@ +<header> + <h1>Star-VoXel + <div class=subtitle>Manage volumetric data</div> + </h1> +</header> + +<div class="news"> + <p><b>Star-VX ${VERSION} is available</b></p> + <ul> + <li>Get source code: + <a href=https://gitlab.com/meso-star/star-vx/tree/${VERSION}>git</a> + </li> + </ul> +</div> + +<p>Star-VoXel is a C library whose purpose is to <b>manage volumetric +elements</b>, named voxels, structured as a set of axis aligned cuboids. This +library does not know anything about the volumetric data that it handles: it +only provides data structures that partition voxels according to user criteria. +It also implements efficient ways to <b>index voxels</b> into the space +partitioning data structures or to access them through <b>ray-tracing</b>.</p> + +<p>Star-VoXel implements 2 hierarchical data structures: the <b>binary tree</b> +and the <b>octree</b> that are used to partition 1D or 3D data, respectively. +For both structures, data are partitionned following a bottom-top strategy: the +caller submits the raw data to Star-VoXel that it recursively structures from +the leaf (the user data) to to the root of the tree. The policies used to merge +input data as well as the merge operator itself are defined by the caller; +Star-VoXel settles for building the hierarchical structure only.</p> + +<p>The way data are accessed through indexing or ray-tracing can be finely +tuned by the caller. Beyond the probe position or the ray to trace, the user +can provide callbacks to stop the traversal at any hierarchy level, perform +computations at the traversed node, discard leafs, <i>etc.</i> This API gives +to the host application a <b>full control on the hierarchical data +structures</b> while its memory representation and its accessors are still +fully managed internally by Star-VoXel.</p> + +${RELEASE_NOTES} + +<h2>License</h2> + +<p>Copyright &#169; 2018 <a +href="https://www.meso-star.com">|Meso|Star&gt;</a>, Université Paul Sabatier. +Star-VoXel is free software released under the GPL v3+ license: GNU GPL version +3 or later. You are welcome to redistribute it under certain conditions; refer +to the <a href="https://www.gnu.org/licenses/gpl-3.0.html">license</a> for +details.</p> diff --git a/stardis/stardis.html.in b/stardis/stardis.html.in @@ -1,5 +1,9 @@ <header> - <h1>Stardis - The Monte-Carlo solver for coupled thermal problems</h1> + <h1>Stardis + <div class=subtitle> + The Monte-Carlo solver for coupled thermal problems + </div> + </h1> </header> <p>Stardis computes the <b>propagator</b> (aka the <b>Green function</b>) of