# 激振频率逆向预测 (Forced-Vibration Frequency Prediction)

## 项目简介
本目录用于完成强迫振动频率逆向预测任务。脚本基于建筑顶部响应传感器 `WSMS00007` 的 Z 向数据，从稳态振动段中识别主频，反推出地震台输入的简谐波频率，并输出频率误差与可视化结果。

## 技术路线
本目录的分析流程覆盖稳态段提取、主频精细识别与结果校验三个部分：

1. **稳态中段截取**
   对强迫振动时程执行滑动窗口搜索，从中间区域选出波动最稳定的响应片段，用于频谱分析。
2. **顶部响应主频识别**
   读取 `WSMS00007` 的 `value3` 列，对稳态段进行加窗 FFT 与补零计算，并结合抛物线插值输出高精度激振频率。
3. **文件名真值校验**
   从样本文件名中提取频率标签，计算预测值与真值之间的绝对误差。

## 核心模块说明

- **`task4_predict_freq.py`**
  任务主脚本。负责稳态段截取、频谱分析、抛物线插值、误差计算与频域图像生成。

## 使用指南

**1. 运行任务脚本**
对单个强迫振动样本预测激振频率：
```bash
python scripts_3\task4_predict_freq.py --file downloads\Non_TMD\val\harmonic_5mm_0.75Hz.csv
```

**2. 指定输出目录**
将图像保存到自定义目录：
```bash
python scripts_3\task4_predict_freq.py --file downloads\Non_TMD\val\harmonic_5mm_0.75Hz.csv --output-dir evaluation_outputs\task4_custom
```