Table of Contents
class Args: Command line arguments
class FirstSight: First-sighting object
addAllSightings(): Read the input files
addFile: Read one sightings file
addSighting(): Filter and add one sighting
filterOut(): Reject records by date and location
writeReports(): Generate final reports
The American Birding Association (ABA) sanctions competitive bird listing: who has seen the most bird species? There are numerous lists.
The most inclusive is the world life list: who has seen the most bird species anyplace, ever?
Some lists are constrained by location: who has seen the most species in North America, or one state?
Some lists are constrained by time: who has seen the most birds in a calendar year?
There are combinations of time and space constraints as well: state year lists, day lists seen from a point location, and so on.
The purpose of the abalist program is to compute a fairly standard set of list totals: life lists, year lists, state lists, and state year lists.
This program depends on the author's sizeable infrastructure for managing bird records. Relevant links:
A system for representing bird taxonomy: Files describing bird classification and a system of short bird codes. We will refer to this as the xnomo system.
A system for encoding bird field notes: Covers the encoding of bird field observations for scientific purposes and a system for putting them up on the Web. In later sections we'll refer to this as the birdnotes system.
The abalist program reads the encoded field notes encoded for scientific use and interprets them according to the ABA's guidelines for countability.
Files mentioned herein are available online: