'\" t .\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "GDAL-RASTER-VIEWSHED" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-viewshed \- محاسبه میدان دید یک مجموعه داده رستری. .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal raster viewshed [OPTIONS] محاسبه میدان دید یک مجموعه داده رستری. آرگومان‌های موضعی: \-i, \-\-input مجموعه داده‌های رستری ورودی [الزامی] [در خط‌لوله‌ها موجود نیست] \-o, \-\-output مجموعه داده رستری خروجی [الزامی] [در خط‌لوله‌ها موجود نیست] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده در قالب سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌لوله‌ها موجود نیست] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (مقدار \(dqGDALG\(dq مجاز است) [در خط‌لوله‌ها موجود نیست] \-\-co, \-\-creation\-option = گزینه ایجاد [تکرارپذیر] [در خط‌لوله‌ها موجود نیست] \-\-overwrite تعیین مجاز بودن رونویسی مجموعه داده خروجی موجود [در خط‌لوله‌ها موجود نیست] غیرقابل استفاده هم‌زمان با \-\-append \-\-append الحاق به خروجی موجود به عنوان زیرمجموعه‌داده [در خط‌لوله‌ها موجود نیست] غیرقابل استفاده هم‌زمان با \-\-overwrite \-p, \-\-pos, \-\-position or موقعیت ناظر [۲..۳ مقدار] \-z, \-\-height ارتفاع ناظر \-\-sd\-filename نام فایل رستر انحراف معیار \-\-target\-height ارتفاع هدف بالاتر از سطح DEM بر حسب واحد ارتفاع DEM. (پیش‌فرض: 0) \-\-mode تعیین اطلاعات موجود در خروجی.. MODE=normal|DEM|ground|cumulative (پیش‌فرض: normal) \-\-max\-distance حداکثر فاصله از ناظر برای محاسبه دید. همچنین برای محدود کردن محدوده رستر خروجی استفاده می‌شود. \-\-min\-distance ماسک کردن تمام سلول‌های با فاصله کمتر از این مقدار از ناظر. باید کمتر از \(aqmax\-distance\(aq باشد. \-\-start\-angle ماسک کردن تمام سلول‌های خارج از کمان (\(aqstart\-angle\(aq, \(aqend\-angle\(aq). درجه ساعت‌گرد از شمال. همچنین برای محدود کردن محدوده رستر خروجی استفاده می‌شود. \-\-end\-angle ماسک کردن تمام سلول‌های خارج از کمان (\(aqstart\-angle\(aq, \(aqend\-angle\(aq). درجه ساعت‌گرد از شمال. همچنین برای محدود کردن محدوده رستر خروجی استفاده می‌شود. \-\-high\-pitch علامت‌گذاری تمام سلول‌های خارج از محدوده که در آن‌ها ارتفاع قابل مشاهده بیشتر از زاویه \(aqhigh\-pitch\(aq از ناظر باشد. درجه از افق \- مثبت به سمت بالا است. باید بیشتر از \(aqlow\-pitch\(aq باشد. \-\-low\-pitch محدود کردن ارتفاع قابل مشاهده به طوری که کمتر از زاویه \(aqlow\-pitch\(aq از ناظر نباشد. درجه از افق \- مثبت به سمت بالا است. باید کمتر از \(aqhigh\-pitch\(aq باشد. \-\-curvature\-coefficient ضریب برای در نظر گرفتن اثر انحنا و شکست نور. \-b, \-\-band باند ورودی (شاخص مبتنی بر ۱) (پیش‌فرض: 1) \-\-visible\-value مقدار پیکسل برای نواحی مرئی (پیش‌فرض: 255) \-\-invisible\-value مقدار پیکسل برای نواحی نامرئی (پیش‌فرض: 0) \-\-maybe\-visible\-value مقدار پیکسل برای نواحی بالقوه مرئی (پیش‌فرض: 2) \-\-out\-of\-range\-value مقدار پیکسل برای سلول‌هایی که خارج از محدوده مشخص‌شده توسط موقعیت ناظر و حداکثر فاصله قرار می‌گیرند (پیش‌فرض: 0) \-\-output\-nodata مقداری که باید برای سلول‌های بدون داده در رستر خروجی تنظیم شود. \-\-observer\-spacing فاصله سلولی بین ناظرها (پیش‌فرض: 10) \-j, \-\-num\-threads تعداد وظایف (یا ALL_CPUS) (پیش‌فرض: 3) گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [تکرارپذیر] [در خط‌لوله‌ها موجود نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [تکرارپذیر] [در خط‌لوله‌ها موجود نیست] .EE .UNINDENT .UNINDENT.SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster viewshed\fP یک رستر دیدپذیری دودویی (باینری) از یک باند مدل رقومی ارتفاع (DEM) ورودی ایجاد می‌کند. رستر خروجی از نوع Byte خواهد بود. استفاده از مقادیر \fBDEM\fP یا \fBground\fP در \fI\%\-\-mode\fP می‌تواند یک رستر حداقل ارتفاع قابل‌مشاهده از نوع Float64 نیز تولید کند. .sp این دستور از روش تعریف‌شده در \fI\%[Wang2000]\fP برای یک نقطه تعیین‌شده توسط کاربر استفاده می‌کند. .sp این زیردستور همچنین به‌عنوان یک مرحله احتمالی در \fI\%gdal raster pipeline\fP در دسترس است (از نسخه GDAL 3.12). .sp افزوده‌شده در نسخه 3.12. .SH "خروجی GDALG (مجموعه‌داده جاری / در حال پرواز) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp این برنامه از سریال‌سازی خط فرمان در قالب یک فایل JSON با استفاده از فرمت خروجی \fBGDALG\fP پشتیبانی می‌کند. سپس فایل حاصل می‌تواند به‌عنوان یک مجموعه‌داده رستری با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز شده و خط لوله مشخص‌شده را به‌صورت در حال پرواز / جریانی (streamed) اعمال کند. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 با این حال این الگوریتم به‌صورت بومی با حالت جریانی سازگار نیست. در نتیجه یک مجموعه‌داده موقت تولید خواهد شد که ممکن است زمان پردازش قابل‌توجهی را هنگام باز کردن ایجاد کند. .UNINDENT .UNINDENT .SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-b, \-\-band انتخاب باند ورودی حاوی داده‌های DEM. شماره‌گذاری باندها از ۱ آغاز می‌شود. تنها یک باند قابل استفاده است. فقط بخشی از رستر که در حداکثر فاصله مشخص‌شده اطراف نقطه دیده‌بان قرار دارد پردازش می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-curvature\-coefficient ضریب برای لحاظ کردن اثر انحنای زمین و شکست نور. هنگام محاسبه دید بین دو نقطه (یعنی خط دید یا میدان دید)، میزان این اثر با شرایط جوی تغییر می‌کند و به طول موج بستگی دارد. .sp برنامه‌های مختلف برای محاسبه دید، از اصطلاحات قابل‌تعویض متفاوتی برای توصیف این پدیده استفاده می‌کنند: ضریب شکست (Refraction Coefficient)، ضریب انحنا (Curvature Coefficient)، و ضریب قطر کره (Sphere Diameter Factor). ابزار gdal_viewshed از اصطلاح ضریب انحنا (Curvature Coefficient) استفاده می‌کند. .sp .ce {CurvCoeff}=1\-{RefractionCoeff} .ce 0 .sp تغییرات چگالی هوا مسیر نور را به سمت پایین خم می‌کند که باعث می‌شود دیده‌بان فاصله‌های دورتر را ببیند و انحنای زمین کمتر به نظر برسد، گویی قطر کره (زمین) بزرگ‌تر از مقدار واقعی آن است. نسبت بین قطر آن کره فرضی و قطر واقعی کره با فرمول زیر مشخص می‌شود: .sp .ce {SphereDiameterFactor}=1/{CurvCoeff}=1/(1\-{RefractionCoeff}) .ce 0 .sp برای نور مرئی، ضریب شکست استاندارد جوی که عموماً به کار می‌رود 1/7 است. بنابراین مقدار پیش‌فرض (از نسخه GDAL 3.4) برای CurvCoeff که gdal_viewshed استفاده می‌کند، برابر با 0.85714 (=~ 1\-1/7) برای سامانه مرجع مختصات (CRS) زمین است. از نسخه GDAL 3.6، برای CRSهای غیر از زمین (آن‌هایی که نیم‌قطر بزرگ آن‌ها بیش از ۵٪ با WGS 84 تفاوت دارد)، مقدار پیش‌فرض CurvCoeff برابر با 1.0 است تا حالت بدون شکست در نظر گرفته شود. .sp ارتفاع DEM بر اساس فرمول زیر تصحیح می‌شود: .sp .ce Height_{Corrected}=Height_{DEM}\-{CurvCoeff}\efrac{{TargetDistance}^2}{SphereDiameter} .ce 0 .sp مقادیر معمول ضرایب در جدول زیر آورده شده است (از مقدار Curvature Coeff برای گزینه cc استفاده کنید): .TS box center; l|l|l|l. T{ مورد کاربرد T} T{ ضریب شکست T} T{ \fBضریب انحنا (Curvature Coeff)\fP T} T{ ضریب قطر کره T} _ T{ بدون شکست T} T{ 0 T} T{ 1 T} T{ 1 T} _ T{ نور مرئی T} T{ 1/7 T} T{ 6/7 (=~0.85714) T} T{ 7/6 (=~1.1666) T} _ T{ امواج رادیویی T} T{ 0.25 ~ 0.325 T} T{ 0.75 ~ 0.675 T} T{ 1.33 ~ 1.48 T} _ T{ زمین تخت T} T{ 1 T} T{ 0 T} T{ inf T} .TE .UNINDENT .INDENT 0.0 .TP .B \-\-end\-angle افزوده‌شده در نسخه 3.12. .sp زاویه پایانی برای دیدپذیری. در جهت عقربه‌های ساعت از ۰ درجه شمال، بر حسب درجه اندازه‌گیری می‌شود. (در حالت تجمعی یا cumulative پشتیبانی نمی‌شود) .UNINDENT .INDENT 0.0 .TP .B \-z, \-\-height ارتفاع دیده‌بان (ناظر). .UNINDENT .INDENT 0.0 .TP .B \-\-high\-pitch افزوده‌شده در نسخه 3.12. .sp زاویه فراز بالا (high pitch) برای دیدپذیری. از سطح افقی صفر به سمت بالا، بر حسب درجه اندازه‌گیری می‌شود. مقادیر ورودی بالاتر از زاویه بالا به‌عنوان خارج از محدوده علامت‌گذاری می‌شوند. باید بزرگ‌تر از \(aq\-\-low\-pitch\(aq باشد. (در حالت cumulative پشتیبانی نمی‌شود) .UNINDENT .INDENT 0.0 .TP .B \-\-invisible\-value مقدار پیکسلی که باید برای نواحی نامرئی تنظیم شود. (در حالت cumulative پشتیبانی نمی‌شود) پیش‌فرض: 0 .UNINDENT .INDENT 0.0 .TP .B \-\-low\-pitch افزوده‌شده در نسخه 3.12. .sp زاویه فراز پایین (low pitch) برای دیدپذیری. از سطح افقی صفر به سمت بالا، بر حسب درجه اندازه‌گیری می‌شود. مقادیر سلول‌های ورودی کمتر از این زاویه به‌گونه‌ای مهار (clamp) می‌شوند که پایین‌تر از محل تقاطع زاویه نباشند. باید کمتر از \(aq\-\-high\-pitch\(aq باشد. (در حالت cumulative پشتیبانی نمی‌شود) .UNINDENT .INDENT 0.0 .TP .B \-\-max\-distance حداکثر فاصله از دیده‌بان برای محاسبه دیدپذیری. همچنین برای مهار کردن وسعت رستر خروجی استفاده می‌شود. (در حالت cumulative پشتیبانی نمی‌شود) .UNINDENT .INDENT 0.0 .TP .B \-\-min\-distance افزوده‌شده در نسخه 3.12..sp حداقل فاصله از ناظر برای محاسبه دید. باید کمتر از \(aq\-\-max\-distance\(aq باشد (در حالت cumulative پشتیبانی نمی‌شود) .UNINDENT .INDENT 0.0 .TP .B \-\-mode normal|DEM|ground|cumulative مشخص می‌کند خروجی چه اطلاعاتی را شامل شود. .INDENT 7.0 .IP \(bu 2 \fBnormal\fP (پیش‌فرض) یک رستر از نوع Byte برمی‌گرداند که شامل مکان‌های مرئی است. .IP \(bu 2 \fBDEM\fP و \fBground\fP رستری از نوع Float64 شامل حداقل ارتفاع لازم برای هدف برمی‌گردانند تا هدف به ترتیب از سطح DEM یا سطح زمین مرئی باشد. بدین معنا که اگر حداقل ارتفاع هدف برای مرئی بودن در یک نقطه برابر با \fBh\fP و مقدار رستر ورودی در آن نقطه برابر با \fBE\fP باشد، برای \fBDEM\fP مقدار خروجی \fBE + h\fP خواهد بود. برای \fBground\fP مقدار خروجی \fBh\fP خواهد بود. گزینه‌های \fB\-\-target\-height\fP، \fB\-\-invisible\-value\fP و \fB\-\-visible\-value\fP نادیده گرفته خواهند شد. .IP \(bu 2 \fBcumulative\fP یک رستر هشت‌بیتی هم‌اندازه با رستر ورودی ایجاد می‌کند که در آن هر سلول نشان‌دهنده قابلیت مشاهده نسبی از شبکه‌ای از نقاط ناظر است. گزینه \fI\%\-\-observer\-spacing\fP را ببینید. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-j, \-\-num\-threads تعداد کارهایی که باید به‌طور هم‌زمان اجرا شوند (تنها در حالت cumulative پشتیبانی می‌شود). پیش‌فرض: 3 .UNINDENT .INDENT 0.0 .TP .B \-\-observer\-spacing فاصله سلولی بین ناظران (تنها در حالت cumulative پشتیبانی می‌شود). پیش‌فرض: 10 .UNINDENT .INDENT 0.0 .TP .B \-\-out\-of\-range\-value مقدار پیکسلی برای سلول‌هایی که خارج از محدوده مشخص‌شده توسط موقعیت ناظر و حداکثر فاصله قرار می‌گیرند (در حالت cumulative پشتیبانی نمی‌شود). پیش‌فرض: 0 .UNINDENT .INDENT 0.0 .TP .B \-\-output\-nodata مقداری که باید برای سلول‌های بدون داده در رستر خروجی تنظیم شود. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 در حال حاضر هیچ پردازش خاصی روی سلول‌های ورودی دارای مقدار nodata انجام نمی‌شود (که ممکن است به نتایج نادرست منجر شود). .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-p, \-\-pos, \-\-position or موقعیت X,Y یا X,Y,H (ارتفاع) ناظر (در واحدهای SRS برای X و Y، و در واحد ارتفاع DEM برای H). اگر مختصات خارج از رستر باشد، فرض می‌شود تمام فضای بین ناظر و رستر مانع دید رستر نمی‌شود (در حالت cumulative پشتیبانی نمی‌شود). اگر H مشخص نشده باشد، پیش‌فرض آن 2 است. .UNINDENT .INDENT 0.0 .TP .B \-\-start\-angle در نسخه 3.12 اضافه شد. .sp زاویه شروع برای دید. در جهت عقربه‌های ساعت از 0 شمال و به درجه اندازه‌گیری می‌شود. (در حالت cumulative پشتیبانی نمی‌شود) .UNINDENT .INDENT 0.0 .TP .B \-\-target\-height ارتفاع هدف بالاتر از سطح DEM در واحد ارتفاع DEM. پیش‌فرض: 0 .UNINDENT .INDENT 0.0 .TP .B \-\-visible\-value .INDENT 7.0 .INDENT 3.5 مقدار پیکسلی برای نواحی مرئی (در حالت cumulative پشتیبانی نمی‌شود). پیش‌فرض: 255 .UNINDENT .UNINDENT .sp در نسخه 3.13 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-\-sd\-filename نام فایل رستری حاوی انحراف معیارهای مقادیر رستر ورودی. این رستر همیشه از باند 1 گرفته می‌شود و اندازه آن باید با رستر ورودی مطابقت داشته باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-maybe\-visible\-value مقدار پیکسلی برای نواحی مرئی (در حالت cumulative پشتیبانی نمی‌شود). پیش‌فرض: 255 .UNINDENT.SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append الحاق رستر ورودی به‌عنوان یک زیرمجموعه‌داده (subdataset) جدید به یک فایل خروجی موجود. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده‌ها پشتیبانی می‌کنند؛ مانند \fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP\&. همچنین در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ساخت دارند که می‌توان برای کنترل جزئیات فایل ایجادشده از آن‌ها استفاده کرد. برای مثال، درایور GeoTIFF از گزینه‌های ساختی برای کنترل فشرده‌سازی و کاشی‌بندی شدن فایل (tiled) پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساختِ در دسترس بر اساس درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات خود قالب، منبع نهایی و معتبر اطلاعات درباره گزینه‌های ساخت درایور است. برای مشاهده گزینه‌های ساخت مجاز هر قالب، به مستندات اختصاصی قالب در \fI\%Raster drivers\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام قالب/درایور مورد نظر برای تلاش جهت باز کردن فایل(های) ورودی. به‌طور کلی تعیین آن ضروری نیست، اما هنگامی که تشخیص خودکار درایور در انتخاب درایور مناسب ناموفق باشد، می‌توان از آن برای صرف‌نظر از تشخیص خودکار استفاده کرد. این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند؛ به‌ویژه آنکه برخی درایورها الزاماتی برای پسوند فایل‌ها دارند. .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (مخصوص هر قالب). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format قالب رستری خروجی مورد استفاده را مشخص می‌کند. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: \fBgdal \-\-formats | grep raster | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد فایل مقصد یا مجموعه‌داده موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل مقصد یا مجموعه‌داده از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .SH "وضعیت خروج (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقدار غیرصفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱" .sp تصویر حاصل از ترکیب دو تحلیل حوضه دید (viewshed)؛ پیکسل‌های زرد محدوده‌ای را نشان می‌دهند که از هر دو مکان دیده‌بانی (نقاط سبز) قابل مشاهده است، در حالی که ناحیه سبز کوچک تنها از یک مکان قابل دیدن است. .INDENT 0.0 .INDENT 2.5 [تصویر] .UNINDENT .UNINDENT .sp ایجاد یک رستر حوضه دید با شعاع ۵۰۰ برای شخصی که در موقعیت (\-10147017, 5108065) ایستاده است. .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster viewshed \-\-max\-distance=500 \-\-pos=\-10147017,5108065 source.tif destination.tif .EE .UNINDENT .UNINDENT.SH "نویسنده (AUTHOR)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .