نام (NAME)

rbox - تولید توزیع‌های نقطه برای qhull

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

دستور "rbox" (بدون آرگومان) گزینه‌ها را فهرست می‌کند.

توضیحات (DESCRIPTION)

برنامه rbox با توجه به گزینه‌های داده‌شده، نقاط تصادفی یا منظم تولید کرده و آن‌ها را به stdout می‌فرستد. نقاط در یک مکعب تولید می‌شوند، مگر اینکه گزینه 's' یا 'k' مشخص شده باشد. قالب خروجی به این صورت است: خط نخست شامل بُعد و یک توضیح است، خط دوم شامل تعداد نقاط است، و خطوط بعدی شامل نقاط هستند (هر نقطه در یک خط). نقاط با مقادیر مختصاتشان نمایش داده می‌شوند.

مثال‌ها (EXAMPLES)

rbox 10: ۱۰ نقطه تصادفی در مکعب واحد هم‌مرکز با مبدأ مختصات.
rbox 10 s D2: ۱۰ نقطه تصادفی روی یک دایره ۲‐بُعدی.
rbox 100 W0: ۱۰۰ نقطه تصادفی روی سطح یک مکعب.
rbox 1000 s D4: ۱۰۰۰ نقطه تصادفی روی یک کره ۴‐بُعدی.
rbox c D5 O0.5: یک ابرمکعب ۵‐بُعدی با یک گوشه در مبدأ.
rbox d D10: یک الماس ۱۰‐بُعدی.
rbox x 1000 r W0: ۱۰۰ نقطه تصادفی روی سطح یک سیمپلکس ثابت.
rbox y D12: یک سیمپلکس ۱۲‐بُعدی.
rbox l 10: ۱۰ نقطه تصادفی در امتداد یک مارپیچ.
rbox l 10 r: ۱۰ نقطه منظم در امتداد یک مارپیچ به‌همراه دو نقطه انتهایی.
rbox 1000 L10000 D4 s: ۱۰۰۰ نقطه تصادفی روی سطح یک عدسی باریک.
rbox c G2 d G3: یک مکعب با مختصات +2/-2 و یک الماس با مختصات +3/-3.
rbox 64 M3,4 z: یک شبکه (Mesh) دوران‌یافته از نقاط صحیح {0,1,2,3} x {0,1,2,3} x {0,1,2,3}. دستور 'rbox 64 M1,0' متعامد است.
rbox P0 P0 P0 P0 P0: ۵ نسخه از مبدأ در فضای ۳‐بُعدی. دستور 'rbox P0 P0 P0 P0 P0 | qhull QJ' را امتحان کنید.
r 100 s Z1 G0.1: دو ۱۰۰‐ضلعی هم‌کره به‌همراه یک نقطه هم‌کره دیگر.
100 s Z1: یک مخروط از نقاط.
100 s Z1e-7: یک مخروط باریک از نقاط با خطاهای دقت بسیار.

گزینه‌ها (OPTIONS)

n: تعداد نقاط
Dn: بُعد n‐بُعدی (پیش‌فرض 3‐بُعدی)
Bn: مختصات جعبه محصورکننده (پیش‌فرض 0.5)
l: توزیع مارپیچی، تنها در فضای ۳‐بُعدی دردسترس است
Ln: توزیع عدسی با شعاع n. می‌تواند با 's'، 'r'، 'G' و 'W' استفاده شود.
Mn,m,r: شبکه (Mesh) دوران‌یافته با {[n,-m,0], [m,n,0], [0,0,r], ...}. از 'Mm,n' برای یک دوران صلب با r = sqrt(n^2+m^2) استفاده کنید. 'M1,0' یک شبکه متعامد است. برای نمونه، '27 M1,0' برابر {0,1,2} x {0,1,2} x {0,1,2} است. '27 M3,4 z' یک شبکه صحیح دوران‌یافته است.
s: نقاط هم‌کره به‌صورت تصادفی در یک مکعب تولید شده و بر روی کره واحد تصویر می‌شوند
x: توزیع سیمپلکس. برای گزینه 'r' ثابت است. می‌تواند با 'W' استفاده شود.
y: توزیع سیمپلکس به‌همراه یک سیمپلکس. هر دو گزینه 'x' و 'y' نقاط یکسانی تولید می‌کنند.
Wn: محدود کردن نقاط به فاصله n از سطح یک کره یا مکعب
c: افزودن یک مکعب واحد به خروجی
c Gm: افزودن یک مکعب با تمام ترکیب‌های +m و -m به خروجی
d: افزودن یک الماس واحد به خروجی.
d Gm: افزودن یک الماس ساخته‌شده از 0، +m و -m به خروجی
Cn,r,m: افزودن n نقطه تقریباً منطبق درون شعاع r از m نقطه
Pn,m,r: افزودن نقطه [n,m,r] در ابتدا به خروجی. مقادیر خالی مختصات با 0.0 پر می‌شوند.
n: حذف خط فرمان از خط نخست خروجی.
On: جابه‌جایی (offset) داده‌ها با افزودن n به هر مختصات.
t: استفاده از زمان برحسب ثانیه به‌عنوان بذر عدد تصادفی (پیش‌فرض خط فرمان است).
tn: تنظیم بذر عدد تصادفی روی n.
z: تولید مختصات صحیح. از 'Bn' برای تغییر بازه استفاده کنید. پیش‌فرض 'B1e6' برای مختصات شش‐رقمی است. در R^4، مختصات هفت‐رقمی باعث سرریز در نرمال‌سازی ابرصفحه خواهند شد.
Zn s: محدود کردن نقاط به یک دیسک حول محور z+ و کره (پیش‌فرض Z1.0). شامل قطب مقابل نیز می‌شود. 'Z1e-6' نقاط تباهیده تحت دقت منفرد (single precision) تولید می‌کند.
Zn Gm s: همانند Zn با مرکزی تهی (پیش‌فرض G0.5).
r s D2: تولید یک چندضلعی منتظم
r s Z1 G0.1: تولید یک مخروط منتظم

گزارش باگ‌ها (BUGS)

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

گزارش باگ‌ها را به qhull_bug@qhull.org و سایر مکاتبات را به qhull@qhull.org ارسال کنید.

همچنین ببینید (SEE ALSO)

qhull(1)

نویسندگان (AUTHORS)

C. Bradford Barber
bradb@shore.net