Diagramas y representación

01 · Punto de partida

Un dibujo acordado vale páginas

El mismo tanque se dibuja de tres maneras: bloques (quién se conecta con quién), flujos (qué se acumula y a qué tasa) y estados (en qué modo está y cómo cambia). Cada diagrama responde una pregunta distinta del mismo modelo.

• ¿Quiero mostrar estructura, acumulación o modos?
• ¿Cada símbolo significa lo mismo para todos?
• ¿El diagrama alcanza para programar sin preguntar?
• ¿Dibujo y código cuentan la misma historia?

02 · Tres lenguajes

Bloques, flujos y estados

03 · Gramática

Reglas para que se entienda

1. 1
   Un símbolo, un significado.

   La flecha siempre es flujo o siempre es información: nunca ambas sin leyenda.

2. 2
   Nombrá todo.

   Caja sin nombre es adorno; flecha sin etiqueta es adivinanza.

3. 3
   Un diagrama, una pregunta.

   El que cuenta todo no cuenta nada: separá estructura, acumulación y modos.

4. 4
   Leyenda y frontera.

   Qué significa cada forma y dónde termina el dibujo.

Stock

Acumulación: nivel, cola, stock. Lo que guarda memoria.

Tasa

Flujo por unidad de tiempo con su válvula de control.

Transición

Cambio de modo con su guarda explícita.

Leyenda

Diccionario visual de símbolos del diagrama.

04 · Del dibujo al código

Traducción directa

Si el diagrama está bien hecho, programar es traducir: cada símbolo tiene su línea de código esperándolo.

05 · En Python

Diagramas como datos que se ejecutan

diagrama = {
    "nodos": ["entradas", "tanque", "salida"],
    "aristas": [("entradas", "tanque"), ("tanque", "salida")],
}


def roto(diagrama):
    # Toda flecha debe unir nodos existentes.
    nodos = set(diagrama["nodos"])
    return [(a, b) for a, b in diagrama["aristas"] if a not in nodos or b not in nodos]


print("roto:", roto(diagrama))

Motor guiado por el diagrama

def correr(pasos, entrada, salida):
    # Nodos en orden: entradas -> tanque -> salida.
    tanque = 10
    historia = []
    for t in range(pasos):
        tanque = max(tanque + entrada - salida, 0)
        historia.append(tanque)
    return historia


print(correr(4, 3, 2))

06 · Exploración

Laboratorio: tres dibujos, un tanque

Cambiá de estilo y compará cómo se ve el mismo sistema en bloques, flujos y estados. Activá etiquetas y resaltado para leer cada gramática.

Bloques cuenta conexiones, flujos cuenta acumulación y estados cuenta modos: tres preguntas, tres dibujos.

Preguntas para explorar

1. ¿Qué estilo muestra el tope del tanque? ¿Y la bomba por umbral?
2. Apagá las etiquetas. ¿El dibujo sigue programable?
3. ¿Qué diagrama pedirías para discutir capacidad? ¿Y para discutir modos?

07 · Comprensión

Confusiones frecuentes

08 · Práctica guiada

Ejercicios con Python

Ejercicio 1: auditar el dibujo

¿Este diagrama tiene flechas rotas? Ejecutá el validador.

def roto(diagrama):
    nodos = set(diagrama["nodos"])
    return [(a, b) for a, b in diagrama["aristas"] if a not in nodos or b not in nodos]


bueno = {"nodos": ["a", "b"], "aristas": [("a", "b")]}
malo = {"nodos": ["a"], "aristas": [("a", "b")]}
print(roto(bueno), roto(malo))

Ejercicio 2: motor mínimo

Corré 4 pasos con entrada 3 y salida 2 desde 10. ¿Historia?

def correr(pasos, entrada, salida):
    tanque = 10
    historia = []
    for t in range(pasos):
        tanque = max(tanque + entrada - salida, 0)
        historia.append(tanque)
    return historia


print(correr(4, 3, 2))

Ejercicio 3: elegir el lenguaje

Asigná diagrama a cada pregunta: ¿quién se conecta?, ¿dónde se acumula?, ¿cuándo conmuta la bomba?

asignacion = {
    "quien se conecta": "bloques",
    "donde se acumula": "flujos",
    "cuando conmuta": "estados",
}
for p, d in asignacion.items():
    print(p, "->", d)

09 · Síntesis

Ideas para recordar

En el próximo tema escribiremos el modelo en su idioma más preciso: la formulación matemática.