Documentaciónhistograma(hist, graf, archivo)

histograma(hist,graf,archivo)\texttt{histograma}(hist, graf, archivo)

Nombre

histograma - Dibuja un histograma a partir de una tabla de clases ya preparada.

Sinopsis

ok = graficos.histograma(hist, graf, archivo)

Descripcion

Recibe una tabla hist que puede venir de estadisticas.sturges() o armarse manualmente.

Formato general:

ejemplo.blox
TABLA hist, graf

graf = { titulo = "Distribucion", x = "Clases", y = "Frecuencia", etiquetas = VERDADERO }

ok = graficos.histograma(hist, graf, "salida.png")

Contrato minimo de hist:

  • hist[1].centros
  • hist[1].frec_abs
  • hist[1].ancho

La tabla graf permite configurar titulo, etiquetas, poligono, x e y.

Comportamiento

  • Si hist[1].ymax_plot no existe, calcula automaticamente el maximo del eje Y.
  • Puede mostrar etiquetas sobre las barras.
  • Puede superponer el poligono de frecuencias.

Funciones API relacionadas

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

Parámetros

ParámetroTipoDescripción
histTABLATABLA con la informacion del histograma. Debe contener al menos hist[1].centros, hist[1].frec_abs y hist[1].ancho.
grafTABLATABLA de configuracion del grafico. Puede incluir titulo, x, y, etiquetas, poligono y leyenda. leyenda puede indicarse como un LOGICO o como una subconfiguracion con mostrar.
archivoSTRINGNombre o ruta del PNG de salida.

Valor de retorno

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

Ejemplo

ejemplo.blox
INCLUIR "graficos.api"
INCLUIR "vectores.api"

FUNCION PRINCIPAL
INICIO "GRAFICOS - histograma()"

    TABLA hist, graf
    VECTOR centros[6], frec_abs[6]

    centros  = [05, 15, 25, 35, 45, 55]
    frec_abs = [02, 05, 09, 12, 07, 03]

    hist[1] = {
        centros = centros,
        frec_abs = frec_abs,
        ancho = 10
    }

    graf = {
        titulo = "ESTADISTICA - Histograma manual",
        etiquetas = VERDADERO,
        poligono = VERDADERO,
        x = "Clases",
        y = "Frecuencia absoluta"
    }

    graficos.histograma(hist, graf, "GRAFICOS - histograma().png")
FINAL