gismo

Other source code

v24.08.0

Download

     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               =====
=====                   https://github.com/gismo                 =====
======================================================================

Continuous Integration status

System	Status	More information
CDash		Report results from all builds
Appveyor		Windows MSVC 14.0
Circle CI		MacOS XCode 14.3 (x86_64/arm64)
Codeship
GitLab		Linux non-default configurations
GitHub Actions		Latest Linux/MacOS/Windows
GitLab-Inria		CI at Inria
GCC Farm	Status	Builders from the GCC Farm
OBS	binaries	Upstream package builds for many Linux distributions
Launchpad	binaries	Upstream package builds for Ubuntu distributions

This README file contains brief information. More details are found in the Wiki pages.

The latest revision of the code can be obtained using git (via https):

git clone https://github.com/gismo/gismo.git

or using subversion:

svn co https://github.com/gismo/gismo/trunk gismo

or as a tar.gz or zip file:

https://github.com/gismo/gismo/archive/stable.tar.gz
https://github.com/gismo/gismo/archive/stable.zip

Prerequisites

Operating systems:

MS Windows
Linux
macOS
FreeBSD

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.

Compilation

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:

To compile G+Smo natively, you can use MS Visual Studio which 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.
Another option is to install Windows Subsystem for Linux which:
lets developers install a Linux distribution [...] and use Linux applications, utilities, and Bash command-line tools directly on Windows, unmodified, without the overhead of a traditional virtual machine or dualboot setup.
Then you can download, compile and use G+Smo as if your were using a native Linux machine.

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

Optional modules

There is a number of optional modules that may be enabled.

Name	Description
gsOpenCascade	Extends functionality using OpenCascade
gsElasticity
gsKLShell
gsStructuralAnalysis

To enable e.g. gsSpectra and gsOpenCascade set the following option in CMake:

-D GISMO_OPTIONAL="gsSpectra;gsOpenCascade"

Configuration Options

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_WITH_XDEBUG 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_PLUGIN_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).
gsOpennurbs
Extension for reading and writing of Rhinoceros' 3DM.
CMAKE_INSTALL_PREFIX (system dependent)
The location for installation of the library, e.g. /usr/local on some Linux systems.