מתחילים

FrontISTR / Getting Started

מתחילים

הריצו ניתוח של ציר באמצעות FrontISTR ולאחר מכן בחנו את התפלגות המאמצים ב-ParaView. הורידו את הפותר ואת הדוגמה המוכנה; בהרצה הראשונה אין צורך ליצור רשת מאפס.

הצגת השלבים

התפלגות מאמץ von Mises בציר, עם ריכוזי מאמצים סביב החורים.
הריצו אנליזה סטטית ליניארית של ציר. המטרה היא להציג את NodalMISES, כלומר מאמץ von Mises בצמתים, כמפת קווי מתאר צבעונית.

01

הכינו את הפותר

בחרו בקובץ הבינארי ל-Windows או בתמונת Docker שניתן להשתמש בה ב-Windows, macOS ו-Linux.

Windows (64-bit)

הורדה עבור Windows

חלצו את קובץ ה-ZIP. לאחר הכנת הדוגמה בשלב הבא, העתיקו את fistr1.exe ואת כל קובצי ה-DLL המצורפים לתיקיית הדוגמה (01_elastic_hinge).

Docker (Windows / macOS / Linux)

הפעילו את Docker ולאחר מכן הריצו את הפקודה הבאה במסוף. ב-Windows השתמשו ב-Docker במצב קונטיינרי Linux והריצו את הפקודה ב-PowerShell.

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

התמונה הרשמית הנוכחית בנויה עבור amd64. במחשבי Mac עם Apple Silicon היא פועלת באמצעות אמולציה ולכן עשויה להימשך זמן רב יותר.

בנייה מקוד המקור

אפשר גם לבנות את FrontISTR מקוד המקור בכל אחת ממערכות ההפעלה האלה. לאחר התקנת המהדרים והספריות הדרושות, CMake מזהה את הסביבה ומגדיר את הבנייה.

התקינו את כלי הבסיס באמצעות הפקודות שלהלן עבור ההפצה שלכם. אפשר להתחיל עם סביבת הפיתוח הקיימת בלי להוסיף MPI או ספריות אופציונליות אחרות.

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

הפקודות הבאות מציגות דוגמה לבנייה ולהתקנה ב-macOS וב-Linux. קובצי ההפעלה מותקנים בתיקיית bin שבתיקיית הבית, ולכן אין צורך ב-sudo או בשינוי PATH. עיינו במדריך הבנייה להכנת סביבת macOS/Windows ולספריות אופציונליות.

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

אפשר להריץ את הדוגמה המצורפת בלי להוריד אותה שוב. הריצו את הפקודות שלהלן ולאחר מכן עברו לשלב 04 כדי להציג את התוצאה ב-ParaView.

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

בנייה מקוד המקור

הקבצים הבינאריים והקונטיינר משתמשים בגרסאות master / LATEST המתעדכנות ברציפות. לגרסאות מתויגות ולסביבות אחרות עיינו בדף ההורדות. גרסאות וסביבות אחרות

02

הורידו את הדוגמה

הורידו וחלצו את קובץ ה-ZIP של הדוגמה. השתמשו בשלושת קובצי הקלט שבתיקיית 01_elastic_hinge.

הורדת הדוגמה (ZIP)

הריצו את האנליזה בתיקיית 01_elastic_hinge שחולצה. פקודת החילוץ בשורת הפקודה של macOS/Linux משתמשת ב-unzip.

01_elastic_hinge/

hecmw_ctrl.dat
מיקומי קובצי הקלט והפלט
hinge.cnt
חומרים, עומסים, אילוצים והגדרות אנליזה
hinge.msh
רשת הציר

כדי להשתמש בשורת הפקודה, הריצו את כל הבלוק שלהלן מהמיקום שבו תרצו לשמור את הדוגמה. הוא מוריד ומחלץ את הארכיון ולאחר מכן עובר לתיקיית הדוגמה. המשיכו עם פקודת האנליזה באותו מסוף.

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

הריצו מתיקיית הדוגמה

הריצו את האנליזה בתיקיית הדוגמה 01_elastic_hinge. ודאו שהקובץ hecmw_ctrl.dat נמצא בתיקייה.

קובץ בינארי ל-Windows

לחצו פעמיים על fistr1.exe בתיקיית הדוגמה. גם קובצי ה-DLL המצורפים צריכים להיות באותה תיקייה. אם החלון נסגר בסיום ההרצה, פתחו ב-ParaView את התוצאות שנכתבו לתיקיית הדוגמה.

לבדיקת היומן

אם החלון נסגר מיד בלי ליצור תוצאות, או אם ברצונכם לבדוק את היומן, פתחו PowerShell בתיקיית הדוגמה והריצו:

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

פתחו מסוף בתיקיית הדוגמה (PowerShell ב-Windows) והריצו את הפקודה. תיקיית הדוגמה ממופה בתוך הקונטיינר אל /work. התוצאות נשמרות בתיקיית הדוגמה המקומית.

כאשר מריצים במסוף, הופעת ההודעה הבאה בסוף היומן מאשרת שהאנליזה הסתיימה. זמן הריצה תלוי במחשב.

FrontISTR Completed !!
אם משהו אינו עובד

אם קובצי הקלט אינם נמצאים, ודאו שאתם מריצים מתוך תיקיית 01_elastic_hinge. ב-Windows ודאו גם ש-fistr1.exe וכל קובצי ה-DLL המצורפים הועתקו לאותה תיקייה.

04

פתחו את התוצאה ב-ParaView

התקינו את ParaView. בחרו File → Open ופתחו את הקובץ הבא בתיקיית הדוגמה.

hinge_vis_psf.0001.pvtu

התוצאות נכתבות לאותה תיקיית 01_elastic_hinge. שמרו גם את התיקייה הסמוכה hinge_vis_psf.0001; אל תעבירו את קובץ .pvtu לבדו. 0000 הוא המצב ההתחלתי, ו-0001 הוא התוצאה לאחר הפעלת העומס.

הורדת ParaView

צילומי מסך: ParaView 6.1.0 ב-macOS. השלבים הבסיסיים זהים ב-Windows וב-Linux.

  1. 04 / 1

    מיד לאחר פתיחת הקובץ. לחצו על Apply בצד שמאל.

    מיד לאחר פתיחת הקובץ. לחצו על Apply בצד שמאל.

  2. 04 / 2

    גאומטריית הציר מופיעה לאחר לחיצה על Apply.

    גאומטריית הציר מופיעה לאחר לחיצה על Apply.

  3. 04 / 3

    שנו את Solid Color בסרגל הכלים העליון ל-NodalMISES כדי להציג את התפלגות מאמץ von Mises.

    שנו את Solid Color בסרגל הכלים העליון ל-NodalMISES כדי להציג את התפלגות מאמץ von Mises.

הצבעים והרקע תלויים בהגדרות ParaView ואינם חייבים להתאים לתמונה. אם המודל אינו נראה, נסו Reset Camera.

האנליזה הראשונה הושלמה

כעת בחנו את העומסים ואת הגדרות החומר בדוגמה. המדריך מסביר את המודל הזה ומציג סוגי אנליזה נוספים.