Regina Calculation Engine
Public Types | Public Member Functions | List of all members
regina::NSFSpace Class Reference

Represents a general Seifert fibred space, which may be orientable or non-orientable. More...

#include <manifold/nsfs.h>

Inheritance diagram for regina::NSFSpace:
regina::NManifold regina::ShareableObject regina::boost::noncopyable

Public Types

enum  classType {
  o1 = 101, o2 = 102, n1 = 201, n2 = 202,
  n3 = 203, n4 = 204, bo1 = 301, bo2 = 302,
  bn1 = 401, bn2 = 402, bn3 = 403
}
 Lists the six classes o1, o2, n1, n2, n3, n4 for base orbifolds without boundaries, plus five classes bo1, b02, bn1, bn2, bn3 for base orbifolds with boundaries. More...
 

Public Member Functions

 NSFSpace ()
 Creates a new Seifert fibred space with base orbifold the 2-sphere and no exceptional fibres. More...
 
 NSFSpace (classType useClass, unsigned long genus, unsigned long punctures=0, unsigned long puncturesTwisted=0, unsigned long reflectors=0, unsigned long reflectorsTwisted=0)
 Creates a new Seifert fibred space of the given class with the given base orbifold and no exceptional fibres. More...
 
 NSFSpace (const NSFSpace &cloneMe)
 Creates a new Seifert fibred space that is a clone of the given space. More...
 
virtual ~NSFSpace ()
 Destroys this Seifert fibred space. More...
 
void operator= (const NSFSpace &cloneMe)
 Modifies this Seifert fibred space to be a clone of the given space. More...
 
classType baseClass () const
 Returns which of the eleven predefined classes this space belongs to. More...
 
unsigned long baseGenus () const
 Returns the genus of the base orbifold. More...
 
bool baseOrientable () const
 Returns whether or not the base surface is orientable. More...
 
bool fibreReversing () const
 Returns whether or not this space contains any fibre-reversing paths. More...
 
bool fibreNegating () const
 Returns whether or not we can negate an exceptional fibre by passing it around the interior of the base orbifold. More...
 
unsigned long punctures () const
 Returns the total number of punctures in the base orbifold. More...
 
unsigned long punctures (bool twisted) const
 Returns the number of punctures of the given type in the base orbifold. More...
 
unsigned long reflectors () const
 Returns the total number of reflector boundary components of the base orbifold. More...
 
unsigned long reflectors (bool twisted) const
 Returns the number of reflector boundary components of the given type in the base orbifold. More...
 
unsigned long fibreCount () const
 Returns the number of exceptional fibres in this Seifert fibred space. More...
 
NSFSFibre fibre (unsigned long which) const
 Returns the requested exceptional fibre. More...
 
long obstruction () const
 Returns the obstruction constant b for this Seifert fibred space. More...
 
void addHandle (bool fibreReversing=false)
 Inserts a new handle into the base orbifold. More...
 
void addCrosscap (bool fibreReversing=false)
 Inserts a new crosscap into the base orbifold. More...
 
void addPuncture (bool twisted=false, unsigned long nPunctures=1)
 Inserts one or more new punctures into the base orbifold. More...
 
void addReflector (bool twisted=false, unsigned long nReflectors=1)
 Adds one or more new reflector boundary components to the base orbifold. More...
 
void insertFibre (const NSFSFibre &fibre)
 Adds the given fibre to this Seifert fibred space. More...
 
void insertFibre (long alpha, long beta)
 Adds the given fibre to this Seifert fibred space. More...
 
void reflect ()
 Replaces this space with its mirror image. More...
 
void complementAllFibres ()
 Replaces each exceptional fibre of the form (alpha, beta) with a fibre of the form (alpha, alpha - beta). More...
 
void reduce (bool mayReflect=true)
 Reduces the parameters of this Seifert fibred space to a simpler form if possible, without changing the underlying fibration. More...
 
NLensSpaceisLensSpace () const
 Determines if this Seifert fibred space is a Lens space. More...
 
