用逐分钟潮位算高低潮及其出现时间:一个可在 STM32 上流式运行的算法
本文整理自一套已在实际潮位自动站运行的固件代码。算法从上位机 C# 验证程序移植到 STM32F407,输入是每分钟一个潮位值,输出是高潮/低潮事件及其发生时刻、潮位和替换关系。文中给出的判据参数、代码骨架和现场数据均来自真实工程,站号等现场信息已做脱敏。
一、问题比想象中难在哪
拿到一串每分钟的潮位数据,肉眼找最高点和最低点很容易,但写成程序会遇到几个绕不开的问题:
- 不知道"当前点"是不是极值。 潮位要涨过去再落回来才能确认刚刚那个点是高潮,所以任何算法都必须"延迟判定"。
- 平潮期没有唯一极值。 露底或平潮时,连续十几分钟的潮位相差不到 2 cm,到底取哪一分钟作为高潮/低潮时刻?直接取最早或最晚都会被人质疑。
- 噪声和毛刺。 陡坡上一分钟的微小回落,用简单的"比左右都低"判断就会被当成低潮。
- 缺测。 现场设备每小时总有一分钟采不到数,直接跳过会把整天的结果带偏。
- 嵌入式资源。 不能动态分配内存,不能依赖
math.h的 NaN,也不能把几天的数据全存下来再批处理。
本文的算法用固定 1440 点环形缓冲 + 32 个候选槽位 + 三层判据解决上述问题,每分钟调用一次,内存占用约 6 KB,无动态分配,已经在现场连续运行。
二、输入输出模型
输入(每分钟一次:
void TideHilo_PushMinute(const uint8_t dt[7], uint8_t valid, float level);
dt是 RTC 时间:年(2000 后两位)、月、日、星期、时、分、秒;valid=1表示本分钟潮位有效,valid=0按缺测处理;level是本分钟潮位,单位 mm,直接使用业务系统里的潮位值(已含高程基准)。
输出(事件回调:
typedef struct {
uint8_t type; /* 高潮 HW / 低潮 LW */
uint8_t isReplacement; /* 1=替换上一条同类事件 */
int32_t replacedTimeMin; /* 被替换事件的绝对分钟序号 */
uint16_t year; uint8_t month, day, hour, minute;
float level; /* 极值潮位,mm */
int32_t timeMin; /* 极值发生时刻的绝对分钟序号 */
} TideHiloEvent_t;
注意输出的是极值发生时刻(事件时间),不是算法判定出结果的时刻。由于延迟窗口的存在,两者通常相差 10 分钟以上——这一点在现场核对数据时非常容易搞混。
三、判据参数(以及一个单位换算的坑)
| 宏 | 值 | 含义 |
|---|---|---|
DAY_POINT |
1440 | 环形缓冲容量,保留最近一天逐分钟潮位 |
TIDE_WIN |
10 | 极值判定半窗宽,左右各 10 分钟,共 21 点 |
MIN_GAP_ALT |
120 | 高低潮交替输出的最小间隔(分钟) |
MIN_GAP_SAME |
360 | 同类型视为两次独立潮汐的最小间隔(分钟) |
CAND_MAX |
32 | 候选池容量 |
BIG_WIN |
90 | 背景确认窗口:中心前 90 分钟、后 10 分钟 |
BIG_WIN_TOL |
100 mm | 背景确认容差 |
BIG_WIN_MIN_PTS |
30 | 背景窗口可用样本数下限 |
PLATFORM_TOL |
20 mm | 平台容差:差值在此范围内视为"同一平潮" |
MAX_MISS_IN_WIN |
3 | ±10 窗口内允许的最大缺测数 |
单位换算的坑:源算法判据是按 cm 标定的(PLATFORM_TOL=2cm、BIG_WIN_TOL=10cm)。如果业务侧数据单位是 mm,直接把 mm 值喂给未换算的算法,2 cm 会缩成 0.2 cm、10 cm 缩成 1 cm,结果就是大量漏检和噪声误判。移植代码里显式做了换算:
#define TIDEHILO_MM_PER_CM 10
#define BIG_WIN_TOL (10.0f * TIDEHILO_MM_PER_CM) /* 100 mm */
#define PLATFORM_TOL (2.0f * TIDEHILO_MM_PER_CM) /* 20 mm */
对外接口、事件结构和业务数据全程保持 mm,只在算法内部换算一次。
四、算法总体流程
每分钟 PushMinute(时间, 有效标志, 潮位)
│
├─ RTC 时间 → 自 1970-01-01 起的绝对分钟序号
│ ├─ 分钟缺失:按 NaN 逐分钟补齐时间轴
│ ├─ 缺失超过一天:判定数据流中断,复位重来
│ └─ 时间倒退/重复:丢弃本条
│
└─ PushOne(本分钟值)
├─ 写入 1440 环形缓冲,更新 s_written
├─ 取 t = 当前分钟 - 10,判定 10 分钟前那一点
│ ├─ 小窗口 ±10 找"并列极值"(带 20mm 容差、缺测容错)
│ └─ 大窗口 [t-90, t+10] 做背景确认(带 100mm 容差)
├─ 成立则登记进候选池
├─ 候选池按时间排序 → 套用间隔规则输出事件
├─ Compact 回收已处理槽位
└─ 时钟前进 1 分钟
关键点:判定的是 10 分钟前的点。因为 TIDE_WIN=10,只有当时间推进 10 分钟,中心点的 ±10 分钟窗口才刚好齐备。这也是"高低潮时间"天生滞后的原因。
五、核心代码
5.1 环形缓冲的读取:未写入的位置一律 NaN
static float TideHilo_RingGet(int32_t pos)
{
int32_t slot;
if (s_first < 0 ||
303



被折叠的 条评论
为什么被折叠?



