Utilities for use with SPLAT! software are found under the
splat-1.1.0/utils directory.  They include the following:

citydecoder
===========
This utility reads U.S. Census Bureau files of Incorporated Places/Census
Designated Places, and generates city/site data files for use with SPLAT!
software.  Files for use with this utility are available for download
free of charge from:

	http://www.census.gov/geo/www/cob/bdy_files.html.

Please select the ARC/INFO Ungenerate (ASCII) Metadata Cartographic Boundary
Files from this site and unzip them prior to importing them to citydecoder.
U.S. Census files are cataloged by the two digit FIPS code for the region
(state) they represent.  citydecoder takes as an argument the two-letter
file prefix plus the FIPS code of the region or state being processed.
For example:

	citydecoder pl34

reads files "pl34_d00.dat" and "pl34_d00a.dat" that are extracted after
the downloaded file has been unzipped, and generates a list of city names
and geographical coordinates for the state of New Jersey (FIPS code 34).
This data may be sorted and written to a file (cities.nj.dat) in the
following manner:

	citydecoder pl34 | sort > cities.nj.dat

A list of FIPS codes (fips.txt) is included under splat/utils for your
convenience.


usgs2sdf
========
The usgs2sdf utility takes as an argument the name of an uncompressed
and record delimited Digital Elevation Model Data (DEM) downloaded from
the US Geological Survey, and generates a SPLAT Data File (SDF) compatible
with SPLAT! Software.  usgs2sdf may be invoked manually, or via the
postdownload script.


postdownload
============
postdownload is a front-end to the usgs2sdf utility.  postdownload
takes as an argument the name of the gzipped Digital Elevation Model
(DEM) downloaded from the US Geological Survey (ie: wilmington-w.gz).
postdownload uncompresses the DEM file, adds necessary record delimiters,
and invokes usgs2sdf to produce a SPLAT Data File (SDF).

Digital Elevation Models may be downloaded from:

     http://edcsgs9.cr.usgs.gov/glis/hyper/guide/1_dgr_demfig/index1m.html

Invoke postdownload with the name of each DEM file downloaded to
produce a database of SPLAT Data Files.


fontdata
========
The fontdata utility reads Slackware gzipped console font data
to create the fontdata.h file required for compilation of SPLAT!.
Font data of the type needed by this utility may be found under
/usr/lib/kbd/consolefonts (Slackware < 8), or under
/usr/share/kbd/consolefonts (Slackware >= 8.0).

A default fontdata.h file is already included in with SPLAT!, and is
a derivative of the s.fnt console font type available under Slackware.
fontdata takes as an argument the name of the file containing the
gzipped compressed console fonts:

	fontdata s.fnt.gz


Building The Utilities
======================
Normally, these utilities are built and installed along with SPLAT!
when SPLAT!'s ./configure script is invoked.  However, if you modify
them and/or wish to build and install them separately, here is how it's
done.  First, invoke the "build" script to compile each or all utilities
in this directory by name.  For example:

	./build citydecoder

compiles citydecoder only, while

	./build all

compiles all utilities.


Installing The Utilities
========================
Invoke the "install" script to install each or all utilities in this
directory by name.  For example:

	./install citydecoder

installs citydecoder only, while

	./install all

installs all utilities.

You need to be 'root' to install any or all of these utilities.

---
John A. Magliacane, KD2BD
January 2004

