{"id":18522662,"url":"https://github.com/xanaduai/thewalrus","last_synced_at":"2025-04-04T23:07:38.081Z","repository":{"id":39571488,"uuid":"133076992","full_name":"XanaduAI/thewalrus","owner":"XanaduAI","description":"A library for the calculation of hafnians, Hermite polynomials and Gaussian boson sampling.","archived":false,"fork":false,"pushed_at":"2024-08-12T16:44:43.000Z","size":16190,"stargazers_count":101,"open_issues_count":21,"forks_count":55,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-09-17T06:26:01.039Z","etag":null,"topics":["algorithm","combinatorics","graphs","matrix","optimization","physics","quantum","quantum-computing"],"latest_commit_sha":null,"homepage":"https://the-walrus.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/XanaduAI.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-11T18:49:44.000Z","updated_at":"2024-09-02T03:31:30.000Z","dependencies_parsed_at":"2024-01-29T04:22:31.311Z","dependency_job_id":"297e8ae1-2b54-494c-82e1-7c0336053349","html_url":"https://github.com/XanaduAI/thewalrus","commit_stats":{"total_commits":963,"total_committers":38,"mean_commits":"25.342105263157894","dds":0.6728971962616823,"last_synced_commit":"43757a9c1e6fa2966c6c401b180951b46fe13c60"},"previous_names":["xanaduai/hafnian"],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XanaduAI%2Fthewalrus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XanaduAI%2Fthewalrus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XanaduAI%2Fthewalrus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XanaduAI%2Fthewalrus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/XanaduAI","download_url":"https://codeload.github.com/XanaduAI/thewalrus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247261603,"owners_count":20910108,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["algorithm","combinatorics","graphs","matrix","optimization","physics","quantum","quantum-computing"],"created_at":"2024-11-06T17:32:35.780Z","updated_at":"2025-04-04T23:07:38.058Z","avatar_url":"https://github.com/XanaduAI.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"The Walrus\n##########\n\n.. image:: https://github.com/XanaduAI/thewalrus/actions/workflows/tests.yml/badge.svg\n    :alt: Tests\n    :target: https://github.com/XanaduAI/thewalrus/actions/workflows/tests.yml\n\n.. image:: https://img.shields.io/codecov/c/github/xanaduai/thewalrus/master.svg?style=flat\n    :alt: Codecov coverage\n    :target: https://codecov.io/gh/XanaduAI/thewalrus\n\n.. image:: https://img.shields.io/codefactor/grade/github/XanaduAI/thewalrus/master?style=flat\n    :alt: CodeFactor Grade\n    :target: https://www.codefactor.io/repository/github/xanaduai/thewalrus\n\n.. image:: https://img.shields.io/readthedocs/the-walrus.svg?style=flat\n    :alt: Read the Docs\n    :target: https://the-walrus.readthedocs.io\n\n.. image:: https://img.shields.io/pypi/pyversions/thewalrus.svg?style=flat\n    :alt: PyPI - Python Version\n    :target: https://pypi.org/project/thewalrus\n\n.. image:: https://joss.theoj.org/papers/10.21105/joss.01705/status.svg\n    :alt: JOSS - The Journal of Open Source Software\n    :target: https://doi.org/10.21105/joss.01705\n\nA library for the calculation of hafnians, Hermite polynomials and Gaussian boson sampling. For more information, please see the `documentation \u003chttps://the-walrus.readthedocs.io\u003e`_.\n\nFeatures\n========\n\n* Fast calculation of hafnians, loop hafnians, and torontonians of general and certain structured matrices.\n\n* An easy to use interface to use the loop hafnian for Gaussian quantum state calculations.\n\n* Sampling algorithms for hafnian and torontonians of graphs.\n\n* Efficient classical methods for approximating the hafnian of non-negative matrices.\n\n* Easy to use implementations of the multidimensional Hermite polynomials, which can also be used to calculate hafnians of all reductions of a given matrix.\n\n\nInstallation\n============\n\nThe Walrus requires Python version 3.7, 3.8, 3.9, or 3.10. Installation of The Walrus, as\nwell as all dependencies, can be done using pip:\n\n.. code-block:: bash\n\n    pip install thewalrus\n\n\nCompiling from source\n=====================\n\nThe Walrus has the following dependencies:\n\n* `Python \u003chttp://python.org/\u003e`_ \u003e= 3.7\n* `NumPy \u003chttp://numpy.org/\u003e`_  \u003e= 1.19.2\n* `Numba \u003chttps://numba.pydata.org/\u003e`_ \u003e= 0.49.1\n* `SciPy \u003chttps://scipy.org/\u003e`_ \u003e=1.2.1\n* `SymPy \u003chttps://www.sympy.org/\u003e`_ \u003e=1.5.1\n* `Dask[delayed] \u003chttps://docs.dask.org/\u003e`_\n\nYou can compile the latest development version by cloning the git repository, and installing using\npip in development mode.\n\n.. code-block:: console\n\n    $ git clone https://github.com/XanaduAI/thewalrus.git\n    $ cd thewalrus \u0026\u0026 python -m pip install -e .\n\n\nSoftware tests\n==============\n\nTo ensure that The Walrus library is working correctly after installation, the test\nsuite can be run locally using pytest.\n\nAdditional packages are required to run the tests. These dependencies can be found in\n``requirements-dev.txt`` and can be installed using ``pip``:\n\n.. code-block:: console\n\n    $ pip install -r requirements-dev.txt\n\nTo run the tests, navigate to the source code folder and run the command\n\n.. code-block:: console\n\n    $ make test\n\n\nDocumentation\n=============\n\nThe Walrus documentation is available online on `Read the Docs \u003chttps://the-walrus.readthedocs.io\u003e`_.\n\nAdditional packages are required to build the documentation locally as specified in ``doc/requirements.txt``.\nThese packages can be installed using:\n\n.. code-block:: console\n\n    $ sudo apt install pandoc\n    $ pip install -r docs/requirements.txt\n\nTo build the HTML documentation, go to the top-level directory and run the command\n\n.. code-block:: console\n\n    $ make doc\n\nThe documentation can then be found in the ``docs/_build/html/`` directory.\n\nContributing to The Walrus\n==========================\n\nWe welcome contributions - simply fork The Walrus repository, and then make a pull request containing your contribution. All contributors to The Walrus will be listed as authors on the releases.\n\nWe also encourage bug reports, suggestions for new features and enhancements, and even links to projects, applications or scientific publications that use The Walrus.\n\nAuthors\n=======\n\nThe Walrus is the work of `many contributors \u003chttps://github.com/XanaduAI/thewalrus/blob/master/.github/ACKNOWLEDGMENTS.md\u003e`_.\n\nIf you are doing research using The Walrus, please cite `our paper \u003chttps://joss.theoj.org/papers/10.21105/joss.01705\u003e`_:\n\n Brajesh Gupt, Josh Izaac and Nicolas Quesada. The Walrus: a library for the calculation of hafnians, Hermite polynomials and Gaussian boson sampling. Journal of Open Source Software, 4(44), 1705 (2019)\n\n\nSupport\n=======\n\n- **Source Code:** https://github.com/XanaduAI/thewalrus\n- **Issue Tracker:** https://github.com/XanaduAI/thewalrus/issues\n\nIf you are having issues, please let us know by posting the issue on our Github issue tracker.\n\n\nLicense\n=======\n\nThe Walrus is **free** and **open source**, released under the Apache License, Version 2.0.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxanaduai%2Fthewalrus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxanaduai%2Fthewalrus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxanaduai%2Fthewalrus/lists"}