خرابی پیغامات کی فہرست¶

یہ صفحہ FrontISTR کے نمایاں خرابی پیغامات کو زمرہ وار مرتب کرتا ہے اور ان کے اسباب اور تدارک کی سمت دکھاتا ہے۔ یہ تمام اندرونی پیغامات کا مکمل احاطہ نہیں کرتا، بلکہ hecmw_part1 اور fistr1 استعمال کرتے وقت عام طور پر سامنے آنے والے پیغامات پر توجہ دیتا ہے۔

پیغام ظاہر ہونے پر پہلے کوڈ اور سابقے کی موجودگی دیکھیں، پھر متعلقہ زمرے کی جدول سے طے کریں کہ ان پٹ فائل، میش، عنصر، حل کنندہ، تماس، ہمگرائی یا یادداشت میں سے کس حصے کی جانچ ضروری ہے۔

پیغام پڑھنے کا طریقہ¶

FrontISTR کے پیغامات میں HEC-MW لائبریری سے آنے والے کوڈ دار پیغامات اور fistr1 سے براہِ راست نکلنے والے بغیر کوڈ پیغامات دونوں ہوتے ہیں۔ کوڈ دار پیغام میں سابقے سے ماڈیول اور اہمیت کا درجہ پہچانا جا سکتا ہے۔

پیغام کے آخر میں نظر آنے والی عددی یا متنی قدر فائل نام، مادّہ نمبر، عنصر نمبر، ذیلی اسٹیپ نمبر یا اندرونی فلیگ جیسی اجرا کے وقت کی معلومات ہو سکتی ہے۔ ایک ہی نمائندہ پیغام میں آخری قدر تجزیاتی کیس کے لحاظ سے بدل سکتی ہے۔

خروجی کوڈ¶

fistr1 تجزیے کا نتیجہ خروجی کوڈ (exit status) کے طور پر واپس کرتا ہے۔ تجزیہ معمول کے مطابق مکمل ہو تو 0، اور ناکامی کی صورت میں خرابی کی نوعیت کے مطابق غیر صفر قدر واپس ہوتی ہے۔

خروجی کوڈ کی یہ درجہ بندی ناکامی کا پتا لگانے کے لیے ہے، عین سبب متعین کرنے کے لیے نہیں۔ کوڈ 2، 3 یا 10 میں سے کوئی بھی ہو، مخصوص سبب معلوم کرنے کے لیے معیاری آؤٹ پٹ میں دکھایا گیا پیغام اور اس صفحے کے متعلقہ زمرے کی جدول دونوں دیکھیں۔

شیل اسکرپٹ سے اسے درج ذیل طرح جانچا جا سکتا ہے۔

fistr1 -t 4
case $? in
  0)  echo "completed" ;;
  10) echo "not converged" ;;
  *)  echo "failed with code $?" ;;
esac

MPI متوازی اجرا میں mpirun یا mpiexec لازماً fistr1 کا خروجی کوڈ جوں کا توں واپس نہیں کرتے۔ قابلِ اعتماد فیصلہ کرنے کے لیے خروجی کوڈ کے ساتھ FSTR.sta کی آخری سطر (... HAS COMPLETED SUCCESSFULLY یا ... HAS NOT COMPLETED SUCCESSFULLY) بھی دیکھیں۔

ان پٹ کی تشریح سے متعلق خرابیاں¶

یہ خرابیاں کنٹرول فائل، میش ڈیٹا، مادّی تعریف یا ری اسٹارٹ تعیین پڑھنے کے مرحلے میں پیدا ہوتی ہیں۔ ایسی صورت میں فوراً پہلے پڑھے گئے فائل نام، کلیدی لفظ، مادّہ نام اور گروپ نام کی جانچ کریں۔

میش اور عنصر سے متعلق خرابیاں¶

یہ خرابیاں اس وقت پیدا ہوتی ہیں جب عنصر کی قسم اور فعل کا امتزاج، مرجعی نوڈ، مقامی محددی نظام، یا تماسی سطح کی عنصر قسم ناموزوں ہو۔ صرف ان پٹ نحو نہیں بلکہ عنصر کی شکل کا معیار اور نوڈ ترتیب بھی دیکھیں۔

مقامی محددی نظام کی تشکیل میں ناکامی صرف ان پٹ قدر پر نہیں بلکہ میش کے معیار پر بھی منحصر ہے۔ خاص طور پر بہت چھوٹے عناصر، تقریباً 0 رقبہ یا حجم رکھنے والے عناصر، اور الٹی نوڈ ترتیب والے عناصر کی موجودگی دیکھیں۔

حل کنندہ سے متعلق خرابیاں¶

یہ خرابیاں غلط خطی حل کنندہ ترتیب، براہِ راست طریقے کے تجزیے کی ناکامی، میٹرکس کی تکینی حالت، یا بیرونی لائبریری لنک نہ ہونے سے پیدا ہوتی ہیں۔ تجزیہ رکنے سے فوراً پہلے کے لاگ میں تکراری طریقہ، براہِ راست طریقہ، تماسی درجۂ آزادی اور MPC سے متعلق معلومات دیکھیں۔

براہِ راست طریقے کے تجزیے کی ناکامی صرف حل کنندہ ترتیب سے نہیں بلکہ ماڈل کی سخت جسمی حرکت، ناکافی یا متضاد قیود، انتہائی مادّی مستقل، یا تماسی عدم مطابقت سے بھی پیدا ہو سکتی ہے۔ حدی شرائط اور بوجھ کو سادہ کیس تک واپس لا کر کم سے کم ساخت میں خطی نظام حل ہونے کی جانچ سبب الگ کرنے میں مدد دیتی ہے۔

تماسی تجزیے کی خرابیاں¶

تماسی خرابیاں تماسی جوڑی اور سطحی گروپ کی عدم مطابقت، تماس تلاش میں ہندسی تکینی حالت، سطحی عنصر قسم کے عدم تطابق، یا تماس تلاش کے لیے یادداشت کی کمی سے پیدا ہوتی ہیں۔ سلیو اور ماسٹر گروپ نام، تماسی سطح کی عنصر قسم، ابتدائی دخول، اور سطح کے نارمل کی سمت دیکھیں۔

اگر تماسی خرابی ان پٹ کے فوراً بعد آئے تو تماسی جوڑی یا سطحی گروپ نام کی عدم مطابقت اہم امیدوار ہے۔ اگر غیر خطی تکرار کے دوران آئے تو بگاڑ سے سطح کا شدید مسخ ہونا، ابتدائی دخول کا بہت بڑا ہونا، یا وقت افزائش کا بہت بڑا ہونا ممکن سبب ہے۔

تماس کی قسم اور الگورتھم کے انتخاب کے لیے تماس اور مدفونیت دیکھیں۔

ہمگرائی اور cutback کی خرابیاں¶

ہمگرائی اور cutback کی خرابیاں اس وقت پیدا ہوتی ہیں جب غیر خطی ساکن تجزیہ ذیلی اسٹیپ آگے نہیں بڑھا سکتا۔ تماس کا شروع یا ختم ہونا، تسلیم کی تیز پیش رفت، بڑا بگاڑ، قیود کی عدم مطابقت، اور بہت بڑی بوجھ افزائش اہم اسباب ہیں۔

ہمگرائی ناکام ہونے پر صرف حل کنندہ کی زیادہ سے زیادہ تکرارات بڑھانے سے بنیادی سبب حل نہیں ہوتا۔ بوجھ مرحلہ وار دیں اور تماس یا مادّی غیر خطیت کو سادہ کر کے تولید پذیری دیکھیں تاکہ سبب الگ ہو سکے۔

حدی شرط کی خرابیاں¶

