Quartum Cartridge · Estándar v1.0

El estándar .quartum.json

Un Quartum Cartridge es la especificación legible por máquina de una prueba — sus entradas, lógica de puntuación, salidas, baremos y referencias — empaquetada en un único archivo .quartum.json compatible con Quartum Group.

¿Qué es un Quartum Cartridge?

Una descripción portable y validada que permite a cualquier motor compatible calcular resultados, aplicar baremos y mostrar avisos de forma consistente.

Metadatos requeridos

nombre, abreviatura, área, autores, año, versión y licencia.

Variables de entrada

Cada variable declara clave, etiqueta, tipo, si es obligatoria y restricciones opcionales de valor.

Lógica de puntuación

Ecuaciones ordenadas, sin efectos colaterales, que referencian claves de entrada o de salida.

Tablas normativas

Tablas estratificadas por población para convertir puntuaciones directas en estandarizadas.

Variables de salida

Cada salida declara clave, etiqueta, tipo y guía de interpretación.

Reglas de validación

Los JSON se validan contra el esquema Quartum durante la revisión editorial.

Avisos

Notas técnicas o de uso que se muestran junto a los resultados.

Referencias

Citas que sustentan la puntuación, los baremos y la evidencia de validez.

Ejemplo .quartum.json

{
  "metadata": {
    "name": "Stroop Color-Word Test",
    "abbreviation": "Stroop CWT",
    "domain": "Executive Function",
    "authors": ["J. R. Stroop"],
    "year": 1935,
    "version": "1.0.0",
    "license": "Public Domain"
  },
  "inputs": [
    { "key": "word_score", "label": "Word Reading", "type": "number", "required": true },
    { "key": "color_score", "label": "Color Naming", "type": "number", "required": true },
    { "key": "color_word_score", "label": "Color-Word", "type": "number", "required": true }
  ],
  "scoring": {
    "equations": [
      { "key": "predicted_cw", "formula": "(word_score * color_score) / (word_score + color_score)" },
      { "key": "interference", "formula": "color_word_score - predicted_cw" }
    ]
  },
  "outputs": [
    { "key": "interference", "label": "Interference Score", "type": "numeric",
      "interpretation": "Higher scores may indicate better inhibitory control." }
  ],
  "norms": [],
  "warnings": [],
  "citations": []
}

Uso responsable. Quartum Atlas no sustituye el criterio profesional ni convierte automáticamente un estudio en una herramienta diagnóstica validada. Los recursos disponibles deben utilizarse como apoyo técnico y documental, respetando la autoría, licencias, permisos de uso y validación correspondiente de cada material.