passagemath-homfly 10.6.35__cp314-cp314t-macosx_13_0_arm64.whl

passagemath_homfly-10.6.35.dist-info/METADATA

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: passagemath-homfly
+Version: 10.6.35
+Summary: passagemath: Homfly polynomials of knots/links with libhomfly
+Author-email: The Sage Developers <sage-support@googlegroups.com>
+Maintainer: Matthias Köppe, passagemath contributors
+License-Expression: GPL-2.0-or-later
+Project-URL: release notes, https://github.com/passagemath/passagemath/releases
+Project-URL: repo (upstream), https://github.com/sagemath/sage
+Project-URL: repo, https://github.com/passagemath/passagemath
+Project-URL: documentation, https://passagemath.org/docs/latest
+Project-URL: homepage (upstream), https://www.sagemath.org
+Project-URL: discourse, https://passagemath.discourse.group
+Project-URL: tracker (upstream), https://github.com/sagemath/sage/issues
+Project-URL: tracker, https://github.com/passagemath/passagemath/issues
+Classifier: Development Status :: 6 - Mature
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/x-rst
+Requires-Dist: cysignals<1.12.4; sys_platform == "win32"
+Requires-Dist: cysignals!=1.12.0,>=1.11.2
+Provides-Extra: test
+Requires-Dist: passagemath-graphs; extra == "test"
+Requires-Dist: passagemath-repl; extra == "test"
+
+==========================================================================================
+ passagemath: Homfly polynomials of knots/links with libhomfly
+==========================================================================================
+
+`passagemath <https://github.com/passagemath/passagemath>`__ is open
+source mathematical software in Python, released under the GNU General
+Public Licence GPLv2+.
+
+It is a fork of `SageMath <https://www.sagemath.org/>`__, which has been
+developed 2005-2025 under the motto “Creating a Viable Open Source
+Alternative to Magma, Maple, Mathematica, and MATLAB”.
+
+The passagemath fork uses the motto "Creating a Free Passage Between the
+Scientific Python Ecosystem and Mathematical Software Communities."
+It was created in October 2024 with the following goals:
+
+-  providing modularized installation with pip,
+-  establishing first-class membership in the scientific Python
+   ecosystem,
+-  giving `clear attribution of upstream
+   projects <https://groups.google.com/g/sage-devel/c/6HO1HEtL1Fs/m/G002rPGpAAAJ>`__,
+-  providing independently usable Python interfaces to upstream
+   libraries,
+-  offering `platform portability and integration testing
+   services <https://github.com/passagemath/passagemath/issues/704>`__
+   to upstream projects,
+-  inviting collaborations with upstream projects,
+-  `building a professional, respectful, inclusive
+   community <https://groups.google.com/g/sage-devel/c/xBzaINHWwUQ>`__,
+-  `empowering Sage users to participate in the scientific Python ecosystem
+   <https://github.com/passagemath/passagemath/issues/248>`__ by publishing packages,
+-  developing a port to `Pyodide <https://pyodide.org/en/stable/>`__ for
+   serverless deployment with Javascript,
+-  developing a native Windows port.
+
+`Full documentation <https://passagemath.org/docs/latest/html/en/index.html>`__ is
+available online.
+
+passagemath attempts to support and provides binary wheels suitable for
+all major Linux distributions and recent versions of macOS.
+
+Binary wheels for native Windows (x86_64) are are available for a subset of
+the passagemath distributions. Use of the full functionality of passagemath
+on Windows currently requires the use of Windows Subsystem for Linux (WSL)
+or virtualization.
+
+The supported Python versions in the passagemath 10.6.x series are 3.10.x-3.13.x.
+
+
+About this pip-installable distribution package
+-----------------------------------------------
+
+This pip-installable distribution ``passagemath-homfly`` provides a Cython interface
+to the `libhomfly <https://github.com/miguelmarco/libhomfly>`_ library.
+
+
+What is included
+----------------
+
+* `sage.libs.homfly <https://github.com/passagemath/passagemath/blob/main/src/sage/libs/homfly.pyx>`_
+
+
+Examples
+--------
+
+::
+
+    $ pipx run --pip-args="--prefer-binary" --spec "passagemath-homfly[test]" ipython
+
+    In [1]: from sage.libs.homfly import homfly_polynomial_dict
+
+    In [2]: trefoil = '1 6 0 1  1 -1  2 1  0 -1  1 1  2 -1 0 1 1 1 2 1'
+
+    In [3]: homfly_polynomial_dict(trefoil)
+    Out[3]: {(-4, 0): -1, (-2, 0): -2, (-2, 2): 1}

passagemath_homfly-10.6.35.dist-info/RECORD

