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])Создает угловую координату из составляющих.
Свойства:
Возвращает градусы.
Возвращает минуты.
Возвращает секунды.
Возвращает числовое значение в формате числа с плавающей точкой (
float
).Методы:
as_rumb
([precision, suppress_trailing_zeros])Получение строкового значения угловой координаты в формате румбов.
as_string
([delimiter, precision, ...])Получение строкового значения угловой координаты.
to_normalized
([polar])Возвращает угловую координату, нормализованную в диапазоне [0; 360) или [-180; 180].
- __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 – если не удалось преобразовать значение в число с плавающей точкой.
- 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 – Признак удаления завершающих нулей.
- classmethod from_parts(degrees: int, minutes: int = 0, seconds: float = 0.0) AngleCoord
Создает угловую координату из составляющих.
- Параметры:
degrees – Градусы.
minutes – Минуты.
seconds – Секунды.
- to_normalized(polar=False) AngleCoord
Возвращает угловую координату, нормализованную в диапазоне [0; 360) или [-180; 180].
- Параметры:
polar – Если
True
, то для нормализации используется полярная система координат [0; 360), еслиFalse
, то нормализация происходит в диапазоне [-180; 180].