# AngleCoord - Угловые координаты.

class axipy.AngleCoord

  Класс представляет собой угловую координату. Для координаты в формате числа с плавающей точкой (float) используется класс `axipy.FloatCoord`.

  Угловую координату можно создать используя конструктор класса.

  Создание угловой координаты конструктором класса.

      from axipy import AngleCoord

      # Создание угловой координаты конструктором класса.
      angle_coord = AngleCoord('''33°22'28,11972"''')
      print(angle_coord)
      '''
      >>> 33°22'28,11972"
      '''

  Также, угловую координату можно создать из составляющих `from_parts()`.

  Конструктор класса:

  `__init__`(value) | Конструктор класса.

  Классовые методы:

  `from_parts`(degrees[, minutes, seconds]) | Создает угловую координату из составляющих.

  Свойства:

  `degrees` | Возвращает градусы.
  `minutes` | Возвращает минуты.
  `seconds` | Возвращает секунды.
  `value` | Возвращает числовое значение в формате числа с плавающей точкой (`float`).

  Методы:

  `as_rumb`([precision, suppress_trailing_zeros]) | Получение строкового значения угловой координаты в формате румбов.
  `as_string`([delimiter, precision, ...]) | Получение строкового значения угловой координаты.
  `to_normalized`([polar]) | Возвращает угловую координату, нормализованную в диапазоне [0; 360) или [-180; 180].

  Специальные методы:

  `__bool__`() | Интерпретация объекта как логического значения.
  `__eq__`(other) | Оператор равенства (==).
  `__ge__`(other) | Оператор 'Больше или равно' (>=).
  `__gt__`(other) | Оператор 'Больше' (>).
  `__le__`(other) | Оператор 'Меньше или равно' (<=).
  `__lt__`(other) | Оператор 'Меньше' (<).
  `__repr__`() | Официальное строковое представление объекта при вызове `repr()`.
  `__str__`() | Неформальное строковое представление объекта при вызове `str` или `print()`.

  __bool__() → bool

    Интерпретация объекта как логического значения.

  __eq__(other: object) → bool

    Оператор равенства (==).

  __ge__(other: object) → bool

    Оператор „Больше или равно“ (>=).

  __gt__(other: object) → bool

    Оператор „Больше“ (>).

  __init__(value: Union[float, int, str])

    Конструктор класса.

    Создает координату из значения в различных форматах.

    Параметры:

      value –

      Значение может быть:

      - целым числом;

      - числом с плавающей точкой;

      - строкой, представляющей целое число или число с плавающей точкой;

      - строкой, представляющей угловую координату с разделителями, или в формате румбов.

      (`<dd°mm'ss,zz">`, `<dd mm ss,zz>`, `<dd/mm/ss,zz>`, `<dd-mm-ss,zz>`, `<dd,mm,ss.zz>`, `<dd.zz>`, `<dd,zz>` или в румбах `ЮВ dd.zz`.)

    Исключение:

      ValueError – если не удалось преобразовать значение в число с плавающей точкой.

  __le__(other: object) → bool

    Оператор „Меньше или равно“ (<=).

  __lt__(other: object) → bool

    Оператор „Меньше“ (<).

  __repr__() → str

    Официальное строковое представление объекта при вызове `repr()`.

  __str__() → str

    Неформальное строковое представление объекта при вызове `str` или `print()`.

  as_rumb(precision: Optional[int] = None, suppress_trailing_zeros: bool = False) → str

    Получение строкового значения угловой координаты в формате румбов.

    Параметры:

      - precision – Количество знаков после запятой. Если None, округление не производится.

      - suppress_trailing_zeros – Признак удаления завершающих нулей.

  as_string(delimiter: Optional[str] = None, precision: Optional[int] = None, suppress_trailing_zeros: bool = False) → str

    Получение строкового значения угловой координаты.

    Параметры:

      - delimiter – Разделитель. Например, `'-'` или `'/'`.

      - precision – Количество знаков после запятой. Если None, округление не производится.

      - suppress_trailing_zeros – Признак удаления завершающих нулей.

  property degrees: int

    Возвращает градусы.

  classmethod from_parts(degrees: int, minutes: int = 0, seconds: float = 0.0) → AngleCoord

    Создает угловую координату из составляющих.

    Параметры:

      - degrees – Градусы.

      - minutes – Минуты.

      - seconds – Секунды.

  property minutes: int

    Возвращает минуты.

  property seconds: float

    Возвращает секунды.

  to_normalized(polar: bool = False) → AngleCoord

    Возвращает угловую координату, нормализованную в диапазоне [0; 360) или [-180; 180].

    Параметры:

      polar – Если `True`, то для нормализации используется полярная система координат [0; 360), если `False`, то нормализация происходит в диапазоне [-180; 180].

  property value: float

    Возвращает числовое значение в формате числа с плавающей точкой (`float`).