External consumers of bird sighting data often represent
sightings as spreadsheets or database tables. To make it
easier to export data into those tools, the
FlatSighting class centralizes the most important
facts about a bird sighting into a single entity.
The constructor operates on a
Attributes of this instance:
Taxonomic key number for this kind of bird, as
described in the definition of the
First or only bird code, stripped of trailing blanks.
This code, the one in the
attribute, and the
.rel field are
documented in A system for representing bird
If this is a single-code form, contains the empty
string. If this is a compound form, contains
"|" for species pairs, or
If this is a single-code form, contains the empty string. If this is a compound form, contains the second bird code, stripped of trailing blanks.
The English name in “Generic[, Specific]” form. Examples: “Hawk, Hawaiian”; “Gadwall x Shoveler, Northern”.
The age code, or an empty string if unknown.
The sex code, or an empty string if unknown.
The countability flag: an empty string normally;
-” for ABA uncountable;
?” for unsure ID.
The count field. Note that this is not necessarily a
single number! Examples: “
#” for two
or more; “
open-ended range. For an unknown count, it holds an
empty string, which is to be interpreted as
“one or more.”
The date as
Two-character U.S. state code or other region code, capitalized. Always present.
Brief description of the general locality.
If the primary observer did not see this bird, the name of the observer who did; otherwise an empty string.
This method is available:
Return the record as a string, with the attributes in
the order shown above (
.observer), with the fields separated
by the supplied