FrontISTR / Getting Started
Primeros pasos
Analice una bisagra con FrontISTR y examine después la distribución de tensiones en ParaView. Con el solver y el ejemplo ya preparados, no es necesario empezar creando una malla.
01
Preparar el solver
Prepare el binario para Windows o la imagen Docker que puede utilizarse en Windows, macOS y Linux.
Windows (64 bits)
Extraiga el ZIP. Después de preparar el ejemplo en el siguiente paso, copie fistr1.exe y todas las DLL incluidas en la carpeta del ejemplo (01_elastic_hinge).
Docker (Windows / macOS / Linux)
Inicie Docker y ejecute el siguiente comando en un terminal. En Windows, use Docker en modo de contenedores Linux y ejecute el comando en PowerShell.
docker pull --platform linux/amd64 registry.gitlab.com/frontistr-commons/frontistr/fistr1:master
La imagen oficial actual está compilada para amd64. En los Mac con Apple Silicon se ejecuta mediante emulación y puede tardar más.
Compilar desde el código fuente
También puede compilar FrontISTR desde el código fuente en cualquiera de estos sistemas operativos. Una vez instalados los compiladores y las bibliotecas necesarias, CMake detecta el entorno y configura la compilación.
Instale las herramientas básicas con los comandos indicados a continuación para su distribución. Puede partir de su entorno de desarrollo actual sin añadir MPI ni otras bibliotecas opcionales.
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
Los siguientes comandos muestran un ejemplo de compilación e instalación en macOS y Linux. Los ejecutables se instalan en el directorio bin de su directorio personal, por lo que no hacen falta sudo ni cambios en PATH. Consulte la guía de compilación para preparar macOS/Windows y añadir bibliotecas opcionales.
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
Puede ejecutar directamente el ejemplo incluido sin volver a descargarlo. Ejecute el análisis con los comandos siguientes y después continúe con el paso 04 para ver el resultado en ParaView.
cd tutorial/01_elastic_hinge
"$HOME/bin/fistr1"
Los binarios y el contenedor utilizan las versiones master / LATEST, que se actualizan continuamente. Consulte la página de descargas para las versiones publicadas y otros entornos. Otras versiones y entornos
02
Descargar el ejemplo
Descargue y extraiga el ZIP del ejemplo. Utilice los tres archivos de entrada que se encuentran en la carpeta 01_elastic_hinge.
Ejecute el análisis en la carpeta 01_elastic_hinge extraída. Para extraer desde la línea de comandos, macOS y Linux utilizan unzip.
01_elastic_hinge/
hecmw_ctrl.dat- Ubicación de los archivos de entrada y salida
hinge.cnt- Materiales, cargas, restricciones y ajustes del análisis
hinge.msh- Malla de la bisagra
Si desea preparar el ejemplo desde la línea de comandos, ejecute todo el bloque siguiente en la ubicación donde quiera guardarlo. Se descargará y extraerá el archivo y se entrará en la carpeta del ejemplo. Después puede ejecutar el comando de análisis en el mismo 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
Ejecutar desde la carpeta del ejemplo
Ejecute el análisis en la carpeta del ejemplo (01_elastic_hinge). Compruebe que hecmw_ctrl.dat se encuentra en esa carpeta.
Binario para Windows
Haga doble clic en fistr1.exe dentro de la carpeta del ejemplo. Las DLL incluidas también deben estar en la misma carpeta. Si la ventana se cierra al terminar la ejecución, abra en ParaView los resultados generados en la carpeta del ejemplo.
Para revisar el registro
Si la ventana se cierra inmediatamente sin generar resultados, o si quiere revisar el registro, abra PowerShell en la carpeta del ejemplo y ejecute:
.\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 un terminal en la carpeta del ejemplo (PowerShell en Windows) y ejecute el comando. La carpeta del ejemplo se monta en /work dentro del contenedor. Los resultados se guardan en la carpeta local del ejemplo.
Si ejecuta el análisis en un terminal, el siguiente mensaje al final del registro confirma que ha finalizado. El tiempo de ejecución depende del PC.
FrontISTR Completed !!Si algo no funciona
Si no se encuentran los archivos de entrada, compruebe que está ejecutando el análisis desde la carpeta 01_elastic_hinge. En Windows, compruebe también que fistr1.exe y todas las DLL incluidas se han copiado en esa misma carpeta.
04
Abrir el resultado en ParaView
Instale ParaView. Seleccione File → Open y abra el siguiente archivo de la carpeta del ejemplo.
hinge_vis_psf.0001.pvtu
Los resultados se guardan en la misma carpeta 01_elastic_hinge. También se necesita la carpeta adyacente hinge_vis_psf.0001, así que no mueva el archivo .pvtu por separado. 0000 es el estado inicial y 0001 es el resultado después de aplicar la carga.
Capturas de pantalla: ParaView 6.1.0 en macOS. Los pasos básicos son los mismos en Windows y Linux.
-
04 / 1
Justo después de abrir el archivo. Haga clic en Apply, a la izquierda.
-
04 / 2
La geometría de la bisagra aparece después de hacer clic en Apply.
-
04 / 3
Cambie Solid Color por NodalMISES en la barra de herramientas superior para mostrar la distribución de la tensión de von Mises.
Los colores y el fondo dependen de la configuración de ParaView y no tienen que coincidir con la imagen de ejemplo. Si no ve el modelo, pruebe Reset Camera.
Su primer análisis ha terminado
A continuación, examine las cargas y los ajustes de material del ejemplo. El manual explica este modelo y presenta otros tipos de análisis.