Qu'est-ce que la Cosmobiologie d'Ebertin ?

La Cosmobiologie est une méthode astrologique du XXe siècle développée par Reinhold Ebertin en Allemagne. Elle réduit l'interprétation du thème aux aspects durs (conjonction, opposition, carré, semi-carré, sesquicarré) lus sur un cadran 22.5° — la 4ème harmonique du zodiaque. Les points médians et l'éphéméride graphique sont des outils centraux. La Cosmobiologie met l'accent sur le timing et la prédiction d'événements plutôt que sur la lecture psychologique. L'endpoint graphic-ephemeris vous donne la visualisation que les praticiens de Cosmobiologie utilisent depuis Combination of Stellar Influences d'Ebertin (1940).

Pourquoi la 4ème harmonique 22.5° est-elle le standard ?

360° divisé par 16 égale 22.5°. La 4ème harmonique fait remonter chaque aspect dur : conjonction (0°), semi-carré (45°), carré (90°), sesquicarré (135°) et opposition (180°) se replient tous sur la même grille 22.5° car chacun est un multiple de 22.5°. Les aspects mous (trigone, sextile) non. Cela fait du cadran 22.5° un détecteur d'aspects durs — c'est pourquoi la Cosmobiologie l'a adopté comme standard de facto pour le travail de timing. graphic-ephemeris utilise harmonic=4 par défaut pour cette raison.

Les calques SVG sont-ils nommés pour le stylage en aval ?

