syohex / noaa

View an NOAA weather forecast for a specific geographic location.

noaa.el

View a simple summary of an NOAA weather forecast

The NOAA exposes a number of services which provide weather-related data. noaa.el provides an interface for viewing USA forecast data at api.weather.gov.

---

Getting started without the Emacs package manager

1. Download noaa.el.

2. Load noaa.el. For example, you might add the following line to ~/.emacs:

   (load "/path/to/noaa.el")

Configure noaa.el

If calendar-latitude and calendar-latitude are already defined, those values will be used. If they are not defined, ensure noaa-latitude and noaa-longitude are set to the desired values. For example, one might set them via ielm (M-x ielm):

;; set latitude and longitude for noaa.el
(setq noaa-latitude 45)
(setq noaa-longitude 120)

NOAA accepts coordinates as floating point numbers with up to four digits of precision (eg. 45.1234).

Use

1. Use M-x noaa to invoke noaa.

2. When done, use q to invoke noaa-quit.

Additional notes on use

• The header line lists useful keybindings

  • n to cycle through forecast view styles

  • h to view an hourly forecast

  • d to view a daily forecast (the default)

  • c to view a forecast for a different USA location.

    • You can enter a CITY, ST location string, or if you just press enter you'll be prompted for latitude and longitude coordinates.

  • q to quit

Customization

The default forecast presentation styles don't present all of the possible data available from NOAA. You can customize the styles to suit your needs by modifying variables noaa-daily-styles and noaa-hourly-styles with reference to the NOAA api. Two useful reference URLs are indicated in the source code.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

If you did not receive a copy of the GNU General Public License along with this program, see http://www.gnu.org/licenses/.