.\" Text automatically generated by txt2man
.TH dgscat 1 "05 August 2023" "" "PT-Scotch user's manual"
.SH "نام (NAME)"
dggath, dgscat, gscat \- تبدیل گراف‌های منبع توزیع‌شده به متمرکز یا برعکس
.SH "خلاصه دستور (SYNOPSIS)"
.nf
.fam C
\fBdggath\fP [\fIoptions\fP] [\fIigfile\fP] [\fIogfile\fP]

\fBdgscat\fP [\fIoptions\fP] [\fIigfile\fP] [\fIogfile\fP]

\fBgscat\fP [\fIoptions\fP] [\fIigfile\fP] [\fIogfile\fP]

.fam T
.fi
.fam T
.fi
.SH "توضیحات (DESCRIPTION)"
برنامهٔ \fBdggath\fP گراف‌های توزیع‌شده را در قالب گراف‌های متمرکز گردآوری (gather) می‌کند. این برنامه مجموعه‌ای از فایل‌های \fIigfile\fP را که قطعات یک گراف منبع توزیع‌شده را نشان می‌دهند می‌خواند و آن‌ها را در قالب یک فایل گراف منبع متمرکز واحد \fIogfile\fP بازمی‌نویسد.
.PP
برنامهٔ \fBdgscat\fP گراف‌های منبع متمرکز را در قالب گراف‌های توزیع‌شده پخش (scatter) می‌کند. این برنامه یک فایل گراف منبع متمرکز \fIigfile\fP را می‌خواند و آن را در قالب مجموعه‌ای از فایل‌های \fIogfile\fP که قطعات گراف منبع توزیع‌شدهٔ متناظر را نشان می‌دهند، می‌نویسد.
.PP
برنامهٔ \fBgscat\fP دقیقاً همان عملکرد \fBdgscat\fP را دارد، اما نیازی به اجرا در یک محیط موازی ندارد. از آنجا که \fBgscat\fP فایل گراف متمرکز ورودی را به عنوان یک جریان متنی پردازش می‌کند، پیش از ساخت فایل‌های قطعه‌گراف توزیع‌شده نیازی به بارگذاری کامل گراف در حافظه ندارد. بنابراین، منابع بسیار کمتری مصرف می‌کند، اما به دلیل نداشتن دید سراسری نسبت به ساختار گراف، امکان بررسی سازگاری گراف را فراهم نمی‌کند.
.PP
هنگامی که نام فایل‌ها مشخص نشده باشد، داده‌ها از ورودی استاندارد خوانده شده و در خروجی استاندارد نوشته می‌شوند. جریان‌های استاندارد را همچنین می‌توان به‌طور صریح با یک خط تیره «\-» مشخص کرد.
.PP
اگر کتابخانه‌های مناسب در زمان کامپایل گنجانده شده باشند، \fBdggath\fP و \fBdgscat\fP می‌توانند مستقیماً گراف‌های فشرده‌شده را هم به عنوان ورودی و هم به عنوان خروجی مدیریت کنند. هر جریانی که نام آن دارای پسوند یک فایل فشرده باشد، مانند \(lqbrol.grf.bz2\(rq یا \(lq-.gz\(rq، به صورت فشرده‌شده در نظر گرفته می‌شود. قالب‌های فشرده‌سازی قابل پشتیبانی عبارتند از: قالب bzip2 (پسوند \(lq.bz2\(rq)، قالب gzip (پسوند \(lq.gz\(rq) و قالب lzma (پسوند \(lq.lzma\(rq).
.PP
برنامه‌های \fBdggath\fP و \fBdgscat\fP برای توزیع کار میان عناصر پردازشی، بر پایهٔ پیاده‌سازی‌های رابط MPI عمل می‌کنند. بنابراین احتمالاً مستقیماً اجرا نمی‌شوند، بلکه از طریق یک دستور راه‌انداز مانند \fBmpirun\fP اجرا خواهند شد.
.SH "نام‌های فایل توزیع‌شده (DISTRIBUTED FILE NAMES)"
برای تعیین اینکه برنامه‌ها باید از/در یک فایل واحد قرارگرفته بر روی تنها یک پردازنده بخوانند یا بنویسند، یا چندین نمونه از همان فایل بر روی همهٔ پردازنده‌ها، و یا فایل‌های مجزا بر روی هر یک از پردازنده‌ها، یک دستور زبان ویژه طراحی شده است که بر پایهٔ نویسهٔ گریز «%» عمل می‌کند. چهار توالی گریز از این نوع تعریف شده‌اند که پیش از باز شدن فایل، بر روی هر پردازنده به‌طور مستقل تفسیر می‌شوند. به‌طور پیش‌فرض، هنگامی که یک نام فایل ارائه می‌شود، فرض بر این است که فایل باید تنها بر روی یکی از پردازنده‌ها باز شود که پردازندهٔ ریشه (root processor) نامیده می‌شود و معمولاً فرایند 0 از برقرارکننده ارتباط (communicator) است که برنامه درون آن اجرا می‌شود. شاخص پردازندهٔ ریشه را می‌توان با استفاده از گزینهٔ \fB\-r\fP تغییر داد. استفاده از هر یک از سه توالی گریز نخست در زیر، به برنامه‌ها دستور می‌دهد تا بر روی هر پردازنده‌ای که در آن اجرا می‌شوند، فایلی با نام برابر با نام فایل تفسیرشده را به‌صورت موازی باز کنند.
.TP
.B
%p
با تعداد فرایندهای موجود در برقرارکننده ارتباط سراسری که برنامه در آن اجرا می‌شود جایگزین می‌شود. منجر به باز شدن موازی می‌شود.
.TP
.B
%r
بر روی هر فرایندِ اجراکنندهٔ برنامه، با رتبهٔ (rank) این فرایند در برقرارکننده ارتباط سراسری جایگزین می‌شود. منجر به باز شدن موازی می‌شود.
.TP
.B
%-
نادیده گرفته می‌شود، اما منجر به باز شدن موازی می‌گردد. این توالی عمدتاً برای این به کار می‌رود که به برنامه‌ها دستور دهد تا بر روی هر پردازنده فایلی با نام یکسان باز کنند. فایل‌های بازشده بسته به اینکه مسیر ارائه‌شده به یک پوشهٔ اشتراکی ختم شود یا به پوشه‌هایی که برای هر پردازنده محلی هستند، به ترتیب می‌توانند منجر به باز شدن چندین نمونه از همان فایل یا باز شدن فایل‌های مجزایی که هر کدام ممکن است محتوای متفاوتی داشته باشند شوند (اما در حالت دوم، اکیداً توصیه می‌شود که فایل‌ها با استفاده از توالی «%r» تفکیک شوند).
.TP
.B
%%
با یک نویسهٔ منفرد «%» جایگزین می‌شود. نام فایل‌هایی که از این توالی گریز استفاده می‌کنند برای باز شدن موازی در نظر گرفته نمی‌شوند، مگر اینکه یک یا چند مورد از سه توالی گریز دیگر نیز حضور داشته باشند.
.RE
.PP
به عنوان مثال، نام فایل \(lqbrol\(rq منجر به باز شدن فایل \(lqbrol\(rq تنها بر روی پردازندهٔ ریشه خواهد شد؛ نام فایل \(lq%\fB-brol\fP\(rq (یا حتی \(lqbr%\fB-ol\fP\(rq) منجر به باز شدن موازی فایل‌هایی به نام \(lqbrol\(rq بر روی هر پردازنده خواهد شد؛ و نام فایل \(lqbrol%p-%r\(rq به ترتیب منجر به باز شدن فایل‌های \(lqbrol2-0\(rq و \(lqbrol2-1\(rq بر روی هر یک از دو پردازنده‌ای که برنامه قرار است روی آن‌ها اجرا شود، خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B
\fB\-c\fP
تنها برای \fBdggath\fP و \fBdgscat\fP. بررسی سازگاری گراف منبع ورودی پس از بارگذاری آن در حافظه.
.TP
.B
\fB\-h\fP
نمایش راهنما.
.TP
.B
\fB\-i\fP nbr
تنها برای \fBgscat\fP. ایجاد یک گراف توزیع‌شدهٔ نامتوازن، که در آن فایل‌های گراف توزیع‌شده برای همهٔ فرایندها به تعداد \textit{nbr} رأس از گراف را دریافت می‌کنند، به جز فایل مربوط به آخرین فرایند که تمامی رأس‌های باقی‌مانده را دریافت خواهد کرد.
.TP
.B
\fB\-r\fP \fIpnum\fP
تنظیم فرایند ریشه برای فایل‌های متمرکز (پیش‌فرض 0 است).
.TP
.B
\fB\-V\fP
نمایش نسخهٔ برنامه و حق نشر.
.SH "مثال‌ها (EXAMPLES)"
اجرای \fBdgscat\fP بر روی ۵ عنصر پردازشی برای پخش کردن فایل گراف متمرکز brol.grf در ۵ قطعه‌فایل فشرده‌شده با gzip از brol5-0.dgr.gz تا brol5-4.dgr.gz.
.PP
.nf
.fam C
    $ mpirun -np 5 dgscat brol.grf brol%p-%r.dgr.gz

.fam T
.fi
.SH "همچنین ببینید (SEE ALSO)"
\fBdgmap\fP(1), \fBdgord\fP(1), \fBdgtst\fP(1), \fBgmk_hy\fP(1).
.PP
راهنمای کاربری PT-Scotch.
.SH "نویسندگان (AUTHORS)"
Francois Pellegrini <francois.pellegrini@labri.fr>