RKWARD(1) RKWard User's Manual RKWARD(1)

rkward - یک واسط کاربری مبتنی بر KDE برای R

rkward [--evaluate Rcode] [--debug-level level] [--debug-flags flags] [--debug-output where] [--backend-debugger debugger_command] [--r-executable path_to_executable] [--reuse] [--autoreuse] [--nowarn-external] [گزینه‌های عمومی KDE] [گزینه‌های عمومی Qt] [files_to_open]

RKWard یک رابط کاربری گرافیکی (GUI) و محیط توسعه یکپارچه (IDE) مبتنی بر KDE برای زبان اسکریپت‌نویسی R جهت محاسبات آماری است.

برای اطلاعات بیشتر، لطفاً به وبگاه RKWard[1] و مستندات ارائه‌شده درون خود RKWard مراجعه کنید.

--evaluate Rcode

کد R داده‌شده پس از راه‌اندازی RKWard و پس از بارگذاری هر فضای کاری مشخص‌شده، ارزیابی می‌شود. این گزینه بیشتر برای آزمایش‌های خودکار کاربرد دارد.

--debug-level level

میزان جزئیات خروجی اشکال‌زدایی. مقادیر بین 0 تا 5 هستند، که در آن 0 به معنی بدون خروجی و 5 شامل همه خروجی‌ها از جمله اطلاعات ردگیری (trace) توابع است. مقدار پیش‌فرض 2 است.

--debug-output where

محل ارسال خروجی اشکال‌زدایی. مقدار پیش‌فرض، ذخیره آن در فایلی درون دایرکتوری موقت است. مشخص کردن "terminal" خروجی اشکال‌زدایی را در عوض به stderr می‌فرستد (برای اشکال‌زدایی مشکلات راه‌اندازی مفید است). توجه داشته باشید که خروجی اشکال‌زدایی فرآیند backend همواره در یک فایل ذخیره می‌شود.

--debug-flags flags

پیکربندی بخش‌هایی از کد که باید اشکال‌زدایی شوند. پرچم‌ها به‌صورت یک عدد باینری (دودویی) مشخص می‌شوند. برای مستندات به فایل‌های منبع مراجعه کنید، چرا که این گزینه کاملاً یک گزینه داخلی است.

--backend-debugger command

اجرای بخش پس‌زمینه (backend) RKWard از طریق دستور اشکال‌زدای مشخص‌شده. برای افزودن گزینه‌های خط فرمان به دستور اشکال‌زدا، آن‌ها را همراه با دستور در علامت نقل‌قول تکی ('') محصور کنید. نکته: آرگومان‌های اشکال‌زدا با فاصله جدا خواهند شد. اگر این رفتار مناسب نیست، باید اسکریپت پوششی (wrapper) خود را برای فراخوانی اشکال‌زدا بنویسید. همچنین مطمئن شوید که تمامی خروجی‌ها و/یا ورودی‌های اشکال‌زدا را به شکل مقتضی بازهدایت (redirect) کنید. مثال‌ها را ببینید.

--r-executable command

در صورت وجود چندین نصب از R، نصبی را که باید استفاده شود مشخص کنید، برای نمونه /usr/bin/R. همچنین می‌توانید از رشته "auto" استفاده کنید، که در این صورت RKWard سعی خواهد کرد R را در یکی از مسیرهای نصب استاندارد و شناخته‌شده پیدا کند. توجه داشته باشید که اگرچه RKWard اغلب با نسخه‌های جدیدتر R کار می‌کند، اما گاهی اوقات نیاز به کامپایل مجدد برای آن نسخه دارد یا ممکن است کلاً ناسازگار باشد.

این گزینه نصب R را تنها برای نشست فعلی تغییر می‌دهد و تغییر آن ماندگار نیست.

--reuse

اگر یک نمونه از RKWard از قبل در حال اجرا باشد، آن را به جلو می‌آورد و files_to_open را باز می‌کند. توجه داشته باشید در صورتی که از یک نمونه مجدداً استفاده شود، تمام گزینه‌های دیگر خط فرمان نادیده گرفته خواهند شد.

--autoreuse

در صورتی که هرگونه آرگومان فایلی نیز داده شده باشد مانند --reuse رفتار می‌کند؛ در غیر این صورت، یک نمونه جدید را آغاز می‌کند. برای استفاده در فایل .desktop در نظر گرفته شده است.

--nowarn-external

معمولاً هنگام فراخوانی افزونه‌های RKWard از خط فرمان (یعنی زمانی که files_to_open شامل URLهایی به شکل rkward://runplugin/... باشد)، RKWard هشداری را نشان می‌دهد مبنی بر اینکه چنین URLهایی می‌توانند برای اجرای اقدامات مخرب روی سیستم شما استفاده شوند. این هشدار به‌طور مشخص مربوط به پیوندهای یافت‌شده در وبگاه‌های غیرقابل اعتماد یا سایر منابع خارجی نامعتبر است. اگر می‌خواهید برای RKWard به‌صورت محلی اسکریپت بنویسید، می‌توانید با افزودن --nowarn-external به خط فرمان از نمایش این هشدار جلوگیری کنید.

(اگر در ترکیب با --reuse استفاده شود، برای فرونشاندن هشدار باید *هر دو* دستور مورد نظر با --nowarn-external فراخوانی شوند.)

--setup

طوری عمل می‌کند که گویی نسخه جدیدی از RKWard نصب شده است؛ به‌ویژه با نصب مجدد بسته پشتیبانی R و نمایش ویزارد راه‌اندازی. این ویژگی عمدتاً برای توسعه‌دهندگان و آزمون‌کنندگان هدف‌گذاری شده است.

--quirkmode

غیرفعال‌سازی برخی از کدهای اعتبارسنجی راه‌اندازی. گزینه‌ای آزمایشی است و برای استفاده عادی در نظر گرفته نشده است.

files_to_open

می‌توانید هر تعداد نام فایل یا URL را برای باز شدن توسط RKWard مشخص کنید. این موارد معمولاً فایل‌های فضای کاری (workspace)، فایل‌های محیط کار (workplace)، فایل‌های اسکریپت R یا URLهای rkward:// (مثلاً برای شروع با پنجره محاوره‌ای یک افزونه) هستند. تعیین بیش از یک فایل فضای کاری منجر به ادغام فضاهای کاری با یکدیگر خواهد شد و توصیه نمی‌شود.

R(1)

# شروع با پنجره محاوره‌ای t-test
rkward --nowarn-external rkward://runplugin/rkward::t_test/
# باز کردن دو فایل اسکریپت در یک نمونه در حال اجرای RKWard (یا نمونه‌ای تازه اگر RKWard در حال اجرا نباشد)
rkward --reuse file_a.R file_b.R
# اجرای پس‌زمینه rkward از طریق valgrind
rkward --backend-debugger 'valgrind --log-file=valgrind.log'

RKWard توسط Thomas Friedrichsmeier و تیم RKWard نوشته شده است. به وبگاه RKWard[1] مراجعه کنید.

Thomas Friedrichsmeier <rkward@kde.org>

صفحه راهنمای RKWard.

1.
وبگاه RKWard
https://rkward.kde.org
2024-05-26 KDE Applications RKWard 0.8.0