WPWeather

In short: ========== Just get started: Unzip the file, then run "install.exe". Everything then will (hopefully) become clear. If not, here are a few details: VRWeather.exe is a GUI version of Frank Wochat's WPWeather.cmd, with a few minor enhancements: - Additional weather data: > Air pressure > Sunshine duration > Wind force of gusts - Show weather data for "Today" at a specific hour - Show weather data for any 3 days in the future - Kiosk-mode: show weather data continously at a given interval of time - Log file analysis showing the forecast accuracy of "Yesterday" for "Today". VRWeather is named as such because it was created with VX-Rexx. ============= INSTALLATION: ============= (1) Unzip the archive into a newly created directory. When unzipping, be aware that subdirectories will be created automatically. For example, use this command: unzip vrweather.zip (2) First, create a config-file: Weather.cnf: ┌───────────────────────────────────────────────────────────────┐ │PLACE=my place ; user-defined, optional, description │ │ ; or <auto> = name of DWD-station │ │CITY=anyvillage ; should exist in the City-List │ │ ; else remove this line │ │LATITUDE=54.0833 ; if no CITY -> then required! │ │LONGITUDE=12.1333 ; if no CITY -> then required! │ │ │ │Language=EN ; or DE or ES │ │ │ │ICONSET=1 ; or 2 or 3 or 4 │ │LOG=1 ; or 0 (no log files written) │ │ │ │OPTAHEAD=1 ; 0=no 1=for today 3=for all 3 days │ │CLOCK=1 ; or 0 (no display of clock) │ │ │ └───────────────────────────────────────────────────────────────┘ You may use "ProtoE.cnf" as a prototype for your "Weather.cnf". NOTE: This step is done automatically by install.exe. (3) Start VRWeather.exe: In case you have not created a file "Weather.cnf" then a dialog box will appear: "No config file found." Click OK. A dialog box will then open for creating the config file Weather.cnf. The instructions should be self-explanatory. After entering the CITY or, AT LEAST the coordinates, click SAVE. The program is now ready for use. The current weather data for today, tomorrow, and the day after tomorrow will be displayed. Optionally, you may request weather data for any date in the future. Install more city-lists (*.CLS): ----------------------- From the website www.simpleminds.com you can download a city-list for every country in the world, in csv-format. In order to make these files accessable to VRWeather you need to process it with the Rexx-script BuildCLS.cmd (which is part of this package): From the commandline: BuildCLS <country>.csv which renders a file named <country>.CLS. Note that not all of the cities in these lists have valid coordinates, which means these locations are not served by the german DWD-Agency. This holds mainly for cities not within the european community. ============= USAGE: ============= Clicking the "refresh" button retrieves the weather data again. * Kiosk-mode: To automate the updates, you can select an interval in the adjacent selection box, e.g., "2" for every 2 hours. The least of possible intervals being 0.1, i.e. 6 minutes. In that case the weather data a renewd automatically every 6 minutes so you can observe changes in your local climate by one simple glance. * Select a different location: Type any city name into the input field in the upper left corner and click the double arrow (to the right of it). If the text "not in list" is then displayed, the coordinates (latitude and longitude) must be determined manually and entered into the Weather.cnf file. maps.google.com will help you in this. * To permanently add another location to the city list: Position the mouse over the drop-down box (top left, "select city"), then open the context menu (right-click). Click on "Insert <new city> in city-list". ==> For further functions, access the context menu (right-click on an empty area of the program window). =============== and more: =============== Thanks to Frank Wochatz for providing us his "weather engine" in well-structured Rexx code and his permission to use his code in my GUI-version! Contact: Lutz.Wagner@hamburg-email.de -------------------------------------------------------------------------- ========== Ganz kurz: ========== Zip-Archiv in ein (leeres) Verzeichnis kopieren, dort entpacken: "unzip VRWeather" (legt Unterverzeichnisse automatisch an). Zum Starten "install.exe" aufrufen. (1) EINFACH LOSLEGEN: "VRWeather.exe" starten, die erforderliche Konfiguration (Erstellen einer Weather.cnf) wird im Dialog erledigt, falls install.exe vergessen wurde. Alles weitere ergibt sich (hoffentlich). Wenn nicht, lesen unter "Allgemeines" ein paar Details. (2) Konfig-Datei manuell erstellen: Die zentrale Konfigurations-Datei heißt Weather.cnf und kann mit jedem beliebigen ASCII-Editor (z.B. ae.exe) erstellt / bearbeitet werden. Sie muß etwa diesen Inhalt haben (s. auch Datei "ProtoD.cnf"): ┌───────────────────────────────────────────────────────────────┐ │PLACE=Mein Wohnort ; benutzereigene Bezeichnung, │ │ ; sonst <auto> = Name der DWD-Meßstation│ │CITY=Büdelsdorf ; wahlweise Ortsname gem. City-List │ │ ; sonst diese Zeile entfernen │ │LATITUDE=54.0833 ; wenn kein CITY -> dann erforderlich! │ │LONGITUDE=12.1333 ; wenn kein CITY -> dann erforderlich! │ │ │ │Language=DE ; oder EN oder ES │ │ │ │ICONSET=3 ; oder 1 oder 2 oder 4 │ │LOG=1 ; oder 0 (kein Log) │ │ │ │OPTAHEAD=1 ; 0=kein 1=für heute 3=für alle 3 Tage │ │CLOCK=1 ; oder 0 (keine Uhrzeit-Anzeige) │ │ │ └───────────────────────────────────────────────────────────────┘ Wichtig sind die Parameter Latitude und Longitude. City und Place müssen nicht angegeben werden. Wenn CITY nicht in der City-Liste (Germany.cls) enthalten ist, funktioniert es trotzdem, solange Latitude und Longitude korrekt angegeben sind. ============ Allgemeines: ============ VRWeather.exe ist eine GUI-Version von Frank Wochat's WPWeather.cmd, mit einigen kleinen Erweiterungen: - Wetterdaten zusätzlich: > Luftdruck > Sonnenscheindauer > Windstärke von Böen - Wetterdaten für "Heute" einer bestimmten Stunde anzeigen - Wetterdaten für einen beliebigen Tag in der Zukunft anzeigen - Log-Datei-Auswertung mit Darstellung der Vorhersage- Genauigkeit von "Gestern" für "Heute". - Ausserdem ist eine City-List beigefügt, die die Geo-Koordinaten für die 130 größten Städte Deutschlands enthält. Ausserdem einige weitere Länder. VRWeather heißt so, weil es mit Vx-Rexx erstellt wurde. ============= INSTALLATION: ============= (1) Das Zip-Archiv in ein neu angelegtes Verzeichnis entpacken. Beim Entpacken drauf achten, dass Unterverzeichnisse automatisch erstellt werden. Dafür z.B. diesen Befehl verwenden: unzip vrweather.zip (2) VRWeather starten Als erstes erscheint ein Dialog: "Keine Config-Datei gefunden" OK klicken, daraufhin öffnet sich ein Dialog zum Erstellen der Config-Datei weather.cnf Die Hinweise sollten selbsterklärend sein. Nach erfolgter Erfassung der CITY und ggf. der Koordinaten SAVE klicken. Danach ist das Programm betriebsbereit. Es werden die momentan aktuellen Wetterdaten für heute, morgen und übermorgen angezeigt. Weitere Länder mit Städten und ihren Koordinaten installieren: -------------- Die Website www.simplemaps.com bietet für alle Länder der Welt Listen mit den wichtigsten Städten und ihren Koordinaten, u.a. im CSV-Format. Die gewünschte Liste downloaden, ins VRWeather-Verzeichnis kopieren, dann mit dem hier beigefügten Rexx-Script BuildCLS.cmd installieren: Aufruf: BuildCLS <land>.csv Bitte zu beachten: Nicht alle Städte in diesen Listen enthalten gültige Koordinaten, in dem Sinne dass sie nicht von DWD-Wetterstationen bedient werden. Das betrifft vor allem außer-europäische Länder. ============= ANWENDUNG: ============= Ein Klick auf den "aktualisieren"-Button holt die Wetterdaten erneut. * Kiosk-Modus: Um das Aktualisieren zu automatisieren, kann in der nebenstehenden Auswahlbox ein Interval ausgewählt werden, z.B. "2" für alle 2 Stunden. Das kleinst-mögliche Interval ist 0.1 (also 6 Minuten). In diesem Fall werden die Wetterdaten alle 6 Minuten erneut abgefragt, ausser4dem die angefragte Stunde um 1 erhöht. * Einen anderen Ort auswählen: In das Eingabefeld links oben einen beliebigen Ortsnamen eintippen und auf den Doppelpfeil (rechts daneben) klicken. Falls dann der Text "not in list" ausgegeben wird, müssen die Koordinaten (LATITUDE und LONGITUDE) manuell ermittelt und in die Datei Weather.cnf eingetragen werden. Google Maps (maps.google.com) kann dabei behilflich sein. * Einen anderen Ort dauerhaft in die City-List eintragen: Maus über der DropDown-Box (links oben) positionieren, dann KontextMenü aufrufen (rechte Maustaste). Klick auf "Insert <neue city> in city-list". Dabei werden die Koordinaten verwendet, die aktuell in der weather.cnf stehen. * Das Farbschema anpassen: Die Hintergrundfarben der jeweiligen Fenster können leicht modifiziert und an den eigenen Geschmack angepaßt werden: OS/2-Farbpalette öffnen, beliebige Farbe auswählen und auf das zu ändernde Programm-Objekt ziehen. ==> Für weitere Funktionen das Kontext-Menü aufrufen (rechte Maustaste auf einem freien Bereich des Programmfensters klicken). ================ TROUBLESHOOTING: ================ Wenn irgendwas schiefläuft (Programm-Absturz, Wetterdaten "N/A" oder nullen) ist in aller Regel eine der beiden möglichen Ursachen schuld: (1) Keine Internetverbindung. (2) Keine gültigen Koordinaten in der Konfig-Datei (weather.cnf). Eine CITY oder PLACE müssen nicht zwingend angegeben werden. Entscheidend ist immer der korrekte Inhalt der Parameter LATITUDE=xx.xxxx und LONGITUDE=yy.yyyy (Längengrad, Breitengrad) =============== und sonst noch: =============== Danke an Frank Wochatz für seine "Wetter-Engine" in gut strukturiertem Rexx-Code und seine Erlaubnis, sie zu nutzen! Kontakt: Lutz.Wagner@hamburg-email.de -------------------------------------------------------------------------- ----------------------- Bienvenido a VRWeather: ----------------------- Por primero, debes usar "install.exe" para crear una ficha "Weather.cnf". Para usar VRWeather.exe, es necessario tener una ficha "Weather.cnf". En caso de no ejecutar "Install.exe" debes crear una ficha "Weather.cnf" manualmente, como descrito en continuación: ┌───────────────────────────────────────────────────────────────┐ │PLACE=mi lugar ; opcional. No tiene función, solo │ │ ; O <auto> = nombre de la DWD-estation │ │CITY=Barcelona ; debe estar contenido in <pais>.cls │ │ ; si no: eliminar esta linea │ │LATITUDE=49.0833 ; si no hay CITY -> NECESSARIO! │ │LONGITUDE=12.1333 ; si no hay CITY -> NECESSARIO! │ │ │ │Language=ES ; oder EN oder DE │ │ │ │ICONSET=1 ; o 2 o 3 o 4 (para selecionar los icons│ │LOG=1 ; o 0 (no Log) │ │ │ │OPTAHEAD=1 ; 0=no 1=hoy 3=todos los 3 dias │ │CLOCK=1 ; │ │ │ └───────────────────────────────────────────────────────────────┘ Como modelo para esta ficha puede usar "ProtoS.cnf". Puede editarlo y guardar como "Weather.cnf". Si no conoce sus coordenadas, puede intentar de localizar su lugar en la City List (lista de ciudades), por ejemplo Spain.cls. Si lo encuentra solo debes ingresar el nombre de esta ciudad como parametro CITY=xxxxx. Para saber las coordenadas (Latitude,Longitude) de su lugar puede preguntarle a su IA (ChapGPT, Gemini ...) ============ En general: ============ VRWeather está basado en el programa "wpweather.cmd", creado por Frank Wochatz, publicado originalmente en os2.org. VRWeather solamente pone una GUI encima del los resultados rendido por wpweather.cmd, en vez de presentarlos en el WPS. Adicionalmente, muestra algunos más datos del clima actual. Además ofrece varias listas de ciudades con sus coordenadas (*.cls). Como añadir otras listas de ciudades (pais): Vease al programa "BuildCLS.cmd". Se puede usarlo para generar nuevas fichas de "<pais>.cls" desde fichas de *.csv de la pagina web www.simplemaps.com. Ten en cuenta que no todas las ciudades en esas listas tienen coordenadas validas, en el sentido que estén servidas por el DWD (estación del clima de Alemania). Sobre todo ellas afuera de Europa. ===== Por todas las funciones del programa "VRWeather.exe" invoque el menu del contexto (botón derecho del ratón). Contacto: Lutz.Wagner@hamburg-email.de