Regina Calculation Engine
Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Attributes | List of all members
regina::NAngleStructureVector Class Reference

A vector of integers used to indirectly store the individual angles in an angle structure. More...

#include <angle/nanglestructure.h>

Inheritance diagram for regina::NAngleStructureVector:
regina::NRay regina::NVector< NLargeInteger >

Public Member Functions

 NAngleStructureVector (size_t length)
 Creates a new vector all of whose entries are initialised to zero. More...
 
 NAngleStructureVector (const NVector< NLargeInteger > &cloneMe)
 Creates a new vector that is a clone of the given vector. More...
 
void scaleDown ()
 Scales this vector down by the greatest common divisor of all its elements. More...
 
void negate ()
 Negates every element of this vector. More...
 
size_t size () const
 Returns the number of elements in the vector. More...
 
const NLargeIntegeroperator[] (size_t index) const
 Returns the element at the given index in the vector. More...
 
void setElement (size_t index, const NLargeInteger &value)
 Sets the element at the given index in the vector to the given value. More...
 
bool operator== (const NVector< NLargeInteger > &compare) const
 Determines if this vector is equal to the given vector. More...
 
void operator+= (const NVector< NLargeInteger > &other)
 Adds the given vector to this vector. More...
 
void operator-= (const NVector< NLargeInteger > &other)
 Subtracts the given vector from this vector. More...
 
void operator*= (const NLargeInteger &factor)
 Multiplies this vector by the given scalar. More...
 
NLargeInteger operator* (const NVector< NLargeInteger > &other) const
 Calculates the dot product of this vector and the given vector. More...
 
NLargeInteger norm () const
 Returns the norm of this vector. More...
 
NLargeInteger elementSum () const
 Returns the sum of all elements of this vector. More...
 
void addCopies (const NVector< NLargeInteger > &other, const NLargeInteger &multiple)
 Adds the given multiple of the given vector to this vector. More...
 
void subtractCopies (const NVector< NLargeInteger > &other, const NLargeInteger &multiple)
 Subtracts the given multiple of the given vector to this vector. More...
 

Static Public Member Functions

static NMatrixIntmakeAngleEquations (const NTriangulation *tri)
 Creates a new set of angle structure equations for the given triangulation. More...
 

Static Public Attributes

static NLargeInteger zero
 Zero in the underlying number system. More...
 
static NLargeInteger one
 One in the underlying number system. More...
 
static NLargeInteger minusOne
 Negative one in the underlying number system. More...
 

Protected Attributes

NLargeIntegerelements
 The internal array containing all vector elements. More...
 
NLargeIntegerend
 A pointer just beyond the end of the internal array. More...
 

Detailed Description

A vector of integers used to indirectly store the individual angles in an angle structure.

This vector will contain one member per angle plus a final scaling member; to obtain the actual angle in the angle structure one should divide the corresonding angle member by the scaling member and then multiply by pi.

The reason for using this obfuscated representation is so we can use the NDoubleDescription vertex enumeration routines to calculate vertex angle structures.

If there are t tetrahedra in the underlying triangulation, there will be precisely 3t+1 elements in this vector. The first three elements will be the angle members for the first tetrahedron, the next three for the second tetrahedron and so on. For each tetraheron, the three individual elements are the angle members for vertex splittings 0, 1 and 2 (see NAngleStructure::getAngle()). The final element of the vector is the scaling member as described above.

Python:
Not present.

Constructor & Destructor Documentation

regina::NAngleStructureVector::NAngleStructureVector ( size_t  length)
inline

Creates a new vector all of whose entries are initialised to zero.

Parameters
lengththe number of elements in the new vector.
regina::NAngleStructureVector::NAngleStructureVector ( const NVector< NLargeInteger > &  cloneMe)
inline

Creates a new vector that is a clone of the given vector.

Parameters
cloneMethe vector to clone.

Member Function Documentation

void regina::NVector< NLargeInteger >::addCopies ( const NVector< NLargeInteger > &  other,
const NLargeInteger multiple 
)
inlineinherited

Adds the given multiple of the given vector to this vector.

Precondition
This and the given vector have the same size.
Parameters
otherthe vector a multiple of which will be added to this vector.
multiplethe multiple of other to be added to this vector.
NLargeInteger regina::NVector< NLargeInteger >::elementSum ( ) const
inlineinherited

Returns the sum of all elements of this vector.

Returns
the sum of the elements of this vector.
static NMatrixInt* regina::NAngleStructureVector::makeAngleEquations ( const NTriangulation tri)
static

Creates a new set of angle structure equations for the given triangulation.

Each equation will be represented as a row of the matrix, and each column will represent a coordinate in the underlying coordinate system (which is described in the NAngleStructureVector class notes).

