.de TQ
.  br
.  ns
.  TP \\$1
..
.TH GVMAP 1 "3 March 2011"
.SH "نام (NAME)"
gvmap \- یافتن خوشه‌ها و ایجاد نقشه جغرافیایی با برجسته‌سازی خوشه‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.B gvmap
[
.I options
]
[
.BI \-o
.I outfile
]
[ 
.I files
]
.SH "توضیحات (DESCRIPTION)"
دستور
.B gvmap
یک گراف با قالب DOT را به عنوان ورودی دریافت کرده، خوشه‌های گره‌ها را پیدا می‌کند و نمایشی از گراف را در قالب xdot به شکل نقشه‌ای با سبک جغرافیایی تولید می‌نماید که در آن خوشه‌ها مانند کشورها برجسته شده‌اند.
.P
در گراف ورودی، هر گره باید دارای اطلاعات موقعیت، عرض و ارتفاع (به ترتیب ویژگی‌های pos، width و height) باشد و گره‌ها نباید با یکدیگر هم‌پوشانی داشته باشند.
.P
به‌طور پیش‌فرض،
.B gvmap
خوشه‌ها را بر اساس داده‌ها تولید خواهد کرد. در صورت تمایل، گراف ورودی می‌تواند با تعیین یک ویژگی \fIcluster\fP برای هر گره که مقدار آن یک عدد صحیح مثبت کوچک است، اطلاعات خوشه‌بندی را مشخص کند. (بهترین نتیجه زمانی حاصل می‌شود که تمام مقادیر \fIcluster\fP اعدادی صحیح در بازهٔ [1,K] به ازای یک K مشخص باشند. گره‌هایی که دارای مقدار یکسان ویژگی \fIcluster\fP هستند، در یک خوشه قرار خواهند گرفت. \fBN.B.\fP برای استفاده از ویژگی \fIcluster\fP، تمامی گره‌ها باید یک مقدار معتبر داشته باشند).
.P
اگر پرچم \fI\-D\fP استفاده شود،
.B gvmap
از زیرگراف‌های خوشه‌ای سطح بالا برای تعیین خوشه‌بندی استفاده خواهد کرد. هر گرهی که در چنین خوشه‌ای نباشد، در یک خوشهٔ جامع و فراگیر قرار داده خواهد شد.
.P
اگر ورودی خوشه‌بندی مورد نظر را به شکل توضیح داده شده در بالا مشخص کند، می‌تواند با داشتن ویژگی \fIclustercolor\fP در برخی از گره‌های هر خوشه، رنگ‌آمیزی مد نظر را نیز تعیین کند. \fBN.B.\fP مگر اینکه \fI\-c0\fP مشخص شده باشد، تنها مقدار \fIclustercolor\fP آخرین گره در یک خوشه اعمال خواهد شد. علاوه بر این، مگر اینکه از \fI\-O\fP استفاده شود، \fBgvmap\fP ممکن است جایگشت‌هایی در رنگ‌های داده‌شده اعمال کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP
.BI \-a " k"
عدد صحیح k میانگین تعداد نقاط مصنوعی اضافه‌شده در امتداد کادر مرزی برچسب‌ها را مشخص می‌کند. این نقاط مصنوعی برای جلوگیری از عبور مرز کشور از میان کادر مرزی برچسب‌ها اضافه می‌شوند. زمان محاسبات با k متناسب است؛ بنابراین، برای گراف‌های بزرگ، مقدار کوچکی برای k پیشنهاد می‌شود. اگر k = -1 باشد، یک مقدار مناسب بر اساس اندازه گراف به‌طور خودکار برای k انتخاب می‌شود. به‌طور پیش‌فرض k = -1 است.
.TP
.BI \-b " v"
عدد حقیقی v پهنای خط مورد استفاده برای رسم مرزهای چندضلعی را مشخص می‌کند، و مقدار v < 0 به معنای عدم رسم خط است. به‌طور پیش‌فرض v = 0 است.
.TP
.BI \-c " k"
عدد صحیح k طرح رنگ مورد استفاده برای رنگ‌آمیزی کشورها را مشخص می‌کند. به‌طور پیش‌فرض k = 1 است.
.TP
   مقادیر مجاز عبارتند از:
   0 : بدون چندضلعی
   1 : رنگ‌های پاستلی
   2 : آبی به زرد
   3 : سفید به قرمز
   4 : خاکستری روشن به قرمز
   5 : رنگ‌های اصلی
   6 : قرمز تک‌فام متوالی
   7 : قرمز روشن‌تر تک‌فام متوالی
   8 : خاکستری روشن
