.\" 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 "CENSUSLOOKUP" "1" "25 August 2025" "" "The Regina Handbook"

.SH "نام (NAME)"
censuslookup \- جستجوی مثلث‌بندی‌ها در پایگاه‌های داده سرشماری Regina
.SH "خلاصه دستور (SYNOPSIS)"

\fBcensuslookup\fR \fB\fIisosig\fB\fR\fI ...\fR


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

.SH "توضیحات (DESCRIPTION)"
.PP
این ابزار مثلث‌بندی‌های ۳-خمینه مشخص‌شده را در پایگاه‌های داده سرشماری مختلفی که همراه با Regina عرضه می‌شوند، جستجو می‌کند.
.PP
شما باید مثلث‌بندی‌ها را با استفاده از \fIامضاهای یک‌ریختی\fR (\fIisomorphism signatures\fR) آن‌ها مشخص کنید. این امضاها رشته‌های متنی کوتاهی هستند که مثلث‌بندی را تا حد یک‌ریختی ترکیبیاتی (یعنی تا حد برچسب‌گذاری دوباره چهاروجهی‌ها و/یا رأس‌های آن‌ها) به‌طور یکتا تعیین می‌کنند.
.PP
در رابط کاربری گرافیکی، می‌توانید با رفتن به برگه Composition در بخش نمایشگر مثلث‌بندی، امضای یک‌ریختی یک مثلث‌بندی را مشاهده کنید. در Python می‌توانید با فراخوانی \fBx.isoSig()\fR، امضای یک‌ریختی مثلث‌بندی \fBx\fR را دریافت نمایید. برای مشخصات کامل و دقیق امضاهای یک‌ریختی، به \fBSimplification paths in the Pachner graphs of closed orientable 3-manifold triangulations\fR، تألیف Burton، سال ۲۰۱۱، arXiv:1110.6080 مراجعه کنید.
.PP
تمام موارد منطبق در پایگاه داده (در صورت وجود) در خروجی استاندارد نوشته خواهند شد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-v, --version\fR
نسخه مورد استفاده Regina را نمایش داده و بلافاصله خارج می‌شود.
.TP
\fB-?, --help\fR
اطلاعات مختصری درباره نحوه استفاده را نمایش داده و بلافاصله خارج می‌شود.
.SH "محیط (ENVIRONMENT)"
.PP
متغیرهای محیطی زیر بر رفتار این برنامه تأثیر می‌گذارند:
.TP
\fB\fIREGINA_HOME\fB\fR
دایرکتوری که فایل‌های داده Regina در زیر آن نصب شده‌اند. این ابزار پایگاه‌های داده سرشماری را در زیردایرکتوری \fI$REGINA_HOME/data/census/\fR جستجو خواهد کرد.

معمولاً نیازی نیست این متغیر را خودتان تنظیم کنید. این ابزار در شرایط استاندارد نحوه پیدا کردن پایگاه‌های داده سرشماری خود را می‌داند؛ این شرایط شامل نصب‌های دارای ساختار فایل ثابت (مانند \fBGNU/Linux\fR و \fBWindows\fR)، بسته‌های برنامه‌ای قابل‌جابه‌جایی (مانند \fBmacOS\fR)، و اجرای مستقیم از درخت منبع است.
.SH "مثال‌ها (EXAMPLES)"

.nf
    example$ \fBcensuslookup fvPQcdecedekrsnrs dLQbcccajqs cPcbbbiht\fR
    fvPQcdecedekrsnrs: 1 hit
        SFS [S2: (2,1) (3,1) (5,-4)] : #1 -- Closed census (orientable)

    dLQbcccajqs: 0 hits

    cPcbbbiht: 2 hits
        m004 : #1 -- Cusped hyperbolic census (orientable)
        L104001 -- Hyperbolic knot and link complements

    example$
.fi
.SH "کاربران MACOS (MACOS USERS)"
.PP
اگر بسته برنامه‌ای drag-and-drop را بارگیری کرده‌اید، این ابزار درون آن قرار دارد. اگر Regina را به پوشه اصلی Applications کشیده‌اید، می‌توانید آن را به صورت /Applications/Regina.app/Contents/MacOS/censuslookup اجرا کنید.
.SH "کاربران WINDOWS (WINDOWS USERS)"
.PP
ابزارهای خط فرمانی در زیر دایرکتوری \fIProgram\~Files\fR نصب می‌شوند؛ در برخی رایانه‌ها این دایرکتوری \fIProgram\~Files\~(x86)\fR نام دارد. می‌توانید این ابزار را با اجرای مسیر c:\\Program\~Files\\Regina\\Regina\~7.4.1\\bin\\censuslookup.exe آغاز کنید.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBregina-gui\fR\&،
\fBtrisetcmp\fR\&.
.SH "نویسندگان (AUTHORS)"
.PP
این ابزار توسط Benjamin Burton <bab@maths.uq.edu.au> نوشته شده است.
افراد زیادی در توسعه Regina مشارکت داشته‌اند؛ برای فهرست کامل دست‌اندرکاران به راهنمای کاربران مراجعه کنید.