snappy 3.1.1__cp39-cp39-win_amd64.whl → 3.2__cp39-cp39-win_amd64.whl

snappy/doc/_sources/other.rst.txt

@@ -1,25 +1,25 @@
-Other components
-===================
-
-SnapPy incorporates:
-
-Ptolemy module
---------------
-
-The `ptolemy module <http://www.unhyperbolic.org/ptolemy.html>`_ for
-studying representations of 3-manifold groups into SL(*N*, **C**) and
-PSL(*N*, **C**).  By `Matthias Goerner
-<http://www.unhyperbolic.org/>`_.
-
-.. toctree::
-   :maxdepth: 3
-
-   ptolemy
-
-Twister
--------
-
-`Twister <https://github.com/MarkCBell/twister>`_ for building
-surface bundles and Heegaard splittings from mapping class group
-data.  By Marc Bell, Tracy Hall, and Saul Schleimer.
-	
+Other components
+===================
+
+SnapPy incorporates:
+
+Ptolemy module
+--------------
+
+The `ptolemy module <http://www.unhyperbolic.org/ptolemy.html>`_ for
+studying representations of 3-manifold groups into SL(*N*, **C**) and
+PSL(*N*, **C**).  By `Matthias Goerner
+<http://www.unhyperbolic.org/>`_.
+
+.. toctree::
+   :maxdepth: 3
+
+   ptolemy
+
+Twister
+-------
+
+`Twister <https://github.com/MarkCBell/twister>`_ for building
+surface bundles and Heegaard splittings from mapping class group
+data.  By Marc Bell, Tracy Hall, and Saul Schleimer.
+	

snappy/doc/_sources/platonic_census.rst.txt

@@ -1,20 +1,20 @@
-Censuses of Platonic manifolds
-==============================
-
-The following manifolds were tabulated in `A census of tetrahedral manifolds <http://arxiv.org/abs/1502.00383>`_ and `A census of Platonic manifolds and augmented knotted trivalent graphs <http://arxiv.org/abs/1602.02208v2>`_. An even larger census of Platonic manifolds can be downloaded `here <http://unhyperbolic.org/platonicCensus/large/platonicCensus_large_snappy_only.tar.bz2>`_.
-
-..   currentmodule:: snappy
-..   autodata:: TetrahedralOrientableCuspedCensus
-..   autodata:: TetrahedralNonorientableCuspedCensus
-..   autodata:: OctahedralOrientableCuspedCensus
-..   autodata:: OctahedralNonorientableCuspedCensus
-..   autodata:: CubicalOrientableCuspedCensus
-..   autodata:: CubicalNonorientableCuspedCensus
-..   autodata:: DodecahedralOrientableCuspedCensus
-..   autodata:: DodecahedralNonorientableCuspedCensus
-..   autodata:: IcosahedralOrientableClosedCensus
-..   autodata:: IcosahedralNonorientableClosedCensus
-..   autodata:: CubicalOrientableClosedCensus
-..   autodata:: CubicalNonorientableClosedCensus
-..   autodata:: DodecahedralOrientableClosedCensus
-..   autodata:: DodecahedralNonorientableClosedCensus
+Censuses of Platonic manifolds
+==============================
+
+The following manifolds were tabulated in `A census of tetrahedral manifolds <http://arxiv.org/abs/1502.00383>`_ and `A census of Platonic manifolds and augmented knotted trivalent graphs <http://arxiv.org/abs/1602.02208v2>`_. An even larger census of Platonic manifolds can be downloaded `here <http://unhyperbolic.org/platonicCensus/large/platonicCensus_large_snappy_only.tar.bz2>`_.
+
+..   currentmodule:: snappy
+..   autodata:: TetrahedralOrientableCuspedCensus
+..   autodata:: TetrahedralNonorientableCuspedCensus
+..   autodata:: OctahedralOrientableCuspedCensus
+..   autodata:: OctahedralNonorientableCuspedCensus
+..   autodata:: CubicalOrientableCuspedCensus
+..   autodata:: CubicalNonorientableCuspedCensus
+..   autodata:: DodecahedralOrientableCuspedCensus
+..   autodata:: DodecahedralNonorientableCuspedCensus
+..   autodata:: IcosahedralOrientableClosedCensus
+..   autodata:: IcosahedralNonorientableClosedCensus
+..   autodata:: CubicalOrientableClosedCensus
+..   autodata:: CubicalNonorientableClosedCensus
+..   autodata:: DodecahedralOrientableClosedCensus
+..   autodata:: DodecahedralNonorientableClosedCensus

