Species Example

I think this is a neat data set. I just use it for testing joins, etc, and
messing around with a pretty big database that I can screw up. On that point,
let me tell you up front that this database, with all its indexes, is a little
over 200 Megabytes. But disk space is cheap these days so it shouldn't be that
big of a deal.

Installation:
-------------

I have tried to make things very easy. This database came from an Informix
database on the Integrated Taxonomic Information System website
(http://www.itis.usda.gov). I have modified the DDL for use in SQLite (it didn't
require a lot of changes).

You can go two routes, the easy or the hard:

1. Easy: Create the database from the Sqlite ASCII dump. Download it from
   http://pysqlite.sourceforge.net/examples/itis/dump.sql.bz2. Decompress
   it, then build it in one fell swoop.

	sqlite db < dump.sql

2. Hard: Import if from the native ITIS ASCII files. I wouldn't recomment this as step
   1 is much easier, but it does serve as an example of using pysqlite to import
   data. In this case, you need to obtain the ASCII data files. You can get this from
   http://pysqlite.sourceforge.net/itis/itis.tgz.

   1. Unpack the tarball:

		tar -xzvf itis.tgz

   2. Move them into the species working directory.

   3. Create the SQLite database:

      sqlite db < schema.sql

   3. run ./insert.py. This will import them into the datbase.

   4. Viola, you've got your big wild kingdom database.

The select example is rather trivial, but I plan on working on it. I have
another python library that I intend to add will will make creating and using
joins kind of fun. That's the reason I am including this example to begin with
--- for future use.

Anyway, if you have problems, email me <mike@mikesclutter.com>.

Have a lot of fun.
