Skip to Content

Site Data

Site data has been divided into two groups (subfolders): Locations and Gauges. Gauges have additional tags that describe the time series contained in the file. Files are in ASCII format, however, the files are compressed using the LZW algorithm. Note that text editors such as VI can edit this files directly. In addition, Java includes libraries to read and write compressed files. The specific tags for ech type of files are described in the following sections.

The files can be grouped in directories for different types of time series (e.g, streamflow, precipitation, temperature, etc.), however this is not required.

LOCATIONS

A Location is described by an ASCII file that contains all the information necessary to describe it. Currently there are 10 tags, which are detailed detail here:

  1. [type]: An indicator such as City, GPS Location, Survey point, etc.
  2. [source]: The source for the data (e.g., USGS).
  3. [site name]: The name of the location.
  4. [county]: County.
  5. [state]: State.
  6. [latitude (deg:min:sec)]: Given in the deg:min:sec format (e.g. 39:33:49.50 N)
  7. [longitude (deg:min:sec)]: Given in the deg:min:sec format (e.g. 110:33:49.50 W)
  8. [altitude ASL (m)]: Altitude over sea level.
  9. [images]: A list of images associated to the location. If the image is in a file the path is given relative to the location of the Location file. The image can also be a URL. After the path, followd by a semicon there must be a description of the image.
  10. [information]: Any additional information about the site.

A example location can be found here.

GAUGES

A Gauge is described by an ASCII file that contains all the information necessary to describe it. Currently there are fifteen tags, which are detailed detail here:

  1. [code]: A string of ascii characters with the gauge code. Codes are typically assigned by the source agency.
  2. [agency]: The source agency (e.g. NOAA, USGS, etc)
  3. [type]: The type of data contained in the file (e.g. Streamflow, Precipitation, Temperature).
  4. [site name]: A name for the gauge.
  5. [stream name]: This tag is mainly for streamflow locations.
  6. [county]: County
  7. [state]: State
  8. [data source]: A brief description of how the data was obtained.
  9. [latitude (deg:min:sec)]: Given in the deg:min:sec format (e.g. 39:33:49.50 N)
  10. [longitude (deg:min:sec)]: Given in the deg:min:sec format (e.g. 110:33:49.50 W)
  11. [altitude ASL (m)]: Altitude over sea level.
  12. [drainage area (km^2)]: Upstream accumulated area
  13. [data units]: use the STN units system
  14. [data accuracy]: use the STN units system
  15. [data (yyyy.mm.dd.hh.mm.ss value)]: The actual data.

A example location can be found here.

Last modified on January 18th, 2013
Posted on January 18th, 2013