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

snappy/doc/_sources/index.rst.txt

@@ -1,115 +1,182 @@
-.. SnapPy documentation master file
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
-======
-SnapPy
-======
-
-What is SnapPy?
-===============
-
-..  image:: images/SnapPy-196.png
-    :align: right
-    :alt: SnapPy logo
-
-
-SnapPy is a program for studying the topology and geometry of
-3-manifolds, with a focus on hyperbolic structures.  It runs on Mac OS
-X, Linux, and Windows, and combines a link editor and 3D-graphics for
-Dirichlet domains and cusp neighborhoods with a powerful command-line
-interface based on the Python_ programming language. You can see it
-:doc:`in action<screenshots>`, learn how to :doc:`install<installing>`
-it, and watch the :doc:`tutorial<tutorial>`.
-
-.. _Python: http://python.org
-
-News
-====
-
-* Version 3.1 (May 2023):
-
-  - A method :meth:`exterior_to_link <snappy.Manifold.exterior_to_link>`
-    for going from a link exterior to a link diagram taken from
-    `Dunfield-Obeidin-Rudd <https://arxiv.org/abs/2112.03251>`_.
-
-  - Covers now computed by the stand-alone `low_index
-    <https://pypi.org/project/low-index/>`_ module, which uses
-    multiple processor cores and is typically much faster than the old
-    code.  In some cases, it is dramatically faster than even GAP or
-    Magma.
-
-  - Added geodesics to the :meth:`inside_view
-    <snappy.Manifold.inside_view>`.  Here are some intersecting tubes
-    about closed geodesics in the manifold ``v3539(5,1)``:
-
-    .. image:: images/geodesics.jpg
-       :width: 50%
-       :align: center
-       :alt: Geodesic tubes for v3539(5,1)
-
-  - Added drilling any simple geodesic with :meth:`drill_word
-    <snappy.Manifold.drill_word>` and :meth:`drill_words
-    <snappy.Manifold.drill_words>`, not just those that are
-    :meth:`combinatorially simple <snappy.Manifold.dual_curves>`.
-
-  - Added `ignore_orientation` flag to :meth:`triangulation_isosig
-    <snappy.Triangulation.triangulation_isosig>`.
-
-  - Added `include_words` flag to :meth:`length_spectrum
-    <snappy.Manifold.length_spectrum>` for getting the word
-    corresponding to a geodesic which can be given to
-    :meth:`drill_word <snappy.Manifold.drill_word>`.
-
-  - Support for Python 3.11 and SageMath 10.0.
-
-  - Modernized styling of the documentation.
-
-* Version 3.0.3 (December 2021):
-
-  - Runs natively on Macs with Apple Silicon processors (M1, M2, and variants).
-
-* :doc:`Complete version history <news>`.
-
-Documentation
-=============
-
-.. toctree::
-   :maxdepth: 1
-
-   installing
-   screenshots
-   tutorial
-   snappy
-   plink
-   spherogram
-   snap
-   verify
-   other
-   news
-   credits
-   bugs
-   todo
-   development
-
-Credits
-=======
-
-Written by `Marc Culler <http://www.math.uic.edu/~culler>`_, `Nathan
-Dunfield <http://dunfield.info>`_, and `Matthias Goerner
-<http://www.unhyperbolic.org/>`_ using the SnapPea kernel written by
-`Jeff Weeks <http://www.geometrygames.org>`_, with contributions from
-:doc:`many others <credits>`.  If you use SnapPy in your work, please
-:ref:`cite it as described here <credits:Citing SnapPy>`.  If you
-encounter problems with SnapPy, :doc:`please report them <bugs>`.
-
-Released under the terms of the `GNU General Public License
-<http://www.gnu.org/licenses/gpl-2.0.txt>`_, version 2 or later.
-
-The development of SnapPy was partially supported by grants from the
-National Science Foundation, including DMS-0707136, DMS-0906155,
-DMS-1105476, DMS-1510204, DMS-1811156, and the Institute for
-Computational and Experimental Research in Mathematics. Any opinions,
-findings, and conclusions or recommendations expressed on this site
-are those of the authors and do not necessarily reflect the views of
-the National Science Foundation.
+.. SnapPy documentation master file
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+======
+SnapPy
+======
+
+What is SnapPy?
+===============
+
+..  image:: images/SnapPy-196.png
+    :align: right
+    :alt: SnapPy logo
+
+
+SnapPy is a program for studying the topology and geometry of
+3-manifolds, with a focus on hyperbolic structures.  It runs on Mac OS
+X, Linux, and Windows, and combines a link editor and 3D-graphics for
+Dirichlet domains and cusp neighborhoods with a powerful command-line
+interface based on the Python_ programming language. You can see it
+:doc:`in action<screenshots>`, learn how to :doc:`install<installing>`
+it, and watch the :doc:`tutorial<tutorial>`.
+
+.. _Python: http://python.org
+
+News
+====
+
+* Version 3.2 (January 2025):
+
+  - An alternative implementation of the length spectrum. It supports verified
+    computations and is significantly faster in some cases. See
+    :meth:`length_spectrum_alt <snappy.Manifold.length_spectrum_alt>`
+    and
+    :meth:`length_spectrum_alt_gen <snappy.Manifold.length_spectrum_alt_gen>`.
+
+  - :meth:`isometry_signature <snappy.Manifold.isometry_signature>` now also
+    works for closed manifolds.
+
+  - A paper plane or eye ball in the
+    :meth:`inside_view <snappy.Manifold.inside_view>` showing the position
+    and bearing of the user in the hyperbolic manifold. By default, we now show
+    the paper plane instead of the edges of the triangulation so that the view
+    is intrinsic to the manifold. The geodesics window now also features a
+    button to put the camera onto a geodesic. Here are some examples:
+
+    .. list-table::
+       :width: 100%
+       :class: borderless
+
+       * - .. image:: images/o9_00000_systole_paper_plane.jpg
+              :width: 90%
+              :align: center
+              :alt: Paper plane near shortest geodesic of o9_00000
+         - .. image:: images/o9_00000_systole_paper_plane_closer.jpg
+              :width: 90%
+              :align: center
+              :alt: Paper plane very near shortest geodesic of o9_00000
+         - .. image:: images/m004_paper_plane_on_systole.jpg
+              :width: 90%
+              :align: center
+              :alt: Paper plane on shortest geodesic of m004
+         - .. image:: images/m125_paper_plane.jpg
+              :width: 90%
+              :align: center
+              :alt: Paper plane coming out of a cusp of m125
+
+  - A faster and more robust algorithm to the compute maximal cusp area matrix.
+    The new algorithm is now the default for
+    :meth:`~snappy.Manifold.cusp_area_matrix`,
+    :meth:`~snappy.Manifold.cusp_areas`,
+    :meth:`~snappy.Manifold.short_slopes` and
+    :meth:`~snappy.Manifold.cusp_translations`.
+
+  - New options ``ignore_curves`` and ``ignore_filling_orientations``
+    for :meth:`~snappy.Triangulation.triangulation_isosig`. Also
+    fixing a subtle bug where the filling coefficients returned by
+    :meth:`triangulation_isosig <snappy.Triangulation.triangulation_isosig>` were
+    not canonical when ``ignore_curve_orientations = True``.
+
+  - :meth:`~snappy.Manifold.canonical_retriangulation`
+    and
+    :meth:`~snappy.Manifold.isometry_signature` fail with
+    exceptions rather than silently returning ``None``. In particular, it now
+    safe to compare isometry signatures (without further checks) to determine
+    whether M and N are isometric hyperbolic manifolds::
+
+        >>> M.isometry_signature(verified=True) == N.isometry_signature(verified=True)
+
+  - Bug fix to :meth:`slice_obstruction_HKL
+    <snappy.Manifold.slice_obstruction_HKL>`: earlier versions
+    incorrectly allowed looking at mod 2 homology of the branched
+    cover, where the theory does not directly apply.
+
+  - New self-contained SnapPy application for Linux. 
+  
+  - Support for Python 3.13 and SageMath 10.5.
+
+    
+* Versions 3.1 (May 2023) and 3.1.1 (June 2023):
+
+  - A method :meth:`exterior_to_link <snappy.Manifold.exterior_to_link>`
+    for going from a link exterior to a link diagram taken from
+    `Dunfield-Obeidin-Rudd <https://arxiv.org/abs/2112.03251>`_.
+
+  - Covers now computed by the stand-alone `low_index
+    <https://pypi.org/project/low-index/>`_ module, which uses
+    multiple processor cores and is typically much faster than the old
+    code.  In some cases, it is dramatically faster than even GAP or
+    Magma.
+
+  - Added geodesics to the :meth:`inside_view
+    <snappy.Manifold.inside_view>`.  Here are some intersecting tubes
+    about closed geodesics in the manifold ``v3539(5,1)``:
+
+    .. image:: images/geodesics.jpg
+       :width: 50%
+       :align: center
+       :alt: Geodesic tubes for v3539(5,1)
+
+  - Added drilling any simple geodesic with :meth:`drill_word
+    <snappy.Manifold.drill_word>` and :meth:`drill_words
+    <snappy.Manifold.drill_words>`, not just those that are
+    :meth:`combinatorially simple <snappy.Manifold.dual_curves>`.
+
+  - Added `ignore_orientation` flag to :meth:`triangulation_isosig
+    <snappy.Triangulation.triangulation_isosig>`.
+
+  - Added `include_words` flag to :meth:`length_spectrum
+    <snappy.Manifold.length_spectrum>` for getting the word
+    corresponding to a geodesic which can be given to
+    :meth:`drill_word <snappy.Manifold.drill_word>`.
+
+  - Support for Python 3.11 and SageMath 10.0.
+
+  - Modernized styling of the documentation.
+
+* :doc:`Complete version history <news>`.
+
+Documentation
+=============
+
+.. toctree::
+   :maxdepth: 1
+
+   installing
+   screenshots
+   tutorial
+   snappy
+   plink
+   spherogram
+   snap
+   verify
+   other
+   news
+   credits
+   bugs
+   todo
+   development
+
+Credits
+=======
+
+Written by `Marc Culler <http://www.math.uic.edu/~culler>`_, `Nathan
+Dunfield <http://dunfield.info>`_, and `Matthias Goerner
+<http://www.unhyperbolic.org/>`_ using the SnapPea kernel written by
+`Jeff Weeks <http://www.geometrygames.org>`_, with contributions from
+:doc:`many others <credits>`.  If you use SnapPy in your work, please
+:ref:`cite it as described here <credits:Citing SnapPy>`.  If you
+encounter problems with SnapPy, :doc:`please report them <bugs>`.
+
+Released under the terms of the `GNU General Public License
+<http://www.gnu.org/licenses/gpl-2.0.txt>`_, version 2 or later.
+
+The development of SnapPy was partially supported by grants from the
+National Science Foundation, including DMS-0707136, DMS-0906155,
+DMS-1105476, DMS-1510204, DMS-1811156, and the Institute for
+Computational and Experimental Research in Mathematics. Any opinions,
+findings, and conclusions or recommendations expressed on this site
+are those of the authors and do not necessarily reflect the views of
+the National Science Foundation.