Survey Shot 3D Coordinate Calculator
Cave shot Cartesian endpoint, xEastyNorthzup, azimuth clockwise from north, inclination positive-up. Declination/calibration datum actual independently corrected; no curved map projection or adjustment.
Description
A cave survey shot relates a measured distance, azimuth and inclination to a Cartesian displacement.
A cave survey shot relates a measured distance, azimuth and inclination to a Cartesian displacement.1
The adopted frame is east, north and up, with azimuth clockwise from north and positive upward inclination.
When to use Survey Shot 3D Coordinate Calculator
Use this tool to obtain conditionalEndXyzMeters from the supplied records using the stated calculation. Establish the survey or observation scope, reference frame, units and independently applicable calibration or qualified plan.
How to use Survey Shot 3D Coordinate Calculator and understand its results
- Establish the survey or observation scope, reference frame, units and independently applicable calibration or qualified plan.
- Enter actualShotDistanceMeters, actualAzimuthDegrees, actualInclinationDegrees, actualStartXyzMeters, using the field meanings and rules below, then run the tool.
- Read result.conditionalEndXyzMeters. Use the units and sign conventions below, and review any unknown records separately.
- Correct any reported input issue and run again. Before using a successful result, check the stated units, signs, reference scope and observation coverage.
| Input field | Meaning | Value type | Requirement |
|---|---|---|---|
| actualShotDistanceMeters | Actual shot distance meters | number | Required |
| actualAzimuthDegrees | Actual azimuth degrees | number | Required |
| actualInclinationDegrees | Actual inclination degrees | number | Required |
| actualStartXyzMeters | Actual start xyz meters | list of number | Required |
Require nonnegative shot distance, azimuth in [0,360) degrees, inclination in [−90,90] degrees and exactly three finite starting coordinates in metres. Calculate displacement in the east/north/up frame and add it to the start. Corrected datum, declination and instrument calibration are external inputs.
end=start+[d×cos(i)×sin(a),d×cos(i)×cos(a),d×sin(i)] (angles converted to radians) Use the matching field units and the exact boundary, ordering and reference rules above.
| Output field | Meaning | Value type |
|---|---|---|
| result | Qualified observed calculation or explicit reference | object |
| result.conditionalEndXyzMeters | Starting coordinate plus calculated shot displacement, ordered east/north/up in metres. | list |
{
"input": {
"actualShotDistanceMeters": 5,
"actualAzimuthDegrees": 90,
"actualInclinationDegrees": 0,
"actualStartXyzMeters": [
1,
2,
3
]
},
"output": {
"result": {
"conditionalEndXyzMeters": [
6,
2.0000000000000004,
3
]
}
}
}Limitations and assumptions
The actual observation coverage, calibration and qualified plan determine applicability. A numerical result does not establish survey accuracy, route suitability, atmosphere conditions or equipment adequacy beyond the declared comparison.
Missing required fields, unknown fields, wrong types and violated rules return input issues. Numeric values and outputs must be finite. Lists and matrices must be dense, without missing cells. Numeric lists allow at most 10000 entries, subject to the narrower lengths and code rules above. Extremely large composite outputs are rejected.
Alternative or Complementary methods
For a related step, use Survey Loop Misclosure Error Calculator: A closed-loop survey ideally returns to its start in the adopted coordinate frame. For a complementary comparison, use Extended Elevation Projection Length Calculator: Extended elevation unfolds a cave survey using independently assigned left and right directions.
References
-
Survey Shot 3D Coordinate Calculator — tool.io
Similar or alternative tools
- Survey Loop Misclosure Error Calculator
A closed-loop survey ideally returns to its start in the adopted coordinate frame.
- Extended Elevation Projection Length Calculator
Extended elevation unfolds a cave survey using independently assigned left and right directions.