RADAR LA TORREGASSA · v0.5.0.5

Manual d’ajuda

Consulta un capítol o desplega'l per llegir-lo. Les instruccions corresponen a aquesta versió del radar.

1. Introducció

El Radar La Torregassa permet veure els ecos de precipitació a l'entorn de la localitat, comparar observacions i seguir els nuclis més intensos. Les observacions provenen d'AEMET. El radar funciona sense OpenAI: la intel·ligència artificial és una eina opcional.

Mira sempre l'hora de l'observació. La imatge pot arribar amb retard i no descriu necessàriament què passa ara mateix. Cap eina d'aquest radar substitueix els avisos oficials d'AEMET o del Servei Meteorològic de Catalunya.

Torna a l’índex

2. Mapes del radar
  1. Tria Local per consultar La Torregassa i un entorn de fins a 100 km, amb dades del radar regional de Barcelona/Gelida.
  2. Tria Catalunya i entorn per entendre l'activitat en un àmbit més ampli.
  3. Tria Península per consultar el mosaic peninsular.

Utilitza els botons de vista i els controls d'animació del mapa. La llegenda correspon a la imatge consultada. Una zona sense cobertura, marcada com a tal, no significa necessàriament absència de pluja. Les vistes àmplies tenen menys detall; no comparis un píxel entre mapes com si representés la mateixa superfície.

Torna a l’índex

3. Colors i intensitat

Els dBZ expressen la força del retorn que rep el radar. En general, un valor més alt indica ecos més intensos. No són mil·límetres de pluja.

  • Cian o turquesa, des de 12 dBZ: ecos febles.
  • Verds, des de 24 dBZ: precipitació més organitzada.
  • Grocs, des de 36 dBZ: ruixats més actius.
  • Taronges i vermells, des de 42 dBZ: ecos intensos.
  • Liles i fúcsies, des de 60 dBZ: ecos molt intensos.
  • Blancs, des de 72 dBZ: retorns extrems.

Consulta la llegenda exacta de cada observació. La reflectivitat no equival directament a la pluja que arriba a terra: hi influeixen l'altura, l'evaporació i el tipus de partícules. Alguns ecos poden ser retorns del terreny o altres interferències. Les estimacions de pluja són orientatives.

Torna a l’índex

4. Animació i històric
  1. Prem el control de reproducció per veure l'evolució.
  2. Atura l'animació per examinar una imatge.
  3. Selecciona un fotograma anterior a la línia temporal i comprova'n l'hora.
  4. Torna a l'última observació per veure les dades més recents disponibles.

La línia temporal conté fins a 14 observacions conservades: aproximadament dues hores si els intervals són regulars de deu minuts. Pot haver-hi buits per retards de la font, imatges no disponibles o problemes de descàrrega. L'aplicació comprova periòdicament si hi ha noves dades; això no implica que AEMET publiqui una imatge nova en cada comprovació. Una anàlisi IA només s'executa quan la demanes.

Torna a l’índex

5. Eco més proper

Eco més proper ≥12 dBZ indica la distància aproximada entre La Torregassa i el píxel detectat més pròxim que arriba a aquest llindar. Si l'eco cobreix la localitat, la distància pot ser zero. El càlcul es basa en la posició dels píxels; no és una mesura exacta de la vora de la pluja a terra.

Els radis de 10, 25, 50 i 100 km ajuden a situar l'activitat. L'anàlisi Local arriba fins a 100 km; els indicadors de màxims mostren també l'entorn de 10, 25 i 50 km. El bàner de proximitat pot canviar quan els ecos entren als radis de 50, 25 o 10 km. Aquest bàner és independent de les notificacions Push.

Una distància que disminueix no demostra que el mateix eco s'acosti: poden aparèixer ecos nous. Petits retorns recurrents, especialment prop de Montserrat i altres muntanyes, poden ser orogràfics. No els consideris automàticament pluja real ni interferència confirmada.

Torna a l’índex

6. Nuclis intensos

