.\" 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-CLIP" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-clip \- برش دادن یک مجموعه داده رستر .sp افزوده‌شده در نگارش 3.11. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal raster clip [گزینه‌ها] برش دادن یک مجموعه داده رستر. آرگومان‌های موضعی: \-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 \-\-bbox جعبه محدودکننده برش به صورت xmin,ymin,xmax,ymax ناسازگار با \-\-window، \-\-geometry، \-\-like \-\-bbox\-crs سامانه مرجع مختصات (CRS) برای جعبه محدودکننده برش \-\-window پنجره رستر به صورت col,line,width,height بر حسب پیکسل ناسازگار با \-\-bbox، \-\-geometry، \-\-like \-\-geometry هندسه برش (WKT یا GeoJSON) ناسازگار با \-\-bbox، \-\-window، \-\-like \-\-geometry\-crs سامانه مرجع مختصات (CRS) هندسه برش \-\-like مجموعه داده برای استفاده به عنوان الگو برای محدوده‌ها ناسازگار با \-\-bbox، \-\-window، \-\-geometry \-\-like\-sql عبارت SELECT برای اجرا روی مجموعه داده \(aqlike\(aq ناسازگار با \-\-like\-where \-\-like\-layer نام لایه از مجموعه داده \(aqlike\(aq \-\-like\-where بند WHERE در SQL برای اجرا روی مجموعه داده \(aqlike\(aq ناسازگار با \-\-like\-sql \-\-only\-bbox برای \(aqgeometry\(aq و \(aqlike\(aq، فقط جعبه محدودکننده در نظر گرفته شود \-\-allow\-bbox\-outside\-source اجازه دادن به جعبه برش جهت در بر گرفتن پیکسل‌های خارج از مجموعه داده ورودی \-\-add\-alpha افزودن یک باند ماسک آلفا به مقصد در صورتی که رستر مبدأ فاقد آن باشد. گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster clip\fP می‌تواند برای برش دادن یک مجموعه داده رستر با استفاده از مختصات زمین‌مرجع (georeferenced) استفاده شود. .sp باید حداقل یکی از گزینه‌های \fI\%\-\-bbox\fP یا \fI\%\-\-like\fP مشخص شود. .sp مجموعه داده خروجی در همان SRS مجموعه داده ورودی خواهد بود و وضوح (resolution) اصلی حفظ می‌شود. محدوده‌ها برای تطابق با موقعیت‌های کامل پیکسل گرد می‌شوند (به این معنی که هیچ بازنمونه‌گیری یا resampling انجام نمی‌شود). .sp دستور \fBclip\fP همچنین می‌تواند به عنوان یک مرحله از \fI\%gdal raster pipeline\fP به کار رود. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-add\-alpha افزودن یک باند ماسک آلفا به مقصد در صورتی که رستر مبدأ فاقد آن باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-allow\-bbox\-outside\-source در صورت تنظیم، اجازه می‌دهد محدوده‌های تعیین‌شده توسط \fI\%\-\-bbox\fP وسعتی فراتر از مجموعه داده ورودی را پوشش دهند. پیکسل‌های خروجی در نواحی خارج از وسعت ورودی برابر با صفر یا مقدار NoData مجموعه داده ورودی تنظیم خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-bbox ,,, محدوده‌هایی که مجموعه داده باید بر اساس آن‌ها برش داده شود. فرض می‌شود که این مختصات در CRS مجموعه داده ورودی هستند، مگر آنکه \fI\%\-\-bbox\-crs\fP مشخص شده باشد. محورهای X و Y بر اساس محورهای مرسوم در GIS هستند، به این معنی که X طول جغرافیایی (یا مختصات شرقی) و Y عرض جغرافیایی (یا مختصات شمالی) است. در صورت نیاز، محدوده‌ها برای تطابق با مرزهای پیکسل ورودی بسط داده می‌شوند. به صورت پیش‌فرض، اگر محدوده‌های تعیین‌شده با \fI\%\-\-bbox\fP بزرگ‌تر از وسعت مجموعه داده ورودی باشند، \fBgdal raster clip\fP با خطا متوقف می‌شود. با استفاده از \fI\%\-\-allow\-bbox\-outside\-source\fP می‌توان از این بررسی صرف‌نظر کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-bbox\-crs سامانه مرجع مختصاتی (CRS) که مقادیر ,,, گزینه \fI\%\-\-bbox\fP بر حسب آن بیان شده‌اند. در صورت عدم تعیین، فرض می‌شود که همان CRS مجموعه داده ورودی است. توجه داشته باشید که تعیین \fI\%\-\-bbox\-crs\fP باعث بازپروژکشن (reprojection) رستر نمی‌شود. در عوض، محدوده‌ها از bbox\-crs به CRS مجموعه داده ورودی بازپروژکشن می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-geometry هندسه به صورت یک رشته WKT یا GeoJSON از یک چندضلعی (یا چندضلعی چندگانه) که مجموعه داده باید بر اساس آن برش داده شود. نواحی رستر که درون جعبه محدودکننده هندسه قرار دارند اما داخل خود هندسه نیستند، برابر با مقدار NoData رستر یا در صورت عدم وجود آن برابر با 0 تنظیم می‌شوند. تمام پیکسل‌هایی که با هندسه هم‌پوشانی دارند انتخاب خواهند شد. اگر هندسه ورودی از نوع GeoJSON باشد، فرض می‌شود که CRS آن WGS84 است، مگر آنکه یک CRS در داخل هندسه GeoJSON تعریف شده باشد یا گزینه \fI\%\-\-geometry\-crs\fP مشخص گردد. اگر هندسه ورودی WKT باشد، فرض می‌شود که CRS آن همان CRS مجموعه داده ورودی است، مگر آنکه \fI\%\-\-geometry\-crs\fP مشخص شود. محورهای X و Y بر اساس محورهای مرسوم GIS هستند؛ یعنی X طول جغرافیایی یا مختصات شرقی، و Y عرض جغرافیایی یا مختصات شمالی است. ناسازگار با \fI\%\-\-bbox\fP و \fI\%\-\-like\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-geometry\-crs سامانه مرجع مختصاتی (CRS) که مقادیر مختصات \fI\%\-\-geometry\fP بر حسب آن بیان شده‌اند. در صورت عدم تعیین، فرض می‌شود همان CRS مجموعه داده ورودی است. محدوده‌ها از geometry\-crs به CRS مجموعه داده ورودی بازپروژکشن می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-like مجموعه داده برداری یا رستر برای استفاده به عنوان الگو برای محدوده‌ها. اگر مجموعه داده مشخص‌شده یک رستر باشد، محدوده‌های مستطیلی آن به عنوان هندسه برش استفاده می‌شود. اگر مجموعه داده مشخص‌شده یک مجموعه داده برداری باشد، هندسه‌های چندضلعی آن با یکدیگر ترکیب (union) می‌شوند تا هندسه برش تشکیل شود. اگر چندین لایه وجود داشته باشد، باید \fI\%\-\-like\-sql\fP یا \fI\%\-\-like\-layer\fP مشخص شود. نواحی رستر درون جعبه محدودکننده هندسه که داخل خود هندسه قرار ندارند، برابر با مقدار NoData رستر، یا 0 در صورت عدم وجود آن تنظیم خواهند شد. ناسازگار با \fI\%\-\-bbox\fP و \fI\%\-\-geometry\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-like\-layer انتخاب لایه نام‌برده از مجموعه داده برش برداری. ناسازگار با \fI\%\-\-like\-sql\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-like\-sql انتخاب هندسه‌های مورد نظر از مجموعه داده برش برداری با استفاده از یک پرسمان SQL. مانند \fBSELECT geom FROM my_layer WHERE country = \(aqFrance\(aq\fP\&. گویش SQL مورد استفاده، گویش پیش‌فرض مجموعه داده \fBlike\fP خواهد بود (OGR SQL برای Shapefile، و SQLite برای GeoPackage، و PostgreSQL برای PostGIS و غیره). ناسازگار با \fI\%\-\-like\-layer\fP و \fI\%\-\-like\-where\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-like\-where محدود کردن هندسه‌های مورد نظر از لایه مجموعه داده برش برداری بر اساس یک پرسمان مشخصه (attribute query). مانند \fBcountry = \(aqFrance\(aq\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-only\-bbox برای گزینه‌های \fI\%\-\-geometry\fP و \fI\%\-\-like\fP، تنها جعبه محدودکننده هندسه در نظر گرفته شود. .UNINDENT .INDENT 0.0 .TP .B \-\-window ,,, افزوده‌شده در نگارش 3.12. .sp انتخاب یک زیرپنجره از تصویر مبدأ برای کپی کردن بر اساس موقعیت پیکسل/سطر. فاصله‌های پیکسل/سطر (\fBcolumn\fP و \fBline\fP) از سمت چپ و بالای تصویر سنجیده می‌شوند. اگر زیرپنجره به خارج از محدوده‌های مجموعه داده مبدأ امتداد یابد، پیکسل‌های خروجی با مقدار صفر نوشته خواهند شد، مگر اینکه مقدار NoData در مجموعه داده مبدأ تعریف شده باشد. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد دارند که می‌توان از آن‌ها برای کنترل ویژگی‌های خاص فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ایجاد برای کنترل فشرده‌سازی و تعیین اینکه آیا فایل باید تایل‌بندی (کاشی‌کاری) شود یا خیر پشتیبانی می‌کند. .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 \-f, \-\-of, \-\-format, \-\-output\-format تعیین قالب رستر خروجی مورد استفاده. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: \fBgdal \-\-formats | grep raster | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه داده (مختص هر قالب). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite اجازه دادن به برنامه برای رونویسی روی فایل یا مجموعه داده مقصد موجود. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه داده مقصد از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار ارسال می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: برش دادن یک فایل GeoTIFF به جعبه محدودکننده از طول جغرافیایی 2، عرض جغرافیایی 49 تا طول جغرافیایی 3، عرض جغرافیایی 50 در WGS 84 .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster clip \-\-bbox=2,49,3,50 \-\-bbox\-crs=EPSG:4326 in.tif out.tif \-\-overwrite .EE .UNINDENT .UNINDENT .SS مثال ۲: برش دادن یک فایل GeoTIFF با استفاده از محدوده‌های reference.tif .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster clip \-\-like=reference.tif in.tif out.tif \-\-overwrite .EE .UNINDENT .UNINDENT .SS مثال ۳: برش دادن یک فایل GeoTIFF از ستون رستر 1000 و سطر 2000، با عرض 500 پیکسل و ارتفاع 600 پیکسل .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster clip \-\-window=1000,2000,500,600 in.tif out.tif \-\-overwrite .EE .UNINDENT .UNINDENT .SS مثال ۴: برش دادن یک GeoTIFF با استفاده از یک جعبه محدودکننده که فراتر از وسعت مبدأ امتداد دارد و نوشتن نتیجه به عنوان یک COG .sp استفاده از \fB\-\-allow\-bbox\-outside\-source\fP برای جلوگیری از خطای \fBERROR 1: Computed source window \-180 2943 6269 6235 falls partially outside source raster extent\fP هنگامی که جعبه محدودکننده از وسعت رستر فراتر می‌رود. .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster clip \e \-\-bbox=3757032.814272985,\-626172.1357121654,4383204.9499851465,0 \e \-\-bbox\-crs=EPSG:3857 \e \-\-allow\-bbox\-outside\-source \e in.tif out.tif \e \-\-overwrite \e \-\-output\-format COG .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .