https://github.com/willlillis/cycle-games-on-graphs

Code written to aid in the combinatorial research of relator games on groups.
https://github.com/willlillis/cycle-games-on-graphs

c-plus-plus combinatorial games mathematics

Last synced: 24 days ago
JSON representation

Code written to aid in the combinatorial research of relator games on groups.

• Host: GitHub
• URL: https://github.com/willlillis/cycle-games-on-graphs
• Owner: WillLillis
• Created: 2022-08-05T01:18:24.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-07-10T16:23:56.000Z (4 months ago)
• Last Synced: 2024-07-10T19:54:27.222Z (4 months ago)
• Topics: c-plus-plus, combinatorial, games, mathematics
• Language: C++
• Homepage:
• Size: 1.26 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Cycle Games on Graphs

Computer code for playing the combinatorial games Make-A-Cycle (MAC) and Avoid-A-Cycle (AAC). These games were first defined for Cayley graphs in the paper Relator Games on Groups. A second paper discussing the games MAC and AAC is forthcoming (put pre-print link here when ready).

## Compiling/ Building

Download the folder Cycle Games on Graphs. The project can be built by compiling ``Source.cpp`` using at least ``C++20``.  

The project can be built with the provided Makefile, or simply with ```g++ --std=c++20 Source.cpp```. Optimizations have been added to the ``Makefile`` for performance reasons.


## Notes

Due to the difference in newline characters between Windows, Mac, and Linux, the provided adjacency files may not work on your machine. This will become evident when you attempt to use a file to simulate a game and received an error while parsing it. Newly generated adjacency information files no longer use '\n' as a delimiter. Furthermore, automatic "repair" functionality has been added where a "dos2unix"-like action is made to a copy of the file in question. If the issue persists, try re-generating from scratch.

This project originally just required ``C++17`` (due to its usage of std::filesystem) but now requires ``C++20`` due to its usage of the ``__VA_OPT__`` functional macro. I believe this means g++ version 10.0 or newer is now needed to compile the project. While I don't anticipate this being an issue, if it proves to be I can make some compatability changes in the code that will allow it to be built (albeit with less informative error reporting at runtime). 

  

An attempt was made to multithread the code, and this can still be seen in ``Cycle_Games_Threaded.h``. Unfortunately, the memory overhead of providing a private copy of the ``node_use_list`` and ``edge_use_matrix`` vectors to each job in the queue causes the program to crash even while working on moderately sized graphs.

### Adding a New Graph Family

If one wishes to add a new graph family to the list of generate-able families, the following steps can be followed: 

- Write a ``user_x_gen()`` function, and declare it at the top of ``Menu.h`` along with the others. This function should prompt the user for the relevant graph parameters, and do some common sense input checking/cleaning. The other ``user_x_gen()`` functions should be good examples for this.

- Write an ``x_gen()`` function that takes in the parameters from the first function and writes the adjacency information to a file. The other ``x_gen()`` functions should be also good examples for this.

- Add an entry for the graph family in the ``gen_menu_options`` array. The entry should hold a display name for the family, an internal name, and a pointer to the afforementioned ``user_x_gen()`` function.

- Add a preprocessor ``#define`` to represent the index into said array, of the form ``GEN_MENU_x_ENTRY``.