updated doc

Author: pancetta

docs/source/conf.py

@@ -59,7 +59,7 @@
 
 # General information about the project.
 project = 'pySDC'
-copyright = '2016, Robert Speck'
+copyright = '2017, Robert Speck'
 author = 'Robert Speck'
 
 # The version info for the project you're documenting, acts as replacement for

docs/source/index.rst

@@ -78,6 +78,7 @@ Projects
    projects/parallelSDC.rst
    projects/node_failure.rst
    projects/fwsw.rst
+   projects/asymp_conv.rst
    projects/RDC.rst
 
 Tests

docs/source/projects/asymp_conv.rst

@@ -0,0 +1 @@
+.. include:: /../../projects/AsympConv/README.rst

docs/source/projects/doc_asympconv.rst

@@ -0,0 +1,14 @@
+Results:
+
+.. image:: ../../../data/conv_test_niter_NS3.png
+   :width: 19%
+
+.. image:: ../../../data/conv_test_niter_NS2.png
+   :width: 19%
+
+.. image:: ../../../data/conv_test_niter_Linf_diffusion.png
+   :width: 19%
+
+.. image:: ../../../data/conv_test_niter_Linf_advection.png
+   :width: 19%
+

projects/AsympConv/README.rst

@@ -0,0 +1,15 @@
+Asymptotic convergence of PFASST
+================================
+
+This project investigates the impact of the convergence results described in the paper "Asymptotic convergence of PFASST for linear problems".
+We use 1D heat equation and advection equation to show how PFASST converges in the stiff as well as in the non-stiff limit.
+Note that due to the long runtime, not all results are not generated via Travis.
+
+Organisation of the project
+---------------------------
+
+- ``conv_test_to0.py`` and ``conv_test_toinf.py``: plots spectral radius of the smoother's iteration matrix for different eigenvalues. See Figures 1 and 2 in the paper.
+- ``smoother_specrad_heatmap.py``: generates heatmap of the spectral radius of the smoother's iteration matrix for different eigenvalues in the test equation. See Figure 3.
+- ``PFASST_conv_tests.py`` and ``PFASST_conv_Linf.py``: runs PFASST for advection and diffusion checking teh iteration counts until convergence. See Figures 4 and 5.
+
+.. include:: doc_asympconv.rst

pySDC/helpers/visualization_tools.py

@@ -1,3 +1,6 @@
+import matplotlib
+matplotlib.use('Agg')
+
 from pySDC.helpers.stats_helper import filter_stats
 
 import numpy as np