From ded879bede5cd0daa42e26a0eddfcbdb30af9df8 Mon Sep 17 00:00:00 2001 From: Guido Kanschat Date: Tue, 28 Aug 2012 11:53:52 +0000 Subject: [PATCH] Add documentation git-svn-id: https://svn.dealii.org/trunk@26139 0785d39b-7218-0410-832d-ea1e28bc413d --- deal.II/include/deal.II/meshworker/output.h | 39 +++++++++++++++------ 1 file changed, 28 insertions(+), 11 deletions(-) diff --git a/deal.II/include/deal.II/meshworker/output.h b/deal.II/include/deal.II/meshworker/output.h index 87ccb27869..f706e3db74 100644 --- a/deal.II/include/deal.II/meshworker/output.h +++ b/deal.II/include/deal.II/meshworker/output.h @@ -30,11 +30,26 @@ namespace MeshWorker /** * A class that, instead of assembling into a matrix or vector, - * outputs the results on a cell to a gnuplot patch. This works only - * for elements with support points. The first dim data vectors will - * be the coordinates, the following are the data. + * outputs the results on a cell to a gnuplot patch. + * + * This assembler expects that LocalResults contains quadrature values + * set with LocalResults::quadrature_value(). When it is initialized + * with the number of quadrature points in a single (!) space + * direction and the number of data fields to be displayed, it + * initializes LocalResults automatically. The number of data fields + * in local results will be increased by dim in order to accommodate + * for the coordinates of the data points. + * + * While data slots for the space coordinates are allocated + * automatically, these coordinates are not entered. It is up to the + * user to enter the coordinates in the first dim data entries at + * every point. This adds the flexibility to output transformed + * coordinates or even something completely different. * * @note In the current implementation, only cell data can be written. + * + * @author Guido Kanschat + * @date 2011, 2012 */ class GnuplotPatch { @@ -56,10 +71,13 @@ namespace MeshWorker * actual Quadrature used to * create the patches. The * total number of data - * vectors produced is n+dim - * and the first dim will be + * vectors produced is n+dim + * and the first dim should be * the space coordinates of - * the points. + * the points. Nevertheless, + * it is up to the user to + * set these values to + * whatever is desired. */ void initialize (const unsigned int n_points, const unsigned int n_vectors); @@ -90,15 +108,14 @@ namespace MeshWorker void initialize_info(DoFInfo& info, bool face); /** - * Assemble the local values - * into the global vectors. + * Write the patch to the + * output stream. */ template void assemble(const DoFInfo& info); /** - * Assemble both local values - * into the global vectors. + * @warning Not implemented yet */ template void assemble(const DoFInfo& info1, @@ -107,7 +124,7 @@ namespace MeshWorker private: /** * Write the object T either - * to the stream #os, if initialize_stream + * to the stream #os, if initialize_stream() * has been called, or to * @p deallog if no pointer has * been set. -- 2.39.5