We've had a number of discussions on the naming of classes as well as coming up with a core glossary. Due to a few iterations on the model and the naming discussion, there still remains some inconsistencies in our naming.
Dom's recent pass on the model also noted:
Modelling generic v specific types:
While I understand the desire to create generic conversion/conversion observation types, should consideration be given to making the general types (Conversion/ConversionObservation) abstract classes and having concrete implementations of Ratings/Gaugings? It might make the end model and encodings more intuitive and domain-friendly if concrete classes called 'Rating', 'Gauging' exist.
There are also a few inconsistencies with the general terminology Conversion/ConversionObservation versus Ratings/Gaugings. E.g. the Gaugings package should probably be called 'ConversionObservations' and the documentation refers to 'gauging observation'. It makes the model a bit hard to read when there are these undefined terms that appear (although that could just be the gaps in my domain knowledge).
I agree with this. It would be good to revisit the naming, especially before we agree on a model version for the IE.
I've pulled out a number of relevant definitions from WMO's glossary of hydrology
. These appear to be largely harmonised with the relevant ISO standards.
- 1.41 stream gauging: all of the operations necessary for the measurement of discharge.
- 1.92 rating: relation between discharge and other variables, or the taking of observations and making of calculations needed to establish the relation.
- 1.93 calibration, rating (of a station): establishment of a discharge relation with the measured variable(s).
- 2.60 rating curve: graphical representation of a stage-discharge relation or rating
- gage height--the height of the water surface above the gage datum (zero point). Gage height is often used interchangeably with the more general term, stage, although gage height is more appropriate when used with a gage reading.
- gaging station--a site on a stream, lake, reservoir or other body of water where observations and hydrologic data are obtained. The U.S. Geological Survey measures stream discharge at gaging stations.
- rating curve--A drawn curve showing the relation between gage height and discharge of a stream at a given gaging station.
NSW Office of Water
. Some definitions are sourced from the USGS glossary; I've only included ones not from there.
- Rating table:
- In most contexts, a table showing the relation between the gauge height and the discharge of a stream at a given gauging station. Also referred to as discharge table.
- Any table showing the relation between two mutually dependent quantities or variables over a given range of magnitude, e.g., a table showing the relationship between the stage in a reservoir and its volume. Nevada Division of Water Resources
- Gauging station: A site on a stream, lake, reservoir or other body of water where observations and hydrologic data are obtained. Measurements of stream discharge at gauging stations.
- Gauge height: The height of the water surface above the gauge datum (zero point). Gauge height is often used interchangeably with the more general term, stage, although gauge height is more appropriate when used with a gauge reading. Gauge heights are measured in metres (m).
Bureau of Meteorology
Fairly recently released their National Industry Guidelines for hydrometric monitoring, which includes a glossary document available here: http://www.bom.gov.au/water/standards/documents/WISBF_GL_100_00-2013.pdf
- I think we should follow these where possible, and if we deviate we should be explicit on the differences. Having an abstract conversion class, as Dom suggests, seems like a good option. Then we could have a RatingTable class in place of either ConversionTable, or as a specialisation of ConversionTable if we want to maintain an abstract separation of tables and equations. The question becomes: is a rating table specific to stage-discharge? Certainly they cover the majority of uses, but there are others like suspended-sediment rating tables.
- There are already aspects of the gaugings model that are specific to measuring discharge: FlowMeasure vocabulary, river state/conditions and parts of the ObservationArea type (gauged section line etc.).
- parameterFrom/parameterTo: Current suggestions are to change the name to: observedPropertyFrom/observedPropertyTo or phenomenonFrom/phenomenonTo to harmonise with naming within O&M. Any suggestions/comments welcome..
- 10 Sep 2013