یہ خرابیاں اس وقت پیدا ہوتی ہیں جب کنٹرول فائل کی تعیین فعلی پابندیوں سے مطابقت نہ رکھے۔ دورانی حدی شرط میں نقل مکانی قید کی طرح کل مقدار دینے سے خرابی پیدا ہوتی ہے۔

دورانی قید اور دورانی بوجھ عنصر قسم اور درجۂ آزادی کی ساخت پر بھی منحصر ہیں۔ بیم اور شیل جیسے دورانی درجۂ آزادی رکھنے والے عناصر میں حدی شرط کے درجۂ آزادی نمبر اور متعلقہ نوڈ گروپ دونوں دیکھیں۔

میش تقسیم (hecmw_part1) کی خرابیاں¶

hecmw_part1 کی خرابیاں HECMW-PART سے شروع ہونے والے کوڈ کے طور پر آتی ہیں۔ میش تقسیم کے دوران ان پٹ فائل کی موجودگی، !PARTITION کے لازمی پیرامیٹر، تقسیم طریقے اور ڈومین تعداد کی پابندیاں، اور صارف متعین پارٹ فائل کی مطابقت کو ترتیب سے دیکھیں۔

ڈومین تقسیم کے تصور اور میش تقسیم کے طریقوں کے انتخاب کے لیے میش تقسیم دیکھیں۔ متوازی اجرا کے عملی مراحل کے لیے اجرا گائیڈ دیکھیں۔

یادداشت مختص کرنے کی خرابیاں¶

یہ خرابیاں اس وقت نکلتی ہیں جب ارے یا عارضی کام کی جگہ کے لیے یادداشت مختص نہ ہو سکے۔ بڑے میش، بہت سی تماسی سطحوں، براہِ راست طریقے، یا زیادہ آؤٹ پٹ متغیرات والے تجزیے میں یادداشت کا استعمال بڑھتا ہے۔

یادداشت کی کمی کا شبہ ہو تو پہلے دیکھیں کہ براہِ راست طریقے کو تکراری طریقے سے بدلا جا سکتا ہے یا نہیں۔ اگر براہِ راست طریقہ ضروری ہو تو ماڈل چھوٹا کریں، آؤٹ پٹ متغیر کم کریں، ڈومین تقسیم کی تعداد بدلیں، یا جاب کے لیے مختص یادداشت بڑھائیں۔

ری اسٹارٹ کی خرابیاں¶

ری اسٹارٹ خرابیاں !RESTART کی غلط نحو، لازمی پیرامیٹر کی کمی، یا پڑھی جانے والی فائل اور موجودہ تجزیاتی شرط کی عدم مطابقت سے پیدا ہوتی ہیں۔ ری اسٹارٹ استعمال کرتے وقت لکھنے اور پڑھنے والے تجزیوں میں میش، ڈومین تقسیم کی تعداد، تجزیے کی قسم اور اسٹیپ معلومات کا مطابقت پذیر ہونا ضروری ہے۔

ری اسٹارٹ پڑھنے میں ناکامی ہو تو صرف فائل نام نہیں بلکہ لکھنے اور پڑھنے کے وقت کی میش، MPI ڈومین تعداد، اسٹیپ ترتیب اور ری اسٹارٹ ورژن بھی دیکھیں۔ ری اسٹارٹ فعل کے خاکے کے لیے آؤٹ پٹ اور ری اسٹارٹ دیکھیں۔

متعلقہ موضوعات¶

• حل کنندہ اور پیش شرطی — حل کنندہ سے متعلق خرابیوں کا پس منظر۔
• میش تقسیم — hecmw_part1 خرابیوں کا پس منظر۔
• آؤٹ پٹ اور ری اسٹارٹ — ری اسٹارٹ تعیین اور آؤٹ پٹ فائل کی جانچ۔
• ضروری اور اختیاری انحصاری لائبریریاں — METIS وغیرہ کی انحصاری لائبریریاں اور بلڈ ترتیبات۔