Primii pași

FrontISTR / Getting Started

Primii pași

Analizează o balama cu FrontISTR, apoi examinează distribuția tensiunilor în ParaView. Cu solverul și un exemplu gata pregătit, la prima rulare nu trebuie să începi prin crearea unei rețele.

Urmează pașii

Distribuția tensiunii von Mises într-o balama, cu concentrații de tensiune în jurul găurilor.
Rulează o analiză statică liniară a unei balamale. Obiectivul este să afișezi NodalMISES, adică tensiunea von Mises nodală, sub forma unei hărți de contur colorate.

01

Obține solverul

Folosește binarul pentru Windows sau imaginea Docker, care poate fi utilizată în Windows, macOS și Linux.

Windows (64-bit)

Descarcă pentru Windows

Dezarhivează fișierul ZIP. După ce pregătești exemplul la pasul următor, copiază fistr1.exe și toate DLL-urile incluse în folderul exemplului (01_elastic_hinge).

Docker (Windows / macOS / Linux)

Pornește Docker, apoi execută comanda următoare într-un terminal. În Windows, folosește Docker în modul pentru containere Linux și execută comanda în PowerShell.

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

Imaginea oficială curentă este construită pentru amd64. Pe Mac-urile cu Apple Silicon rulează prin emulare și poate dura mai mult.

Construiește din codul sursă

Poți construi FrontISTR și din codul sursă pe oricare dintre aceste sisteme de operare. După instalarea compilatoarelor și a bibliotecilor necesare, CMake detectează mediul și configurează compilarea.

Instalează instrumentele de bază folosind comenzile de mai jos pentru distribuția ta. Poți folosi mediul de dezvoltare existent fără să adaugi inițial MPI sau alte biblioteci opționale.

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

Comenzile următoare arată un exemplu de compilare și instalare pe macOS și Linux. Executabilele sunt instalate în directorul bin din directorul personal, astfel încât nu sunt necesare sudo sau modificări ale PATH. Consultă ghidul de compilare pentru pregătirea macOS/Windows și bibliotecile opționale.

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

Poți rula direct exemplul inclus, fără să îl descarci din nou. Execută analiza folosind comenzile de mai jos, apoi continuă cu pasul 04 pentru a vedea rezultatul în ParaView.

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

Construiește din codul sursă

Binarele și containerul folosesc versiunile master / LATEST actualizate continuu. Consultă pagina de descărcare pentru versiunile lansate și alte medii. Alte versiuni și medii

02

Descarcă exemplul

Descarcă și extrage fișierul ZIP al exemplului. Folosește cele trei fișiere de intrare din folderul 01_elastic_hinge.

Descarcă exemplul (ZIP)

Rulează analiza în folderul 01_elastic_hinge extras. Pentru extragerea din linia de comandă, macOS și Linux folosesc unzip.

01_elastic_hinge/

hecmw_ctrl.dat
Locațiile fișierelor de intrare și ieșire
hinge.cnt
Materiale, sarcini, constrângeri și setări de analiză
hinge.msh
Rețeaua balamalei

Pentru a pregăti exemplul din linia de comandă, execută întregul bloc de mai jos în locul în care vrei să păstrezi exemplul. Acesta descarcă și extrage arhiva, apoi intră în folderul exemplului. Poți continua cu comanda de analiză în același 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

Rulează din folderul exemplului

Rulează analiza în folderul exemplului 01_elastic_hinge. Verifică dacă hecmw_ctrl.dat se află în acel folder.

Binar pentru Windows

Fă dublu clic pe fistr1.exe în folderul exemplului. DLL-urile incluse trebuie să se afle în același folder. Dacă fereastra se închide la finalul rulării, deschide în ParaView rezultatele scrise în folderul exemplului.

Vezi jurnalul

Dacă fereastra se închide imediat fără să producă rezultate sau dacă vrei să verifici jurnalul, deschide PowerShell în folderul exemplului și execută:

.\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

Deschide un terminal în folderul exemplului (PowerShell în Windows) și execută comanda. Folderul exemplului este montat ca /work în container. Rezultatele sunt salvate în folderul local al exemplului.

La rularea într-un terminal, mesajul următor de la sfârșitul jurnalului confirmă că analiza s-a încheiat. Durata depinde de PC.

FrontISTR Completed !!
Dacă ceva nu funcționează

Dacă fișierele de intrare nu pot fi găsite, verifică dacă rulezi analiza din folderul 01_elastic_hinge. În Windows, verifică și dacă fistr1.exe și toate DLL-urile incluse au fost copiate în același folder.

04

Deschide rezultatul în ParaView

Instalează ParaView. Alege File → Open și deschide fișierul următor din folderul exemplului.

hinge_vis_psf.0001.pvtu

Rezultatele sunt scrise în același folder 01_elastic_hinge. Păstrează și folderul alăturat hinge_vis_psf.0001; nu muta singur fișierul .pvtu. 0000 este starea inițială, iar 0001 este rezultatul după aplicarea sarcinii.

Descarcă ParaView

Capturi de ecran: ParaView 6.1.0 pe macOS. Pașii de bază sunt aceiași în Windows și Linux.

  1. 04 / 1

    Imediat după deschiderea fișierului. Apasă Apply în partea stângă.

    Imediat după deschiderea fișierului. Apasă Apply în partea stângă.
  2. 04 / 2

    Geometria balamalei apare după ce apeși Apply.

    Geometria balamalei apare după ce apeși Apply.
  3. 04 / 3

    Schimbă Solid Color din bara de instrumente de sus în NodalMISES pentru a afișa distribuția tensiunii von Mises.

    Schimbă Solid Color din bara de instrumente de sus în NodalMISES pentru a afișa distribuția tensiunii von Mises.

Culorile și fundalul depind de setările ParaView și nu trebuie să coincidă cu ilustrația. Dacă modelul nu este vizibil, încearcă Reset Camera.

Prima analiză este finalizată

În continuare, examinează sarcinile și setările de material din exemplu. Manualul descrie acest model și prezintă alte tipuri de analiză.