Duas janelas acionadas em 0,4% e 3,3% do ano
Esta nota de pesquisa documenta um erro de dados encontrado nos dois registros de San Blas no AYON Wave, e o que foi preciso para enxergá-lo. San Blas fica na costa do Pacífico de Nayarit, no México, numa baía voltada para o sul. Um registro afirmava uma janela de swell de 170–205°, o outro de 170–210° — o setor que os guias dão para um swell de sul.
Contado contra um ano inteiro de swell horário modelado do arquivo do Open-Meteo, na célula de modelo dos registros, o swell chegou dentro da janela de 170–205° em 0,4% do tempo (33 horas) e dentro da janela de 170–210° em 3,3% (286 horas), no máximo 12,6% em qualquer mês (abril). O intervalo exato de doze meses não foi registrado no commit. Não são janelas fracas. São janelas em que o swell modelado nesta célula raramente entra, e o swell dominante nunca entrou.
Os registros foram adicionados em 2026-09-07 (commit 07c3100) e carregaram as janelas por seis dias no repositório. A correção entrou no repositório em 2026-09-13 (commit 940457d). O resto desta nota cobre o que os números significavam dentro do motor, como a substituição foi escolhida e o que ela deixa sem resolver.
O que a janela errada fazia dentro do motor
O motor do AYON Wave não desliga um pico quando o swell fica fora da janela dele. Desde que o decaimento gradual entrou no repositório em 2026-08-26 (commit 7f0c5fe), um swell dentro da janela pontua +12 como alinhado; até cerca de 20° fora dela leva a penalidade de −4 da faixa próxima à janela, sem motivo de cautela; além desse ponto é pontuado como desalinhado, de −14 a −23. Um teto rígido que segura a pontuação em 70, abaixo da linha de GO de 75, só se aplica a 30° ou mais fora da janela. A docstring do motor registra a pontuação binária anterior — +12 dentro, −14 fixo e uma cautela em qualquer ponto fora — como o bug que o decaimento substituiu.
Com as janelas antigas, o swell dominante de 215–225° ficava 5–15° fora do registro de 170–210° e 10–20° fora do registro de 170–205°, que é, em sua maior parte, a faixa de −4; a 225° no registro de 170–205° a penalidade era de −14. O registro de 170–205° ganhou o crédito de +12 por alinhamento em 33 horas do ano, e o registro de 170–210° em 286, nunca pelo swell dominante. Contra uma linha de GO de 75 pontos, a distância entre +12 e −4 é uma desvantagem de 16 pontos em quase todas as horas do ano. O teto rígido só foi atingido pelo mar de vento de 235–255°, não pelo swell de fundo.
O que essa desvantagem custou em recomendações não foi contado. A mensagem do commit descreve os picos como "efetivamente mortos no app"; uma leitura do motor no mesmo commit mostra que o efeito real foi uma desvantagem de −4 a −14 sobre o swell dominante, não um desligamento, e essa correção faz parte deste achado. Não existe nenhuma rodada do motor ao longo do ano com as janelas antigas, então esta nota não afirma que os picos nunca foram recomendados; afirma que o swell que carrega o surf em San Blas nunca ganhou o crédito por isso em nenhum dos dois registros.
O commit não registra como o erro foi percebido. Um pico que raramente ganha seu crédito de direção é difícil de distinguir, de dentro do app, de um pico que raramente fica bom — o problema em aberto retomado no fim desta nota.
Onde o arquivo do modelo coloca o swell
O mesmo ano de horas de arquivo mostra de onde o swell nesta célula chega no arquivo. A massa dele fica numa faixa estreita logo a oeste do sul, e o período médio cai bruscamente conforme a direção gira mais para oeste.
- 215–225°: 4632 das horas do ano, período médio de 11,9 s — swell de fundo, o setor que carrega o surf.
- 225–235°: período médio de 9,7 s — o período já está desabando.
- 235–255°: período médio de 8,3 s — mar de vento local, não swell de fundo, e maral numa baía voltada para o sul.
Por que a janela corrigida é 210–225°
A janela foi definida em 210–225° nos dois registros no repositório; a correção chega ao app com a próxima atualização. A borda inferior mantém a ponta sul do setor de chegada; a borda superior para antes do ponto em que a evidência de período diz que o swell virou marola de vento.
Três outras janelas foram pesquisadas antes desta: 200–230°, 205–235° e 230–255°. Duas revisões independentes rejeitaram as duas primeiras por serem largas demais.
A terceira, 230–255°, nunca foi revisada e contradiz a evidência de período diretamente: começa onde o período médio já caiu para 9,7 s e atravessa o terreno de 8,3 s. Foi descartada com base nisso. Das quatro candidatas pesquisadas, 210–225° é a que para antes de a evidência de período desabar e não foi rejeitada. Sua fatia de 210–215° não tem um número de período separado nas estatísticas do arquivo.
O que a correção não resolve
A nova janela é consistente com o arquivo, e mal discrimina. Ela é acionada em 63,8% de todas as horas do ano, e em 100% das horas de junho. A direção carrega pouca informação nesta célula por um motivo simples: o swell vem de 215–225° em mais da metade de todas as horas (4632 delas), então um teste de direção que passa diz muito pouco ao motor.
O que de fato controla esses picos é o tamanho. A altura média do swell na célula é de 0,55–0,80 m, contra os cerca de 1,5 m em que se diz que esses pointbreaks começam a funcionar. Esse número vem das descrições escritas do pico, e a AYON não o conferiu. San Blas é pequeno na maior parte do ano; a mira não é o problema.
A consequência para o motor é específica. Qualquer seletividade real aqui tem de vir dos termos de altura e período. Estreitar ainda mais a janela de direção só recriaria o problema original em forma menor.
- O swell chega dentro da janela dos registrosErro
- Registro
- 170–205° / 170–210°
- Modelado (um ano na célula)
- 0,4% / 3,3% das horas
- O swell chega dentro da janela corrigida (ajustada a este mesmo arquivo)Não pontuado
- Registro
- 210–225°
- Modelado (um ano na célula)
- 63,8% das horas — uma checagem de consistência contra os dados de ajuste, não um teste
- A janela corrigida discrimina entre as horasErro
- Registro
- 210–225°
- Modelado (um ano na célula)
- 63,8% das horas; 100% em junho
Verificado continua falso
Os dois registros mantêm a marcação de verificado em false. No vocabulário de evidência da AYON, um MODELO é uma estimativa calculada, uma OBSERVAÇÃO DE CAMPO é um relato humano com carimbo de hora, e VERIFICADO significa um registro revisado contra sua fonte e uma observação repetida. Um ano de estatísticas de arquivo numa célula de modelo é o primeiro desses, não o último.
A janela corrigida é consistente com o arquivo do modelo. Se o pico a 210–225° e 1,5 m faz o que os guias dizem que faz é uma pergunta que só alguém na água em San Blas pode responder, e não existe nenhuma observação de campo da AYON para San Blas.
O problema em aberto: janelas que penalizam um pico em silêncio
O achado generalizável não é sobre San Blas. Uma janela de direção escrita a partir do que dizem os guias pode estar errada de um jeito que não quebra nada visivelmente: com até 30° de erro, ela taxa a pontuação do pico em toda hora em que o swell corre fora dela, e além de 30° ela segura o pico abaixo da linha de GO de vez — em silêncio, enquanto a janela continuar sem conferência.
A checagem que pegou o erro é barata: um ano de swell horário na célula do registro, agrupado por direção, comparado com a janela. Todo registro deveria passar por ela antes de ir para o app. Os resultados dessa checagem para o resto do catálogo não fazem parte desta nota; serão publicados aqui, caiam para o lado que caírem.
Isto é pesquisa. Estimativas são modelos, não garantias; um modelo nunca é uma observação, e uma estimativa de máquina nunca é “confirmada” — só uma pessoa revisando em campo a torna verificada. Nada nesta página é uma afirmação de capacidade operacional, uma promessa de segurança ou a previsão de um evento específico num lugar específico.
Referências e dados
- 1.Open-Meteo Marine API — historical hourly swell — A fonte do arquivo: um ano de altura, período e direção do swell, de hora em hora, na célula de modelo dos registros de San Blas, agrupado por setor de direção para produzir as contagens de horas e os períodos médios acima. Os dois registros caem na mesma célula. O intervalo exato de doze meses não foi registrado no commit. Um arquivo de MODELO, não uma observação.
- 2.AYON Wave spots.ts — San Blas records (commit 940457d) — Os dois registros de pico cuja janela de swell foi mudada de 170–205° / 170–210° para 210–225° em 2026-09-13, com verificado deixado em false nos dois.
- 3.AYON Wave src/domain/direction.ts and src/domain/signal-engine.ts (at commit 940457d) — A pontuação de direção de swell do motor como estava quando a janela foi mudada: um decaimento gradual em meio cosseno ao longo dos 30° fora de uma janela (directionMatchScore), +12 dentro, −4 na faixa próxima à janela, −14 a −23 a partir de cerca de 20° fora, GO com pontuação de 75 ou mais, e um teto em 70 para swells 30° ou mais fora. Pontuação graduada desde o commit 7f0c5fe, 2026-08-26. A desvantagem de 16 pontos desta nota é a distância entre +12 e −4.