El radar agrupa ecos a partir de 42 dBZ i comprova que tinguin prou extensió o suport coherent en l'entorn. No mostra com a nucli fiable qualsevol píxel aïllat: els nuclis petits necessiten suport espacial o persistència.

La reflectivitat màxima és el retorn més fort del nucli, no la intensitat uniforme de tota la zona. La distància correspon a la part intensa més propera i la direcció situa el conjunt respecte de La Torregassa. Els identificadors serveixen per seguir els nuclis entre observacions, encara que no sempre apareguin a la targeta. Una divisió o fusió pot complicar aquest seguiment.

Compara diverses imatges per veure intensificació, debilitament o canvis d'extensió. Un nucli intens no confirma una tempesta: el radar de reflectivitat no verifica per si sol llamps, trons ni calamarsa.

Torna a l’índex

7. Moviment i trajectòries

El radar compara observacions successives per estimar desplaçaments. El moviment general dels ecos i el seguiment d'un nucli individual són informacions diferents: una fletxa global no garanteix que cada nucli segueixi aquella direcció.

Una confiança alta necessita una correspondència coherent entre imatges; una confiança moderada indica suport amb limitacions; una confiança baixa indica que el moviment és poc fiable. El programa també pot presentar un moviment probable quan encara no està consolidat.

Trajectòria encara incerta pot aparèixer si el nucli és nou, es divideix, canvia de forma, desapareix temporalment o no es pot relacionar amb observacions anteriors. No significa que estigui quiet. Una trajectòria és una extrapolació de l'evolució observada, no una arribada garantida ni un avís oficial.

Torna a l’índex

8. Notificacions Push
  1. Obre l'apartat de notificacions del radar.
  2. Prem l'opció d'activar i accepta el permís del navegador.
  3. Si està disponible, envia una prova per comprovar la recepció.
  4. Per deixar de rebre-les, utilitza l'opció de desactivar. També pots revisar els permisos del navegador.

Cal que el servidor tingui Push configurat i que el dispositiu i navegador ho permetin. Els permisos, la connexió i les restriccions del sistema poden impedir o retardar un avís.

En aquesta versió s'avisa de nuclis acceptats pel seguiment i publicats, dins de 50 km, quan entren en un nivell nou: ordinari des de 48 dBZ, molt intens des de 66 dBZ i extrem des de 72 dBZ. L'avís no exigeix que el nucli s'aproximi i pot indicar una trajectòria incerta.

Els avisos ordinaris tenen una espera global d'una hora des de l'últim avís emès, sigui del nivell que sigui. Les escalades a 66 o 72 dBZ poden avisar abans, però no es repeteix contínuament el mateix nivell del mateix fenomen. Les divisions i fusions hereten els nivells ja notificats quan el seguiment estableix la relació.

No s'envien avisos retroactius de la primera observació, de reinicis del seguiment ni de dades crítiques amb 80 minuts o més de retard. Un llindar travessat durant l'espera no queda pendent per avisar després. Cal que la subscripció sigui anterior a l'esdeveniment. Dos passos seguits per sota de 48 dBZ, o una interrupció de seguiment de més de 30 minuts, poden tancar aquell episodi. No rebre un avís no garanteix que no hi hagi risc.

Torna a l’índex

9. Meteoròleg IA

Interpreta les sis últimes observacions Local i formula una tendència orientativa de 30–60 minuts. La consulta és manual i utilitza l’API personal; obrir el mòdul no genera cap informe ni consumeix tokens facturats.

Quin mode d’anàlisi he d’escollir?

Visual independent — Recomanat

És la primera opció i queda seleccionada cada vegada que s’obre el Meteoròleg IA. Analitza visualment les sis observacions locals i pot rebre dades bàsiques de referència del radar. No utilitza les conclusions numèriques del motor de moviment en el JSON. Es recomana per a consultes habituals per senzillesa i perquè en les proves inicials ha necessitat menys tokens. El consum pot variar; no es garanteix un estalvi fix ni s’ha demostrat que pronostiqui millor.

Anàlisi completa

Combina les imatges amb els càlculs meteorològics i el seguiment dels nuclis. Pot aportar informació addicional, però habitualment comporta un consum més elevat. És una alternativa secundària i fa una sola petició.