The returned matrix will be newly allocated and its destruction will be the responsibility of the caller of this routine.

Parameters
trithe triangulation upon which these angle structure equations will be based.
Returns
a newly allocated set of equations.
void regina::NRay::negate ( )
inlineinherited

Negates every element of this vector.

This is an optimised implementation that overrides NVector<NLargeInteger>::negate().

NLargeInteger regina::NVector< NLargeInteger >::norm ( ) const
inlineinherited

Returns the norm of this vector.

This is the dot product of the vector with itself.

Returns
the norm of this vector.
NLargeInteger regina::NVector< NLargeInteger >::operator* ( const NVector< NLargeInteger > &  other) const
inlineinherited

Calculates the dot product of this vector and the given vector.

Precondition
This and the given vector have the same size.
Parameters
otherthe vector with which this will be multiplied.
Returns
the dot product of this and the given vector.
void regina::NVector< NLargeInteger >::operator*= ( const NLargeInteger factor)
inlineinherited

Multiplies this vector by the given scalar.

Parameters
factorthe scalar with which this will be multiplied.
void regina::NVector< NLargeInteger >::operator+= ( const NVector< NLargeInteger > &  other)
inlineinherited

Adds the given vector to this vector.

Precondition
This and the given vector have the same size.
Parameters
otherthe vector to add to this vector.
void regina::NVector< NLargeInteger >::operator-= ( const NVector< NLargeInteger > &  other)
inlineinherited

Subtracts the given vector from this vector.

Precondition
This and the given vector have the same size.
Parameters
otherthe vector to subtract from this vector.
bool regina::NVector< NLargeInteger >::operator== ( const NVector< NLargeInteger > &  compare) const
inlineinherited

Determines if this vector is equal to the given vector.

Precondition
This and the given vector have the same size.
Parameters
comparethe vector with which this will be compared.
Returns
true if and only if the this and the given vector are equal.
const NLargeInteger & regina::NVector< NLargeInteger >::operator[] ( size_t  index) const
inlineinherited

Returns the element at the given index in the vector.

A constant reference to the element is returned; the element may not be altered.

Precondition
index is between 0 and size()-1 inclusive.
Parameters
indexthe vector index to examine.
Returns
the vector element at the given index.
void regina::NRay::scaleDown ( )
inherited

Scales this vector down by the greatest common divisor of all its elements.

The resulting vector will be the smallest multiple of the original that maintains integral entries, and these entries will have the same signs as the originals.

This routine thus reduces a ray to its smallest possible representation.

This routine poses no problem for vectors containing infinite elements; such elements are simply ignored and left at infinity.

void regina::NVector< NLargeInteger >::setElement ( size_t  index,
const NLargeInteger value 
)
inlineinherited

Sets the element at the given index in the vector to the given value.

Precondition
index is between 0 and size()-1 inclusive.
Parameters
indexthe vector index to examine.
valuethe new value to assign to the element.
Returns
the vector element at the given index.
size_t regina::NVector< NLargeInteger >::size ( ) const
inlineinherited

Returns the number of elements in the vector.

Returns
the vector size.
void regina::NVector< NLargeInteger >::subtractCopies ( const NVector< NLargeInteger > &  other,
const NLargeInteger multiple 
)
inlineinherited

Subtracts the given multiple of the given vector to this vector.

Precondition
This and the given vector have the same size.
Parameters
otherthe vector a multiple of which will be subtracted from this vector.
multiplethe multiple of other to be subtracted from this vector.

Member Data Documentation

NLargeInteger * regina::NVector< NLargeInteger >::elements
protectedinherited

The internal array containing all vector elements.

NLargeInteger * regina::NVector< NLargeInteger >::end
protectedinherited

A pointer just beyond the end of the internal array.

The size of the vector can be computed as (end - elements).

NLargeInteger regina::NVector< NLargeInteger >::minusOne
staticinherited

Negative one in the underlying number system.

This would be const if it weren't for the fact that some compilers don't like this. It should never be modified!

NLargeInteger regina::NVector< NLargeInteger >::one
staticinherited

One in the underlying number system.

This would be const if it weren't for the fact that some compilers don't like this. It should never be modified!

NLargeInteger regina::NVector< NLargeInteger >::zero
staticinherited

Zero in the underlying number system.

This would be const if it weren't for the fact that some compilers don't like this. It should never be modified!


The documentation for this class was generated from the following file:

Copyright © 1999-2014, The Regina development team
This software is released under the GNU General Public License, with some additional permissions; see the source code for details.
For further information, or to submit a bug or other problem, please contact Ben Burton (bab@debian.org).