Skip to main content

Motives 0.3.3

pypi PyPI Downloads python os

Motives is a symbolic manipulation package based on SymPy, which handles motivic expressions in the Grothendieck ring of Chow motives and other types of λ-rings. It is an easy to use library aimed to help researchers verify equations, simplify, and handle motivic expressions. Check the paper Motives meet SymPy: studying λ-ring expressions in Python for a more comprehensive description of the package.

Grothendieck's motive of a variety is an invariant that provides extensive information about its geometry. Manipulating motivic formulas and understanding when two distinct expressions can represent the same variety is sometimes complex but mathematically interesting. The goal of this package is to provide a comprehensive tool that allows efficient manipulation and comparison of motives, as well as expressions in other λ-rings. Furthermore, it contains the equations for the motives of some commonly used moduli spaces, so that the package can be applied easily to test hypothesis and conjectural results on their geometry.

Methodology

The simplification algorithm is based on a refinement of the abstract simplification algorithm for λ-ring expressions developed in [Alfaya '22]. See [Sanchez, Alfaya and Pizarroso '24] for the complete mathematical description of the algorithms and equations used by the package.

The package works on λ-rings (R,λ,σ) under the following assumptions:

  • R is a unital abelian ring with no additive torsion.
  • There are two mutually oposite λ-ring structures on R, λ and σ.
  • σ is a special λ-ring structure, and has associated Adams operations ψ. λ is not assumed to be special.

Based on these assumptions, the algorithm uses certain universal algebraic relations allowing to write λ-ring operations λ, σ and ψ in terms on each other and the fact that Adams operations are ring homomorphisms to convert any expression tree in a λ-ring as a polynomial in terms of a finite set of Adams operations ψ. This equivalent Adams polynomial can then be used for comparison, or be transformeed into a polynomial in λ-powers instead, which allows to obtain smaller polynomial representations of an expression when it depends of elements of small dimension in the σ λ-ring structure.

