Text Classifier

Inspired by Perspective API and its real-time comment moderation tools, this Nifty Assignment is about improving online conversations by implementing a decision tree data type for text classification.1

Online abuse and harassment stops people from engaging in conversation. One area of focus is the study of negative online behaviors, such as toxic comments: user-written comments that are rude, disrespectful or otherwise likely to make someone leave a discussion. Platforms struggle to effectively facilitate conversations, leading many communities to limit or completely shut down user comments. In 2018, the Conversation AI team, a research initiative founded by Jigsaw and Google (both part of Alphabet), organized a public competition called the Toxic Comment Classification Challenge to build better machine learning systems for detecting different types of of toxicity like threats, obscenity, insults, and identity-based hate.2

Toxic comment classification is a special case of a more general problem in machine learning known as text classification. Discussion forums use text classification to determine whether comments should be flagged as inappropriate. Email software uses text classification to determine whether incoming mail is sent to the inbox or filtered into the spam folder.3

Spam email classifier

Improve online conversations by implementing a decision tree data type for text classification.
Data structures, binary trees, binary search trees, recursion, mutation.
A second programming course (CS2), a data structures course, or a machine learning course.
While the assignment is motivated by a hard problem in natural language processing (NLP, a subfield of machine learning), it focuses on programming 4 fundamental binary search tree operations that can be solved by applying programming problem solving templates taught in class. We provide CS2 students all of the NLP and machine learning concepts as abstractions.
Text classification explores a social implication of computing since students learn how programming can address (but not fully solve) real-world problems that have been at the center of popular attention. The assignment touches on the limits of computing by pointing out how algorithms are ultimately dependent on the given data.
Students can run the bundled web app and test their decision tree classifier on any text in realtime. Web apps are uniquely authentic and engaging since students can see their code served beyond their computer screen and accessible to anyone online. Students can also host their web app for free online.
The provided abstractions allow instructors to customize learning objectives. We focus on data structures and algorithms, but other courses can flip the abstractions: instructors can provide the decision tree as an abstraction so that students can focus on implementing the machine learning components.
The provided abstractions allow students to focus on programming the decision tree data structure by hiding all of the machine learning implementation. While students can interact with the dataset, students likely won’t feel that they understand everything about the assignment compared to something they write entirely on their own.
There are no particular course content knowledge dependencies beyond their typical treatment in a programming-focused CS2 course. Some of the machine learning abstractions depend on Smile (Statistical Machine Intelligence and Learning Engine), a Java library for machine learning similar to scikit-learn for Python. 5MB of jar files need to be distributed alongside the source code.
Rather than focus on data structures and algorithms, the assignment could instead focus on datasets and data representation. Instructors can also organize Kaggle competitions to give students exposure to the community and teamwork aspects involved in developing better machine learning algorithms.
Rather than focus on programming, the assignment could instead focus on computer ethics by investigating unintended bias in toxicity classification and holistic approaches to addressing online harm such as restorative justice.

Getting started

The simplest way to use the text classifier is through the web app. The first visit may take 30–60 seconds for the server to wake up and train the model.

The assignment specification (spec.mhtml) contains all of the information that students need to get started. To run the project locally, download the code from GitHub and implement (or stub) each required method in the TextClassifier class.

Compile and run the Main class to compute the classifier’s training accuracy.

javac -cp ".:lib/*" Main.java && java -cp ".:lib/*" Main

Compile and run the Server class to launch the Nifty Web App.

javac -cp ".:lib/*" Server.java && java -cp ".:lib/*" Server toxic.tsv

A JUnit 5 TextClassifierTest class is provided, though it requires a GoodTextClassifier reference solution with a modified print method that returns the expected string result.

  1. Machine learning models are trained on human-selected and human-generated datasets. Such models encode and reproduce the implicit bias inherent in the datasets. This model is not meant to generalize beyond the toy training datasets. Don’t use this in a real system!

    The included vectorization algorithms also encode explicit bias. The vectorization ignores all grammar and syntax, treating each occurrence of a word as independent from all other words in the text. Any usage of a word, no matter the context, is considered equally toxic or spammy.

    The provided datasets contain text that may be considered profane, vulgar, or offensive. 

  2. When the Conversation AI team first built toxicity models, they found that the models incorrectly learned to associate the names of frequently attacked identities with toxicity. In 2019, the Conversation AI team ran another competition about Unintended Bias in Toxicity Classification, focusing on building models that detect toxicity across a range of diverse conversations. 

  3. Google Developers. Oct 1, 2018. Text classification. In Machine Learning Guides. https://developers.google.com/machine-learning/guides/text-classification