File: RandomPrimitiveElement.h

package info (click to toggle)
magnus 20060324-3
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 19,404 kB
  • ctags: 20,466
  • sloc: cpp: 130,118; ansic: 37,076; tcl: 10,970; perl: 1,109; makefile: 963; sh: 403; yacc: 372; csh: 57; awk: 33; asm: 10
file content (73 lines) | stat: -rw-r--r-- 2,396 bytes parent folder | download | duplicates (3)
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
// Copyright (C) 1995 The New York Group Theory Cooperative
// See magnus/doc/COPYRIGHT for the full notice.
//
// Contents: Declarations of classes RandomPrimitiveElement
//
// Principal Author: Sergei Lioutikov
//
// Status: in progress
//
// Revision History:
//
// Notes:
//
// * generates random primitive elements for a free group ( those which can be 
//   extended to a basis. )
// * copy constructor does logical copy.
//

#ifndef _RANDOMPRIMITIVEELEMENT_H_
#define _RANDOMPRIMITIVEELEMENT_H_


#include "RandomNumbers.h"
#include "FreeGroup.h"

//---------------------------------------------------------------------------//
//----------------------- RandomPrimitiveElement ----------------------------//
//---------------------------------------------------------------------------//


class RandomPrimitiveElement
{
public:

  /////////////////////////////////////////////////////////////////////////
  //                                                                     //
  // Constructors:                                                       //
  //                                                                     //
  /////////////////////////////////////////////////////////////////////////

  RandomPrimitiveElement( const FreeGroup& F, int seed );
  // Giving the same `seed' you obtain the same sequence of automorphisms.

  ~RandomPrimitiveElement( );

  /////////////////////////////////////////////////////////////////////////
  //                                                                     //
  // Accessors:                                                          //
  //                                                                     //
  /////////////////////////////////////////////////////////////////////////

  Word getElement( int avgNumGens );
  // `avgNumGens' gives the average number of Whitehead automorphisms to apply.

private:

  /////////////////////////////////////////////////////////////////////////
  //                                                                     //
  // Data Members:                                                       //
  //                                                                     //
  /////////////////////////////////////////////////////////////////////////

  FreeGroup theGroup;

  int numberOfGroupGens;

  NormalRandom numGensPicker;
  UniformRandom typeGenPicker;

};

#endif