User:Jcreer/Direction Conventions and Conversions
From XMS Wiki
Jump to navigationJump to search
SMS supports the following direction conventions:
- Cartesian: The direction FROM. The origin (0.0) indicates the direction is coming from North. It increases clockwise from North (viewed from above). This is most commonly used for wind direction.
- Meteorologic: The direction TO. The origin (0.0) indicates the direction is going to the North. It increases clockwise (like a bearing) so 45 degrees indicates a direction heading towards the North East.
- Oceanographic: The Cartesian coordinate axes as a direction TO. East, or the positive X axis, defines the zero direction. It increases in a counter clockwise direction or righthand rule. 45 degrees indicates a direction heading to the North East and 90 degrees indicates a direction heading to the North.
- Shore Normal: "TO" convention based on a Theta(grid) which defines the grid orientation relative to the positive X axis (CCW direction). So:
Theta(grid) Direction of I axis 0 East 90 North 180 West 270 South
For a shore normal grid, the direction angle is interpreted as relative to the I axis with CCW as positive. Therefore, if Theta(grid) is 0 degrees (I axis aligned with X axis) then:
0 To the east 45 To the north east -45 To the south east
When SMS converts from one convention to another the conversions always goes through Cartesian. For example, to convert from Oceanographic to Meteorologic, SMS converts from Oceanographic to Cartesian, and then from Cartesian to Meteorologic.
The conversions that are:
- Cartesian = 90 - Oceanographic
- Cartesian = 270.0 - Meteorologic
- Cartesian = ShoreNormal + GridOrientation
- Meteorologic = 270.0 - Cartesian (add or subtract 360 if out of range)
- ShoreNormal = Cartesian - GridOrientation (add or subtract 360 if out of range)
- Oceanographic = 90.0 - Cartesian (add or subtract 360 if out of range)