home 

pt-count


SYNOPSIS

 pt-count.pl [options] [-p waypointfile] [-l listfile] infile
 Options:
 -a    Include all species.
       Create empty rows for species not recorded in infile.
 -l file   Read species symbols and names from file.
           Defaults to "species.txt".
 
 -O sym  Output a column for species encountered other than
         at the survey points.  The column will contain the
         symbol sym for each such species.
 -n    Use names.
       Output descriptive names of species, instead of symbols.
 -p file  Read coordinates of survey points from file.
 -r N   Treat the coordinates as decimal numbers,
        and round to N places.  Otherwise, output the
                coordinates unchanged.
 -u   Append unrecognized symbols.
      For symbols not in the species list file,
      treat them as additional species at the end of the list.
 -w   Include an additional time/weather summary.
 -z   Use zero to represent "not recorded".
      Output "0" instead of an empty string,
      for points where a species was not encountered


SAMPLE INPUT

 The list file:
 --
 amke American Kestral
 noca Northern Cardinal
 cach Carolina Chickadee
 bcti Black-crested Titmouse
 --
 The waypoint file:
 The names of the waypoints (the third field)
 must end with numbers, and must be be in
 numerical order, starting with 1.
 --
 WP,D,p1 , 30.215629, -97.650457
 WP,D,p2 , 30.212995, -97.645430
 --
 The point count data file:
 Lines beginning with '#' are comments, and lines
 beginning with '$' separate points.
 If the first line for a point begins with a
 number, it is assumed to be the time; the
 remainder of the line may contain weather info
 in the order shown (with any trailing part
 omitted).
 --
 # time temp[f] wind clouds[%]
 715 67 0 100
 noca
 cach 2
 $
 732 67f s/5 100%
 noca 5
 bcti 2
 amke
 --


SAMPLE OUTPUT

 The output fields are tab-separated.
 Lines are sorted by the order in the species list file.
 --
 lat:   30.215629       30.212995
 long:  -97.650457      -97.645430
 time   715     732
 temp   67      67
 wind   none    S/5
 clouds 100     100
 American Kestral               1
 Northern Cardinal      1       5
 Carolina Chickadee     2
 Black-crested Titmouse         2
 totals:        3       8
 --