FAQ

   1 ======================================================
   2  Frequently Asked Questions About the Weather Utility
   3 ======================================================
   4
   5 :Copyright: (c) 2006-2010 Jeremy Stanley <fungi@yuggoth.org>. Permission to
   6             use, copy, modify, and distribute this software is granted under
   7             terms provided in the LICENSE file distributed with this software.
   8
   9 .. contents::
  10
  11 1. Can I help?
  12 --------------
  13 Sure! Bug reports and feature suggestions are always welcome, but fixes and
  14 patches are of course preferred. Contact fungi@yuggoth.org if desired, but
  15 please read this FAQ and the included manuals for weather(1) and weatherrc(5)
  16 before asking questions that might be answered therein. One big way anyone can
  17 help is to provide me with some additional mappings of METAR station ID, city
  18 name and state abbreviation for inclusion in the default /etc/weatherrc file.
  19
  20 2. How do I figure out my local METAR station ID?
  21 -------------------------------------------------
  22 The list of stations is found at http://weather.noaa.gov/data/nsd_cccc.gz (it's
  23 thousands of lines long, so I recommend keyword searching in your browser or
  24 using grep(1) to find what you're looking for). From time to time, the
  25 compression on their site seems to be failing, resulting in zero-byte files. If
  26 you run into this issue, you can get uncompressed and zip-compressed versions
  27 by replacing the "gz" suffix in the URL with "txt" or "zip" respectively. The
  28 list can also be obtained from the following URLs in a pinch, though they are
  29 not guaranteed to be up to date (thanks Celejar!):
  30
  31  * http://www.rap.ucar.edu/weather/surface/stations.txt
  32  * http://aviationweather.gov/adds/metars/stations.txt
  33
  34 3. How do I figure out my local city name and state abbreviation?
  35 -----------------------------------------------------------------
  36 The forecasts can be located starting from
  37 http://weather.noaa.gov/pub/data/forecasts/city/ (choose the state abbreviation
  38 to get to a list of cities in that state).
  39
  40 4. I live outside the USA--can this be made to work for me anyway?
  41 ------------------------------------------------------------------
  42 METAR station IDs can be found for cities and airports worldwide, but forecast
  43 data is harder to come by. If you have any recommendations of forecast data for
  44 other countries available in a format like NOAA's, I will be happy to try and
  45 find a way to integrate it into the weather utility, but I suspect that some
  46 serious modification would be necessary given that the data is likely to be
  47 published in a non-English language, requiring some additional input from
  48 speakers of that language for how to handle filtering and formatting of the
  49 text.
  50
  51 5. Why do I get the wrong forecast when specifying -i or --id?
  52 --------------------------------------------------------------
  53 The -i or --id switch (or the id parameter in an alias definition), only tells
  54 weather(1) what current conditions to retrieve. If you specify -f or --forecast
  55 on the command line (or forecast=True in an alias) without providing a city
  56 name and state abbreviation (-c/--city and -s/--st, or city and st in an alias)
  57 and are seeing an actual forecast, then you probably have a default city and
  58 state abbreviation set in your config. See question 3 above for information on
  59 figuring out what city name and state abbreviation to use, and the manual for
  60 weatherrc(5) for information on defining aliases.
  61
  62 6. Where can I get a list of the NWS advisory zones for alerts?
  63 ---------------------------------------------------------------
  64 The lists of advisory zones by region are found aggregated at
  65 http://weather.noaa.gov/pub/data/zonecatalog.curr.tar (it's several thousand
  66 files totalling well over a hundred thousand lines of text, so I recommend
  67 downloading, unpacking and using a recursive grep(1) to find what you're
  68 looking for).