https://github.com/frizensami/archangel

An angel-mortal matching algorithm for Angel-Mortal games. Used in Tembusu College, NUS.
https://github.com/frizensami/archangel

Last synced: 27 days ago
JSON representation

An angel-mortal matching algorithm for Angel-Mortal games. Used in Tembusu College, NUS.

• Host: GitHub
• URL: https://github.com/frizensami/archangel
• Owner: frizensami
• License: mit
• Created: 2016-08-21T09:36:07.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2022-06-21T21:07:09.000Z (over 2 years ago)
• Last Synced: 2023-10-20T19:54:36.049Z (about 1 year ago)
• Language: Python
• Homepage:
• Size: 25.4 KB
• Stars: 2
• Watchers: 2
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# tAngel: Matching algorithm

## Author: Sriram Sami

### Overview

This year's algorithm uses a Hamiltonian-cycle based approach to finding valid angel-mortal chains. Critically, `networkx` was used for graph algorithms.

### Usage

1. Clone the repo

2. Create a virtual environment so that the required libraries don't pollute your namespace (Optional). Run `virtualenv venv` in the cloned directory.

3. Install requirements with `pip install -r requirements.txt`

4. Put a header-less tsv file (no column names, the first row is the first row of data already) with all details of participants in correct order in a file called `playerlist.tsv` in the main folder.

5. Run `python angel.py`

### Columns required for playerlist.tsv

The columns in playerlist.tsv should be arranged as such, with 1 being the leftmost column. Important columns for matching: 2, 4, 7, 9, 10.

1. Timestamp

2. Full Name

3. Facebook Name (if different)

4. Floor Number

5. Room Number

6. Contact Number

7. Gender

8. Year of Study

9. What's your gender preference for your Angel and Mortal?

10. Faculty 

11. Interests

12. Is there anything that you'd like us to know?