Skip to content

fransolerc/astro-cycles

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌌 Astro-Cycles Calculator


🇪🇸 Español

(Calculadora de ciclos y aspectos astronómicos)

🎯 Descripción

Astro-Cycles es una aplicación web ligera y de alto rendimiento diseñada para visualizar tránsitos planetarios, ciclos sinódicos e índices armónicos. Construida bajo la filosofía "No-Framework", utiliza tecnologías nativas para maximizar la velocidad y precisión en el renderizado de datos astronómicos complejos directamente en el navegador.


✨ Características Principales

  • 🛰️ Tránsitos Planetarios (T-T): Visualización de la separación angular entre pares de planetas.
  • 🌙 Tránsitos Natales (T-N): Interacción entre planetas actuales y una carta natal personalizada.
  • ⚖️ Índice Armónico: Puntuación de "tensión" o "armonía" basada en aspectos configurables.
  • 📈 Gráfico Dinámico (Canvas): Renderizado de alto rendimiento con inspección interactiva de datos al pasar el ratón o tocar la pantalla.
  • 📱 Optimización Móvil: Interfaz adaptativa y controles táctiles optimizados para tablets y smartphones.
  • ⚙️ Altamente Configurable: Control total sobre orbes, suavizado (smoothing), modos de visualización (180°/360°) y aspectos activos.

🛠️ Arquitectura y Stack

El proyecto sigue un diseño modular para mantener la escalabilidad sin la carga de frameworks pesados:

  • Vanilla JavaScript (ES6+): Lógica desacoplada en módulos (Cálculo, Estado, UI, Renderizado).
  • HTML5 Canvas: Motor de dibujo de alto rendimiento para series temporales densas.
  • CSS3 Moderno: Diseño basado en variables y flexbox con soporte nativo para modo oscuro.

⚙️ Ejecución

Al ser una aplicación estática, no requiere servidor:

  1. Clona el repositorio.
  2. Abre index.html en tu navegador.

🇺🇸 English

(An Astronomical Cycle and Aspect Calculator)

🎯 Description

Astro-Cycles is a lightweight, high-performance web application for visualizing planetary transits, synodic cycles, and harmonic indices. Built with a "No-Framework" philosophy, it leverages native web technologies to maximize speed and precision when rendering complex astronomical data directly in the browser.


✨ Core Features

  • 🛰️ Planetary Transits (T-T): Visualizes the angular separation between pairs of planets over time.
  • 🌙 Natal Transits (T-N): Displays transits against a predefined birth chart.
  • ⚖️ Harmonic Index: A scoring system representing global "tension" or "harmony" based on active aspects.
  • 📈 Dynamic Graph (Canvas): High-performance rendering engine with interactive data inspection via mouse or touch.
  • 📱 Mobile Optimized: Responsive layout and touch-friendly controls designed for tablets and smartphones.
  • ⚙️ Highly Customizable: Dynamic adjustment of orbs, smoothing factors, display modes (180°/360°), and active aspects.

🛠️ Architecture & Stack

The project follows a modular design to ensure scalability without the overhead of heavy frameworks:

  • Vanilla JavaScript (ES6+): Logic decoupled into specialized modules (Astronomy, State, UI, Rendering).
  • HTML5 Canvas: High-efficiency drawing engine for dense astronomical time series.
  • Modern CSS3: Variable-based styling and flexbox layouts with native dark theme support.

⚙️ Setup

As a static application, no server is required:

  1. Clone the repository.
  2. Open index.html in your browser.

About

Astronomical cycle and aspect calculator — planetary transits, synodic cycles and harmonic index. Pure HTML/JS, no dependencies.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors