degrees 0.3.0

A python lib for degree calculations and conversions

degrees V0.3.0

Note:

This is the only version that is stable and compatible with python 3.8.

The older versions are NOT stable.

Added in version 0.2: Supported pickle.

Contents

• Introduction
• Importing
• Class
  • Degree
• Functions
  • degree2radian
  • radian2degree
  • normalize
• Changelog

Introduction

A python lib for degree calculations and conversions

Importing

Just type import degrees.

Class

• class degrees.Degree(number)
  class degrees.Degree(degree_obj)
  class degrees.Degree(degree=0, minute=0, second=0)

  • Creating a Degree object

import degrees

print(degrees.Degree(1))  # 1°
print(degrees.Degree(2, 3, 4))  # 2°3'4"
print(degrees.Degree(1, second=2))  # 1°0'2"
print(degrees.Degree(1, 3))  # 1°3'
print(degrees.Degree(0, -1))  # -1'
print(degrees.Degree(1.5))  # 1°30'
print(degrees.Degree(2, -4))  # ValueError: if degree is not 0, minute and second must be positive integer

• calculating:

  a + b	a - b	a * b	a / b	math.trunc(a)
  abs(a)	math.ceil(a)	math.floor(a)	a % b
  a // b	+a	-a	hash(a)

  Added in version 0.1.7: Implemented the math.trunc function on the Degree objects.

• conversions:

  int(a)	float(a)	str(a)	repr(a)	bool(a)	complex(a)

  The complex(degree_obj) is different from degree_obj.to_complex(length). The former returns int(degree_obj)+0j, but the latter returns complex(length * cos(theta), length * sin(theta)), theta=degree2radian(degree_obj).

For example:

import degrees
a = degrees.Degree(45)
print(complex(a))  # (45+0j)
print(a.to_complex(2 ** 0.5))  # about (1+1j)

• comparisons:

  a >= b	a > b	a = b
  a <= b	a < b	a != b

• staticmethod from_str(string)

  Return a degree object from a string. The dms characters should be °, ' and ".

• staticmethod from_unicode(string)

  Similar to from_str, but the dms characters should be °, ′ and ″.

  Added in version 0.1.10.

• staticmethod from_iter(iterable)

  Return a degree object from an iterable.

• property total_seconds

  The total seconds of a degree object.

• deg

  The degree of a degree object(without sign).

• min

  The minute of a degree object(without sign).

• sec

  The second of a degree object(without sign).

• sign

  The sign of a degree object.

• to_complex(length: Union[int, float])

  Returns the complex number corresponding to (angle=self, radius=length).

  Added in version 0.2.1.

• property dms

  A tuple of (degree, minute, second).

Note

The attributes of Degree are read-only.

Functions

def degree2radian(x: Degree, /)

• Convert angle x from a degree object to radians.

def radian2degree(x: Union[int, float], /)

• Convert angle x from radians to a degree object.

def normalize(x: Degree, /)

• Be using for angle normalization.

Version

version_info

• The version of this package, like sys.version_info ← click for more info.

Consts

DEGREE
MINUTE
SECOND

Equals to °, ′ and ″.

Changelog

1. Nothing.

Write in the end

If you found the bug in the code, you can email me at [e-mail]. I am happy to receive the advice!