Skip to main content

A sandbox billiards game that emphasizes realistic physics.

Project description

Project Status: Active – The project has reached a stable, usable state and is being actively developed. GitHub license Documentation Status GitHub Actions Workflow Status

PyPI - Version PyPI - Python Version codecov

Discord

Description

Pooltool is a general purpose billiards simulator crafted specifically for science and engineering.

Its core design principles focus on speed, flexibility, and the ease of visualization and analysis. With an interactive 3D interface, a robust API, and extensive documentation, pooltool aims to be a systemic tool in billiards-related research. Continuously evolving through active maintenance and bolstered by a growing community, this vision for pooltool emphasizes not just its current capabilities, but also its potential for growth and adaptation within billiards simulation.

Pooltool is peer-reviewed and published in the Journal of Open Source Software (JOSS) and pyOpenSci.

DOI pyOpenSci Peer-Reviewed

Gallery

Installation & Documentation

rtd

All resources are hosted at https://pooltool.readthedocs.io.

Quick links:

  1. 🛠️ Installation
  2. 📚 Examples
  3. 🔌 API Reference

Join the community

Discord

If you want to ask questions, get help, or contribute to the codebase, please join the Discord and introduce yourself.

If the Discord link is expired, please make an issue in this repo.

Contributing

See CONTRIBUTING.md.

Blog

I have blogged about many aspects of this project. Read the detailed account here.

Citation

If you use pooltool in your research/project/product, please cite the JOSS publication:

DOI

@article{Kiefl2024,
    doi = {10.21105/joss.07301},
    url = {https://doi.org/10.21105/joss.07301},
    year = {2024},
    publisher = {The Open Journal},
    volume = {9},
    number = {101},
    pages = {7301},
    author = {Evan Kiefl},
    title = {Pooltool: A Python package for realistic billiards simulation},
    journal = {Journal of Open Source Software}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pooltool_billiards-0.4.2.tar.gz (29.1 MB view details)

Uploaded Source

Built Distribution

pooltool_billiards-0.4.2-py3-none-any.whl (29.2 MB view details)

Uploaded Python 3

File details

Details for the file pooltool_billiards-0.4.2.tar.gz.

File metadata

  • Download URL: pooltool_billiards-0.4.2.tar.gz
  • Upload date:
  • Size: 29.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.12.4 Darwin/22.4.0

File hashes

Hashes for pooltool_billiards-0.4.2.tar.gz
Algorithm Hash digest
SHA256 d85dfc9c79e4332cfeab2fb045474424e1a9054971078f52d96255a5d1ec5540
MD5 677284e5a93362e51245f9e46f69f1e2
BLAKE2b-256 ff3d0d6b35dfee0cc54fe6d267c307ae9a4266313a2fd61281ee9ee0ad6d80f3

See more details on using hashes here.

File details

Details for the file pooltool_billiards-0.4.2-py3-none-any.whl.

File metadata

File hashes

Hashes for pooltool_billiards-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 be8ba04724ab2e9b9c9e914efb8fe7ff3773bbd871267330af176f62dfb60f0b
MD5 d325b003efb118c45943441a555b14d3
BLAKE2b-256 e059697f0c96a49ea2adffeef3076b7ed465ff5a8526383f1216f5a8c470b41e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page