.TH GVPACK 1 "27 May 2010"
.SH "نام (NAME)"
gvpack \- ادغام و بسته‌بندی گراف‌های مجزا
.SH "خلاصه دستور (SYNOPSIS)"
.B gvpack
[
.B \-nguv?
]
[
.BI \-m margin
]
[
.B \-array\fIopts\fP
]
[
.BI \-o outfile
]
[
.BI \-s graph_name
]
[
.BI \-G name\fB=\fPvalue
]
[ 
.I files
]
.SH "توضیحات (DESCRIPTION)"
.B gvpack
جریانی از گراف‌ها را می‌خواند، آن‌ها را در یک چیدمان واحد ترکیب می‌کند، و یک گراف واحد تولید می‌نماید که به عنوان اجتماع گراف‌های ورودی عمل می‌کند. گراف‌های ورودی باید در قالب dot بوده و تمام اطلاعات لازم چیدمان را دارا باشند. ورودی قابل قبول با اعمال یک برنامه چیدمان Graphviz، مانند \fBdot\fP یا \fBneato\fP، بدون پرچم \fB\-T\fP تولید می‌شود.
.P
به‌طور پیش‌فرض، بسته‌بندی در سطح خوشه (cluster) انجام می‌شود. بنابراین، بخش‌های یک گراف وارد هیچ‌یک از خوشه‌های سطح بالا نمی‌شوند و با هیچ گره یا یال از گراف دیگر هم‌پوشانی نخواهند داشت.
.P
خروجی \fBgvpack\fP را می‌توان با اعمال \fBneato \-s \-n2\fP همراه با پرچم \fB\-T\fP مورد نظر برای تولید خروجی ملموس به کار برد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP
.B \-g
گراف‌ها را در سطح گراف ترکیب می‌کند. این حالت فضای بیشتری مصرف می‌کند، اما از قرار گرفتن بخش‌هایی از یک گراف در میان بخش‌های گراف دیگر جلوگیری می‌نماید.
.TP
.BI \-array\fI[_flags][n]\fP
گراف‌ها را در سطح گراف ترکیب کرده و آن‌ها را در یک آرایه قرار می‌دهد.
به‌طور پیش‌فرض، چیدمان به ترتیب سطر-محور (row-major) انجام می‌شود. تعداد ستون‌های مورد استفاده تقریباً برابر با ریشه دوم (جذر) تعداد گراف‌ها است. اگر عدد صحیح اختیاری \fIn\fP ارائه شود، این مقدار تعداد ستون‌های مورد استفاده را تعیین می‌کند.
.TP 

اگر پرچم‌های اختیاری ارائه شوند، شامل یک خط زیر (underscore) به همراه هر یک از حروف "c"، "t"، "b"، "l"، "r"، "u" یا "i" خواهند بود.
اگر "c" مشخص شود، گراف‌ها به ترتیب ستون-محور (column-major) بسته‌بندی می‌شوند که در این صورت عدد صحیح پایانی تعداد سطرها را تعیین می‌کند.
پرچم‌های "t"، "b"، "l"، "r" نشان می‌دهند که مؤلفه‌ها به ترتیب در امتداد بالا، پایین، چپ یا راست تراز می‌شوند.
به‌طور پیش‌فرض، ترتیب درج با مرتب‌سازی گراف‌ها بر اساس اندازه، از بزرگ‌ترین به کوچک‌ترین تعیین می‌شود. اگر پرچم "u" تنظیم شده باشد، گراف‌ها بر اساس صفت عدد صحیح نامنفی \fIsortv\fP متصل به هر گراف مرتب می‌شوند.
پرچم "i" نشان می‌دهد که هیچ مرتب‌سازی انجام نمی‌شود و گراف‌ها به همان ترتیب ورودی درج می‌گردند.
.TP
.BI \-G "name\fB=\fPvalue"
ویژگی‌هایی را برای افزوده شدن به گراف اجتماع حاصل تعیین می‌کند. برای مثال، از این گزینه می‌توان برای تعیین یک برچسب گراف استفاده کرد.
.TP
.BI \-m "margin"
گراف‌ها را با در نظر گرفتن حاشیه‌ای به اندازه \fImargin\fP نقطه در اطراف بخش‌ها بسته‌بندی می‌کند.
.TP
.B \-n
گراف‌ها را در سطح گره (node) ترکیب می‌کند. خوشه‌ها در بسته‌بندی نادیده گرفته می‌شوند.
.TP
.BI \-o "output"
خروجی را در فایل \fIoutput\fP چاپ می‌کند. در صورت عدم تعیین، \fBgvpack\fP از خروجی استاندارد (stdout) استفاده می‌کند.
.TP
.BI \-s "graph_name"
استفاده از \fIgraph_name\fP به عنوان نام گراف ریشه. به‌طور پیش‌فرض، از "root" استفاده می‌شود.
.TP
.B \-u
گراف‌ها را بسته‌بندی نکن. فقط آن‌ها را در یک گراف واحد ادغام کن.
.TP
.B \-v
حالت پرگو (verbose).
.TP
.B \-?
چاپ اطلاعات راهنمای استفاده و خروج.
.SH "عملوندها (OPERANDS)"
عملوند زیر پشتیبانی می‌شود:
.TP 8
.I files
نام فایل‌های حاوی ۱ یا چند گراف در قالب dot. اگر هیچ عملوند
.I files
مشخص نشود، از ورودی استاندارد استفاده خواهد شد.
.SH "کدهای بازگشتی (RETURN CODES)"
.B gvpack
در صورت عدم وجود مشکل مقدار
.B 0
و در غیر این صورت مقداری غیر\(hyصفر برمی‌گرداند.
.SH "مثال‌ها (EXAMPLES)"
.EX
ccomps \-x abc.gv | dot | gvpack | neato \-s \-n2 \-Tps
.EE
این خط لوله، گراف موجود در \fIabc.gv\fP را به مؤلفه‌های متصل آن تجزیه کرده، هر یک را با استفاده از \fBdot\fP چیدمان نموده، همه آن‌ها را دوباره در کنار هم بسته‌بندی می‌کند و ترسیم نهایی را در قالب PostScript تولید می‌نماید. البته هیچ مانعی برای استفاده از چیدمان‌های متفاوت برای هر مؤلفه وجود ندارد.
.SH "اشکالات (BUGS)"
تمام گراف‌های ورودی باید همگی جهت‌دار یا همگی بدون جهت باشند.
.P
یک گراف ورودی نباید برچسب داشته باشد، زیرا این برچسب در چیدمان آن استفاده خواهد شد. از آنجا که \fBgvpack\fP برچسب‌های گراف ریشه را نادیده می‌گیرد، چیدمان حاصل ممکن است حاوی مقداری فضای خالی اضافی باشد.
.P
دستور \fBgvpack\fP ویژگی کادر محدودکننده (bounding box) همه زیرگراف‌های غیر\(hyخوشه‌ای را لغو می‌کند.
.SH "نویسندگان (AUTHORS)"
Emden R. Gansner <erg@research.att.com>
.SH "همچنین ببینید (SEE ALSO)"
gvpr(1), dot(1), neato(1), twopi(1), ccomps(1), libpack(3)