Oui. Chaque endpoint /render/* regroupe les éléments SVG dans des calques nommés : g id='axes', g id='aspects', g id='planets' sur la roue ; g id='bars', g id='ticks', g id='axis' sur le Gantt de transits ; g id='planet-sun', g id='planet-moon', etc. sur l'éphéméride graphique. Votre CSS ou processeur SVG en aval peut cibler n'importe quel calque par id sans parser la géométrie — recolorer les planètes, masquer le calque d'aspects, restyler les traits. La convention de nommage reste stable entre les versions.

Quels thèmes de graphique sont disponibles ?

Quatre préréglages : minimal (clair épuré), minimal-dark (papier sombre épuré), astrocom (version claire du look astro.com), et astrocom-dark (version sombre du look astro.com). En dessous, quatre thèmes CSS natifs Kerykeion fonctionnent aussi : light, dark, dark-high-contrast, classic. Passez theme=astrocom-dark pour le look professionnel sombre le plus populaire. Chaque préréglage se superpose à un thème CSS Kerykeion de base, donc les couleurs de papier et les secteurs zodiacaux héritent proprement.

Puis-je obtenir un graphique style Astrocom ?

Oui — réglez theme=astrocom (clair) ou theme=astrocom-dark. Cela combine quatre patchs d'un coup : axis_stroke_width=3.0 pour des lignes AC/MC/DC/IC épaisses, axes_labels_position='outside' pour les étiquettes juste après la roue, house_numbers_position='center' pour la disposition des numéros de maison en anneau intérieur, et un axis_color unifié (#444444 clair, #6b7280 sombre). La sortie imite le graphique de référence astro.com (Astrodienst) que les astrologues traditionnels lisent depuis 30+ ans.

Comment personnaliser l'épaisseur des axes ?

Passez axis_stroke_width en flottant. 1.0 est la valeur par défaut (comportement Kerykeion pré-patch). 3.0 correspond au préréglage astrocom et à la référence astro.com. 5.0+ fonctionne pour une sortie format poster mural. Le paramètre n'affecte que les quatre cuspides d'axes (AC à l'index 0, IC à 3, DC à 6, MC à 9). Les autres cuspides de maisons restent à 1px en pointillé à 0.4 d'opacité. Les lignes d'axes se rendent en trait plein à 0.9 d'opacité quand ce paramètre est défini.

Puis-je masquer des planètes spécifiques des lignes d'aspects ?

Oui — passez hide_points_in_aspects en tableau de noms de points, par ex. ['Chiron','Mean_Lilith','Mean_South_Node']. Ces points restent visibles sur la roue mais le post-processeur les retire de toutes les lignes d'aspects dans le SVG et supprime leur ligne de la grille d'aspects. Utile pour les intégrations où vous voulez une vue d'aspects propre sans retirer les corps mineurs entièrement du graphique. Le post-processeur s'exécute après makeTemplate() de Kerykeion, donc le timing est cohérent.

L'API rend-elle Part of Fortune ?

Oui. Ajoutez 'part_of_fortune' à active_points et trois choses se produisent : la formule jour/nuit calcule la position (ASC + Lune - Soleil pour les thèmes de jour, ASC + Soleil - Lune pour la nuit), le glyphe en croix entourée se rend sur la roue via le nouveau symbole Part_of_Fortune dans les defs SVG, et une ligne Part of Fortune apparaît dans la grille d'aspects. Nous calculons nous-mêmes les aspects de Part of Fortune car Kerykeion en amont ne sait pas que ce corps existe. Fonctionne aujourd'hui pour les types natal et external-natal.

Prenez-vous en charge les planètes uraniennes / École de Hambourg ?

Oui — les huit hypothétiques uraniennes se rendent nativement : Cupido, Hadès, Zeus, Kronos, Apollon, Admetos, Vulcanus, Poséidon. Ajoutez à active_points les noms que vous voulez et settings_builder injecte la configuration glyphe et couleur de chacune. Elles apparaissent sur la roue et dans la grille d'aspects comme n'importe quel autre corps. Combinez avec hide_points_in_aspects pour dessiner les glyphes sans le bruit des aspects, ce qui correspond au style de notation de l'École de Hambourg.

Puis-je rendre des graphiques de synastrie, transit et composite ?

Oui — un seul endpoint, quatre types de graphiques : Natal, Synastrie, Transit, Composite. Le système de thèmes s'applique à tous, donc theme=astrocom-dark vous donne un graphique de synastrie style astrocom sombre avec les noms des deux sujets dans l'en-tête double-graphique. Les sujets secondaires en synastrie et transit obtiennent aussi les numéros de maison patchés et (quand c'est configuré) leur propre glyphe Part of Fortune. Les aspects Part of Fortune entre sujets sont sur la feuille de route.

Pourquoi avez-vous vendoré Kerykeion v4.26.3 au lieu de simplement l'importer ?

Importer Kerykeion via pip signifiait que nous ne pouvions pas modifier le comportement des axes, ajouter Part of Fortune ni patcher la logique d'aspects sans forker. Nous avons copié Kerykeion v4.26.3 dans app/vendor/kerykeion_charts/, gardé les chemins d'import compatibles, et ajouté un PATCHES.md qui suit chaque modification. Désormais, les mises à niveau en amont sont une revue de code délibérée au lieu d'un changement cassant silencieux en production. Chaque patch a un tag numéroté (PATCH-01 à PATCH-04 plus PATCH-PartOfFortune) et un commentaire inline correspondant dans la source.

Où vont les numéros de maison avec house_numbers_position='center' ?

Les numéros de maison se rendent dans un anneau intérieur à 78% du rayon de la roue (r * 0.78), avec une police de 10px et fill-opacity de 0.7. C'est la disposition astro.com. Par défaut ('near_cusp' ou null), ils restent au décalage dropin d'origine à côté de chaque cuspide avec une police de 14px et fill-opacity de 0.6. Pour les graphiques de synastrie et de transit, la même réduction s'applique aux numéros du sujet secondaire — la logique de fill-opacity spécifique au transit (0 pour le transit, 0.4 sinon) est préservée.

Que fait hide_axes_visually ?

Passez un tableau de noms d'axes (par ex. ['IC','DC']) et ces lignes d'axes sont retirées du SVG, tandis que les calculs sous-jacents restent intacts. Les angles sont toujours dans les données du graphique, donc les calculs d'aspects et les positions des maisons restent corrects — seule la ligne visible disparaît. Utile pour les intégrations minimales où vous voulez montrer les planètes et les signes sans la croix des axes cardinaux. C'est actuellement un post-processeur de niveau stub ; le contrôle complet par axe est sur la feuille de route.

À quelle vitesse se fait le rendu ?

Le temps de rendu typique reste sous les 500ms, le pire cas sous 1 seconde. Le chemin de code Kerykeion vendoré ajoute un surcoût minimal — les patchs sont surtout des branches conditionnelles dans les fonctions de dessin existantes plus une passe de post-processeur sur la chaîne SVG. Le temps de démarrage à froid dépend du chargement des fichiers Swiss Ephemeris. Le cache edge couvre les requêtes identiques, donc la génération répétée de graphiques pour les mêmes données de naissance retourne presque instantanément.

Quels formats de sortie j'obtiens ?

SVG est la sortie principale — tout ce que fait le rendeur est natif SVG. PNG, JPEG, WebP et PDF sont disponibles via des endpoints de conversion de format. SVG est ce que vous voulez pour les intégrations web car il s'adapte sans perte de qualité et reste léger. Utilisez PNG ou JPEG quand vous avez besoin de compatibilité avec les clients de messagerie (Outlook). PDF préserve la qualité vectorielle pour l'impression. WebP est environ 30% plus léger que PNG pour la même qualité visuelle.

Puis-je surcharger les paramètres de thème par requête ?

Oui — passez un dictionnaire custom_settings pour surcharger n'importe quel paramètre de graphique au-dessus du thème. La fusion est superficielle : les valeurs par défaut du thème se chargent en premier, votre dictionnaire custom_settings surcharge par-dessus, le résultat alimente Kerykeion. Vous pouvez aussi passer directement des paramètres de patch individuels (axis_stroke_width, axes_labels_position, etc.) — ceux-ci l'emportent toujours sur les valeurs par défaut du thème. Un thème est un point de départ, pas une contrainte.

Combien coûte Chart Rendering API ?

Le rendu de graphique coûte 10 crédits par requête. Le plan Ultra démarre à 37 $/mois pour 55 000 crédits (environ 5 500 graphiques). Le plan Business est à 99 $/mois pour 220 000 crédits (environ 22 000 graphiques). Le palier gratuit n'inclut pas le rendu de graphiques — uniquement les endpoints de données. Les plans Entreprise obtiennent une infrastructure dédiée et une génération illimitée.

Quels systèmes de maisons sont pris en charge ?

23 systèmes de maisons fonctionnent avec chaque thème et chaque type de graphique : Placidus, Whole Sign, Equal House, Koch, Regiomontanus, Campanus, Morinus, Porphyry, Topocentric, Alcabitius, Krusinski, Sripati, et 11 autres. Le choix du système de maisons est indépendant du thème — vous pouvez rendre un graphique Whole Sign dans le thème astrocom-dark et les cuspides se dessinent correctement. Les calculs utilisent Swiss Ephemeris (données NASA JPL).

Quelle est la précision des calculs sous-jacents ?

Précision sous l'arcseconde pour chaque planète, astéroïde et corps hypothétique. Le rendeur est une fine couche au-dessus de Swiss Ephemeris, qui utilise les données d'éphémérides NASA JPL — la même source sur laquelle s'appuient les logiciels d'astronomie professionnels. Les paramètres de thème et de personnalisation n'affectent que la sortie visuelle ; le calcul est identique quel que soit le thème choisi.

Y a-t-il des roues temporelles (age-bands, bi-wheel) ?

Oui — les roues temporelles SVG vivent sous /svg/timing/* en tant qu'endpoints séparés. La roue age-bands rend les anneaux de phases de vie autour d'un thème natal. Le rendeur bi-wheel superpose un graphique à un autre (par ex. transit sur natal) avec les deux anneaux visibles. Ils partagent le même cœur Kerykeion vendoré que l'endpoint chart_svg standard, donc les thèmes prédéfinis et les paramètres de patch s'appliquent.

Comment intégrer cela à mon application ?

C'est une API REST. Envoyez les données de naissance (date, heure, lieu), plus le thème et les paramètres de personnalisation, recevez une chaîne SVG en retour. Fonctionne avec n'importe quel langage — curl, JavaScript, Python, Ruby, PHP, Go. Pour le web, injectez le SVG directement dans la page. Pour les applications mobiles, demandez PNG ou WebP via les endpoints de conversion de format. Même authentification, mêmes limites de débit, même modèle de crédits pour tous les types de graphiques.

Y a-t-il une limite de débit sur la génération de graphiques ?

Les limites de débit dépendent du plan. Ultra (55 000 crédits/mois) couvre la plupart des plateformes indépendantes. Business (220 000 crédits) convient aux applications en croissance. Les plans Entreprise tournent sur une infrastructure dédiée sans plafond mensuel. À 10 crédits par graphique, Ultra vous donne ~5 500 graphiques/mois et Business ~22 000 — le plafond est le pool de crédits, pas une limite par seconde.

Graphiques SVG personnalisables

Chart Rendering API : SVG de qualité Astrocom, vos règles

Nous avons vendoré Kerykeion v4.26.3 pour pouvoir le patcher.

Résultat : 3 thèmes prédéfinis, un préréglage style Astrocom, 10+ paramètres de graphique, Part of Fortune, planètes uraniennes, et natal/synastrie/transit/composite depuis un seul endpoint.

Voir la démo

Gantt

Barres de timing de transits

22.5°

4ème harmonique d'Ebertin

Astrocom

Thèmes prédéfinis

10+

Paramètres personnalisés

2,1M+ de graphiques rendus chaque mois

Utilisé par 750+ plateformes dans le monde

Précision Swiss Ephemeris garantie

Les tableaux de bord prévisionnels ont besoin de vues de timing pro — barres Gantt et éphéméride graphique — pas seulement de roues natales
La sortie Kerykeion prête à l'emploi est figée : mêmes axes, mêmes polices, même rendu sur chaque site
Aucun moyen d'imiter l'esthétique Astrocom (Astrodienst) que les astrologues traditionnels attendent
Les lignes d'aspects s'accumulent — et vous ne pouvez pas masquer des points spécifiques sans les retirer de la roue
Part of Fortune est absent du rendu en amont (pas de glyphe, pas de ligne d'aspect)
Les lignes d'axes (AC, MC, DC, IC) se rendent toutes pareilles — impossible de les épaissir ou de changer la position des étiquettes
Les astrologues de l'École de Hambourg et uraniens ne peuvent pas afficher leurs planètes hypothétiques
Les numéros de maison bloqués à un seul endroit ; aucune option de disposition en anneau intérieur
Les workflows de Cosmobiologie ont besoin de la grille 4ème harmonique d'Ebertin ; la plupart des API ne la livrent pas

Transformez avec

/api/v3/render/* est le namespace consolidé — roues de graphique, Gantt de transits, éphéméride graphique vivent tous comme frères
/render/transit-gantt : visualisation en barres horizontales des fenêtres de timing d'aspects pour tableaux de bord prévisionnels
/render/graphic-ephemeris : grille 22.5° 4ème harmonique style Ebertin traçant les planètes en lignes continues
Calques SVG nommés (g id='axes', g id='aspects', g id='planets') pour le stylage CSS en aval
3 thèmes prédéfinis : minimal, minimal-dark, astrocom-dark — choisissez un look avec un seul paramètre
Préréglage Astrocom : axes plus épais, étiquettes AC/MC/DC/IC à l'extérieur, numéros de maison centrés — directement
10+ paramètres de graphique : axis_stroke_width, axes_labels_position, house_numbers_position, axis_color, et plus encore
hide_points_in_aspects : retirez des planètes choisies des lignes d'aspects tout en les conservant sur la roue
Part of Fortune + 8 hypothétiques uraniennes rendues côté serveur
Natal, synastrie, transit, composite — même endpoint de graphique, même système de thèmes

Performance du rendu de graphiques

Kerykeion v4.26.3 vendoré avec notre couche de personnalisation

Thèmes prédéfinis

10+

Paramètres de personnalisation

SVG (post-traité)

Sortie principale

<500ms

Temps de rendu

Roue, Gantt de transits, éphéméride graphique

Endpoints de rendu

2,1M+

Rendus mensuels

SVG personnalisable, du thème jusqu'à l'axe unique

3 préréglages, 10+ paramètres, sortie de qualité Astrocom

Transit Gantt SVG

/render/transit-gantt dessine des barres horizontales pour les fenêtres de timing d'aspects. Les lignes sont des paires de planètes, les colonnes sont des dates, des traits de contact exact à l'intérieur de chaque barre.

Endpoint : /api/v3/render/transit-gantt — codé en couleur par type d'aspect, calques SVG nommés

Graphic Ephemeris SVG

/render/graphic-ephemeris trace les planètes en lignes continues sur la grille 22.5° 4ème harmonique d'Ebertin. Les rencontres de lignes marquent des aspects durs selon la logique de Cosmobiologie.

Endpoint : /api/v3/render/graphic-ephemeris — harmonique 1/2/4/8/16, fenêtre par défaut 12 mois

Standard 4ème harmonique d'Ebertin

La grille 22.5° est le standard de facto de la Cosmobiologie depuis les années 1940. Nous la livrons comme harmonique par défaut sur graphic-ephemeris.

harmonic=4 par défaut ; commutable vers 1, 2, 8, 16 par requête

Calques SVG nommés

Chaque sortie de rendu regroupe les éléments dans des calques SVG nommés (g id='axes', 'aspects', 'planets', 'bars', 'ticks') pour que le CSS en aval puisse re-styler sans parser la géométrie.

Convention de nommage d'id stable sur tous les endpoints /render/*

Namespace /render/*

Un seul namespace pour les visualisations : roues de graphique, Gantt de transits, éphéméride graphique. Les anciens chemins /svg/timing/* fonctionnent toujours pour la rétrocompatibilité.

Consolidé sous /api/v3/render/* — /svg/timing/* hérités en alias

Préréglage du thème Astrocom

Un seul paramètre (theme=astrocom) vous donne le look graphique astro.com — axes épais, étiquettes AC/MC/DC/IC à l'extérieur, numéros de maison centrés, couleur d'axe unifiée.

Combine PATCH-01, PATCH-02, PATCH-03, PATCH-04 avec une couleur d'axe #444444

Thème Astrocom-Dark

Pendant sombre d'Astrocom — mêmes patchs structurels, papier sombre, couleur d'axe unifiée ajustée pour les interfaces sombres.

axis_color=#6b7280, se superpose au dark.css de Kerykeion

Thème Minimal

Thème clair épuré avec lignes d'aspects discrètes et secteurs zodiacaux simples — pour les intégrations qui ne doivent pas s'opposer à la page.

Se superpose à classic.css, aucun patch structurel appliqué

Thème Minimal-Dark

Même look minimal sur papier sombre — fonctionne pour une interface sombre sans CSS supplémentaire.

Hérite des couleurs de papier et de secteurs zodiacaux de dark.css

Paramètre axis_stroke_width

Contrôlez l'épaisseur de rendu des cuspides d'axes AC/MC/DC/IC. 1.0 par défaut, 3.0 imite astro.com, 5.0 pour les posters muraux.

Flottant — s'applique uniquement aux cuspides d'axes (indices 0, 3, 6, 9), trait plein à 0.9 d'opacité

Paramètre axes_labels_position

Placez les étiquettes AC/MC/DC/IC à l'extérieur de la roue (gras), dans un petit anneau intérieur (graisse moyenne), ou masquez-les entièrement.

Accepte 'outside' | 'center' | null — les calculs de coordonnées réutilisent la formule de décalage de cuspide

Paramètre house_numbers_position

Rendez les numéros de maison dans un anneau intérieur à 78% du rayon (style astro.com) ou près de chaque cuspide (par défaut).

Accepte 'center' | 'near_cusp' — s'applique aussi au sujet secondaire en synastrie/transit

Glyphe Part of Fortune

Ajoutez 'part_of_fortune' à active_points — le glyphe en croix entourée se rend sur la roue et une ligne Part of Fortune apparaît dans la grille d'aspects.

Formule jour/nuit, id=23 pour garder stables les accès indexés en amont

hide_points_in_aspects

Passez un tableau de noms de points pour les retirer des lignes d'aspects et de la grille d'aspects — sans supprimer les glyphes de la roue.

Post-processeur sur la chaîne SVG — s'exécute après makeTemplate() de Kerykeion

hide_axes_visually

Gardez AC/MC/DC/IC dans le calcul mais masquez les lignes du SVG. Utile pour des vues d'intégration épurées.

Post-processeur de niveau stub — accepte un tableau de noms d'axes

Planètes hypothétiques

8 hypothétiques uraniennes / École de Hambourg — Cupido, Hadès, Zeus, Kronos, Apollon, Admetos, Vulcanus, Poséidon — rendues avec leurs propres glyphes.

À ajouter à active_points ; settings_builder injecte la configuration glyphe + couleur

En-tête double-graphique

Les graphiques de synastrie et de transit gardent leur en-tête double-sujet après la refonte du rendeur — les deux noms et les deux dates de naissance se rendent au-dessus de la roue.

Préservé à travers la façade ChartRenderer dans app/services/chart_renderer/renderer.py

Type de graphique composite

Les graphiques composites par point médian se rendent par le même endpoint avec le même système de thèmes.

chart_type='Composite' sur la façade ChartRenderer unifiée

Précision Swiss Ephemeris

Les données d'éphémérides NASA JPL pilotent chaque position planétaire, quel que soit le thème ou le type de graphique.

Précision sous l'arcseconde pour tous les corps célestes

23 systèmes de maisons

Placidus, Whole Sign, Equal House, Koch, Regiomontanus, Campanus, Morinus, Porphyry, Topocentric, et 14 autres.

Le choix du système de maisons est indépendant du thème

Surcharge des paramètres personnalisés

Passez un dictionnaire custom_settings pour surcharger n'importe quel champ du graphique par requête — couleurs, couleurs de glyphes, couleurs de papier, couleurs zodiacales.

Fusionné par-dessus les valeurs par défaut du thème ; l'appelant l'emporte

Qu'est-ce que Chart Rendering API ? L'histoire du Kerykeion vendoré

3 thèmes prédéfinis, 10+ paramètres de personnalisation, sortie de qualité Astrocom, Part of Fortune, planètes uraniennes

Chart Rendering API transforme les données de naissance en un graphique d'astrologie SVG personnalisable. Nous avons vendoré Kerykeion v4.26.3 dans notre propre base de code afin de pouvoir le patcher — cela nous a permis d'obtenir des axes plus épais, des étiquettes d'axes à l'extérieur de la roue, des numéros de maison centrés, un glyphe Part of Fortune, la prise en charge des planètes hypothétiques, et un post-processeur capable de masquer des points choisis des lignes d'aspects. Vous obtenez trois thèmes prédéfinis directement (minimal, minimal-dark, astrocom-dark), 10+ paramètres de graphique, et un seul endpoint qui gère les graphiques natal, de synastrie, de transit et composite. Le temps de rendu reste sous les 500ms.

Pourquoi avons-nous vendoré Kerykeion v4.26.3 au lieu de l'importer ?

Kerykeion est une solide bibliothèque open-source de graphiques, mais le rendeur en amont est verrouillé : largeurs d'axes fixes, pas de Part of Fortune, aucun hook pour masquer des points des lignes d'aspects, et aucune voie pour les planètes hypothétiques de l'École de Hambourg.

Nous avons copié les modules concernés dans app/vendor/kerykeion_charts/ en version 4.26.3, conservé une surface d'importation compatible, et ajouté un PATCHES.md qui suit chaque modification.

Quatre patchs numérotés (PATCH-01 à PATCH-04) plus une injection Part of Fortune couvrent les nouveaux paramètres.

Deux thèmes livrés en amont (light, dark, dark-high-contrast, classic) fonctionnent toujours comme couches de base.

Nos préréglages se superposent à ces variables CSS de base, donc les couleurs de papier sombre, les couleurs des secteurs zodiacaux et les couleurs des glyphes héritent proprement.

L'approche vendor signifie que chaque mise à niveau en amont est une revue de code — pas un changement cassant surprise en production.

Kerykeion v4.26.3 vendoré — nous maîtrisons la ligne de patchs

1 min read

Quel thème choisir : minimal, minimal-dark ou astrocom-dark ?

Trois préréglages couvrent la plupart des cas.

Minimal est un thème clair épuré : lignes d'aspects discrètes, secteurs zodiacaux simples, papier clair.

Utilisez-le pour les intégrations de blog, les cartes sociales, et les applications qui veulent un graphique qui ne se bat pas avec le reste de la page.

Minimal-dark inverse le papier en gris foncé, garde les couleurs d'aspects lisibles, et fonctionne pour les interfaces sombres.

Astrocom-dark est la version sombre du préréglage Astrocom : axes plus épais, étiquettes AC/MC/DC/IC à l'extérieur de la roue, numéros de maison centrés, couleur d'axe unifiée (#6b7280) — en gros le look graphique Astrodienst dans un habillage sombre.

Passez theme=astrocom pour la version claire, theme=astrocom-dark pour la sombre, theme=minimal pour un rendu clair épuré, ou theme=minimal-dark pour le même en sombre.

Vous pouvez toujours surcharger n'importe quel paramètre sous-jacent par requête, donc un thème est un point de départ — pas une cage.

3 préréglages : minimal, minimal-dark, astrocom-dark — plus astrocom (clair)

1 min read

Qu'est-ce que le préréglage Astrocom et pourquoi est-ce important ?

Astrocom est le look que vous voyez sur astro.com — le graphique Astrodienst que les astrologues professionnels lisent depuis les années 90.

C'est le style de référence de facto pour la tradition occidentale : lignes d'axes noires épaisses, étiquettes AC/MC/DC/IC juste à l'extérieur de la roue, numéros de maison dans un anneau intérieur plutôt qu'à côté des cuspides, et une couleur d'axe neutre unique pour que les quatre directions cardinales ne s'opposent pas.

Le préréglage astrocom combine PATCH-01 (axis_stroke_width=3.0), PATCH-02 (axes_labels_position='outside'), PATCH-03 (house_numbers_position='center') et PATCH-04 (axis_color='#444444' pour clair, '#6b7280' pour sombre).

Réglez theme=astrocom et vous obtenez les quatre d'un coup.

Pour les plateformes ciblant les astrologues traditionnels, ce préréglage à lui seul est souvent la raison pour laquelle des équipes basculent.

Le thème classic de Kerykeion a des couleurs par axe (orange/noir/bleu/rouge) ce qui jure avec une disposition plus sobre — astrocom les unifie.

Préréglage Astrocom = aspect de référence astro.com en un seul paramètre

1 min read

Comment fonctionnent les paramètres par élément ?

Cinq paramètres vous permettent de surcharger le préréglage par requête.

axis_stroke_width prend un flottant — 1.0 par défaut, 3.0 imite astro.com, 5.0 est épais comme un poster mural.

axes_labels_position accepte 'outside' (juste après la roue, gras), 'center' (petit anneau intérieur, graisse moyenne), ou null (pas d'étiquettes d'axes — comportement Kerykeion pré-patch).

house_numbers_position prend 'center' (petit anneau intérieur à 78% du rayon, police 10px, opacité 0.7) ou 'near_cusp' (par défaut, 14px, à côté de chaque cuspide).

hide_points_in_aspects prend un tableau de noms de points : passez ['Chiron','Lilith'] et Chiron et Lilith restent sur la roue mais disparaissent de toutes les lignes d'aspects et de la ligne de la grille d'aspects.

hide_axes_visually prend un tableau de noms d'axes : l'AC reste dans le calcul, mais aucune ligne n'est dessinée — utile pour les intégrations où vous voulez une roue propre.

axis_color surcharge les variables CSS par axe avec une seule couleur unifiée.

5 paramètres de patch : axis_stroke_width, axes_labels_position, house_numbers_position, hide_points_in_aspects, hide_axes_visually

1 min read

Qu'est-ce que l'endpoint /render/transit-gantt ?

/api/v3/render/transit-gantt est un rendeur SVG pour les fenêtres de timing d'aspects.

Au lieu d'une roue, vous obtenez un graphique en barres horizontales : les lignes sont des paires de planètes (par ex.

transit de Saturne sur le Soleil natal), les colonnes sont des dates, et chaque barre marque la fenêtre pendant laquelle l'aspect est en orbe.

Les dates de contact exact apparaissent en traits verticaux à l'intérieur de chaque barre.

La sortie est une vue de tableau de bord prévisionnel dont les astrologues et applications de timing ont besoin — quand ce transit commence, quand il culmine, quand il finit.

Les barres sont codées en couleur par type d'aspect (conjonction, carré, opposition, trigone, sextile) et le SVG est livré avec des calques nommés (g id='bars', g id='ticks', g id='axis') pour que le CSS en aval puisse re-styler sans parser la géométrie.

La spec vit dans docs/SPECS/06_timing_visualizations.md §A, le rendeur dans app/services/render/transit_gantt.py.

La plage temporelle, les aspects inclus et les tolérances d'orbe sont des paramètres de requête.

/render/transit-gantt — SVG en barres horizontales pour les fenêtres de timing d'aspects

1 min read

Qu'est-ce que l'endpoint /render/graphic-ephemeris ?

/api/v3/render/graphic-ephemeris est l'éphéméride graphique style Ebertin en 4ème harmonique — un classique de la Cosmobiologie depuis les années 1940.

L'axe X est le temps.

L'axe Y est la grille 22.5° (360° / 16 — la 4ème harmonique, ou quatrième division du cadran de base 22.5°).

Chaque planète trace une ligne continue qui s'enroule quand elle franchit 22.5°.

Quand deux lignes se rencontrent sur la grille, c'est un aspect dur selon la logique de la 4ème harmonique : conjonction, opposition, carré ou semi-carré.

Les praticiens de Cosmobiologie lisent ces rencontres comme des dates d'événement.

Options d'harmonique : 1 (longitude brute), 2, 4 (par défaut Ebertin), 8 ou 16.

La fenêtre temporelle par défaut est de 12 mois, configurable.

La sortie est SVG avec des calques nommés (g id='planet-sun', g id='planet-moon', etc.) afin que chaque ligne planétaire soit sélectionnable en CSS.

Spec : docs/SPECS/06_timing_visualizations.md §B.

Rendeur : app/services/render/graphic_ephemeris.py.

/render/graphic-ephemeris — grille 22.5° 4ème harmonique d'Ebertin

1 min read

Use Cases

Plateformes pour astrologues traditionnels

theme=astrocom livre le look graphique astro.com auquel les professionnels font déjà confiance

Applications modernes en mode sombre

theme=minimal-dark ou astrocom-dark s'accordent avec une interface sombre sans CSS supplémentaire

Graphiques hellénistiques avec Part of Fortune

Ajoutez 'part_of_fortune' à active_points — le glyphe et la ligne d'aspect se rendent automatiquement

Uranien / École de Hambourg

8 planètes hypothétiques (de Cupido à Poséidon) se rendent avec leurs propres glyphes

Intégrations centrées sur les aspects

hide_points_in_aspects retire les corps mineurs des lignes tout en gardant la roue intacte

Synastrie, transit, composite

Un seul endpoint, même système de thèmes, en-tête double-graphique préservé entre les types

Technical Specifications

Namespace de rendu	/api/v3/render/* (chart, transit-gantt, graphic-ephemeris)
Plage temporelle Gantt de transits	12 mois par défaut ; début/fin configurables
Harmonique éphéméride graphique	1, 2, 4 (par défaut Ebertin), 8 ou 16
Nommage des calques SVG	g id='axes' \| 'aspects' \| 'planets' \| 'bars' \| 'ticks'
Base du rendeur	Kerykeion v4.26.3 vendoré + 4 patchs numérotés
Thèmes prédéfinis	minimal, minimal-dark, astrocom, astrocom-dark
Thèmes natifs Kerykeion	light, dark, dark-high-contrast, classic
axis_stroke_width	Flottant — 1.0 par défaut, 3.0 astrocom, jusqu'à 5.0
axes_labels_position	outside \| center \| null (pas d'étiquettes)
house_numbers_position	center (anneau intérieur à r*0.78) \| near_cusp (par défaut)
axis_color	Chaîne hex — surcharge les variables CSS par axe
hide_points_in_aspects	Tableau de noms de points — le post-processeur les retire des lignes d'aspects
hide_axes_visually	Tableau de noms d'axes — gardés dans le calcul, retirés du SVG
active_points	Inclut part_of_fortune + 8 hypothétiques uraniennes
Types de graphiques	Natal, Synastrie, Transit, Composite (un seul endpoint)
Formats de sortie	SVG principal ; PNG, JPEG, WebP, PDF via conversion
Temps de rendu	<500ms typique, <1s dans le pire des cas
Systèmes de maisons	23 pris en charge (Placidus, Whole Sign, Koch, etc.)
Précision des calculs	Swiss Ephemeris (données NASA JPL)
Surcharge des paramètres	Dictionnaire custom_settings — tout champ, par requête

Kerykeion vendoré + patchs vs Kerykeion standard vs concurrents fermés

Feature	Astrology API	Others
Couverture des visualisations	Roue + Gantt de transits + éphéméride graphique (3 endpoints de rendu)	Roues natales uniquement
Base source	Kerykeion v4.26.3 vendoré — nous maîtrisons la ligne de patchs	Installation pip standard OU SDK fermé
Sortie style Astrocom	theme=astrocom — un seul paramètre	Non disponible ; style de graphique verrouillé
Thèmes prédéfinis	minimal, minimal-dark, astrocom, astrocom-dark	Aspect fixe ou 1-2 thèmes
Épaisseur du trait d'axe	Paramètre flottant, de 1.0 à 5.0+	Codé en dur à 1px
Position des numéros de maison	center \| near_cusp	Près de la cuspide uniquement
Masquer des points des aspects	Tableau hide_points_in_aspects — post-processeur	Tout ou rien ; retire entièrement du graphique
Part of Fortune	Formule + glyphe + ligne de la grille d'aspects	Non pris en charge (Kerykeion) ; varie ailleurs
Planètes hypothétiques	8 uraniennes (de Cupido à Poséidon) en natif	Rarement prises en charge
Types de graphiques	Natal, Synastrie, Transit, Composite — un seul endpoint	Souvent endpoints ou bibliothèques séparés
Voie de mise à niveau en amont	Revue de code à chaque incrément — PATCHES.md suivi	Changements cassants silencieux à la mise à jour pip
Temps de rendu	<500ms typique	1-3 secondes courant

API d'astrologie associées

Transit Gantt SVG

Visualisation en barres horizontales des fenêtres de timing d'aspects

Graphic Ephemeris SVG

Grille 22.5° 4ème harmonique style Ebertin

Natal API

Calculs de thème natal alimentant le rendeur de graphiques

Part of Fortune

Lot hellénistique — formule, glyphe, ligne d'aspect

Hypothetical Planets

École de Hambourg / Uranien — 8 hypothétiques en natif

Synastry API

Graphiques de relation avec le même système de thèmes

Composite API

Graphiques composites par point médian pour les couples

Timing API

SVG de timing age-bands et bi-wheel

Transit API

Transits en direct sur une roue natale

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Tarifs Simples et Transparents

Commencez gratuitement, evoluez selon vos besoins. Pas de frais caches.

Toujours Gratuit

Sans Carte de Credit

Parfait pour apprendre, tester et petits projets personnels

100 appels API/mois

Cartes natales de base

5 systemes de maisons

Support communautaire

Pro

11€/mois

Pour petites apps et projets personnels

Tous les endpoints de base
12 systemes de maisons
Support email

Meilleur Rapport Qualite-Prix

Pro Plus

21€/mois

Pour apps en croissance et trafic moyen

Tous les endpoints ameliores
18 systemes de maisons
Interpretations IA
Support email prioritaire

Ultra

37€/mois

Pour applications d'astrologie professionnelles

Credit math ↓

Tous les endpoints premium
23 systemes de maisons
Interpretations IA avancees
Support prioritaire

Plans Haut Volume

Pour applications a echelle entreprise

Business

99€/mois

Pour applications a haut volume

Credit math ↓

TOUS les endpoints
Pret pour marque blanche
Affinage IA personnalise
Support telephonique

ILLIMITE

Enterprise

399€+par mois

Requetes illimitees avec infrastructure dediee

Infrastructure serveur dediee
Moins de 300ms garanti
Support dedie 24/7
99,99% uptime SLA

Tous les plans incluent documentation complete et SDKs

Questions? Parlez a notre equipe

Questions fréquentes sur Chart Rendering API

Thèmes, patchs, Part of Fortune, planètes hypothétiques, et tout ce qu'il y a entre

API d'astrologie associées

Chart SVG API fonctionne au mieux aux côtés du reste de la stack. Ajoutez

Gantt de transits SVG éphéméride graphique SVG calculs de thème natal Part of Fortune planètes hypothétiques graphiques de synastrie graphiques composites roues temporelles transits en direct

Trois rendeurs SVG, un seul namespace

Roues de graphique, barres Gantt de transits, et éphéméride graphique sur la grille 22.5° 4ème harmonique d'Ebertin — le tout sous /api/v3/render/*. Thèmes Astrocom, calques SVG nommés, Part of Fortune, planètes uraniennes.

Démarrer gratuitement Voir la documentation

Gantt de transits + éphéméride graphique SVG

Grille 22.5° 4ème harmonique d'Ebertin

Calques SVG nommés pour le stylage CSS

Temps de rendu <500ms

Disponible sur le plan Ultra et au-dessus

Chart Rendering API : SVG de qualité Astrocom, vos règles

Les roues natales seules ne pilotent pas les tableaux de bord prévisionnels

Un namespace de rendu : roues, barres Gantt, éphéméride graphique

Performance du rendu de graphiques

SVG personnalisable, du thème jusqu'à l'axe unique

Transit Gantt SVG

Graphic Ephemeris SVG

Standard 4ème harmonique d'Ebertin

Calques SVG nommés

Namespace /render/*

Préréglage du thème Astrocom

Thème Astrocom-Dark

Thème Minimal

Thème Minimal-Dark

Paramètre axis_stroke_width

Paramètre axes_labels_position

Paramètre house_numbers_position

Glyphe Part of Fortune

hide_points_in_aspects

hide_axes_visually

Planètes hypothétiques

En-tête double-graphique

Type de graphique composite

Précision Swiss Ephemeris

23 systèmes de maisons

Surcharge des paramètres personnalisés

Qu'est-ce que Chart Rendering API ? L'histoire du Kerykeion vendoré

Pourquoi avons-nous vendoré Kerykeion v4.26.3 au lieu de l'importer ?

Quel thème choisir : minimal, minimal-dark ou astrocom-dark ?

Qu'est-ce que le préréglage Astrocom et pourquoi est-ce important ?

Comment fonctionnent les paramètres par élément ?

Qu'est-ce que l'endpoint /render/transit-gantt ?

Qu'est-ce que l'endpoint /render/graphic-ephemeris ?

Use Cases

Plateformes pour astrologues traditionnels

Applications modernes en mode sombre

Graphiques hellénistiques avec Part of Fortune

Uranien / École de Hambourg

Intégrations centrées sur les aspects

Synastrie, transit, composite

Technical Specifications

Kerykeion vendoré + patchs vs Kerykeion standard vs concurrents fermés

API d'astrologie associées

Transit Gantt SVG

Graphic Ephemeris SVG

Natal API

Part of Fortune

Hypothetical Planets

Synastry API

Composite API

Timing API

Transit API

References & Standards

Tarifs Simples et Transparents

Toujours Gratuit

Pro

Pro Plus

Ultra

Plans Haut Volume

Business

Enterprise

Questions fréquentes sur Chart Rendering API

Qu'est-ce que l'endpoint /render/transit-gantt ?

Qu'est-ce que l'endpoint /render/graphic-ephemeris ?

Qu'est-ce que la Cosmobiologie d'Ebertin ?

Pourquoi la 4ème harmonique 22.5° est-elle le standard ?

Les calques SVG sont-ils nommés pour le stylage en aval ?

Quels thèmes de graphique sont disponibles ?

Puis-je obtenir un graphique style Astrocom ?

Comment personnaliser l'épaisseur des axes ?

Puis-je masquer des planètes spécifiques des lignes d'aspects ?

L'API rend-elle Part of Fortune ?

Prenez-vous en charge les planètes uraniennes / École de Hambourg ?

Puis-je rendre des graphiques de synastrie, transit et composite ?

Pourquoi avez-vous vendoré Kerykeion v4.26.3 au lieu de simplement l'importer ?

Où vont les numéros de maison avec house_numbers_position='center' ?

Que fait hide_axes_visually ?

À quelle vitesse se fait le rendu ?

Quels formats de sortie j'obtiens ?

Puis-je surcharger les paramètres de thème par requête ?