A FFT-based homogenization tool.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
cmake
demo
doc
gui
joss
lib
page/images
src
CMakeLists.txt
LICENSE
README.md
TUTORIAL.md
_config.yml
build.sh
codemeta.json

README.md

DOI

fibergen

A FFT-based homogenization tool.

  • FFT-based homogenization based on Lippmann-Schwinger equation with staggered grid approach (SchneiderOspaldKabel2015:1)
  • homogenization for linear elasticity, large deformations, Stokes flow and heat equation
  • C++, OpenMP multiprocessing, XML + Python scripting interface
  • laminate mixing for interfaces (KabelMerkertSchneider2014, SchneiderOspaldKabel2015:2)
  • mixed boundary conditions (Kabel2016)
  • generation of fibers distributions
  • use of tetrahedrical mesh geometries
  • arbitrarily many materials
  • reading of raw CT data (gzip compressed)
  • identification of homogenized material parameters
  • ...

Target Platform

The tool was developed and tested under Linux (Ubuntu). Other platforms such as Windows and MacOS might work but probably require adjustmest to the CMakeLists.txt file and some other small scripts.

Requirements

The following libraries are required, which are likely already installed on your system:

If unsure, continue with the installation and check the error messages of CMake.

Installation

  1. download source
git clone https://github.com/fospald/fibergen.git
  1. run build.sh, on error probably a library is missing
sh build.sh [optional CMake parameters]
  1. after successful build update your envirnoment variables:
export PATH=$PATH:$FIBERGEN/bin
export PYTHONPATH=$PYTHONPATH:$FIBERGEN/lib

where $FIBERGEN denotes your download directory.

Run

Enter the following command to run the GUI (with an optional project file to load)

fibergen-gui [project.xml]

In order to run a project file from the command line run

fibergen project.xml

You can also run some test routines using

fibergen --test

in order to perform some internal tests of math and operators.

Tutorial

Further information on how to use fibergen, can be found in the tutorial.

Troubleshooting

GUI Crash

There are known instances with QtWebKit which may result in a crash of the GUI. An re-installation of QtWebKit with an older version or use of the newer QtWebEngine (i.e. using the latest version of Qt) may resolve the issue. Alternatively you can run the GUI with the demo- and help- browser disabled by

fibergen-gui --disable-browser

All QtWebKit/QtWebEngine browser instances will then be replaced by simplified QTextBrowser instances.

Setting the Python version

If you get an error about "boost_python-pyXY" not found, try to figure out which Python version boost-python is compiled against byrunning

locate boost_python-py

and then modify the CMakeLists.txt accordingly

SET(PYTHON_VERSION_MAJOR X)
SET(PYTHON_VERSION_MINOR Y)

Installing boost-numeric-bindings

Only the header files are required. No configure/build needed.

cd install_dir
git clone http://git.tiker.net/trees/boost-numeric-bindings.git
export BOOSTNUMERICBINDINGS_DIR=$(pwd)/boost-numeric-bindings

Generating source code documentation

You can generate a Doxygen-based documentation by running

cd doc/doxygen
make (or just doxygen)
firefox html/index.html

Contributing

If you have any question, idea or issue please create an new issue in the issue tracker. If you want to contribute anything (e.g. demos) please contact me.

Acknowledgements

Felix Ospald gratefully acknowledges financial support by the German Research Foundation (DFG), Federal Cluster of Excellence EXC 1075 "MERGE Technologies for Multifunctional Lightweight Structures". Many thanks to Matti Schneider for his helpful introduction to FFT-based homogenization and ideas regarding the ACG distribution.