# 大物实验数据处理平台

**Repository Path**: heuwings/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-14
- **Last Updated**: 2025-03-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 物理实验数据处理平台

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

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

## 功能特点

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

## 技术栈

- Vue 3 (使用 Composition API 和 `<script setup>`)
- TypeScript
- Vite
- Element Plus
- ECharts
- Vue Router
- Pinia (状态管理)
- Headless UI

## 快速开始

### 环境要求

- 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-experiments/
├── src/
│   ├── assets/              # 静态资源
│   │   ├── base.css         # 基础样式
│   │   └── main.css         # 主样式文件
│   ├── components/          # 组件
│   │   ├── BridgeExperiment.vue     # 电桥实验组件
│   │   ├── SpectrometerExperiment.vue  # 分光计实验组件
│   │   ├── ElementDemo.vue     # Element Plus 示例组件
│   │   └── TemplateDemo.vue    # 模板示例组件
│   ├── layouts/             # 布局组件
│   │   └── MainLayout.vue   # 主布局组件
│   ├── router/              # 路由配置
│   │   ├── categories.ts    # 实验分类配置
│   │   └── index.ts         # 路由主配置
│   ├── stores/              # 状态管理
│   │   └── experimentStore.ts  # 实验相关状态
│   ├── templates/           # 模板组件
│   │   ├── Card.vue         # 卡片组件
│   │   ├── DataTable.vue    # 数据表格组件
│   │   ├── ExperimentLayout.vue  # 实验布局组件
│   │   ├── InputField.vue   # 输入字段组件
│   │   └── StatisticsCard.vue  # 统计卡片组件
│   ├── views/               # 视图页面
│   │   ├── dev/             # 开发示例页面
│   │   │   ├── ElementDemoView.vue  # Element Plus 示例页面
│   │   │   └── TemplateDemoView.vue  # 模板示例页面
│   │   ├── experiments/     # 实验页面
│   │   │   ├── BridgeView.vue        # 电桥实验页面
│   │   │   ├── SpectrometerView.vue  # 分光计实验页面
│   │   │   ├── CategoryView.vue      # 分类页面
│   │   │   └── ComingView.vue        # 即将上线页面
│   │   ├── HomeView.vue     # 首页
│   │   └── NotFoundView.vue # 404页面
│   ├── App.vue              # 主应用组件
│   └── main.ts              # 应用入口
├── public/                  # 公共资源
├── index.html               # HTML 模板
├── package.json             # 项目配置
├── tsconfig.json            # TypeScript 配置
├── vite.config.ts           # Vite 配置
├── tailwind.config.js       # Tailwind 配置
└── postcss.config.js        # PostCSS 配置
```

## 代码风格和最佳实践

### Vue 组件示例

```vue
<script setup lang="ts">
import { ref, computed } from "vue";
import type { ExperimentData } from "@/types";

// 类型定义
interface Props {
  initialData?: ExperimentData;
}

// 组件 props
const props = defineProps<Props>();

// 组件事件
const emit = defineEmits<{
  (e: "update:data", value: ExperimentData): void;
  (e: "calculate"): void;
}>();

// 响应式状态
const measurements = ref<number[]>([]);
const isCalculating = ref(false);
const hasError = ref(false);

// 计算属性
const average = computed(() =>
  measurements.value.length > 0
    ? measurements.value.reduce((sum, val) => sum + val, 0) /
      measurements.value.length
    : 0
);

// 方法
function addMeasurement(value: number) {
  measurements.value.push(value);
}

function calculate() {
  isCalculating.value = true;
  try {
    // 计算逻辑
    emit("update:data", { average: average.value });
    emit("calculate");
  } catch (error) {
    hasError.value = true;
    console.error(error);
  } finally {
    isCalculating.value = false;
  }
}
</script>

<template>
  <div class="p-4 bg-white dark:bg-gray-800 rounded-lg shadow">
    <h3 class="text-lg font-medium text-gray-900 dark:text-white mb-4">
      实验数据
    </h3>

    <!-- 数据输入 -->
    <div class="space-y-4">
      <!-- 组件内容 -->
    </div>
  </div>
</template>
```

## 贡献指南

我们欢迎所有形式的贡献，特别是新的物理实验数据处理模块。详细的贡献指南请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。

贡献流程简要说明：

1. Fork 项目到自己的账号
2. 克隆项目到本地进行开发
3. 创建新分支实现功能
4. 提交代码并创建 Pull Request
5. 等待代码审核和合并

## 现有实验模块

### 分光计实验

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

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

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

### 开发文档

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

## 性能优化

项目实现了以下性能优化策略：

- 使用 `<script setup>` 减少组件样板代码
- 组件按需导入和懒加载
- Vite 构建优化和代码分割
- 实现了响应式图像加载
- 使用 VueUse 提供的优化函数
- Suspense 异步组件包装

## 待开发实验

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

## 许可证

[MIT License](LICENSE)

## 联系方式

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

## 致谢

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