sceptre2novender
================

Fuente: SCEPTRE de Wolf-Rainer Novender (THM Friedberg),
https://www.thm.de/iem/wolf-rainer-novender
Último fuente del sitio: sc1-sd2.26.131_1008.tar.gz
(nombre = año.día-del-año_hora: 11 de mayo de 2026, 10:08).

Idea
----

- cuasioriginal/ : el tarball desempaquetado más los cambios mínimos para
  que el Fortran compile limpio. Queda como referencia; no se toca más.
- nuevo/ : copia de cuasioriginal donde se cambia a fondo.

Los demás árboles (sceptre-00.317, sceptre-2012.061, sceptre-2013-0.6,
sc1-sd2 viejos) son versiones anteriores del mismo proyecto; los PDF son
la documentación original revisada (ver ref).

Cambios de cuasioriginal respecto del tarball
---------------------------------------------

1. Correcciones de compilación, manteniendo -Wall y -Wextra sin
   diagnósticos: tipos, rangos, conversiones explícitas y variables sin
   inicializar (detalle en el agregado en castellano al 00README.1st).
   Fuentes tocados:
   - sceptreM/: expscn, getarg, numprs, rrpro, strelm, stringmod, wtdat,
     wteqtn, wtsptp, xf90 (.f90) y Makefile
   - sceptreDU/: cmpv1, common_buffrs_2, eigen1, opaim, opdres, opfire,
     opmmpy, opredy, opstuf (.f90) y Makefile
   - sd2/: evalmod, pos4_interface, sd2, stringmod (.f90),
     FCreadline.c y Makefile
   - Makefile raíz y bin/sd2.tpl

2. Agregados para el flujo simul: sd2/simul_input.f90, bin/sceptre2simul,
   bin/exa.sh, samples/.sdrc y tests/.

3. El árbol quedó con los productos de compilación (bin/sc1, bin/sd2,
   lib/, *.o, *.mod); nuevo/ los hereda tal cual.

SCEPTRE de Novender, modernizado: COMO SE USA Y QUE ARCHIVOS HAY
================================================================================
(01/11/2026, paso 7 del PLAN. El 00README.1st es el del tarball original de
Novender, en ingles, y describe un arbol que ya no es este: queda como
historia.)

QUE ES, Y POR QUE COMPILA
-------------------------
SCEPTRE resuelve circuitos electricos y sistemas de ecuaciones de otra manera:
no interpreta el circuito, lo COMPILA. De un deck CASO.d la FASE 1 (sceptreM)
resuelve la topologia, arma las ecuaciones y escribe con ellas un PROGRAMA
FORTRAN; sc1 lo compila con gfortran y la FASE 2 (sceptreDU) lo corre para simular.
De ahi dos cosas que sorprenden:

  - gfortran hace falta EN CADA CORRIDA, no solo al instalar;
  - el programa de un circuito se puede guardar y reutilizar. Desde el
    01/11/2026 se reutiliza por el PROGRAMA GENERADO, asi que cambiar un VALOR
    del deck no vuelve a compilar; cambiar el circuito si.

LOS PROGRAMAS
-------------
  sc1                corre un circuito: las dos fases, con todas las opciones.
  sd2                grafica los resultados con gnuplot.
  sceptre            el nombre corto de sc1; ademas --init-user y
                     --build-runtime.
  sceptre-user-setup le arma al usuario su configuracion y sus ejemplos.
  sceptre2simul      corre un circuito y exporta el resultado al .simul de
                     Simusol.
  sceptreM, sceptreDU       las dos fases. No se llaman a mano: las llama sc1.
                     sceptreDU --servidor atiende varios circuitos en un proceso
                     (sc1 -lote).

Cada uno tiene su pagina de manual: man sc1, man sd2, man sceptre,
man sceptre-user-setup, man sceptre2simul.

LO MINIMO
---------
  sc1 a01.d          deja a01.dirac, a01.simnativo y a01.log
  sd2 a01.dirac      grafica: 'P 1 2' dibuja la variable 2 contra la 1, 'Q' sale

