snappy 3.0.3__cp38-cp38-macosx_11_0_arm64.whl → 3.2__cp38-cp38-macosx_11_0_arm64.whl
Sign up to get free protection for your applications and to get access to all the features.
- snappy/CyOpenGL.cpython-38-darwin.so +0 -0
- snappy/SnapPy.cpython-38-darwin.so +0 -0
- snappy/SnapPyHP.cpython-38-darwin.so +0 -0
- snappy/__init__.py +373 -426
- snappy/app.py +240 -75
- snappy/app_menus.py +93 -78
- snappy/browser.py +87 -63
- snappy/cache.py +5 -8
- snappy/canonical.py +249 -0
- snappy/{verify/cusp_shapes.py → cusps/__init__.py} +11 -19
- snappy/cusps/cusp_area_matrix.py +101 -0
- snappy/{verify/cusp_areas.py → cusps/cusp_areas_from_matrix.py} +39 -54
- snappy/cusps/maximal_cusp_area_matrix.py +136 -0
- snappy/cusps/test.py +21 -0
- snappy/cusps/trig_cusp_area_matrix.py +63 -0
- snappy/database.py +40 -31
- snappy/db_utilities.py +13 -14
- snappy/decorated_isosig.py +377 -133
- snappy/dev/extended_ptolemy/complexVolumesClosed.py +42 -9
- snappy/dev/extended_ptolemy/extended.py +32 -25
- snappy/dev/extended_ptolemy/giac_rur.py +23 -8
- snappy/dev/extended_ptolemy/phc_wrapper.py +10 -10
- snappy/dev/vericlosed/computeApproxHyperbolicStructureOrb.py +2 -1
- snappy/dev/vericlosed/gimbalLoopFinder.py +5 -5
- snappy/dev/vericlosed/hyperbolicStructure.py +3 -3
- snappy/dev/vericlosed/oneVertexTruncatedComplex.py +2 -2
- snappy/dev/vericlosed/truncatedComplex.py +3 -2
- snappy/dev/vericlosed/verifyHyperbolicStructureEngine.py +4 -3
- snappy/doc/_images/geodesics.jpg +0 -0
- snappy/doc/_images/m004_paper_plane_on_systole.jpg +0 -0
- snappy/doc/_images/m125_paper_plane.jpg +0 -0
- snappy/doc/_images/o9_00000_systole_paper_plane.jpg +0 -0
- snappy/doc/_images/o9_00000_systole_paper_plane_closer.jpg +0 -0
- snappy/doc/_sources/additional_classes.rst.txt +1 -0
- snappy/doc/_sources/credits.rst.txt +6 -1
- snappy/doc/_sources/development.rst.txt +69 -50
- snappy/doc/_sources/index.rst.txt +101 -66
- snappy/doc/_sources/installing.rst.txt +148 -165
- snappy/doc/_sources/news.rst.txt +136 -32
- snappy/doc/_sources/ptolemy.rst.txt +1 -1
- snappy/doc/_sources/ptolemy_examples1.rst.txt +9 -8
- snappy/doc/_sources/ptolemy_examples2.rst.txt +3 -3
- snappy/doc/_sources/ptolemy_examples3.rst.txt +14 -14
- snappy/doc/_sources/ptolemy_prelim.rst.txt +1 -1
- snappy/doc/_sources/snap.rst.txt +2 -2
- snappy/doc/_sources/snappy.rst.txt +1 -1
- snappy/doc/_sources/triangulation.rst.txt +3 -2
- snappy/doc/_sources/verify.rst.txt +89 -29
- snappy/doc/_sources/verify_internals.rst.txt +5 -16
- snappy/doc/_static/SnapPy-horizontal-128.png +0 -0
- snappy/doc/_static/SnapPy.ico +0 -0
- snappy/doc/_static/_sphinx_javascript_frameworks_compat.js +123 -0
- snappy/doc/_static/basic.css +47 -27
- snappy/doc/_static/css/badge_only.css +1 -0
- snappy/doc/_static/css/fonts/Roboto-Slab-Bold.woff +0 -0
- snappy/doc/_static/css/fonts/Roboto-Slab-Bold.woff2 +0 -0
- snappy/doc/_static/css/fonts/Roboto-Slab-Regular.woff +0 -0
- snappy/doc/_static/css/fonts/Roboto-Slab-Regular.woff2 +0 -0
- snappy/doc/_static/css/fonts/fontawesome-webfont.eot +0 -0
- snappy/doc/_static/css/fonts/fontawesome-webfont.svg +2671 -0
- snappy/doc/_static/css/fonts/fontawesome-webfont.ttf +0 -0
- snappy/doc/_static/css/fonts/fontawesome-webfont.woff +0 -0
- snappy/doc/_static/css/fonts/fontawesome-webfont.woff2 +0 -0
- snappy/doc/_static/css/fonts/lato-bold-italic.woff +0 -0
- snappy/doc/_static/css/fonts/lato-bold-italic.woff2 +0 -0
- snappy/doc/_static/css/fonts/lato-bold.woff +0 -0
- snappy/doc/_static/css/fonts/lato-bold.woff2 +0 -0
- snappy/doc/_static/css/fonts/lato-normal-italic.woff +0 -0
- snappy/doc/_static/css/fonts/lato-normal-italic.woff2 +0 -0
- snappy/doc/_static/css/fonts/lato-normal.woff +0 -0
- snappy/doc/_static/css/fonts/lato-normal.woff2 +0 -0
- snappy/doc/_static/css/theme.css +4 -0
- snappy/doc/_static/doctools.js +107 -274
- snappy/doc/_static/documentation_options.js +6 -5
- snappy/doc/_static/fonts/Lato/lato-bold.eot +0 -0
- snappy/doc/_static/fonts/Lato/lato-bold.ttf +0 -0
- snappy/doc/_static/fonts/Lato/lato-bold.woff +0 -0
- snappy/doc/_static/fonts/Lato/lato-bold.woff2 +0 -0
- snappy/doc/_static/fonts/Lato/lato-bolditalic.eot +0 -0
- snappy/doc/_static/fonts/Lato/lato-bolditalic.ttf +0 -0
- snappy/doc/_static/fonts/Lato/lato-bolditalic.woff +0 -0
- snappy/doc/_static/fonts/Lato/lato-bolditalic.woff2 +0 -0
- snappy/doc/_static/fonts/Lato/lato-italic.eot +0 -0
- snappy/doc/_static/fonts/Lato/lato-italic.ttf +0 -0
- snappy/doc/_static/fonts/Lato/lato-italic.woff +0 -0
- snappy/doc/_static/fonts/Lato/lato-italic.woff2 +0 -0
- snappy/doc/_static/fonts/Lato/lato-regular.eot +0 -0
- snappy/doc/_static/fonts/Lato/lato-regular.ttf +0 -0
- snappy/doc/_static/fonts/Lato/lato-regular.woff +0 -0
- snappy/doc/_static/fonts/Lato/lato-regular.woff2 +0 -0
- snappy/doc/_static/fonts/RobotoSlab/roboto-slab-v7-bold.eot +0 -0
- snappy/doc/_static/fonts/RobotoSlab/roboto-slab-v7-bold.ttf +0 -0
- snappy/doc/_static/fonts/RobotoSlab/roboto-slab-v7-bold.woff +0 -0
- snappy/doc/_static/fonts/RobotoSlab/roboto-slab-v7-bold.woff2 +0 -0
- snappy/doc/_static/fonts/RobotoSlab/roboto-slab-v7-regular.eot +0 -0
- snappy/doc/_static/fonts/RobotoSlab/roboto-slab-v7-regular.ttf +0 -0
- snappy/doc/_static/fonts/RobotoSlab/roboto-slab-v7-regular.woff +0 -0
- snappy/doc/_static/fonts/RobotoSlab/roboto-slab-v7-regular.woff2 +0 -0
- snappy/doc/_static/jquery.js +2 -2
- snappy/doc/_static/js/badge_only.js +1 -0
- snappy/doc/_static/js/theme.js +1 -0
- snappy/doc/_static/js/versions.js +228 -0
- snappy/doc/_static/language_data.js +3 -101
- snappy/doc/_static/pygments.css +1 -0
- snappy/doc/_static/searchtools.js +489 -398
- snappy/doc/_static/snappy_furo.css +33 -0
- snappy/doc/_static/snappy_sphinx_rtd_theme.css +42 -0
- snappy/doc/_static/sphinx_highlight.js +154 -0
- snappy/doc/additional_classes.html +688 -263
- snappy/doc/bugs.html +107 -94
- snappy/doc/censuses.html +155 -127
- snappy/doc/credits.html +115 -104
- snappy/doc/development.html +184 -146
- snappy/doc/genindex.html +287 -204
- snappy/doc/index.html +189 -150
- snappy/doc/installing.html +259 -266
- snappy/doc/manifold.html +1626 -592
- snappy/doc/manifoldhp.html +119 -105
- snappy/doc/news.html +198 -104
- snappy/doc/objects.inv +0 -0
- snappy/doc/other.html +117 -105
- snappy/doc/platonic_census.html +161 -114
- snappy/doc/plink.html +113 -105
- snappy/doc/ptolemy.html +131 -108
- snappy/doc/ptolemy_classes.html +242 -223
- snappy/doc/ptolemy_examples1.html +144 -130
- snappy/doc/ptolemy_examples2.html +141 -129
- snappy/doc/ptolemy_examples3.html +148 -132
- snappy/doc/ptolemy_examples4.html +131 -111
- snappy/doc/ptolemy_prelim.html +162 -138
- snappy/doc/py-modindex.html +104 -69
- snappy/doc/screenshots.html +117 -108
- snappy/doc/search.html +115 -84
- snappy/doc/searchindex.js +1 -1
- snappy/doc/snap.html +109 -96
- snappy/doc/snappy.html +134 -97
- snappy/doc/spherogram.html +259 -187
- snappy/doc/todo.html +107 -94
- snappy/doc/triangulation.html +1380 -111
- snappy/doc/tutorial.html +107 -94
- snappy/doc/verify.html +194 -125
- snappy/doc/verify_internals.html +248 -686
- snappy/drilling/__init__.py +456 -0
- snappy/drilling/barycentric.py +103 -0
- snappy/drilling/constants.py +5 -0
- snappy/drilling/crush.py +270 -0
- snappy/drilling/cusps.py +125 -0
- snappy/drilling/debug.py +242 -0
- snappy/drilling/epsilons.py +6 -0
- snappy/drilling/exceptions.py +55 -0
- snappy/drilling/moves.py +620 -0
- snappy/drilling/peripheral_curves.py +210 -0
- snappy/drilling/perturb.py +188 -0
- snappy/drilling/shorten.py +36 -0
- snappy/drilling/subdivide.py +274 -0
- snappy/drilling/test.py +23 -0
- snappy/drilling/test_cases.py +126 -0
- snappy/drilling/tracing.py +351 -0
- snappy/exceptions.py +23 -3
- snappy/export_stl.py +20 -14
- snappy/exterior_to_link/__init__.py +2 -0
- snappy/exterior_to_link/barycentric_geometry.py +463 -0
- snappy/exterior_to_link/exceptions.py +6 -0
- snappy/exterior_to_link/geodesic_map.json +14408 -0
- snappy/exterior_to_link/hyp_utils.py +112 -0
- snappy/exterior_to_link/link_projection.py +323 -0
- snappy/exterior_to_link/main.py +197 -0
- snappy/exterior_to_link/mcomplex_with_expansion.py +261 -0
- snappy/exterior_to_link/mcomplex_with_link.py +687 -0
- snappy/exterior_to_link/mcomplex_with_memory.py +162 -0
- snappy/exterior_to_link/pl_utils.py +491 -0
- snappy/exterior_to_link/put_in_S3.py +156 -0
- snappy/exterior_to_link/rational_linear_algebra.py +123 -0
- snappy/exterior_to_link/rational_linear_algebra_wrapped.py +135 -0
- snappy/exterior_to_link/simplify_to_base_tri.py +114 -0
- snappy/exterior_to_link/stored_moves.py +475 -0
- snappy/exterior_to_link/test.py +31 -0
- snappy/geometric_structure/__init__.py +212 -0
- snappy/geometric_structure/cusp_neighborhood/__init__.py +3 -0
- snappy/geometric_structure/cusp_neighborhood/complex_cusp_cross_section.py +697 -0
- snappy/geometric_structure/cusp_neighborhood/cusp_cross_section_base.py +484 -0
- snappy/geometric_structure/cusp_neighborhood/exceptions.py +42 -0
- snappy/geometric_structure/cusp_neighborhood/real_cusp_cross_section.py +298 -0
- snappy/geometric_structure/cusp_neighborhood/tiles_for_cusp_neighborhood.py +159 -0
- snappy/geometric_structure/cusp_neighborhood/vertices.py +32 -0
- snappy/geometric_structure/geodesic/__init__.py +0 -0
- snappy/geometric_structure/geodesic/add_core_curves.py +152 -0
- snappy/geometric_structure/geodesic/avoid_core_curves.py +369 -0
- snappy/geometric_structure/geodesic/canonical_keys.py +52 -0
- snappy/geometric_structure/geodesic/check_away_from_core_curve.py +60 -0
- snappy/geometric_structure/geodesic/constants.py +6 -0
- snappy/geometric_structure/geodesic/exceptions.py +22 -0
- snappy/geometric_structure/geodesic/fixed_points.py +93 -0
- snappy/geometric_structure/geodesic/geodesic_start_point_info.py +435 -0
- snappy/geometric_structure/geodesic/graph_trace_helper.py +67 -0
- snappy/geometric_structure/geodesic/line.py +30 -0
- snappy/geometric_structure/geodesic/multiplicity.py +127 -0
- snappy/geometric_structure/geodesic/tiles_for_geodesic.py +101 -0
- snappy/geometric_structure/test.py +22 -0
- snappy/gui.py +36 -36
- snappy/horoviewer.py +50 -48
- snappy/hyperboloid/__init__.py +212 -0
- snappy/hyperboloid/distances.py +245 -0
- snappy/hyperboloid/horoball.py +19 -0
- snappy/hyperboloid/line.py +35 -0
- snappy/hyperboloid/point.py +9 -0
- snappy/hyperboloid/triangle.py +29 -0
- snappy/{infodialog.py → infowindow.py} +32 -33
- snappy/isometry_signature.py +382 -0
- snappy/len_spec/__init__.py +596 -0
- snappy/len_spec/geodesic_info.py +110 -0
- snappy/len_spec/geodesic_key_info_dict.py +117 -0
- snappy/len_spec/geodesic_piece.py +143 -0
- snappy/len_spec/geometric_structure.py +182 -0
- snappy/len_spec/geometry.py +80 -0
- snappy/len_spec/length_spectrum_geodesic_info.py +170 -0
- snappy/len_spec/spine.py +206 -0
- snappy/len_spec/test.py +24 -0
- snappy/len_spec/test_cases.py +69 -0
- snappy/len_spec/tile.py +275 -0
- snappy/len_spec/word.py +86 -0
- snappy/manifolds/__init__.py +1 -1
- snappy/math_basics.py +176 -0
- snappy/matrix.py +525 -0
- snappy/number.py +97 -21
- snappy/numeric_output_checker.py +37 -27
- snappy/pari.py +30 -69
- snappy/phone_home.py +25 -20
- snappy/polyviewer.py +39 -37
- snappy/ptolemy/__init__.py +4 -6
- snappy/ptolemy/component.py +14 -12
- snappy/ptolemy/coordinates.py +312 -295
- snappy/ptolemy/fieldExtensions.py +14 -12
- snappy/ptolemy/findLoops.py +43 -31
- snappy/ptolemy/geometricRep.py +24 -26
- snappy/ptolemy/homology.py +12 -7
- snappy/ptolemy/manifoldMethods.py +69 -70
- snappy/ptolemy/matrix.py +65 -26
- snappy/ptolemy/numericalSolutionsToGroebnerBasis.py +18 -14
- snappy/ptolemy/polynomial.py +125 -119
- snappy/ptolemy/processComponents.py +36 -30
- snappy/ptolemy/processFileBase.py +79 -18
- snappy/ptolemy/processFileDispatch.py +13 -14
- snappy/ptolemy/processMagmaFile.py +44 -39
- snappy/ptolemy/processRurFile.py +18 -11
- snappy/ptolemy/ptolemyGeneralizedObstructionClass.py +20 -17
- snappy/ptolemy/ptolemyObstructionClass.py +13 -17
- snappy/ptolemy/ptolemyVariety.py +190 -121
- snappy/ptolemy/ptolemyVarietyPrimeIdealGroebnerBasis.py +20 -19
- snappy/ptolemy/reginaWrapper.py +25 -29
- snappy/ptolemy/rur.py +6 -14
- snappy/ptolemy/solutionsToPrimeIdealGroebnerBasis.py +27 -22
- snappy/ptolemy/test.py +247 -188
- snappy/ptolemy/utilities.py +41 -43
- snappy/raytracing/__init__.py +64 -0
- snappy/raytracing/additional_horospheres.py +64 -0
- snappy/raytracing/additional_len_spec_choices.py +63 -0
- snappy/raytracing/cohomology_fractal.py +10 -6
- snappy/raytracing/eyeball.py +123 -0
- snappy/raytracing/finite_raytracing_data.py +48 -38
- snappy/raytracing/finite_viewer.py +218 -210
- snappy/raytracing/geodesic_tube_info.py +174 -0
- snappy/raytracing/geodesics.py +246 -0
- snappy/raytracing/geodesics_window.py +258 -0
- snappy/raytracing/gui_utilities.py +152 -40
- snappy/raytracing/hyperboloid_navigation.py +102 -52
- snappy/raytracing/hyperboloid_utilities.py +114 -261
- snappy/raytracing/ideal_raytracing_data.py +256 -179
- snappy/raytracing/inside_viewer.py +522 -253
- snappy/raytracing/pack.py +22 -0
- snappy/raytracing/raytracing_data.py +46 -34
- snappy/raytracing/raytracing_view.py +190 -109
- snappy/raytracing/shaders/Eye.png +0 -0
- snappy/raytracing/shaders/NonGeometric.png +0 -0
- snappy/raytracing/shaders/__init__.py +60 -4
- snappy/raytracing/shaders/fragment.glsl +575 -148
- snappy/raytracing/test.py +29 -0
- snappy/raytracing/tooltip.py +146 -0
- snappy/raytracing/upper_halfspace_utilities.py +98 -0
- snappy/raytracing/view_scale_controller.py +98 -0
- snappy/raytracing/zoom_slider/__init__.py +32 -29
- snappy/raytracing/zoom_slider/test.py +2 -0
- snappy/sage_helper.py +69 -123
- snappy/{preferences.py → settings.py} +167 -145
- snappy/shell.py +4 -0
- snappy/snap/__init__.py +12 -8
- snappy/snap/character_varieties.py +24 -18
- snappy/snap/find_field.py +35 -34
- snappy/snap/fundamental_polyhedron.py +99 -85
- snappy/snap/generators.py +6 -8
- snappy/snap/interval_reps.py +18 -6
- snappy/snap/kernel_structures.py +8 -3
- snappy/snap/mcomplex_base.py +1 -2
- snappy/snap/nsagetools.py +107 -53
- snappy/snap/peripheral/__init__.py +1 -1
- snappy/snap/peripheral/dual_cellulation.py +15 -7
- snappy/snap/peripheral/link.py +20 -16
- snappy/snap/peripheral/peripheral.py +22 -14
- snappy/snap/peripheral/surface.py +47 -50
- snappy/snap/peripheral/test.py +8 -8
- snappy/snap/polished_reps.py +65 -40
- snappy/snap/shapes.py +41 -22
- snappy/snap/slice_obs_HKL.py +64 -25
- snappy/snap/t3mlite/arrow.py +88 -51
- snappy/snap/t3mlite/corner.py +5 -6
- snappy/snap/t3mlite/edge.py +32 -21
- snappy/snap/t3mlite/face.py +7 -9
- snappy/snap/t3mlite/files.py +31 -23
- snappy/snap/t3mlite/homology.py +14 -10
- snappy/snap/t3mlite/linalg.py +158 -56
- snappy/snap/t3mlite/mcomplex.py +739 -291
- snappy/snap/t3mlite/perm4.py +236 -84
- snappy/snap/t3mlite/setup.py +9 -10
- snappy/snap/t3mlite/simplex.py +65 -48
- snappy/snap/t3mlite/spun.py +42 -30
- snappy/snap/t3mlite/surface.py +45 -45
- snappy/snap/t3mlite/test.py +3 -0
- snappy/snap/t3mlite/test_vs_regina.py +17 -13
- snappy/snap/t3mlite/tetrahedron.py +25 -24
- snappy/snap/t3mlite/vertex.py +8 -13
- snappy/snap/test.py +45 -52
- snappy/snap/utilities.py +66 -65
- snappy/test.py +155 -158
- snappy/test_cases.py +263 -0
- snappy/testing.py +131 -0
- snappy/tiling/__init__.py +2 -0
- snappy/tiling/canonical_key_dict.py +59 -0
- snappy/tiling/dict_based_set.py +79 -0
- snappy/tiling/floor.py +49 -0
- snappy/tiling/hyperboloid_dict.py +54 -0
- snappy/tiling/iter_utils.py +78 -0
- snappy/tiling/lifted_tetrahedron.py +22 -0
- snappy/tiling/lifted_tetrahedron_set.py +54 -0
- snappy/tiling/real_hash_dict.py +164 -0
- snappy/tiling/test.py +23 -0
- snappy/tiling/tile.py +215 -0
- snappy/tiling/triangle.py +33 -0
- snappy/tkterminal.py +313 -203
- snappy/twister/main.py +1 -8
- snappy/twister/twister_core.cpython-38-darwin.so +0 -0
- snappy/upper_halfspace/__init__.py +146 -0
- snappy/upper_halfspace/ideal_point.py +26 -0
- snappy/verify/__init__.py +4 -8
- snappy/verify/{verifyCanonical.py → canonical.py} +114 -97
- snappy/verify/complex_volume/__init__.py +3 -2
- snappy/verify/complex_volume/adjust_torsion.py +13 -11
- snappy/verify/complex_volume/closed.py +29 -24
- snappy/verify/complex_volume/compute_ptolemys.py +8 -6
- snappy/verify/complex_volume/cusped.py +10 -9
- snappy/verify/complex_volume/extended_bloch.py +14 -12
- snappy/verify/{cuspTranslations.py → cusp_translations.py} +15 -14
- snappy/verify/edge_equations.py +80 -0
- snappy/verify/exceptions.py +23 -56
- snappy/verify/{verifyHyperbolicity.py → hyperbolicity.py} +19 -15
- snappy/verify/interval_newton_shapes_engine.py +51 -211
- snappy/verify/interval_tree.py +27 -25
- snappy/verify/krawczyk_shapes_engine.py +47 -50
- snappy/verify/maximal_cusp_area_matrix/__init__.py +17 -86
- snappy/verify/maximal_cusp_area_matrix/cusp_tiling_engine.py +58 -48
- snappy/verify/maximal_cusp_area_matrix/cusp_translate_engine.py +53 -57
- snappy/verify/{realAlgebra.py → real_algebra.py} +26 -20
- snappy/verify/shapes.py +10 -7
- snappy/verify/short_slopes.py +41 -42
- snappy/verify/{squareExtensions.py → square_extensions.py} +96 -92
- snappy/verify/test.py +59 -57
- snappy/verify/upper_halfspace/extended_matrix.py +5 -5
- snappy/verify/upper_halfspace/finite_point.py +44 -31
- snappy/verify/upper_halfspace/ideal_point.py +69 -57
- snappy/verify/volume.py +15 -12
- snappy/version.py +2 -3
- {snappy-3.0.3.dist-info → snappy-3.2.dist-info}/METADATA +14 -12
- snappy-3.2.dist-info/RECORD +503 -0
- {snappy-3.0.3.dist-info → snappy-3.2.dist-info}/WHEEL +1 -1
- {snappy-3.0.3.dist-info → snappy-3.2.dist-info}/entry_points.txt +0 -1
- {snappy-3.0.3.dist-info → snappy-3.2.dist-info}/top_level.txt +10 -1
- snappy/doc/_sources/verify_canon.rst.txt +0 -90
- snappy/doc/_static/classic.css +0 -266
- snappy/doc/_static/jquery-3.5.1.js +0 -10872
- snappy/doc/_static/sidebar.js +0 -159
- snappy/doc/_static/underscore-1.13.1.js +0 -2042
- snappy/doc/_static/underscore.js +0 -6
- snappy/doc/verify_canon.html +0 -283
- snappy/ppm_to_png.py +0 -243
- snappy/togl/__init__.py +0 -3
- snappy/togl/darwin-tk8.6/Togl2.1/LICENSE +0 -28
- snappy/togl/darwin-tk8.6/Togl2.1/libTogl2.1.dylib +0 -0
- snappy/togl/darwin-tk8.6/Togl2.1/pkgIndex.tcl +0 -5
- snappy/togl/linux2-x86_64-tk8.6/Togl2.1/LICENSE +0 -28
- snappy/togl/linux2-x86_64-tk8.6/Togl2.1/libTogl2.1.so +0 -0
- snappy/togl/linux2-x86_64-tk8.6/Togl2.1/pkgIndex.tcl +0 -5
- snappy/togl/win32VC-tk8.6/Togl2.1/LICENSE +0 -28
- snappy/togl/win32VC-tk8.6/Togl2.1/Togl21.dll +0 -0
- snappy/togl/win32VC-tk8.6/Togl2.1/Togl21.lib +0 -0
- snappy/togl/win32VC-tk8.6/Togl2.1/pkgIndex.tcl +0 -6
- snappy/togl/win32VC-x86_64-tk8.6/Togl2.1/LICENSE +0 -28
- snappy/togl/win32VC-x86_64-tk8.6/Togl2.1/Togl21.dll +0 -0
- snappy/togl/win32VC-x86_64-tk8.6/Togl2.1/Togl21.lib +0 -0
- snappy/togl/win32VC-x86_64-tk8.6/Togl2.1/pkgIndex.tcl +0 -6
- snappy/verify/cuspCrossSection.py +0 -1413
- snappy/verify/mathHelpers.py +0 -64
- snappy-3.0.3.dist-info/RECORD +0 -360
snappy/doc/installing.html
CHANGED
@@ -1,196 +1,280 @@
|
|
1
1
|
|
2
|
+
|
2
3
|
<!DOCTYPE html>
|
4
|
+
<html class="writer-html5" lang="en" data-content_root="./">
|
5
|
+
<head>
|
6
|
+
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
3
7
|
|
4
|
-
<
|
5
|
-
<
|
6
|
-
|
7
|
-
|
8
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
9
|
+
<title>Installing SnapPy — SnapPy 3.2 documentation</title>
|
10
|
+
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" />
|
11
|
+
<link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=e59714d7" />
|
12
|
+
<link rel="stylesheet" type="text/css" href="_static/snappy_sphinx_rtd_theme.css?v=1b8ec2a8" />
|
8
13
|
|
9
|
-
|
10
|
-
<link rel="
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
<script src="_static/
|
17
|
-
|
14
|
+
|
15
|
+
<link rel="shortcut icon" href="_static/SnapPy.ico"/>
|
16
|
+
<script src="_static/jquery.js?v=5d32c60e"></script>
|
17
|
+
<script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
|
18
|
+
<script src="_static/documentation_options.js?v=828ea960"></script>
|
19
|
+
<script src="_static/doctools.js?v=9a2dae69"></script>
|
20
|
+
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
|
21
|
+
<script src="_static/js/theme.js"></script>
|
18
22
|
<link rel="index" title="Index" href="genindex.html" />
|
19
23
|
<link rel="search" title="Search" href="search.html" />
|
20
24
|
<link rel="next" title="Screenshots: SnapPy in action" href="screenshots.html" />
|
21
25
|
<link rel="prev" title="SnapPy" href="index.html" />
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
26
|
+
</head>
|
27
|
+
|
28
|
+
<body class="wy-body-for-nav">
|
29
|
+
<div class="wy-grid-for-nav">
|
30
|
+
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
31
|
+
<div class="wy-side-scroll">
|
32
|
+
<div class="wy-side-nav-search" >
|
33
|
+
|
34
|
+
|
35
|
+
|
36
|
+
<a href="index.html" class="icon icon-home">
|
37
|
+
SnapPy
|
38
|
+
<img src="_static/SnapPy-horizontal-128.png" class="logo" alt="Logo"/>
|
39
|
+
</a>
|
40
|
+
<div role="search">
|
41
|
+
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
|
42
|
+
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
|
43
|
+
<input type="hidden" name="check_keywords" value="yes" />
|
44
|
+
<input type="hidden" name="area" value="default" />
|
45
|
+
</form>
|
46
|
+
</div>
|
47
|
+
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
|
48
|
+
<ul class="current">
|
49
|
+
<li class="toctree-l1 current"><a class="current reference internal" href="#">Installing SnapPy</a><ul>
|
50
|
+
<li class="toctree-l2"><a class="reference internal" href="#macos">macOS</a></li>
|
51
|
+
<li class="toctree-l2"><a class="reference internal" href="#windows">Windows</a></li>
|
52
|
+
<li class="toctree-l2"><a class="reference internal" href="#linux-app">Linux app</a></li>
|
53
|
+
<li class="toctree-l2"><a class="reference internal" href="#python-modules-for-macos-or-windows">Python Modules for macOS or Windows</a></li>
|
54
|
+
<li class="toctree-l2"><a class="reference internal" href="#python-modules-for-linux">Python Modules for Linux</a></li>
|
55
|
+
<li class="toctree-l2"><a class="reference internal" href="#sagemath">SageMath</a></li>
|
56
|
+
<li class="toctree-l2"><a class="reference internal" href="#kitchen-sink">Kitchen sink</a></li>
|
57
|
+
<li class="toctree-l2"><a class="reference internal" href="#conda">Conda</a></li>
|
58
|
+
<li class="toctree-l2"><a class="reference internal" href="#source-code">Source code</a></li>
|
59
|
+
</ul>
|
60
|
+
</li>
|
61
|
+
<li class="toctree-l1"><a class="reference internal" href="screenshots.html">Screenshots: SnapPy in action</a></li>
|
62
|
+
<li class="toctree-l1"><a class="reference internal" href="tutorial.html">Tutorial</a></li>
|
63
|
+
<li class="toctree-l1"><a class="reference internal" href="snappy.html">The snappy module and its classes</a></li>
|
64
|
+
<li class="toctree-l1"><a class="reference internal" href="plink.html">Using SnapPy’s link editor</a></li>
|
65
|
+
<li class="toctree-l1"><a class="reference internal" href="spherogram.html">Links: planar diagrams and invariants</a></li>
|
66
|
+
<li class="toctree-l1"><a class="reference internal" href="snap.html">Number theory of hyperbolic 3-manifolds</a></li>
|
67
|
+
<li class="toctree-l1"><a class="reference internal" href="verify.html">Verified computations</a></li>
|
68
|
+
<li class="toctree-l1"><a class="reference internal" href="other.html">Other components</a></li>
|
69
|
+
<li class="toctree-l1"><a class="reference internal" href="news.html">News</a></li>
|
70
|
+
<li class="toctree-l1"><a class="reference internal" href="credits.html">Credits</a></li>
|
71
|
+
<li class="toctree-l1"><a class="reference internal" href="bugs.html">Reporting bugs and other problems</a></li>
|
72
|
+
<li class="toctree-l1"><a class="reference internal" href="todo.html">To Do List</a></li>
|
73
|
+
<li class="toctree-l1"><a class="reference internal" href="development.html">Development Basics</a></li>
|
74
|
+
</ul>
|
42
75
|
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
76
|
+
</div>
|
77
|
+
</div>
|
78
|
+
</nav>
|
79
|
+
|
80
|
+
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
|
81
|
+
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
82
|
+
<a href="index.html">SnapPy</a>
|
83
|
+
</nav>
|
84
|
+
|
85
|
+
<div class="wy-nav-content">
|
86
|
+
<div class="rst-content">
|
87
|
+
<div role="navigation" aria-label="Page navigation">
|
88
|
+
<ul class="wy-breadcrumbs">
|
89
|
+
<li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
|
90
|
+
<li class="breadcrumb-item active">Installing SnapPy</li>
|
91
|
+
<li class="wy-breadcrumbs-aside">
|
92
|
+
</li>
|
93
|
+
</ul>
|
94
|
+
<hr/>
|
95
|
+
</div>
|
96
|
+
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
97
|
+
<div itemprop="articleBody">
|
98
|
+
|
48
99
|
<section id="installing-snappy">
|
49
|
-
<h1>Installing SnapPy<a class="headerlink" href="#installing-snappy" title="
|
100
|
+
<h1>Installing SnapPy<a class="headerlink" href="#installing-snappy" title="Link to this heading"></a></h1>
|
50
101
|
<p>Here are detailed instructions on how to get SnapPy working on a
|
51
|
-
variety of platforms. The current version is 3.
|
52
|
-
on
|
102
|
+
variety of platforms. The current version is 3.2 which was released
|
103
|
+
on January 2025. If you encounter any problems installing SnapPy,
|
53
104
|
<a class="reference internal" href="bugs.html"><span class="doc">please let us know</span></a>.</p>
|
54
105
|
<section id="macos">
|
55
|
-
<h2>macOS<a class="headerlink" href="#macos" title="
|
106
|
+
<h2>macOS<a class="headerlink" href="#macos" title="Link to this heading"></a></h2>
|
56
107
|
<p>Simply download <a class="reference external" href="https://github.com/3-manifolds/SnapPy/releases/latest/download/SnapPy.dmg">SnapPy.dmg</a>
|
57
108
|
and copy SnapPy.app to the Applications folder. Double-click to start
|
58
|
-
it, just like any other application.
|
59
|
-
newer
|
109
|
+
it, just like any other application. The current version works with macOS 10.14 and
|
110
|
+
newer and earlier releases <a class="reference external" href="https://github.com/3-manifolds/SnapPy/releases/">can be found here</a>.</p>
|
60
111
|
</section>
|
61
112
|
<section id="windows">
|
62
|
-
<h2>Windows<a class="headerlink" href="#windows" title="
|
113
|
+
<h2>Windows<a class="headerlink" href="#windows" title="Link to this heading"></a></h2>
|
63
114
|
<p>Simply download and run <a class="reference external" href="https://github.com/3-manifolds/SnapPy/releases/latest/download/InstallSnapPy.exe">InstallSnapPy.exe</a>.
|
64
115
|
Earlier releases <a class="reference external" href="https://github.com/3-manifolds/SnapPy/releases/">can be found here</a>.</p>
|
65
116
|
</section>
|
66
|
-
<section id="linux">
|
67
|
-
<h2>Linux<a class="headerlink" href="#linux" title="
|
68
|
-
<p>
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
in
|
74
|
-
|
75
|
-
|
76
|
-
<
|
77
|
-
<
|
78
|
-
<
|
79
|
-
<span class="
|
80
|
-
<span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">upgrade</span> <span class="o">--</span><span class="n">user</span> <span class="n">snappy</span>
|
117
|
+
<section id="linux-app">
|
118
|
+
<h2>Linux app<a class="headerlink" href="#linux-app" title="Link to this heading"></a></h2>
|
119
|
+
<p>Starting with SnapPy 3.2, a completely self-contained SnapPy <a class="reference external" href="https://docs.appimage.org/introduction/quickstart.html#ref-quickstart">AppImage</a>
|
120
|
+
is available that should work on any Linux system from the last 5
|
121
|
+
years. This AppImage contains its own private copy of Python, so if
|
122
|
+
you plan to use SnapPy in your own Python programs, skip ahead to
|
123
|
+
<a class="reference internal" href="#python-modules-for-linux">Python Modules for Linux</a>. Here is the recipe for installing the
|
124
|
+
AppImage in <code class="docutils literal notranslate"><span class="pre">~/bin</span></code> after you have downloaded the file
|
125
|
+
<a class="reference external" href="https://github.com/3-manifolds/SnapPy/releases/latest/download/SnapPy-x86_64.AppImage.">SnapPy-x86_64.AppImage</a>:</p>
|
126
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">mkdir</span> <span class="o">-</span><span class="n">p</span> <span class="o">~/</span><span class="nb">bin</span>
|
127
|
+
<span class="n">mv</span> <span class="o">~/</span><span class="n">Downloads</span><span class="o">/</span><span class="n">SnapPy</span><span class="o">-</span><span class="n">x86_64</span><span class="o">.</span><span class="n">AppImage</span> <span class="o">~/</span><span class="nb">bin</span>
|
128
|
+
<span class="n">chmod</span> <span class="o">+</span><span class="n">x</span> <span class="o">~/</span><span class="nb">bin</span><span class="o">/</span><span class="n">SnapPy</span><span class="o">-</span><span class="n">x86_64</span><span class="o">.</span><span class="n">AppImage</span>
|
129
|
+
<span class="n">ln</span> <span class="o">-</span><span class="n">s</span> <span class="o">-</span><span class="n">f</span> <span class="o">~/</span><span class="nb">bin</span><span class="o">/</span><span class="n">SnapPy</span><span class="o">-</span><span class="n">x86_64</span><span class="o">.</span><span class="n">AppImage</span> <span class="o">~/</span><span class="nb">bin</span><span class="o">/</span><span class="n">SnapPy</span>
|
130
|
+
<span class="o">~/</span><span class="nb">bin</span><span class="o">/</span><span class="n">SnapPy</span><span class="o">-</span><span class="n">x86_64</span><span class="o">.</span><span class="n">AppImage</span> <span class="o">--</span><span class="n">install</span>
|
81
131
|
</pre></div>
|
82
132
|
</div>
|
83
|
-
<p>
|
84
|
-
|
85
|
-
|
86
|
-
|
87
|
-
|
133
|
+
<p>The last command registers the SnapPy app with your desktop system and
|
134
|
+
starts it. Next time, you can start SnapPy by using the desktop
|
135
|
+
search tool with GNOME or the main menu with KDE. You can pin also the icon
|
136
|
+
to your dash or task bar for easy access. From a terminal window, you
|
137
|
+
can also start the app by typing <code class="docutils literal notranslate"><span class="pre">SnapPy</span></code> provided <code class="docutils literal notranslate"><span class="pre">~/bin</span></code> is in
|
138
|
+
your <a class="reference external" href="https://opensource.com/article/17/6/set-path-linux">$PATH</a>.</p>
|
139
|
+
</section>
|
140
|
+
<section id="python-modules-for-macos-or-windows">
|
141
|
+
<h2>Python Modules for macOS or Windows<a class="headerlink" href="#python-modules-for-macos-or-windows" title="Link to this heading"></a></h2>
|
142
|
+
<p>If you write Python programs on macOS or Windows, you may wish to
|
143
|
+
install SnapPy as a Python module into your own copy of Python. We
|
144
|
+
support Python 3.9 and up. (On macOS, use a Python downloaded from
|
145
|
+
<a class="reference external" href="http://python.org">Python.org</a> and not the one provided by Apple.)
|
146
|
+
After installing Python, you may install a SnapPy module from your
|
147
|
+
Terminal application or Command Prompt with the command:</p>
|
148
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">upgrade</span> <span class="o">--</span><span class="n">user</span> <span class="n">snappy</span> <span class="n">snappy_15_knots</span>
|
88
149
|
</pre></div>
|
89
150
|
</div>
|
90
|
-
|
91
|
-
|
92
|
-
<
|
93
|
-
|
94
|
-
<
|
151
|
+
<p>If you do not want the larger version of HTLinkExteriors that includes
|
152
|
+
the 15 crossing knots (it uses 110M of disk space), omit
|
153
|
+
<code class="docutils literal notranslate"><span class="pre">snappy_15_knots</span></code> from the command.</p>
|
154
|
+
</section>
|
155
|
+
<section id="python-modules-for-linux">
|
156
|
+
<h2>Python Modules for Linux<a class="headerlink" href="#python-modules-for-linux" title="Link to this heading"></a></h2>
|
157
|
+
<p>You can also use SnapPy with your Linux system’s version of Python,
|
158
|
+
for example if you want to incorporate SnapPy in your own Python
|
159
|
+
scripts. These instructions assume you have system administrator
|
160
|
+
(superuser) privileges to install software packages from your Linux
|
161
|
+
distribution. (If you’re not a superuser, use either the
|
162
|
+
<a class="reference internal" href="#linux-app">Linux app</a> or <a class="reference internal" href="#conda">conda</a>.)</p>
|
163
|
+
<p>The first step is to install Python and other requirements; here’s how
|
164
|
+
to do that on the most popular Linux distributions:</p>
|
165
|
+
<ul>
|
166
|
+
<li><p><strong>Ubuntu/Debian/Mint/MX Linux/Elementary:</strong> Tested on Ubuntu 24.04:</p>
|
167
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">apt</span> <span class="n">install</span> <span class="n">python3</span><span class="o">-</span><span class="n">pip</span> <span class="n">python3</span><span class="o">-</span><span class="n">tk</span>
|
95
168
|
</pre></div>
|
96
169
|
</div>
|
97
170
|
</li>
|
98
|
-
<li><p><strong>
|
99
|
-
|
100
|
-
available</a>.
|
101
|
-
For CentOS and SciLinux, you can access EPEL packages by doing:</p>
|
102
|
-
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">yum</span> <span class="n">install</span> <span class="n">epel</span><span class="o">-</span><span class="n">release</span>
|
171
|
+
<li><p><strong>Fedora</strong>: Tested on Fedora 41:</p>
|
172
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">dnf</span> <span class="n">install</span> <span class="n">python3</span><span class="o">-</span><span class="n">pip</span> <span class="n">python3</span><span class="o">-</span><span class="n">tkinter</span>
|
103
173
|
</pre></div>
|
104
174
|
</div>
|
105
|
-
|
106
|
-
<
|
107
|
-
<span class="
|
108
|
-
<span class="n">python36</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">upgrade</span> <span class="o">--</span><span class="n">user</span> <span class="n">snappy</span>
|
175
|
+
</li>
|
176
|
+
<li><p><strong>Arch/Manjaro/EndeavourOS</strong>: Install via:</p>
|
177
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">pacman</span> <span class="o">-</span><span class="n">Sy</span> <span class="n">python</span><span class="o">-</span><span class="n">pip</span> <span class="n">tk</span>
|
109
178
|
</pre></div>
|
110
179
|
</div>
|
111
180
|
</li>
|
112
|
-
<li><p><strong>
|
113
|
-
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">
|
114
|
-
|
115
|
-
|
181
|
+
<li><p><strong>openSUSE</strong>: For Tumbleweed:</p>
|
182
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">zypper</span> <span class="n">install</span> <span class="n">python3</span><span class="o">-</span><span class="n">pip</span> <span class="n">python3</span><span class="o">-</span><span class="n">tk</span>
|
183
|
+
</pre></div>
|
184
|
+
</div>
|
185
|
+
<p>For Leap, as of version 15.6 you need to ask for a recent version of
|
186
|
+
Python or it will give you Python 3.6 which is too old for SnapPy:</p>
|
187
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">zypper</span> <span class="n">install</span> <span class="n">python312</span><span class="o">-</span><span class="n">pip</span> <span class="n">python312</span><span class="o">-</span><span class="n">tk</span>
|
116
188
|
</pre></div>
|
117
189
|
</div>
|
190
|
+
<p>You will need to replace <code class="docutils literal notranslate"><span class="pre">python3</span></code> by <code class="docutils literal notranslate"><span class="pre">python3.12</span></code> in subsequent
|
191
|
+
steps.</p>
|
118
192
|
</li>
|
119
|
-
<li><p><strong>
|
120
|
-
|
121
|
-
<span class="
|
122
|
-
<span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">upgrade</span> <span class="o">--</span><span class="n">user</span> <span class="n">snappy</span>
|
193
|
+
<li><p><strong>Red Hat Enterprise Linux/CentOS/Rocky Linux/AlmaLinux:</strong>: These instructions
|
194
|
+
are for version 8 or later; tested on AlmaLinux 8 and 9:</p>
|
195
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">dnf</span> <span class="n">install</span> <span class="n">python3</span><span class="mf">.11</span><span class="o">-</span><span class="n">pip</span> <span class="n">python3</span><span class="mf">.11</span><span class="o">-</span><span class="n">tkinter</span>
|
123
196
|
</pre></div>
|
124
197
|
</div>
|
198
|
+
<p>You will also need to replace <code class="docutils literal notranslate"><span class="pre">python3</span></code> by <code class="docutils literal notranslate"><span class="pre">python3.11</span></code> in subsequent
|
199
|
+
steps.</p>
|
125
200
|
</li>
|
126
201
|
</ul>
|
127
|
-
<p>
|
128
|
-
|
129
|
-
|
130
|
-
|
202
|
+
<p>Next, you need to install the SnapPy Python modules. For this, you can
|
203
|
+
either use a <em>virtual environment</em> (<code class="docutils literal notranslate"><span class="pre">python</span> <span class="pre">-m</span> <span class="pre">venv</span></code>) or do a <em>user
|
204
|
+
install</em> (<code class="docutils literal notranslate"><span class="pre">pip</span> <span class="pre">install</span> <span class="pre">--user</span></code>). The former will work on any
|
205
|
+
version of Linux, whereas the latter is now strongly discouraged on
|
206
|
+
many systems (e.g. Ubuntu 24.04). If you have not previously
|
207
|
+
installed SnapPy on this computer, we recommend using a virtual
|
208
|
+
environment, but suggest a user install if you are upgrading an
|
209
|
+
existing version of SnapPy that was installed in that manner.</p>
|
210
|
+
<dl>
|
211
|
+
<dt>Virtual environment</dt><dd><p>Here is the <a class="reference external" href="https://docs.python.org/3/tutorial/venv.html">official tutorial</a> on using virtual
|
212
|
+
environments in Python and an <a class="reference external" href="https://realpython.com/python-virtual-environments-a-primer/">in-depth article</a>. A
|
213
|
+
recipe is:</p>
|
214
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">venv</span> <span class="n">snappy_venv</span>
|
215
|
+
<span class="c1"># Switch to snappy_venv's Python</span>
|
216
|
+
<span class="n">source</span> <span class="n">snappy_venv</span><span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">activate</span>
|
217
|
+
<span class="n">pip</span> <span class="n">install</span> <span class="n">snappy</span> <span class="n">snappy_15_knots</span>
|
218
|
+
<span class="c1"># Start the SnapPy app!</span>
|
219
|
+
<span class="n">SnapPy</span>
|
220
|
+
<span class="c1"># Return to system Python</span>
|
221
|
+
<span class="n">deactivate</span>
|
131
222
|
</pre></div>
|
132
223
|
</div>
|
133
|
-
<p>
|
134
|
-
<
|
224
|
+
<p>If you always want to use the <code class="docutils literal notranslate"><span class="pre">snappy_venv</span></code> Python, adjust your
|
225
|
+
<a class="reference external" href="https://opensource.com/article/17/6/set-path-linux">$PATH</a> to
|
226
|
+
<strong>start</strong> with <code class="docutils literal notranslate"><span class="pre">snappy_venv/bin</span></code>.</p>
|
227
|
+
</dd>
|
228
|
+
<dt>User install</dt><dd><p>To do a user install with pip, try:</p>
|
229
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># Note no "sudo" below!</span>
|
230
|
+
<span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">upgrade</span> <span class="o">--</span><span class="n">user</span> <span class="n">snappy</span> <span class="n">snappy_15_knots</span>
|
135
231
|
</pre></div>
|
136
232
|
</div>
|
137
|
-
<p>
|
138
|
-
|
139
|
-
command “SnapPy” which does the same thing. To make it so that you
|
140
|
-
can start SnapPy with just the command <code class="docutils literal notranslate"><span class="pre">SnapPy</span></code>, make sure
|
141
|
-
<code class="docutils literal notranslate"><span class="pre">~/.local/bin</span></code> is in <a class="reference external" href="https://opensource.com/article/17/6/set-path-linux">in your path</a>.</p>
|
142
|
-
</section>
|
143
|
-
<section id="python-modules-for-macintosh-or-windows">
|
144
|
-
<h2>Python Modules for Macintosh or Windows<a class="headerlink" href="#python-modules-for-macintosh-or-windows" title="Permalink to this headline">¶</a></h2>
|
145
|
-
<p>If you write Python programs on a Macintosh or Windows system, you may
|
146
|
-
wish to install SnapPy as a Python module into your own copy of
|
147
|
-
Python. We support Python 3.6 and up. (On macOS, use a Python
|
148
|
-
downloaded from <a class="reference external" href="http://python.org">Python.org</a> and not the one
|
149
|
-
provided by Apple.) After installing Python, you may install a SnapPy
|
150
|
-
module from your Terminal application or Command Prompt with the
|
151
|
-
commands:</p>
|
152
|
-
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">upgrade</span> <span class="o">--</span><span class="n">user</span> <span class="n">snappy</span>
|
233
|
+
<p>If you get a long error message that starts:</p>
|
234
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">error</span><span class="p">:</span> <span class="n">externally</span><span class="o">-</span><span class="n">managed</span><span class="o">-</span><span class="n">environment</span>
|
153
235
|
</pre></div>
|
154
236
|
</div>
|
155
|
-
<p>
|
156
|
-
|
157
|
-
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="
|
237
|
+
<p>you should probably use a virtual environment; however,
|
238
|
+
you can force pip to do a user install via:</p>
|
239
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># Note no "sudo" below!</span>
|
240
|
+
<span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">upgrade</span> <span class="o">--</span><span class="n">user</span> <span class="o">--</span><span class="k">break</span><span class="o">-</span><span class="n">system</span><span class="o">-</span><span class="n">packages</span> <span class="n">snappy</span> <span class="n">snappy_15_knots</span>
|
158
241
|
</pre></div>
|
159
242
|
</div>
|
160
|
-
<p>
|
161
|
-
|
162
|
-
|
243
|
+
<p>Despite the scary name, provided you don’t use <code class="docutils literal notranslate"><span class="pre">sudo</span></code>, this will
|
244
|
+
not actually modify the system packages, but rather install
|
245
|
+
<code class="docutils literal notranslate"><span class="pre">snappy</span></code> into the subdirectory
|
246
|
+
<code class="docutils literal notranslate"><span class="pre">~/.local/share/python3.*/site-packages</span></code> of your home directory.</p>
|
247
|
+
<p>After a user install, you run the following command to start
|
248
|
+
the app:</p>
|
249
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">~/.</span><span class="n">local</span><span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">SnapPy</span>
|
250
|
+
</pre></div>
|
251
|
+
</div>
|
252
|
+
<p>So that you can start SnapPy with just the command <code class="docutils literal notranslate"><span class="pre">SnapPy</span></code>, make
|
253
|
+
sure <code class="docutils literal notranslate"><span class="pre">~/.local/bin</span></code> is in <a class="reference external" href="https://opensource.com/article/17/6/set-path-linux">in your path</a>.</p>
|
254
|
+
</dd>
|
255
|
+
</dl>
|
163
256
|
</section>
|
164
257
|
<section id="sagemath">
|
165
|
-
<h2>SageMath<a class="headerlink" href="#sagemath" title="
|
258
|
+
<h2>SageMath<a class="headerlink" href="#sagemath" title="Link to this heading"></a></h2>
|
166
259
|
<p>SnapPy has some special features when used within <a class="reference external" href="http://sagemath.org">SageMath</a>, the universal mathematics software based on
|
167
260
|
Python. This section describes how to install SnapPy into your
|
168
|
-
existing copy of SageMath
|
169
|
-
<
|
170
|
-
optional package via the following if using Sage 6.4 or newer:</p>
|
171
|
-
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sage</span> <span class="o">-</span><span class="n">pip</span> <span class="n">install</span> <span class="n">snappy</span>
|
172
|
-
<span class="n">sage</span> <span class="o">-</span><span class="n">pip</span> <span class="n">install</span> <span class="n">snappy_15_knots</span> <span class="c1"># Larger version of HTLinkExteriors</span>
|
261
|
+
existing copy of SageMath:</p>
|
262
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sage</span> <span class="o">-</span><span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">upgrade</span> <span class="n">snappy</span> <span class="n">snappy_15_knots</span>
|
173
263
|
</pre></div>
|
174
264
|
</div>
|
175
|
-
<p>If you are on macOS, we recommend use <a class="reference external" href="https://github.com/3-manifolds/Sage_macOS/releases">this binary</a>.</p>
|
176
265
|
<p>Alternatively, SageMath on <a class="reference external" href="https://cocalc.com/">CoCalc</a> (formerly
|
177
266
|
the SageMathCloud) also has SnapPy preinstalled, and the graphics
|
178
267
|
features even work via the <a class="reference external" href="http://blog.sagemath.com/cocalc/2018/11/05/x11.html">X11 interface</a>, see the
|
179
268
|
bottom of that page for more.</p>
|
180
|
-
<p>
|
181
|
-
|
182
|
-
|
183
|
-
|
184
|
-
</
|
185
|
-
|
186
|
-
the <cite>“gl.h” headers <openglmesa></cite>. The graphical features may or may
|
187
|
-
not work, depending on how Tkinter was configured within Sage, and may
|
188
|
-
seem to “hang” when you try to start them. To deal with the latter
|
189
|
-
issue type “%gui tk” at the Sage prompt; please note that doing so may
|
190
|
-
break Sage’s “attach” feature.</p>
|
269
|
+
<p>The graphical features may or may not work, depending on how Tkinter
|
270
|
+
was configured within Sage. (There is no problem on macOS if you use
|
271
|
+
this <a class="reference external" href="https://github.com/3-manifolds/Sage_macOS/releases">SageMath binary</a>.) If the
|
272
|
+
graphical features seem to “hang” when you try to start them, type
|
273
|
+
<code class="docutils literal notranslate"><span class="pre">%gui</span> <span class="pre">tk</span></code> at the Sage prompt; please note that doing so may break
|
274
|
+
Sage’s “attach” feature.</p>
|
191
275
|
</section>
|
192
276
|
<section id="kitchen-sink">
|
193
|
-
<h2>Kitchen sink<a class="headerlink" href="#kitchen-sink" title="
|
277
|
+
<h2>Kitchen sink<a class="headerlink" href="#kitchen-sink" title="Link to this heading"></a></h2>
|
194
278
|
<p>SnapPy gains extra features when used in <a class="reference external" href="http://sagemath.org">SageMath</a> and one can use
|
195
279
|
Sage’s Python to interact not just with SnapPy but a range of other
|
196
280
|
computational tools in low-dimensional topology including
|
@@ -200,76 +284,27 @@ computational tools in low-dimensional topology including
|
|
200
284
|
<a class="reference external" href="https://github.com/3-manifolds/gridlink">gridlink</a>,
|
201
285
|
and <a class="reference external" href="http://flipper.readthedocs.io">flipper</a>.
|
202
286
|
We offer a <a class="reference external" href="https://hub.docker.com/r/computop/sage/">prepackaged Docker image</a> with all of the above tools
|
203
|
-
and many more; using this is
|
204
|
-
working setup for such multifaceted computations. For more, watch
|
287
|
+
and many more; using this is sometimes the easiest way to get a
|
288
|
+
working setup for such multifaceted computations, especially on Windows. For more, watch
|
205
289
|
<a class="reference external" href="https://icerm.brown.edu/video_archive/?play=1992">this demonstration</a>.</p>
|
206
|
-
<p>We also offer <a class="reference external" href="https://github.com/unhyperbolic/condaForSnapPy">conda environments</a> with SnapPy and
|
207
|
-
optionally Sage (only on Mac OS and Linux). While it has none of the
|
208
|
-
other aforementioned tools, it has the advantage that the GUI elements
|
209
|
-
such as the link editor and the browser can be used directly.</p>
|
210
290
|
</section>
|
211
|
-
<section id="
|
212
|
-
<h2>
|
213
|
-
<p>
|
214
|
-
|
215
|
-
Here
|
216
|
-
|
217
|
-
<
|
218
|
-
<
|
219
|
-
|
220
|
-
|
221
|
-
|
222
|
-
“python3-devel”, and “python3-wheel”.</p></li>
|
223
|
-
<li><p>Test that Python is in order by installing PLink from source:</p>
|
224
|
-
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">user</span> <span class="n">plink</span>
|
225
|
-
<span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">plink</span><span class="o">.</span><span class="n">app</span> <span class="c1"># Should start the link editor!</span>
|
226
|
-
</pre></div>
|
227
|
-
</div>
|
228
|
-
</li>
|
229
|
-
</ul>
|
230
|
-
<ul id="openglmesa">
|
231
|
-
<li><p>Support for OpenGL (3D graphics): This is built in on OS X and the
|
232
|
-
most installations of Fedora and Ubuntu. But you’ll need the <a class="reference external" href="http://www.mesa3d.org/">MESA</a> header files “gl.h” and “glu.h” to compile
|
233
|
-
SnapPy. On Debian and Ubuntu, install “libglu1-mesa-dev”; On Fedora install
|
234
|
-
“mesa-libGLU-devel”.</p></li>
|
235
|
-
<li><p><a class="reference external" href="http://cython.org">Cython</a>, which you can install via:</p>
|
236
|
-
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">user</span> <span class="n">cython</span>
|
237
|
-
</pre></div>
|
238
|
-
</div>
|
239
|
-
</li>
|
240
|
-
<li><p>The gcc C++ compiler, g++.</p></li>
|
241
|
-
<li><p><a class="reference external" href="https://pypi.python.org/pypi/cypari/">CyPari</a>: a stand-alone version of
|
242
|
-
<a class="reference external" href="http://sagemath.org">Sage’s</a> Python interface to the
|
243
|
-
<a class="reference external" href="http://pari.math.u-bordeaux.fr/PARI">PARI</a> number theory
|
244
|
-
library. Usually, you can install this with:</p>
|
245
|
-
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">user</span> <span class="n">cypari</span>
|
246
|
-
</pre></div>
|
247
|
-
</div>
|
248
|
-
</li>
|
249
|
-
</ul>
|
250
|
-
<p>Now download the <a class="reference internal" href="#source-code">source code</a> listed below, for instance</p>
|
251
|
-
<pre class="literal-block">wget <a class="reference external" href="https://pypi.python.org/packages/source/s/snappy/">https://pypi.python.org/packages/source/s/snappy/</a>snappy-3.0.3.tar.gz
|
252
|
-
tar xfz snappy-3.0.3.tar.gz; cd snappy-*</pre>
|
253
|
-
<p>There is one more dependency that may need to be dealt with:</p>
|
254
|
-
<ul class="simple">
|
255
|
-
<li><p><a class="reference external" href="http://togl.sf.net">Togl</a>: a 3d widget for Tk. For OS X and
|
256
|
-
Linux, there are pre-built binaries of this in the snappy
|
257
|
-
subdirectory, e.g. snappy/linux2-tk8.4. For Linux these are built
|
258
|
-
for 64-bit kernels, and should work on most systems. If they don’t,
|
259
|
-
you’ll need to edit or follow “build_togl.sh” to build Togl directly.</p></li>
|
260
|
-
</ul>
|
261
|
-
<p>Finally, compile and install the SnapPy module (which will install
|
262
|
-
certain other dependencies) and test:</p>
|
263
|
-
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">python3</span> <span class="n">setup</span><span class="o">.</span><span class="n">py</span> <span class="n">build</span>
|
264
|
-
<span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">--</span><span class="n">user</span> <span class="o">.</span>
|
265
|
-
<span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">snappy</span><span class="o">.</span><span class="n">test</span>
|
266
|
-
<span class="n">python3</span> <span class="o">-</span><span class="n">m</span> <span class="n">snappy</span><span class="o">.</span><span class="n">app</span>
|
291
|
+
<section id="conda">
|
292
|
+
<h2>Conda<a class="headerlink" href="#conda" title="Link to this heading"></a></h2>
|
293
|
+
<p>Conda can be used to install Python on all platforms and is a
|
294
|
+
particularly good choice to use SnapPy on the older Linux systems
|
295
|
+
often found on high-performance clusters. Here is a recipe for
|
296
|
+
installing SnapPy into a new conda environment on macOS or Linux:</p>
|
297
|
+
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">source</span> <span class="o">~/</span><span class="n">miniforge3</span><span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">activate</span>
|
298
|
+
<span class="n">mamba</span> <span class="n">create</span> <span class="o">--</span><span class="n">name</span> <span class="n">snappy_env</span> <span class="n">python</span><span class="o">=</span><span class="mf">3.12</span>
|
299
|
+
<span class="n">conda</span> <span class="n">activate</span> <span class="n">snappy_env</span>
|
300
|
+
<span class="n">pip</span> <span class="n">install</span> <span class="n">snappy</span>
|
301
|
+
<span class="n">python</span> <span class="o">-</span><span class="n">m</span> <span class="n">snappy</span><span class="o">.</span><span class="n">app</span>
|
267
302
|
</pre></div>
|
268
303
|
</div>
|
269
304
|
</section>
|
270
305
|
<section id="source-code">
|
271
|
-
<h2>Source code<a class="headerlink" href="#source-code" title="
|
272
|
-
<p>The complete source code for all platforms: <a class="reference external" href="https://pypi.python.org/packages/source/s/snappy/snappy-3.
|
306
|
+
<h2>Source code<a class="headerlink" href="#source-code" title="Link to this heading"></a></h2>
|
307
|
+
<p>The complete source code for all platforms: <a class="reference external" href="https://pypi.python.org/packages/source/s/snappy/snappy-3.2.tar.gz">snappy-3.2.tar.gz</a></p>
|
273
308
|
<p>You can also browse our <a class="reference external" href="https://github.com/3-manifolds/SnapPy">source code repository</a> or clone it using <a class="reference external" href="https://git-scm.com/">git</a> via:</p>
|
274
309
|
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">git</span> <span class="n">clone</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">github</span><span class="o">.</span><span class="n">com</span><span class="o">/</span><span class="mi">3</span><span class="o">-</span><span class="n">manifolds</span><span class="o">/</span><span class="n">SnapPy</span><span class="o">.</span><span class="n">git</span>
|
275
310
|
</pre></div>
|
@@ -278,76 +313,34 @@ certain other dependencies) and test:</p>
|
|
278
313
|
</section>
|
279
314
|
|
280
315
|
|
281
|
-
|
316
|
+
</div>
|
282
317
|
</div>
|
283
|
-
|
284
|
-
|
285
|
-
|
286
|
-
<div class="sphinxsidebarwrapper">
|
287
|
-
<h3><a href="index.html">Table of Contents</a></h3>
|
288
|
-
<ul>
|
289
|
-
<li><a class="reference internal" href="#">Installing SnapPy</a><ul>
|
290
|
-
<li><a class="reference internal" href="#macos">macOS</a></li>
|
291
|
-
<li><a class="reference internal" href="#windows">Windows</a></li>
|
292
|
-
<li><a class="reference internal" href="#linux">Linux</a></li>
|
293
|
-
<li><a class="reference internal" href="#python-modules-for-macintosh-or-windows">Python Modules for Macintosh or Windows</a></li>
|
294
|
-
<li><a class="reference internal" href="#sagemath">SageMath</a></li>
|
295
|
-
<li><a class="reference internal" href="#kitchen-sink">Kitchen sink</a></li>
|
296
|
-
<li><a class="reference internal" href="#generic-unix">Generic Unix</a></li>
|
297
|
-
<li><a class="reference internal" href="#source-code">Source code</a></li>
|
298
|
-
</ul>
|
299
|
-
</li>
|
300
|
-
</ul>
|
301
|
-
|
302
|
-
<h4>Previous topic</h4>
|
303
|
-
<p class="topless"><a href="index.html"
|
304
|
-
title="previous chapter">SnapPy</a></p>
|
305
|
-
<h4>Next topic</h4>
|
306
|
-
<p class="topless"><a href="screenshots.html"
|
307
|
-
title="next chapter">Screenshots: SnapPy in action</a></p>
|
308
|
-
<div role="note" aria-label="source link">
|
309
|
-
<h3>This Page</h3>
|
310
|
-
<ul class="this-page-menu">
|
311
|
-
<li><a href="_sources/installing.rst.txt"
|
312
|
-
rel="nofollow">Show Source</a></li>
|
313
|
-
</ul>
|
314
|
-
</div>
|
315
|
-
<div id="searchbox" style="display: none" role="search">
|
316
|
-
<h3 id="searchlabel">Quick search</h3>
|
317
|
-
<div class="searchformwrapper">
|
318
|
-
<form class="search" action="search.html" method="get">
|
319
|
-
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
|
320
|
-
<input type="submit" value="Go" />
|
321
|
-
</form>
|
318
|
+
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
|
319
|
+
<a href="index.html" class="btn btn-neutral float-left" title="SnapPy" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
320
|
+
<a href="screenshots.html" class="btn btn-neutral float-right" title="Screenshots: SnapPy in action" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
322
321
|
</div>
|
323
|
-
|
324
|
-
<
|
322
|
+
|
323
|
+
<hr/>
|
324
|
+
|
325
|
+
<div role="contentinfo">
|
326
|
+
<p>© Copyright 2009-2025, by Marc Culler, Nathan Dunfield, Matthias Goerner, Jeffrey Weeks and others.</p>
|
327
|
+
</div>
|
328
|
+
|
329
|
+
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
|
330
|
+
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
|
331
|
+
provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
332
|
+
|
333
|
+
|
334
|
+
</footer>
|
325
335
|
</div>
|
326
336
|
</div>
|
327
|
-
|
328
|
-
|
329
|
-
|
330
|
-
|
331
|
-
|
332
|
-
|
333
|
-
|
334
|
-
|
335
|
-
|
336
|
-
<a href="py-modindex.html" title="Python Module Index"
|
337
|
-
>modules</a> |</li>
|
338
|
-
<li class="right" >
|
339
|
-
<a href="screenshots.html" title="Screenshots: SnapPy in action"
|
340
|
-
>next</a> |</li>
|
341
|
-
<li class="right" >
|
342
|
-
<a href="index.html" title="SnapPy"
|
343
|
-
>previous</a> |</li>
|
344
|
-
<li class="nav-item nav-item-0"><a href="index.html">SnapPy 3.0.3 documentation</a> »</li>
|
345
|
-
<li class="nav-item nav-item-this"><a href="">Installing SnapPy</a></li>
|
346
|
-
</ul>
|
347
|
-
</div>
|
348
|
-
<div class="footer" role="contentinfo">
|
349
|
-
© Copyright 2009-2021, by Marc Culler, Nathan Dunfield, Matthias Goerner, Jeffrey Weeks and others.
|
350
|
-
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 4.3.1.
|
351
|
-
</div>
|
352
|
-
</body>
|
337
|
+
</section>
|
338
|
+
</div>
|
339
|
+
<script>
|
340
|
+
jQuery(function () {
|
341
|
+
SphinxRtdTheme.Navigation.enable(true);
|
342
|
+
});
|
343
|
+
</script>
|
344
|
+
|
345
|
+
</body>
|
353
346
|
</html>
|