FrontISTR / Getting Started
Primers passos
Executeu una anàlisi d’una frontissa amb FrontISTR i després examineu la distribució de tensions a ParaView. Descarregueu el solver i un exemple preparat: en aquesta primera execució no cal començar creant la malla.
01
Prepareu el solver
Prepareu el binari per a Windows o la imatge Docker que es pot utilitzar a Windows, macOS i Linux.
Windows (64 bits)
Extraieu el ZIP. Després de preparar l’exemple al pas següent, copieu fistr1.exe i totes les DLL que l’acompanyen a la carpeta de l’exemple (01_elastic_hinge).
Docker (Windows / macOS / Linux)
Inicieu Docker i executeu l’ordre següent en un terminal. A Windows, utilitzeu Docker en mode de contenidors Linux i executeu l’ordre a PowerShell.
docker pull --platform linux/amd64 registry.gitlab.com/frontistr-commons/frontistr/fistr1:masterLa imatge oficial actual està compilada per a amd64. Als Mac amb Apple Silicon s’executa mitjançant emulació i pot trigar més.
Compileu des del codi font
També podeu compilar FrontISTR des del codi font en qualsevol d’aquests sistemes operatius. Un cop instal·lats els compiladors i les biblioteques necessàries, CMake detecta l’entorn i configura la compilació.
Instal·leu les eines bàsiques amb les ordres següents segons la distribució que utilitzeu. Podeu començar amb l’entorn de desenvolupament existent sense afegir MPI ni altres biblioteques opcionals.
Ubuntu / Debian
sudo apt-get update
sudo apt-get install build-essential cmake git gfortranRHEL / Rocky Linux / AlmaLinux
sudo dnf install gcc gcc-c++ gcc-gfortran make cmake gitLes ordres següents mostren un exemple de compilació i instal·lació a macOS i Linux. Els executables s’instal·len al directori bin del vostre directori personal, de manera que no cal ni sudo ni modificar PATH. Consulteu la guia de compilació per preparar macOS/Windows i les biblioteques opcionals.
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 buildPodeu executar directament l’exemple inclòs sense tornar-lo a baixar. Executeu l’anàlisi amb les ordres següents i després continueu al pas 04 per veure el resultat a ParaView.
cd tutorial/01_elastic_hinge
"$HOME/bin/fistr1"Els binaris i el contenidor utilitzen les versions master / LATEST, que s’actualitzen contínuament. Consulteu la pàgina de descàrregues per a les versions etiquetades i altres entorns. Altres versions i entorns
02
Baixeu l’exemple
Baixeu i extraieu el ZIP de l’exemple. Utilitzeu els tres fitxers d’entrada de la carpeta 01_elastic_hinge.
Executeu l’anàlisi a la carpeta 01_elastic_hinge extreta. Per extreure des de la línia d’ordres, macOS i Linux utilitzen unzip.
01_elastic_hinge/
hecmw_ctrl.dat- Ubicacions dels fitxers d’entrada i de sortida
hinge.cnt- Materials, càrregues, restriccions i paràmetres d’anàlisi
hinge.msh- Malla de la frontissa
Per preparar l’exemple des de la línia d’ordres, executeu tot el bloc següent a la ubicació on el vulgueu desar. Es baixa i s’extreu l’arxiu i després s’entra a la carpeta de l’exemple. A continuació podeu executar l’ordre d’anàlisi al mateix 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
Executeu-lo des de la carpeta de l’exemple
Executeu l’anàlisi a la carpeta de l’exemple (01_elastic_hinge). Comproveu que hecmw_ctrl.dat hi sigui.
Binari per a Windows
Feu doble clic a fistr1.exe dins la carpeta de l’exemple. Les DLL que l’acompanyen també han de ser a la mateixa carpeta. Si la finestra es tanca en acabar l’execució, obriu amb ParaView els resultats escrits a la carpeta de l’exemple.
Per inspeccionar el registre
Si la finestra es tanca immediatament sense produir resultats, o si voleu inspeccionar el registre, obriu PowerShell a la carpeta de l’exemple i executeu:
.\fistr1.exeDocker (Windows / macOS / Linux)
docker run --rm --platform linux/amd64 -v "${PWD}:/work" -w /work registry.gitlab.com/frontistr-commons/frontistr/fistr1:master fistr1Obriu un terminal a la carpeta de l’exemple (PowerShell a Windows) i executeu l’ordre. La carpeta de l’exemple es munta a /work dins del contenidor. Els resultats es desen a la carpeta local de l’exemple.
Quan s’executa des d’un terminal, aquest missatge al final del registre confirma que l’anàlisi ha acabat. El temps d’execució depèn del vostre PC.
FrontISTR Completed !!Si alguna cosa no funciona
Si no es troben els fitxers d’entrada, comproveu que executeu l’anàlisi des de la carpeta 01_elastic_hinge. A Windows, comproveu també que fistr1.exe i totes les DLL que l’acompanyen s’hagin copiat a la mateixa carpeta.
04
Obriu el resultat a ParaView
Instal·leu ParaView. Trieu File → Open i obriu el fitxer següent a la carpeta de l’exemple.
hinge_vis_psf.0001.pvtuEls resultats s’escriuen a la mateixa carpeta 01_elastic_hinge. Manteniu també la carpeta veïna hinge_vis_psf.0001: no moveu el fitxer .pvtu tot sol. 0000 és l’estat inicial i 0001 és el resultat després d’aplicar la càrrega.
Captures de pantalla: ParaView 6.1.0 a macOS. Els passos bàsics són els mateixos a Windows i Linux.
-
04 / 1
Just després d’obrir el fitxer. Feu clic a Apply a l’esquerra.
-
04 / 2
La geometria de la frontissa apareix després de fer clic a Apply.
-
04 / 3
Canvieu Solid Color de la barra d’eines superior a NodalMISES per mostrar la distribució de la tensió de von Mises.
Els colors i el fons depenen de la configuració de ParaView i no cal que coincideixin amb la il·lustració. Si el model no és visible, proveu Reset Camera.
La vostra primera anàlisi s’ha completat
A continuació, examineu les càrregues i els paràmetres de material de l’exemple. El manual explica aquest model i presenta altres tipus d’anàlisi.