# 质量分析

**Repository Path**: love-snow/quality-analysis

## Basic Information

- **Project Name**: 质量分析
- **Description**: 用来分析小学期中期末成绩的质量分析工具
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-08-13
- **Last Updated**: 2025-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# **小学考试成绩质量分析工具**

## **📝 下载QualityAnalysisTool.exe 双击即可快速使用！**

本软件无毒无害，如果出现杀毒软件误报，安全提示，请选择“继续运行”/“跳过”  

![下载程序](%E4%B8%8B%E8%BD%BD.png)

## **📝 项目简介**

这是一款专为教师设计的、简单易用的考试成绩质量分析工具。它拥有简洁的图形用户界面（GUI），无需进行复杂的命令行操作。

教师只需提供格式标准的学生成绩单（CSV格式），并根据需要设定分析规则，即可快速对试卷的不同维度（如：计算、概念、应用等）进行统计分析，并生成一目了然的等级人数统计摘要，极大地提升了考后分析的效率。


## **🚀 快速开始**


![输入图片说明](%E8%BE%93%E5%85%A5%E6%96%87%E4%BB%B6%E6%A0%BC%E5%BC%8F.png)

![输入图片说明](%E4%BF%9D%E5%AD%98%E6%96%B9%E5%BC%8F.png)

![输入图片说明](%E7%A8%8B%E5%BA%8F%E8%AF%B4%E6%98%8E.png)

#### **1\. 准备成绩单文件**
* **格式要求**：请务必将您的成绩单文件在Excel等软件中\*\*“另存为”CSV UTF-8（逗号分隔）格式\*\*。  
* **标题行**：网站默认输出表格文件的标题行位于第二行，可以不动。  
* **题号行**：文件中必须包含一行完整的\*\*题号\*\*，例如 1, 2, 3, 4...  
* **姓名列**：文件中必须包含学生姓名列，且该列的列标题必须为 **“姓名”**。  
* **数据清洗**：请确保CSV文件的末尾没有无关的统计行（如总分、平均分等）。

**输入文件格式示例 (.csv):**

班级,姓名,1,2,3,4,5,6,7,8  
三年一班,陈曦,9,8,10,5,10,9,4,8  
三年一班,李伟,10,7,9,4,8,8,5,7  
三年一班,王芳,8,6,8,3,7,6,3,6  
三年一班,刘洋,9,8,9,5,9,7,4,8

#### **2\. 运行分析工具**

1. **（推荐）直接运行**：找到 QualityAnalysisTool.exe 文件，直接双击运行即可。  
2. **（备选）使用Python运行**：如果您的电脑已安装Python环境，也可以直接运行 quality\_report\_interact\_gui.py 文件来启动程序。

#### **3\. 在界面中进行配置**

### 注意所有输入内容都以英文输入法输入！
1. **选择成绩文件**：点击 **选择文件...** 按钮，找到并选择您准备好的成绩单 .csv 文件。  
2. **设置题号所在行号**：根据您的CSV文件，输入题号所在的是第几行。例如，如果题号在文件的第2行，则输入 2。  
3. **配置分析维度**：  
   * 程序预设了“计算部分”、“概念部分”、“应用部分”三个维度。  
   * 在每个维度后，填入对应的\*\*“题号区间”\*\*和\*\*“阈值”\*\*。  
   * **题号区间示例**：若计算题是第1到第5题，则输入 1-5。  
   * **阈值示例**：若某部分满分40，规定大于等于38分是“优”，大于等于34分是“良”，大于等于26分是“合格”，则输入 38,34,26 （请使用英文逗号分隔）。

#### **4\. 执行分析**

* 所有信息填写完毕后，点击界面下方蓝色的 **运行分析** 大按钮。  
* 程序开始处理数据，处理过程和信息会显示在下方的“状态和日志”窗口中。

#### **5\. 查看结果**

* 分析成功后，会弹出“完成”的提示框。  
* 在您的原始成绩单文件所在的文件夹内，会生成一个名为 \[您的原始文件名\]\_summary.csv 的新文件。

**输出摘要文件示例 (...\_summary.csv):**

部分,优,良,合格,需努力  
计算部分,15,20,5,2  
概念部分,10,18,12,2  
应用部分,8,15,15,4

## **⚙️ 运行环境**

* Windows 操作系统（对于 .exe 文件）  
* Python 3.x （如果选择运行 .py 文件）  

## **⚠️ 注意事项**

* 请严格遵守输入文件的格式要求，特别是学生姓名列的列标题必须是“姓名”。  
* 在设置阈值时，请确保“优、良、合格”的最低分是按从高到低的顺序填写的。  
* 如果程序运行出错，请首先检查“状态和日志”窗口中的错误提示信息，根据提示检查您的输入文件或配置。