Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore Correccion readme. Ajustado formato archivo. Sep 2, 2017
LICENSE
README.md
calculate_cc.m
calculate_cu.m
calculate_d.m
convert_fraction.m
create_granulometry_table.m Correccion readme. Ajustado formato archivo. Sep 2, 2017
example.m
example_data.txt
generate_gravel_groupname.m
generate_groupnames.m
generate_sand_groupname.m
get_classification_groupname.m
get_classification_groupsymbol.m
get_composition_list.m Correccion readme. Ajustado formato archivo. Sep 2, 2017
get_gravel_group_name.m Correccion readme. Ajustado formato archivo. Sep 2, 2017
get_gravel_group_symbol.m
get_sand_group_name.m
get_sand_group_symbol.m
gravel_groupname.mat
groupname_creator.m
indx_cucc.m
indx_fines_n.m Correccion readme. Ajustado formato archivo. Sep 2, 2017
indx_fines_p.m Correccion readme. Ajustado formato archivo. Sep 2, 2017
indx_group_symbol.m
indx_sg_percentage.m
isequal_gn.m
isequal_gs.m
load_granulometry_data.m
load_granulometry_table.m
plot_granulometry_table.m Correccion readme. Ajustado formato archivo. Sep 2, 2017
print_cell_table.m
readme.content.md
readme.json
sand_groupname.mat
symbol_group_indx.m

README.md

Clasificación de suelos gruesos

Clasificación de suelos gruesos

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

@ppizarror GPL V2.0

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:

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');
    Curva de distribución
  • 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