Skip to main content

A simple game to learn about hamiltonian cycles, by doing

Project description

WALK THE LOOP

A simple 'learning by doing' game illustrating the concept of hamiltonian cycles by having the player find a hamiltonian cycle (a cycle that visits each node exactly once) in 6 graphs (gameboards), each consecutively more difficult than the last, with 5 derived from the skeleton of the 5 platonic solids and a sixth discocube graph derived from skeleton of a polycube of an octahedron (like using sugarcubes to form a diamond).

Description

6 puzzles, each having more edges and nodes (game pieces) in its graph (gameboard) than the previous (from 4 nodes to 32 nodes) results in each proceeding graph being slightly more difficult than the last, demonstrating the idea of complexity, of the growth in complexity in solving a puzzle with let's say a thousand more nodes. Once a puzzle is solved, the game will proceeds to the next puzzle. Clicking on one of the 6 icons below the gameboard will set that graph as the current game. The gameboard consists of a visual representation of a graph, which is a collection of nodes and edges, where node represent objects and edges the connection / relationship between them. In this game the nodes are the steps and the edges are the lines connecting these steps. The goal is to step (click) from node to node (if they are connected by an edge) until all nodes have been clicked and the last node is next to the start.

GAMEPLAY

Starting: Click on any node to begin. This is the origin. You will have to end up here to finish the game.

Stepping Forward: Click on any node adjacent to the current step to take a step. You can run by clicking on an unvisited node (grayed circle) not adjacent to the current step.

Stepping Backward: Clicking on any visited node (colored node) will cause that to be the current step (purple circle with a ring), thereby erasing the previous moves.

Switching heads: Clicking on the other end (the origin), will switch the origin to be the head (current step) and the head as the origin.

Choose another graph (non-sequential): The 6 puzzle icons below can be used to pick a particular graph.

Reset game: The (r) key will reset the game

Quit: The (esc) key will quit the game.

Getting Started

Just click. To pick a starting point.

Dependencies

  • Hopefully none other than pygame.
  • for mac and windows better is a web app.

Installing

  • How/where to download your program
  • Any modifications needed to be made to files/folders

Executing program

  • How to run the program
  • Step-by-step bullets
code blocks for commands

Help

Any advice for common problems or issues.

command to run if program contains helper info

Authors

Rommelo Yu

Version History

  • 0.1
    • Initial Release

License

This project is licensed under the [GNU AFFERO GENERAL PUBLIC LICENSE] License - see the LICENSE.md file for details

Acknowledgments

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

walk_the_loop-0.0.2.tar.gz (25.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

walk_the_loop-0.0.2-py3-none-any.whl (2.7 MB view details)

Uploaded Python 3

File details

Details for the file walk_the_loop-0.0.2.tar.gz.

File metadata

  • Download URL: walk_the_loop-0.0.2.tar.gz
  • Upload date:
  • Size: 25.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for walk_the_loop-0.0.2.tar.gz
Algorithm Hash digest
SHA256 fa1b5ada3b5fa42e6c0b38219264b2ee3fa35eee768c8feddb5975f39e9c51e3
MD5 994d5f2f3c7bf1341cffff7af2f380e0
BLAKE2b-256 e3093166d286763e8b7756d205a7d7baf7c6205d99a25e02e22b6e998358c13c

See more details on using hashes here.

File details

Details for the file walk_the_loop-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: walk_the_loop-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 2.7 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for walk_the_loop-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 87fd3b75169fef962d98b3586953114716a4b346dfef920f39184520ffe77b95
MD5 3a82507bb8f267ebaf6d297359e69dbc
BLAKE2b-256 722dac375f4281c3b7cca9235305e12fbeae600a0d61c09b052100904e15f0c5

See more details on using hashes here.

Supported by

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