البدء

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.

اكتمل تحليلك الأول

بعد ذلك، راجع الأحمال وإعدادات المواد في المثال. يشرح الدليل هذا النموذج ويعرض أنواعًا أخرى من التحليل.