Angles¶

Angle Types¶

GeodePy supports Angular Notation in 9 different formats

ABRV	FORMAT (type)
rad	Radians (stored as float)
dec	Decimal Degrees (stored as float)
dec	Decimal Degrees (via DECAngle class)
hp	Hewlett Packard (HP) Notation (stored as float)
hpa	Hewlett Packard (HP) Notation (via HPAngle class)
gon	Gradians (stored as float)
gona	Gradians (via GONAngle class)
dms	Degrees, Minutes and Seconds Notation (via DMSAngle class)
ddm	Degrees and Decimal Minutes Notation (via DDMAngle class)

Conversion between all formats is supported as shown below:

Radians to/from Decimal Degrees via built in math.radians and math.degrees
Formats as floats to all other types via functions in the form abrv2abrv

e.g. gon2hpa()
DECAngle, HPAngle, GONAngle, DMSAngle and DDMAngle class objects via methods in the form CLASS.abrv()

e.g. HPAngle(value).dec()

All angle classes can be seen below:

class geodepy.angles.DECAngle(dec_angle=0.0)[source]¶

Class for working with angles in Decimal Degrees

Note: GeodePy also supports working with angles in Decimal Degrees as floats

Parameters:: dec_angle – float Decimal Degrees angle

ddm()[source]¶

Convert to Degrees, Decimal Minutes Object

Returns:: Degrees, Decimal Minutes Object
Return type:: DDMAngle

dec()[source]¶

Convert to Decimal Degrees (float)

Returns:: Decimal Degrees
Return type:: float

dms()[source]¶

Convert to Degrees, Minutes, Seconds Object

Returns:: Degrees, Minutes, Seconds Object
Return type:: DMSAngle

gon()[source]¶

Convert to Gradians (float)

Returns:: Gradians
Return type:: float

gona()[source]¶

Convert to Gradians (class)

Returns:: Gradians
Return type:: GONAngle

hp()[source]¶

Convert to HP Notation

Returns:: HP Notation (DDD.MMSSSS)
Return type:: float

hpa()[source]¶

Convert to HP Notation (class)

Returns:: HP Notation (DDD.MMSSSS)
Return type:: HPAngle

rad()[source]¶

Convert to radians

Returns:: radians
Return type:: float

class geodepy.angles.HPAngle(hp_angle=0.0)[source]¶

Class for working with angles in Hewlett-Packard (HP) format

Note: GeodePy also supports working with angles in HP format as floats

Parameters:: hp_angle – float HP angle

ddm()[source]¶

Convert to Degrees, Decimal Minutes Object

Returns:: Degrees, Decimal Minutes Object
Return type:: DDMAngle

dec()[source]¶

Convert to Decimal Degrees (float)

Returns:: Decimal Degrees
Return type:: float

deca()[source]¶

Convert to Decimal Degrees (class)

Returns:: Decimal Degrees
Return type:: DECAngle

dms()[source]¶

Convert to Degrees, Minutes, Seconds Object

Returns:: Degrees, Minutes, Seconds Object
Return type:: DMSAngle

gon()[source]¶

Convert to Gradians (float)

Returns:: Gradians
Return type:: float

gona()[source]¶

Convert to Gradians (class)

Returns:: Gradians
Return type:: GONAngle

hp()[source]¶

Convert to HP Notation (float)

Returns:: HP Notation (DDD.MMSSSS)
Return type:: float

rad()[source]¶

Convert to Radians

Returns:: Radians
Return type:: float

class geodepy.angles.GONAngle(gon_angle=0.0)[source]¶

Class for working with angles in Gradians (90 degrees == 100 Gradians)

Note: GeodePy also supports working with angles in Gradians as floats

Parameters:: gon_angle – float Gradian angle

ddm()[source]¶

Convert to Degrees, Decimal Minutes Object

Returns:: Degrees, Decimal Minutes Object
Return type:: DDMAngle

dec()[source]¶

Convert to Decimal Degrees (float)

Returns:: Decimal Degrees
Return type:: float

deca()[source]¶

Convert to Decimal Degrees (class)

Returns:: Decimal Degrees
Return type:: DECAngle

dms()[source]¶

Convert to Degrees, Minutes, Seconds Object

Returns:: Degrees, Minutes, Seconds Object
Return type:: DMSAngle

gon()[source]¶

