Document correlation set rebuilding process
* INSTALL: Add a new section documenting the way in which newer correlation data sets can be rebuilt and substituted for officially distributed copies.
This commit is contained in:
40
INSTALL
40
INSTALL
@@ -2,7 +2,7 @@
|
|||||||
Basic Unix Installation Instructions for the Weather Utility
|
Basic Unix Installation Instructions for the Weather Utility
|
||||||
==============================================================
|
==============================================================
|
||||||
|
|
||||||
:Copyright: (c) 2006-2012 Jeremy Stanley <fungi@yuggoth.org>. Permission
|
:Copyright: (c) 2006-2014 Jeremy Stanley <fungi@yuggoth.org>. Permission
|
||||||
to use, copy, modify, and distribute this software is
|
to use, copy, modify, and distribute this software is
|
||||||
granted under terms provided in the LICENSE file distributed
|
granted under terms provided in the LICENSE file distributed
|
||||||
with this software.
|
with this software.
|
||||||
@@ -66,3 +66,41 @@ Manuals
|
|||||||
Optionally, the weather.1 and weatherrc.5 files can be placed in sane
|
Optionally, the weather.1 and weatherrc.5 files can be placed in sane
|
||||||
locations for TROFF/NROFF manual files on your system (for example,
|
locations for TROFF/NROFF manual files on your system (for example,
|
||||||
/usr/local/share/man/ or ~/man/).
|
/usr/local/share/man/ or ~/man/).
|
||||||
|
|
||||||
|
Updating Correlation Sets
|
||||||
|
-------------------------
|
||||||
|
The version control repository and tarballs are occasionally updated
|
||||||
|
with refreshed correlation sets (the files which track what the nearest
|
||||||
|
stations and weather zones are to various places). If you find you need
|
||||||
|
to generate updated correlation sets yourself, however, it can be done.
|
||||||
|
|
||||||
|
You'll need to retrieve the most recent source databases from the
|
||||||
|
different sites mentioned in the comments at the top of a recent
|
||||||
|
correlation data file--each one includes a comment block with a list of
|
||||||
|
the origins and checksums of the data files used along with the date and
|
||||||
|
time they were built. You'll also want to generate recent slist and
|
||||||
|
zlist files (look at the comments at the top of each for the shell
|
||||||
|
commands used to generate them). You probably also need the most recent
|
||||||
|
overrides.conf from the weather source repository or tarball, since that
|
||||||
|
contains known corrections for errors in the original data. Put all of
|
||||||
|
these files in your current working directory and then call::
|
||||||
|
|
||||||
|
weather --build-sets
|
||||||
|
|
||||||
|
Then wait, and wait, and wait some more. After loading and analyzing the
|
||||||
|
source data, it will guess an upper-bound for the number of great-arc
|
||||||
|
distance calculations it may have to perform and attempt to give you a
|
||||||
|
progress bar indicating percent completion. If you're lucky, it will
|
||||||
|
finish successfully also generate some automated quality assurance
|
||||||
|
analysis of the results (mostly checking for obviously bad airports,
|
||||||
|
stations, zones). If you are UNlucky, it will break, which is not
|
||||||
|
terribly uncommon because the government-provided source data is often
|
||||||
|
misformatted or gets sudden schema changes requiring updates to the
|
||||||
|
parsing routines in weather.
|
||||||
|
|
||||||
|
If you're using a system-wide (for example, distribution packaged) copy
|
||||||
|
of weather and its data, you may want to place the new airports,
|
||||||
|
stations, places, zctas and zones files into your ~/.weather directory
|
||||||
|
and make use of the setpath configuration or command-line options to
|
||||||
|
override where weather looks for them. See the weather(1) and
|
||||||
|
weatherrc(5) manpages for details.
|
||||||
|
|||||||
Reference in New Issue
Block a user