Documentacióncuartiles(v, num)

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

Nombre

cuartiles - Calcula uno de los cuartiles principales de una muestra.

Sinopsis

n = estadisticas.cuartiles(v, num)

Descripcion

Los cuartiles dividen la distribucion en cuatro tramos: Q1, Q2 y Q3 son los cortes mas usados.

Formula:

Q1=P25,Q2=P50,Q3=P75Q_1=P_{25},\quad Q_2=P_{50},\quad Q_3=P_{75}

Validaciones y casos borde

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

Comportamiento

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

Funciones API relacionadas

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

Parámetros

ParámetroTipoDescripción
vVECTORVector de datos numericos de entrada sobre el cual se calcula el cuartil.
numNUMERICOCuartil a calcular en rango 1..4 (1=25%, 2=50% mediana, 3=75%, 4=100%).

Valor de retorno

NUMERICO - Retorna el valor del cuartil solicitado (umbral correspondiente a num/4 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
← Volver al inicioDescargar Blox →