Next / Previous / Contents / Shipman's homepage

13. class BirdForm: Records for one kind of bird

Each instance of this class represents a group of one or more sightings of the same kind of bird. An instance is a container for one or more Sighting instances.

Public attributes:

.dayNotes

The parent DayNotes instance.

.birdId

An instance of class BirdId that describes what kind of bird was observed. For documentation, see the documentation for abbr.py in A system for representing bird taxonomy.

.notable

True iff this form at this time and place is out of the ordinary.

.locGroup

For the single sighting case, this attribute is None. If there is any loc-group content under the input form element, it is in the sole child Sighting.

For the multiple sighting case, if there is any loc-group content under the form element that is not inside one of the child floc elements, it is attached here as a LocGroup instance. See Section 14, “class LocGroup: Inheritable locality data”.

.sightNotes

For the single sighting case, this attribute is None. If there is any sighting-notes content, it resides in the sole child Sighting.

For the multiple sighting case, if there are any sighting-notes content under the form element that is not inside one of the child floc elements, it is attached here as a SightNotes instance. See Section 15, “class SightNotes: Sighting notes”.

13.1. BirdForm.addSighting()

To add a Sighting instance S to a BirdForm instance B:

B.addSighting(S)