.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamcrater User Manual" 0 "03 November 2014" "netpbm documentation"

.SH "نام (NAME)"

pamcrater \- ایجاد زمین دهانه‌دار به روش جعل فرکتالی


.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBpamcrater\fP

[\fB-number\fP \fIn\fP]

[\fB-height\fP \fIpixels\fP]

[\fB-width\fP \fIpixels\fP]

[\fB-randomseed=\fP\fIinteger\fP]

[\fB-verbose\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه \fBpamcrater\fP یک تصویر PAM ایجاد می‌کند که یک نقشه عوارض زمین (نه یک تصویر بصری) از سطحی دهانه‌دار است. زمین به گونه‌ای شکل می‌گیرد که گویی تعداد مشخصی برخورد با سطح، دهانه‌هایی با مکان و اندازه تصادفی پدید آورده‌اند.
.PP
توزیع اندازه دهانه‌ها بر اساس یک قانون توانی (power law) است که منجر به ایجاد دهانه‌های کوچک بسیار بیشتر نسبت به دهانه‌های بزرگ می‌شود. تعداد دهانه‌های با اندازه معین با معکوس مساحت تغییر می‌کند، همان‌طور که در صفحه‌های ۳۱ و ۳۲ از Peitgen and Saupe[1] توصیف شده است؛ مشاهده شده است که اجرام دارای دهانه در منظومه شمسی از این رابطه پیروی می‌کنند. فرمول مورد استفاده برای به‌دست آوردن شعاع دهانه‌ها بر اساس این قانون از یک دنباله شبه‌تصادفی با توزیع یکنواخت، توسط Rudy Rucker توسعه داده شده است.
.PP
یک نقشه عوارض زمین، نقشه‌ای دوبعدی از ارتفاعات است. بنابراین، تصویر PAM تولیدشده توسط \fBpamcrater\fP یک تصویر بصری نیست، بلکه تصویری با عمق یک از نوع چندتایی (tuple type) «elevation» است که مقدار نمونه (sample value) در آن با ارتفاع متناسب است.
.PP
می‌توانید با ایجاد یک تصویر سایه‌روشن برجسته از این نقشه با استفاده از \fBpamshadedrelief\fP، آن را به‌صورت بصری نمایش دهید.
.PP
تصاویر با تفکیک‌پذیری بالا همراه با تعداد زیادی دهانه، اغلب با هدایت از طریق لوله به \fBpnmsmooth\fP کیفیت بهتری پیدا می‌کنند. میانگین‌گیری انجام‌شده توسط این فرایند، برخی از پیکسل‌های دندانه‌دار را حذف کرده و حسی ملایم شبیه به «تصویر تلسکوپی» به نمای کلی تصویر می‌بخشد.
.PP
برنامه \fBpamcrater\fP تنها دهانه‌های کوچک تولید می‌کند که شکلی نیم‌کره‌ای دارند (صرف‌نظر از زاویه برخورد جرم، تا زمانی که سرعت به اندازه کافی بالا باشد). دهانه‌های بزرگ، مانند کوپرنیک و تیکو بر روی ماه، شکلی شبیه به «دشت دیواره‌دار» با مقطع عرضی شبیه به این دارند:

.nf
                /\e                            /\e
          _____/  \e____________/\e____________/  \e_____
.fi
.PP
دهانه‌های بزرگ‌تر در واقع باید از چنین نمایه‌ای، شامل قله مرکزی، استفاده کنند و زمین پیشین را کاملاً محو سازند.
.PP
مقدار maxval در تصویر PAM همیشه ۶۵۵۳۵ است.
.PP
میزان تصادفی بودن در تصویر پیش از نسخه Netpbm 10.37 (دسامبر ۲۰۰۶) محدود بود -- اگر برنامه را دو بار در یک ثانیه اجرا می‌کردید، ممکن بود خروجی کاملاً یکسانی دریافت کنید.


.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک بین تمامی برنامه‌های مبتنی بر libnetpbm
(به‌ویژه \fB-quiet\fP، به
.UR index.html#commonoptions
گزینه‌های مشترک (Common Options)
.UE
\& مراجعه کنید)، برنامه \fBpamcrater\fP گزینه‌های خط فرمان زیر را می‌شناسد:
.PP
تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد.


.TP
\fB-number\fP \fIn\fP
این گزینه باعث می‌شود \fBpamcrater\fP تعداد \fIn\fP دهانه ایجاد کند. اگر \fB-number\fP را مشخص نکنید، ۵۰۰۰۰ دهانه تولید می‌کند. انتظار نداشته باشید همه آن‌ها را ببینید! به ازای هر دهانه بزرگ، دهانه‌های بسیار بسیار کوچک‌تری وجود دارند که تمایل دارند به سادگی چشم‌انداز را فرسایش دهند. به‌طور کلی، هر چه دهانه‌های بیشتری مشخص کنید، نتیجه واقع‌گرایانه‌تر خواهد بود؛ در حالت ایده‌آل انتظار می‌رود کل زمین بارها و بارها به‌طور گسترده در اثر ایجاد دهانه‌ها زیر و رو شده باشد. تصاویر با تفکیک‌پذیری بالا شامل پنج تا ده میلیون دهانه خیره‌کننده‌اند، اما ساخت آن‌ها زمان بیشتری می‌برد.

.TP
\fB-height\fP \fIheight\fP
این گزینه ارتفاع تصویر تولیدی را بر حسب پیکسل روی \fIheight\fP تنظیم می‌کند. ارتفاع پیش‌فرض ۲۵۶ پیکسل است.

.TP
\fB-width\fP \fIwidth\fP
این گزینه پهنای تصویر تولیدی را بر حسب پیکسل روی \fIwidth\fP تنظیم می‌کند. پهنای پیش‌فرض ۲۵۶ پیکسل است.

.TP
\fB-randomseed=\fP\fIinteger\fP
این گزینه مقدار دانه (seed) را برای مولد اعداد تصادفی که پیکسل‌ها را ایجاد می‌کند، تعیین می‌نماید.
.sp
از این گزینه برای اطمینان از دریافت تصویر یکسان در دفعات مختلف اجرا استفاده کنید.
.sp
به‌طور پیش‌فرض، \fBpamcrater\fP از دانه‌ای مشتق‌شده از زمان روز و شناسه فرایند (PID) استفاده می‌کند که در اجراهای متعدد نتایجی نسبتاً مستقل و بدون همبستگی ارائه می‌دهد.
.sp
این گزینه در Netpbm 10.61 (دسامبر ۲۰۱۲) اضافه شد.

.TP
\fB-verbose\fP
باعث می‌شود \fBpamcrater\fP پیام‌های توضیحی بیشتری درباره عملیات در حال انجام صادر کند.
.sp
این گزینه در Netpbm 10.69 (دسامبر ۲۰۱۴) اضافه شد.



.UN examples
.SH "مثال‌ها (EXAMPLES)"

.nf
\f(CW
    $ pamcrater | pamshadedrelief | pamx

    $ pamcrater -number=500000 -height=1000 -width=1000 >craters.pam
\fP  
.fi

.UN designnotes
.SH "نکات طراحی (DESIGN NOTES)"
.PP
دهانه‌های واقعی دارای دو ریخت‌شناسی (مورفولوژی) متمایز هستند.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamshadedrelief" (1)\c
\&،
.BR "ppmrelief" (1)\c
\&،
.BR "pnmsmooth" (1)\c
\&،
.BR "pam" (1)\c
\&


.TP
[1]
Peitgen, H.-O., and Saupe, D. eds., The Science Of Fractal Images,
New York: Springer Verlag, 1988.



.UN author
.SH "نویسنده (AUTHOR)"
.PP
برنامه \fBpgmcrater\fP که این برنامه از آن مشتق شده است، توسط John Walker نوشته شده است:

.nf
John Walker
Autodesk SA
Avenue des Champs-Montants 14b
CH-2074 MARIN
Suisse/Schweiz/Svizzera/Svizra/Switzerland
    \fBUsenet:\fP\fIkelvin@Autodesk.com\fP
    \fBFax:\fP038/33 88 15
    \fBVoice:\fP038/33 76 33
.fi
.PP
بدین‌وسیله مجوز استفاده، کپی، تغییر و توزیع این نرم‌افزار و مستندات آن برای هر هدفی و بدون دریافت هزینه، بدون هیچ‌گونه شرط یا محدودیتی اعطا می‌شود. این نرم‌افزار «همان‌طور که هست» (as is) و بدون هرگونه ضمانت صریح یا ضمنی ارائه می‌شود.


.UN history
.SH "تاریخچه (HISTORY)"
.PP
جان واکر (John Walker) برنامه \fBpgmcrater\fP را در سال ۱۹۹۱ نوشت و در Pbmplus گنجانده شد. \fBpgmcrater\fP معادل دستور \f(CWpamcrater | pamshadedrelief\fP عمل می‌کرد. در Netpbm 10.68 (سپتامبر ۲۰۱۴)، برایان هندرسون (Bryan Henderson) عملکردهای \fBpgmcrater\fP را به دو برنامه تفکیک کرد؛ یکی (\fBpamcrater\fP) برای محاسبه ارتفاعات، و دیگری (\fBpamshadedrelief\fP) برای تولید یک تصویر بصری سایه‌روشن برجسته از آن ارتفاعات. برایان این کار را به دلیل همگامی بیشتر با معماری پیمانه‌ای (ماژولار) Netpbm انجام داد و همچنین به این دلیل که \fBpamshadedrelief\fP ممکن است برای ورودی‌های دیگر نیز مفید واقع شود.
.PP
(مانند تمام برنامه‌های Netpbm، برنامه \fBpgmcrater\fP نیز بین دو رویداد یادشده در بالا ایستا نماند؛ تغییرات جزئی، از جمله جایگزینی بخش عمده‌ای از کد، در این فاصله انجام شد).
.PP
دفترچه راهنمای اصلی \fBpgmcrater\fP در سال ۱۹۹۱ شامل متن زیر بود:

.SS "معرفی محصول (PLUGWARE!)"
.PP
اگر به این موضوعات علاقه دارید، ممکن است از "James Gleick's Chaos--The Software" برای MS-DOS نیز لذت ببرید که با قیمت ۵۹.۹۵ دلار از فروشگاه‌های نرم‌افزاری محلی شما یا مستقیماً از شرکت Autodesk, Inc., Attn: Science Series, 2320 Marinship Way, Sausalito, CA 94965, USA قابل تهیه است. تلفن: ‎(800) 688-2344‎ (رایگان) یا از خارج از ایالات متحده ‎(415) 332-2344 Ext 4886‎. نمابر: ‎(415) 289-4718‎. نرم‌افزار "Chaos--The Software" شامل یک مولد جامع‌تر جعل فرکتالی است که چشم‌اندازهای سه‌بعدی و همچنین ابرها و سیارات را ایجاد می‌کند، به‌علاوه پنج ماژول دیگر که جنبه‌های دیگری از آشوب (Chaos) را بررسی می‌کنند. دفترچه راهنمای بیش از ۲۰۰ صفحه‌ای آن شامل مقدمه‌ای از James Gleick و توضیحات مفصل Rudy Rucker درباره ریاضیات و الگوریتم‌های مورد استفاده در هر برنامه است.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' متعلق به Netpbm از منبع HTML تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamcrater.html
.PP