Next / Previous / Contents / Shipman's homepage

Abstract

Describes a system for counting birds according to the rules of the American Birding Association.

This publication is available in Web form and also as a PDF document. Please forward any comments to john@nmt.edu.

Table of Contents

1. Introduction
1.1. How to get this publication
2. Operation of abalist
3. What is meant by ABA countable?
4. Internals of abalist
4.1. Prologue
4.2. class Args: Command line arguments
4.3. class FirstRecordSet
4.4. Class prologue
4.5. FirstRecordSet.addSight()
4.6. FirstRecordSet.purgeUncountables()
4.7. FirstRecordSet.__purgeCheck()
4.8. FirstRecordSet.__purgeAncestors()
4.9. FirstRecordSet.__removeSight()
4.10. FirstRecordSet.__promoteForm()
4.11. FirstRecordSet.genPhylo()
4.12. FirstRecordSet.genByDate()
4.13. FirstRecordSet.__init__()
4.14. class FirstSight: First-sighting object
4.15. addAllSightings(): Read the input files
4.16. addFile: Read one sightings file
4.17. addSighting(): Filter and add one sighting
4.18. filterOut(): Reject records by date and location
4.19. writeReports(): Generate final reports
4.20. Main program

1. Introduction

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:

The abalist program reads the encoded field notes encoded for scientific use and interprets them according to the ABA's guidelines for countability.

1.1. How to get this publication

This publication is available in Web form and also as a PDF document. Please forward any comments to tcc-doc@nmt.edu.

Files mentioned herein are available online: