GGGGGGGGG      GGGG      GGGGGGGGG  GGGGGG   GGGGGG  GGGGGGGGGG
    GGGG            GGGG     GGGG        GGGGGG  GGGGGG  GGGG   GGGG
   GGGG         GGGGGGGGGGGG GGGGGGGGG   G GGGG  G GGGG GGGG    GGGG
   GGGG GGGGGG GGGGGGGGGGGGG GGGGGGGGGG GG GGGG GG GGGG GGGG   GGGGG
  GGGGG  GGGGG GGGGGGGGGGGG  GGGGGGGGG  GG GGGGGG GGGG  GGGG   GGGG
  GGGG   GGGG      GGGG           GGGG  GG  GGGG  GGGG  GGGG   GGGG
   GGGGGGGGGG      GGGG     GGGGGGGGG  GG   GGG   GGGG  GGGGGGGGGG

======================================================================
=====             Geometry plus Simulation modules               =====
=====                     version 20.12 Alpha                    =====
=====                   https://github.com/gismo                 =====
======================================================================

This repository includes an archived version of G+Smo (June 3rd, 2021) with the gsStructuralAnalysis and gsKLShell modules in version v21.6. It accompanies the paper H.M. Verhelst, M. Möller, J.H. Den Besten, A. Mantzaflaris, M.L. Kaminski (2021). Stretch-Based Hyperelastic Material Formulations for Isogeometric Kirchhoff-Love Shells with Application to Wrinkling (https://hal.archives-ouvertes.fr/hal-02890963v2).

To compile this specific archive and run all the examples, run the following commands

# Go to the directory where you cloned this repository
cd path/to/directory

# Create a build folder and execute CMake
make

# Go into the build folder and add the CMake options
cd build
cmake . -DCMAKE_CXX_STANDARD=17 -DCMAKE_BUILD_TYPE=Release -DGISMO_KLSHELL=ON -DGISMO_STRUCTURALANALYSIS=ON -DGISMO_WITH_SPECTRA=ON

The relevant examples are stored in gismo/extensions/gsStructuralAnalysis/examples/. To compule the examples, call

# inside the build directory
make <name of example>

To consequently run the examples,

# inside the build directory
./bin/<run command>

The run commands name of the examples all start with benchmark_ and can be found together with relevant run options in the subsections below.

benchmark_UniaxialTension -m <int> -I <int> -c <int>
# -m      <int Material>
#         1: Neo-Hookean,
#         2: Mooney-Rivlin,
#         4: Ogden (only with Implementation 3)
# -I      <int Implementation>
#         1: Analytical
#         2: Generalized
#         3: Spectral
# -c      <int Compressibility>
#         0: Incompressible
#         1: Compressible

benchmark_Balloon -m <int> -I <int> -c <int>
# -m      <int Material>
#         1: Neo-Hookean,
#         2: Mooney-Rivlin,
#         4: Ogden (only with Implementation 3)
# -I      <int Implementation>
#         1: Analytical
#         2: Generalized
#         3: Spectral

# Using the Arc-Length Method (ALM)
benchmark_FrustrumALM -M <int> -I <int> -t <int> -N <int>
# Using the Arc-Length Method (DC)
benchmark_FrustrumDC -M <int> -I <int> -t <int> -N <int>
# Options:
# -M      <int Material>
#         1: Neo-Hookean,
#         2: Mooney-Rivlin,
#         4: Ogden (only with Implementation 3)
# -I      <int Implementation>
#         1: Analytical
#         2: Generalized
#         3: Spectral
# -t      <int testCase>
#         0: Constant top edge
#         1: Variable top edge
# -N      <int Number of load steps>

benchmark_MaterialTest -M <int> -I <int> -t <int>
# -M      <int Mateial>
#         1: Neo-Hookean,
#         2: Mooney-Rivlin,
#         4: Ogden (only with Implementation 3)
# -I      <int Implementation>
#         1: Analytical
#         2: Generalized
#         3: Spectral
# -t      <int testCase>
#         1: Roohbakashan
#         2: Panaitescu

benchmark_MaterialTestConv -M <int> -I <int> -r <int> -e <int>
# -M      <int Material>
#         1: Neo-Hookean,
#         2: Mooney-Rivlin,
#         4: Ogden (only with Implementation 3)
# -I      <int Implementation>
#         1: Analytical
#         2: Generalized
#         3: Spectral
# -r      <Number of refinement steps>
# -e      <Number of order elevations (-e 0 gives order 1 splines)>

benchmark_Wrinkling -M <int> -I <int>
# -M      <int Material>
#         1: Neo-Hookean,
#         2: Mooney-Rivlin,
#         4: Ogden (only with Implementation 3)
# -I      <int Implementation>
#         1: Analytical
#         2: Generalized
#         3: Spectral

• Operating systems:

  • MS Windows
  • Linux
  • macOS

• Configuration: CMake 2.8.12 or newer.

• Compilers tested include recent versions of

  • AMD Optimizing C/C++ Compiler
  • AppleClang see here for OpenMP support
  • Clang
  • GNU GCC
  • Intel C++ compiler
  • Mingw64
  • MS Visual Studio C++
  • PGI C/C++ only with GISMO_WITH_OPENMP=OFF

• Compilers known to not work

  • Oracle Developer Studio fails to compile Eigen
  • IBM XLC C/C++ fails to compile Eigen

• Recommended:

  • Doxygen for generating documentation.
  • Paraview for visualization.

The compilation requires configuration using CMake at a new, empty folder (in-source builds are disabled).

• On Linux/macOS: A Unix makefile exists in the root source folder. Running make creates a sub folder named build and executes CMake and compilation inside that folder. Alternatively, choose your own build folder and execute CMake pointing to the sources.

• On MS Windows: MS Visual Studio has built-in CMake support since version 2015. Alternatively, you can run the cmake-gui tool (from an environment that is configured with your compiler) to generate makefiles (or Visual Studio project files). Then execute the make tool to launch compilation. Alternatively, use the QtCreator GUI and open the CMakeLists.txt file on the root folder to create a QtCreator project.

After successful compilation a dynamic library is created in ./lib and executable example programs are output at the ./bin subdirectory of the build folder.

Additionally, if Doxygen is available on the system one can execute (eg. on Linux):

make doc

to obtain the Doxygen documentation in HTML format. The main doxygen page is at ./doc/html/index.html.

More information at https://github.com/gismo/gismo/wiki

The available options are displayed at CMake configuration. Short description and default setting follows:

• CMAKE_BUILD_TYPE Release

  Available values are the standard CMake build configurations: Debug, Release, RelWithDebInfo, MinSizeRel.

• GISMO_COEFF_TYPE double

  The arithmetic type to be used for all computations. Available options include double, long double, float.

• GISMO_EXTRA_INSTANCE not set

  If set to one or more of the options available for GISMO_COEFF_TYPE the G+Smo library is compiled with extra arithmetic types enabled.

• GISMO_EXTRA_DEBUG OFF

  If set to ON additional debugging tools are enabled during compilation. These include checked iterators for GCC and MSVC compilers and call stack back-trace printout when a runtime exception occurs.

• GISMO_BUILD_LIB ON

  If enabled a dynamic library is created using GISMO_COEFF_TYPE arithmetic. A target for a static library named gismo_static is also created but not compiled by default.

• GISMO_BUILD_EXAMPLES ON

  If enabled the programs in the examples folder are compiled, and executables are created in build-folder/bin.

• GISMO_BUILD_UNITTESTS OFF

  If enabled the tests in the unittests folder are compiled, and an executable is created in build-folder/bin.

• GISMO_BUILD_AXL OFF

  If enabled the plugin for Axel modeler is compiled (requires Axel).

• GISMO_WITH_PSOLID OFF

  If enabled the extensions using functionalities of Parasolid geometric kernel are compiled (requires Parasolid).

• GISMO_WITH_ONURBS OFF

  If enabled the extension for reading and writing of Rhinoceros' 3DM is compiled.

• CMAKE_INSTALL_PREFIX (system dependent)

  The location for installation of the library, e.g. /usr/local on some Linux systems.

The source tree consists of the following sub-folders:

• src

Contains all source files. Code is partitioned into modules. Currently eleven modules are present as sub-folders:

• gsCore
• gsMatrix
• gsNurbs
• gsHSplines
• gsModeling
• gsAssembler
• gsSolver
• gsPde
• gsTensor
• gsIO
• gsUtils

• examples

  Examples of usage, small programs and tutorials.

• unittests

  Unittests for some parts of the codebase.

• filedata

  Data files in the XML format the G+Smo can read and write.

• extensions

  Optional additional features that can be compiled along G+Smo.

• plugins

  The plugins for:

  • Axel modeler
  • Rhinoceros' 3DM

• cmake

  Cmake configuration files.

• doc

  Files related to doxygen documentation.

The G+Smo library is distributed under the Mozilla Public License v2.0. (see LICENSE.txt).