Metadata-Version: 2.4
Name: UEQanalyzer
Version: 0.1.1
Summary: A Python package for analyzing and visualizing User Experience Questionnaire (UEQ) data.
Home-page: https://github.com/Pranj99/UEQAnalysis
Author: Pranjali Barve
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas
Requires-Dist: matplotlib
Requires-Dist: openpyxl
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# UEQanalyzer

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Version](https://img.shields.io/badge/python-3.6%2B-blue)](https://www.python.org/)

**UEQanalyzer** is a Python package for analyzing and visualizing data from the **User Experience Questionnaire (UEQ)**. The UEQ is a fast and reliable questionnaire designed to measure the user experience of interactive products. It covers a comprehensive impression of user experience, including both classical usability aspects (efficiency, perspicuity, dependability) and user experience aspects (originality, stimulation).

This package provides tools to:
- Load and preprocess UEQ data.
- Calculate mean scores for UEQ dimensions.
- Transform and rescale data.
- Generate visualizations (e.g., dimension scores, item means, scale means with benchmarks).
- Handle edge cases (e.g., missing data, invalid files).

---

## Installation

You can install **UEQanalyzer** using `pip`:

```bash
pip install UEQanalyzer==0.1.0
```
Alternatively, you can install it directly from the source:
```bash
git clone https://github.com/Pranj99/UEQAnalysis.git
cd UEQAnalysis
pip install .
```
## Usage
Basic Usage
Here’s an example of how to use UEQanalyzer to analyze and visualize UEQ data:
```bash
from UEQanalyzer.data_loader import load_ueq_data
from UEQanalyzer.analysis import calculate_mean_scores
from UEQanalyzer.visualization import plot_dimension_scores

# Load data
data = load_ueq_data("ueq_data.xlsx")

# Calculate mean scores
mean_scores = calculate_mean_scores(data)

# Plot dimension scores
plot_dimension_scores(mean_scores)
```
## Command-Line Interface (CLI)

You can also use the UEQanalyzer CLI to analyze and visualize UEQ data:

**Basic Usage**

To analyze UEQ data and display results in the terminal:
```bash
ueqanalyzer -i ueq_data.xlsx
```
**Save Results to a CSV File**

To save the analysis results to a CSV file:
```bash
ueqanalyzer -i ueq_data.xlsx -o results.csv
```
**Generate and Display Plots**

To generate and display plots for UEQ dimensions, item means, and scale means:
```bash
ueqanalyzer -i ueq_data.xlsx -p
```
**Save Results and Generate Plots**

To save the results to a CSV file and generate plots:
```bash
ueqanalyzer -i ueq_data.xlsx -o results.csv -p
```

- -i: Path to the input Excel file containing UEQ data.

- o: Path to save the analysis results (optional).

- p: Generate and display plots for UEQ dimensions.

## Examples
For more detailed examples, check out the examples/ directory in the repository. The examples demonstrate:

- Loading and preprocessing UEQ data.

- Calculating mean scores and item statistics.

- Generating visualizations.

- Handling edge cases (e.g., invalid files, missing data).
