You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Documento normativo de nomenclatura. Versión 1.0 · Lineamiento de diseño: Formal Mathematic Abstract (FMA) Referencia canónica: HVA_Formalismo_Matematico_v2.docx (en adelante FORM) Alcance: Todo símbolo público del paclet cuyo nombre pueda derivarse de un concepto del formalismo DEBE usar la terminología de este glosario. La sección 5.7 de la spec fija el idioma (inglés); este documento fija el vocabulario semántico.
Principio rector del lineamiento FMA
Leer código HVA debe ser equivalente a leer el formalismo matemático. Cada nombre de símbolo público es una proyección del concepto formal al espacio de identificadores Wolfram. El test de validez de un nombre es: ¿un ingeniero que conoce FORM Def. 2.1 puede inferir el tipo matemático del objeto sin leer la implementación?
Si la respuesta es no, el nombre no respeta este lineamiento.
Bloque I · La tupla del agente 𝒜
Origen formal: FORM Def. 2.1 — 𝒜 = ⟨id, Q, X, U, Y, ℱ, 𝒢, ℐ, ℳ, ℋ, 𝒞, q₀, ν₀⟩
id — Identificador de agente
Atributo
Valor
Símbolo formal
id ∈ 𝕀
Tipo matemático
Elemento de un conjunto de identificadores únicos
Término canónico
AgentId
Términos prohibidos
AgentName, AgentKey, AgentTag (no reflejan el rol de identidad dentro del sistema multi-agente)
Referencia
FORM Def. 2.1, Def. 3.1 (indexación de agentes por I)
Q — Modos discretos
Atributo
Valor
Símbolo formal
Q — conjunto finito de modos discretos del autómata híbrido
Tipo matemático
Conjunto finito de etiquetas cualitativas de régimen operacional
Término canónico
Mode (sustantivo), AgentModes (accessor), ModeSet (cuando se refiere al conjunto completo)
Términos prohibidos
State como sinónimo de modo (reservado para el estado completo s(t)), AgentStates (ambiguo)
Justificación
En la microgrid: {Charging, Discharging, Idle, Fault} son modos, no estados. State queda reservado para FORM Def. 2.2.
Referencia
FORM Def. 2.1, §8.1 (instanciación Batería)
X — Espacio de estado continuo
Atributo
Valor
Símbolo formal
X ⊆ ℝⁿ — variedad del espacio continuo
Tipo matemático
Subconjunto de ℝⁿ; sus elementos son valuaciones de variables físicas medibles
Término canónico
ContinuousStateSpace (el espacio), ContinuousVars (la lista de variables simbólicas), AgentContinuousVars (accessor)
Términos prohibidos
AgentVars (demasiado genérico; no distingue de variables discretas), Variables (ambiguo)
Justificación
En la batería: {SoC, T, P, I} son las variables de X. El nombre debe señalar que son continuas y físicas.
Referencia
FORM Def. 2.1, Def. 2.2 (valuación ν : X → ℝ)
U — Espacio de entradas de control
Atributo
Valor
Símbolo formal
U ⊆ ℝᵐ — espacio de entradas
Tipo matemático
Subconjunto de ℝᵐ; señales que el agente recibe del entorno o de otros agentes
Término canónico
ControlInputSpace (el espacio), ControlInputVars (la lista), AgentControlInputs (accessor)
Términos prohibidos
Inputs, Commands (no reflejan la posición en la tupla ni el tipo matemático)
Justificación
En la batería: {P_cmd} es el vector de control. El nombre debe distinguir entradas de control (U) de salidas observables (Y).
Referencia
FORM Def. 2.1, Def. 2.3 (aparece en el campo vectorial como ℱ(q)(ξ, u))
Y — Espacio de salidas observables
Atributo
Valor
Símbolo formal
Y ⊆ ℝᵖ — espacio de salidas
Tipo matemático
Subconjunto de ℝᵖ; proyección observable del estado continuo
Término canónico
ObservableOutputSpace (el espacio), ObservableVars (la lista), AgentObservables (accessor)
Términos prohibidos
Outputs, Readings
Referencia
FORM Def. 2.1
ℱ — Familia de campos vectoriales
Atributo
Valor
Símbolo formal
ℱ : Q → Vect(X×U) — familia de campos vectoriales por modo
Tipo matemático
Función que asigna a cada modo discreto un campo vectorial (EDO) sobre X×U
Término canónico
VectorField (singular, por modo), VectorFields (colección), AgentVectorFields (accessor), ModeVectorField[agent, mode] (accessor por modo)
Términos prohibidos
AgentDynamics (demasiado genérico; "dynamics" puede referir a cualquier comportamiento temporal), Equations, ODEs (son la realización operacional del campo, no el campo mismo)
Justificación
ℱ es una función Q → Vect(X×U). El nombre debe señalar esa estructura: es una familia indexada por modo de objetos de tipo campo vectorial.
Referencia
FORM Def. 2.1, Def. 2.3 (transición continua: Dₜ ξ = ℱ(q)(ξ, u)), B3 (Lipschitz-continuidad del campo)
𝒢 — Relación de transición discreta (guardas y resets)
Atributo
Valor
Símbolo formal
𝒢 ⊆ Q × Φ × A × Q — conjunto de cuádruplas (q, φ, α, q′)
Tipo matemático
Relación entre modos con predicado de guarda φ y acción de reset α
Término canónico
Transition (una cuádrupla), TransitionRelation (el conjunto completo), AgentTransitions (accessor), TransitionGuard (el predicado φ), TransitionReset (la acción α)
Términos prohibidos
AgentGuards (nombra solo el componente φ, no la cuádrupla completa; oculta el reset), Switches, Jumps
Justificación
Cada elemento de 𝒢 es una cuádrupla; Guard nombra solo uno de los cuatro componentes. En la batería: (Idle, P_cmd > 0, ν, Charging) es una Transition, no una Guard.
Referencia
FORM Def. 2.1, Def. 2.4 (transición discreta por guarda), B2 (bien-formación: transiciones no violan invariantes de destino)
ℐ — Invariantes por modo
Atributo
Valor
Símbolo formal
ℐ : Q → Pred(X) — familia de predicados por modo
Tipo matemático
Función que asigna a cada modo un predicado lógico sobre X que debe mantenerse mientras el agente permanece en ese modo
Término canónico
ModeInvariant (el predicado de un modo específico), ModeInvariants (la colección), AgentModeInvariants (accessor), ModeInvariantOf[agent, mode] (accessor por modo)
Términos prohibidos
AgentInvariants sin calificador de modo (confunde con el invariante global del sistema Φ de FORM Def. 3.1), SafetyConstraints
Justificación
Distingue explícitamente ℐ(q) (invariante local por modo, componente de la tupla del agente) de Ψ (invariante inductivo a verificar, FORM Def. 4.1) y de Φ (propiedad global del sistema, FORM Def. 3.1).
Referencia
FORM Def. 2.1, Def. 2.3 (ℐ(q)(ξ(s)) ≡ ⊤ durante flujo continuo), B1 y B2 (bien-formación)
ℳ — Alfabeto de mensajes
Atributo
Valor
Símbolo formal
ℳ ⊆ 𝒯(Σ, V) — subconjunto del lenguaje de términos sobre la signatura algebraica
Tipo matemático
Lenguaje formal: conjunto de expresiones simbólicas pattern-matcheables admisibles para este agente
Término canónico
MessageAlphabet (el conjunto ℳ), AgentMessageAlphabet (accessor), MessageTerm (un elemento m ∈ ℳ)
Términos prohibidos
MessageQueue (confunde ℳ con μ(t), el mailbox), MessageType, MessageSchema
Justificación
ℳ es el lenguaje de mensajes admisibles, no la cola de mensajes pendientes. La cola es μ(t) (componente del estado, FORM Def. 2.2). La distinción es fundamental para la semántica del dispatcher.
Referencia
FORM Def. 2.1, §1.1 (términos sobre signatura Σ), Def. 2.5 (unificación de mensajes)
ℋ — Handlers como reglas de reescritura
Atributo
Valor
Símbolo formal
ℋ ⊆ Pat(ℳ) × Pred × Act — conjunto de triples (π, φ, α)
Tipo matemático
Conjunto de reglas de reescritura condicional donde π es un patrón, φ una guarda y α una acción
Variables de contrato en el modelo causal (FORM Def. A.12)
Variable
Término canónico
Semántica
A_𝒜
ContractAssumptionIndicator
Booleano: asunciones del contrato se mantuvieron antes del incidente
G_𝒜
ContractGuaranteeIndicator
Booleano: garantías del contrato se mantuvieron
Bloque IX · Semánticas denotacionales (FORM §7)
Origen formal: FORM Def. 7.1, Teorema 7.2 — tres semánticas sobre la misma representación
Semántica
Símbolo formal
Término canónico
Realización
Simbólica
⟦𝒜⟧ₛ
SymbolicSemantics
Verificación por Resolve / CylindricalDecomposition
Numérica
⟦𝒜⟧ₙ
NumericalSemantics
Simulación por NDSolve + WhenEvent
Ejecucional
⟦𝒜⟧ₑ
ExecutionalSemantics
Ejecución contra hardware a través de adapters
Principio de representación unificada: las tres semánticas operan sobre la misma estructura simbólica. Un nombre que sugiera representaciones paralelas viola P1 de METHODOLOGY §2.
Equivalencia de semánticas ⊆_ε
Concepto
Término canónico
Significado
⟦𝒜⟧ₙ ⊆_ε ⟦𝒜⟧ₛ
NumericalSoundness
La simulación queda dentro del envelope verificado (módulo ε)
⟦𝒜⟧ₑ ⊆_ε,η ⟦𝒜⟧ₙ
ExecutionalFidelity
La ejecución real queda dentro de la simulación (módulo error y ruido)
Margen residual ε
VerificationMargin
Brecha entre el límite del invariante y la trayectoria verificada
Error de modelo η
ModelFidelityError
Diferencia entre el modelo simbólico y la planta real (CPV1)
Bloque X · Validez ciberfísica (FORM §6)
Origen formal: FORM §6 — condiciones CPV1–CPV3 y Teorema C.8
Condición
Término canónico
Semántica
CPV1
ModelFidelityCondition
El modelo simbólico captura la dinámica de la planta física con error acotado
CPV2
SamplingRateCondition
El periodo de muestreo Δ ≤ Δ_max garantiza que el invariante no se viola entre muestras
CPV3
ActuationLatencyCondition
La latencia Sense→handler→Actuate no excede el horizonte de invariancia local
Tabla de correspondencia completa: símbolo formal → término canónico → accessor
Símbolo formal
Tipo
Término canónico (concepto)
Accessor Wolfram
Prohibido
id
Identificador
AgentId
AgentId
AgentName, AgentKey
Q
Conjunto de modos
ModeSet
AgentModes
AgentStates
X
Espacio continuo
ContinuousStateSpace
AgentContinuousVars
AgentVars
U
Espacio de control
ControlInputSpace
AgentControlInputs
Inputs
Y
Espacio observable
ObservableOutputSpace
AgentObservables
Outputs
ℱ
Campos vectoriales
VectorFields
AgentVectorFields
AgentDynamics
𝒢
Transiciones
TransitionRelation
AgentTransitions
AgentGuards
ℐ
Invariantes por modo
ModeInvariants
AgentModeInvariants
AgentInvariants (sin calificador)
ℳ
Alfabeto de mensajes
MessageAlphabet
AgentMessageAlphabet
MessageQueue, MessageType
ℋ
Reglas de reescritura
RewriteRules
AgentRewriteRules
AgentHandlers
𝒞
Contrato
Contract
AgentContract
AgentSpec, AgentPolicy
q₀
Modo inicial
InitialMode
AgentInitialMode
InitialState
ν₀
Valuación inicial
InitialValuation
AgentInitialValuation
InitialValues
q(t)
Modo actual
CurrentMode
AgentCurrentMode
CurrentState
ν(t)
Valuación actual
Valuation
AgentValuation
—
μ(t)
Mailbox
Mailbox
AgentMailbox
MessageQueue (como sinónimo de ℳ)
τ(t)
Traza
Trace
AgentTrace
—
s(t)
Estado completo
AgentState
AgentState
Usar para modos
Ψ
Invariante a verificar
VerificationTarget
—
Usar para propiedades globales
Φ
Propiedad global
SystemInvariant
—
Confundir con Ψ
𝒮
Sistema multi-agente
MultiAgentSystem
—
—
ℳ_C
Modelo causal
CausalModel
—
—
do(x)
Intervención
Intervention
—
Confundir con observación
Reglas de nombramiento derivadas
Estas reglas se derivan del glosario y aplican a cualquier nombre nuevo en el paclet.
R1 — Calificación de nivel. Cuando un concepto existe en dos niveles (agente vs. sistema), el nombre DEBE distinguirlos: ModeInvariant (agente) vs. SystemInvariant (sistema). Nunca compartir nombres entre niveles.
R2 — State está reservado. El término State (y sus compuestos CurrentState, InitialState, AgentState) se reserva para la cuádrupla completa s(t) = ⟨q, ν, μ, τ⟩. Cualquier referencia a solo el modo discreto usa Mode.
R3 — Verbos de transición. Las cuatro relaciones de transición se nombran con el sufijo Transition o con el sustantivo del evento de traza (flow, jump, dispatch, recv). Nunca event, trigger o callback para referirse a una relación de transición.
R4 — Distinción observación / intervención. Siempre que aparezcan distribuciones de probabilidad, el nombre DEBE indicar si es observacional (ObservationalDistribution) o intervencional (InterventionalDistribution). Nunca usar P(y|x) e P(y|do(x)) con el mismo término.
R5 — Certificado con fragmento. Todo símbolo relacionado con la emisión de certificados DEBE exponer el campo CertFragment. Un certificado sin declaración de fragmento es un defecto.
R6 — Trazabilidad en ::usage. Todo accessor público DEBE terminar su ::usage con: "Implementa <símbolo formal> de FORM <Def. N.M>." usando la terminología de este glosario.
Fin del glosario FMA v1.0. Próxima revisión: cuando se incorpore Fase 3 (adapters industriales) o se extienda el formalismo causal a feedbacks instantáneos.