Орб — это допуск вокруг точного угла аспекта: насколько две точки могут отстоять от идеального угла и всё ещё считаться в аспекте. На этой странице описаны все орбы, которые применяет API — по аспекту, по телу, по типу карты — и как их переопределить.
В проекте три модели орбов. Они по-разному отвечают на вопрос «какой ширины орб?»:
| Модель | Орб зависит от | Где применяется |
|---|---|---|
| По аспекту (классика) | вида аспекта (☌ 8°, △ 7°, ✶ 5°…) | сетка aspects по умолчанию везде |
| По телу (moiety, классическая школа) | двух тел (Солнце 15°, Луна 12°…) | опционально в запросе (orbs) |
| Конвенция (интерпретационная) | вида аспекта + бонус светилам (мажоры 6°, светила 8°, ⚻ 3°) | опциональный блок wide_aspects |
Дефолт для aspects, angle_aspects и configurations на всех эндпоинтах.
Орб — свойство вида аспекта, одинаковое для любой пары тел (и Солнце☌Сатурн,
и Меркурий☌Венера допускают 8°).
| Аспект | Символ | Точный угол | Орб по умолчанию |
|---|---|---|---|
| Соединение | ☌ | 0° | 8° |
| Оппозиция | ☍ | 180° | 8° |
| Трин | △ | 120° | 7° |
| Квадрат | □ | 90° | 7° |
| Секстиль | ✶ | 60° | 5° |
| Квинконс | ⚻ | 150° | 3° |
«8/7/5» — это сокращение для соединения/оппозиции 8, трина/квадрата 7, секстиля 5 (квинконс 3). Ту же сетку использует веб-колесо, поэтому колесо и API никогда не расходятся.
Все карт-эндпоинты используют одни и те же дефолтные орбы по аспекту (выше) — орб не меняется между наталом, транзитами, синастрией, соляром и прогрессиями. Различается лишь переопределение, которое принимает каждый эндпоинт:
| Эндпоинт | Список аспектов | Орбы по умолчанию | Доступные переопределения |
|---|---|---|---|
POST /v1/charts/natal | aspects (внутрикартные) | по аспекту (8/7/5) | orbs (по телу) |
POST /v1/charts/transits | aspects (натал × транзит) | по аспекту (8/7/5) | orb (единый), orbs (по телу, в natal) |
POST /v1/charts/synastry | aspects (A × B) | по аспекту (8/7/5) | orb (единый), orbs (по телу, в a/b) |
POST /v1/charts/solar · return · progressed | меж-аспекты | по аспекту (8/7/5) | — |
POST /v1/aspect-hits | окна точных попаданий | orb = 1° (полуширина окна) | orb |
Параметр orb у транзитов/синастрии — единое переопределение: один орб для
всех видов аспектов (например, конфликт-индекс Шестопалова использует orb=6).
Включается передачей объекта orbs в запросе (даже пустого {}). Тогда
сетка aspects переключается на классический метод полусуммы (moiety):
каждое тело несёт свой орб, а орб для пары — это среднее двух орбов:
орб(A, B) = (body_orb(A) + body_orb(B)) / 2
Полусумма применяется к пяти птолемеевым аспектам (соединение, секстиль,
квадрат, трин, оппозиция). Квинконс не птолемеев и не имеет допуска-полусуммы,
поэтому в этом режиме он сохраняется со своим фиксированным орбом по умолчанию
(3°) — а не отбрасывается (иначе параметр orbs молча терял бы все квинконсы,
включая экзактные). Эффективная таблица орбов по телу возвращается обратно в поле
orbs ответа (она описывает только птолемеевы аспекты; квинконс всегда 3°).
| Тело | Орб | Тело | Орб | |
|---|---|---|---|---|
| ☉ Солнце | 15° | ♅ Уран | 5° | |
| ☽ Луна | 12° | ♆ Нептун | 5° | |
| ☿ Меркурий | 7° | ♇ Плутон | 5° | |
| ♀ Венера | 7° | ☊ Узлы (mean/true/south) | 3° | |
| ♂ Марс | 8° | ⚷ Хирон | 3° | |
| ♃ Юпитер | 9° | ⚸ Лилит, Селена, жребии, точки | 2° | |
| ♄ Сатурн | 9° |
Семь видимых тел используют классические орбы Лилли («Christian Astrology», 1647); внешние планеты и точки — вне классического канона — получают современные конвенционные значения. Примеры орбов пар: Солнце–Луна (15+12)/2 = 13.5°; Солнце–Сатурн 12°; Марс–Юпитер 8.5°; Меркурий–Венера 7°.
orbs — это частичная карта: любое тело, которое вы опустите, сохраняет свой
классический дефолт:
// тело запроса натала
{ "datetime_utc": "1990-05-15T09:20:00Z",
"location": { "latitude": 55.7558, "longitude": 37.6178 },
"orbs": { "sun": 10, "moon": 9, "pluto": 3 } } // остальные остаются классическими
Тогда ответ несёт полную эффективную таблицу:
"orbs": { "sun": 10.0, "moon": 9.0, "mercury": 7.0, ..., "pluto": 3.0 }
wide_aspects)Орбы, которые астролог реально применяет при трактовке карты. Передаются с
wide_aspects: true и наполняют отдельные блоки wide_aspects /
wide_angle_aspects (сетка aspects по умолчанию не затрагивается).
квинконс → 3°
любой аспект к ☉/☽ → 8°
все прочие мажоры → 6°
Уже классики для мажоров планета–планета (6° против 7–8°), шире для светил.
wide_angle_aspects также отдаёт аспекты ко всем четырём углам (Asc/MC
считаются, Dsc/IC — зеркала). Попадание за пределом дефолтного орба — или зеркало
— помечается derived.
Передаются с minor_aspects: true → блок minor_aspects. Гармонические аспекты
помимо мажоров, с тесными орбами. Углы 7-й/9-й/10-й гармоник иррациональны
(360/7, 360/9, 360/10), приведены до 4 знаков.
| Аспект | Угол | Гармоника | Орб |
|---|---|---|---|
| Полусекстиль | 30° | 12-я | 1.5° |
| Дециль (полуквинтиль) | 36° | 10-я | 1° |
| Новиль | 40° | 9-я | 1° |
| Полуквадрат | 45° | 8-я | 2° |
| Септиль | 51.4286° | 7-я | 1° |
| Квинтиль | 72° | 5-я | 2° |
| Биновиль | 80° | 2×9-я | 1° |
| Бисептиль | 102.8571° | 2×7-я | 1° |
| Тридециль (сесквиквинтиль) | 108° | 3×10-я | 1° |
| Полутораквадрат | 135° | 3×8-я | 2° |
| Биквинтиль | 144° | 2×5-я | 2° |
| Трисептиль | 154.2857° | 3×7-я | 1° |
| Квадрановиль | 160° | 4×9-я | 1° |
Орбы, зашитые в конкретные расчёты, приведены для полноты:
| Расчёт | Орб | Примечания |
|---|---|---|
Соединения с неподвижными звёздами (star_conjunctions) | по звёздной величине: mag ≤ 1 → 2°, ≤ 2 → 1.5°, иначе 1° | у ярких звёзд орб шире |
Аспекты по склонению (declination_aspects) | 1° | параллель ` |
| Соединение со Спикой (исключение ЛБК) | 1° | Луна в пределах 1° от Спики |
Параны (star_parans) | 5 минут времени | звезда и планета одновременно на углах |
Мунданные аспекты (/v1/calendar/global) | точные моменты (без орба) | корневой поиск пересечений; параметр orb принимается для совместимости, но не используется |
orbs (даже {}) → метод
полусуммы, эхом в поле orbs ответа.wide_aspects: true.minor_aspects: true.orb: N.Алгоритм подбора аспектов и обоснование каждого дефолта — в CALCULATIONS.md §14.