bool operator== (const NSFSpace &compare) const
 Determines whether this and the given structure contain precisely the same representations of precisely the same Seifert fibred spaces. More...
 
bool operator< (const NSFSpace &compare) const
 Determines in a fairly ad-hoc fashion whether this representation of this space is "smaller" than the given representation of the given space. More...
 
NTriangulationconstruct () const
 Returns a triangulation of this 3-manifold, if such a construction has been implemented. More...
 
NAbelianGroupgetHomologyH1 () const
 Returns the first homology group of this 3-manifold, if such a routine has been implemented. More...
 
std::ostream & writeName (std::ostream &out) const
 Writes the common name of this 3-manifold as a human-readable string to the given output stream. More...
 
std::ostream & writeTeXName (std::ostream &out) const
 Writes the common name of this 3-manifold in TeX format to the given output stream. More...
 
std::ostream & writeStructure (std::ostream &out) const
 Writes details of the structure of this 3-manifold that might not be evident from its common name to the given output stream. More...
 
- Public Member Functions inherited from regina::NManifold
virtual ~NManifold ()
 A destructor that does nothing. More...
 
std::string getName () const
 Returns the common name of this 3-manifold as a human-readable string. More...
 
std::string getTeXName () const
 Returns the common name of this 3-manifold in TeX format. More...
 
std::string getStructure () const
 Returns details of the structure of this 3-manifold that might not be evident from its common name. More...
 
bool operator< (const NManifold &compare) const
 Determines in a fairly ad-hoc fashion whether this representation of this 3-manifold is "smaller" than the given representation of the given 3-manifold. More...
 
virtual void writeTextShort (std::ostream &out) const
 Writes this object in short text format to the given output stream. More...
 
virtual void writeTextLong (std::ostream &out) const
 Writes this object in long text format to the given output stream. More...
 
- Public Member Functions inherited from regina::ShareableObject
 ShareableObject ()
 Default constructor that does nothing. More...
 
virtual ~ShareableObject ()
 Default destructor that does nothing. More...
 
std::string str () const
 Returns the output from writeTextShort() as a string. More...
 
std::string toString () const
 A deprecated alias for str(), which returns the output from writeTextShort() as a string. More...
 
std::string detail () const
 Returns the output from writeTextLong() as a string. More...
 
std::string toStringLong () const
 A deprecated alias for detail(), which returns the output from writeTextLong() as a string. More...
 

Additional Inherited Members

- Protected Member Functions inherited from regina::boost::noncopyable
 noncopyable ()
 A constructor which does nothing. More...
 
 ~noncopyable ()
 A destructor which does nothing. More...
 

Detailed Description

Represents a general Seifert fibred space, which may be orientable or non-orientable.

Punctures and reflector boundaries in the base orbifold are supported.

A Seifert fibred space whose base orbifold has no punctures or reflector boundaries can be placed into one of the six classes o1, o2, n1, n2, n3 and n4, as detailed on page 88 of "Seifert Manifolds", Peter Orlik, Springer-Verlag, 1972. These classes describe whether this base surface is orientable, as well as how many of its generators give fibre-reversing paths in the 3-manifold.

In the case where the base orbifold has punctures and/or reflector boundaries, we use the five simplified classes bo1, bo2, bn1, bn2 and bn3. These classes are not standard terminology (i.e., they have been created explicitly for Regina), and generally they do not provide enough information to uniquely identify the 3-manifold. They do however identify whether or not the base orbifold is orientable, and whether or not it contains any fibre-reversing paths.

When describing punctures and reflector boundaries, a twisted boundary is one that gives a fibre-reversing path, and an untwisted boundary is one around which the direction of fibres is preserved.

Exceptional fibres are sorted first by alpha (the index) and then by beta. The obstruction constant b is stored separately, though in output routines such as getName() and getStructure() it is merged in with the exceptional fibres. Specifically, it is merged in with the beta of the final exceptional fibre (replacing it with beta + b.alpha), or if there are no exceptional fibres then it is presented as a single (1,b) fibre.

