//STARTHEADER
// $Id: ClosestPair2DBase.hh 2577 2011-09-13 15:11:38Z salam $
//
// Copyright (c) 2005-2011, Matteo Cacciari, Gavin P. Salam and Gregory Soyez
//
//----------------------------------------------------------------------
// This file is part of FastJet.
//
// FastJet 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.
//
// The algorithms that underlie FastJet have required considerable
// development and are described in hep-ph/0512210. If you use
// FastJet as part of work towards a scientific publication, please
// include a citation to the FastJet paper.
//
// FastJet 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 FastJet. If not, see .
//----------------------------------------------------------------------
//ENDHEADER
#ifndef __FASTJET_CLOSESTPAIR2DBASE__HH__
#define __FASTJET_CLOSESTPAIR2DBASE__HH__
#include
#include "fastjet/internal/base.hh"
FASTJET_BEGIN_NAMESPACE // defined in fastjet/internal/base.hh
//----------------------------------------------------------------------
/// \if internal_doc
/// @ingroup internal
/// \class Coord2D
/// class for representing 2d coordinates and carrying out some basic
/// operations on them
/// \endif
class Coord2D {
public:
double x, y;
Coord2D() {};
Coord2D(double a, double b): x(a), y(b) {};
/// return the vector difference between two coordinates
Coord2D operator-(const Coord2D & other) const {
return Coord2D(x - other.x, y - other.y);};
/// return the vector sum between two coordinates
Coord2D operator+(const Coord2D & other) const {
return Coord2D(x + other.x, y + other.y);};
/// return the product of the coordinate with the factor
Coord2D operator*(double factor) const {return Coord2D(factor*x,factor*y);};
friend Coord2D operator*(double factor, const Coord2D & coord) {
return Coord2D(factor*coord.x,factor*coord.y);
}
/// division of each component of coordinate
Coord2D operator/(double divisor) const {
return Coord2D(x / divisor, y / divisor);};
/// return the squared distance between two coordinates
friend double distance2(const Coord2D & a, const Coord2D & b) {
double dx = a.x - b.x, dy = a.y-b.y;
return dx*dx+dy*dy;
};
/// return the squared distance between two coordinates
double distance2(const Coord2D & b) const {
double dx = x - b.x, dy = y-b.y;
return dx*dx+dy*dy;
};
};
//----------------------------------------------------------------------
/// \if internal_doc
/// @ingroup internal
/// \class ClosestPair2DBase
/// abstract base class for finding closest pairs in 2D
/// \endif
class ClosestPair2DBase {
public:
/// provides the IDs of the closest pair as well as the squared
/// distance between them
virtual void closest_pair(unsigned int & ID1, unsigned int & ID2,
double & distance2) const = 0;
/// removes the entry labelled by ID from the object;
virtual void remove(unsigned int ID) = 0;
/// inserts the position into the closest pair structure and returns the
/// ID that has been allocated for the object.
virtual unsigned int insert(const Coord2D & position) = 0;
/// replaces the specified ID1 and ID2 with something at a new position
/// assuming that ID1 and ID2 are in sequence wrt position; it returns
/// the ID of the new object...
virtual unsigned int replace(unsigned int ID1, unsigned int ID2,
const Coord2D & position) {
remove(ID1);
remove(ID2);
unsigned new_ID = insert(position);
return(new_ID);
};
/// replaces IDs_to_remove with points at the new_positions
/// indicating the IDs allocated to the new points in new_IDs
virtual void replace_many(const std::vector & IDs_to_remove,
const std::vector & new_positions,
std::vector & new_IDs) {
for(unsigned i = 0; i < IDs_to_remove.size(); i++) {
remove(IDs_to_remove[i]);}
new_IDs.resize(0);
for(unsigned i = 0; i < new_positions.size(); i++) {
new_IDs.push_back(insert(new_positions[i]));}
}
virtual unsigned int size() = 0;
virtual ~ClosestPair2DBase() {};
};
FASTJET_END_NAMESPACE
#endif // __FASTJET_CLOSESTPAIR2DBASE__HH__