feat: 添加项目初始文件

- 添加 .gitignore 忽略文件
- 添加 doc/ 设计需求文档
This commit is contained in:
2026-05-24 09:51:05 +08:00
commit 43f79dac37
2 changed files with 153 additions and 0 deletions
+61
View File
@@ -0,0 +1,61 @@
# Python
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
*.egg-info/
.installed.cfg
*.egg
# 虚拟环境
venv/
ENV/
env/
.venv/
# IDE
.idea/
.vscode/
*.swp
*.swo
*~
# 移动平台
*.apk
*.aab
*.ipa
*.app
*.xcarchive
*.xcodeproj
*.xcworkspace
# 构建输出
*.o
*.obj
*.dll
*.exe
# 数据文件
*.csv
*.json
*.log
logs/
# 临时文件
.DS_Store
Thumbs.db
*.tmp
.cache/
+92
View File
@@ -0,0 +1,92 @@
# 软件基本信息
- 软件名称:sensTools (传感器工具)
- 软件版本:1.0.0
- 软件平台:Android, iOS ,HarmonyOS
- 软件描述:这是一个采用手机上的传感器进行简单的数据采集和分析的工具。
- 软件作者:[青辉之主]
- 软件联系邮箱:[1234567890@qq.com]
- 软件使用许可:[MIT](https://opensource.org/licenses/MIT)
## 软件工程管理
1. 项目管理:
- 项目采用敏捷开发方法,包括需求分析,功能设计,代码实现,测试,部署等。
- 项目采用版本控制工具,包括Git。
2. 版本控制:
- 提供版本控制功能,包括代码提交,版本切换,版本对比等。
- 支持团队合作,包括代码合并,冲突解决等。
3. 文档管理:
- 提供项目文档,包括需求分析,功能设计,代码实现,测试,部署等。
- 提供项目文档的版本控制,包括文档提交,文档切换,文档对比等。
4. 测试管理:
- 提供项目测试用例,包括功能测试,性能测试,安全测试等。
- 提供项目测试用例的版本控制,包括测试用例提交,测试用例切换,测试用例对比等。
5. 需求管理:
- 提供项目需求分析文档,包括功能需求,非功能需求,性能需求等。
- 提供项目需求分析文档的版本控制,包括需求分析文档提交,需求分析文档切换,需求分析文档对比等。
- 支持团队合作,包括需求分析文档的合并,冲突解决等。
## 软件功能
1. GPS数据采集,包括经度,纬度,高度,速度,方向,卫星数,时间,日期等数据;
2. 传感器数据采集,包括加速度,陀螺仪,磁力计,气压高度,温度,湿度数据。
2. 数据可视化,包括地图,陀螺仪、加速度传感器曲线,磁力三维显示,姿态角可视化,飞行姿态仪表盘等。
3. 数据分析,包括统计分析,趋势分析,异常检测等。
4. 飞行仪表参考空客飞机的设计模式。
## 软件界面
1. 主界面:
- 显示当前采集的GPS数据,包括经度,纬度,高度,速度,方向,卫星数,时间,日期等。
- 显示飞行姿态仪表盘,包括姿态角可视化,高度,速度,方向等。
- 显示传感器数据,包括加速度,陀螺仪,磁力计,气压高度,温度,湿度等数字数据。
2. 数据管理界面:
- 显示已采集的GPS数据,包括经度,纬度,高度,速度,方向,卫星数,时间,日期等。
- 显示已采集的传感器数据,包括加速度,陀螺仪,磁力计,气压高度,温度,湿度等。
- 提供数据删除功能,包括删除所有数据,删除选中数据等。
3. 数据导出界面:
- 提供数据导出功能,包括CSV文件导出,JSON文件导出等。
- 提供数据导出路径选择功能,包括默认路径,自定义路径等。
- 提供数据发送到微信,飞书等功能。
## 软件数据结构
```python
1. GPS数据结构:
class GPSData:
- 时间撮 int
- 经度 double
- 纬度 double
- 高度:float
- 速度:float
- 方向:float
- 卫星数:int
- 时间:str
- 日期:str
2. 传感器数据结构:
class SensorData:
- 时间撮 int
- 加速度:float
- 陀螺仪:float
- 磁力计:float
- 气压高度:float
- 温度:float
- 湿度:float
- 时间:str
- 日期:str
```
## 软件数据处理
1. GPS经纬度显示为小数点后8位,高度显示为小数点后2位,速度显示为小数点后2位,方向显示为小数点后2位。
2. 传感器数据显示为小数点后2位。
3. 经纬度转换成度格式,高度显示为米。
4. 姿态角显示为度,角速度显示为度/秒。加速度显示为米/秒^2。温度显示为摄氏度。湿度显示为百分比。
5. 角速度要经过扩展卡尔曼滤波融合GPS数据,得到更准确的姿态角。
6. 速度和位置都要经过扩展卡尔曼滤波融合传感器数据,得到更准确的速度和位置。
## 软件数据存储
1. 数据存储,文件名为当前时间,格式为:yyyy-MM-dd HH:mm:ss.csv。
2. 数据支持导出操作
3. 每一包数据都要带时间戳,单位为毫秒。使用时间戳来排序数据。
4. 数据记录频率,GPS数据记录频率为5Hz,传感器数据记录频率为100Hz。
6. 数据原始格式可以记录为二进制文件减少存储空间,按照数据结构进行记录,要导出时,再转换成CSV,或者JSON文件。