Polylib - Polygon Management Library

OUTLINE

Polylib is a C++ class library to keep and to manage polygon data, and has following functions.

load and save polygon data. The supported file formats are STL and OBJ.
management of polygon data on distributed parallel environment.
search and retrieve polygon data
grouping by input parameter file (text parser format).
data movement and migration between subdomains.

SOFTWARE REQUIREMENT

Cmake
MPI library (option)
Text parsing library

INGREDIENTS

ChangeLog.md History of development CMakeLists.txt Makefile of cmake License.txt License of Polylib Readme.md This document cmake/ cmake modules doc/ Documents examples/ Example sources include/ Header files src/ Source files

HOW TO BUILD

Build

$ export CC=c_compiler CXX=c++_compiler F90=fortran_compiler FC=fortran_compiler
$ export PL_HOME=/hogehoge
$ mkdir BUILD
$ cd BUILD
$ cmake [options] ..
$ make
$ make test  // if test option is specified.
$ sudo make install

Options

-D INSTALL_DIR= Install_directory

Specify the directory that this library will be installed. Built library is installed at install_directory/lib and the header files are placed at install_directory/include.

-D real_type= {float | double}

Specify the type of floating point. If this option is omitted, the default is float.

-D with_MPI= {no | yes}

If you use an MPI library, specify with_MPI=yes, otherwise no or you can omit.

-D with_example= {no | yes}

Specify building example. The default is 'no'.

-D with_TP= Installed_directory

Specify the directory path that TextParser library is installed.

The default compiler options are described in cmake/CompilerOptionSelector.cmake file. See BUILD OPTION section in CMakeLists.txt in detail.

Configure Examples

INTEL/GNU/PGI compiler

$ cmake -DINSTALL_DIR=${PL_HOME}/Polylib -Dreal_type=float -Dwith_MPI=yes -Dwith_example=yes -Dwith_TP=${PL_HOME}/TextParser ..

FUJITSU compiler / FX10, FX100, K on login nodes (Cross compilation)

$ cmake -DINSTALL_DIR=${PL_HOME}/Polylib -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchain_fx10.cmake -Dreal_type=float -Dwith_MPI=yes -Dwith_example=yes -Dwith_TP=${PL_HOME}/TextParser ..

$ cmake -DINSTALL_DIR=${PL_HOME}/Polylib -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchain_fx100.cmake -Dreal_type=float -Dwith_MPI=yes -Dwith_example=yes -Dwith_TP=${PL_HOME}/TextParser ..

$ cmake -DINSTALL_DIR=${PL_HOME}/Polylib -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchain_K.cmake -Dreal_type=float -Dwith_MPI=yes -Dwith_example=yes -Dwith_TP=${PL_HOME}/TextParser ..

Note

On Fujitsu machines(fx10, K, fx100), confirm appropriate directrory path for compiler environment.
Before building, execute following command for clean. $ make distclean

TEST

If you specify the test option by -Dwith_example=yes, you can execute the intrinsic tests by;

$ make test or $ ctest
The detailed results are written in BUILD/Testing/Temporary/LastTest.log file. Meanwhile, the summary is displayed for stdout.

CONTRIBUTORS

Kenji Ono keno@{cc.kyushu-u.ac, riken, iis.u-tokyo.ac}.jp
Tomohiro Kawanabe tkawanab@iis.u-tokyo.ac.jp
Takehiro Tawara
Takashi Suzuki

avr-aics-riken/Polylib