An open API service indexing awesome lists of open source software.

https://github.com/sowinskibraeden/schedule-generator

The standalone Algorithm, schedule generation from my school-management-api project
https://github.com/sowinskibraeden/schedule-generator

Last synced: 6 months ago
JSON representation

The standalone Algorithm, schedule generation from my school-management-api project

Awesome Lists containing this project

README

        

# Schedule Generator

Hello there! This is the standalone repository for the schedule generator from my [school-management-api](https://github.com/SowinskiBraeden/school-management-api) project.

The algorithm reads student requests and generates a timetable for all requested classes and fills them with students, giving the students their own schedules.

The algorithm has been moved out of `tinker.py` into its own python script. Version 1 and 2 are removed and the script can be found in the `/scheduleGenerator` folder. The algorithm has come a long way; using real 2018 course selection data from my school, enabling me to better test the script. V3 has a entirely different approach from V1 and V2, that you can read about at the top of the function in [`generator.py`](/scheduleGenerator/generator.py). The function is broken up into 6 steps, each step is labeled within the function with a comment, giving a brief explination of what that step contributes to the algorithm.

Here is the list of commands.

Note: to show a basic error table, include `show_error` in your command args.
Note: to stop any animations for loading, us `noanim` at the end of your command args.

1. Collect latest data from files and generate timetable
```
$ ./tinker.py
```

2. Collect Data and store it in files for later
```
$ ./tinker.py generate_data
```

3. Generate timetable from existing files (faster), requires last command run once
```
$ ./tinker.py no_refresh
```

4. More details on errors
```
$ ./tinker.py errors
```


This is the output after running it with the following command.
```
$ ./tinker.py no_refresh
```

![preview](/preview/generator-preview.png)


A more in depth error log can be read with the additional argument
```
$ ./tinker.py errors
```

![preview](/preview/error-preview.png)