eamontoyaa/pycss

Open-source program written in Python for 2D slope stability analysis of circular surfaces by the limit equilibrium method (Fellenius and Bishop's method.

Circular Slope Stability PyProgram (pyCSS)

It is an open-source program written in Python for 2D slope stability analysis of circular surfaces by the limit equilibrium method (Fellenius and Bishop methods).

Downloading the program

To install pyCSS v0.1.0 from PyPI, run this command in your terminal:

pip install pycss-lem

Also, you can clone the original repo directory (release v0.0.9) using git:

git clone https://github.com/eamontoyaa/pyCSS/ --branch v0.0.9

or directly use the download options from GitHub.

Installing dependencies

The program has been tested in Python ≥3.6. It is suggested to create a virtual environment to use the program.

From release v0.1.0, the program is expected to install its dependencies automatically. If this does not happen, please follow the instructions as for previous releases:

Download the requirements.txt file. In the same directory, type and execute the following line in your terminal:

python3 -m pip install -r requirements.txt

Usage

Release v0.1.0+

Please, refer to this notebook prepared for the Slope Stability class at EAFIT University (Colombia). There, you will find a series of commented code blocks to carry out a stability assessment using pyCSS.

You can run the program by editing the script_template.py file located in the ./examples/ directory of the installation folder. Use the examples located in the same folder as an input guide. Then, save the script wherever you need it to be saved, and run it by typing the following line from the terminal:

python3 script_template.py

Note: the graphical user interface is not yet available from release v0.1.0.

Release v0.0.9

You can run the program via GUI by typing the following line in the root directory:

python3 pyCSS.py

Or editing the finalModule.py file located in the root directory and running it:

python3 finalModule.py

You can test the program by runing the files in the /examples folder.

cd examples/
python3 example01.py

If the example runs successfully, the program will create two files. One is a graphical output of the slope and the stability analysis. The second file is a text file with a summary of the run.

Documentation

Please refer to the user manual user manual for release v0.0.9 to learn more. Currently, the manual is in Spanish, but in the future, we will translate it to English.

Citation

To cite pyCSS in publications, use:

Suarez-Burgoa, Ludger O., and Exneyder A. Montoya-Araque. 2016. “Programa en código abierto para el análisis bidimensional de estabilidad de taludes por el método de equilibrio límite.” Revista de La Facultad de Ciencias 5 (2): 88–104. <https://doi.org/10.15446/rev.fac.cienc.v5n2.59914>.

A BibTeX entry for LaTeX users is:

@article{SuarezBurgoa_MontoyaAraque_2016_art,
    doi = {10.15446/rev.fac.cienc.v5n2.59914},
    journal = {Revista de la Facultad de Ciencias},
    keywords = {C{\'{o}}digo fuente libre,an{\'{a}}lisis de estabilidad de taludes,m{\'{e}}todo de Bishop,m{\'{e}}todo de equilibrio l{\'{i}}mite},
    month = {jul},
    number = {2},
    pages = {88--104},
    title = {{Programa en c{\'{o}}digo abierto para el an{\'{a}}lisis bidimensional de estabilidad de taludes por el m{\'{e}}todo de equilibrio l{\'{i}}mite}},
    volume = {5},
    year = {2016}
}

pycss's Issues

Problema utilizando Interfaz

Hola,

Estoy intentando correr el programa pyCSS.py, y cuando ingreso los valores en el cuadro con la interfaz me arroja diversos errores:

• return umr_minimum(a, axis, None, out, keepdims)
  ValueError: zero-size array to reduction operation minimum which has no identity

No sé, si existen algunas restricciones para los valores de la Geometría del talud, que no me permite correr bien el código.

Muchas gracias,
Marcelo

¿El programa está descontinuado?

Hola, he intentado usar el programa en Ubuntu 20.04 siguiendo el manual adjunto, puedo descargar y ejecutar el programa hasta ver la interfaz, relleno los datos como se muestra a continuación.

Sin embargo, cuando le doy ejecutar análisis no ejecuta y en la linea de comando me muestra la siguiente salida.

Exception in Tkinter callback
Traceback (most recent call last):
  File "/usr/lib/python3.8/tkinter/__init__.py", line 1892, in __call__
    return self.func(*args)
  File "pyCSS.py", line 376, in cssanalysis
    automaticslipcircles(projectName, projectAuthor, projectDate, \
  File "/home/william/Descargas/pyCSS-master/./functions/automaticslipcircles.py", line 221, in automaticslipcircles
    slicesSTRCell = divideslipintoslices(slipArcSTR, \
  File "/home/william/Descargas/pyCSS-master/./functions/divideslipintoslices.py", line 320, in divideslipintoslices
    terrainSlicePlineCordsArray = extractplinefrom2pts\
  File "/home/william/Descargas/pyCSS-master/./functions/extractplinefrom2pts.py", line 82, in extractplinefrom2pts
    yLeftEnd = surfaceDataCell[pointOnePlineIndex]['intercept']\
TypeError: only integer scalar arrays can be converted to a scalar index

Ya que se observa que la última actualización del programa fue hace 6 años, entiendo que el programa puede no estar al día con algunas actualizaciones de python3 u otras dependencias. ¿es eso o estoy haciendo algo mal?, agradesco su respuesta.

Could you please tell me where can I find the English version of pyCSS manual?

Dear author：
I tried to find the English version, but I couldn't find it. If you forget to provide the English version, please provide it here. Or you have provided it. Can you tell me where to find it. Thank you very much!

Yours Sincerely
wznhaha

Can you provide the English version of pyCSS manual?

Thank you for providing this! But the pyCSS manual is written in Spanish, which is very difficult for people who are not Spanish. I also noticed that you will be translated into English, so can you provide an English version of manual?

Muchas gracias,
kevin4z.