CENTROIDS

Code and data for the paper "Enhancing Dimension-Reduced Scatter Plots with Class and Feature Centroids."

Zenodo DOI	Test Status	Coverage

Table of Contents

• CENTROIDS
  • Table of Contents
  • Summary
  • Usage
    • Setup
    • Execution

Summary

This project implements the code and data necessary to generate the figures and results of the paper "Enhancing Dimension-Reduced Scatter Plots with Class and Feature Centroids." This repository contains multiple python scripts for generating the various results of the paper with multiple data -> script -> output workflows.

The project is laid out as follows:

• src/: the Python files implementing each experiment.
• data/: the data files necessary to run the experiment.
• example_output/: example files demonstrating the output of the experiment.

Usage

Brief installation instructions can be found in Setup, and use of the scripts can be found in Execution.

Setup

Create and activate a virtual Python environment with your favorite tool (e.g., conda, mamba, or venv).

For example, with conda:

conda create -n centroids python=3.11
conda activate centroids

Next, install dependencies while inside this virtual environment via the requirements.txt file at the top of this repo:

pip install -r requirements.txt

Execution

Each experiment lives in Python files under the src/ directory. To execute each experiment, simply run the file through the Python interpreter while in your virtual environment as follows:

python src/<experiment>.py

where <experiment> is the name of the file that you wish to run.

Examples of the output files that are generated during these experiments can be seen in the example_output/ directory.