Comparació A/B

Executa dues consultes sobre exactament les mateixes observacions, capturades una vegada. Serveix per comparar les interpretacions i és una funció principalment experimental.

Aquesta opció executarà dues peticions a OpenAI i consumirà els tokens de totes dues. Es facturen les dues peticions. En seleccionar-la apareix l’avís; en prémer «Analitzar amb IA» cal confirmar abans d’iniciar-les. Si cancel·les, no es fa cap consulta. Els modes individuals no demanen aquesta confirmació.

  1. Tria el mode; Visual independent és el predeterminat.
  2. Tria el model i raonament disponibles, com abans.
  3. Introdueix la contrasenya i prem Analitzar amb IA.
  4. Si has triat comparació, confirma l’avís del doble consum.
  5. Consulta l’informe, evidències, confiança i tokens/cost estimat. En comparar es mostren els dos informes i el total.
Exemple orientatiu d’una prova concreta
ModeTokensCost estimat
Visual independent5.1600,001244 USD
Anàlisi completa22.2520,003181 USD
Comparació A/B27.4120,004425 USD

Resultats d’una prova concreta facilitada per l’usuari, no imports fixos ni tarifes garantides. El consum i el cost poden variar. El mode visual es recomana per senzillesa i cost; no s’ha demostrat que pronostiqui millor.

Els mapes es preparen amb el sistema funcional original. Poden contenir fletxes o velocitats calculades: el prompt visual demana ignorar-les, però no es garanteix una independència visual absoluta. Els canvis d’intensitat no demostren desplaçament. Cal contrastar les interpretacions amb observacions posteriors abans d’afirmar que un mode prediu millor.

Consulta i observació tenen hores diferents; comprova l’antiguitat. No s’inventen hores d’arribada ni velocitats. Les estimacions no substitueixen els avisos oficials.

Torna a l’índex

10. Com crear un compte d'OpenAI API

ChatGPT i l'API tenen facturacions independents. Una subscripció de ChatGPT, inclòs Plus, no inclou el consum d'aquest radar. Cada persona paga les consultes fetes amb la seva clau API.

  1. Entra a platform.openai.com i inicia sessió o crea un compte. Selecciona l'organització correcta si en tens més d'una.
  2. Obre la configuració de facturació de l'API. Pots necessitar permisos de propietari o de gestió de facturació.
  3. Busca Add payment details o l'opció equivalent i introdueix el pagament. En comptes amb saldo prepagat, escull l'import inicial i confirma'l. Revisa les condicions que mostra OpenAI abans de pagar.
  4. Comprova que el saldo o la facturació estiguin actius abans de fer una anàlisi. Si ofereix recàrrega automàtica, revisa'n els imports i límits abans d'activar-la.
  5. Opcionalment, crea un projecte anomenat «Radar La Torregassa» al selector de projectes. Això facilita separar claus i consum.
  6. Consulta Usage i selecciona projecte i període. Revisa també Settings → Limits → Spend, quan estigui disponible, per establir un límit mensual i avisos.

Un avís de pressupost només notifica; no atura necessàriament el consum. Si apareix Enforce a hard limit, és una opció diferent que bloqueja noves peticions quan el consum registrat arriba al límit. La comptabilització pot tenir retard i permetre un petit excés. Comprova què has activat realment.

Els menús, permisos i opcions poden canviar. Fonts oficials verificades el 8 d'octubre de 2026: facturació separada, saldo prepagat i límits de despesa.

Torna a l’índex

11. Com obtenir una API Key
  1. Obre API Keys amb el compte i projecte correctes.
  2. Prem Create new secret key o l'opció equivalent.
  3. Posa un nom identificatiu, com «Radar La Torregassa».
  4. Revisa els permisos. És recomanable una clau específica per al radar, amb només els permisos necessaris per crear respostes i consultar els models. Una clau només de lectura no pot generar informes. Els permisos del compte i del projecte també han de permetre aquestes accions.
  5. Copia la clau quan OpenAI la mostri: el secret complet es mostra en crear-la i després pot no ser recuperable.
  6. Obre Meteoròleg IA → Configuració de la clau i introdueix-la al camp API Key. Protegeix-la com explica el capítol següent.

