ppizarror / clasificacion-suelos-gruesos

Desarollo movido a https://github.com/ppizarror/granulometria-gui

Clasificación de suelos gruesos

Clasificación de suelos gruesos, CI4401-1 Geotecnia 2016, Universidad de Chile

Esta libreria de Matlab permite obtener la clasificación de un suelo grueso a partir de una tabla granulométrica, la cual es cargada desde un archivo, o bien a partir de una serie de parametros como son el porcentaje de fino en una muestra, los valores del coeficiente de uniformidad Cu y coeficiente de forma Cc, el nombre del fino y el símbolo del grupo.

Antes de partir

Una vez que descargue esta libreria tiene que abrir con Matlab la carpeta descargada, luego, debe ejecutar el siguiente comando en consola:

>>> generate_groupnames

Esta función creará los archivos binarios gravel_groupname.mat y sand_groupname.mat los cuales contendrán listas con las tablas de clasificación para poder ejecutar el resto de las funciones del programa.

Funciones disponibles

Una vez que los archivos gravel_groupname.mat y sand_groupname.mat hayan sido creados puede hacer uso de las funciones del programa.

Las funciones disponibles son las siguientes:

• load_granulometry_data: Cargar un archivo de datos granulométricos.
• create_granulometry_table: Crear una tabla granulométrica.
• load_granulometry_table: Crear una tabla granulométrica a partir de un archivo de datos granulométricos.
• print_cell_table: Imprimir en consola la tabla granulométrica.
• get_composition_list: Obtener la cantidad de gravas, finos y arena de una tabla granulométrica.
• calculate_d: Obtener los valores D10, D30, D60, Dn.
• calculate_cc: Calcular el parametro del coeficiente de forma a partir de una tabla ranulométrica.
• calculate_cu: Calcular el parametro del coeficiente de uniformidad a partir de una tabla granulométrica.
• plot_granulometry_table: Plotear una curva granulométrica.
• get_classification_groupname: Obtener el nombre de grupo de un suelo (clasificación) a partir de una tabla granulométrica.
• get_gravel_group_name: Obtener el nombre de grupo de una grava a partir de una serie de parámetros.
• get_sand_group_name: Obtener el nombre de grupo de una arena a partir de una serie de parámetros.
• get_classification_groupsymbol: Obtener el símbolo de grupo de un suelo (clasificación) a partir de una tabla granulométrica.
• get_gravel_group_symbol: Obtener el simbolo de grupo de una grava a partir de una serie de parámetros.
• get_sand_group_symbol: Obtener el simbolo de grupo de una arena a partir de una serie de parámetros.

Detalles de las funciones

>>> load_granulometry_data( file )
    file: String con la ubicación del archivo a cargar.
    
    Retorna: Lista con los valores cargados y parseados a números.

>>> create_granulometry_table( data )
    data: Datos granulométricos resultantes de la función load_granulometry_data.
    
    Retorna: Tabla granulométrica usada por la mayoría de las funciones.

>>> load_granulometry_table( file )
    file: String con la ubicación del archivo a cargar.
    
    Retorna: Tabla granulométrica usada por la mayoría de las funciones.

>>> print_cell_table( c )
    c: Tabla a imprimir.

>>> get_composition_list( granulometry_table )
    granulometry_table: Tabla granulométrica resultante de create_granulometry_table.
    
    Retorna: Lista de la forma [gravas, arena, fino]

>>> calculate_d( granulometry_table, n )
    granulometry_table: Tabla granulométrica resultante de create_granulometry_table.
    n: Pocentaje que pasa.
    
    Retorna: Valor de D_n.

>>> calculate_cc( granulometry_table )
    granulometry_table: Tabla granulométrica resultante de create_granulometry_table.
    
    Retorna: Valor del coeficiente de curvatura.

>>> calculate_cu( granulometry_table )
    granulometry_table: Tabla granulométrica resultante de create_granulometry_table.
    
    Retorna: Valor del coeficiente de uniformidad.

