Skip to main content

Interactive analysis of GCTS Triaxial Testing Systems results

Project description


PyRockLab is a Python 3.x module that provides several interactive interfaces for triaxial test analysis. The results obtained in the tests using the GCTS Triaxial Test Systems is input to the program in a spreadsheet format (*. xls or *. csv files).

From the results of the Triaxial Shear Test, it is possible to obtain, for a set of samples, Young's modulus, Poisson's ratio, cohesion, friction angle, p-q graphs, stress-strain behavior, among others.

All interactivity is managed by Jupyter Notebook using the ipywidgets module, which can be either local (single user) or network (multiuser) access.

For more examples and information on interactive functions, visit the wiki of the project.

1. Requirements

As a requirement for using PyRockLab, in addition to Python 3.x, it is necessary to have the Firefox browser installed.

Python needs to be added to the system PATH. For this, install Python 3.x from official site and don't forget to check the box "Add Python 3.x to PATH" during installation.

2. Installation

With Python added to the system path you can use the script pip to install the PyRockLab module and its dependencies. To do this, simply type in terminal the command:

pip install PyRockLab

In addition, you need to configure the Jupyter notebook and create an access file. There are two configuration possibilities: (1) local and (2) network.

2.1. Local Installation

For local use of PyRockLab, for a single user only, open the terminal where you want to install and type the command:

python -m PyRockLab

This command creates the PyRockLab.bat file that initializes the local server and PyRockLab when executed. Move this file to the desktop for easy startup.

2.2. Network Installation

For PyRockLab network use, installation is only required on the main computer (server) and any user within the network will be able to access PyRockLab through the browser. In this case, the server must have a fixed IP and PyRockLab must be running whenever any user needs to use the program. For network installation, open the terminal in the path where PyRockLab will be installed and enter the command:

python -m PyRockLab --server

This command will prompt you for a password that will be required every time someone tries to access PyRockLab. Run the generated file (PyRockLab_Server.bat) to start Jupyter on the main computer (server). Move this file to the desktop for easy startup.

Using PyRockLab on a network requires that a * PyRockLab.bat * file be created for each user who will use the program. This way, when executing this bat file, the user will be directed to a PyRockLab interface customized for him. To create a * PyRockLab.bat * file for a new user, run the * PyRockLab_Server.bat * file on the main computer, type the username, download the file, and distribute it to the user.

3. Update

To update PyRockLab, type in the command:

pip install --upgrade PyRockLab

4. Suggestions

Any suggestion is welcome. To suggest fixes or new implementations, create an Issue or send an email to

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for PyRockLab, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size PyRockLab-0.1.1-py3-none-any.whl (51.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size PyRockLab-0.1.1.tar.gz (49.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page