Introduction

‘tmech’ is a C++ library for the numerical study of the physics of continuous materials using higher-oder tensors.

tmech provides

• an extensible expression system enabling lazy evaluation.

• tmech is a high quality tensor algebra library for the C++ language, aiming towards a good balance between speed and ease of use.

• Integer and floating point numbers are fully supported, complex numbers are supported only for basic arithmetic operations.

• Provides high-level syntax and functionality for easy use.

• Can be used for solid mechanics, fluid mechanics, …

• isotropic tensor functions.

• compile-time differentiation of scalar and tensorial expressions

• many more…

tmech requires a modern C++ compiler supporting C++17. The following C++ compilers are supported:

• On Unix platforms, gcc 5 or a recent version of Clang

• On Windows platforms not tested

Licensing

This software is licensed under the Apache License, Version 2.0. See the LICENSE file for details.

INSTALLATION

• Install
  • From source with cmake
  • Including tmech in your project
• Changelog
  • 0.0.0

USAGE

• Getting started
  • First example
  • Compiling the first example
  • Building with cmake
  • Second example: single contraction
  • Third example: index access
• Expressions and lazy evaluation
  • Expressions
  • Lazy evaluation
  • Aliasing: temporary evaluation
  • Accessing elements
  • Expression interface
• Tensors as arrays
  • Internal memory layout
  • Performance

QUICK REFERENCE TMECH

• Basic arithmetic
  • Addition
  • Subtraction
  • Single contraction
  • Scalar update
• Basis rearrangement
  • General basis rearrangement
  • Transposition
  • Left basis transposition
• Outer product
  • General outer product
  • Dyadic product
  • Lower dyadic product
  • Upper dyadic product
• Inner product
  • General inner product
  • Double contraction
  • Fourth contraction
• Invers of a tensor
  • Second order tensors and fourth order tensors with minior-symmetry
  • Fully anisotropic tensors
• Volumetric and deviatoric parts
  • Volumetric part
  • Deviatoric part
• Symmetric and skew-symmetric parts
  • Symmetric part
  • Skew-symmetric part
• Isotropic tensor functions
  • General function
  • Square root
  • Exponential map
  • Logarithmic map
• Positive-negative decomposition
  • General method
  • Only positive part
  • Only negative part
• Eigen-decomposition
• Sign decomposition
• Polar decomposition
• Exponential map
• Numerical differentiation
  • Nonsymmetric input and result
  • Symmetric input and result
• Compare Operators
• Adapting pointers of raw memory
  • Adapting raw pointers Voigt’s notation
  • Adapting raw pointers full representation
• Converting to Voigt’s notation

API REFERENCE TMECH

• Tensors
  • Tensor
  • Adaptor
  • Identity
  • Zeros
  • Random normal
  • Random uniform
• Wrapper

API REFERENCE SYMDIFF

• Variable
• Wrappers