Primeiros passos

FrontISTR / Getting Started

Primeiros passos

Analise uma dobradiça com o FrontISTR e examine depois a distribuição de tensões no ParaView. Com o solver e o exemplo já preparados, não é necessário começar por criar uma malha.

Ver os passos

Distribuição da tensão de von Mises numa dobradiça, com concentrações de tensão em redor dos furos.
Execute uma análise estática linear de uma dobradiça. O objetivo é apresentar NodalMISES, a tensão de von Mises nodal, num mapa de contornos a cores.

01

Preparar o solver

Prepare o binário para Windows ou a imagem Docker, que pode ser utilizada em Windows, macOS e Linux.

Windows (64 bits)

Transferir a versão para Windows

Extraia o ZIP. Depois de preparar o exemplo no passo seguinte, copie fistr1.exe e todas as DLL fornecidas para a pasta do exemplo (01_elastic_hinge).

Docker (Windows / macOS / Linux)

Inicie o Docker e execute o comando seguinte num terminal. Em Windows, utilize o Docker no modo de contentores Linux e execute o comando no PowerShell.

docker pull --platform linux/amd64 registry.gitlab.com/frontistr-commons/frontistr/fistr1:master

A imagem oficial atual é compilada para amd64. Nos Macs com Apple Silicon, é executada por emulação e pode demorar mais tempo.

Compilar a partir do código-fonte

Também pode compilar o FrontISTR a partir do código-fonte em qualquer um destes sistemas operativos. Depois de instalar os compiladores e as bibliotecas necessárias, o CMake deteta o ambiente e configura a compilação.

Instale as ferramentas básicas com os comandos abaixo correspondentes à sua distribuição. Pode utilizar o seu ambiente de desenvolvimento atual sem adicionar MPI nem outras bibliotecas opcionais.

Ubuntu / Debian

sudo apt-get update
sudo apt-get install build-essential cmake git gfortran

RHEL / Rocky Linux / AlmaLinux

sudo dnf install gcc gcc-c++ gcc-gfortran make cmake git

Os comandos seguintes mostram um exemplo de compilação e instalação em macOS e Linux. Os executáveis são instalados no diretório bin da sua pasta pessoal, pelo que não é necessário usar sudo nem alterar PATH. Consulte o guia de compilação para preparar macOS/Windows e instalar bibliotecas opcionais.

git clone https://gitlab.com/FrontISTR-Commons/FrontISTR.git
cd FrontISTR
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX="$HOME"
cmake --build build --parallel
cmake --install build

Pode executar diretamente o exemplo incluído sem o transferir novamente. Execute a análise com os comandos abaixo e depois avance para o passo 04 para visualizar o resultado no ParaView.

cd tutorial/01_elastic_hinge
"$HOME/bin/fistr1"

Compilar a partir do código-fonte

Os binários e o contentor utilizam as versões master / LATEST, atualizadas continuamente. Consulte a página de transferências para versões publicadas e outros ambientes. Outras versões e ambientes

02

Transferir o exemplo

Transfira e extraia o ZIP do exemplo. Utilize os três ficheiros de entrada na pasta 01_elastic_hinge.

Transferir o exemplo (ZIP)

Execute a análise na pasta 01_elastic_hinge extraída. Para extrair pela linha de comandos, macOS e Linux utilizam unzip.

01_elastic_hinge/

hecmw_ctrl.dat
Localização dos ficheiros de entrada e saída
hinge.cnt
Materiais, cargas, restrições e definições da análise
hinge.msh
Malha da dobradiça

Para preparar o exemplo pela linha de comandos, execute todo o bloco abaixo no local onde pretende guardá-lo. O ficheiro ZIP é transferido e extraído e, em seguida, o terminal entra na pasta do exemplo. Depois pode executar o comando de análise no mesmo terminal.

Windows / PowerShell

curl.exe -fL -o 01_elastic_hinge.zip https://www.frontistr.com/sys/files/01_elastic_hinge.zip
if ($LASTEXITCODE -eq 0) {
  Expand-Archive -Path 01_elastic_hinge.zip -DestinationPath . -ErrorAction Stop
  cd 01_elastic_hinge
}

macOS / Linux

curl -fL -o 01_elastic_hinge.zip https://www.frontistr.com/sys/files/01_elastic_hinge.zip &&
unzip 01_elastic_hinge.zip &&
cd 01_elastic_hinge

03

Executar na pasta do exemplo

Execute a análise na pasta do exemplo (01_elastic_hinge). Confirme que hecmw_ctrl.dat se encontra nessa pasta.

Binário para Windows

Faça duplo clique em fistr1.exe na pasta do exemplo. As DLL fornecidas também têm de estar na mesma pasta. Se a janela se fechar no fim da execução, abra no ParaView os resultados gravados na pasta do exemplo.

Para consultar o registo

Se a janela se fechar imediatamente sem produzir resultados, ou se pretender consultar o registo, abra o PowerShell na pasta do exemplo e execute:

.\fistr1.exe

Docker (Windows / macOS / Linux)

docker run --rm --platform linux/amd64 -v "${PWD}:/work" -w /work registry.gitlab.com/frontistr-commons/frontistr/fistr1:master fistr1

Abra um terminal na pasta do exemplo (PowerShell em Windows) e execute o comando. A pasta do exemplo é montada em /work no contentor. Os resultados são guardados na pasta local do exemplo.

Ao executar num terminal, a mensagem seguinte no fim do registo confirma que a análise terminou. O tempo de execução depende do PC.

FrontISTR Completed !!
Se algo não funcionar

Se os ficheiros de entrada não forem encontrados, confirme que está a executar a análise na pasta 01_elastic_hinge. Em Windows, confirme também que fistr1.exe e todas as DLL fornecidas foram copiadas para essa mesma pasta.

04

Abrir o resultado no ParaView

Instale o ParaView. Selecione File → Open e abra o ficheiro seguinte na pasta do exemplo.

hinge_vis_psf.0001.pvtu

Os resultados são gravados na mesma pasta 01_elastic_hinge. A pasta adjacente hinge_vis_psf.0001 também é necessária; não mova apenas o ficheiro .pvtu. 0000 corresponde ao estado inicial e 0001 ao resultado depois de aplicada a carga.

Transferir o ParaView

Capturas de ecrã: ParaView 6.1.0 em macOS. As operações básicas são as mesmas em Windows e Linux.

  1. 04 / 1

    Logo após abrir o ficheiro. Clique em Apply à esquerda.

    Logo após abrir o ficheiro. Clique em Apply à esquerda.
  2. 04 / 2

    A geometria da dobradiça aparece depois de clicar em Apply.

    A geometria da dobradiça aparece depois de clicar em Apply.
  3. 04 / 3

    Na barra de ferramentas superior, altere Solid Color para NodalMISES para apresentar a distribuição da tensão de von Mises.

    Na barra de ferramentas superior, altere Solid Color para NodalMISES para apresentar a distribuição da tensão de von Mises.

As cores e o fundo dependem das definições do ParaView e não precisam de coincidir com a ilustração. Se o modelo não estiver visível, experimente Reset Camera.

A sua primeira análise está concluída

Em seguida, examine as cargas e as definições de material do exemplo. O manual explica este modelo e apresenta outros tipos de análise.