snappy/doc/_sources/plink.rst.txt

@@ -1,102 +1,102 @@
-.. Documentation of the plink part of SnapPy
-
-Using SnapPy's link editor
-=================================
-
-PLink draws piecewise linear link projections.  Components may be
-points, PL arcs, or PL circles.  Line segments are oriented consistently in
-each component.  Different components are different colors.
-
-..  image:: plink-action.png
-    :align: right
-
-To invoke the link editor, do::
-
-  In[5]:  M = Manifold()
-
-Once you've drawn the link, select the menu item "PLink->Tools->Send to
-SnapPy", and then *M* will be the complement of the link.  If you edit
-the link, you can again do "Send to SnapPy" to update *M*.  
-
-Drawing Basics
-------------------------------
-
-* When using the mouse to draw a link with PLink, you should always
-  *click-and-release*.  Do not hold the mouse button down while drawing.
-  PLink requires only the left mouse button.
- 
-* The default state of the editor is indicated by the arrow cursor.
-  In this state, click-and-release the left mouse button on the
-  background to place a starting vertex and begin drawing.  The vertex
-  will be connected to the pencil cursor by a thin red line.
-  Click-and-release to place a second vertex.  The two vertices will
-  then be joined by an edge. Continue to draw other vertices and edges
-  to your heart's content.
-
-* To stop drawing, either click twice on the same vertex to create an
-  arc, or click on an endpoint vertex.  The latter operation will
-  either create a circle component or join together two arc
-  components.
-
-* When the cursor hovers over a vertex it changes to the pointing
-  finger.  From this state you can drag a vertex to a new location
-  with a click-and-release on the vertex. The vertex will become
-  enclosed in a circular cursor.  Move it to where you want it to go
-  and click the left (or middle) button to place it.  If you drag one
-  endpoint on top of another, they will meld.
-
-* When the cursor hovers over an edge, not too close to a vertex or
-  crossing, it changes to the push-me-pull-you cursor.  Clicking in
-  this state will change the orientation of the component containing
-  the edge.
-
-* When the cursor hovers over a crossing it changes to the yin-yang
-  recycling cursor.  Clicking while in this state changes the the
-  handedness of the crossing.
-
-* Double-clicking on an endpoint vertex will restart drawing from
-  that vertex.  Double-clicking on a non-endpoint vertex will break
-  the link at that point and begin drawing with the old incoming edge.
-
-* While in drawing state, hitting the Delete key removes the last
-  vertex before the cursor.  If no vertices remain, the drawing state
-  ends and the active component is removed.  This can be used to
-  remove a segment from the diagram.  Double-click a vertex; hit
-  Delete to remove the incoming segment at that vertex; then click the
-  vertex again to reconnect.
-
-* You will not be allowed to create edges that pass too close to a
-  vertex or a crossing, or to place vertices too close to edges or to
-  crossings or to other vertices.  If you attempt to do any of these
-  things, PLink will flash the drawing canvas.
-
-Miscellaneous Features
----------------------------------
-
-The window can be resized to allow for different sizes of link
-projections, and the arrow keys can be used to slide the projection
-around in order to make more room on one side or another.
-
-The "Tools" menu can be used to make the projection alternating
-(provided that all components are circles), or to clear the screen,
-or to reflect the projection in the xy-plane, changing all crossings.
-Also, the "Tools" menu includes the "send to SnapPy" command.
-
-The "File" menu can be used to save the projection as a SnapPea
-link projection file.  (This can be done from the drawing state as
-well, in which case the "hot vertex" is remembered in the file!).  The
-"File->Open File" command will read a SnapPea link projection file,
-and restart drawing if the projection was saved while drawing.
-
-The "Info" menu selects information about the link projection to be
-displayed in the info line at the bottom.  Various encoding schemes
-for link projections are supported, as well as the blackboard framing
-curves, expressed in meridian-longitude coordinates.  Cutting and
-pasting from the info line is supported.  The numerical and
-alphabetical Dowker-Thistlethwaite codes are displayed in an extended
-form which includes a full description of the planar embedding.  The
-string printed in the info line is also accepted as input to SnapPy's
-Manifold constructor.  That is, you can paste the complete DT code,
-for example ``DT: [(-4,6,2)], [0,0,1]``, between the apostrophes in
-Manifold('').  The "DT labels" option displays the indexing used in
-computing the Dowker-Thistlethwaite codes.
+.. Documentation of the plink part of SnapPy
+
+Using SnapPy's link editor
+=================================
+
+PLink draws piecewise linear link projections.  Components may be
+points, PL arcs, or PL circles.  Line segments are oriented consistently in
+each component.  Different components are different colors.
+
+..  image:: plink-action.png
+    :align: right
+
+To invoke the link editor, do::
+
+  In[5]:  M = Manifold()
+
+Once you've drawn the link, select the menu item "PLink->Tools->Send to
+SnapPy", and then *M* will be the complement of the link.  If you edit
+the link, you can again do "Send to SnapPy" to update *M*.  
+
+Drawing Basics
+------------------------------
+
+* When using the mouse to draw a link with PLink, you should always
+  *click-and-release*.  Do not hold the mouse button down while drawing.
+  PLink requires only the left mouse button.
+ 
+* The default state of the editor is indicated by the arrow cursor.
+  In this state, click-and-release the left mouse button on the
+  background to place a starting vertex and begin drawing.  The vertex
+  will be connected to the pencil cursor by a thin red line.
+  Click-and-release to place a second vertex.  The two vertices will
+  then be joined by an edge. Continue to draw other vertices and edges
+  to your heart's content.
+
+* To stop drawing, either click twice on the same vertex to create an
+  arc, or click on an endpoint vertex.  The latter operation will
+  either create a circle component or join together two arc
+  components.
+
+* When the cursor hovers over a vertex it changes to the pointing
+  finger.  From this state you can drag a vertex to a new location
+  with a click-and-release on the vertex. The vertex will become
+  enclosed in a circular cursor.  Move it to where you want it to go
+  and click the left (or middle) button to place it.  If you drag one
+  endpoint on top of another, they will meld.
+
+* When the cursor hovers over an edge, not too close to a vertex or
+  crossing, it changes to the push-me-pull-you cursor.  Clicking in
+  this state will change the orientation of the component containing
+  the edge.
+
+* When the cursor hovers over a crossing it changes to the yin-yang
+  recycling cursor.  Clicking while in this state changes the the
+  handedness of the crossing.
+
+* Double-clicking on an endpoint vertex will restart drawing from
+  that vertex.  Double-clicking on a non-endpoint vertex will break
+  the link at that point and begin drawing with the old incoming edge.
+
+* While in drawing state, hitting the Delete key removes the last
+  vertex before the cursor.  If no vertices remain, the drawing state
+  ends and the active component is removed.  This can be used to
+  remove a segment from the diagram.  Double-click a vertex; hit
+  Delete to remove the incoming segment at that vertex; then click the
+  vertex again to reconnect.
+
+* You will not be allowed to create edges that pass too close to a
+  vertex or a crossing, or to place vertices too close to edges or to
+  crossings or to other vertices.  If you attempt to do any of these
+  things, PLink will flash the drawing canvas.
+
+Miscellaneous Features
+---------------------------------
+
+The window can be resized to allow for different sizes of link
+projections, and the arrow keys can be used to slide the projection
+around in order to make more room on one side or another.
+
+The "Tools" menu can be used to make the projection alternating
+(provided that all components are circles), or to clear the screen,
+or to reflect the projection in the xy-plane, changing all crossings.
+Also, the "Tools" menu includes the "send to SnapPy" command.
+
+The "File" menu can be used to save the projection as a SnapPea
+link projection file.  (This can be done from the drawing state as
+well, in which case the "hot vertex" is remembered in the file!).  The
+"File->Open File" command will read a SnapPea link projection file,
+and restart drawing if the projection was saved while drawing.
+
+The "Info" menu selects information about the link projection to be
+displayed in the info line at the bottom.  Various encoding schemes
+for link projections are supported, as well as the blackboard framing
+curves, expressed in meridian-longitude coordinates.  Cutting and
+pasting from the info line is supported.  The numerical and
+alphabetical Dowker-Thistlethwaite codes are displayed in an extended
+form which includes a full description of the planar embedding.  The
+string printed in the info line is also accepted as input to SnapPy's
+Manifold constructor.  That is, you can paste the complete DT code,
+for example ``DT: [(-4,6,2)], [0,0,1]``, between the apostrophes in
+Manifold('').  The "DT labels" option displays the indexing used in
+computing the Dowker-Thistlethwaite codes.

