# 边坡可视化工具

**Repository Path**: dc5866/slope-visualization-tool

## Basic Information

- **Project Name**: 边坡可视化工具
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-15
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 边坡监测数据可视化分析工具

一个基于 Vue 3 + TypeScript 的边坡/滑坡监测数据分析与三维可视化 Web 应用。

## 功能特性

- **三维模型可视化**：基于 Three.js 的边坡三维模型渲染，支持旋转、缩放交互
- **多源数据导入**：支持 Excel 格式的监测数据导入（表面位移、内部位移、水位线等）
- **数据分析处理**：提供数据矫正、变异点分析、小波变换、数据平滑等功能
- **关联分析**：多因素关联性分析，融合表面位移、内部位移、水位等数据
- **图表可视化**：基于 ECharts 的监测数据图表展示

## 技术栈

| 类别 | 技术 |
|------|------|
| 核心框架 | Vue 3.5 + TypeScript |
| 构建工具 | Vite 6 |
| UI 组件库 | Element Plus |
| 状态管理 | Pinia |
| 路由 | Vue Router |
| 图表库 | ECharts + vue-echarts |
| 三维渲染 | Three.js |
| Excel 处理 | SheetJS (xlsx) |
| 样式预处理器 | Sass |

## 快速开始

### 环境要求

- Node.js >= 18
- pnpm >= 8（推荐）或 npm / yarn

### 安装依赖

```bash
pnpm install
```

### 开发模式

```bash
pnpm dev
```

访问 `http://localhost:5173`

### 生产构建

```bash
pnpm build
```

### 预览构建结果

```bash
pnpm preview
```

### 运行测试

```bash
pnpm test:unit
```

## 项目结构

```
src/
├── views/              # 页面视图
│   ├── Index.vue           # 主页面
│   ├── PlaneFromExcel.vue  # Excel 点云可视化
│   └── InsideMovingDT.vue  # 内部位移数据表
├── components/         # 组件
│   ├── SceneContainer.vue      # 三维场景容器
│   ├── UploadFile.vue          # 文件上传组件
│   ├── SurfaceDisplacementDA.vue  # 表面位移分析
│   ├── CorrelationAnalysis.vue    # 关联分析
│   └── ...
├── router/            # 路由配置
├── stores/            # Pinia 状态管理
├── utils/            # 工具函数
└── assets/           # 静态资源

数据文件/
├── 表面位移.xlsx          # 示例数据
├── 内部位移0.xlsx
├── 剖线坐标（生成模型示例文件）new.xlsx
└── 水位线坐标.xlsx
```

## 数据文件格式

### 模型文件（剖线坐标）

Excel 文件需包含以下列：
| 列名 | 说明 |
|------|------|
| 剖面号 | 剖面标识 |
| X | X 坐标 |
| Y | Y 坐标 |
| Z | Z 坐标 |

### 表面位移数据

| 列名 | 说明 |
|------|------|
| 日期 | 监测日期 |
| X累积 | X 方向累积位移 |
| Y累积 | Y 方向累积位移 |
| Z累积 | Z 方向累积位移 |
| 剖面号 | 所属剖面 |

### 内部位移数据

| 列名 | 说明 |
|------|------|
| 监测日期 | 监测日期 |
| 孔号 | 监测孔标识 |
| 深度 | 监测深度(m) |
| 累积位移 | 累积位移量(mm) |
| 速率 | 变化速率(mm/d) |

### 水位线数据

| 列名 | 说明 |
|------|------|
| X | X 坐标 |
| Y | Y 坐标 |
| Z | Z 坐标（水位高程） |

## 主要功能模块

1. **数据采集**：上传模型文件、监测点、表面位移、内部位移、水位线等数据
2. **数据处理**：表面位移方向矫正、内部位移变异点确定、数据平滑等
3. **分析功能**：关联分析、融合分析
4. **可视化**：三维模型展示、监测曲线图表

## License

MIT