Описание астрологического обменного формата JALIF
JALIF - (JSON AstroLogical Interchange Format) - это JSON-формат обмена астрологическими данными. Формат аналогичен обменному формату CALIF, и отличается от него тем, что основан на JSON (JavaScript Object Notation), а не на XML. Он, как и формат CALIF, предназначен для обмена астрологическими данными между астрологическими программами. Причём, под астрологическими данными понимаются не только общепринятые данные в виде даты-времени, координат и временнЫх поправок, но и расширенные данные, вида тем астрологических домов, выбора дополнительных условий, ссылок карт событий на базовые натальные карты и т.п.Файлы этого формата имеют меньший объём, по сравнению с файлами формата CALIF, но передаваемые в них наборы, имеют строгий набор данных и типизированы, что несколько сужает их расширяемость, в отличии от формата CALIF. Тем не менее, этот формат может быть использован как менее объёмная и лёгкая альтернатива более общему и универсальному формату CALIF.
Это важно! Программа DataWorker, которая, в том числе, занимается импортом и экспортом данных, поможет преобразовать данные из формата JALIF в формат, доступный для использования.
Содержание страницы описания обменного формата JALIF
- Общее описание обменного формата
- Преимущества использования формата
- Информационные элементы набора карт
- Элементы данных записи
- Загрузить (скачать)
- Часто задаваемые вопросы по формату
Общее описание обменного формата JALIF
JALIF представляет собой JSON-файл с произвольным именем и набором пар ключ-значение, определёнными заданной схемой хранения.
- обменный файл формата JSON позволяет описывать любую древовидную структуру записей базы данных;
- кодировка файла данных - UTF-8;
- информационные элементы набора записей однозначно идентифицируют данный формат и его набор записей;
- элементы записи описывают содержимое одной записи (карты или события).
Преимущества использования формата JALIF
Так как этот формат является более лёгким клоном формата CALIF, то практически все преимущества формата CALIF, свойственны и данном формату.
- Позволяет организовать хранение данных в древовидной структуре с любой конфигурацией папок.
- Может оперировать частными признаками, присущими только конкретной программе.
- Позволяет автоматизировать астрологический анализ, поиск карт и событий по ряду признаков (тип карты, точность событий, темы кверента и квезита, связывать события с базовыми натальными картами, анализировать количественные величины (например, изменение курса валюты для конкретной биржи) и т.д.).
- Не зависит от форматов хранения данных (дата-время, координаты, знак временной поправки и т.д.), присущих конкретной стране или сообществу астрологов.
- Поддерживает любые языки и не зависит от национальной кодировки (использует UNICODE).
- Открыт и прост в реализации благодаря JSON.
Для просмотра картинки большого размера просто щёлкните по ней мышкой.
|
Диаграмма сравнения использования данных в астрологических программах (полная аналогия с форматом CALIF) Без формата JALIF
|
Информационные элементы, идентифицирующие формат JALIF и конкретный набор карт
Важно! В отличии от формата CALIF, файлы формата JALIF содержат только элементы записей с наборами пар ключ-значение. В связи с этим информация о данном наборе передаётся в примечаниях к 1-й записи набора в файле. Эта информация может быть удалена после переноса данных. Так как формат JALIF является клоном формата CALIF, то все его ключи записей полностью повторяют теги формата CALIF.
Данные элементы несут информационную составляющую каждого набора записей.
| Элемент | Описание | Формат, примечание | Варианты, Примеры |
|---|---|---|---|
| fsign | Сигнатура формата | Сигнатура формата необходима для однозначного определения формата файла | JALIF_DataFormat |
| fver | Версия формата | YYYYMMDD | 20190801 |
| utctag | Признак направления поправки UTC | В России и Европе принято считать поправку положительной к востоку от Гринвича, а в США - наоборот |
P - плюс к востоку от Гринвича N- минус к востоку от Гринвича |
| nameset | Название набора данных | SSS...SSS. Любая доступная строка символов | Тестовый пример |
| dtset | Дата формирования набора | YYYYMMDDHHMISS (год-месяц-день-часы-мин-секунды) | 20190801211317 |
| totrec | Количество записей в наборе | Описывает количество записей данного набора | 739 |
| author | Информация об авторе подборки данных набора | Астролог-составитель данного набора данных и (или) ссылка на страницу в Интернете | Astroman |
| ... | другие атрибуты | вводятся по мере необходимости | ... |
Элементы данных записи (в наборе)
Данные элементы описывают содержимое каждой записи (карты или события), относящейся к набору.| Ключ | Описание | Формат, примечание | Варианты, Примеры | Обязательность |
|---|---|---|---|---|
| rkey | Уникальный ключ записи | Записью может быть, как карта, так и папка. Ключ должен однозначно идентифицировать каждую запись. В качестве ключа рекомендуется использовать GUID | 7AA8AC13A2F947CC82470CCBEE0B4700 | V |
| pkey | Уникальный ключ записи родителя | Родителем может быть только папка. Ключ должен однозначно идентифицировать каждую запись. В качестве ключа рекомендуется использовать GUID | A73B273FF6094B14972F01FDD383320E | V |
| rtag | Признак типа записи | S Описывает тип записи как папку или карту |
F - папка D - карта |
V |
| name | Наименование карты (ФИО, событие, вопрос и т.д. | SSS...SSS Любая доступная строка символов |
Рождение Владимира Высоцкого | V |
| dt | Дата-время карты | YYYYMMDDHHMISS (год-месяц-день-часы-мин-секунды) |
19380125093400 25 января 1938 года в 9 часов 34 минут 0 секунд |
V |
| delta | Поправка к UTC | NHHMISS (знак-часы-мин-секунды) С учётом признака направления поправки UTC в атрибутах набора записей |
+030000 - UTC+3 часа (к востоку) +053017 - UTC+5:30:17 (к востоку) -010000 - UTC-1 час (к западу) |
V |
| lat | Широта места | DDMISSN (градусы-мин-секунды-полусфера N/S) |
554500N - 55°45'00" с.ш. 000001S - 0°0'1" ю.ш. |
V |
| lon | Долгота места | DDDMISSN (градусы-мин-секунды-полусфера E/W) |
0373700E - 37°37'00" в.д. 0070101W - 7°1'1" з.д. 0000000E - 0°0'0" в.д. |
V |
| place | Текстовое описание места | SSS...SSS Произвольное название места карты (события) |
Москва (Московская) | - |
| remc | Примечание | SSS...SSS Произвольный текст для карты (события) |
ректификация Astroman | - |
| ctag | Признак карты | S Признак, описывающий тип карты |
0 - признак не определён N - натальная карта E - событие H - хорарная карта |
- |
| thems | Тема(ы) карты | NNMM Тема(ы) карты для события и темы кверента-квезита для хорара |
0000 - для натальной карты 0500 - событие по теме 5 0107 - тема кверента 1, тема квезита 7 |
- |
| sex | Признак пола | S Признак пола для натальной карты |
0 - (ноль) пол не определён M - мужской F - женский |
- |
| prectag | Признак точности карты | S Описывает точность даты-времени карты |
Для натальных карт: 0 - точность не определена K - космограмма N - карта не ректифицирована R - карта ректифицирована Для событий: 0 - (ноль) точность не определена P - точно M - минуты H - часы D - дни W - недели Y - месяцы |
- |
| rpic | Ссылка на файл фотографии | SSS...SSS относительное имя файла и расширение |
vvisockiy.png - файл находится в папке с JSON-файлом img\vvisockiy.png - файл находится в папке IMG, которая находится в папке с JSON-файлом |
- |
| nkey | Уникальный ключ записи натальной карты | Предназначен для указания на натальную карту, породившую данное событие. Используется для автоматизированного анализа событий и карт. | A73B273FF6094B14972F01FDD383320E | - |
| addvals | Дополнительные условия | SSS...SSS Дополнительные условия, используемые для расширения возможностей автоматизированного выполнения операций. Например, здесь задаются дополнительные темы домов (тег "addtheme"), дополнительные объекты карты (тег "useobj") и исключаемые объекты (тег "ignoreobj"), которые используются для определения тематических объектов, используемых при ректификации и прогностике. |
<addtheme>28</addtheme> <useobj>0304</useobj> <ignoreobj>06</ignoreobj> |
- |
| fval | Величина для анализа | N.M (N - целая часть, M - дробная часть) используется в случае автоматизированного анализа событий и карт. Например, величина курса валюты для населённого пункта (биржи) в указанную дату. | 33.1719 4.0 -15 |
- |
Загрузить (скачать)
- Скачать спецификации и примеры формата JALIF
- Астрологические базы и банки данных
- Видеоролики с YouTube