La clau és privada. No la comparteixis ni l'enviïs en captures. Si sospites que s'ha exposat, revoca-la a OpenAI i crea'n una altra. Utilitza controls de pressupost del projecte i comprova el consum oficial. Referència: gestió de projectes i claus.

Torna a l’índex

12. Com protegir la clau amb contrasenya

La clau es conserva xifrada al navegador amb AES-256-GCM. Aquest emmagatzematge és independent de l'historial d'informes.

La primera vegada:

  1. Introdueix la clau API.
  2. Crea una contrasenya de protecció llarga i exclusiva, de com a mínim 12 caràcters.
  3. Repeteix-la al camp de confirmació.
  4. Guarda la configuració.

Les vegades següents: obre Meteoròleg IA, introdueix la contrasenya i executa l'anàlisi. No cal la contrasenya per consultar l'historial.

Durant una consulta la clau es desxifra temporalment i s'envia per HTTPS al servidor PHP del radar perquè contacti amb OpenAI. El radar no la desa al NAS ni l'inclou als registres d'historial. Per tant, la clau sí que passa temporalment pel servidor. Cal confiar en qui administra el radar i en el dispositiu utilitzat.

Una contrasenya llarga protegeix millor la còpia xifrada, però no elimina els riscos d'un navegador compromès o d'una sessió ja desbloquejada. No utilitzis aquesta configuració en un dispositiu que no controles.

Si oblides la contrasenya, el radar no la pot recuperar: elimina la configuració local i torna a introduir una clau amb una contrasenya nova. Si no tens la clau, crea'n una altra a OpenAI. Canviar de dispositiu o esborrar les dades del navegador elimina l'accés a aquesta còpia local; també pot eliminar l'historial. Revocar una clau a OpenAI és diferent d'eliminar-la del navegador.

Torna a l’índex

13. Models OpenAI i raonament

Un model és el sistema d'intel·ligència artificial que interpreta les dades i redacta el text. El catàleg incorporat al radar conté GPT-6 Luna, GPT-6 Sol i GPT-6.1 Sol. El programa comprova quins estan disponibles per a la teva clau: tenir-los al catàleg no garanteix l'accés.

GPT-6 Luna és l'opció inicial amb tarifa estimada incorporada. Els altres models són alternatives que poden tenir altres costos o temps de resposta; el radar no garanteix una qualitat superior. Si no disposa d'una tarifa verificada, mostra el cost com a no disponible.

Els nivells implementats per Luna i Sol són none, low, medium, high, xhigh i max; GPT-6.1 Sol ofereix low, medium, high, xhigh i max. Només es poden seleccionar les opcions permeses per al model.

Un nivell més alt permet més raonament intern i pot augmentar la durada i els tokens de sortida. No assegura una previsió millor: dades antigues o una trajectòria incerta continuen sent limitacions. Mantén una opció moderada i compara resultats només quan tinguis un motiu concret.

Torna a l’índex

14. Tokens i costos

Un token és una peça de text o una unitat amb què el model comptabilitza informació. Una paraula pot ocupar un o diversos tokens; les imatges també consumeixen entrada. No hi ha una equivalència fixa amb paraules.

  • Entrada: instruccions, dades i observacions enviades.
  • Sortida total: text generat i raonament intern comptabilitzat.
  • Raonament intern: part de la sortida, quan OpenAI n'informa. No és text que es pugui llegir com un informe.
  • Total: entrada més sortida total. No tornis a sumar el raonament.
  • Cost estimat: càlcul amb els tokens i les tarifes disponibles, incloent tractaments de memòria cau quan la resposta els identifica.

Exemple històric aportat d'una consulta real: GPT-6 Luna; entrada 19.044 tokens; sortida total 907; raonament inclòs 516; total 19.951; cost estimat registrat 0,002834 USD. El total és 19.044 + 907: els 516 no s'afegeixen de nou. L'import és el que es va registrar en aquella consulta, no una tarifa garantida per a consultes futures.