LOS FORMATOS
------------
LO QUE ENTRA:

  CASO.d        EL DECK, el formato de SCEPTRE. Secciones en orden: MODEL
                DESCRIPTION (los modelos, con ELEMENTS, DEFINED PARAMETERS,
                FUNCTIONS, OUTPUTS), CIRCUIT DESCRIPTION (ELEMENTS, con los
                nodos y los valores; SENSITIVITY; DEFINED PARAMETERS;
                OUTPUTS; RUN CONTROLS) y END. Los grupos OBSERVABLES,
                VARIABLES y LINEALIZADO del CIRCUIT DESCRIPTION dicen para
                que se va a usar el modelo (de que se deriva, que se mueve,
                si se quiere el modelo lineal) y solo los entiende el lector
                de slex.
  CASO.ds       un circuito de siru. sc1 lo traduce a .d con d2datdinc --d y
  CASO.ds2      corre el .d.
  modellib.dat  la biblioteca de modelos: los MODEL que el deck usa sin
                definirlos.
  usrlib.a      la biblioteca de funciones de usuario (Fortran ya compilado)
                que se enlaza con el programa generado. Para el modo dinamico
                tiene que estar compilada con -fPIC.
  fort.12       datos de una corrida anterior, para los decks que continuan.
  .sdrc         la configuracion de sd2 (el dispositivo de pantalla, el de
                papel y las ordenes de gnuplot).

LO QUE SALE:

  CASO.dirac    LOS RESULTADOS, en el formato binario POS4: una base de
                registros con las series de cada variable. Es lo que lee sd2.
                Lo escribe la fase 2 como fort.7 y sc1 lo renombra.
  CASO.simnativo  los mismos resultados en TEXTO, una columna por salida.
                Con -nosim no se deja.
  CASO.log      EL LISTADO de las dos fases: lo que leyo del deck, los avisos,
                los errores, las tablas impresas y el renglon de salida si algo
                corto. Se abre en APPEND: acumula las corridas, asi que para
                leer la ultima hay que mirar el final (o correr en un
                directorio limpio).
  CASO.so       el circuito COMPILADO, y los datos con que se corrio. Si el
  CASO.datasave deck se vuelve a correr y el programa generado sale igual, se
  CASO.huella   reutilizan y no se llama a gfortran. La huella es el md5 del
                programa generado, de la fase 2 y de la biblioteca: si no
                coincide, se rehace. Con -estatico no hay .so: el circuito se
                enlaza en un ejecutable propio.
  pgmsave.for   EL PROGRAMA FORTRAN que la fase 1 genero. Queda en el
                directorio de trabajo; es el que explica todo lo que SCEPTRE
                hizo con el circuito.
  CASO.ls1      los listados por fase, cuando se corren las fases por separado
  CASO.ls2      (es lo que hacen las pruebas: cada fase a su archivo, en vez
                del .log acumulado).

VARIABLES DE ENTORNO
--------------------
  SCEPTRE_HOME        la raiz de la instalacion; sin esto se deduce de donde
                      esta el lanzador (la instalacion se puede mover).
  TMPDIR              donde van los archivos de trabajo de las dos fases.
                      IMPORTA: para un circuito grande son enormes --dos de
                      3,25 GB en el mayor del corpus-- y si /tmp esta en
                      memoria con cuota, conviene un directorio en disco.
  SCEPTRE_LOG         el archivo del listado.
  SCEPTRE_SIN_AVANCE  segundos sin avanzar antes de cortar (300; 0 lo apaga).
  SCEPTRE_FASE1_TOPE  el tope de la fase 1 en total (1800).
  SCEPTRE_LECTOR      propio | slex          (= --lector)
  SCEPTRE_TABLAS      tabular2 | sceptre     (= --tablas)
  SCEPTRE_MODELOS     sceptre | c            (= --modelos)
  SCEPTRE_MODELO      comun | observable | lineal: cual de los modelos
                      declarados genera la fase 1.
  SCEPTRE_PARAR       1 | 2                  (= --parar)
  SCEPTRE_VERBOSE     1 | 2 | 3              (= --verbose)
  SCEPTRE_NO_CONF     no leer sceptre.conf.
  SCEPTRE_FACTOR      el factor F de esfuerzo de integracion: la fase 2
                      multiplica los pasos del deck (STARTING/MINIMUM/
                      MAXIMUM STEP SIZE) por F y los limites de error por
                      F**2, en cada corrida y cada RERUN. F < 1 integra mas
                      fino; F > 1 mas grueso; actua solo sobre los controles
                      explicitos. Es para comparar metodos gastando el mismo
                      tiempo (siru/doc/6elementos-integradores) y para el
                      patron del corpus minimo.
  D2DATDINC           el programa que expande los MODEL con --modelos c, y
  D2DATDINC_BIB       su biblioteca y sus reglas de slex.
  D2DATDINC_CONF

