FrontISTR / Getting Started
Memulai
Jalankan analisis engsel dengan FrontISTR, lalu lihat distribusi tegangan di ParaView. Unduh solver dan contoh siap pakai; untuk percobaan pertama ini Anda tidak perlu membuat mesh dari awal.
01
Siapkan solver
Siapkan biner Windows atau image Docker yang dapat digunakan di Windows, macOS, dan Linux.
Windows (64-bit)
Ekstrak ZIP. Setelah menyiapkan contoh pada langkah berikutnya, salin fistr1.exe dan semua DLL yang menyertainya ke folder contoh (01_elastic_hinge).
Docker (Windows / macOS / Linux)
Jalankan Docker, lalu eksekusi perintah berikut di terminal. Di Windows, gunakan Docker dalam mode container Linux dan jalankan perintah di PowerShell.
docker pull --platform linux/amd64 registry.gitlab.com/frontistr-commons/frontistr/fistr1:master
Image resmi saat ini dibuat untuk amd64. Di Mac Apple Silicon, image ini berjalan melalui emulasi sehingga mungkin memerlukan waktu lebih lama.
Build dari kode sumber
Anda juga dapat membangun FrontISTR sendiri dari kode sumber pada sistem operasi mana pun di atas. Setelah compiler dan library yang diperlukan terpasang, CMake akan mendeteksi lingkungan Anda dan mengatur build.
Pasang alat dasar dengan perintah di bawah sesuai distribusi yang Anda gunakan. Anda dapat memulai dari lingkungan pengembangan yang sudah ada tanpa menambahkan MPI atau library opsional lainnya.
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
Perintah berikut adalah contoh build dan instalasi di macOS dan Linux. File executable dipasang ke direktori bin di home Anda, sehingga tidak memerlukan sudo atau perubahan PATH. Lihat panduan build untuk penyiapan macOS/Windows dan library opsional.
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
Anda dapat langsung menjalankan contoh yang disertakan tanpa mengunduhnya lagi. Jalankan analisis dengan perintah berikut, lalu lanjutkan ke langkah 04 untuk melihat hasil di ParaView.
cd tutorial/01_elastic_hinge
"$HOME/bin/fistr1"
Biner dan container menggunakan versi master / LATEST yang terus diperbarui. Lihat halaman unduhan untuk rilis bertag dan lingkungan lainnya. Versi dan lingkungan lainnya
02
Unduh contoh
Unduh dan ekstrak ZIP contoh. Gunakan tiga file input di dalam folder 01_elastic_hinge.
Jalankan analisis di folder 01_elastic_hinge yang sudah diekstrak. Untuk ekstraksi melalui command line, macOS dan Linux menggunakan unzip.
01_elastic_hinge/
hecmw_ctrl.dat- Lokasi file input dan output
hinge.cnt- Material, beban, pengekangan, dan pengaturan analisis
hinge.msh- Mesh engsel
Jika ingin menyiapkan contoh melalui command line, jalankan seluruh blok berikut di lokasi tempat Anda ingin menyimpan contoh. Blok ini mengunduh dan mengekstrak arsip, lalu masuk ke folder contoh. Setelah itu, jalankan perintah analisis di terminal yang sama.
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
Jalankan dari folder contoh
Jalankan analisis di folder contoh (01_elastic_hinge). Pastikan hecmw_ctrl.dat berada di folder tersebut.
Biner Windows
Klik dua kali fistr1.exe di folder contoh. Semua DLL yang menyertainya juga harus berada di folder yang sama. Jika jendela tertutup saat proses selesai, buka hasil yang ditulis ke folder contoh dengan ParaView.
Untuk memeriksa log
Jika jendela langsung tertutup tanpa menghasilkan keluaran, atau jika Anda ingin memeriksa log, buka PowerShell di folder contoh lalu jalankan:
.\fistr1.exeDocker (Windows / macOS / Linux)
docker run --rm --platform linux/amd64 -v "${PWD}:/work" -w /work registry.gitlab.com/frontistr-commons/frontistr/fistr1:master fistr1Buka terminal di folder contoh (PowerShell di Windows) lalu jalankan perintah. Folder contoh dipasang sebagai /work di dalam container. Hasil disimpan di folder contoh lokal.
Jika dijalankan dari terminal, pesan berikut di akhir log menandakan analisis telah selesai. Lama proses bergantung pada PC Anda.
FrontISTR Completed !!Jika terjadi masalah
Jika file input tidak ditemukan, pastikan Anda menjalankan analisis dari folder 01_elastic_hinge. Di Windows, pastikan fistr1.exe dan semua DLL yang menyertainya telah disalin ke folder yang sama.
04
Buka hasil di ParaView
Pasang ParaView. Pilih File → Open, lalu buka file berikut di folder contoh.
hinge_vis_psf.0001.pvtu
Hasil ditulis ke folder 01_elastic_hinge yang sama. Folder hinge_vis_psf.0001 di sebelahnya juga diperlukan, jadi jangan memindahkan file .pvtu sendirian. 0000 adalah kondisi awal, sedangkan 0001 adalah hasil setelah beban diterapkan.
Contoh layar: ParaView 6.1.0 di macOS. Langkah dasarnya sama di Windows dan Linux.
-
04 / 1
Tampilan sesaat setelah file dibuka. Klik Apply di sebelah kiri.
-
04 / 2
Geometri engsel muncul setelah Anda mengklik Apply.
-
04 / 3
Ubah Solid Color pada toolbar bagian atas menjadi NodalMISES untuk menampilkan distribusi tegangan von Mises.
Warna dan latar belakang bergantung pada pengaturan ParaView dan tidak harus sama dengan contoh. Jika model tidak terlihat, coba Reset Camera.
Analisis pertama Anda selesai
Selanjutnya, lihat pengaturan beban dan material pada contoh. Panduan menjelaskan model ini dan memperkenalkan jenis analisis lainnya.