PyRockLab

PyRockLab é um módulo Python 3.x que disponibiliza diversas interfaces interativas para análise de ensaios triaxiais em rochas. Os resultados obtidos nos ensaios realizados no GCTS Triaxial Test Systems são dados de entrada para o programa em forma de arquivos *.xls ou *.csv.

A partir dos resultados do ensaio de compressão triaxial, é possível obter, para um conjunto de amostras, o módulo de Young, coeficiente de Poisson, coesão, ângulo de atrito, gráficos p-q, comportamento tensão-deformação, entre outros.

Toda a interatividade é gerenciada pelo Jupyter Notebook com o uso do módulo ipywidgets, podendo ser um acesso local (único usuário) ou em rede (vários usuários). Abaixo estão alguns dos gráficos que podem ser obtidos pelo PyRockLab.

Tensão-deformação	Círculo de Mohr

Para mais exemplos e informações das funções interativas, acesse a Wiki do projeto.

1. Requisitos

Como requisito para a utilização do PyRockLab, além do Python 3.x, é necessário ter o browser Firefox instalado.

O Python precisa ser adicionado ao PATH do sistema. Para isso, instale o Python 3.x pelo site oficial e não se esqueça de marcar a opção "Add Python 3.x to PATH" durante a instalação.

2. Instalação

Com o Python adicionado ao caminho do sistema é possível utilizar o script pip para instalar o módulo PyRockLab e suas dependências. Para isso, basta digitar no terminal o comando:

pip install PyRockLab

Além disso, é necessário configurar o Jupyter notebook e criar um arquivo de acesso. Existem duas possibilidades de configuração: (1) local e (2) em rede.

2.1. Instalação Local

Para o uso local do PyRockLab, exclusivo para um único usuário, abra o terminal no local onde será instalado o programa e digite o comando:

python -m PyRockLab

Esse comando cria o arquivo PyRockLab.bat que inicializa o servidor local e o PyRockLab quando executado. Mova este arquivo para a área de trabalho para facilitar a inicialização.

2.2. Instalação em Rede

Para o uso em rede do PyRockLab, a instalação é necessária apenas no computador principal (servidor) e qualquer usuário dentro da rede poderá acessar o PyRockLab pelo Mozilla Firefox. Neste caso, o servidor deve ter um IP fixo e o PyRockLab deve estar em execução sempre que algum usuário precisar utilizar o programa. Para a instalação em rede, abra o terminal no caminho onde será instalado o PyRockLab e digite o comando:

python -m PyRockLab --server 

Este comando irá solicitar uma senha que será requisitada toda vez que algum usúario tentar acessar o PyRockLab. Para iniciar o Jupyter no computador principal (servidor), execute o arquivo gerado: PyRockLab_Server.bat. Mova este arquivo para a área de trabalho para facilitar a inicialização.

O uso do PyRockLab em rede requer que seja criado um arquivo PyRockLab.bat para cada usuário que irá utilizar o programa. Dessa forma, ao executar este arquivo bat, o usuário será direcionado a uma interface do PyRockLab personalizado para ele. Para criar um arquivo PyRockLab.bat para um novo usuário, execute o arquivo PyRockLab_Server.bat no computador principal, digite o nome do usuário, faça o download do arquivo e distribua ao usuário.

3. Utilização

Para utilizar o PyRockLab, basta executar o arquivo PyRockLab.bat gerado no momento da instalação. Essa script irá abrir o Mozilla Firefox com o arquivo Jupyter notebook. Para executar este arquio .ipynb, execute o comando de executar todas as células: clique no menu Cell e depois escolha a opção Run All. Outra opção é selecionar a primeira célula e clicar no botão >|Run.

Para mais informações sobre a utilização leia a página de instruções na Wiki do projeto.

4. Atualização

Para atualizar o PyRockLab, digite no terminal o comando:

pip install --upgrade PyRockLab

As atualizações podem ser acompanhadas pelo arquivo changlog.md.

5. Sugestões

Toda sugestão é bem vinda. Para sugerir correções ou novas implementações, crie uma Issue ou mande um e-mail para bismarckgomes@gmail.com.