This file is indexed.

/usr/include/deal.II/distributed/grid_refinement.h is in libdeal.ii-dev 8.1.0-6ubuntu1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
// ---------------------------------------------------------------------
// $Id: grid_refinement.h 30036 2013-07-18 16:55:32Z maier $
//
// Copyright (C) 2009 - 2013 by the deal.II authors
//
// This file is part of the deal.II library.
//
// The deal.II library is free software; you can use it, redistribute
// it, and/or modify it under the terms of the GNU Lesser General
// Public License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
// The full text of the license can be found in the file LICENSE at
// the top level of the deal.II distribution.
//
// ---------------------------------------------------------------------

#ifndef __deal2__distribute_grid_refinement_h
#define __deal2__distribute_grid_refinement_h


#include <deal.II/base/config.h>
#include <deal.II/base/exceptions.h>
#include <deal.II/distributed/tria.h>

#include <vector>
#include <limits>

DEAL_II_NAMESPACE_OPEN

namespace parallel
{
  namespace distributed
  {
    // forward declarations
    template <int dim, int spacedim> class Triangulation;


    /**
     * Collection of functions controlling refinement and coarsening of
     * parallel::distributed::Triangulation objects. This namespace
     * provides similar functionality to the dealii::GridRefinement
     * namespace, except that it works for meshes that are parallel and
     * distributed.
     *
     * @ingroup grid
     * @author Wolfgang Bangerth, 2009
     */
    namespace GridRefinement
    {
      /**
       * Like
       * dealii::GridRefinement::refine_and_coarsen_fixed_number,
       * but for parallel distributed
       * triangulation.
       *
       * The vector of criteria needs to be a
       * vector of refinement criteria for
       * all cells active on the current
       * triangulation,
       * i.e. <code>tria.n_active_cells()</code>
       * (and not
       * <code>tria.n_locally_owned_active_cells()</code>). However,
       * the function will only look at the
       * indicators that correspond to those
       * cells that are actually locally
       * owned, and ignore the indicators for
       * all other cells. The function will
       * then coordinate among all processors
       * that store part of the triangulation
       * so that at the end @p
       * top_fraction_of_cells are refined,
       * where the fraction is enforced as a
       * fraction of
       * Triangulation::n_global_active_cells,
       * not
       * Triangulation::n_locally_active_cells
       * on each processor individually. In
       * other words, it may be that on some
       * processors, no cells are refined at
       * all.
       *
       * The same is true for the fraction of
       * cells that is coarsened.
       */
      template <int dim, class Vector, int spacedim>
      void
      refine_and_coarsen_fixed_number (
        parallel::distributed::Triangulation<dim,spacedim> &tria,
        const Vector                &criteria,
        const double                top_fraction_of_cells,
        const double                bottom_fraction_of_cells);

      /**
       * Like
       * dealii::GridRefinement::refine_and_coarsen_fixed_fraction,
       * but for parallel distributed
       * triangulation.
       *
       * The vector of criteria needs to be a
       * vector of refinement criteria for
       * all cells active on the current
       * triangulation,
       * <code>tria.n_active_cells()</code>
       * (and not
       * <code>tria.n_locally_owned_active_cells()</code>). However,
       * the function will only look at the
       * indicators that correspond to those
       * cells that are actually locally
       * owned, and ignore the indicators for
       * all other cells. The function will
       * then coordinate among all processors
       * that store part of the triangulation
       * so that at the end the smallest
       * fraction of
       * Triangulation::n_global_active_cells
       * (not
       * Triangulation::n_locally_active_cells
       * on each processor individually) is
       * refined that together make up a
       * total of @p top_fraction_of_error of
       * the total error. In other words, it
       * may be that on some processors, no
       * cells are refined at all.
       *
       * The same is true for the fraction of
       * cells that is coarsened.
       */
      template <int dim, class Vector, int spacedim>
      void
      refine_and_coarsen_fixed_fraction (
        parallel::distributed::Triangulation<dim,spacedim> &tria,
        const Vector                &criteria,
        const double                top_fraction_of_error,
        const double                bottom_fraction_of_error);
    }
  }
}


DEAL_II_NAMESPACE_CLOSE

#endif //__deal2__distributed_grid_refinement_h