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.
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)
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"
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.
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_hinge03
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.exeDocker (Windows / macOS / Linux)
docker run --rm --platform linux/amd64 -v "${PWD}:/work" -w /work registry.gitlab.com/frontistr-commons/frontistr/fistr1:master fistr1Abra 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.
Capturas de ecrã: ParaView 6.1.0 em macOS. As operações básicas são as mesmas em Windows e Linux.
-
04 / 1
Logo após abrir o ficheiro. Clique em Apply à esquerda.
-
04 / 2
A geometria da dobradiça aparece depois de clicar em Apply.
-
04 / 3
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.