>>> plot_granulometry_table( granulometry_table, diameter_scale )
    granulometry_table: Tabla granulométrica resultante de create_granulometry_table.
    diameter_scale: Escala del eje x (eje del diámetro).

>>> get_classification_groupname( granulometry_table, fines )
    granulometry_table: Tabla granulométrica resultante de create_granulometry_table.
    fines: Nombre del fino, string (ML, MH, CL-CH, CL-ML, CL-CH, CL-ML).

    Retorna: Nombre de grupo del suelo definido por la tabla granulométrica y su respectivo fino.

>>> get_gravel_group_name( pfines, cu, cc, fines, psand )
    pfines: Porcentaje de finos en el suelo, entre 0 y 100.
    cu: Valor del coef. de uniformidad en la muestra, entre 0 y 100.
    cc: Valor del coef. de forma en la muestra, entre 0 y 100.
    fines: Nombre del fino, string.
    psand: Porcentaje de arena en el suelo, entre 0 y 100.
    
    Retorna: Nombre de grupo de una grava definida por los parámetros.

>>> get_sand_group_name( pfines, cu, cc, fines, pgravel )
    pfines: Porcentaje de finos en el suelo, entre 0 y 100.
    cu: Valor del coef. de uniformidad en la muestra, entre 0 y 100.
    cc: Valor del coef. de forma en la muestra, entre 0 y 100.
    fines: Nombre del fino, string.
    pgravel: Porcentaje de grava en el suelo, entre 0 y 100.
    
    Retorna: Nombre de grupo de una arena definida por los parámetros.

>>> get_classification_groupsymbol( granulometry_table, fines )
    granulometry_table: Tabla granulométrica resultante de create_granulometry_table.
    fines: Nombre del fino, string (ML, MH, CL-CH, CL-ML, CL-CH, CL-ML).

    Retorna: Símbolo de grupo del suelo definido por la tabla granulométrica y su respectivo fino.

>>> get_gravel_group_symbol( pfines, cu, cc, fines )
    pfines: Porcentaje de finos en el suelo, entre 0 y 100.
    cu: Valor del coef. de uniformidad en la muestra, entre 0 y 100.
    cc: Valor del coef. de forma en la muestra, entre 0 y 100.
    fines: Nombre del fino, string.
    
    Retorna: Símbolo de grupo de una grava definida por los parámetros.

>>> get_sand_group_symbol( pfines, cu, cc, fines )
    pfines: Porcentaje de finos en el suelo, entre 0 y 100.
    cu: Valor del coef. de uniformidad en la muestra, entre 0 y 100.
    cc: Valor del coef. de forma en la muestra, entre 0 y 100.
    fines: Nombre del fino, string.
    
    Retorna: Símbolo de grupo de una arena definida por los parámetros.

Ejemplos

• Cargar el archivo de datos granulométricos 'example_data.txt':

  >>>> data = load_granulometry_data('example_data.txt');

• Crear una tabla granulométrica a partir de los datos cargados.

  >>>> granulometry_table = create_granulometry_table(data);

• Crear una tabla granulométrica a partir de 'example_data.txt'.

  >>>> granulometry_table = load_granulometry_table('example_data.txt');

• Imprimir en consola la tabla granulométrica cargada:

  >>>> print_cell_table(granulometry_table);
        1.0000   25.4000    94.0000   10.5870    10.5870   89.4130
        4.0000    4.7500   225.0000    8.1023    18.6892   81.3108
       10.0000    2.0000   750.0000   27.0076    45.6968   54.3032
       20.0000    0.8500   405.0000   14.5841    60.2809   39.7191
       40.0000    0.4250   165.0000    5.9417    66.2225   33.7775
       60.0000    0.2500   189.0000    6.8059    73.0284   26.9716
      100.0000    0.1500   174.0000    6.2658    79.2942   20.7058
      200.0000    0.0750   336.0000   12.0994    91.3936    8.6064
      0           0        239.0000    8.6064   100.0000    0.0000

