Introduccion
============

Este es Calcula 6.0: resuelve sistemas de ecuaciones por modulos (dados
tantos datos como grados de libertad, halla las demas variables con Newton
y GSL). Su modulo psicro es la calculadora psicrometrica que hasta la
version 5.0-15 fue el programa Psicro; los otros modulos son pendulo y
modulodinamico (variables y ecuaciones leidas de un archivo).

Nombres desde la 6.0: ejecutable calcula, bibliotecas
libcalcula-<modulo>.so (cargadas con dlopen), variables de entorno
calcula_<opcion>, configuracion ~/.calcula y /etc/calcula.conf, paquete
Debian calcula. El lenguaje de entrada y los resultados son los de psicro
5.0.

Es software libre.
Se distribuye bajo la licencia publica general GNU (GPL), version 3 o
posterior (hasta la 5.0, Psicro era AGPL; Puyuspa, la interfaz web, sigue
siendo AGPL). Vea el archivo
COPYING. 

Para mas informacion vea el manual en doc/manual-6.0 del repositorio
(Calcula 6.0, el sistema psicro y Puyuspa 6.0), NEWS y debian/changelog
(o /usr/share/doc/calcula si instalo el paquete). El modulo dinamico, que toma
variables y ecuaciones de un archivo, esta descripto en MODULODINAMICO.md,
con los sistemas de ejemplo en sistemas/ (o /usr/share/calcula/sistemas).

Sistemas: calcula no tiene sistema por defecto. Se nombra con -s SISTEMA
(o %SISTEMA; al comienzo de la linea de datos, o sistema=SISTEMA en
~/.calcula); calcula --sistemas los lista. Cada sistema es un archivo
<id>.sis que dice que modulo usa y, si es del modulo dinamico, su .din:

    calcula --sistemas
    calcula -s psicro -p t=25,wr=.5,alt=0
    calcula -s circuito-carga -p r=10,c1=1,c2=2,v1=4,v2=4

Los sistemas propios van en ~/.local/share/calcula/sistemas.

Para construir un modelo, comenzar por [Escribir modelos para Calcula](ESCRIBIR-MODELOS.md): ejemplos completos con .dsa, llaves, lazos y cortes, las alternativas .d/.ds/.din y módulos binarios, y qué se comparte con el modelado para Siru y SCEPTRE.

Modelos fuente .d, .ds y .dsa
------------------------

Con Siru instalado, Calcula también acepta un .d, .ds o .dsa como fuente del modelo. Siru prepara sus ecuaciones, circuito y datos iniciales para resolver un punto por cada línea de datos, sin avanzar el tiempo, aunque el archivo declare Runge-Kutta. Los módulos binarios, los sistemas registrados y la entrada directa de .din conservan sus comandos.

    calcula modelo.d                         # punto inicial del archivo
    calcula modelo.ds -p 'j1=2,r2=3'         # otros datos; admite unidades
    calcula modelo.dsa -p 'x=3'             # mismo tipo de modelo fuente
    calcula modelo.d datos.txt               # una línea por punto
    printf 'j1=2,r2=3\nj1=3,r2=4\n' | calcula modelo.d

Los datos pueden ir también como comentarios al final del modelo; cada línea dentro del bloque es un punto. Los valores iniciales del modelo completan los datos que falten en una línea. Para elegir otras variables como datos, se pueden indicar tantas como grados de libertad tenga el sistema.

    # CALCULA DATOS
    # j1=2,r2=3
    # j1=3,r2=4
    # FIN CALCULA DATOS

El llamador conserva una sesión de Calcula durante las líneas sucesivas. La salida se escribe en la terminal. La integración con Puyuspa permite subir el mismo .d/.ds y darle líneas de datos desde el navegador.

El modelo es el archivo fuente con sus recursos. La nueva carga conserva esa identidad y prepara una representación .dat y un sistema .din en un directorio temporal; no escribe derivados junto al archivo del usuario. Las rutas de recursos se resuelven desde el directorio del modelo. Los datos omitidos se toman de los iniciales, mientras que las semillas conservan su función numérica. Se puede calcular una derivada en un punto sin pedir una trayectoria.

La operación solicitada a Calcula es resolver puntos. No ejecuta RERUN, AC, sensibilidad, optimización, barridos ni las órdenes SPICE incluidas en USOS. Conserva las ecuaciones, los modelos de elementos, funciones, tablas y datos necesarios para el punto; no convierte el archivo fuente a otro modelo permanentemente.

