Busca de Radar e Satélite NOAA

Visão Geral

Recupere objetos de radar NEXRAD e satélite GOES da NOAA de arquivos de nuvem públicos, preservando a identidade do produto, plataforma, setor espacial e tempo de varredura. Descubra através de prefixos restritos, escolha pelo tempo de observação em vez do tempo de upload e valide o arquivo científico baixado antes do uso.

Esta funcionalidade abrange produtos brutos ou produzidos por provedores de radar e satélite. Ela não recupera saída de modelo numérico ou observações de estação comuns.

Quando Usar Esta Funcionalidade

• Uma tarefa precisa de volumes de arquivo NEXRAD Nível II ou blocos em tempo real.
• Uma tarefa precisa de produtos NEXRAD Nível III selecionados.
• GOES ABI, GLM ou outro produto GOES-R é necessário para um tempo e região.
• Um download deve selecionar a varredura completa mais próxima dentro de uma tolerância.
• Uma chave S3 pública, designação de satélite, local de radar, canal ou setor é incerta ou mudou.

Não ative esta funcionalidade meramente para exibir um tile de mapa de terceiros ou para responder a uma pergunta geral sobre o tempo.

Defina o Contrato do Produto

Para NEXRAD, especifique:

• Arquivo Nível II, blocos em tempo real Nível II ou um produto Nível III nomeado;
• local de radar de quatro caracteres, como KTLX;
• tempo de varredura desejado em UTC e política de seleção mais próxima/anterior/próxima;
• tolerância máxima de tempo;
• volume completo ou código de produto exato;
• retenção de arquivo bruto e decodificador.

Para GOES, especifique:

• número físico do satélite ou função operacional, como Leste ou Oeste;
• instrumento e nível/nome curto do produto;
• setor Full Disk, CONUS, Mesoscale 1 ou Mesoscale 2, quando aplicável;
• canal ABI ou produto derivado;
• tempo de varredura desejado em UTC e tolerância;
• forma de calibração necessária, como radiância ou temperatura de brilho.

Resolva uma função operacional para um satélite físico usando a documentação atual da NOAA no momento da solicitação. As designações Leste e Oeste mudam ao longo da vida útil de um programa de satélite.

Rotas Públicas Atuais da AWS

Consulte o Registro de Dados Abertos da AWS antes de codificar um bucket. Na época desta publicação da funcionalidade:

• Arquivo NEXRAD Nível II: s3://unidata-nexrad-level2/
• Blocos em tempo real NEXRAD Nível II: s3://unidata-nexrad-level2-chunks/
• Dados em tempo real NEXRAD Nível III selecionados: s3://unidata-nexrad-level3/
• Imagens e metadados GOES: buckets específicos de satélite como s3://noaa-goes18/ e s3://noaa-goes19/

O antigo bucket noaa-nexrad-level2 foi descontinuado e programado para se tornar indisponível em 1º de setembro de 2025. Não copie essa rota aposentada de tutoriais antigos.

Descubra com Prefixos Restritos

Objetos de arquivo NEXRAD Nível II são organizados por data UTC e local. Objetos GOES são organizados por produto, ano, dia do ano e hora. Liste apenas o prefixo menor que pode conter a varredura solicitada.

aws s3 ls --no-sign-request \
  s3://unidata-nexrad-level2/YYYY/MM/DD/KXXX/

aws s3 ls --no-sign-request \
  s3://noaa-goes19/ABI-L2-CMIPC/YYYY/DDD/HH/

Substitua cada placeholder por um valor validado. Inclua a hora adjacente ou o dia UTC apenas quando a tolerância de tempo cruzar esse limite. Pagine as listagens e limite as chaves totais inspecionadas.

Use buckets de blocos em tempo real apenas quando o consumidor for projetado para montar e validar blocos. Prefira volumes de arquivo completos para processamento histórico ou pós-evento comum.

Selecione por Tempo de Varredura

O objeto Last-Modified são metadados de publicação, não o tempo de medição.

• Para NEXRAD, analise o local e o timestamp da varredura do nome do objeto documentado, em seguida, confirme o tempo e o local do cabeçalho do volume decodificado.
• Para GOES-R, os nomes de arquivo codificam timestamps da plataforma mais o início da varredura (s), fim (e) e criação (c). Selecione pelo início da varredura ou sobreposição de intervalo, não pelo tempo de criação do arquivo.
• Por padrão, use a varredura mais próxima no momento solicitado ou antes dele para uma visualização retrospectiva. Permita uma varredura futura apenas quando o chamador solicitar explicitamente o comportamento de mais próximo em qualquer direção.
• Rejeite todos os candidatos fora da tolerância declarada.
• Quando os setores se sobrepõem, exija o setor solicitado em vez de escolher apenas pelo tempo.

Este auxiliar da biblioteca padrão extrai timestamps de varredura GOES-R sem abrir a carga útil NetCDF:

import re
from datetime import datetime, timezone
from pathlib import PurePosixPath


GOES_TIMES = re.compile(
    r"_s(?P<start>\d{14})_e(?P<end>\d{14})_c(?P<created>\d{14})"
)


def parse_goes_times(object_key):
    match = GOES_TIMES.search(PurePosixPath(object_key).name)
    if not match:

…