Convert to Gradians (float)

Returns:: Gradians
Return type:: float

hp()[source]¶

Convert to HP Notation (float)

Returns:: HP Notation (DDD.MMSSSS)
Return type:: float

hpa()[source]¶

Convert to HP Notation (class)

Returns:: HP Notation (DDD.MMSSSS)
Return type:: HPAngle

rad()[source]¶

Convert to Radians

Returns:: Radians
Return type:: float

class geodepy.angles.DMSAngle(degree, minute=0, second=0.0, positive=None)[source]¶

Class for working with angles in Degrees, Minutes and Seconds format

Parameters:

degree (float | str) – Angle: whole degrees component (floats truncated) Alt: formatted string ‘±DDD MM SS.SSS’
minute (float) – Angle: whole minutes component (floats truncated)
second (float) – Angle: seconds component (floats preserved)
positive (bool) – Optional. True is positive, False is negative. Evaluated from deg/min/sec where None

ddm()[source]¶

Convert to Degrees, Decimal Minutes Object

Returns:: Degrees, Decimal Minutes Object
Return type:: DDMAngle

dec()[source]¶

Convert to Decimal Degrees (float)

Returns:: Decimal Degrees
Return type:: float

deca()[source]¶

Convert to Decimal Degrees (class)

Returns:: Decimal Degrees
Return type:: DECAngle

gon()[source]¶

Convert to Gradians (float)

Returns:: Gradians
Return type:: float

gona()[source]¶

Convert to Gradians (class)

Returns:: Gradians
Return type:: GONAngle

hp()[source]¶

Convert to HP Notation (float)

Returns:: HP Notation (DDD.MMSSSS)
Return type:: float

hpa()[source]¶

Convert to HP Notation (class)

Returns:: HP Notation (DDD.MMSSSS)
Return type:: HPAngle

rad()[source]¶

Convert to Radians

Returns:: Radians
Return type:: float

class geodepy.angles.DDMAngle(degree, minute=0.0, positive=None)[source]¶

Class for working with angles in Degrees, Decimal Minutes format

Parameters:

degree (float | str) – Angle: whole degrees component (floats truncated)
minute (float) – Angle: minutes component (floats preserved)
positive (bool) – Optional. True is positive, False is negative. Evaluated from deg/min/sec where None

dec()[source]¶

Convert to Decimal Degrees (float)

Returns:: Decimal Degrees
Return type:: float

deca()[source]¶

Convert to Decimal Degrees (class)

Returns:: Decimal Degrees
Return type:: DECAngle

dms()[source]¶

Convert to Degrees, Minutes, Seconds Object

Returns:: Degrees, Minutes, Seconds Object
Return type:: DMSAngle

gon()[source]¶

Convert to Gradians (float)

Returns:: Gradians
Return type:: float

gona()[source]¶

Convert to Gradians (class)

Returns:: Gradians
Return type:: GONAngle

hp()[source]¶

Convert to HP Notation (float)

Returns:: HP Notation (DDD.MMSSSS)
Return type:: float

hpa()[source]¶

Convert to HP Notation (class)

Returns:: HP Notation (DDD.MMSSSS)
Return type:: HPAngle

rad()[source]¶

Convert to Radians

Returns:: Radians
Return type:: float

Angle Conversions¶

All conversion functions can be seen below.

For converting decimal degree to other formats:

geodepy.angles.dec2hp(dec)[source]¶: Converts Decimal Degrees to HP Notation (float) :param dec: Decimal Degrees :type dec: float :return: HP Notation (DDD.MMSSSS) :rtype: float

geodepy.angles.dec2hpa(dec)[source]¶

Converts Decimal Degrees to HP Angle Object

Parameters:: dec (float) – Decimal Degrees
Returns:: HP Angle Object (DDD.MMSSSS)
Return type:: HPAngle

geodepy.angles.dec2gon(dec)[source]¶

Converts Decimal Degrees to Gradians

Parameters:: dec (float) – Decimal Degrees
Returns:: Gradians
Return type:: float

geodepy.angles.dec2gona(dec)[source]¶

Converts Decimal Degrees to Gradians (class)

Parameters:: dec (float) – Decimal Degrees
Returns:: Gradians
Return type:: GONAngle

geodepy.angles.dec2dms(dec)[source]¶

Converts Decimal Degrees to Degrees, Minutes, Seconds Object

