/usr/include/CLHEP/Random/Hurd288Engine.h is in libclhep-dev 2.1.4.1-1.2.
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 | // $Id: Hurd288Engine.h,v 1.5 2010/06/16 17:24:53 garren Exp $
// -*- C++ -*-
//
// -----------------------------------------------------------------------
// HEP Random
// --- Hurd288Engine ---
// class header file
// -----------------------------------------------------------------------
// The starting point for the Hurd Random algorithm is the paper in
// IEEE Transactions on Computers c23, 2 Feb 1974. The algorithm is
// essentially a series of 32 interconnected b-bit registers. The basic
// property is that at each step, bit 1 becomes bit 0, bit 2 the new bit 1,
// bit b the new bit b-1. This is modified so that the new bit b0 is the old
// bit b1 XOR'd with some bit b-d from the previous bit register. The values
// of d can be chosen so as to generate a primitive polynomial, a maximal
// length sequence through all bit patterns except the zero pattern.
//
// This generator, Hurd288, use values based upon Table I of the afore-
// mentioned paper, such that we have 288 total bits, representing 32
// 9-bit registers (actually implemented as an array of 9 32-bit words)
// =======================================================================
// 07-23-98 KLS Initial draft started
// Ken Smith - Added conversion operators: 6th Aug 1998
// Mark Fischler - methods for distrib. instacne save/restore 12/8/04
// Mark Fischler - methods for anonymous save/restore 12/27/04
// =======================================================================
#ifndef Hurd288Engine_h
#define Hurd288Engine_h
#include "CLHEP/Random/defs.h"
#include "CLHEP/Random/RandomEngine.h"
namespace CLHEP {
/**
* @author
* @ingroup random
*/
class Hurd288Engine: public HepRandomEngine {
public:
Hurd288Engine();
Hurd288Engine( std::istream &is );
Hurd288Engine( long seed );
Hurd288Engine( int rowIndex, int colIndex );
virtual ~Hurd288Engine();
// Constructors and destructor.
double flat();
// Returns a pseudo random number between 0 and 1
void flatArray( const int size, double* vect );
// Fills the array "vect" of specified size with flat random values.
void setSeed( long seed, int );
// Sets the state of the algorithm according to seed.
void setSeeds( const long* seeds, int );
// Sets the state of the algorithm according to the zero-terminated
// array of seeds.
void saveStatus( const char filename[] = "Hurd288Engine.conf" ) const;
// Saves on named file the current engine status
void restoreStatus( const char filename[] = "Hurd288Engine.conf" );
// Reads from named file the last saved engine status
// and restores it.
void showStatus() const;
// Dumps the engine status on the screen
operator float(); // flat value, without worrying about filling bits
operator unsigned int(); // 32-bit flat value, quickest of all
virtual std::ostream & put (std::ostream & os) const;
virtual std::istream & get (std::istream & is);
static std::string beginTag ( );
virtual std::istream & getState ( std::istream & is );
std::string name() const;
static std::string engineName() {return "Hurd288Engine";}
std::vector<unsigned long> put () const;
bool get (const std::vector<unsigned long> & v);
bool getState (const std::vector<unsigned long> & v);
static const unsigned int VECTOR_STATE_SIZE = 11;
private:
static int numEngines;
static int maxIndex;
void advance();
int wordIndex;
unsigned int words[9];
}; // Hurd288Engine
} // namespace CLHEP
#ifdef ENABLE_BACKWARDS_COMPATIBILITY
// backwards compatibility will be enabled ONLY in CLHEP 1.9
using namespace CLHEP;
#endif
#endif // Hurd288Engine_h
|