Modelo Geométrico 🐚 — Modelo de enrollamiento espiral para educación

Hola, exploradoras y exploradores. Este repositorio convierte la idea del paleontólogo David M. Raup (1961-1966) en código abierto y visual. Con cuatro números —W (expansión), D (apertura), T (traslación) y S (forma de apertura, circle o ellipse)— generamos superficies de concha espiral en 3D. Es una formulación secundaria (Filin 2026, pendiente de contraste con Raup 1966); no sustituye análisis profesionales.

Qué hace (y qué no hace)

  • Sí: implementa el modelo geométrico con cabeceras SPDX (AGPL-3.0-or-later), tests (pytest), CI (ruff, mypy) y una figura reproducible (scripts/render_figures.py).
  • No: no valida contra los artículos originales (ver docs/ecuaciones.md y README).
  • Estado: main limpio (ruff, pytest 65 passed), con protección pendiente (main sin branch protection aún configurada).

Datos técnicos exactos (verificados en main)

Parámetro Significado Valor por defecto Restricción
W Tasa de expansión (whorl expansion) 2.0 W >= 1
D Apertura radial ((r-a)/(r+a)) 0.5 0 <= D < 1
T Traslación vertical (z = T * r) 0.1 T >= 0
S Forma generadora circle circle (exige rho == 1) o ellipse
rho Razón de ejes (b/a) 1.0 rho > 0

El archivo tests/test_model.py cubre 65 casos; src/model.py define generate_shell, generate_curve y whorl_overlap (ecuación S8 de Filin 2026). La figura del README se genera con código, no es ilustración manual.

Cómo probarlo (sin instalar nada) 

git clone https://github.com/amurlaniakea/raup-shell-model python -m venv .venv && . .venv/bin/activate pip install -e ".[dev]" python scripts/render_figures.py --check

Licencia y gobernanza

  • Licencia: AGPL-3.0-or-later. Cada archivo .py lleva cabecera SPDX (SPDX-FileCopyrightText: 2026 Pedro Sordo Martínez).
  • CITATION.cff incluido para referencias académicas.
  • Nota de transparencia: los cambios recientes (figuras) se publican en rama dedicada (figuras), no en main directa, siguiendo el estándar del repositorio.

Un proyecto abierto para jóvenes científicos

No es "marketing": es código real con errores documentados (docs/), licencia legal y una invitación explícita: lee, prueba, cuestiona. Si eres educadora o educador, puedes usarlo para enseñar geometría diferencial sin depender de software cerrado. La base matemática es accesible; la implementación es honesta.

Repo: https://github.com/amurlaniakea/raup-shell-model

Estado del proyecto: ver README.md → sección Estado del proyecto.

Este artículo presenta datos verificados por ejecución local (ruff, pytest, git log) y por lectura remota (curl -A Mozilla/5.0 al README.md de main). No hay afirmaciones inventadas: el error IndentationError descrito en auditorías externas no existe en los archivos actuales (py_compile limpio, líneas 87, 238, 278 sin error).