Imported from archive.
[weather.git] / FAQ
1 FREQUENTLY ASKED QUESTIONS ABOUT THE WEATHER UTILITY
2
3 Copyright (c) 2006-2008 Jeremy Stanley <fungi@yuggoth.org>.
4 Permission to use, copy, modify, and distribute this software is
5 granted under terms provided in the LICENSE file distributed with
6 this software.
7
8
9 Table of Contents:
10
11 1. Can I help?
12 2. How do I figure out my local METAR station ID?
13 3. How do I figure out my local city name and state abbreviation?
14 4. I live outside the USA--can this be made to work for me
15    anyway?
16 5. Why do I get the wrong forecast when specifying -i or --id?
17
18
19 1. Can I help?
20  
21 Sure! Bug reports and feature suggestions are always welcome, but
22 fixes and patches are of course preferred. Contact
23 fungi@yuggoth.org if desired, but please read this FAQ and the
24 included manuals for weather(1) and weatherrc(5) before asking
25 questions that might be answered therein. One big way anyone can
26 help is to provide me with some additional mappings of METAR
27 station ID, city name and state abbreviation for inclusion in the
28 default /etc/weatherrc file.
29
30
31 2. How do I figure out my local METAR station ID?
32
33 The list of stations is found at
34 http://weather.noaa.gov/data/nsd_cccc.gz (it's thousands of lines
35 long, so I recommend keyword searching in your browser or using
36 grep(1) to find what you're looking for).
37
38
39 3. How do I figure out my local city name and state abbreviation?
40
41 The forecasts can be located starting from
42 http://weather.noaa.gov/pub/data/forecasts/city/ (choose the
43 state abbreviation to get to a list of cities in that state).
44
45
46 4. I live outside the USA--can this be made to work for me
47 anyway?
48
49 METAR station IDs can be found for cities and airports worldwide,
50 but forecast data is harder to come by. If you have any
51 recommendations of forecast data for other countries available in a
52 format like NOAA's, I will be happy to try and find a way to
53 integrate it into the weather utility, but I suspect that some
54 serious modification would be necessary given that the data is
55 likely to be published in a non-English language, requiring some
56 additional input from speakers of that language for how to handle
57 filtering and formatting of the text.
58
59
60 5. Why do I get the wrong forecast when specifying -i or --id?
61
62 The -i or --id switch (or the id parameter in an alias definition),
63 only tells weather(1) what current conditions to retrieve. If you
64 specify -f or --forecast on the command line (or forecast=True in
65 an alias) without providing a city name and state abbreviation
66 (-c/--city and -s/--st, or city and st in an alias) and are seeing
67 an actual forecast, then you probably have a default city and state
68 abbreviation set in your config. See question 3 above for
69 information on figuring out what city name and state abbreviation
70 to use, and the manual for weatherrc(5) for information on defining
71 aliases.