/usr/include/p4est_points.h is in libp4est-dev 1.1-4.
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 | /*
This file is part of p4est.
p4est is a C library to manage a collection (a forest) of multiple
connected adaptive quadtrees or octrees in parallel.
Copyright (C) 2010 The University of Texas System
Written by Carsten Burstedde, Lucas C. Wilcox, and Tobin Isaac
p4est is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
p4est is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with p4est; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/********************************************************************
* IMPORTANT NOTE *
* *
* The p4est_points functionality depends on sc/src/sc_sort. *
* That parallel bitonic sort is still buggy (see sc/bugs). *
* If you want to use this code you have to fix the sort first. *
********************************************************************/
#ifndef P4EST_POINTS_H
#define P4EST_POINTS_H
#include <p4est.h>
SC_EXTERN_C_BEGIN;
/** Create a new forest based on a distributed set of points.
*
* \param [in] mpicomm A valid MPI communicator.
* \param [in] connectivity This is the connectivity information that
* the forest is built with. Note the p4est
* does not take ownership of the memory.
* \param [in] maxlevel Level of the smallest possible quadrants.
* \param [in] points Unsorted collection of clamped quadrant nodes.
* The tree id must be stored in p.which_tree.
* \param [in] num_points Number of local points provided in the array.
* \param [in] max_points Maximum number of points per quadrant.
* Applies to quadrants above maxlevel, so 0 is ok.
* A value of -1 disables all refinement.
* \param [in] data_size This is the size of data for each quadrant which
* can be zero. Then user_data_pool is set to NULL.
* \param [in] init_fn Callback function to initialize the user_data
* which is already allocated automatically.
* \param [in] user_pointer Assign to the user_pointer member of the p4est
* before init_fn is called the first time.
*
* \return This returns a valid forest.
*
* \note The connectivity structure must not be destroyed
* during the lifetime of this forest.
*/
p4est_t *p4est_new_points (sc_MPI_Comm mpicomm,
p4est_connectivity_t * connectivity,
int maxlevel, p4est_quadrant_t * points,
p4est_locidx_t num_points,
p4est_locidx_t max_points,
size_t data_size, p4est_init_t init_fn,
void *user_pointer);
SC_EXTERN_C_END;
#endif /* !P4EST_POINTS_H */
|