.\" 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-FOOTPRINT" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-footprint \- محاسبه ردپای یک مجموعه داده شطرنجی (رستر) .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX نحوه استفاده: gdal raster footprint [OPTIONS] ... محاسبه ردپای یک مجموعه داده رستر. آرگومان‌های موضعی (Positional arguments): \-i, \-\-input مجموعه داده‌های رستر ورودی [تکرارپذیر] [الزامی] [در خطوط لوله در دسترس نیست] \-o, \-\-output مجموعه داده برداری خروجی [الزامی] [در خطوط لوله در دسترس نیست] گزینه‌های عمومی (Common Options): \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست] گزینه‌ها (Options): \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی [در خطوط لوله در دسترس نیست] \-\-co, \-\-creation\-option = گزینه ایجاد [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-lco, \-\-layer\-creation\-option = گزینه ایجاد لایه [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-append آیا الحاق به لایه موجود مجاز است [در خطوط لوله در دسترس نیست] \-\-overwrite آیا بازنویسی روی مجموعه داده خروجی موجود مجاز است [در خطوط لوله در دسترس نیست] \-\-output\-layer نام لایه خروجی (پیش‌فرض: footprint) \-b, \-\-band باند(های) ورودی (شاخص مبتنی بر 1) [تکرارپذیر] \-\-combine\-bands تعیین نحوه ترکیب باندهای ماسک باندهای انتخابی جهت تولید یک باند ماسک منفرد پیش از برداری‌سازی. COMBINE\-BANDS=union|intersection (پیش‌فرض: union) \-\-overview کدام سطح نمای کلی (overview) فایل منبع باید استفاده شود ناسازگار با \-\-input\-nodata \-\-input\-nodata تنظیم مقادیر nodata برای باندهای ورودی. [1.. values] ناسازگار با \-\-overview \-\-coordinate\-system سیستم مختصات مقصد. COORDINATE\-SYSTEM=georeferenced|pixel \-\-output\-crs سیستم مرجع مختصات (CRS) خروجی \-\-split\-multipolygons آیا چندضلعی‌های چندبخشی (multipolygons) به چندین عارضه که هرکدام دارای یک چندضلعی منفرد هستند تقسیم شوند \-\-convex\-hull آیا پوش محدب (convex hull) ردپا محاسبه شود \-\-densify\-distance حداکثر فاصله بین ۲ نقطه متوالی از هندسه خروجی. \-\-simplify\-tolerance میزان تلورانس برای ادغام نقاط متوالی از هندسه خروجی. \-\-min\-ring\-area حداقل مقدار برای مساحت یک حلقه \-\-max\-points حداکثر تعداد نقاط در هر هندسه خروجی (پیش‌فرض: 100) \-\-location\-field نام فیلدی که مسیر مجموعه داده ورودی در آن ذخیره خواهد شد. (پیش‌فرض: location) ناسازگار با \-\-no\-location\-field \-\-no\-location\-field غیرفعال کردن ایجاد فیلد حاوی مسیر مجموعه داده ورودی ناسازگار با \-\-location\-field \-\-absolute\-path آیا مسیر مجموعه داده ورودی به صورت یک مسیر مطلق ذخیره شود گزینه‌های پیشرفته (Advanced Options): \-\-oo, \-\-open\-option = گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-if, \-\-input\-format قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster footprint\fP ردپای یک فایل رستر را با در نظر گرفتن مقادیر داده‌نامعتبر (nodata) یا به طور کلی‌تر، باند ماسک متصل به باندهای رستر محاسبه می‌کند؛ چندضلعی‌ها یا چندضلعی‌های چندبخشی (polygons/multipolygons) متناظر با نواحی دارای پیکسل‌های معتبر را تولید کرده و آن‌ها را در یک فایل برداری خروجی می‌نویسد. .sp از نسخه 3.12 نرم‌افزار GDAL، این الگوریتم می‌تواند بخشی از یک \fI\%gdal pipeline\fP باشد\&. .sp ابزار \fBgdal raster clean\-collar\fP می‌تواند به عنوان یک مرحله پیش‌پردازش برای ایجاد باندهای ماسک مناسب اجرا شود. .INDENT 0.0 .INDENT 2.5 [تصویر] .UNINDENT .UNINDENT .sp نمونه‌ای از ردپای محاسبه‌شده با گزینه‌های پیش‌فرض \fBgdal raster footprint\fP\&. .sp عملیات هندسی پس از برداری‌سازی (Post\-vectorization) به ترتیب زیر اعمال می‌شوند: .INDENT 0.0 .IP \(bu 2 تفکیک اختیاری (\fI\%\-\-split\-multipolygons\fP) .IP \(bu 2 تراکم‌بخشی اختیاری (\fI\%\-\-densify\-distance\fP) .IP \(bu 2 بازپرتوافکنی اختیاری (\fI\%\-\-output\-crs\fP) .IP \(bu 2 فیلتر کردن اختیاری بر اساس حداقل مساحت حلقه (\fI\%\-\-min\-ring\-area\fP) .IP \(bu 2 اعمال اختیاری پوش محدب (\fI\%\-\-convex\-hull\fP) .IP \(bu 2 ساده‌سازی اختیاری (\fI\%\-\-simplify\-tolerance\fP) .IP \(bu 2 محدودسازی تعداد نقاط (\fI\%\-\-max\-points\fP) .UNINDENT .sp در نسخه 3.12 اضافه شد. .SH "خروجی GDALG (مجموعه داده درجا / جریانی)" .sp این برنامه از سریال‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. سپس فایل حاصل می‌تواند با استفاده از راه‌انداز (درایور) \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه داده برداری باز شود و خط لوله مشخص‌شده را به صورت درجا (on\-the\-fly) یا جریانی (streamed) اعمال کند. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 با این حال، این الگوریتم به صورت ذاتی با حالت جریانی سازگار نیست. در نتیجه، یک مجموعه داده موقت در حافظه (in\-memory) ایجاد خواهد شد که ممکن است هنگام باز شدن باعث صرف زمان پردازش قابل‌توجهی شود. .UNINDENT .UNINDENT .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-absolute\-path نوشتن مسیر مطلق مجموعه داده ورودی را فعال می‌کند. به‌طور پیش‌فرض، نام فایل دقیقاً همان‌طور که در خط فرمان مشخص شده است در فیلد موقعیت مکانی (location) نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-b, \-\-band انتخاب یک <باند> ورودی برای پردازش. شماره‌گذاری باندها از ۱ آغاز می‌شود. می‌توان از چندین سوییچ \fI\%\-b\fP برای انتخاب مجموعه‌ای از باندهای ورودی استفاده کرد. در صورت عدم تعیین، تمام باندها در نظر گرفته می‌شوند. نحوه ترکیب چندین باند توسط \fI\%\-\-combine\-bands\fP کنترل می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-combine\-bands union|intersection تعیین می‌کند که باندهای ماسک باندهای انتخابی، پیش از برداری‌سازی چگونه ترکیب شوند تا یک باند ماسک منفرد ایجاد گردد. مقدار پیش‌فرض \fBunion\fP (اجتماع) است: بدین معنا که یک پیکسل در صورتی معتبر خواهد بود که دست‌کم در یکی از باندهای انتخابی معتبر باشد. مقدار \fBintersection\fP (اشتراک) به این معناست که یک پیکسل تنها در صورتی معتبر است که در تمامی باندهای انتخابی معتبر باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-coordinate\-system pixel|georeferenced سیستم مختصات مقصد. به‌طور پیش‌فرض اگر مجموعه داده ورودی دارای زمین‌مرجع (georeferenced) باشد، مقدار \fBgeoreferenced\fP در نظر گرفته می‌شود؛ بدین معنی که هندسه ردپا به صورت مختصات در سیستم مرجع مختصات (CRS) رستر (یا سیستم مشخص‌شده با \fI\%\-\-output\-crs\fP) بیان خواهد شد. در صورت مشخص کردن \fBpixel\fP، مختصات هندسه ردپا به صورت شاخص‌های ستون و سطر (پیکسل) خواهند بود. .UNINDENT .INDENT 0.0 .TP .B \-\-convex\-hull در صورت تعیین این گزینه، پوش محدب چندضلعی‌ها (یا چندضلعی‌های چندبخشی) محاسبه می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-densify\-distance مقدار مشخص‌شده برای این گزینه، حداکثر فاصله بین ۲ نقطه متوالی از هندسه خروجی است. واحد این فاصله اگر \fI\%\-\-coordinate\-system\fP برابر \fBpixel\fP باشد بر حسب پیکسل، و در غیر این صورت بر حسب واحدهای زمین‌مرجع رستر منبع خواهد بود. این گزینه پیش از بازپرتوافکنی ناشی از \fI\%\-\-output\-crs\fP اعمال می‌شود\&. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-nodata تنظیم مقادیر داده‌نامعتبر (nodata) برای باندهای ورودی (می‌توان مقادیر متفاوتی برای هر باند ارائه داد). اگر یک مقدار منفرد مشخص شود، برای تمام باندهای انتخابی اعمال می‌گردد. در صورتی که بیش از یک مقدار ارائه شود، باید تعداد مقادیر برابر با تعداد باندهای انتخابی باشد، و تمام مقادیر باید در داخل کوتیشن (نقل‌قول) قرار گیرند تا به عنوان یک آرگومان منفرد به سیستم‌عامل فرستاده شوند. اگر این گزینه مشخص نشود، باند ماسک ذاتی هر یک از باندهای انتخابی استفاده خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-location\-field نام فیلد را در مجموعه داده برداری حاصل مشخص می‌کند که در آن مسیر مجموعه داده ورودی ذخیره خواهد شد. نام پیش‌فرض این فیلد \(dqlocation\(dq است. برای جلوگیری از نوشتن مسیر مجموعه داده ورودی، از گزینه \fI\%\-\-no\-location\-field\fP استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-points |unlimited حداکثر تعداد نقاط در هر هندسه خروجی (بدون احتساب نقطه پایانی هر حلقه که همیشه با نقطه ابتدایی یکسان است). مقدار پیش‌فرض 100 است. برای حذف این محدودیت می‌توان از مقدار \fBunlimited\fP استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-min\-ring\-area حداقل مقدار برای مساحت یک حلقه. واحد مساحت اگر \fI\%\-\-coordinate\-system\fP برابر با \fBpixel\fP باشد بر حسب پیکسل مربع، و در غیر این صورت بر حسب واحدهای زمین‌مرجع مجموعه داده برداری مقصد خواهد بود. این گزینه پس از بازپرتوافکنی ناشی از \fI\%\-\-output\-crs\fP اعمال می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-location\-field نوشتن مسیر مجموعه داده ورودی به عنوان یک فیلد در مجموعه داده برداری خروجی را غیرفعال می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-crs سیستم مرجع مختصات (CRS) مقصد فایل خروجی. مقدار می‌تواند هر یک از قالب‌های معمول GDAL/OGR، یک WKT کامل، PROJ.4، مقدار EPSG:n یا فایلی حاوی WKT باشد. مشخص کردن این گزینه مستلزم \fB\-\-coordinate\-system=georeferenced\fP است\&. ردپا از CRS رستر منبع به CRS مشخص‌شده بازپرتوافکنی (reproject) می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-layer نام لایه خروجی. پیش‌فرض \fBfootprint\fP است\&. .UNINDENT .INDENT 0.0 .TP .B \-\-overview مشخص کردن سطح نمای کلی (overview) فایل منبع که باید استفاده شود، در صورتی که نماهای کلی در رستر منبع موجود باشند. به‌طور پیش‌فرض، سطح وضوح کامل استفاده می‌شود. این شاخص بر پایه صفر است، یعنی 0 به معنای نخستین سطح نمای کلی می‌باشد. این گزینه با \fI\%\-\-input\-nodata\fP ناسازگار (مانعة‌الجمع) است\&. .UNINDENT .INDENT 0.0 .TP .B \-\-simplify\-tolerance مقدار مشخص‌شده برای این گزینه، میزان تلورانسی است که برای ادغام نقاط متوالی از هندسه خروجی با استفاده از متد \fI\%OGRGeometry::Simplify()\fP به کار می‌رود. واحد فاصله اگر \fI\%\-\-coordinate\-system\fP برابر \fBpixel\fP باشد بر حسب پیکسل، و در غیر این صورت بر حسب واحدهای زمین‌مرجع مجموعه داده برداری مقصد خواهد بود. این گزینه پس از بازپرتوافکنی ناشی از \fI\%\-\-output\-crs\fP اعمال می‌شود\&. .UNINDENT .INDENT 0.0 .TP .B \-\-split\-multipolygons در صورت مشخص شدن، چندضلعی‌های چندبخشی به چند عارضه مجزا شکسته می‌شوند که هر کدام تنها شامل یک چندضلعی منفرد خواهند بود. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append تعیین اینکه آیا افزودن عوارض به لایه(های) موجود مجاز است یا خیر. این گزینه همچنین در صورتی که مجموعه داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند. .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 \-\-lco, \-\-layer\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد لایه دارند که می‌توان از آن‌ها برای کنترل ویژگی‌های مربوط به لایه ایجادشده استفاده کرد. برای مثال، راه‌انداز GeoPackage از گزینه‌های ایجاد لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ایجاد لایه بسته به راه‌انداز قالب متفاوت هستند و برخی قالب‌های ساده اصلاً گزینه ایجاد لایه ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات آن قالب مرجع قطعی اطلاعات درباره گزینه‌های ایجاد لایه راه‌انداز است. برای گزینه‌های مجاز ایجاد لایه در هر قالب، مستندات اختصاصی قالب \fI\%Vector drivers\fP را ببینید. .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 vector | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد تا روی فایل یا مجموعه داده مقصد موجود بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض اگر فایل یا مجموعه داده مقصد از قبل وجود داشته باشد، \fBgdal\fP خطا می‌دهد. .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: نوشتن ردپای یک فایل GeoTIFF در یک فایل GeoJSON. .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster footprint my_raster.tif footprint.geojson .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .