Documentaciónquintiles(v, num)

quintiles(v,num)\texttt{quintiles}(v, num)

Nombre

quintiles - Calcula un quintil de la distribucion.

Sinopsis

n = estadisticas.quintiles(v, num)

Descripcion

Los quintiles dividen la distribucion en 5 partes iguales de 20%.

Esta funcion calcula el quintil num usando el metodo type7.

Validaciones y casos borde

  • Requiere un vector no vacio.
  • num debe estar en 1..5; en caso contrario emite ERROR().
  • Si el vector esta vacio, la validacion interna del cuantil emite ERROR().

Comportamiento

  • Convierte el quintil a cuantil y delega en cuantil_generico().
  • Retorna un NUMERICO con el quintil solicitado.

Funciones API relacionadas

  • estadisticas.cuantil_generico()
  • estadisticas.percentiles()
  • estadisticas.deciles()
  • estadisticas.cuartiles()

Parámetros

ParámetroTipoDescripción
vVECTORVector de datos numericos de entrada sobre el cual se calcula el quintil.
numNUMERICOQuintil a calcular en rango 1..5 (1=20%, 2=40%, 3=60%, 4=80%, 5=100%).

Valor de retorno

NUMERICO - Retorna el valor del quintil solicitado (umbral correspondiente a num/5 de la distribucion).

Ejemplo

ejemplo.blox
INCLUIR "archivos.api"
INCLUIR "strings.api"
INCLUIR "estadisticas.api"
INCLUIR "vectores.api"

// Demo de cuantiles
FUNCION PRINCIPAL
INICIO
    // Vector 0-based con 10 elementos
    NUMERICO i, m, c, d, q, p, N
    TABLA ret


    ret = archivos.archivo_a_vector("sturges2.txt")
    N = ret[1].cant
    VECTOR v[N]
    v = ret[1].lista
 
    // Mediana (referencia)
    m = estadisticas.mediana(v)
    IMPRIMIR("\nMediana = ", m)       

    // Cuartiles
    c = estadisticas.cuartiles(v, 1)
    IMPRIMIR("\n\nQ1  (25%) = ", c)  
    c = estadisticas.cuartiles(v, 2)
    IMPRIMIR("\nQ2  (50%) = ", c, " (Mediana)")  //  (igual que mediana)
    c = estadisticas.cuartiles(v, 3)
    IMPRIMIR("\nQ3  (75%) = ", c)  

    // Deciles (10%, 90%)
    d = estadisticas.deciles(v, 1)
    IMPRIMIR("\n\nD1  (10%) = ", d)    
    d = estadisticas.deciles(v, 6)
    IMPRIMIR("\nD6  (60%) = ", d)    
    d = estadisticas.deciles(v, 9)
    IMPRIMIR("\nD9  (90%) = ", d)    

    // Quintiles (20%, 40%, 60%, 80%)
    q = estadisticas.quintiles(v, 1)
    IMPRIMIR("\n\nK1  (20%) = ", q)  
    q = estadisticas.quintiles(v, 2)
    IMPRIMIR("\nK2  (40%) = ", q)  
    q = estadisticas.quintiles(v, 3)
    IMPRIMIR("\nK3  (60%) = ", q)  
    q = estadisticas.quintiles(v, 4)
    IMPRIMIR("\nK4  (80%) = ", q)  

    // Percentiles sueltos (5% y 95%)
    p = estadisticas.percentiles(v, 5)
    IMPRIMIR("\n\nP5   (5%)  = ", p)   
    p = estadisticas.percentiles(v, 25)
    IMPRIMIR("\nP25  (25%) = ", p)   
    p = estadisticas.percentiles(v, 75)
    IMPRIMIR("\nP75  (75%) = ", p)     
    p = estadisticas.percentiles(v, 95)
    IMPRIMIR("\nP95  (95%) = ", p)  
FINAL