Parameters:: dec (float) – Decimal Degrees
Returns:: Degrees, Minutes, Seconds Object
Return type:: DMSAngle

geodepy.angles.dec2ddm(dec)[source]¶

Converts Decimal Degrees to Degrees, Decimal Minutes Object

Parameters:: dec (float) – Decimal Degrees
Returns:: Degrees, Decimal Minutes Object
Return type:: DDMAngle

For converting Hewlett Packard to other formats:

geodepy.angles.hp2dec(hp)[source]¶

Converts HP Notation to Decimal Degrees

Parameters:: hp (float) – HP Notation (DDD.MMSSSS)
Returns:: Decimal Degrees
Return type:: float

geodepy.angles.hp2deca(hp)[source]¶

Converts HP Notation to DECAngle Object

Parameters:: hp (float) – HP Notation (DDD.MMSSSS)
Returns:: Decimal Degrees Object
Return type:: DECAngle

geodepy.angles.hp2rad(hp)[source]¶

Converts HP Notation to radians

Parameters:: hp (float) – HP Notation (DDD.MMSSSS)
Returns:: radians
Return type:: float

geodepy.angles.hp2gon(hp)[source]¶

Converts HP Notation to Gradians

Parameters:: hp (float) – HP Notation (DDD.MMSSSS)
Returns:: Gradians
Return type:: float

geodepy.angles.hp2gona(hp)[source]¶

Converts HP Notation to Gradians (class)

Parameters:: hp (float) – HP Notation (DDD.MMSSSS)
Returns:: Gradians
Return type:: GONAngle

geodepy.angles.hp2dms(hp)[source]¶

Converts HP Notation to Degrees, Minutes, Seconds Object

Parameters:: hp (float) – HP Notation (DDD.MMSSSS)
Returns:: Degrees, Minutes, Seconds Object
Return type:: DMSAngle

geodepy.angles.hp2ddm(hp)[source]¶

Converts HP Notation to Degrees, Decimal Minutes Object

Parameters:: hp (float) – HP Notation (DDD.MMSSSS)
Returns:: Degrees, Decimal Minutes Object
Return type:: DDMAngle

For converting Gradians to other formats:

geodepy.angles.gon2dec(gon)[source]¶

Converts Gradians to Decimal Degrees

Parameters:: gon (float) – Gradians
Returns:: Decimal Degrees
Return type:: float

geodepy.angles.gon2deca(gon)[source]¶

Converts Gradians to DECAngle Object

Parameters:: gon (float) – Gradians
Returns:: Decimal Degrees Object
Return type:: DECAngle

geodepy.angles.gon2hp(gon)[source]¶

Converts Gradians to HP Notation (float)

Parameters:: gon (float) – Gradians
Returns:: HP Notation (DDD.MMSSSS)
Return type:: float

geodepy.angles.gon2hpa(gon)[source]¶

Converts Gradians to HP Angle Object

Parameters:: gon (float) – Gradians
Returns:: HP Angle Object (DDD.MMSSSS)
Return type:: HPAngle

geodepy.angles.gon2rad(gon)[source]¶

Converts Gradians to radians

Parameters:: gon (float) – Gradians
Returns:: Radians
Return type:: float

geodepy.angles.gon2dms(gon)[source]¶

Converts Gradians to Degrees, Minutes, Seconds Object

Parameters:: gon (float) – Gradians
Returns:: Degrees, Minutes, Seconds Object
Return type:: DMSAngle

geodepy.angles.gon2ddm(gon)[source]¶

Converts Gradians to Degrees, Decimal Minutes Object

Parameters:: gon (float) – Gradians
Returns:: Degrees, Decimal Minutes Object
Return type:: DDMAngle

Other Converstion Functions:

geodepy.angles.dd2sec(dd)[source]¶

Converts angle in decimal degrees to angle in seconds

Parameters:: dd – Decimal Degrees
Returns:: Seconds

geodepy.angles.dec2hp_v(dec)[source]¶

geodepy.angles.hp2dec_v(hp)[source]¶

Angle Type Checking¶

geodepy.angles.angular_typecheck(angle)[source]¶

Converts Angle Objects to Decimal Degrees (float) for computations or returns float input as-is.

Parameters:: angle – Angle Object or float
Returns:: Decimal Degrees
Return type:: float