groupify 0.1.14

Automatically generates random groups from a class list.

groupify

groupify is a Python package for automatically creating random groups in the classroom from a classlist.

NOTE: there is currently no way to ensure that Newton and Leibniz are not in the same group. They must cooperate if necessary.

Installation

To install on Unix/Linux:

pip install groupify

To install in an IDE simply search for the package groupify and install it.

Basic examples

Example 1

import groupify

classlist = "sample_class.txt"

groupify.create(
    classlist=classlist,
    group_size=4,
)

groupify.savefig(dirname="../figures/", fname="example_1.svg")

groupify.show()

This will generate the following groups (randomly):

Example 2

If some students are absent, you can specify them in the absent parameter to exclude them from the list of students before creating the groups.

import groupify

classlist = "sample_class.txt"

absent = [
    "Einstein",  # Busy dreaming about light
    "Feynman",  # Busy pick-locking government secrets
    "Hilbert",  # Busy trying to one-up Einstein on GR
    "Schrödinger",  # Uncertain if he's here or not – we'll exlude him to be sure
]

groupify.create(
    classlist=classlist,
    group_size=4,
    absent=absent,  # Removes them from the list before creating the groups
)

groupify.savefig(dirname="../figures/", fname="example_2.svg")

groupify.show()

This will generate the following groups (randomly):

Example 3

import groupify

classlist = "sample_class.txt"

groupify.create(
    classlist=classlist,
    group_size=3,
)

groupify.savefig(dirname="../figures/", fname="example_3.svg")

groupify.show()

This will generate the following groups (randomly):

Example 4

import groupify

classlist = "sample_class.txt"

groupify.create(
    classlist=classlist,
    group_size=2,
)

groupify.savefig(dirname="../figures/", fname="example_4.svg")

groupify.show()

This will generate the following groups (randomly):