SoftwareApplication
identifier: 10.5281/zenodo.7671856
name: Discuit
description: Python package with the goal to split datasets (e.g. words defined by several variables) into subsets that are as comparable as possible.
description: ## About Discuit Discuit is a **D**ynamic **i**tem **s**et **c**lustering **UI** **t**ool (with the UI part yet to come) Discuit can split datasets (e.g. words defined by several variables) into subsets that are as comparable as possible. The package takes a csv file as input and generates a defined number of matched sets for a given number of continuous and categorical variables. One of the categorical variables can be selected to be split absolutely even across sets. Discuit generates the following output: - csv file ammended with the set membership for each item - txt file that reports on the outcomes of statistics tests In the future, this will be integrated in an GUI. The project setup is documented in [project_setup.md](project_setup.md). ## Installation Discuit is available on PyPI! ```bash pip install discuit ``` Or install the latest development version directly from GitHub: ```console git clone git@github.com:doerte/discuit-project.git cd discuit-project python3 -m pip install . ``` ## Using Discuit In the terminal, run Discuit with the following command: python3 run_discuit.py "name of input file" [number of desired sets] --columns l/c/n/a/d --runs [desired number of runs] Example: python3 discuit/run_discuit.py example/input.csv 2 --columns l a n c n d --runs 3 This will run Discuit with the [provided testfile](example/input.csv) and create 2 subsets. The columns in the file are identified as "label", "categorical", "numerical", "absolute", "numerical" and "disregard" (in that order). The program will run 3 times (and create 3 output files). ### Required input The input file needs to be a .csv file with a first line containing headings followed by rows that represent the different items. Each column specifies one variable. When launching the script, please specify per column what kind a data the script should expect: - (l)abel: just a label, will not be taken into consideration, could be the itemname or itemnumber. This can only be assigned once. - (n)um…
code repository: https://github.com/doerte/discuit-project
author: https://orcid.org/0000-0002-9437-6230
author: https://orcid.org/0000-0003-1250-6968
keywords: linguistics
keywords: python
keywords: Statistics
keywords: Data
programming language: Python
programming language: Shell
license:
  creative work: creativeWork
    name: Apache-2.0

https://orcid.org/0000-0002-9437-6230
type: Person
given name: Dörte
family name: De Kok
name: Dörte De Kok
affiliation: Organization
  name: University of Groningen

https://orcid.org/0000-0003-1250-6968
type: Person
given name: Sven
family name: van der Burg
name: Sven van der Burg
role name: Research Software Engineer
affiliation: Organization
  name: Netherlands eScience Center