Documentaciónpercentiles(v, num)

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

Nombre

percentiles - Calcula un percentil a partir de un vector de datos.

Sinopsis

n = estadisticas.percentiles(v, num)

Descripcion

Calcula el percentil num de un vector de datos, equivalente a evaluar el cuantil num/100.

Formula:

Pp=Q(p100)P_p = Q\left(\frac{p}{100}\right)

Validaciones y casos borde

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

Comportamiento

  • Convierte el percentil a un cuantil.
  • Usa cuantil_generico() con el metodo type7.
  • Retorna un NUMERICO con el percentil solicitado.

Funciones API relacionadas

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

Parámetros

ParámetroTipoDescripción
vVECTORVector de datos numericos de entrada sobre el cual se calcula el percentil.
numNUMERICOPercentil a calcular en rango 0..100 (ej: 90 = P90, 50 = mediana).

Valor de retorno

NUMERICO - Retorna el valor del percentil solicitado (corte de la distribucion segun num%).

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 →