FrontISTR / Getting Started
Kom godt i gang
Analyser et hængsel med FrontISTR, og undersøg derefter spændingsfordelingen i ParaView. Med solveren og et færdigt eksempel behøver du ikke begynde med at oprette et mesh.
01
Hent solveren
Brug Windows-binærfilen eller Docker-imaget, som kan bruges på Windows, macOS og Linux.
Windows (64-bit)
Pak ZIP-filen ud. Når du har klargjort eksemplet i næste trin, skal du kopiere fistr1.exe og alle medfølgende DLL-filer til eksempelmappen (01_elastic_hinge).
Docker (Windows / macOS / Linux)
Start Docker, og kør derefter følgende kommando i en terminal. På Windows skal du bruge Docker i Linux-container-tilstand og køre kommandoen i PowerShell.
docker pull --platform linux/amd64 registry.gitlab.com/frontistr-commons/frontistr/fistr1:master
Det aktuelle officielle image er bygget til amd64. På Mac-computere med Apple Silicon kører det via emulering og kan derfor tage længere tid.
Byg fra kildekode
Du kan også bygge FrontISTR fra kildekoden på alle disse operativsystemer. Når compilere og de nødvendige biblioteker er installeret, registrerer CMake miljøet og konfigurerer buildet.
Installer basisværktøjerne med kommandoerne nedenfor for din distribution. Du kan bruge dit eksisterende udviklingsmiljø uden først at tilføje MPI eller andre valgfrie biblioteker.
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
Følgende kommandoer viser et eksempel på build og installation på macOS og Linux. De eksekverbare filer installeres i bin under din hjemmemappe, så hverken sudo eller ændringer af PATH er nødvendige. Se build-guiden for opsætning på macOS/Windows og valgfrie biblioteker.
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
Du kan køre det medfølgende eksempel direkte uden at downloade det igen. Kør analysen med kommandoerne nedenfor, og fortsæt derefter til trin 04 for at se resultatet i ParaView.
cd tutorial/01_elastic_hinge
"$HOME/bin/fistr1"
Binærfilerne og containeren bruger de løbende opdaterede versioner master / LATEST. Se downloadsiden for udgivne versioner og andre miljøer. Andre versioner og miljøer
02
Download eksemplet
Download og pak eksemplets ZIP-fil ud. Brug de tre inputfiler i mappen 01_elastic_hinge.
Kør analysen i den udpakkede mappe 01_elastic_hinge. Ved udpakning fra kommandolinjen bruges unzip på macOS og Linux.
01_elastic_hinge/
hecmw_ctrl.dat- Placeringer af input- og outputfiler
hinge.cnt- Materialer, belastninger, randbetingelser og analyseindstillinger
hinge.msh- Hængslets mesh
Hvis du vil klargøre eksemplet fra kommandolinjen, skal du køre hele blokken nedenfor på det sted, hvor du vil gemme eksemplet. Den downloader og pakker arkivet ud og går derefter ind i eksempelmappen. Fortsæt med analysekommandoen i samme 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
Kør fra eksempelmappen
Kør analysen i eksempelmappen 01_elastic_hinge. Kontrollér, at hecmw_ctrl.dat findes i mappen.
Windows-binærfil
Dobbeltklik på fistr1.exe i eksempelmappen. De medfølgende DLL-filer skal ligge i samme mappe. Hvis vinduet lukker, når kørslen er færdig, skal du åbne resultaterne fra eksempelmappen i ParaView.
Se loggen
Hvis vinduet lukker med det samme uden at producere resultater, eller hvis du vil gennemse loggen, skal du åbne PowerShell i eksempelmappen og køre:
.\fistr1.exeDocker (Windows / macOS / Linux)
docker run --rm --platform linux/amd64 -v "${PWD}:/work" -w /work registry.gitlab.com/frontistr-commons/frontistr/fistr1:master fistr1Åbn en terminal i eksempelmappen (PowerShell på Windows), og kør kommandoen. Eksempelmappen monteres som /work i containeren. Resultaterne gemmes i din lokale eksempelmappe.
Når analysen køres i en terminal, bekræfter følgende meddelelse sidst i loggen, at analysen er afsluttet. Køretiden afhænger af din pc.
FrontISTR Completed !!Hvis noget ikke virker
Hvis inputfilerne ikke kan findes, skal du kontrollere, at analysen køres fra mappen 01_elastic_hinge. På Windows skal du også kontrollere, at fistr1.exe og alle medfølgende DLL-filer er kopieret til den samme mappe.
04
Åbn resultatet i ParaView
Installer ParaView. Vælg File → Open, og åbn følgende fil i eksempelmappen.
hinge_vis_psf.0001.pvtu
Resultaterne skrives til den samme mappe 01_elastic_hinge. Behold også den tilstødende mappe hinge_vis_psf.0001; flyt ikke .pvtu-filen alene. 0000 er starttilstanden, og 0001 er resultatet efter belastning.
Skærmbilleder: ParaView 6.1.0 på macOS. De grundlæggende trin er de samme på Windows og Linux.
-
04 / 1
Lige efter at filen er åbnet. Klik på Apply til venstre.
-
04 / 2
Hængslets geometri vises, når du klikker på Apply.
-
04 / 3
Skift Solid Color i den øverste værktøjslinje til NodalMISES for at vise fordelingen af von Mises-spænding.
Farver og baggrund afhænger af indstillingerne i ParaView og behøver ikke matche illustrationen. Hvis modellen ikke kan ses, kan du prøve Reset Camera.
Din første analyse er færdig
Undersøg derefter belastningerne og materialeindstillingerne i eksemplet. Manualen beskriver modellen og introducerer andre analysetyper.