snappy/doc/_sources/ptolemy.rst.txt

@@ -1,66 +1,66 @@
-The ptolemy module
-==================
-
-..   automodule:: snappy.ptolemy
-		  
-What is the ptolemy module?
----------------------------
-
-This module provides tools to find boundary-unipotent representations of an
-oriented
-3-manifold into PSL(*N*, **C**). It was used, for example, to generate the tables
-of representations at
-`ptolemy.unhyperbolic.org <http://ptolemy.unhyperbolic.org/html/summary.html>`_.
-
-The ptolemy module can use `magma <http://magma.maths.usyd.edu.au/magma/>`_ for
-the computations necessary to find the representations or it can automatically
-retrieve the necessary computations from a database we provide that contains the
-computations for all manifolds and *N* at
-`ptolemy.unhyperbolic.org <http://ptolemy.unhyperbolic.org/html/summary.html>`_.
-In particular, the database includes the computations for all orientable census
-manifolds for PSL(2, **C**) and the examples below work without magma for these
-manifolds.
-This makes it useful for people who do not have magma (see :ref:`here <ptolemy-example-retrieve-exact-solutions>`).
-
-The ptolemy module is still under development. Please report bugs or email suggestions to: enischte at gmail dot com.
-
-Examples of what the Ptolemy module can do:
-
-* Give the :ref:`equations for the reduced Ptolemy varieties<ptolemy-example-basic>` to find all :ref:`generically decorated <ptolemy-generically-decorated>` and :ref:`boundary-unipotent <ptolemy-boundary-unipotent>` representations into SL(*N*, **C**).
-* Same for representations into PSL(*N*, **C**) using :ref:`Obstruction classes <ptolemy-example-obstruction-class>`.
-* Retrieve the :ref:`exact <ptolemy-example-retrieve-exact-solutions>` and :ref:`numerical <ptolemy-example-retrieve-numerical-solutions>` solutions for these varieties.
-* Compute the matrices for these representations :ref:`exactly <ptolemy-example-matrices>` or :ref:`numerically <ptolemy-example-numerical-matrix>` given a generator of or word in the fundamental group.
-* Compute the :ref:`traces <ptolemy-example-traces>` for these matrices.
-* Compute the :ref:`trace field <ptolemy-examples-trace-field>` of the representation.
-* Compute the :ref:`boundary holonomy <ptolemy-example-boundary-holonomy>`.
-* Compute the corresponding :ref:`shape parameters/cross ratios <ptolemy-example-cross-ratios>` for a representation.
-* Compute the :ref:`volume <ptolemy-example-volume>` and :ref:`complex volume <ptolemy-example-complex-volume>` (volume + i Chern-Simons) for a representation.
-* Compute solutions to the Ptolemy varieties :ref:`using magma or sage <ptolemy-example-using-magma-sage>`.
-* Find :ref:`positively dimensional components <ptolemy-non-zero-dim-comp>` of the Ptolemy variety.
-* Find :ref:`positively dimensional families <ptolemy-example-non-zero-dim-rep>` of boundary-unipotent representations.
-
-The ptolemy module tries to have powerful and flexible functionality but at the same time be easy to use. For example, we can get the volumes of boundary-unipotent PSL(2, **C**)-representations of ``m011`` in just one line::
-
-    >>> Manifold("m011").ptolemy_variety(2,'all').retrieve_solutions().volume_numerical()
-    [[[-4.30211422042248 E-16, -0.942707362776931, 0.942707362776931]],
-     [[4.64255370258293 E-15, 3.94215909915729 E-15, -2.78183391239608, 2.78183391239608]]]
-
-Here, we see that ``m011`` has a representation that is not Galois-conjugate to the geometric representation and that has the volume 0.9427... of the Weeks manifold.
-
-**Remark:** Please check your Internet connection if the above example does not work.
-
-Documentation
--------------
-
-.. toctree::
-   :maxdepth: 2
-
-   ptolemy_prelim
-   ptolemy_examples1
-   ptolemy_examples2
-   ptolemy_examples3
-   ptolemy_examples4
-   ptolemy_classes
-
-
-
+The ptolemy module
+==================
+
+..   automodule:: snappy.ptolemy
+		  
+What is the ptolemy module?
+---------------------------
+
+This module provides tools to find boundary-unipotent representations of an
+oriented
+3-manifold into PSL(*N*, **C**). It was used, for example, to generate the tables
+of representations at
+`ptolemy.unhyperbolic.org <http://ptolemy.unhyperbolic.org/html/summary.html>`_.
+
+The ptolemy module can use `magma <http://magma.maths.usyd.edu.au/magma/>`_ for
+the computations necessary to find the representations or it can automatically
+retrieve the necessary computations from a database we provide that contains the
+computations for all manifolds and *N* at
+`ptolemy.unhyperbolic.org <http://ptolemy.unhyperbolic.org/html/summary.html>`_.
+In particular, the database includes the computations for all orientable census
+manifolds for PSL(2, **C**) and the examples below work without magma for these
+manifolds.
+This makes it useful for people who do not have magma (see :ref:`here <ptolemy-example-retrieve-exact-solutions>`).
+
+The ptolemy module is still under development. Please report bugs or email suggestions to: enischte at gmail dot com.
+
+Examples of what the Ptolemy module can do:
+
+* Give the :ref:`equations for the reduced Ptolemy varieties<ptolemy-example-basic>` to find all :ref:`generically decorated <ptolemy-generically-decorated>` and :ref:`boundary-unipotent <ptolemy-boundary-unipotent>` representations into SL(*N*, **C**).
+* Same for representations into PSL(*N*, **C**) using :ref:`Obstruction classes <ptolemy-example-obstruction-class>`.
+* Retrieve the :ref:`exact <ptolemy-example-retrieve-exact-solutions>` and :ref:`numerical <ptolemy-example-retrieve-numerical-solutions>` solutions for these varieties.
+* Compute the matrices for these representations :ref:`exactly <ptolemy-example-matrices>` or :ref:`numerically <ptolemy-example-numerical-matrix>` given a generator of or word in the fundamental group.
+* Compute the :ref:`traces <ptolemy-example-traces>` for these matrices.
+* Compute the :ref:`trace field <ptolemy-examples-trace-field>` of the representation.
+* Compute the :ref:`boundary holonomy <ptolemy-example-boundary-holonomy>`.
+* Compute the corresponding :ref:`shape parameters/cross ratios <ptolemy-example-cross-ratios>` for a representation.
+* Compute the :ref:`volume <ptolemy-example-volume>` and :ref:`complex volume <ptolemy-example-complex-volume>` (volume + i Chern-Simons) for a representation.
+* Compute solutions to the Ptolemy varieties :ref:`using magma or sage <ptolemy-example-using-magma-sage>`.
+* Find :ref:`positively dimensional components <ptolemy-non-zero-dim-comp>` of the Ptolemy variety.
+* Find :ref:`positively dimensional families <ptolemy-example-non-zero-dim-rep>` of boundary-unipotent representations.
+
+The ptolemy module tries to have powerful and flexible functionality but at the same time be easy to use. For example, we can get the volumes of boundary-unipotent PSL(2, **C**)-representations of ``m011`` in just one line::
+
+    >>> Manifold("m011").ptolemy_variety(2,'all').retrieve_solutions().volume_numerical()
+    [[[-4.30211422042248 E-16, -0.942707362776931, 0.942707362776931]],
+     [[4.64255370258293 E-15, 3.94215909915729 E-15, -2.78183391239608, 2.78183391239608]]]
+
+Here, we see that ``m011`` has a representation that is not Galois-conjugate to the geometric representation and that has the volume 0.9427... of the Weeks manifold.
+
+**Remark:** Please check your Internet connection if the above example does not work.
+
+Documentation
+-------------
+
+.. toctree::
+   :maxdepth: 2
+
+   ptolemy_prelim
+   ptolemy_examples1
+   ptolemy_examples2
+   ptolemy_examples3
+   ptolemy_examples4
+   ptolemy_classes
+
+
+

