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

.SH "نام (NAME)"
regina-python \- رابط خط فرمانی پایتون برای نرم‌افزار Regina
.SH "خلاصه دستور (SYNOPSIS)"

\fBregina-python\fR [ \fB-q, --quiet\fR | \fB-v, --verbose\fR ] [ \fB-n, --nolibs\fR ] [ \fB-a, --noautoimport\fR ]


\fBregina-python\fR [ \fB-q, --quiet\fR | \fB-v, --verbose\fR ] [ \fB-n, --nolibs\fR ] [ \fB-a, --noautoimport\fR ] [ \fB-i, --interactive\fR ] \fB\fIscript\fB\fR [ \fB\fIscript-args\fB\fR ]

.SH "توضیحات (DESCRIPTION)"
.PP
نرم‌افزار Regina یک بستهٔ نرم‌افزاری برای مطالعهٔ مثلث‌بندی‌های ۳-خمینه (3-manifold triangulations) و سطوح نرمال (normal surfaces) است. از دیگر ویژگی‌های کلیدی آن می‌توان به ساختارهای زاویه‌ای، سرشماری و شمارش، بازشناسی ترکیبیاتی مثلث‌بندی‌ها، و وظایف سطح‌بالا مانند بازشناسی ۳-کره و تجزیه به مجموع همبند اشاره کرد. Regina به همراه یک رابط گرافیکی کاربر کامل ارائه می‌شود و همچنین اتصالات (bindings) پایتون و یک رابط برنامه‌نویسی سطح‌پایین C++ را فراهم می‌سازد.
.PP
این دستور یک نشست تعاملی پایتون را برای Regina آغاز می‌کند. این نشست یک جلسهٔ خط فرمانی پایتون همراه با ورودی/خروجی متنی مستقیم و فاقد رابط گرافیکی کاربر خواهد بود. تمامی شیءها، کلاس‌ها و متدهای موتور ریاضیاتی Regina از طریق ماژول \fIregina\fR در دسترس خواهند بود که هنگام راه‌اندازی درون‌ریزی می‌شود (مشابه با اجرای دستور import regina). علاوه بر این، مگر در صورتی که گزینهٔ \fB--noautoimport\fR تعیین شده باشد، همهٔ شیءها، کلاس‌ها و متدهای Regina مستقیماً در فضای نام فعلی درون‌ریزی می‌شوند (مشابه با اجرای دستور from regina import\~*).
.PP
به جای شروع یک نشست تعاملی پایتون، می‌توانید یک اسکریپت پایتون را (در صورت نیاز به همراه آرگومان‌ها) ارسال کنید. در این حالت، Regina اسکریپت را اجرا خواهد کرد (پس از درون‌ریزی اولیهٔ ماژول \fIregina\fR). اگر گزینهٔ \fB--interactive\fR را ارسال کنید، Regina پس از پایان اجرای اسکریپت شما را در اعلان پایتون باقی می‌گذارد؛ در غیر این صورت از پایتون خارج شده و شما را به خط فرمان بازمی‌گرداند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-q\fR
.TP
\fB--quiet\fR
اجرا در حالت بی‌صدا. به جز خطاهای بحرانی هیچ خروجی دیگری تولید نخواهد شد. به‌ویژه، هشدارها نادیده گرفته می‌شوند.

این گزینه معادل تنظیم متغیر محیطی \fIREGINA_VERBOSITY\fR=0 است.
.TP
\fB-v\fR
.TP
\fB--verbose\fR
اجرا در حالت پرگو. اطلاعات تشخیصی تکمیلی در خروجی نمایش داده خواهد شد.

این گزینه معادل تنظیم متغیر محیطی \fIREGINA_VERBOSITY\fR=2 است.
.TP
\fB-a\fR
.TP
\fB--noautoimport\fR
همچنان ماژول \fIregina\fR درون‌ریزی می‌شود، اما تمام شیءها، کلاس‌ها و متدهای Regina به‌طور خودکار به فضای نام جاری درون‌ریزی نخواهند شد (یعنی دستور from regina import\~* اجرا نمی‌شود). این بدان معناست که (به‌عنوان مثال) کلاس اصلی مثلث‌بندی ۳-خمینه باید به‌صورت regina.Triangulation3 فراخوانی شود، نه فقط Triangulation3\&.
.TP
\fB-i\fR
.TP
\fB--interactive\fR
اجرای اسکریپت در حالت تعاملی. پس از اجرای اسکریپت مشخص‌شده، Regina شما را درون مفسر پایتون باقی می‌گذارد تا دستورهای تکمیلی مورد نظرتان را اجرا کنید.