The NManifold routines getHomologyH1() and construct() are only implemented in some cases. The getHomologyH1() routine is implemented if and only if the base orbifold has no punctures. The construct() routine is implemented only for lens spaces and Seifert fibred spaces over the 2-sphere without punctures or reflector boundaries.

Warning
In Regina 4.2.1 and earlier, this class was named NSFS. The new NSFSpace class was introduced with Regina 4.3, and has changed its behaviour in siginficant ways (becoming more general, as well as keeping the obstruction parameter b separate). Code that was written to work with the old NSFS class should be looked at closely before being adapted to the new NSFSpace class (i.e., it may require more than just substituting class names).
Test:
Included in the test suite.
Todo:

Feature (long-term): Implement recognition of more common names.

Feature (long-term): Implement triangulation construction and homology calculation for more Seifert fibred spaces.

Member Enumeration Documentation

Lists the six classes o1, o2, n1, n2, n3, n4 for base orbifolds without boundaries, plus five classes bo1, b02, bn1, bn2, bn3 for base orbifolds with boundaries.

Enumerator
o1 

Indicates that the base orbifold is orientable with no punctures or reflector boundaries, and that none of its generators give fibre-reversing paths.

o2 

Indicates that the base orbifold is orientable with no punctures or reflector boundaries, and that all of its generators give fibre-reversing paths.

n1 

Indicates that the base orbifold is non-orientable with no punctures or reflector boundaries, and that none of its generators give fibre-reversing paths.

n2 

Indicates that the base orbifold is non-orientable with no punctures or reflector boundaries, and that all of its generators give fibre-reversing paths.

n3 

Indicates that the base orbifold is non-orientable with no punctures or reflector boundaries, that it has non-orientable genus at least two, and that precisely one of its generators gives a fibre-reversing path.

n4 

Indicates that the base orbifold is non-orientable with no punctures or reflector boundaries, that it has non-orientable genus at least three, and that precisely two of its generators give fibre-reversing paths.

bo1 

Indicates that the base orbifold contains punctures and/or reflector boundaries, that it is orientable, and that it contains no fibre-reversing paths.

bo2 

Indicates that the base orbifold contains punctures and/or reflector boundaries, that it is orientable, and that it contains at least one fibre-reversing path.

bn1 

Indicates that the base orbifold contains punctures and/or reflector boundaries, that it is non-orientable, and that it contains no fibre-reversing paths.

bn2 

Indicates that the base orbifold contains punctures and/or reflector boundaries, that it is non-orientable, and that its fibre-reversing paths correspond precisely to its orientation-reversing paths.

bn3 

Indicates that the base orbifold contains punctures and/or reflector boundaries, that it is non-orientable, that it contains at least one fibre-reversing path, and that its fibre-reversing paths do not correspond precisely to its orientation-reversing paths.

Constructor & Destructor Documentation

regina::NSFSpace::NSFSpace ( )
inline

Creates a new Seifert fibred space with base orbifold the 2-sphere and no exceptional fibres.

regina::NSFSpace::NSFSpace ( NSFSpace::classType  useClass,
unsigned long  genus,
unsigned long  punctures = 0,
unsigned long  puncturesTwisted = 0,
unsigned long  reflectors = 0,
unsigned long  reflectorsTwisted = 0 
)
inline

Creates a new Seifert fibred space of the given class with the given base orbifold and no exceptional fibres.

