========
Tutorial                                                                [TOC]
========

FLENS has many great features.  Looking through all the examples given in
this tutorial should give you a first impression and a quick start.

More tutorials are on the way ...

... so stay tuned.


Session: General Matrix with Full Storage
=========================================

 *--[BOX]--------------------------------------------------------------------*
 |                                                                           |
 |                                                                           |
 |    - __Page 1__: We show how to allocate and initialize a general matrix. |
 |    - __Page 2__: Shows how to change the default index base which is One  |
 |    - __Page 3__: We introduce the concept of matrix views.  Matrix views  |
 |      can be used to reference other matrix parts.  Furthermore it allows  |
 |      the creation of a FLENS matrix(view) from an existing C-array        |
 |      copying the C-array. The latter is very useful for interfacing with  |
 |      other libraries.                                                     |
 |    - __Page 4__: We introduce dense vectors.                              |
 |                                                                           |
 *---------------------------------------------------------------------------*

:links: __Page (\d)__       -> doc:flens/examples/tut01-page0$1


Session:  BLAS, CXXBLAS, FLENS-BLAS and Overloaded Operators
============================================================

 *--[BOX]--------------------------------------------------------------------*
 |                                                                           |
 |    - __Page 1__: Using __CXXBLAS__ directly.  CXXBLAS provides a generic  |
 |      BLAS implementation but also can serve as a interface to high        |
 |      performance BLAS implementations.                                    |
 |    - __Page 2__: Using __FLENS-BLAS__ which is a high-level interface to  |
 |      CXXBLAS.                                                             |
 |    - __Page 3__: Using overloaded operators for BLAS operations.  This    |
 |      is an even higher-level BLAS interface.  FLENS has some nice feature |
 |      that allows logging how BLAS actually gets used for the evaluation   |
 |      of complex linear algebra operations.                                |
 |    - __Page 4__: How FLENS helps you avoiding the creation of temporaries |
 |      when evaluation linear algebra expressions.                          |
 |                                                                           |
 *---------------------------------------------------------------------------*

:links: __Page (\d)__   -> doc:flens/examples/tut02-page0$1
        __CXXBLAS__     -> dir:cxxblas/
        __FLENS-BLAS__  -> doc:flens/blas/blas


Session: Symmetric and Triangular Matrices with Full Storage
============================================================

 *--[BOX]--------------------------------------------------------------------*
 |                                                                           |
 |    - __Page 1__: We show how to create triangular and symmetric views     |
 |      from a general matrix.                                               |
 |                                                                           |
 *---------------------------------------------------------------------------*

:links: __Page (\d)__     -> doc:flens/examples/tut03-page0$1


Session: FLENS-LAPACK
=====================

 *--[BOX]--------------------------------------------------------------------*
 |                                                                           |
 |    - __Page 1__: Computing a LU factorization.                            |
 |    - __Page 2__: Computing a QR factorization.                            |
 |    - __Page 3__: Solving systems of linear equations.                     |
 |    - __Page 4__: Computing eigenvalues and eigenvectors.                  |
 |                                                                           |
 *---------------------------------------------------------------------------*

:links: __Page (\d)__     -> doc:flens/examples/tut04-page0$1


Session: Define your own Matrix/Vector Types
============================================

 *--[BOX]--------------------------------------------------------------------*
 |                                                                           |
 |    - __Page 1__: Permutation Matrix.                                      |
 |    - __Page 2__: Matrix representing a (discrete) differential operator.  |
 |                                                                           |
 *---------------------------------------------------------------------------*

:links: __Page (\d)__     -> doc:flens/examples/tut05-page0$1

Session: Kick-Ass Interface for FLENS-LAPACK
============================================

 *--[BOX]--------------------------------------------------------------------*
 |                                                                           |
 |    - __Page 1__: LU Factorization `tupel(P,L,U) = lu(A)`                  |
 |                                                                           |
 *---------------------------------------------------------------------------*

:links: __Page (\d)__     -> doc:flens/examples/tut06-page0$1