Skip to content

cartocrow/simplesets

Repository files navigation

CartoCrow: SimpleSets

arXiv

This repository contains an implementation of SimpleSets. Given a set of points in the plane that each belong to one category, SimpleSets creates simple shapes that enclose patterns in the data. The visualization is described in more detail in the corresponding paper:

Steven van den Broek, Wouter Meulemans, Bettina Speckmann. SimpleSets: Capturing Categorical Point Patterns with Simple Shapes. IEEE Transactions on Visualization and Computer Graphics, 2025. 10.1109/TVCG.2024.3456168

Dependencies

This module depends on the following libraries:

CartoCrow/core can be cloned and built using CMake as described in https://github.com/cartocrow/core.

Compiling

Emscripten

To compile SimpleSets to WebAsssembly with Emscripten, do the following.

  1. Compile cartocrow/core with Emscripten.
  2. Run the following commands; the placeholder paths refer to those in the cartocrow/core Emscripten installation instructions.
emcmake cmake -S . -B wasm_build -DCMAKE_BUILD_TYPE=Release -DCartoCrow_DIR=<path/to/compiled_webassembly/lib/cmake/CartoCrow> -DEMSCRIPTEN_INCLUDE_DIR=<path/to/cartocrow_wasm_files>
cmake --build wasm_build

This creates a wasm_build/wasm_frontend/simplesets_wasm.js file that exposes a JavaScript API.

Usage

The program receives as input points in the plane that each have exactly one category. A data format we use a .txt file that contains a point on each line in the format c x y where c is a non-negative integer representing the category of the point, and x and y are the coordinates of the point.

The data folder contains example data. There is both a graphical and a command-line interface (GUI and CLI). To load data in the GUI, press the corresponding button. For the CLI, pass a JSON file that specifies the input file and all options (see the examples in the data folder).

License

Copyright (c) 2026 TU Eindhoven Licensed under the GPLv3.0 license. See LICENSE for details.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published