@@ -0,0 +1,10 @@
+passagemath_homfly-10.6.35.dist-info/RECORD,,
+passagemath_homfly-10.6.35.dist-info/WHEEL,sha256=nEAtTEo8zKB0Etf0OcFBf11mfJfxrhFw5PZkKHw0p5k,154
+passagemath_homfly-10.6.35.dist-info/top_level.txt,sha256=Kmzulf9WsphADFQuqgvdy5mvTLDj_V2zkFHU2s3UXos,6
+passagemath_homfly-10.6.35.dist-info/METADATA,sha256=ng6qWpy8CBeAcUqaSpw5Iw3KoWkqiU6VYCnxAFHnxLk,4916
+passagemath_homfly.dylibs/libgc.1.dylib,sha256=fpzijQacq2YOhUPQ3i0AC00e80R-MUbsK2BGE-MFKOk,263360
+passagemath_homfly.dylibs/libhomfly.0.0.0.dylib,sha256=ThpAhOw5tBTtNv8Jkb6gXD1sxfvKdPJMB1x7sMNKYK0,72216
+sage/all__sagemath_homfly.py,sha256=F63UPkJOfraoStQNe-1tYDqhjd-siF5P04FcMv4yRcg,106
+sage/libs/homfly.cpython-314t-darwin.so,sha256=vPUmKTTDhItCIngLpgnf_H-lPE7cPZJaiMbozsPYqu8,77136
+sage/libs/homfly.pyx,sha256=RKaj10MXyfdAIqnDec18931GnQrOSPATo92NsdPNCe8,2988
+sage/libs/all__sagemath_homfly.py,sha256=acUGFX0Wx4P0uJwgj5m9ANtfRaZriA7rgY4-VlJE8xc,45

passagemath_homfly-10.6.35.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp314-cp314t-macosx_13_0_arm64
+Generator: delocate 0.13.1.dev42+ga0af70b54
+

passagemath_homfly-10.6.35.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+
+sage

sage/all__sagemath_homfly.py

@@ -0,0 +1,4 @@
+# sage_setup: distribution = sagemath-homfly
+# delvewheel: patch
+
+from sage.all__sagemath_graphs import *

sage/libs/all__sagemath_homfly.py

@@ -0,0 +1 @@
+# sage_setup: distribution = sagemath-homfly

sage/libs/homfly.pyx

@@ -0,0 +1,104 @@
+# sage_setup: distribution = sagemath-homfly
+# distutils: libraries = homfly gc
+r"""
+Cython wrapper for libhomfly library
+
+This is used to call the libhomfly library directly from python. Knots
+and links are passed following the convention in libhomfly. It is basically
+the oriented Gauss code, represented as a string of integers separated
+by spaces as follows:
+
+- how many strings,
+
+  - for each string, how many crossings, then
+
+    - for each crossing, the cross name, then `1` if over, `-1` if under
+
+- for each crossing, the name of the crossing and `1` if right, `-1` if left.
+
+If there are `n` crossings, they must be named `0, 1, ..., n-1`.
+
+AUTHORS:
+
+- Miguel Marco (2015-03-24): initial version.
+"""
+
+# ****************************************************************************
+#       Copyright (C) 2015 Miguel Marco  <mmarco@unizar.es>
+#
+#  Distributed under the terms of the GNU General Public License (GPL)
+#  as published by the Free Software Foundation; either version 2 of
+#  the License, or (at youroption) any later version.
+#                  https://www.gnu.org/licenses/
+# ****************************************************************************
+
+from cysignals.signals cimport sig_on, sig_off
+
+from sage.cpython.string cimport str_to_bytes, char_to_str
+
+cdef extern from "homfly.h":
+    ctypedef int  word
+    ctypedef signed long int sb4
+    ctypedef unsigned short int ub2
+    ctypedef signed short int sb2
+    struct Term:
+        sb4 coef
+        sb2 m
+        sb2 l
+    struct Poly:
+        Term* term
+        sb4 len
+    Poly* homfly(char *argv)
+    char* homfly_str(char *argv)
+
+
+def homfly_polynomial_string(link):
+    r"""
+    Return the HOMFLY polynomial of a link.
+
+    INPUT:
+
+    - ``link`` -- string of space-separated integers representing the link
+
+    OUTPUT: string with the HOMFLY polynomial in the variables `M` and `L`
+
+    EXAMPLES::
+
+        sage: from sage.libs.homfly import homfly_polynomial_string
+        sage: trefoil = '1 6 0 1  1 -1  2 1  0 -1  1 1  2 -1 0 1 1 1 2 1'
+        sage: homfly_polynomial_string(trefoil)
+        ' - L^-4 - 2L^-2 + M^2L^-2'
+    """
+    link = str_to_bytes(link)
+    sig_on()
+    cdef char* c_output = homfly_str(link)
+    sig_off()
+    return char_to_str(c_output)
+
+
+def homfly_polynomial_dict(link):
+    """
+    Return a dictionary representing the HOMFLY polynomial of a link.
+
+    INPUT:
+
+    - ``link`` -- string of space-separated integers representing the link
+
+    EXAMPLES::
+
+        sage: from sage.libs.homfly import homfly_polynomial_dict
+        sage: trefoil = '1 6 0 1  1 -1  2 1  0 -1  1 1  2 -1 0 1 1 1 2 1'
+        sage: homfly_polynomial_dict(trefoil)
+        {(-4, 0): -1, (-2, 0): -2, (-2, 2): 1}
+    """
+    link = str_to_bytes(link)
+    cdef Term ter
+    sig_on()
+    cdef Poly* c_output = homfly(link)
+    sig_off()
+    cdef int l = c_output.len
+    d = {}
+    for i in range(l):
+        ter = c_output.term[i]
+        d[(int(ter.l), int(ter.m))] = int(ter.coef)
+    return d