User Manual for an interactive application for clustering data. Project "Music and mental health"

Interface oveview

First of all, the app consists of two main tabs:

1. Tab 1 - Data input and clustering

2. Tab 2 - Data output and cluster visualization

TAB #1 interface: Data input and clustering

This tab allows you to input your data, manage it and perform clustering operations.

Features：

1. Data table:

The majority of the space is occupied by the input data that displays the dataset

2.Data management buttons：

On the right there are several buttons that allow the user to modify the data and to clusterize it:

Modifying data:

1. Add Row: Adds a new row to the data table.
2. Remove Row: Removes selected row from the data table.
3. Edit Cell: Allows editing of a specific cell in the data table.
4. Clear Data: Clears all the data in the data table.

Clustering options:

You can select the clustering method by choosing:

1. Sort by Hierarchy
2. Sort by Medoids
3. Sort by Means

You can also edit the clustering parametrs:

1. Number of Clusters: Input the desired number of clusters.
2. Number of Iterations: Input the number of iterations for the clustering algorithm.

Clusterize Button: Executes the clustering process based on selected parameters.

TAB #2 interface: Data output and cluster visualization

Shows the result of clustering

Features：

1. Clustered data table：

The majority of the space is occupied by the output data presented in a form of a colored scatter plot and a table with the following columns:

1. X Coordinate: X-axis value of the data point.
2. Y Coordinate: Y-axis value of the data point.
3. Cluster: Cluster number the data point belongs to.

The scatter plot provides the user with such information as:

1. Visual representation of the clusters.
2. Color-coded by cluster data points.

2. Buttons：

On the left there are several buttons that allow the user to work with the output data:

Modifying data：

1. Save Image: Extracts the scatter plot as an image (allows the user to choose the destination of the saved file).
2. Save Results: Saves the clustered data results as txt file (allows the user to choose the destination of the saved file).
3. Compare Methods: Allows user to compare different clustering methods (user should choose three output files saved by "Save Results" button).

How to use the app

1. Input data：

When the application starts, the tab 1 is opened:

1. Make sure tab 1 is opened.
2. Use the data table to change your dataset. You can add, remove, or edit rows via buttons.

2. Select clustering parameters：

1. Choose a clustering method from the available options (clusterize by hierarchy, means, medoids).
2. Enter the number of clusters you want to create.
3. Enter the number of iterations for the clustering algorithm
4. Click the "Clusterize" button to perform the clustering.

3. View and Save Results：

1. Navigate to tab 2 to view and save the results.
2. Use the "Save Image" and "Save Results" buttons to save the output data (after clicked, choose the path to save the file).
3. Use the "Compare Methods" button to compare different clustering methods (after clicked, choose three files saved by button "Save Results").

Summary

Using the following instuctions, user should be able to effectively use the Music & Mental Health interactive application to analyze and visualize the data.