The package includes modules for working with the Grothendieck ring of motives, with its natural λ-ring structures yield by symmetric and alternated products. It contains modules for working with several commonly used motives, including the following:

  • Complex algebraic curves. Implements the algebraic relations from [Heinloth '07].
  • Jacobian and Picard varieties of curves. Implements the equations from [Heinloth '07].
  • Symmetric and alternated products of any variety given its motive.
  • Moduli spaces of vector bundles on curves. Implements the equations from [García-Prada, Heinloth and Shmitt '14], [Sánchez '14] and [del Baño '01].
  • Moduli spaces of L-twisted Higgs bundles on curves. Implements the theorems from [Alfaya and Oliveira '24] and the conjectural formula from [Mozgovoy '12].
  • Moduli spaces of chain bundles and variations of Hodge structure on curves in low rank. Implements the results in [García-Prada, Heinloth and Shmitt '14] and [Sánchez '14].
  • Algebraic groups. Implements the formula from [Behrend and Dhillon '07].
  • Moduli stacks of vector bundles and principal G-bundles on curves. Uses the conjectural formulas from [Behrend and Dhillon '07] (proven for SL(n,C))
  • Classifying stacks BG for several groups G. Applies results from [Behrend and Dhillon '07], [Bergh '16] and [Dhillon and Young '16].

Citation

If you use the "motives" package in your work, please cite the paper

Daniel Sanchez, David Alfaya and Jaime Pizarroso. Motives meet SymPy: studying λ-ring expressions in Python. arXiv:2501.00563, 2025.

Getting Started

Prerequisites

  • Python >= 3.10.6
  • pytest==7.4.4
  • sympy>=1.12
  • tqdm==4.66.1
  • typeguard==4.3.0

Installation

  1. Install the package from PyPI

    pip install motives
    
  2. Import the package in your Python code

    import motives
    

Alternatively, you can install the package from the source code:

  1. Clone the repository
    git clone https://github.com/CIAMOD/motives.git
    
  2. Install the required packages
    pip install -r requirements.txt
    

Usage

Instructions on how to run the software or code will be updated soon.

License

This project is licensed under the GNU GPLv3 License - see the LICENSE.md file in each repository for details.

Authors

  • Daniel Sánchez Sánchez, Student of the Degree in Mathematical Engineering and Artificial Intelligence, ICAI, Comillas Pontifical University
  • David Alfaya Sánchez, Department of Applied Mathematics and Institute for Research in Technology, ICAI, Comillas Pontifical University
  • Jaime Pizarroso Gonzalo, Department of Telematics and Computing and Institute for Research in Technology, ICAI, Comillas Pontifical University

Acknowledgments

This research was supported by project CIAMOD (Applications of computational methods and artificial intelligence to the study of moduli spaces, project PP2023_9) funded by Convocatoria de Financiación de Proyectos de Investigación Propios 2023, Universidad Pontificia Comillas, and by grants PID2022-142024NB-I00 and RED2022-134463-T funded by MCIN/AEI/10.13039/501100011033.

Find more about the CIAMOD project in the project webpage and the IIT proyect webpage.

Special thanks to everyone who contributed to the project:

  • David Alfaya Sánchez (PI), Department of Applied Mathematics and Institute for Research in Technology, ICAI, Comillas Pontifical University
  • Javier Rodrigo Hitos, Department of Applied Mathematics, ICAI, Comillas Pontifical University
  • Luis Ángel Calvo Pascual, Department of Quantitative Methods, ICADE, Comillas Pontifical University
  • Anitha Srinivasan, Department of Quantitative Methods, ICADE, Comillas Pontifical University
  • José Portela González, Department of Quantitative Methods, ICADE, IIT, Comillas Pontifical University
  • Jaime Pizarroso Gonzalo, Department of Telematics and Computing and Institute for Research in Technology, ICAI, Comillas Pontifical University
  • Tomás Luis Gómez de Quiroga, Institute of Mathematical Sciences, UAM-UCM-UC3M-CSIC
  • Daniel Sánchez Sánchez, Student of the Degree in Mathematical Engineering and Artificial Intelligence, Institute for Research in Technology, ICAI, Comillas Pontifical University
  • Alejandro Martínez de Guinea García, Student of the Degree in Mathematical Engineering and Artificial Intelligence, Institute for Research in Technology, ICAI, Comillas Pontifical University
  • Sergio Herreros Pérez, Student of the Degree in Mathematical Engineering and Artificial Intelligence, Institute for Research in Technology, ICAI, Comillas Pontifical University

References

  • [Alfaya '22] David Alfaya. Simplification of λ-ring expressions in the Grothendieck ring of Chow motives. Applicable Algebra in Engineering, Communication and Computing, 33:599–628, 2022.
  • [Alfaya, Oliveira '24] David Alfaya and André Oliveira. Lie algebroid connections, twisted Higgs bundles and motives of moduli spaces. Journal of Geometry and Physics, 201:105195–1 – 105195–55, 2024.
  • [Behrend and Dhillon '07] Kai Behrend and Ajneet Dhillon. On the motivic class of the stack of bundles. Advances in Mathematics, 212(2):617–644, 2007.
  • [Bergh '16] Daniel Bergh. Motivic classes of some classifying stacks. Journal of the London Mathematical Society, 93(1):219– 243, 2016.
  • [del Baño '01] Sebastian del Baño. On the chow motive of some moduli spaces. Journal für die reine und angewandte Mathematik, 2001(532):105–132, 2001
  • [Dhillon and Young '16] Ajneet Dhillon and Matthew B. Young. The motive of the classifying stack of the orthogonal group. Michigan Math. J., 65(1):189–197, 2016.
  • [García-Prada, Heinloth and Schmitt '14] Oscar García-Prada, Jochen Heinloth, and Alexander Schmitt. On the motives of moduli of chains and Higgs bundles. Journal of the European Mathematical Society, 16:2617–2668, 2014.
  • [Heinloth '07 ] Franziska Heinloth. A note on functional equations for zeta functions with values in Chow motives. Ann. Inst. Fourier (Grenoble), 57(6):1927–1945, 2007.
  • [Sánchez '14] Jonathan S´anchez. Motives of moduli spaces of pairs and applications. PhD thesis, Universidad Complutense de Madrid, Madrid, 2014.
  • [Sanchez, Alfaya and Pizarroso '24] Daniel Sanchez, David Alfaya and Jaime Pizarroso. Motives meet SymPy: studying λ-ring expressions in Python. arXiv:2501.00563, 2025.
  • [Mozgovoy '12] Sergey Mozgovoy. Solutions of the motivic ADHM recursion formula. Int. Math. Res. Not. IMRN, 2012(18):4218–4244, 2012.
  • [Chuang, Diaconescu, Pan 2011] CHUANG, Wu-yen; DIACONESCU, Duiliu-Emanuel; PAN, Guang. Wallcrossing and cohomology of the moduli space of Hitchin pairs. arXiv preprint arXiv:1004.4195, 2010.

Metadata

Release files for motives 0.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for motives 0.3.3
File Size Uploaded Provenance Actions
motives-0.3.3.tar.gz 58.4 kB Without provenance Details for motives-0.3.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for motives 0.3.3
File Interpreter ABI Platform Actions
motives-0.3.3-py3-none-any.whl Python 3 none any Details for motives-0.3.3-py3-none-any.whl

Total release size: 140.1 kB

Release files / motives-0.3.3.tar.gz

Download URL motives-0.3.3.tar.gz
Size 58.4 kB
Tags Source
SHA-256 checksum
How to use checksums
a9a9ed5aca48cf75622762716e2d1b955bd214f42f363aeae3661c88e1b26a8a
BLAKE2b-256 checksum
How to use checksums
2d0579d01ef4237eb9495b390abdca929c5f9ff51a0ece3d19b6a1d09ac63621
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.11.7 Windows/10

Release files / motives-0.3.3-py3-none-any.whl

Download URL motives-0.3.3-py3-none-any.whl
Size 81.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8c1c41d35da3c1f2c148ad9911c8b71bdf658c592dc8288ee4184bbb96ba24dc
BLAKE2b-256 checksum
How to use checksums
6a280bc8469c4e2d3289288b0d77a87b46a66d02e83379a28bda444457254dc2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.11.7 Windows/10

Security for motives 0.3.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page