NILM-EVAL 项目使用教程

1. 项目目录结构及介绍

NILM-EVAL 是一个用于评估非侵入式负载监控算法的 MATLAB 框架。项目的目录结构如下：

nilm-eval/
├── Matlab/
│   ├── algorithms/
│   │   ├── kolter_alg/
│   │   └── ...
│   ├── datasets/
│   ├── evaluation/
│   ├── utils/
│   └── ...
├── Python/
├── gitignore
├── HOWTO.txt
├── LICENSE
├── QUICK_GUIDE.txt
├── README.md
└── ...

目录结构介绍

• Matlab/: 包含所有 MATLAB 代码和脚本，用于评估非侵入式负载监控算法。
  • algorithms/: 包含不同的算法实现，例如 kolter_alg/ 目录下的 kolter.m 文件。
  • datasets/: 包含用于评估的数据集。
  • evaluation/: 包含评估算法的脚本和工具。
  • utils/: 包含一些实用工具和辅助函数。
• Python/: 包含 Python 代码和脚本，用于辅助评估。
• gitignore: Git 忽略文件配置。
• HOWTO.txt: 使用指南和说明。
• LICENSE: 项目许可证文件。
• QUICK_GUIDE.txt: 快速入门指南。
• README.md: 项目介绍和基本信息。

2. 项目的启动文件介绍

项目的启动文件通常是 Matlab/ 目录下的某个脚本文件，例如 Matlab/evaluation/evaluate_algorithm.m。这个文件负责加载数据集、配置算法参数并执行评估。

启动文件示例

% Matlab/evaluation/evaluate_algorithm.m

% 加载数据集
dataset = load_dataset('datasets/eco_dataset.mat');

% 配置算法参数
algorithm_config = struct();
algorithm_config.algorithm = 'kolter';
algorithm_config.parameters = struct('lratio', 0.5);

% 执行评估
results = evaluate_algorithm(dataset, algorithm_config);

% 输出结果
disp(results);

3. 项目的配置文件介绍

项目的配置文件通常是 Matlab/ 目录下的某个配置文件，例如 Matlab/config/default_config.m。这个文件定义了评估算法时使用的参数和设置。

配置文件示例

% Matlab/config/default_config.m

% 数据集配置
config.dataset = 'eco_dataset';
config.granularity = 1; % 数据粒度
config.household = 1; % 家庭编号

% 算法配置
config.algorithm = 'kolter';
config.parameters.lratio = 0.5; % 算法参数

% 评估配置
config.evaluation.metrics = {'MAE', 'RMSE'}; % 评估指标
config.evaluation.period = 'daily'; % 评估周期

通过修改配置文件中的参数，可以调整评估算法的行为和性能。

---

以上是 NILM-EVAL 项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用该项目。