A more descriptive documentation for the TransformationBase classes.

git-svn-id: https://svn.dealii.org/trunk@29371 0785d39b-7218-0410-832d-ea1e28bc413d

diff --git a/deal.II/include/deal.II/lac/slepc_solver.h b/deal.II/include/deal.II/lac/slepc_solver.h
index d28d46c02801b5b2c1d7d2861c5fdcbb5e807d7b..595843a5d08320d6f17bd17fda43d599d5bab77a 100644 (file)
--- a/deal.II/include/deal.II/lac/slepc_solver.h
+++ b/deal.II/include/deal.II/lac/slepc_solver.h
@@ -57,7 +57,6 @@ DEAL_II_NAMESPACE_OPEN
  * @endcode
  * for the generalized eigenvalue problem $Ax=B\lambda x$, where the
  * variable <code>const unsigned int size_of_spectrum</code> tells
-
  * SLEPc the number of eigenvector/eigenvalue pairs to solve
  * for. Additional options and solver parameters can be passed to the
  * SLEPc solvers before calling <code>solve()</code>. For example, if

diff --git a/deal.II/include/deal.II/lac/slepc_spectral_transformation.h b/deal.II/include/deal.II/lac/slepc_spectral_transformation.h
index 4b8683408bfcfb0f88118b7eaea121dd3deb9e66..c33a99bb9b6581d34f718e22755485be422b9f7f 100644 (file)
--- a/deal.II/include/deal.II/lac/slepc_spectral_transformation.h
+++ b/deal.II/include/deal.II/lac/slepc_spectral_transformation.h
@@ -36,8 +36,28 @@ namespace SLEPcWrappers
    * solvers which are selected based on flags passed to the spectral
    * transformation.
    *
+   * <code>SLEPcWrappers::TransformationXXX</code>, where
+   * <code>XXX</code> is your favourite transformation type, can then
+   * be implemented in application codes in the following way for
+   * <code>XXX=INVERT</code> with the solver object
+   * <code>eigensolver</code>:
+   * @code
+   *  // Set a transformation, this one shifts the eigenspectrum by 3.142..
+   *  SLEPcWrappers::TransformationShift::AdditionalData additional_data (3.142); 
+   *  SLEPcWrappers::TransformationShift shift (additional_data);
+   *  eigensolver.set_transformation (shift);
+   * @endcode
+   * and later calling the <code>solve()</code> function as usual:
+   * @code
+   *  SolverControl solver_control (1000, 1e-9);
+   *  SolverArnoldi system (solver_control, mpi_communicator);
+   *  eigensolver.solve (A, B, lambda, x, size_of_spectrum);
+   * @endcode
+   * 
+   * @note These options can also be set at the commandline.
+   *
    * @ingroup SLEPcWrappers
-   * @author Toby D. Young 2009
+   * @author Toby D. Young 2009, 2013
    **/
   class TransformationBase
   {