From: wolf Date: Mon, 5 Apr 2004 15:23:10 +0000 (+0000) Subject: Start with writing the documentation. X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=40221b2473076c416a3ac5620df1bf7adbb49ba3;p=dealii-svn.git Start with writing the documentation. git-svn-id: https://svn.dealii.org/trunk@8968 0785d39b-7218-0410-832d-ea1e28bc413d --- diff --git a/deal.II/examples/step-17/step-17.cc b/deal.II/examples/step-17/step-17.cc index 1e9007538b..9ea67db519 100644 --- a/deal.II/examples/step-17/step-17.cc +++ b/deal.II/examples/step-17/step-17.cc @@ -1,29 +1,25 @@ /* $Id$ */ -/* Author: Wolfgang Bangerth, University of Heidelberg, 2000 */ +/* Author: Wolfgang Bangerth, University of Texas at Austin, 2000, 2004 */ /* $Id$ */ /* Version: $Name$ */ /* */ -/* Copyright (C) 2004 by the deal.II authors */ +/* Copyright (C) 2000, 2004 by the deal.II authors */ /* */ /* This file is subject to QPL and may not be distributed */ /* without copyright and license information. Please refer */ /* to the file deal.II/doc/license.html for the text and */ /* further information on this license. */ + + // First the usual assortment of header files + // we have already used in previous example + // programs: #include #include #include #include #include - - // xxx -#include -#include -#include -#include -#include - #include #include #include @@ -33,22 +29,57 @@ #include #include #include - - // xxx -#include - +#include #include #include #include #include #include #include -#include #include - // xxx + // And here come the things that we need + // particularly for this example program and + // that weren't in step-8. First, we are + // going to replace all linear algebra + // components that involve the (global) + // linear system by classes that wrap + // interfaces similar to our own linear + // algebra classes around what PETSc offers + // (PETSc is a library written in C, and + // deal.II comes with wrapper classes that + // provide the PETSc functionality with an + // interface that is similar to the interface + // we already had for our own linear algebra + // classes). In particular, we need vectors + // and matrices that are distributed across + // several processes in MPI programs (and + // simply map to sequential, local vectors + // and matrices if there is only a single + // process, i.e. if you are running on only + // one machine, and without MPI support): +#include +#include +#include + // Then we also need interfaces for solvers + // and preconditioners that PETSc provides: +#include +#include + // And in addition, we need some algorithms + // for partitioning our meshes so that they + // can be efficiently distributed across an + // MPI network. The partitioning algorithm is + // implemented in the ``GridTools'' class, + // and we need an additional include file for + // a function in ``DoFRenumbering'' that + // allows to sort the indices associated with + // degrees of freedom so that they are + // numbered according to the subdomain they + // are associated with: #include +#include + // And this is simply C++ again: #include #include