# 大物实验数据处理平台

**Repository Path**: felix_lee0512/Physics-experiments

## Basic Information

- **Project Name**: 大物实验数据处理平台
- **Description**: 辅助计算大物实验数据
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 19
- **Created**: 2025-01-24
- **Last Updated**: 2025-01-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 物理实验数据处理平台

这是一个基于 Vue 3 + TypeScript 开发的物理实验数据处理平台，旨在为Heuer的物理实验数据处理提供便利，同时为计算机相关专业以及热爱编程的同伴提供一个简单的前端Vue开源项目实践。目前已实现分光计实验的数据处理功能，其他实验的数据处理模块正在开发中。

![image-20250122154746498](./demo/demo.png)

## 功能特点

- 🎯 专注于物理实验数据处理
- 📊 实时数据计算和验证
- 🎨 美观的用户界面，支持暗色模式
- 📱 响应式设计，支持多种设备
- 🛠 模块化设计，易于扩展
- 📈 集成 ECharts 数据可视化
- 🎛️ 使用 Element Plus UI 组件库

## 技术栈

- Vue 3
- TypeScript
- Element Plus
- Vite
- ECharts

## 快速开始

### 环境要求

- Node.js >= 18.0.0
- npm >= 9.0.0

### 安装

```bash
# 克隆项目
git clone https://gitee.com/heuwings/Physics-experiments.git

# 进入项目目录
cd Physics-experiments

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

## 项目结构

```
physics-lab-platform/
├── src/
│   ├── assets/          # 静态资源
│   │   ├── base.css    # 基础样式
│   │   └── main.css    # 主样式文件
│   ├── components/     # 实验组件
│   │   ├── SpectrometerExperiment.vue  # 分光计实验
│   │   ├── BridgeExperiment.vue        # 电桥实验
│   │   └── ...
│   ├── templates/      # 通用模板组件
│   │   ├── Card.vue
│   │   ├── DataTable.vue
│   │   ├── InputField.vue
│   │   └── StatisticsCard.vue
│   ├── App.vue        # 主应用组件
│   └── main.ts        # 应用入口
├── public/            # 公共资源
├── index.html         # HTML 模板
├── package.json       # 项目配置
├── tsconfig.json      # TypeScript 配置
├── vite.config.ts     # Vite 配置
└── postcss.config.js  # PostCSS 配置
```

## 贡献指南

我们欢迎所有形式的贡献，特别是新的物理实验数据处理模块。以下是贡献指南：

### 开发规范

1. **Git 提交规范**

   - 使用语义化的提交消息
   - 格式：`<type>(<scope>): <description>`
   - 类型包括：
     - feat: 新功能
     - fix: 修复
     - docs: 文档更新
     - style: 代码格式（不影响代码运行的变动）
     - refactor: 重构
     - test: 测试
     - chore: 构建过程或辅助工具的变动

2. **代码风格**

   - 使用 TypeScript 编写代码
   - 遵循 ESLint 配置的代码规范
   - 使用 Prettier 进行代码格式化

3. **组件开发规范**
   - 每个实验组件应放在 `src/components` 目录下
   - 组件命名格式：`[ExperimentName]Experiment.vue`
   - 组件应包含完整的类型定义
   - 必须包含实验说明注释
   - 实现响应式设计
   - 可选使用Tailwindcss自定义组件样式，也可使用ElementPlus组件库

### 添加新的实验组件

1. 在 `src/components` 目录下创建新的实验组件，实现以下基本功能

   - 数据输入和验证
   - 数据处理和计算
   - 结果显示和格式化
   - 错误处理和提示

2. 在 `App.vue` 的中的引入Vue组件，例如

   ```vue
   <script setup lang="ts">
   import SpectrometerExperiment from "./components/SpectrometerExperiment.vue";
   ```

3. 找到新的实验组件的id， 使用v-else-if添加新的组件

   ```vue
   <!-- 右侧实验处理区域 -->
           <div class="flex-1">
             <div class="mb-6">
               <h2 class="text-2xl font-bold text-gray-900">
                 {{ selectedExperiment.name }}
               </h2>
             </div>
             <!-- 根据选择的实验显示对应的组件 -->
             <div v-if="selectedExperiment.id === 2">
               <SpectrometerExperiment />
             </div>
             <div v-else-if="selectedExperiment.id === 5">
               <BridgeExperiment />
             </div>
             <div v-else-if="selectedExperiment.id === 36">
               <TemplateDemo />
             </div>
             <div v-else-if="selectedExperiment.id === 37">
               <ElementDemo />
             </div>
             <div v-else class="text-gray-500 text-center py-12">
               该实验的数据处理功能正在开发中...
             </div>
           </div>
   ```

### 提交流程

1. Fork 项目
2. 克隆到本地并进行开发
3. 提交修改：`git commit -am 'feat: add new feature'`
4. 推送到远程：`git push origin main`
5. 提交 Pull Request

## 现有实验模块

### 分光计实验

- 支持光谱测量数据输入和处理
- 自动计算波长和误差
- 支持三棱镜面角测量
- 数据以度分格式显示
- 支持数据导出和图表可视化

### 自组电桥测电阻实验

- 支持电桥数据输入和处理
- 自动计算电阻值和误差
- 支持数据验证和异常检测

### 开发文档

- 组件模板演示
- Element Plus 组件演示
- 开发规范和示例

## 待开发实验

- [ ] 电位差计实验
- [ ] 光纤通信实验
- [ ] 测量透明薄片的折射率
- [ ] 光纤传感器实验
- [ ] 弗兰克-赫兹实验
- [ ] 更多...

## 许可证

[MIT License](LICENSE)

## 联系方式

如有问题或建议，请提交 Issue 或 Pull Request。

## 致谢

感谢所有贡献者对项目的支持！