船舶数据处理系统说明文档（KKC每周透视表系统）

1. 系统概述

船舶数据处理系统是一款专为船舶数据管理设计的桌面应用程序，基于Python和Tkinter开发。该系统能够高效处理船舶相关的Excel数据，实现数据的自动化处理、拆分和统计分析，大幅提高数据处理效率。

2. 功能特点

• 简洁直观的用户界面：采用现代化UI设计，操作简单明了
• 多线程处理：使用后台线程进行数据处理，保持界面响应性
• 进度可视化：实时显示处理进度和状态信息
• 数据验证：自动检查必要数据列是否存在
• 智能数据拆分：自动拆分提单号，提取尺寸数值
• 数据透视分析：自动生成数据透视表，便于分析统计
• 结果自动保存：处理结果自动保存为新Excel文件

3. 系统要求

• 操作系统：Windows/macOS/Linux
• Python 3.6+
• 依赖库：
  • tkinter
  • pandas
  • openpyxl（用于Excel文件处理）

4. 使用指南

4.1 启动程序

运行主程序文件，启动船舶数据处理系统。系统启动后将显示主界面，包含"导入Excel文件"和"退出程序"两个主要按钮。

4.2 数据处理流程

1. 点击"导入Excel文件"按钮
2. 在弹出的文件选择对话框中选择需要处理的Excel文件
3. 系统自动开始处理数据，进度条显示当前处理进度
4. 处理完成后，系统会显示成功提示，并告知结果文件的保存位置
5. 如遇错误，系统会显示错误提示信息

4.3 数据要求

输入的Excel文件必须包含以下列（从第3行开始读取数据）：

• 英文船名
• 航次
• 箱号
• 动态
• 动态时间
• 经营人
• 尺寸
• 箱型
• 提单号
• 抵离港日期

如果缺少任何必要列，系统将提示错误。

5. 数据处理说明

系统对数据的处理分为三个主要步骤，每个步骤的结果将保存在不同的工作表中：

5.1 原始数据（Sheet1）

系统将从输入文件中提取必要的列，保留原始数据格式，作为处理的第一步。这些数据将保存在输出Excel的"原始数据"工作表中。

5.2 拆分数据（Sheet2）

系统对原始数据进行进一步处理：

• 提单号拆分：将提单号拆分为"提"（前两位）和"单号"（剩余部分）
• 尺寸处理：从尺寸字段中提取数字部分，转换为整数值
• 数据清洗：移除不必要的小数点和空格

处理后的数据将保存在输出Excel的"拆分数据"工作表中。

5.3 数据透视表（Sheet3）

系统自动生成数据透视表，按以下字段进行分组统计：

• 提（提单号前两位）
• 动态
• 英文船名
• 航次
• 尺寸

统计结果将显示每个分组的计数，保存在输出Excel的"数据透视表"工作表中。

6. 输出文件

处理完成后，系统会在原文件的同一目录下生成一个新的Excel文件，文件名为原文件名加上"_处理结果"后缀。例如，如果输入文件名为"船舶数据.xlsx"，则输出文件名为"船舶数据_处理结果.xlsx"。

输出文件包含三个工作表：

1. 原始数据：包含从输入文件提取的原始数据
2. 拆分数据：包含经过处理和拆分的数据
3. 数据透视表：包含按指定字段分组的统计结果

7. 错误处理

系统会处理以下常见错误：

• 文件选择取消：如果用户取消文件选择，系统会恢复到就绪状态
• 缺少必要列：如果输入文件缺少必要的数据列，系统会显示错误信息
• 数据格式错误：系统会尝试处理不规范的数据格式，如果无法处理则会显示错误信息
• 其他异常：系统会捕获处理过程中的所有异常，并显示友好的错误提示

8. 注意事项

• 处理大型Excel文件可能需要较长时间，请耐心等待
• 建议在处理前备份原始数据文件
• 如果遇到无法处理的数据格式，请检查原始数据是否符合要求

9. 技术支持

如有任何问题或建议，请联系技术支持团队。