Precondition
If there are no punctures or reflector boundary components, then useClass is one of the six classes o1, o2, n1, n2, n3 or n4. Likewise, if there are punctures and/or reflector boundary components, then useClass is one of the five classes bo1, bo2, bn1, bn2 or bn3.
If there are any twisted punctures or reflector boundary components, then useClass is either bo2 or bn3.
Parameters
useClassindicates whether the base orbifold is closed and/or orientable, and gives information about fibre-reversing paths in the 3-manifold. See the NSFSpace class notes and the classType enumeration notes for details.
genusthe genus of the base orbifold (the number of tori or projective planes that it contains). Note that for non-orientable base surfaces, this is the non-orientable genus.
puncturesthe number of untwisted ordinary boundary components of the base orbifold. Here "ordinary" means that the puncture gives rise to a real 3-manifold boundary (i.e., this is not a reflector boundary of the base orbifold).
puncturesTwistedthe number of twisted ordinary boundary components of the base orbifold. Here "ordinary" means that the puncture gives rise to a real 3-manifold boundary (i.e., this is not a reflector boundary of the base orbifold).
reflectorsthe number of untwisted reflector boundary components of the base orbifold. These are in addition to the ordinary boundary components described by punctures.
reflectorsTwistedthe number of twisted reflector boundary components of the base orbifold. These are in addition to the ordinary boundary components described by puncturesTwisted.
regina::NSFSpace::NSFSpace ( const NSFSpace cloneMe)
inline

Creates a new Seifert fibred space that is a clone of the given space.

Parameters
cloneMethe Seifert fibred space to clone.
regina::NSFSpace::~NSFSpace ( )
inlinevirtual

Destroys this Seifert fibred space.

Member Function Documentation

void regina::NSFSpace::addCrosscap ( bool  fibreReversing = false)

Inserts a new crosscap into the base orbifold.

This makes the base orbifold non-orientable, and increases its non-orientable genus by one. It is equivalent to removing a disc from the base orbifold and replacing it with a Mobius band.

Note that this operation may alter which of the classes described by classType this space belongs to.

The exceptional fibres and the obstruction constant b are not modified by this routine.

Parameters
fibreReversingtrue if the generator of the new crosscap should give a fibre-reversing curve in the overall 3-manifold, or false (the default) if it should preserve the directions of the fibres.
void regina::NSFSpace::addHandle ( bool  fibreReversing = false)

Inserts a new handle into the base orbifold.

This increases the orientable genus of the base orbifold by one, or the non-orientable genus by two. It is equivalent to removing a disc from the base orbifold and replacing it with a punctured torus.

Note that this operation may alter which of the classes described by classType this space belongs to.

The exceptional fibres and the obstruction constant b are not modified by this routine.

Parameters
fibreReversingtrue if one or both generators of the new handle should give fibre-reversing curves in the overall 3-manifold, or false (the default) if both generators should preserve the directions of the fibres.
void regina::NSFSpace::addPuncture ( bool  twisted = false,
unsigned long  nPunctures = 1 
)

Inserts one or more new punctures into the base orbifold.

The punctures may be twisted or untwisted.

Each puncture insertion is equivalent to removing a disc from the base orbifold. In the untwisted case this results in a new torus boundary for the 3-manifold, and in the twisted case it results in a new Klein bottle boundary.

The exceptional fibres and the obstruction constant b are not modified by this routine.

Parameters
twistedtrue if the new punctures should be twisted (i.e., their boundaries should be fibre-reversing), or false if the new punctures should be untwisted.
nPuncturesthe number of new punctures to insert.
void regina::NSFSpace::addReflector ( bool  twisted = false,
unsigned long  nReflectors = 1 
)

Adds one or more new reflector boundary components to the base orbifold.

The new reflector boundaries may be twisted or untwisted.

Each addition of a reflector boundary component is equivalent to removing a disc from the base orbifold and replacing it with an annulus with one reflector boundary.

In the untwisted case, it has the effect of removing a trivially fibred solid torus from the overall 3-manifold and replacing it with an appropriately fibred twisted I-bundle over the torus.

The exceptional fibres and the obstruction constant b are not modified by this routine.

Parameters
twistedtrue if the new reflector boundaries should be twisted (i.e., the boundaries should be fibre-reversing), or false if the new reflector boundaries should be untwisted.
nReflectorsthe number of new reflector boundaries to add.
NSFSpace::classType regina::NSFSpace::baseClass ( ) const
inline

Returns which of the eleven predefined classes this space belongs to.