Y la configuracion del usuario, ~/.config/sceptre/sceptre.conf, que
sceptre-user-setup le deja armada. Las opciones de la linea de comando le ganan.

CUANDO ALGO FALLA
-----------------
Toda salida anormal escribe UN renglon que dice el codigo, el archivo, la
linea, la rutina y el motivo:

  SCEPTRE: SALIDA | 96 | 16:22:42 | cuota_sd2.f90 | CUOTA | no queda lugar: ...

Los que mas se ven: 91 el circuito pasa los 999 elementos (los nombres del
programa generado no entran); 96 no queda lugar donde la corrida escribe, con
el directorio y como pasarlo; 103 falto modellib.dat y la corrida siguio; 106 a
109 son de sc1 (uso, el deck no existe, falta una pieza, el generado no
compilo); 110 la lectura del deck encontro un error grave; 118 la corrida no
avanzaba y se corto, guardando lo que habia calculado; 85 el .so guardado no es
de esta fase 2 (correr con -rehacer). La lista completa esta en pasos/SALIDAS.

COMPILAR E INSTALAR
-------------------
Desde el paquete (.deb, .rpm, .tgz): se instala y listo; gfortran es
dependencia de EJECUCION.

Desde las fuentes, dos caminos que conviven:

  autotools, el del paquete y el de 'make check':
     autoreconf -i ; mkdir build && cd build
     ../configure --with-corpus=/ruta/al/corpus && make && make check
     (el build va en un directorio APARTE: el arbol tiene los .o del otro
      camino y a VPATH le estorban; configure avisa)

  los Makefile artesanales, los del trabajo diario:
     make -C sceptreM ; make -C sceptreDU ; make -C sd2 ; make sync

LAS PRUEBAS
-----------
  make check                  el corpus entero contra sus patrones
  tests/check-corpus.sh       lo mismo, desde el arbol (CORPUS=... ARBOL=...)
  tests/prueba-*.sh           una por tema: los dos lectores, la reentrancia,
                              el latido, el .so, el disco lleno, el lugar que
                              queda, la salida de terminal, el vectorial...
Cada una dice al final cuantas fallas tuvo. Las que piden un corpus lo reciben
por CORPUS; tests/valores trae el suyo.

HAY DOS CORPUS (09/11/2026, pedido del autor), porque el grande no cabe en el
tarball:

  corpus-minimo/   DIEZ decks, muy distintos entre si (transitorio, AC,
                   ecuaciones sin circuito, modelos, llaves resistivas, los
                   tres metodos de integracion sobre el mismo motor, mutuas,
                   PARAPLOT), con varios DU por cada M. ES EL QUE VIAJA: un
                   "make check" del tarball corre este y compara el error rms
                   y el tiempo contra su patron (tests/check-corpus-minimo.sh,
                   corpus-minimo/LEEME).
  corpus/          los 105 casos con sus patrones completos, 25 MB. NO viaja:
                   es su propio paquete, sceptresimusol-corpus, armado con
                   automake y summapack ahi mismo (corpus/LEEME). Se corre
                   diciendole a configure donde quedo:

                     ./configure --with-corpus=/usr/share/sceptresimusol/corpus

                   Sin corpus grande, el "make check" se saltea esa parte y lo
                   dice; no es una falla.

LA DOCUMENTACION
----------------
  docs/sc1-sd2.pdf            la guia de sc1 y sd2
  docs/pos4.pdf               el formato POS4 del .dirac

Y aparte, en extra-docs/, el MATERIAL DE REFERENCIA (09/11/2026, pedido del
autor): no es documentacion de este programa sino de donde viene, escaneado y
sin fuente, y son 46 de los 50 MB del tar.gz de fuentes.

  extra-docs/ibm-astap-gh20-1271-catalogo.pdf   el catalogo de ASTAP de IBM
                              (GH20-1271), 317 paginas, 37 MB; ASTAP es el
                              programa del que viene esta familia
  extra-docs/SCEPTRE-Vol12-de.pdf   el manual Vol 1-2 de SCEPTRE de Novender,
                              en aleman, 175 paginas
  extra-docs/SCEPTRE-beispiele.pdf  sus ejemplos, en aleman, 283 paginas
  doc/mapas/                  los mapas de rutinas y llamadas, regenerables
                              con 'make mapas'

Y, en las fuentes del proyecto (no en el paquete), un archivo por cambio en
pasos/, cada uno con su diff y su verificacion medida; pasos/DEFECTOS con los
defectos encontrados, su estado y como se reproducen; pasos/ESTADO con la foto
del dia.
