Gradient Ratio 1-in-N Formatter
Format signed gradient as vertical 1-in-N; level handled explicitly, not slope compliance.
Description
Format a signed rise-to-run gradient as level, up 1 in N or down 1 in N.
A gradient ratio expresses vertical change relative to horizontal run. Keeping the rise signed lets this formatter distinguish ascent, descent and level ground.
When to use this tool
Format a signed rise-to-run gradient as level, up 1 in N or down 1 in N. Use it when the input measurements and conventions below match the operation you need.
- Prepare signedRise, horizontalRun, respecting the measurement basis and boundaries below.
- Compare the worked example with your intended operation before reusing its result.
How to use the tool and how it works
- Enter every field in the input table using the stated units and exact supported selector spelling where applicable.
- Run the tool. Correct input errors before interpreting an output.
- Read the result fields below; use accompanying flags and the stated sign, boundary or model convention when interpreting a number.
horizontalRun must be positive. A zero signed rise produces the level label; otherwise the tool reports up or down and a one-in ratio equal to horizontal run divided by the absolute rise.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| signedRise | Signed rise. | Finite number |
| horizontalRun | Horizontal run. | Finite number; greater than zero |
| Output field | Interpretation |
|---|---|
| result | Object containing the following named result fields. |
| result.gradientRatio | Gradient ratio; use the stated units and sign convention. |
{
"input": {
"signedRise": 2,
"horizontalRun": 20
},
"output": {
"result": {
"gradientRatio": "up 1 in 10"
}
}
}Limitations and assumptions
- The result is based on horizontal distance and the entered sign convention. It is not a slope-distance correction, rounded construction grade or accessibility assessment.
- Every declared field is required and unexpected fields are rejected. Numeric inputs must be finite; input errors are distinct from a valid false result or an explicitly qualified output.
- Extremely large inputs and nonfinite or excessively large outputs are rejected. List positions reported by the tool use zero-based indices unless stated otherwise.
Alternative or Complementary methods
For a map-layout decision, inspect the rendered map at its intended size as well as its numerical dimensions. For classification or coordinate work, retain the chosen boundary and coordinate conventions with the result. Compare the scope of the nearby tools below before substituting one.
References
Similar or alternative tools
- Azimuth to Quadrant Bearing Formatter
Azimuth to quadrant bearing, boundary convention NE at north/east, SE at south and SW at west; 360 normalizes to north.
- aspect octant classifier
Aspect Direction Octant Classifier from Slope Components: return downhill aspect, bearing degrees.