Описание астрологического обменного формата CALIF
CALIF - (Common AstroLogical Interchange Format) - это общий формат обмена астрологическими данными. Он предназначен для обмена астрологическими данными между астрологическими программами Причём, под астрологическими данными понимаются не только общепринятые данные в виде даты-времени, координат и временнЫх поправок. Это понятие для формата CALIF гораздо шире, так как он позволяет передавать любые данные, которые используются не только в настоящее время, но и те, которые когда-либо будут внедрены в астрологические программы. Т.е. иными словами, этот формат очень гибкий и легко адаптируется к любым данным. Так, этот формат поддерживает связанные карты, которые позволяют автоматизировать процесс ректификации (см. астрологическая программа ректификации) и прогнозирования событий (см. программа для астрологического прогноза).Программа DataWorker, которая, в том числе, занимается импортом и экспортом данных, поможет преобразовать данные из формата CALIF в формат, доступный для использования.
Это важно! Обмен астрологическими данными возможен, если астрологическая программа поддерживает этот формат. Для внедрения (создания) этого формата в другой программе, на сайте представлено достаточно подробное описание формата, схем хранения и примеров его использования.
Содержание страницы описания обменного формата CALIF
- Общее описание обменного формата CALIF
- Преимущества использования формата CALIF
- Информационные элементы набора записей
- Элементы структуры набора (записей)
- Элементы данных записи (в наборе)
- Загрузить (скачать)
- Часто задаваемые вопросы по формату CALIF
Общее описание обменного формата CALIF
Формат представляет собой XML-файл с произвольным именем и тегами, определёнными заданной схемой хранения.
- обменный файл формата XML позволяет описывать любую древовидную структуру записей базы данных;
- кодировка файла данных - UTF-8;
- информационные элементы набора записей однозначно идентифицируют данный формат и его набор записей;
- элементы структуры определяют структуру всего набора и его записей (карт или событий).
- элементы записи описывают содержимое одной записи (карты или события).
Преимущества использования формата CALIF
- Позволяет организовать хранение данных в древовидной структуре с любой конфигурацией папок.
- Может оперировать частными признаками, присущими только конкретной программе.
- Позволяет автоматизировать астрологический анализ, поиск карт и событий по ряду признаков (тип карты, точность событий, темы кверента и квезита, связывать события с базовыми натальными картами, анализировать количественные величины (например, изменение курса валюты для конкретной биржи) и т.д.).
- Не зависит от форматов хранения данных (дата-время, координаты, знак временной поправки и т.д.), присущих конкретной стране или сообществу астрологов.
- Расширяем, что позволяет легко вводить иные, используемые только конкретной программой, расширения данных.
- Поддерживает любые языки и не зависит от национальной кодировки (использует UNICODE).
- Открыт и прост в реализации благодаря XML.
|
Диаграмма сравнения использования данных в астрологических программах Без формата CALIF
|
Информационные элементы набора записей
Данные элементы несут информационную составляющую каждого набора записей.| Элемент | Описание | Формат, примечание | Варианты, Примеры |
|---|---|---|---|
| fsign | Сигнатура формата | Сигнатура формата необходима для однозначного определения формата файла | CALIF_DataFormat |
| fver | Версия формата | YYYYMMDD | 20140707 |
| utctag | Признак направления поправки UTC | В России и Европе принято считать поправку положительной к востоку от Гринвича, а в США - наоборот |
P - плюс к востоку от Гринвича N- минус к востоку от Гринвича |
| nameset | Название набора данных | SSS...SSS. Любая доступная строка символов | Тестовый пример |
| dtset | Дата формирования набора | YYYYMMDDHHMISS (год-месяц-день-часы-мин-секунды) | 20140707211317 |
| totrec | Количество записей в наборе | Описывает количество записей данного набора | 739 |
| author | Информация об авторе подборки данных набора | Астролог-составитель данного набора данных и (или) ссылка на страницу в Интернете | Astroman |
| ... | другие атрибуты | вводятся по мере необходимости | ... |
Элементы структуры набора (записей)
Данные элементы определяют структуру всего набора и его записей.| Элемент | Описание | Примечание | Пример |
|---|---|---|---|
| recset | Элемент всего набора записей | Корневой элемент набора записей обменного файла. Контейнер всех записей обменного файла. |
<recset></recset> |
| rec | Элемент одной записи набора | Корневой элемент каждой записи. Контейнер записи с данными по карте или событию |
<rec></rec> |
| nkeys | Элемент набора ссылок карты события на натальные карты | Корневой элемент набора ссылок каждой записи на натальные карты, породившие данное событие | <nkeys></nkeys> |
Элементы данных записи (в наборе)
Данные элементы описывают содержимое каждой записи (карты или события), относящейся к набору.| Элемент | Описание | Формат, примечание | Варианты, Примеры | Обязательность |
|---|---|---|---|---|
| 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 - файл находится в папке с XML-файлом img\vvisockiy.png - файл находится в папке IMG, которая находится в папке с XML-файлом |
- |
| 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 |
- |
| ... | другие атрибуты | другие приватные атрибуты, которые могут быть использованы конкретной программой | ... | ... |
Загрузить (скачать)
- Скачать спецификации и примеры формата CALIF
- Астрологические базы и банки данных в формате CALIF
- Видеоролики с YouTube