The specific class indicates whether the base orbifold has punctures and/or reflector boundaries, whether the base orbifold is orientable, and gives information on fibre-reversing paths.

The class can be (indirectly) modified by calling addHandle(), addCrosscap(), addPuncture() or addReflector().

For more information on the eleven predefined classes, see the NSFSpace class notes or the classType enumeration notes.

Returns
the particular class to which this space belongs.
unsigned long regina::NSFSpace::baseGenus ( ) const
inline

Returns the genus of the base orbifold.

All punctures and reflector boundaries in the base orbifold are ignored (i.e., they are treated as though they had been replaced with ordinary filled discs).

The genus is the number of tori or projective planes that the base surface is formed from. In particular, if the base surface is non-orientable then this is the non-orientable genus.

Returns
the genus of the base orbifold.
bool regina::NSFSpace::baseOrientable ( ) const
inline

Returns whether or not the base surface is orientable.

Reflector boundary components of the base orbifold are not considered here.

The orientability of the base surface can be (indirectly) modified by calling addCrosscap().

Returns
true if and only if the base surface is orientable.
void regina::NSFSpace::complementAllFibres ( )

Replaces each exceptional fibre of the form (alpha, beta) with a fibre of the form (alpha, alpha - beta).

The obstruction constant b is not touched.

NTriangulation* regina::NSFSpace::construct ( ) const
virtual

Returns a triangulation of this 3-manifold, if such a construction has been implemented.

If no construction routine has yet been implemented for this 3-manifold (for instance, if this 3-manifold is a Seifert fibred space with sufficiently many exceptional fibres) then this routine will return 0.

The details of which 3-manifolds have construction routines can be found in the notes for the corresponding subclasses of NManifold. The default implemention of this routine returns 0.

Returns
a triangulation of this 3-manifold, or 0 if the appropriate construction routine has not yet been implemented.

Reimplemented from regina::NManifold.

NSFSFibre regina::NSFSpace::fibre ( unsigned long  which) const

Returns the requested exceptional fibre.

Fibres are stored in sorted order by alpha (the index) and then by beta. See the NSFSpace class notes for details.

Warning
This routine takes linear time (specifically, linear in the argument which).
Parameters
whichdetermines which fibre to return; this must be between 0 and getFibreCount()-1 inclusive.
Returns
the requested fibre.
unsigned long regina::NSFSpace::fibreCount ( ) const
inline

Returns the number of exceptional fibres in this Seifert fibred space.

Note that the obstruction parameter b is not included in this count. That is, any (1,k) fibres are ignored.

Returns
the number of exceptional fibres.
bool regina::NSFSpace::fibreNegating ( ) const
inline

Returns whether or not we can negate an exceptional fibre by passing it around the interior of the base orbifold.

That is, this routine determines whether a (p, q) exceptional fibre can become a (p, -q) exceptional fibre simply by sliding it around.

This is possible if either

  • the base orbifold has an orientation-reversing loop that does not reverse fibres in the 3-manifold, or
  • the base orbifold has an orientation-preserving loop that does reverse fibres in the 3-manifold.

Note that reflector boundary components, whilst making the overall 3-manifold non-orientable, have no bearing on the outcome of this routine.

Returns
true if and only an exceptional fibre can be reflected as described above.
bool regina::NSFSpace::fibreReversing ( ) const
inline

Returns whether or not this space contains any fibre-reversing paths.

Returns
true if and only if a fibre-reversing path exists.
NAbelianGroup* regina::NSFSpace::getHomologyH1 ( ) const
virtual

Returns the first homology group of this 3-manifold, if such a routine has been implemented.

If the calculation of homology has not yet been implemented for this 3-manifold then this routine will return 0.

The details of which 3-manifolds have homology calculation routines can be found in the notes for the corresponding subclasses of NManifold. The default implemention of this routine returns 0.

The homology group will be newly allocated and must be destroyed by the caller of this routine.

Returns
the first homology group of this 3-manifold, or 0 if the appropriate calculation routine has not yet been implemented.

Reimplemented from regina::NManifold.

