.EQ
delim $$
.EN
.TH MM2GV 1 "31 July 2008"
.SH "نام (NAME)"
mm2gv \- مبدل ماتریس‌های Matrix Market به قالب DOT
.SH "خلاصه دستور (SYNOPSIS)"
.B mm2gv
[
.B \-cluv?
]
[
.BI \-U i
]
[
.BI \-o outfile
]
[ 
.I file
]
.br
.SH "توضیحات (DESCRIPTION)"
.B mm2gv
یک ماتریس خلوت (sparse) در قالب Matrix Market را به یک گراف در قالب GV (DOT سابق) تبدیل می‌کند.
اگر ماتریس \fIM\fP مربعی نباشد، گراف دو‌بخشی (bipartite) در نظر گرفته می‌شود و به ماتریس به عنوان ماتریس مجاورت یک گراف دو‌بخشی نگریسته می‌شود، که در آن سطرها و ستون‌های ماتریس، دو مجموعه از رأس‌ها را مشخص می‌کنند. به طور معادل، ماتریس به یک ماتریس مربعی متقارن تبدیل می‌شود:
.TS
c c.
0	\fIM\fP
$\fIM\fP sup \fIT\fP$	0
.TE
یک ماتریس بلوکی با بلوک‌های مربعی صفر در بالا-چپ و پایین-راست، که بلوک بالا-راست \fIM\fP و بلوک پایین-چپ ترانهاده \fIM\fP است.
این ماتریس سپس به عنوان ماتریس مجاورت گراف در نظر گرفته می‌شود.
.P
برای یک ماتریس مربعی، \fBmm2gv\fP اگر الگوی درایه‌های غیرصفر آن متقارن باشد، مستقیماً از آن به عنوان ماتریس مجاورت استفاده می‌کند؛ در غیر این صورت، همانند ماتریس‌های غیرمربعی، با آن مانند یک گراف دو‌بخشی رفتار خواهد کرد. این رفتار را می‌توان با فلگ \fB\-U\fP تغییر داد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP
.B \-c
این فلگ باعث می‌شود \fBmm2gv\fP به یال‌ها رنگ اختصاص دهد. عنصر ماتریس بسته به اینکه در کجای بازه بین مقادیر کمینه و بیشینه ماتریس قرار دارد، به بازه [0,1] مقیاس‌بندی می‌شود. این مقدار مقیاس‌بندی‌شده به عنوان مشخصه \fI"wt"\fP یال متناظر استفاده می‌شود.
علاوه بر این، این مقدار اسکالر به یک مقدار RGB نگاشت می‌شود که به عنوان مشخصه \fI"color"\fP یال ذخیره می‌گردد.
.TP
.B \-l
در صورت تعیین، \fBmm2gv\fP برچسبی حاوی نام پایه فایل ورودی و تعداد گره‌ها و یال‌ها را به گراف پیوست می‌کند.
.TP
.B \-u
در صورت مشخص شدن، گراف بدون‌جهت در نظر گرفته می‌شود. به‌طور پیش‌فرض، گراف تولیدشده جهت‌دار است.
.TP
.B \-v
این فلگ باعث می‌شود \fBmm2gv\fP مقادیر ماتریس را به عنوان مشخصه \fI"len"\fP یال متناظر ذخیره کند.
.TP
.BI \-U "bflag"
نحوه مدیریت ماتریس‌های مربعی را مشخص می‌کند. اگر \fIbflag\fP برابر با 0 باشد، با ماتریس مربعی همواره مانند یک ماتریس مجاورت رفتار خواهد شد.
اگر \fIbflag\fP برابر با 1 باشد (پیش‌فرض)، از ماتریس مربعی با الگوی متقارن درایه‌های غیرصفر به عنوان ماتریس مجاورت استفاده می‌شود؛ در غیر این صورت، به عنوان یک گراف دو‌بخشی استفاده خواهد شد.
اگر \fIbflag\fP برابر با 2 باشد، از ماتریس متقارن به عنوان ماتریس مجاورت استفاده می‌شود؛ در غیر این صورت، به عنوان یک گراف دو‌بخشی استفاده خواهد شد.
اگر \fIbflag\fP برابر با 3 باشد، با هر ماتریس ورودی مانند یک گراف دو‌بخشی رفتار خواهد شد.
.TP
.BI \-o "outfile"
خروجی را در فایل \fIoutfile\fP چاپ می‌کند. در صورت عدم تعیین، \fBmm2gv\fP از خروجی استاندارد (stdout) استفاده می‌کند.
.SH "عملوندها (OPERANDS)"
عملوند زیر پشتیبانی می‌شود:
.TP 8
.I file
نام فایل در قالب MatrixMarket.
اگر عملوند
.I file
مشخص نشود،
از ورودی استاندارد استفاده خواهد شد.
.SH "کدهای بازگشتی (RETURN CODES)"
در صورت تبدیل بدون مشکل مقدار
.B 0
و در صورت بروز هرگونه خطا، مقداری غیر از صفر بازگردانده می‌شود.
.SH "نویسندگان (AUTHORS)"
Yifan Hu <yifanhu@yahoo.com>
.br
Emden R. Gansner <erg@graphviz.com>
.SH "اطلاعات تکمیلی (ADDITIONAL INFO)"
برای مشاهده توضیحات قالب به <http://math.nist.gov/MatrixMarket> و برای مجموعه بزرگی از ماتریس‌های خلوت در این قالب به <http://www.cise.ufl.edu/research/sparse/matrices> مراجعه کنید.