Package pygeodesy :: Module resections
[frames] | no frames]

Module resections

#-Point resection functions ciassini, collins, pierot and tienstra.


Version: 21.10.23

Classes
  Collins5Tuple
5-Tuple (pointP, pointH, a, b, c) with survey pointP, auxiliary pointH, each an instance of pointA's (sub-)class and triangle sides a, b and c in meter, conventionally.
  ResectionError
Error raised for resection issues.
  Tienstra7Tuple
7-Tuple (pointP, A, B, C, a, b, c) with survey pointP, interior triangle angles A, B and C in degrees and triangle sides a, b and c in meter, conventionally.
Functions
 
cassini(pointA, pointB, pointC, alpha, beta, useZ=False)
3-Point resection using Cassini's method.
 
collins(pointA, pointB, pointC, alpha, beta, useZ=False)
3-Point resection using Collins' method.
 
tienstra(pointA, pointB, pointC, alpha, beta=None, gamma=None, useZ=False)
3-Point resection using Tienstra's formula.
Variables
  __all__ = _ALL_LAZY.resections
Function Details

cassini (pointA, pointB, pointC, alpha, beta, useZ=False)

 

3-Point resection using Cassini's method.

Arguments:
  • pointA - First point (Cartesian, Vector3d, Vector3Tuple, Vector4Tuple or Vector2Tuple if useZ=False).
  • pointB - Second point (Cartesian, Vector3d, Vector3Tuple, Vector4Tuple or Vector2Tuple if useZ=False).
  • pointC - Center point (Cartesian, Vector3d, Vector3Tuple, Vector4Tuple or Vector2Tuple if useZ=False).
  • alpha - Angle subtended by triangle side pointA to pointC (degrees, non-negative).
  • beta - Angle subtended by triangle side pointB to pointC (degrees, non-negative).
  • useZ - If True, use and interpolate the Z component, otherwise force z=0 (bool).
Returns:
Survey point, an instance of pointA's (sub-)class.
Raises:
  • ResectionError - Near-coincident, -colinear or -concyclic points or negative or invalid alpha or beta.
  • TypeError - Invalid pointA, pointB or pointM.

Note: PointC is between pointA and pointB, typically.

See Also: Three Point Resection Problem and functions pygeodesy.collins and pygeodesy.tienstra.

collins (pointA, pointB, pointC, alpha, beta, useZ=False)

 

3-Point resection using Collins' method.

Arguments:
  • pointA - First point (Cartesian, Vector3d, Vector3Tuple, Vector4Tuple or Vector2Tuple if useZ=False).
  • pointB - Second point (Cartesian, Vector3d, Vector3Tuple, Vector4Tuple or Vector2Tuple if useZ=False).
  • pointC - Center point (Cartesian, Vector3d, Vector3Tuple, Vector4Tuple or Vector2Tuple if useZ=False).
  • alpha - Angle subtended by triangle side pointA to pointC (degrees, non-negative).
  • beta - Angle subtended by triangle side pointB to pointC (degrees, non-negative).
  • useZ - If True, use and interpolate the Z component, otherwise force z=0 (bool).
Returns:
Collins5Tuple(pointP, pointH, a, b, c) with survey pointP, auxiliary pointH, each an instance of pointA's (sub-)class and triangle sides a, b and c.
Raises:
  • ResectionError - Near-coincident, -colinear or -concyclic points or negative or invalid alpha or beta.
  • TypeError - Invalid pointA, pointB or pointM.

Note: PointC is between pointA and pointB, typically.

See Also: Collins' methode and functions pygeodesy.cassini and pygeodesy.tienstra.

tienstra (pointA, pointB, pointC, alpha, beta=None, gamma=None, useZ=False)

 

3-Point resection using Tienstra's formula.

Arguments:
  • pointA - First point (Cartesian, Vector3d, Vector3Tuple, Vector4Tuple or Vector2Tuple if useZ=False).
  • pointB - Second point (Cartesian, Vector3d, Vector3Tuple, Vector4Tuple or Vector2Tuple if useZ=False).
  • pointC - Third point (Cartesian, Vector3d, Vector3Tuple, Vector4Tuple or Vector2Tuple if useZ=False).
  • alpha - Angle subtended by triangle side pointB to pointC (degrees, non-negative).
  • beta - Angle subtended by triangle side pointA to pointC (degrees, non-negative) or None if gamma is not None.
  • gamma - Angle subtended by triangle side pointA to pointB (degrees, non-negative) or None if beta is not None.
  • useZ - If True, use and interpolate the Z component, otherwise force z=0 (bool).
Returns:
Tienstra7Tuple(pointP, A, B, C, a, b, c) with survey pointP, an instance of pointA's (sub-)class and triangle angles A, B and C in degrees and triangle sides a, b and c.
Raises:
  • ResectionError - Near-coincident, -colinear or -concyclic points or sum of alpha, beta and gamma not 360 or negative alpha, beta or gamma.
  • TypeError - Invalid pointA, pointB or pointC.