void regina::NSFSpace::insertFibre ( const NSFSFibre fibre)
inline

Adds the given fibre to this Seifert fibred space.

This may be an exceptional fibre (alpha > 1) or it may be a regular fibre (alpha = 1). If it is a regular fibre, the obstruction constant b will be adjusted according to the value of beta.

Note that there is no restriction on the range of the second parameter beta. If it is out of the usual range 0 <= beta < alpha, it will be pulled back into this range and the excess will be pushed into the obstruction constant b.

Parameters
fibrethe fibre to insert. The first parameter of this fibre (i.e., its index) must be strictly positive, and the two parameters of this fibre must be coprime.
void regina::NSFSpace::insertFibre ( long  alpha,
long  beta 
)

Adds the given fibre to this Seifert fibred space.

This may be an exceptional fibre (alpha > 1) or it may be a regular fibre (alpha = 1). If it is a regular fibre, the obstruction constant b will be adjusted according to the value of beta.

Note that there is no restriction on the range of the second parameter beta. If it is out of the usual range 0 <= beta < alpha, it will be pulled back into this range and the excess will be pushed into the obstruction constant b.

Parameters
alphathe first parameter (i.e., the index) of the fibre to insert; this must be strictly positive.
betathe second parameter of the fibre to insert; this must have no common factors with the first parameter alpha.
NLensSpace* regina::NSFSpace::isLensSpace ( ) const

Determines if this Seifert fibred space is a Lens space.

If this is a Lens space, the NLensSpace returned will be newly created and it will be up to the caller of this routine to destroy it.

Returns
a structure containing the details of this Lens space, or null if this is not a Lens space.
long regina::NSFSpace::obstruction ( ) const
inline

Returns the obstruction constant b for this Seifert fibred space.

The obstruction constant corresponds to the insertion of an additional (1,b) fibre. It can be modified by calling insertFibre() with a value of alpha = 1. It will also be modified whenever insertFibre() is called with beta out of range (beta < 0 or beta >= alpha), since each exceptional fibre must be stored in standard form (0 <= beta < alpha).

Returns
the obstruction constant b.
bool regina::NSFSpace::operator< ( const NSFSpace compare) const

Determines in a fairly ad-hoc fashion whether this representation of this space is "smaller" than the given representation of the given space.

The ordering imposed on Seifert fibred space representations is purely aesthetic on the part of the author, and is subject to change in future versions of Regina. It also depends upon the particular representation, so that different representations of the same space may be ordered differently.

All that this routine really offers is a well-defined way of ordering Seifert fibred space representations.

Parameters
comparethe representation with which this will be compared.
Returns
true if and only if this is "smaller" than the given Seifert fibred space representation.
void regina::NSFSpace::operator= ( const NSFSpace cloneMe)

Modifies this Seifert fibred space to be a clone of the given space.

Parameters
cloneMethe Seifert fibred space to clone.
bool regina::NSFSpace::operator== ( const NSFSpace compare) const

Determines whether this and the given structure contain precisely the same representations of precisely the same Seifert fibred spaces.

Note that this routine examines the particular representation of the Seifert fibred space. Different Seifert parameters that give the same 3-manifold will be regarded as not equal by this routine.

Parameters
comparethe representation with which this will be compared.
Returns
true if and only if this and the given Seifert fibred space representations are identical.
unsigned long regina::NSFSpace::punctures ( ) const
inline

Returns the total number of punctures in the base orbifold.

In other words, this routine returns the total number of real torus or Klein bottle boundary components in the overall 3-manifold.

Note that reflector boundaries on the base orbifold are not counted here; only the ordinary boundary components that give rise to real 3-manifold boundaries are included.

Both untwisted and twisted punctures (giving rise to torus and Klein bottle boundaries respectively in the 3-manifold) are counted by this routine.

Returns
the total number of punctures.
unsigned long regina::NSFSpace::punctures ( bool  twisted) const
inline

Returns the number of punctures of the given type in the base orbifold.

