Documentaciónbarras_agrupadas(curvas, graf, archivo)

barras_agrupadas(curvas,graf,archivo)\texttt{barras\_agrupadas}(curvas, graf, archivo)

Nombre

barras_agrupadas - Construye un grafico de barras agrupadas a partir de varias series.

Sinopsis

ok = graficos.barras_agrupadas(curvas, graf, archivo)

Descripcion

Recibe varias series que comparten el mismo eje X y las desplaza horizontalmente para que las barras queden lado a lado.

Formato tipico:

ejemplo.blox
TABLA curvas, graf

graf = { titulo = "Ingresos por sucursal", x = "Trimestres", y = "Ingresos (miles USD)" }
curvas[1] = { X = xs, Y = norte,  nombre = "Norte",  color = "azul" }
curvas[2] = { X = xs, Y = centro, nombre = "Centro", color = "verde" }
curvas[3] = { X = xs, Y = sur,    nombre = "Sur",    color = "rojo" }

Comportamiento

  • Valida que todas las series tengan el mismo numero de puntos y el mismo vector X.
  • Construye desplazamientos laterales por categoria.
  • Usa graficos.graficar_trayectorias() como motor de salida.

Funciones API relacionadas

  • graficos.barras_apiladas()
  • graficos.boxplot()
  • graficos.boxplots()
  • graficos.histograma()
  • graficos.graficar_sturges()

Parámetros

ParámetroTipoDescripción
curvasTABLATabla de series de barras. Cada registro debe tener X, Y y opcionalmente nombre, color y bar_width.
grafTABLATabla de configuracion del grafico. Puede incluir titulo, x, y, etiquetas y leyenda. leyenda puede indicarse como un LOGICO o como una subconfiguracion con mostrar.
archivoSTRINGNombre o ruta del archivo PNG de salida.

Valor de retorno

VOID - No retorna valor. Genera el grafico y escribe el archivo PNG indicado.

Ejemplo

ejemplo.blox
// ======================================================
// ESTADISTICA - EJERCICIO 2
// Barras agrupadas
//
// Se comparan las frecuencias observadas en tres muestras distintas.
// Cada muestra fue clasificada en los mismos intervalos.
//
// Se pide comparar las frecuencias usando barras agrupadas.
// ======================================================

INCLUIR "graficos.api"
INCLUIR "vectores.api"

FUNCION PRINCIPAL
INICIO "Estadistica - Barras agrupadas"

    NUMERICO intervalos
    intervalos = 4

    VECTOR xs[intervalos]
    VECTOR muestra_a[intervalos]
    VECTOR muestra_b[intervalos]
    VECTOR muestra_c[intervalos]

    TABLA curvas
    STRING archivo
    NUMERICO ancho_barra

    xs        = [1, 2, 3, 4]
    muestra_a = [12, 18, 25, 15]
    muestra_b = [10, 20, 22, 17]
    muestra_c = [8, 16, 28, 20]

    ancho_barra = 0.25

    archivo = "PROG1000 - ESTADISTICAS - GRAFICO - BAR - barras_agrupadas().png"

    curvas[1] = {
        X = xs,
        Y = muestra_a,
        nombre = "muestra A",
        color = "azul",
        bar_width = ancho_barra
    }

    curvas[2] = {
        X = xs,
        Y = muestra_b,
        nombre = "muestra B",
        color = "verde",
        bar_width = ancho_barra
    }

    curvas[3] = {
        X = xs,
        Y = muestra_c,
        nombre = "muestra C",
        color = "rojo",
        bar_width = ancho_barra
    }

    TABLA graf

    graf = {
        titulo = "ESTADISTICA - Frecuencias por muestra",
        x = "Muestras",
        y = "Frecuencias"
    }

    graficos.barras_agrupadas(curvas, graf, archivo)

FINAL
← Volver al inicioDescargar Blox →