.TP
.BI \-c_opacity= xy
یک رشتهٔ هگزادسیمال دو نویسه‌ای را برای مشخص کردن میزان کدر بودن (opacity) چندضلعی‌ها معین می‌کند.
.TP
.BI \-C " d"
عدد صحیح d حداکثر تعداد خوشه‌ها (کشورها) مجاز را مشخص می‌کند. به‌طور پیش‌فرض d = 0 است که به معنای عدم وجود محدودیت است.
.TP
.BI \-d " d"
عدد صحیح d دانهٔ تصادفی مورد استفاده در زمان بهینه‌سازی تخصیص رنگ را مشخص می‌کند که تفاوت رنگ میان کشورهای همسایه را به حداکثر می‌رساند.
.TP
.BI \-D
در صورت تعیین، از زیرگراف‌های خوشه‌ای گراف برای تعیین خوشه‌بندی استفاده می‌شود.
.TP
.BI \-e
در صورت تعیین، یال‌ها در خروجی نهایی گنجانده خواهند شد.
.TP
.BI \-h " k"
تعداد نقاط مصنوعی اضافه‌شده برای حفظ پل میان نقاط پایانی. به‌طور پیش‌فرض، این مقدار صفر است.
.TP
.BI \-highlight= k
تنها خوشهٔ \fIk\fP را رسم می‌کند. به‌طور پیش‌فرض، تمام خوشه‌ها رسم می‌شوند.
.TP
.BI \-k 
در صورت تعیین، میزان تصادفی بودن مرز بیرونی را افزایش می‌دهد.
.TP
.BI \-m " v"
حاشیه‌ای به اندازهٔ \fIv\fP نقطه در اطراف طرح ایجاد می‌کند. به‌طور پیش‌فرض، این مقدار توسط \fBgvmap\fP تعیین می‌شود.
.TP
.BI \-O  
بهینه‌سازی تخصیص رنگ برای به حداکثر رساندن تفاوت رنگ بین کشورهای همسایه را انجام \fBنمی‌دهد\fR.
.TP
.BI \-o <file> 
خروجی را در <file> قرار می‌دهد. خروجی پیش‌فرض stdout است.
.TP
.BI \-Q
برای خوشه‌بندی از کیفیت پیمانه‌ای (modularity quality) به جای خوشه‌بندی پیمانه‌ای پیش‌فرض استفاده می‌کند.
.TP
.BI \-r " k"
تعداد نقاط تصادفی k (عدد صحیح) مورد استفاده برای تعیین مرزهای دریا و دریاچه. اگر 0 باشد، به‌طور خودکار تخصیص می‌یابد. به‌طور پیش‌فرض v = 0 است.
.TP
.BI \-s " v"
عدد حقیقی v عمق سواحل دریا و دریاچه را بر حسب نقطه مشخص می‌کند. اگر 0 باشد، به‌طور خودکار تخصیص می‌یابد. به‌طور پیش‌فرض v = 0 است.
.TP
.BI \-t " n"
تعداد \fIn\fP بار تلاش برای بهبود پیوستگی خوشه‌ها انجام می‌دهد.
.TP
.BI \-v 
حالت پرگو (نمایش گزارش‌های دقیق).
.TP
.BI \-z " c" 
رنگ خط چندضلعی را مشخص می‌کند. پیش‌فرض سیاه (black) است.
.TP
.BI \-? 
نمایش نحوه استفاده و خروج.
.SH "مثال‌ها (EXAMPLES)"
.PP
با در دست داشتن گراف foo.gv، یک روش برای ایجاد چیدمان و برجسته‌سازی خوشه‌ها این است که ابتدا یک موتور چیدمان با روش مناسب حذف هم‌پوشانی انتخاب شود، سپس خروجی به gvmap ارسال شده و در نهایت نقشه با یک قالب گرافیکی مشخص رندر گردد. برای مثال، خط‌لولهٔ زیر نقشه‌ای با یال‌های خاکستری روشن نیمه‌شفاف و گره‌های چیده‌شده با sfdp ایجاد می‌کند:
.PP
sfdp \-Goverlap=prism foo.gv | gvmap \-e | neato \-n2 \-Ecolor=#55555522 \-Tpng > foo.png
.PP
اسکریپت شل gvmap.sh دستوری کوتاه برای چنین خط‌لوله‌هایی فراهم می‌کند. برای مثال، خط‌لولهٔ فوق را می‌توان با دستور زیر اجرا کرد:
.PP
gvmap.sh \-Ae \-Ecolor=#55555522 \-Tpng foo.gv > foo.png


.SH "نویسندگان (AUTHORS)"
Yifan Hu <yifanhu@yahoo.com>
.SH "همچنین ببینید (SEE ALSO)"
.PP
gvmap.sh(1), sfdp(1), neato(1), gvpr(1)
.PP
E. R. Gansner, Y. Hu, S. G. Kobourov, "GMap: Visualizing graphs and clusters as maps," Proc. Pacific Vis. 2010, pp. 201\(hy208.