Els preus poden variar. El radar mostra la moneda i no suma monedes diferents com si fossin equivalents. Una estimació no és una factura. Consulta el consum oficial a platform.openai.com/usage i la facturació d'OpenAI.

Torna a l’índex

15. Historial d'anàlisis

Des de v0.5.0.3, cada registre identifica el mode Completa o Visual independent. Les comparacions desen dos informes amb els seus consums, una referència comuna de comparació i la mateixa seqüència. Es manté el límit de 20 informes: una comparació completa ocupa dues entrades. Si s’elimina o caduca una de les dues, s’indica que la parella conservada és incompleta. Els consums desconeguts no es compten com a zero. Els informes antics continuen disponibles.

Prem Historial dins Meteoròleg IA. Es guarden automàticament les últimes 20 anàlisis completades correctament, de més recent a més antiga. En guardar-ne la 21a, s'elimina la més antiga. Els errors i les respostes incompletes no es guarden.

  1. Obre una entrada per recuperar l'informe complet.
  2. Consulta el model, el raonament, el desglossament de tokens i el cost disponible.
  3. Prem Copiar informe per copiar el text.
  4. Elimina un registre amb el seu botó.
  5. Per eliminar-los tots, prem Esborrar tot l'historial i confirma l'acció.

Consum de les consultes conservades suma només els registres encara desats: no és el consum total del teu compte ni la facturació oficial. Els costos de monedes diferents es presenten separats.

Consultar informes antics no fa peticions a OpenAI ni consumeix tokens. L'historial és exclusiu del navegador i dispositiu; no s'envia al NAS per guardar-lo. Qualsevol persona amb accés al mateix perfil del navegador pot llegir-lo sense contrasenya. No inclou claus ni credencials. Si l'emmagatzematge de l'historial falla, apareix un avís i pots continuar analitzant sense historial.

Torna a l’índex

16. Preguntes freqüents
Puc utilitzar el radar sense OpenAI? Necessito pagar per veure els mapes?
Sí, pots utilitzar les funcions radar sense compte OpenAI. Veure els mapes no consumeix tokens API.
ChatGPT Plus inclou els tokens de l'API? Qui paga les anàlisis?
No. Les paga el compte associat a la clau introduïda, amb facturació API independent.
La meva clau queda guardada al NAS?
No es desa al NAS. Es guarda xifrada al navegador, però passa temporalment pel servidor PHP durant la consulta per HTTPS.
Què passa si oblido la contrasenya?
No es pot recuperar. Esborra la configuració local i torna a configurar una clau; això no revoca la clau a OpenAI.
Puc utilitzar la mateixa clau en diversos dispositius?
Si els permisos d'OpenAI ho permeten, sí. Cal configurar i protegir una còpia a cada navegador. L'historial no se sincronitza i tot el consum es carrega al mateix compte. Una clau separada facilita el control.
Per què una anàlisi pot tenir confiança baixa?
Per imatges antigues, intervals irregulars, poca cobertura, canvis de forma o seguiment poc coherent. Tenir sis imatges no elimina aquestes limitacions.
Per què hi ha ecos sense que plogui?
La precipitació pot no arribar a terra, ser lluny de tu o haver-hi retorns del terreny. Un eco aïllat no és una comprovació de pluja al carrer.
Per què les observacions tenen retard?
Cal captar, processar, publicar i descarregar les dades. Si la font s'endarrereix, el radar no pot crear observacions noves.
Per què alguns nuclis no tenen trajectòria?
Pot faltar correspondència temporal fiable o el nucli pot haver nascut, canviat o dividit. Sense trajectòria no es pot deduir que estigui quiet.
Per què el consum d'OpenAI pot aparèixer amb retard?
La informació de facturació i els límits poden actualitzar-se amb retard. Revisa també l'organització, projecte, període i zona horària: el tauler oficial utilitza UTC. El radar mostra els tokens retornats en aquella resposta; no és una factura instantània.

Torna a l’índex