# RUL-Framework

**Repository Path**: zhao-xiao-yong/RULFramework

## Basic Information

- **Project Name**: RUL-Framework
- **Description**: 剩余使用寿命（RUL）预测、故障诊断框架，附带实验示例代码，目前完善中，不定时更新
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: http://134.175.206.112/#/home
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 10
- **Created**: 2025-01-22
- **Last Updated**: 2025-01-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 故障预测框架（Prognostics Framework）

## 🚀    功能简介
- 简化剩余使用寿命预测、故障诊断的代码编写，附带示例+经典论文复现代码
- 对中间生成数据进行缓存并自动管理，提升程序运行速度与实验效率
- 兼容多种深度学习框架进行模型搭建（PyTorch、TensorFlow、Pyro）
- 支持自动导出实验参数与结果（模型、正则化系数、迭代次数、采样次数..）
- 支持多种实验对象（轴承、涡扇发动机、电池..）
- 支持多种数据集自动导入（XJTU-SY、PHM2012、C-MAPSS、PHM2008..）
- 支持多种预处理+特征提取方法（滑动窗口、归一化、均方根、峭度..）
- 支持多种退化阶段划分算法（3σ原则FPT、10倍振幅EoL）
- 支持多种预测算法（端到端预测、单/多步滚动预测、不确定性预测..）
- 支持实验结果可视化（混淆矩阵图、阶段划分图、预测结果图、注意力分布图..）
- 支持多种评价指标（MAE、MSE、RMSE、MAPE、PHM2012score、NASAscore..）
- 支持自定义组件（轻松扩展新的算法）


## 💡    安装方法
### 使用git库远程安装
1. pip install git+https://gitee.com/holdenmcgorin/RULFramework
### 使用源代码安装
1. 下载源代码 或 git clone https://gitee.com/holdenmcgorin/RULFramework.git
2. 进入此项目根目录
3. pip install .

## 💻    代码示例
- notebook示例：项目根目录
- 原生python示例：example文件夹

## 📂    文件结构说明
- rulframework —— 框架代码
- doc —— 框架详细说明文档（编写自定义组件时建议查看）
- example —— 试验代码示例（原生python）

## 📦    数据集来源
### 1. XJTU-SY西交大轴承数据集
https://biaowang.tech/xjtu-sy-bearing-datasets/
### 2. PHM2012轴承数据集
https://github.com/Lucky-Loek/ieee-phm-2012-data-challenge-dataset
### 3. C-MAPSS涡扇发动机数据集
https://data.nasa.gov/Aeorspace/CMAPSS-Jet-Engine-Simulated-Data/ff5v-kuh6  
### 4. PHM2008数据集
https://data.nasa.gov/download/nk8v-ckry/application%2Fzip
### 5. 更多数据集
https://www.nasa.gov/intelligent-systems-division/discovery-and-systems-health/pcoe/pcoe-data-set-repository/

## ⚠    注意事项
- 该框架使用Python 3.8.10编写，使用其他版本python运行可能会出现兼容性问题，若出现问题欢迎在issue反馈
- 读取数据集时，不要改变原始数据集内部文件的相对位置（可以只保留部分数据），不同的位置可能导致无法读取数据


觉得项目写的还行的大佬们点个star呗，觉得哪里写得不行的地方也欢迎issue一下，您的关注是我最大的更新动力！😀


##### @键哥工作室 @AndrewStudio
##### 个人邮箱：andrewstudio@foxmail.com
##### 个人网站：http://134.175.206.112/#/home