dsmc-tools: DSMC toolkit for rarefied gas dynamics

[ bsd3, physics, program ] [ Propose Tags ]

CLI tools for dsmc library. README and examples are included in package distribution.

[Skip to Readme]

Downloads

dsmc-tools-0.1.0.1.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

DmitryDzhus

For package maintainers and hackage trustees

edit package information

Candidates

No Candidates

Versions [RSS]	0.1.0.0, 0.1.0.1
Dependencies	base (>=4 && <5), bytestring (>=0.10 && <0.11), cmdargs (>=0.10 && <0.11), ConfigFile (>=1.1 && <1.2), dsmc (>=0.1 && <0.2), gloss (>=1.7 && <1.8), gloss-raster (>=1.7 && <1.8), hslogger (>=1.2 && <1.3), mtl (>=2.1 && <2.2), repa (>=3.2 && <3.3), strict (>=0.3 && <0.4), transformers (>=0.3 && <0.4), vector (>=0.10 && <0.11) [details]
License	BSD-3-Clause
Author	Dmitry Dzhus
Maintainer	dima@dzhus.org
Category	Physics
Source repo	head: git clone https://github.com/dzhus/dsmc-tools/
Uploaded	by DmitryDzhus at 2012-11-24T23:00:48Z
Distributions	NixOS:0.1.0.1
Reverse Dependencies	1 direct, 0 indirect [details]
Executables	dsmc-runner, dsmc-caster
Downloads	1743 total (4 in the last 30 days)
Rating	(no votes yet) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs not available [build log] All reported builds failed as of 2016-11-11 [all 9 reports]

Readme for dsmc-tools-0.1.0.1

[back to package description]

This package provides CLI to dsmc library to perform rarefied gas flow
simulation. The tool is named `dsmc-runner`. Another tool,
`dsmc-caster` is used to render CSG bodies to check if the body
geometry is defined correctly.

Both programs can be run with `-?` flag to obtain usage informaiton
and help of command-line flags.

To run programs using multiple threads, specify `+RTS -N` flag.

Extra data files which are installed with this package can be found in
`share` directory used by Cabal.

* dsmc-runner

To perform a simulation, input parameters for DSMC must be defined in
«problem file», which uses INI-like format, see `example.prb` included
in the package.

To define the body (which is then referenced from the problem file),
`.geo` format is used, see `body.geo`, `smiley.geo` and `reentry2.geo`
for example.

The runner dumps macroscopic data in text format to the file specified
using `-m` option, which can be then analyzed using visualization
software like ParaView.

To sum up,

    $ dsmc-runner example.prb -m macro.txt +RTS -N

    2012-06-13 11:32:02 MSK: [DEBUG] Program started
    2012-06-13 11:32:02 MSK: [DEBUG] Using problem file: example.prb
    2012-06-13 11:32:02 MSK: [DEBUG] Macroscopic data output file: macro.txt
    2012-06-13 11:32:02 MSK: [DEBUG] Not writing ensemble data
    2012-06-13 11:32:02 MSK: [DEBUG] Using body definition file: ./reentry2.geo
    2012-06-13 11:32:02 MSK: [DEBUG] Starting simulation
    2012-06-13 11:32:04 MSK: [DEBUG] Not steady yet; particles count: 1662080
    2012-06-13 11:32:05 MSK: [DEBUG] Not steady yet; particles count: 1661946
    2012-06-13 11:32:06 MSK: [DEBUG] Not steady yet; particles count: 1662026
    …

* dsmc-caster
  
dsmc-caster is a program used to view bodies defined using `.geo`
format.

    $ dsmc-caster smiley.geo +RTS -N

Drag with left mouse button to rotate the object and mouse wheel to
zoom in/out. More command-line options are available, see usage help
with `-?` flag.