.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "KATIE" "1" "25 August 2025" "" "The Regina Handbook"

.SH "نام (NAME)"
katie \- مثلث‌بندی یک ۳\-خمینه یا ۴\-خمینه از روی یک پیوند آراسته
.SH "خلاصه دستور (SYNOPSIS)"

\fBkatie\fR \fB\fIpd_code\fB\fR \fB\fIframing_vector\fB\fR [ \fB-3, --dim3\fR | \fB-4, --dim4\fR ] [ \fB-g, --graph\fR ] [ \fB-V, --verbose\fR ]


\fBkatie\fR { \fB-v, --version\fR | \fB-?, --help\fR }

.SH "توضیحات (DESCRIPTION)"
.PP
این ابزار یک مثلث‌بندی یا گراف رنگی از یک ۳\-خمینه یا ۴\-خمینه را بر اساس یک پیوند آراسته می‌سازد.
.PP
برای ۳\-خمینه‌ها، خمینهٔ ساخته‌شده همان خمینه‌ای است که از اعمال جراحی دِهن (Dehn surgery) صحیح بر روی پیوند داده‌شده به دست می‌آید.
.PP
برای ۴\-خمینه‌ها، خمینهٔ ساخته‌شده با الحاق دسته‌های ۱ و ۲ چهاربُعدی به گوی ۴\-بُعدی در امتداد مؤلفه‌های نقطه‌چین و قاب‌بندی‌شدهٔ پیوند (به ترتیب) به دست می‌آید.
.PP
دستور \fBKatie\fR در زمان اجرا دو آرگومان را انتظار دارد: پیوند پایه‌ای (بدون تزیین)، و فهرستی از نشانه‌ها که با فاصله از هم جدا شده‌اند (ضرایب قاب‌بندی و/یا «نشانگرهای» دستهٔ ۱).
.TP 0.2i
\(bu
پیوند باید در قالب کد دیاگرام مسطح (PD) ارائه شود، به‌ویژه در همان قالبی که توسط \fBSnapPy\fR به کار می‌رود. ساده‌ترین راه برای انجام این کار، رسم پیوند در ویرایشگر \fBPLink\fR برنامهٔ \fBSnapPy\fR و کپی کردن کد PD تولیدشده توسط \fBSnapPy\fR از طریق گزینهٔ منوی InfoPD\~Code در ویرایشگر است.
.TP 0.2i
\(bu
در دنبالهٔ قاب‌بندی، برای نشان دادن دسته‌های ۱ از \&'x' یا \&'.' استفاده کنید.
.sp
.RS
.B "هشدار:"
کد PD و دنبالهٔ قاب‌بندی باید به عنوان دو آرگومان نخست ظاهر شوند. اگر \fBKatie\fR را از درون یک شل اجرا می‌کنید، باید هر دوی این آرگومان‌ها را درون علامت‌های نقل‌قول قرار دهید.
.RE
.PP
برای اطلاعات بیشتر، راهنمای کامل \fBKatie\fR را که در نشانی
<https://raburke.github.io>\&
در دسترس است ببینید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-3, --dim3\fR
ساخت ۳\-خمینهٔ به‌دست‌آمده از جراحی دِهن صحیح روی پیوند ورودی.

اگر هیچ‌یک از گزینه‌های \fB--dim3\fR یا \fB--dim4\fR را ارسال نکنید، حالت پیش‌فرض ساخت یک ۴\-خمینه است.
.TP
\fB-4, --dim4\fR
ساخت ۴\-خمینهٔ به‌دست‌آمده از الحاق دسته‌های ۱ و ۲ در راستای مؤلفه‌های پیوند آراسته به گوی ۴\-بُعدی.

این گزینه در صورتی که هیچ‌یک از گزینه‌های \fB--dim3\fR یا \fB--dim4\fR را مشخص نکنید، پیش‌فرض است.
.TP
\fB-g, --graph\fR
خروجی دادن فهرست یال‌های گراف یال‌رنگی مرتبط با خمینه. هر گره گراف در مورد ۳\-خمینه‌ها متناظر با یک چهاروجهی (tetrahedron) و در مورد ۴\-خمینه‌ها متناظر با یک پنج‌خانه (pentachoron) است. دو گره توسط یک یال به رنگ \fIc\fR به هم متصل می‌شوند اگر دو سیمپلکس با بالاترین بعد متناظر در مثلث‌بندی، وجوه روبه‌رو به رأس دارای برچسب \fIc\fR را یکسان‌سازی کرده باشند.
.TP
\fB-V, --verbose\fR
نمایش اطلاعات در حین فرایند ساخت.
.TP
\fB-v, --version\fR
نمایش نسخهٔ استفاده‌شده از Regina و خروج فوری.
.TP
\fB-?, --help\fR
نمایش اطلاعات کوتاه دربارهٔ نحوهٔ استفاده و خروج فوری.
.SH "مثال‌ها (EXAMPLES)"
.PP
دستور زیر ۳\-کرهٔ همولوژی پوانکاره را که از جراحی ۱+ در امتداد گره سه‌پرهٔ راست‌گرد به‌دست می‌آید، می‌سازد.

.nf
    example$ \fBkatie "[(6,4,1,3),(4,2,5,1),(2,6,3,5)]" "1" -3\fR
    Writhes:
    Component 0: 2-handle, writhe 1
    
    Here is the isomorphism signature:
    GLvvQvPvALvzMAQAvAQQQPccgfekjp...
    example$
.fi
.PP
دستور زیر صفحهٔ تصویری مختلط را با الصاق یک تک‌دستهٔ ۲ به گوی ۴\-بُعدی در امتداد یک ناگره با قاب‌بندی ۱+ می‌سازد.

.nf
    example$ \fBkatie "[(1,1,2,2)]" "1"\fR
    Writhes:
    Component 0: 2-handle, writhe 1
    
    Here is the isomorphism signature:
    mLvAwAQAPQQcfffhijgjgjkkklklll...
    example$
.fi
.PP
دستور زیر یک ۴\-خمینه را می‌سازد که شامل هر دو دستهٔ ۱ و ۲ است.

.nf
    example$ \fBkatie "[(4,8,1,9),(9,3,10,4),(1,5,2,6),(6,2,7,3),(7,5,8,10)]" "x 0"\fR
    Writhes:
    Component 0: 1-handle (0)
    Component 1: 2-handle, writhe 0
    
    Here is the isomorphism signature:
    SLvAvAAwvvALMQQPvPvPMQwQAQMAvQ...
    example$
.fi
.SH "کاربران مک‌اواس (MACOS USERS)"
.PP
اگر یک بستهٔ برنامه‌ای کشیدن و رها کردن (drag-and-drop app bundle) دانلود کرده‌اید، این ابزار درون آن قرار دارد. اگر Regina را به پوشهٔ اصلی Applications منتقل کرده‌اید، می‌توانید آن را به صورت
/Applications/Regina.app/Contents/MacOS/katie\&
اجرا کنید.
.SH "کاربران ویندوز (WINDOWS USERS)"
.PP
ابزارهای خط فرمانی در زیر دایرکتوری
\fIProgram\~Files\fR
نصب می‌شوند؛ در برخی رایانه‌ها این دایرکتوری
\fIProgram\~Files\~(x86)\fR\&
نامیده می‌شود. می‌توانید این ابزار را با اجرای
c:\\Program\~Files\\Regina\\Regina\~7.4.1\\bin\\katie.exe\&
آغاز کنید.
.SH "نویسندگان (AUTHORS)"
.PP
این ابزار توسط Rhuaidi Burke
<rhuaidi.burke@uq.edu.au>\&
نوشته شده است. افراد بسیاری در توسعهٔ Regina مشارکت داشته‌اند؛ برای مشاهدهٔ فهرست کامل دست‌اندرکاران، به راهنمای کاربران مراجعه کنید.