In other words, this routine returns the number of real boundary components of the given type in the overall 3-manifold.

This routine either counts only twisted punctures (which give rise to Klein bottle boundaries), or only untwisted punctures (which give rise to torus boundaries).

Either way, reflector boundaries on the base orbifold are not counted here; only ordinary boundary components that give rise to real 3-manifold boundaries are considered.

Parameters
twistedtrue if only twisted punctures should be counted (those that give fibre-reversing paths and Klein bottle boundaries), or false if only untwisted punctures should be counted (those that are fibre-preserving and give torus boundaries).
Returns
the number of punctures of the given type.
void regina::NSFSpace::reduce ( bool  mayReflect = true)

Reduces the parameters of this Seifert fibred space to a simpler form if possible, without changing the underlying fibration.

In some cases the parameters of the Seifert fibred space may be simplified by taking a mirror image of the entire 3-manifold. The argument mayReflect signifies whether this is allowed.

This routine will not change the curves made by the fibres and the base orbifold on any boundary components (i.e., boundaries caused by punctures in the base orbifold).

Warning
If mayReflect is true then the entire 3-manifold might be replaced with its mirror image, in which case any subsequent modifications (such as inserting additional fibres or altering the base orbifold) may give unexpected results.
Parameters
mayReflecttrue if we are allowed to take a mirror image of the entire 3-manifold, or false if we are not.
void regina::NSFSpace::reflect ( )
inline

Replaces this space with its mirror image.

Specifically, all exceptional fibres and the obstruction constant b will be negated. Note that the obstruction constant will generally undergo further change as the exceptional fibres are standardised into the usual 0 <= beta < alpha form.

This routine will not change the curves made by the fibres and the base orbifold on any boundary components (i.e., boundaries caused by punctures in the base orbifold), with the exception that each base curve will be reflected.

Warning
The space is not reduced after reflecting. It may be that the space can be further simplified (especially in the case of non-orientable manifolds).
unsigned long regina::NSFSpace::reflectors ( ) const
inline

Returns the total number of reflector boundary components of the base orbifold.

This includes both twisted and untwisted reflector boundaries.

Returns
the total number of reflector boundary components.
unsigned long regina::NSFSpace::reflectors ( bool  twisted) const
inline

Returns the number of reflector boundary components of the given type in the base orbifold.

This either counts only twisted reflector boundaries, or only untwisted reflector boundaries.

Parameters
twistedtrue if only twisted reflector boundaries should be counted (those that give fibre-reversing paths), or false if only untwisted reflector boundaries should be counted.
Returns
the number of reflector boundaries of the given type.
std::ostream & regina::NSFSpace::writeName ( std::ostream &  out) const
inlinevirtual

Writes the common name of this 3-manifold as a human-readable string to the given output stream.

Python:
The parameter out does not exist; standard output will be used.
Parameters
outthe output stream to which to write.
Returns
a reference to the given output stream.

Implements regina::NManifold.

std::ostream & regina::NSFSpace::writeStructure ( std::ostream &  out) const
inlinevirtual

Writes details of the structure of this 3-manifold that might not be evident from its common name to the given output stream.

For instance, for an orbit space S^3/G this routine might write the full Seifert structure.

This routine may write nothing if no additional details are deemed necessary. The default implementation of this routine behaves in this way.

Python:
The parameter out does not exist; standard output will be used.
Parameters
outthe output stream to which to write.
Returns
a reference to the given output stream.

Reimplemented from regina::NManifold.

std::ostream & regina::NSFSpace::writeTeXName ( std::ostream &  out) const
inlinevirtual

Writes the common name of this 3-manifold in TeX format to the given output stream.

No leading or trailing dollar signs will be included.

Warning
The behaviour of this routine has changed as of Regina 4.3; in earlier versions, leading and trailing dollar signs were provided.
Python:
The parameter out does not exist; standard output will be used.
Parameters
outthe output stream to which to write.
Returns
a reference to the given output stream.

Implements regina::NManifold.


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

Copyright © 1999-2013, 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).