Skip to main content

Module zeus

Module zeus 

Source
Expand description

Zeus .zdb chart-database text format.

§File structure

Plain UTF-8 text. One chart record per line. Fields are semicolon-separated; 16 fields per record (trailing ; produces an empty 17th which is ignored):

[0]  name           free text
[1]  chart_type     0-5 integer enum
[2]  date           DD.MM.YYYY or DD.MM.YYYYJc (Julian Calendar suffix)
[3]  time           HH:MM:SS (24-hour)
[4]  utc_offset     ±HH:MM:SS (East positive — already ISO 6709, no flip needed)
[5]  location       free text, may be empty
[6]  latitude       {N|S}{D+}.{MM}.{SS}
[7]  longitude      {E|W}{DDD}.{MM}.{SS}
[8]  sex            M / F / -
[9]  rodden_rating  AA / A / B / C / DD / X / XX
[10] rectified      '+' if rectified, otherwise empty (not mapped to Chart)
[11] notes          free text; || is paragraph separator (preserved as-is)
[12] unknown        always empty in observed records
[13] ref_id         numeric ADB/Wikipedia ID, not mapped to Chart
[14] flag           0 or 1, not mapped to Chart
[15] image          Windows file path or empty, not mapped to Chart

UTC offset is already East-positive (ISO 6709). No sign flip required. Zeus does not store house system or zodiac; defaults (Placidus, Tropical, Geocentric) are used when constructing Chart.

Functions§

parse_file
Parse a Zeus .zdb file into a vec of canonical charts.
write_file
Serialize a slice of canonical charts to Zeus .zdb text format.