snappy/doc/_sources/ptolemy_classes.rst.txt

@@ -1,42 +1,42 @@
-Classes
-==============================
-
-PtolemyVariety
---------------
-
-..   autoclass:: snappy.ptolemy.ptolemyVariety.PtolemyVariety
-     :members:
-
-PtolemyCoordinates
-------------------
-
-..   autoclass:: snappy.ptolemy.coordinates.PtolemyCoordinates
-     :members:
-
-CrossRatios
------------
-
-..   autoclass:: snappy.ptolemy.coordinates.CrossRatios
-     :members:
-
-Flattenings
------------
-
-..   autoclass:: snappy.ptolemy.coordinates.Flattenings
-     :members:
-
-NonZeroDimensionalComponent
----------------------------
-
-..   autoclass:: snappy.ptolemy.component.NonZeroDimensionalComponent
-     :members:
-
-Other functions
----------------
-
-..   autofunction:: snappy.ptolemy.solutions_from_magma
-
-..   autofunction:: snappy.ptolemy.solutions_from_magma_file
-
-
-.. [FKR2013] Falbel, Koseleff, Rouillier: Representations of Fundamental Groups of 3-Manifolds into PGL(3,C): Exact Computations in Low Complexity, http://arxiv.org/abs/1307.6697
+Classes
+==============================
+
+PtolemyVariety
+--------------
+
+..   autoclass:: snappy.ptolemy.ptolemyVariety.PtolemyVariety
+     :members:
+
+PtolemyCoordinates
+------------------
+
+..   autoclass:: snappy.ptolemy.coordinates.PtolemyCoordinates
+     :members:
+
+CrossRatios
+-----------
+
+..   autoclass:: snappy.ptolemy.coordinates.CrossRatios
+     :members:
+
+Flattenings
+-----------
+
+..   autoclass:: snappy.ptolemy.coordinates.Flattenings
+     :members:
+
+NonZeroDimensionalComponent
+---------------------------
+
+..   autoclass:: snappy.ptolemy.component.NonZeroDimensionalComponent
+     :members:
+
+Other functions
+---------------
+
+..   autofunction:: snappy.ptolemy.solutions_from_magma
+
+..   autofunction:: snappy.ptolemy.solutions_from_magma_file
+
+
+.. [FKR2013] Falbel, Koseleff, Rouillier: Representations of Fundamental Groups of 3-Manifolds into PGL(3,C): Exact Computations in Low Complexity, http://arxiv.org/abs/1307.6697