.\" Text automatically generated by txt2man
.TH gcv 1 "16 June 2026" "" "Scotch user's manual"
.SH "نام (NAME)"
gcv \- مبدل فایل گراف
.SH "خلاصه دستور (SYNOPSIS)"
.nf
.fam C
\fBgcv\fP [\fIoptions\fP] [\fIigfile\fP] [\fIogfile\fP] [\fIoxfile\fP]

.fam T
.fi
.fam T
.fi
.SH "توضیحات (DESCRIPTION)"
برنامه \fBgcv\fP فایل‌های گراف Scotch را به و از سایر قالب‌های خارجی تبدیل می‌کند.
.PP
فایل ورودی \fIigfile\fP به فایل گراف خروجی \fIogfile\fP تبدیل می‌شود و در صورت موجود بودن داده‌های هندسی، این داده‌های اختیاری درون فایل هندسه \fIoxfile\fP ذخیره می‌شوند.
.PP
هنگامی که نام فایل‌ها مشخص نشده باشد، داده‌ها از ورودی استاندارد خوانده شده و در خروجی استاندارد نوشته می‌شوند. جریان‌های استاندارد را می‌توان به‌طور صریح با یک خط تیره «-» نیز مشخص کرد.
.PP
در صورتی که کتابخانه‌های مناسب در زمان کامپایل گنجانده شده باشند، \fBgcv\fP می‌تواند مستقیماً گراف‌های فشرده‌شده را چه در ورودی و چه در خروجی پردازش کند. هرگاه پسوند یک فایل فشرده به انتهای نام جریان اضافه شده باشد (مانند 'brol.grf.bz2' یا '-.gz')، آن جریان به عنوان یک فایل فشرده در نظر گرفته می‌شود. قالب‌های فشرده‌سازی پشتیبانی‌شده عبارتند از bzip2 (با پسوند '.bz2')، gzip (با پسوند '.gz') و lzma (با پسوند '.lzma').
.SH "گزینه‌ها (OPTIONS)"
.TP
.B
\fB-h\fP
نمایش راهنما.
.TP
.B
\fB-i\fP \fIifmt\fP
تنظیم قالب فایل گراف ورودی، که می‌تواند یکی از موارد زیر باشد:
.RS
.TP
.B
b \fInum\fP
قالب Boeing-Harwell. این یک قالب ماتریسی است و تنها از ماتریس‌های مربعی پشتیبانی می‌کند. ماتریس‌های مربعی با الگوی نامتقارن، متقارن‌سازی می‌شوند. در صورتی که فایل شامل چندین ماتریس باشد، پارامتر \fInum\fP به کاربر امکان می‌دهد شاخص ماتریس مورد نظر برای تبدیل را (با شروع از 0) مشخص کند. در صورت عدم تعیین پارامتر \fInum\fP، مقدار آن پیش‌فرض 0 در نظر گرفته می‌شود.
.TP
.B
c
قالب Chaco. این یک قالب گراف مجاورت است که توسط MeTiS نیز استفاده می‌شود.
.TP
.B
m
قالب Matrix Market. این یک قالب ماتریسی است که یال‌های مجزا را توصیف می‌کند. الگوی ماتریس متقارن‌سازی می‌شود، به‌طوری که ماتریس‌های مستطیلی در نهایت مربعی خواهند شد.
.TP
.B
s
قالب گراف Scotch. این یک قالب گراف مجاورت است.
.RE
.TP
.B
\fB-o\fP \fIofmt\fP
تنظیم قالب فایل گراف خروجی، که می‌تواند یکی از موارد زیر باشد:
.RS
.TP
.B
c
قالب Chaco.
.TP
.B
m
قالب الگوی متقارن Matrix Market.
.TP
.B
s
قالب Scotch. این مقدار پیش‌فرض است.
.RE
.TP
.B
\fB-V\fP
نمایش نسخه برنامه و حق نشر.
.SH "مثال‌ها (EXAMPLES)"
تبدیل یک گراف Matrix Market به یک گراف Scotch. فایل‌های Matrix Market شامل داده‌های هندسی نیستند، بنابراین در خروجی نیازی به فایل هندسه نخواهد بود:
.PP
.nf
.fam C
    $ gcv -im brol.mm brol.grf

.fam T
.fi
.SH "همچنین ببینید (SEE ALSO)"
\fBgbase\fP(1), \fBgtst\fP(1), \fBgmap\fP(1), \fBgord\fP(1), \fBgout\fP(1).
.PP
راهنمای کاربری Scotch.
.SH "نویسندگان (AUTHORS)"
Francois Pellegrini <francois.pellegrini@labri.fr>