این گزینه تنها زمانی قابل استفاده است که یک اسکریپت ارسال شده باشد. اگر اسکریپتی ارسال نشود، \fBregina-python\fR همواره در حالت تعاملی آغاز به کار می‌کند.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
متغیرهای محیطی زیر بر رفتار این برنامه تأثیر می‌گذارند. اکثر متغیرها را می‌توان در فایل پیکربندی محلی \fI~/.regina-python\fR نیز با استفاده از سطری به شکل \fIoption\fR=\fIvalue\fR تنظیم کرد؛ موارد استثنا در ادامه ذکر شده‌اند. متغیرهای محیطی نسبت به مقادیر موجود در فایل پیکربندی اولویت دارند.
.TP
\fB\fIREGINA_VERBOSITY\fB\fR
مشخص می‌کند چه مقدار خروجی باید تولید شود. مقادیر معتبر عبارتند از:
.RS
.TP
\fB0\fR
تنها نمایش خطاها؛ این حالت معادل تعیین گزینهٔ \fB--quiet\fR است.
.TP
\fB1\fR
نمایش خطاها و هشدارها؛ این مقدار پیش‌فرض است.
.TP
\fB2\fR
نمایش خطاها، هشدارها و خروجی‌های تشخیصی؛ این حالت معادل تعیین گزینهٔ \fB--verbose\fR است.
.RE
.TP
\fB\fIREGINA_PYTHON\fB\fR
دستوری که برای اجرای مفسر پایتون استفاده می‌شود.

به‌طور کلی باید از همان نسخه‌ای از پایتون استفاده کنید که Regina در برابر آن ساخته شده است؛ در غیر این صورت ممکن است پایتون نتواند ماژول \fIregina\fR را بارگذاری کند.

معمولاً نیازی نیست این گزینه را به صورت دستی تنظیم کنید. به‌طور پیش‌فرض، Regina از همان نصب پایتونی استفاده می‌کند که با آن ساخته شده است.
.TP
\fB\fIREGINA_PYLIBDIR\fB\fR
دایرکتوری حاوی ماژول پایتون \fIregina\fR\&.

اگر ماژول پایتون Regina را در یک مسیر استاندارد پایتون نصب کرده‌اید (به‌طوری که پایتون بتواند آن را بدون افزودن به sys.path مستقیماً درون‌ریزی کند)، متغیر \fIREGINA_PYLIBDIR\fR باید خالی یا تعریف‌نشده باقی بماند.

معمولاً نیازی نیست این گزینه را به صورت دستی تنظیم کنید. این برنامه در شرایط استاندارد می‌داند چگونه ماژول پایتون Regina را پیدا کند؛ از جمله در نصب‌های با ساختار فایل‌سیستم ثابت (مانند \fBGNU/Linux\fR و \fBWindows\fR)، بسته‌های برنامک جابه‌جاشدنی (مانند \fBmacOS\fR)، و هنگام اجرای مستقیم از شاخهٔ کد منبع.
.TP
\fB\fIREGINA_HOME\fB\fR
دایرکتوری‌ای که فایل‌های دادهٔ Regina در زیر آن نصب شده‌اند. به‌ویژه، روتین‌های جستجوی سرشماری Regina پایگاه‌های دادهٔ سرشماری را در زیرشاخهٔ \fI$REGINA_HOME/data/census/\fR جستجو خواهند کرد.

این گزینه فقط از طریق متغیر محیطی قابل تنظیم است و نمی‌توان آن را در فایل پیکربندی \fI~/.regina-python\fR تعریف کرد.

معمولاً نیازی نیست این گزینه را به صورت دستی تنظیم کنید. این برنامه در شرایط استاندارد می‌داند چگونه فایل‌های دادهٔ خود را پیدا کند؛ از جمله در نصب‌های با ساختار فایل‌سیستم ثابت (مانند \fBGNU/Linux\fR و \fBWindows\fR)، بسته‌های برنامک جابه‌جاشدنی (مانند \fBmacOS\fR)، و هنگام اجرای مستقیم از شاخهٔ کد منبع.
.SH "کاربران MACOS (MACOS USERS)"
.PP
اگر نسخهٔ بستهٔ برنامک کشیدنی و رهاکردنی (drag-and-drop) را بارگیری کرده‌اید، این ابزار درون آن قرار دارد. چنانچه Regina را به دایرکتوری اصلی Applications منتقل کرده باشید، می‌توانید آن را به صورت /Applications/Regina.app/Contents/MacOS/regina-python اجرا کنید.
.SH "کاربران WINDOWS (WINDOWS USERS)"
.PP
دستور \fBregina-python\fR تحت \fBWindows\fR در دسترس نیست. با این حال، همچنان می‌توانید با باز کردن کنسول پایتون در رابط گرافیکی کاربر Regina یا استفاده از بسته‌های اسکریپت (script packets)، از قابلیت‌های اسکریپت‌نویسی پایتون بهره ببرید.
.SH "همچنین ببینید (SEE ALSO)"
.PP
regina-gui\&.
.PP
نرم‌افزار Regina به همراه مستندات کامل API عرضه می‌شود که تمامی شیءها، کلاس‌ها و متدهای در دسترس قرارگرفته در پایتون را با جزئیات تشریح می‌کند. می‌توانید از طریق مسیر Help->Python API Reference در رابط گرافیکی کاربر به این مستندات دسترسی پیدا کنید، یا آن را به‌صورت برخط در نشانی \fBhttp://regina-normal.github.io/engine-docs\fR مطالعه نمایید.
.SH "نویسندگان (AUTHORS)"
.PP
افراد زیادی در توسعهٔ نرم‌افزار Regina مشارکت داشته‌اند؛ برای مشاهدهٔ فهرست کامل اسامی به کتابچهٔ راهنمای کاربران مراجعه کنید.