Changes between Version 18 and Version 19 of WikiStart


Ignore:
Timestamp:
05/27/17 07:41:29 (6 months ago)
Author:
Chris Lautenberger
Comment:

Increment version number and add info about environment variables

Legend:

Unmodified
Added
Removed
Modified
  • WikiStart

    v18 v19  
    33Gpyro is an open source computer model that describes the thermal response of solid materials exposed to radiative or convective heating, including thermo-oxidative pyrolysis of the condensed phase.
    44
    5 Gpyro can be used for 0D, 1D, 2D, and 3D simulations and can write NIST Smokeview files for visualization of 2D and 3D simulations. Gpyro contains the physics necessary to simulate pyrolysis of thermoplastic and charring solids, intumescent coatings, and smolder in porous media. It can be applied as a boundary condition in a modified version of FDS6 (disclaimer: Gpyro and its linking to FDS is in no way supported by or developed by NIST or VTT). Coupled to Gpyro is a material property estimation program that can be used to help estimate the required material properties from experimental data (Cone Calorimeter or similar, thermogravimetric analysis, and differential scanning calorimetry). At the present time, brute force search, genetic algorithm optimization, genetic algorithm/simulated annealing, stochastic hillclimber, and shuffled complex evolution optimization methods are available.
     5Gpyro can be used for 0D, 1D, 2D, and 3D simulations and can write NIST Smokeview files for visualization of 2D and 3D simulations. Gpyro contains the physics necessary to simulate pyrolysis of thermoplastic and charring solids, intumescent coatings, and smolder in porous media. It can be applied as a boundary condition in a modified version of FDS6 (disclaimer: Gpyro and its linking to FDS is in no way supported by or developed by NIST or the FDS developers). Coupled to Gpyro is a material property estimation program that can be used to help estimate the required material properties from experimental data (Cone Calorimeter or similar, thermogravimetric analysis, and differential scanning calorimetry). At the present time, brute force search, genetic algorithm optimization, genetic algorithm/simulated annealing, stochastic hillclimber, and shuffled complex evolution optimization methods are available.
    66
    77=== Installation ===
    88
    9 The Gpyro software consists of three separate executable files (standalone, property estimation, and FDS/Gpyro) so it isn't really necessary to "install" Gpyro. The easiest way to get started is to download a .zip file containing the Gpyro repository and executables. Gpyro Version 0.8175 (current as of April 26, 2017) can be downloaded at http://reaxengineering.com/media/gpyro/gpyro_0.8175.zip. This archive includes Windows executables but it does not include linux executables because it's difficult to build portable linux executables due to libray incompatibilites across linux distributions and versions. The property estimation and coupled FDS/Gpryo Windows executables are currently compiled against MS-MPI v7 (https://msdn.microsoft.com/en-us/library/windows/desktop/bb524831(v=vs.85).aspx). To run the property estimation or FDS/Gpyro programs in Windows you will have to install MS-MPI. To visualize 2D and 3D simulations, you will also need to install NIST Smokeview, which can be downloaded from https://pages.nist.gov/fds-smv/downloads.html.
     9The Gpyro software consists of three separate executable files (standalone, property estimation, and FDS/Gpyro) so it isn't really necessary to "install" Gpyro. The easiest way to get started is to download a .zip file containing the Gpyro repository and executables. Gpyro Version 0.8178 (current as of May 26, 2017) can be downloaded at http://reaxengineering.com/media/gpyro/gpyro_0.8178.zip. This archive includes Windows executables but it does not include linux executables because it's difficult to build portable linux executables due to library incompatabilites across linux distributions and versions. The property estimation and coupled FDS/Gpryo Windows executables are currently compiled against MS-MPI v8 (https://www.microsoft.com/en-us/download/details.aspx?id=54607). To run the property estimation or FDS/Gpyro programs in Windows you will have to install MS-MPI. To visualize 2D and 3D simulations, you will also need to install NIST Smokeview, which can be downloaded from https://pages.nist.gov/fds-smv/downloads.html.
    1010
    1111=== Building from source ===
     
    1919svn checkout svn://reaxengineering.com/gpyro
    2020cd ./gpyro/build/linux/
    21 sh make_gnu.sh
     21sh make_gnu.sh # or sh make_intel.sh
    2222}}}
    2323
    24 Depending on the configuration of your system or available compilers, you may have to modify the make scripts (make_gnu.sh, make_intel.sh) and/or the Makefiles. We use OpenMPI 1.10.3 (https://www.open-mpi.org/software/ompi/v1.10/downloads/openmpi-1.10.3.tar.gz) but it is possible to build with other MPI installations.
     24Depending on the configuration of your system or available compilers, you may have to modify the make scripts (make_gnu.sh, make_intel.sh) and/or the Makefiles. We use OpenMPI 1.10.3 (https://www.open-mpi.org/software/ompi/v1.10/downloads/openmpi-1.10.3.tar.gz) but it is possible to build with other MPI installations. The make scripts use several environment variables to specify compiler paths and the directory to which the built binaries will be copied, so you may wish to add lines similar to these to your ~/.bashrc file:
     25
     26{{{
     27export GPYRO_FCOMPL_SERIAL_INTEL=ifort
     28export GPYRO_FCOMPL_MPI_INTEL=/usr/local/openmpi-1.10.3_intel/bin/mpifort
     29export GPYRO_FCOMPL_SERIAL_GNU=gfortran
     30export GPYRO_FCOMPL_MPI_GNU=/usr/local/openmpi-1.10.3_gnu/bin/mpifort
     31export GPYRO_BINARY_DIRECTORY=/usr/local/bin
     32}}}
    2533
    2634=== Documentation ===
     
    3038=== Sample calculations ===
    3139
    32 A logical place to get started is the sample calculations included in the source repository. These can be found in the "samples" folder. In windows, you can run the samples by executing run_samples.bat, and under linux by executing the samples run_samples.sh.
     40A logical place to get started is the sample calculations included in the source repository. These can be found in the "samples" folder. In windows, you can run the samples by executing run_samples.bat, and under linux by executing the samples run_samples.sh. Like the build scripts, the run_samples.sh script uses several environment variables so if the default values are not appropriate for your system you will have to put some lines such as this in your ~/.bashrc file:
     41
     42{{{
     43export GPYRO_BINARY_DIRECTORY=/usr/local/bin
     44export GPYRO_MPIRUN=/usr/local/openmpi-1.10.3_gnu/bin/mpirun
     45export GPYRO_COMPILER=gnu # Set to 'gnu' or 'intel'
     46export GPYRO_DEBUG=no # Set to 'yes' or 'no'
     47}}}
    3348
    3449=== General questions, bug reports, and feature/enhancement requests ===