• Obtener la cantidad de gravas, finos y arena de una tabla granulométrica:

  >>>> get_composition_list(granulometry_table);
  ans = [18.6892   72.7044    8.6064] 

• Obtener los valores D10, D30, D60, Dn a partir de la tabla granulométrica cargada:

  >>>> calculate_d(granulometry_table, 10)
  ans = 0.083638 
  
  >>>> calculate_d(granulometry_table, 30)
  ans = 0.327870
  
  >>>> calculate_d(granulometry_table, 60)
  ans = 2.580067   

• Obtener los parámetros Cc (coef. de forma) y Cu (coef. de uniformidad) a partir de la tabla granulométrica cargada:

  >>>> calculate_cc(granulometry_table)
  ans = 0.498159
  
  >>>> calculate_cu(granulometry_table)
  ans = 30.847875

• Plotear una tabla granulométrica cargada, con escala de diámetro en milímetros (mm):

  >>>> plot_granulometry_table(granulometry_table, 'mm');

  

• Obtener el nombre de grupo de un suelo (clasificación) a partir de la tabla granulométrica cargada, con tipo de finos ML:

  >>>> get_classification_groupname(granulometry_table, 'ML');
  ans = 'Poorly graded sand with silt and gravel'

• Obtener el símbolo de grupo de un suelo (clasificación) a partir de la tabla granulométrica cargada, con tipo de finos ML:

  >>>> get_classification_groupsymbol(table, 'ML');
  ans = 'SP-SM'

• Obtener nombre de grupo de una grava con 8% de finos y 15% de arena, Cu=7 y Cc=2.4, el fino es ML:

  >>>> get_gravel_group_name(8, 7, 2.4, 'ML', 15)
  ans = 'Well-graded gravel with silt and sand'

• Obtener nombre de grupo de una grava con 4% de finos y 13% de arena, Cu=2 y Cc=0.8, no tiene fino:

  >>>> get_gravel_group_name(4, 2, 0.8, '', 13)
  ans = 'Poorly graded gravel'

• Obtener nombre de grupo de una grava con 25% de finos, sin Cu o Cc, con fino CL-ML y 19% de arena:

  >>>> get_gravel_group_name(25, 0, 0, 'CL-ML', 19)
  ans = 'Silty, clayey gravel with sand'

• Obtener nombre de grupo de una arena con 3% de finos y 44% de grava, Cu=10 y Cc=1.5, fino sin definir:

  >>>> get_sand_group_name(3, 10, 1.5, '', 44)
  ans = 'Well-graded sand with gravel'
  

• Obtener nombre de grupo de una arena con 7% de finos y 3% de grava, Cu=4 y Cc=0.98, fino MH:

  >>>> get_sand_group_name(7, 4, 0.98, 'MH', 3)
  ans = 'Poorly graded sand with silt'
  
  

• Obtener nombre de grupo de una arena con 30% de finos y 3% de grava, Cu y Cc sin definir, el fino es CL:

  >>>> get_sand_group_name(30, 0, 0, 'CL', 3)
  ans = 'Clayey sand'
  
  

• Obtener símbolo de grupo de una grava con 2% de finos, Cu=8.5 y Cc=1.2, sin fino definido:

  >>>> get_gravel_group_symbol(2, 8.5, 1.2, '')
  ans = 'GW'   

• Obtener símbolo de grupo de una grava con 9.9% de finos, Cu=1.1 y Cc=6.6, con fino CL-CH:

  >>>> get_gravel_group_symbol(9.9, 1.1, 6.6, 'CL-CH')
  ans = 'GP-GC'   

• Obtener símbolo de grupo de una arena con 7% de finos, Cu=4 y Cc=0.98, fino MH:

  >>>> get_sand_group_symbol(7, 4, 0.98, 'MH')
  ans = 'SP-SM'
  

Licencia

Este proyecto está licenciado bajo GPLv2 [https://www.gnu.org/licenses/gpl-2.0.html]

Autor

Pablo Pizarro R. | 2016