/usr/include/siscone/hash.h is in libsiscone-dev 2.0.6-1.1.
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 | // -*- C++ -*-
///////////////////////////////////////////////////////////////////////////////
// File: hash.h //
// Description: header file for classes hash_element and hash_cones //
// This file is part of the SISCone project. //
// For more details, see http://projects.hepforge.org/siscone //
// //
// Copyright (c) 2006 Gavin Salam and Gregory Soyez //
// //
// This program 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. //
// //
// This program 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 this program; if not, write to the Free Software //
// Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA //
// //
// $Revision:: 224 $//
// $Date:: 2008-05-16 19:58:30 +0200 (Fri, 16 May 2008) $//
///////////////////////////////////////////////////////////////////////////////
#ifndef __HASH_H__
#define __HASH_H__
#include "momentum.h"
#include "reference.h"
namespace siscone{
/**
* \class hash_element
* information on store cones candidates.
*
* We store in this class the information used to count all
* protocones in a first pass. This first pass only count
* cones with different references and test their stbility
* with the parent-child particles (border particles).
*/
class hash_element{
public:
Creference ref; ///< reference
double eta; ///< centre: eta coordinate
double phi; ///< centre: phi coordinate
bool is_stable; ///< true if stable w.r.t. "border particles"
hash_element *next; ///< pointer to the next element
};
/**
* \class hash_cones
* list of cones candidates.
*
* We store in this class all the hash_elements and give
* functions to manipulate them.
*/
class hash_cones{
public:
/// constructor with initialisation
/// \param _Np number of particles
/// \param _R2 cone radius (squared)
hash_cones(int _Np, double _R2);
/// destructor
~hash_cones();
/**
* insert a new candidate into the hash.
* \param v 4-momentum of te cone to add
* \param parent parent particle defining the cone
* \param child child particle defining the cone
* \param p_io whether the parent has to belong to the cone or not
* \param c_io whether the child has to belong to the cone or not
* \return 0 on success, 1 on error
*/
int insert(Cmomentum *v, Cmomentum *parent, Cmomentum *child, bool p_io, bool c_io);
/**
* insert a new candidate into the hash.
* \param v 4-momentum of te cone to add
* Note, in this case, we assume stability. We also assume
* that eta and phi are computed for v
* \return 0 on success, 1 on error
*/
int insert(Cmomentum *v);
/// the cone data itself
hash_element **hash_array;
/// number of elements
int n_cones;
/// number of occupied cells
#ifdef DEBUG_STABLE_CONES
int n_occupied_cells;
#endif
/// number of cells-1
int mask;
/// circle radius (squared)
/// NOTE: need to be set before any call to 'insert'
double R2;
/**
* test if a particle is inside a cone of given centre.
* check if the particle of coordinates 'v' is inside the circle of radius R
* centered at 'centre'.
* \param centre centre of the circle
* \param v particle to test
* \return true if inside, false if outside
*/
inline bool is_inside(Cmomentum *centre, Cmomentum *v);
};
}
#endif
|