نام (NAME)

gvmap.sh - خط لوله‌ای برای اجرای gvmap

خلاصه دستور (SYNOPSIS)

gvmap.sh [-vV?] [ options ] [ -o outfile ] [ files ]

توضیحات (DESCRIPTION)

دستور gvmap.sh یک گراف با قالب DOT را به عنوان ورودی دریافت می‌کند، چیدمان (layout) آن را انجام می‌دهد، خروجی را از طریق gvmap پردازش می‌کند و خروجی نهایی را رندر می‌نماید. امید است در آینده تمامی این وظایف در خود gvmap ادغام شوند.

گزینه‌ها (OPTIONS)

از گزینه‌های زیر پشتیبانی می‌شود:

-a k: عدد صحیح k میانگین تعداد نقاط مصنوعی اضافه‌شده در امتداد کادر مرزی (bounding box) برچسب‌ها را مشخص می‌کند. چنین نقاط مصنوعی برای جلوگیری از عبور مرز کشورها از میان کادر مرزی برچسب‌ها افزوده می‌شوند. زمان محاسبات متناسب با k است؛ بنابراین، برای گراف‌های بزرگ، مقدار کوچکی برای k پیشنهاد می‌شود. اگر k = -1 باشد، مقدار مناسبی برای k به‌طور خودکار بر اساس اندازه گراف انتخاب می‌شود. مقدار پیش‌فرض k = -1 است.
-K layout: مشخص می‌کند که کدام برنامه باید برای چیدمان اولیه استفاده شود. به‌طور پیش‌فرض، sfdp اجرا می‌شود. همچنین به‌طور پیش‌فرض، پرچم -Goverlap=prism به برنامه چیدمان فرستاده می‌شود. این رفتار را می‌توان با استفاده از پرچم -g لغو و بازنویسی کرد.
-T format: قالب خروجی نهایی را مشخص می‌کند. عملکرد این گزینه مشابه پرچم -T در تمامی برنامه‌های چیدمان Graphviz است.
-N attr=val: تنظیم یک صفت پیش‌فرض گره (node attribute) را در طول مرحله رندر مشخص می‌کند. عملکرد این گزینه مشابه پرچم -N در تمامی برنامه‌های چیدمان Graphviz است.
-G attr=val: تنظیم یک صفت گراف (graph attribute) را در طول مرحله رندر مشخص می‌کند. عملکرد این گزینه مشابه پرچم -G در تمامی برنامه‌های چیدمان Graphviz است.
-E attr=val: تنظیم یک صفت پیش‌فرض یال (edge attribute) را در طول مرحله رندر مشخص می‌کند. عملکرد این گزینه مشابه پرچم -E در تمامی برنامه‌های چیدمان Graphviz است.
-n attr=val: تنظیم یک صفت پیش‌فرض گره را در طول مرحله چیدمان مشخص می‌کند. عملکرد این گزینه مشابه پرچم -N در تمامی برنامه‌های چیدمان Graphviz است.
-g attr=val: تنظیم یک صفت گراف را در طول مرحله چیدمان مشخص می‌کند. عملکرد این گزینه مشابه پرچم -G در تمامی برنامه‌های چیدمان Graphviz است.
-e attr=val: تنظیم یک صفت پیش‌فرض یال را در طول مرحله چیدمان مشخص می‌کند. عملکرد این گزینه مشابه پرچم -E در تمامی برنامه‌های چیدمان Graphviz است.
-A flag: پرچمی را برای ارسال به gvmap مشخص می‌کند. برای مثال، دستور gvmap.sh -Ae -As3 باعث اجرای gvmap -e -s3 می‌شود.
-v: فعال کردن حالت پرگو (verbose).
-V: چاپ اطلاعات نسخه و خروج.
-?: چاپ راهنمای نحوه استفاده و خروج.

مثال‌ها (EXAMPLES)

اجرای دستور زیر نقشه‌ای با یال‌هایی به رنگ خاکستری روشنِ نیمه‌شفاف و گره‌هایی چیده‌شده با sfdp ایجاد می‌کند:

gvmap.sh -Ae -Ecolor=#55555522 -Tpng foo.gv > foo.png

این دستور معادل اجرای خط لوله زیر است:

sfdp -Goverlap=prism foo.gv | gvmap -e | neato -n2 -Ecolor=#55555522 -Tpng > foo.png

نویسندگان (AUTHORS)

Emden R. Gansner <erg@research.att.com>

همچنین ببینید (SEE ALSO)

gvmap(1), sfdp(1), neato(1), gvpr(1)

E. R. Gansner, Y. Hu, S. G. Kobourov, "GMap: Visualizing graphs and clusters as maps," Proc. Pacific Vis. 2010, pp. 201‐208.