blaine-t / randomPartners

Generate random partners for every day without repeats

Home Page:https://rp.traudt.dev/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Contributors Forks Stargazers Issues MIT License


Logo

Random Partners

Algorithmically optimized lab partner generation
Live Version

About The Project

This project provides a solution to the problem of generating random lab partner assignments that are different for each iteration. Instead of randomly generating an assignment for each day (which would inevitably cause repeated partnerships), we implement an algorithm that creates the maximum possible number of partnerships without repeats.

(back to top)

Built With

  • HTML
  • CSS
  • JS

(back to top)

Usage

Usage Screenshot

Simply type (or paste) all students' full names into the left box, one name per line. After clicking the "Generate" button, an output is generated in the middle box, showing each student and who their partner is. You can also switch between lab days, where the algorithm guarantees that each student will have a different partner on every lab day. Necessarily, for n students, Random Partners generates n-1 days of partnerships. To export output, simply click the buttons to copy an individual day, or copy output for all days, or download output for all days to a .txt file.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the GPL-3.0 License. See LICENSE for more information.

(back to top)

Contact

Blaine Traudt - blaine-t - blaine-t@bathost.net

Anton Angeletti - anton-3 - angelettianton@gmail.com

Project Link: https://github.com/blaine-t/randomPartners

(back to top)

About

Generate random partners for every day without repeats

https://rp.traudt.dev/

License:GNU General Public License v3.0


Languages

Language:HTML 100.0%