Para .dsa se usa el lector Slex y el adaptador estricto de siru/slex/dsa/python/traducir.py. Desde el árbol se encuentra automáticamente; fuera del árbol se indica CALCULA_DSA=/ruta/a/traducir.py, con sus módulos y dependencias disponibles. CALCULA_SIRU permite elegir el ejecutable siru. Este cambio no instala ni publica el adaptador ni agrega la carga web de .dsa a Puyuspa.

Llaves, lazos y cortes
---------------------

El llamador coordina los sistemas derivados del mismo modelo fuente mediante Siru::PuntoModelo y Siru::Preparador. Usa las ecuaciones de instante y de equilibrio generadas por libdin, las mismas que utiliza Siru: no reproduce las leyes de los elementos dentro de Calcula ni ejecuta un paso de integración.

| Etapa | Comportamiento |
|---|---|
| Datos del caso | Lee parámetros, estados iniciales, tiempo y voltajes iniciales de capacitores; acepta unidades con la misma conversión que la consola. |
| Configuración inicial | Resuelve las condiciones de las llaves antes de aplicar trasvases; la configuración de prueba con todas abiertas no impone un equilibrio ficticio. |
| Lazos y cortes | Resuelve el trasvase instantáneo de cargas o flujos mediante el sistema de equilibrio de libdin. Conserva los acoplamientos y las leyes no lineales que dicho generador admite. |
| Fuentes | Respeta la regla de Siru para estados impuestos por fuentes: sin condición inicial explícita no inventa un impulso desde cero; con condición explícita calcula el trasvase. |
| Estabilización | Vuelve a resolver el instante y las condiciones de las llaves después del equilibrio; repite si cambian. Un ciclo repetido sin configuración estable informa «circuito imposible»; el límite de 256 cambios informa falta de estabilización, sin entregar un punto como válido. |
| Reutilización | Conserva sistemas y sesiones por configuración. Cada línea empieza con sus propios datos y los valores iniciales del archivo; no hereda el estado físico del caso anterior. |
| Resultados | Informa configuración, cambios instantáneos de estado y valores finales, incluidas las derivadas. El tiempo no avanza. |

Para los modelos que requieren esta coordinación, las líneas de entrada son asignaciones de parámetros, estados, tiempo o voltajes iniciales. La elección inversa arbitraria de datos de salida todavía no está incorporada a este coordinador; se rechaza explícitamente. La entrada simple de un solo sistema conserva su elección de datos anterior. No indicar a la vez la carga y el voltaje inicial del mismo capacitor. Las semillas numéricas no son condiciones físicas del caso.

La aceptación de .dsa sigue limitada a las construcciones que el adaptador ya traduce; lo no implementado se rechaza explícitamente. Este llamador no se combina con --machine: el coordinador mantiene sus propias sesiones internas del protocolo. Se requieren las versiones de Calcula y Siru con la operación DATOS del protocolo, que normaliza unidades sin resolver prematuramente el circuito. Esta integración no instala ni publica versiones nuevas.

Instalación para usuarios
------------------------

La guía pública única es https://www.simusol.org/downloads/0-README-como-instalar.

    curl -fsSLO https://www.simusol.org/downloads/sp
    sh sp --para fuentes calcula

Esta única orden instala SummaPack, Calcula y sus dependencias; no hace falta instalar SummaPack antes. --para fuentes compila e instala en /usr/local con registro de archivos. --para fuentes-paquete construye .deb o .rpm; --para deb usa binarios Debian/Ubuntu. Son alternativas. La guía explica también --prueba. Después se usa sp install calcula, sp remove calcula o sp search gsl.

Compilación para desarrollo
--------------------------

Para compilarlo e instalar ejecute ./configure en el directorio raiz
de la distribucion, luego make y make install. El tar.gz publicado ya trae
configure: no hace falta autoconf, automake ni libtool.

Desde la copia de svn, antes, una vez (hace falta autoconf, automake y
libtool; instalar.am, dist.am y m4/summapack.m4 salen de calcula.summa y
MANIFIESTO):

python3 ../../siru/summapack/share/summapack/data/summa.py automake .
autoreconf -fi

El archivo INSTALL contiene instrucciones genericas de como
instalar distribuciones configuradas con autoconf.
 
Bugs y sugerencias
==================

Debe enviarlos a dsa@unsa.edu.ar

Página https://www.simusol.org/?Psicro-Calcula (psicro.org redirige a simusol.org).



sudo zypper install gsl gsl-devel
