.TH planarity 1

.SH "نام (NAME)"
planarity \- بسته نرم‌افزاری مسطح‌بودن گراف مبتنی بر افزودن یال

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

.SS دریافت راهنما
.B planarity -h|-help [-menu]

.B planarity -i|-info

.SS حالت منومحور
.B planarity

.SS حالت‌های دسته‌ای

.B planarity -s [-q] \fICOMMAND\fR \fIINPUT\fR \fIOUTPUT\fR [\fICOMPLEMENT\fR]

.B planarity -r [-q] \fICOMMAND\fR \fIK\fR \fIN\fR [\fIOUTPUT\fR]

.B planarity -rm [-q] \fIN\fR \fIOUTPUT\fR [\fICOMPLEMENT\fR]

.B planarity -rn [-q] \fIN\fR \fIOUTPUT\fR [\fICOMPLEMENT\fR]

.B planarity -x [-q] \fB-(gam)\fR \fIINPUT\fR \fIOUTPUT\fR

.B planarity -t [-q] \fICOMMAND\fR \fIINPUT\fR \fIOUTPUT\fR

.SH "توضیحات (DESCRIPTION)"
ابزار خط فرمانی Edge Addition Planarity Suite را در حالت تعاملی یا حالت دسته‌ای (batch) فراخوانی می‌کند.

بدون هیچ پارامتری، این ابزار یک رابط کاربری تعاملیِ منومحور را نمایش می‌دهد.

هنگامی که پارامتری داده شود، در حالت دسته‌ای اجرا شده و برای نتیجه موفقیت‌آمیز 0 یا 1، و در صورت بروز خطا -1 بازمی‌گرداند.

.SH "گزینه‌ها (OPTIONS)"

.TP
.B -h, -help [-menu]
نمایش راهنما؛ گزینه \fB-menu\fR باعث نمایش خروجی با جزئیات بیشتر می‌شود.

.TP
.B -i, -info
نمایش اطلاعات نسخه، حق نشر (کپی‌رایت)، پروانه و مقالات مرجع.

.TP
.B -q
اصلاح‌کننده اختیاری برای حالت بی‌صدا؛ در زیر ببینید کدام گزینه‌ها آن را می‌پذیرند.

.TP
.B -s [-q] \fICOMMAND\fR \fIINPUT\fR \fIOUTPUT\fR [\fICOMPLEMENT\fR]
اجرای \fICOMMAND\fR (به زیر مراجعه کنید) روی یک گراف خاص ارائه‌شده در فایل \fIINPUT\fR، همراه با ذخیره خروجی در فایل اصلی \fIOUTPUT\fR و اطلاعات تکمیلی (در صورت وجود) در فایل فرعی \fICOMPLEMENT\fR (مانند ترسیم اسکی‌آرت برای دستور رسم گراف مسطح). اگر گراف مشخص‌شده تعبیه‌پذیر باشد (مثلاً مسطح باشد یا شامل زیرگراف همسان‌ریخت نباشد)، مقدار بازگشتی 0 است و اگر تعبیه‌پذیر نباشد (مثلاً غیرمسطح باشد یا زیرگراف همسان‌ریخت داشته باشد)، مقدار 1 بازگردانده می‌شود.

.TP
.B -r [-q] \fICOMMAND\fR \fIK\fR \fIN\fR [\fIOUTPUT\fR]
اجرای \fICOMMAND\fR (به زیر مراجعه کنید) روی \fIK\fR گراف تصادفی با \fIN\fR رأس. به طور اختیاری، تمام گراف‌های تولیدشده را در فایل .g6 با نام \fIOUTPUT\fR ذخیره می‌کند.

.TP
.B -rm [-q] \fIN\fR \fIOUTPUT\fR [\fICOMPLEMENT\fR]
تولید یک گراف مسطح بیشینه تصادفی با \fIN\fR رأس، سپس نوشتن تعبیه مسطح آن در فایل خروجی اصلی \fIOUTPUT\fR و به طور اختیاری نوشتن گراف تولیدشده در فایل \fICOMPLEMENT\fR.

.TP
.B -rn [-q] \fIN\fR \fIOUTPUT\fR [\fICOMPLEMENT\fR]
تولید یک گراف غیرمسطح تصادفی (مسطح بیشینه به همراه یک یال اضافه) با \fIN\fR رأس، سپس نوشتن یک زیرگراف کوراتوفسکی از گراف تولیدشده در فایل خروجی اصلی \fIOUTPUT\fR و به طور اختیاری نوشتن گراف تولیدشده در فایل \fICOMPLEMENT\fR.

.TP
.B [-q] \fB-(gam)\fR \fIINPUT\fR \fIOUTPUT\fR
تبدیل یک گراف منفرد موجود در فایل \fIINPUT\fR (هر قالب پشتیبانی‌شده) به قالب .g6 (\fBg\fR)، فهرست مجاورت (\fBa\fR)، یا ماتریس مجاورت (\fBm\fR) و ذخیره خروجی در فایل \fIOUTPUT\fR.

.TP
.B [-q] \fICOMMAND\fR \fIINPUT\fR \fIOUTPUT\fR
اجرای \fICOMMAND\fR (به زیر مراجعه کنید) روی گراف‌های موجود در فایل \fIINPUT\fR کدگذاری‌شده با .g6، و سپس نوشتن خلاصه آمارها در فایل \fIOUTPUT\fR.

.SH "دستورها (COMMANDS)"
مشخص می‌کند کدام پیاده‌سازی الگوریتم اجرا شود:
.TP
.B -p
تعبیه مسطح و جداسازی زیرگراف کوراتوفسکی
.TP
.B -d
ترسیم گراف مسطح بر پایه نمایش دیداری (و بازنمایی اختیاری اسکی‌آرت)
.TP
.B -o
تعبیه برون‌مسطح و جداسازی مانع
.TP
.B -2
جستجو برای زیرگراف همسان‌ریخت با K_{2,3}
.TP
.B -3
جستجو برای زیرگراف همسان‌ریخت با K_{3,3}
.TP
.B -4
جستجو برای زیرگراف همسان‌ریخت با K_4

.SH "مثال‌ها (EXAMPLES)"
.TP
.B planarity -s -q -p infile.txt embedding.out [obstruction.out]
پردازش infile.txt در حالت بی‌صدا (-q)، قرار دادن تعبیه مسطح در embedding.out یا (به طور اختیاری) یک زیرگراف کوراتوفسکی در obstruction.out.
پردازش مقادیر 0=مسطح، 1=غیرمسطح، -1=خطا را بازمی‌گرداند.
.TP
.B planarity -s -q -d infile.txt embedding.out [drawing.out]
اگر گراف موجود در infile.txt مسطح باشد، تعبیه را در embedding.out و (به طور اختیاری) یک رسم اسکی‌آرت را در drawing.out قرار می‌دهد.
پردازش مقادیر 0=مسطح، 1=غیرمسطح، -1=خطا را بازمی‌گرداند.

.SH "همچنین ببینید (SEE ALSO)"

راهنمای کامل درون‌برنامه‌ای: \fBplanarity -h -menu\fR

صفحه خانگی پروژه: \fBhttps://github.com/graph-algorithms/edge-addition-planarity-suite\fR