Development Page--Not for Official Use

NAME

        StnAttr() - retrieve station attributes 

SYNOPSIS

        %stn = StnAttr($gmt,$stnid);

DESCRIPTION

StnAttr() retrieves the attributes for the station given by $stnid at the time specified by $gmt. $stnid is any unique station identifier such as '001', 'NAVALA', or '87753211'. $gmt is the number of seconds since 1 Jan 1970 00:00:00 UTC. The result of PDB::StnAttr() is a hash containing the attributes from the station attribute file (PDB::PHAROSDB/var/stnattr.dat).

If $stnid specifies a nonexistent station, the returned hash is empty. Thus one can test for a valid station by

        %stn = PDB::StnAttr($gmt,$stnid);
        unless (%stn) { die "Invalid station\n"; }

The commonly available attributes for all stations include

        pwl ==> sig:out:cla:clb
        vlx ==> vly:vlz
        wsd ==> wdr:wgt

• id

The DNR three-character identifier for the station (e.g., "001").

• name

The printable name of the station (e.g, "Naval Air Station").

• abbr

The abbreviation normally associated with the station (e.g., "NAVALA").

• bay

The bay or water body in which the station is located.

• class

A colon-separated list of classes to which the station belongs (e.g., ":active:qc:cbi:"). Certain attributes in the attribute file automatically imply other attributes.

This was done to make the attribute file a little cleaner.

<< Stat | PerlModules | URLDecode >>

DNRDocs.SoftwareDocumentation