TimeTable-Gen

TimeTable-Gen uses Genetic Algorithms to generate timetables for different classes given courses, lecturers, rooms... The resulting timetable is the fittest one through many generations that satistfy fixed rules (other rules for the 'best' timetable will be added)

Running using docker

docker run ahbenmed/timetable_gen

Running manually

Prerequisites

python3 should be installed.
Installing needed python modules:

pip install -r requirements.txt

Run

To test things, run:

python main.py

Contributing

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

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

Or just share an idea in the Github's project section. I am using it to organize my ideas and to keep track of TODOs, issues...

References

Samuel Lukas, Arnold Aribowo and Milyandreana Muchri (2012). Solving Timetable Problem by GeneticAlgorithm and Heuristic Search Case Study: Universitas Pelita Harapan Timetable, Real-World Applications ofGenetic Algorithms, Dr. Olympia Roeva (Ed.), ISBN: 978-953-51-0146-8, InTech, Available from: this link
Genetic Algorithms explaination by Rayen MHAMDI