| GDAL-RASTER-RESIZE(1) | GDAL | GDAL-RASTER-RESIZE(1) |
نام (NAME)
gdal-raster-resize - تغییر اندازه یک مجموعه داده رستر
افزوده‌شده در نگارش 3.11.
خلاصه دستور (SYNOPSIS)
کاربرد: gdal raster resize [گزینه‌ها] <INPUT> <OUTPUT>
تغییر اندازه یک مجموعه داده رستر بدون تغییر در محدوده‌های زمین‌مرجع (georeferenced extents).
آرگومان‌های موضعی:
-i, --input <INPUT> مجموعه داده‌های رستر ورودی [الزامی] [در خطوط لوله در دسترس نیست]
-o, --output <OUTPUT> مجموعه داده رستر خروجی [الزامی] [در خطوط لوله در دسترس نیست]
گزینه‌های عمومی:
-h, --help نمایش پیام راهنما و خروج
--json-usage نمایش شیوه استفاده به صورت سند JSON و خروج
--config <KEY>=<VALUE> گزینه پیکربندی [تکرارپذیر]
-q, --quiet حالت بی‌صدا (عدم نمایش نوار پیشرفت یا پیام‌های هشدار) [در خطوط لوله در دسترس نیست]
گزینه‌ها:
-f, --of, --format, --output-format <OUTPUT-FORMAT> قالب خروجی (مقدار "GDALG" مجاز است) [در خطوط لوله در دسترس نیست]
--co, --creation-option <KEY>=<VALUE> گزینه ایجاد [تکرارپذیر] [در خطوط لوله در دسترس نیست]
--overwrite آیا رونویسی روی مجموعه داده خروجی موجود مجاز است [در خطوط لوله در دسترس نیست]
ناسازگار با --append
--append افزودن به عنوان زیرمجموعه‌داده به خروجی موجود [در خطوط لوله در دسترس نیست]
ناسازگار با --overwrite
--resolution <xres>,<yres> تفکیک‌پذیری هدف (بر حسب واحدهای CRS مقصد)
ناسازگار با --size
--size <width[%]>,<height[%]> اندازه هدف بر حسب پیکسل (یا درصد در صورت استفاده از پسوند '%') [الزامی]
ناسازگار با --resolution
-r, --resampling <RESAMPLING> روش بازنمونه‌برداری. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|mode (پیش‌فرض: nearest)
گزینه‌های پیشرفته:
--if, --input-format <INPUT-FORMAT> قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست]
--oo, --open-option <KEY>=<VALUE> گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست]
توضیحات (DESCRIPTION)
دستور gdal raster resize می‌تواند برای تغییر اندازه یک مجموعه داده رستر بدون تغییر محدوده‌های زمین‌مرجع‌شده (georeferenced extents) استفاده شود.
این زیردستور همچنین به عنوان یک مرحله بالقوه از gdal raster pipeline در دسترس است.
خروجی GDALG (مجموعه داده پویا / جریانی)
این برنامه از سریال‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی GDALG پشتیبانی می‌کند. فایل حاصل می‌تواند سپس با استفاده از درایور GDALG: GDAL Streamed Algorithm به عنوان یک مجموعه داده رستر باز شود و خط لوله مشخص‌شده را به صورت پویا (on-the-fly) یا جریانی (streamed) اعمال نماید.
گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)
- -r, --resampling <RESAMPLING>
- روش
بازنمونه‌برداری
مورد
استفاده.
روش‌های
موجود
عبارتند از:
nearest: بازنمونه‌برداری نزدیک‌ترین همسایه (پیش‌فرض، سریع‌ترین الگوریتم، کمترین کیفیت میان‌یابی).
bilinear: بازنمونه‌برداری دوخطی.
cubic: بازنمونه‌برداری مکعبی.
cubicspline: بازنمونه‌برداری اسپلاین مکعبی.
lanczos: بازنمونه‌برداری پنجره‌ای سینک لانچوس.
average: بازنمونه‌برداری میانگین، میانگین وزن‌دار تمام پیکسل‌های مؤثر غیر-NODATA را محاسبه می‌کند.
- --resolution <xres>,<yres>
- افزوده‌شده
در نگارش 3.12.
تنظیم تفکیک‌پذیری فایل خروجی (بر حسب واحدهای زمین‌مرجع هدف).
با گزینه --size ناسازگار است.
- --size <width[%]>,<height[%]>
- تنظیم عرض و
ارتفاع
رستر
خروجی، بر
حسب پیکسل
یا در صورت
استفاده از
پسوند % بر
حسب درصد.
اگر عرض یا
ارتفاع روی
0 تنظیم
شود، بعد
دیگر از
تفکیک‌پذیری
محاسبه‌شده
حدس زده
خواهد شد.
با گزینه --resolution ناسازگار است.
گزینه‌های استاندارد (STANDARD OPTIONS)
- --append
- الحاق رستر ورودی به عنوان یک زیرمجموعه‌داده جدید به یک فایل خروجی موجود. فقط با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده پشتیبانی می‌کنند، مانند GTiff -- GeoTIFF File Format و GPKG -- GeoPackage raster. این گزینه همچنین در صورتی که مجموعه داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.
- --co, --creation-option <NAME>=<VALUE>
- بسیاری از
قالب‌ها یک
یا چند
گزینه
اختیاری
ایجاد
دارند که
می‌توان از
آن‌ها برای
کنترل
ویژگی‌های
خاص فایل
ایجادشده
استفاده
کرد. برای
نمونه،
درایور GeoTIFF از
گزینه‌های
ایجاد برای
کنترل
فشرده‌سازی
و تعیین
اینکه آیا
فایل باید
تایل‌بندی
شود یا خیر
پشتیبانی
می‌کند.
می‌تواند تکرار شود.
گزینه‌های ایجاد موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب مرجع قطعی اطلاعات درباره گزینه‌های ایجاد درایور است. برای گزینه‌های مجاز ایجاد هر قالب، به مستندات اختصاصی قالب در Raster drivers مراجعه کنید.
- --if, --input-format <format>
- نام
قالب/درایور
برای تلاش
جهت باز
کردن
فایل(های)
ورودی.
معمولاً
نیازی به
مشخص کردن
آن نیست،
اما
می‌توان از
آن برای
چشم‌پوشی
از تشخیص
خودکار
درایور، در
مواردی که
در انتخاب
درایور
مناسب
ناموفق است
استفاده
کرد. این
گزینه
می‌تواند
چندین بار
تکرار شود
تا چند
درایور
نامزد مشخص
گردند. توجه
داشته
باشید که
این گزینه
آن
درایورها
را مجبور به
باز کردن
مجموعه
داده
نمی‌کند.
به‌ویژه،
برخی
درایورها
نیازمندی‌هایی
درباره
پسوند فایل
دارند.
می‌تواند تکرار شود.
- --oo, --open-option <NAME>=<VALUE>
- گزینه باز
کردن
مجموعه
داده (مختص
هر قالب).
می‌تواند تکرار شود.
- -f, --of, --format, --output-format <OUTPUT-FORMAT>
- تعیین قالب رستر خروجی مورد استفاده. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: gdal --formats | grep raster | grep rw | sort
- --overwrite
- اجازه دادن به برنامه برای رونویسی روی فایل یا مجموعه داده هدف موجود. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه داده هدف از قبل وجود داشته باشد، gdal با خطا متوقف می‌شود.
کد وضعیت بازگشتی (RETURN STATUS CODE)
برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
مثال‌ها (EXAMPLES)
مثال ۱: تغییر اندازه یک مجموعه داده به ۱۰۰۰ ستون و ۵۰۰ سطر با استفاده از بازنمونه‌برداری مکعبی
$ gdal raster resize --size=1000,500 -r cubic in.tif out.tif --overwrite
مثال ۲: تغییر اندازه یک مجموعه داده به نصف اندازه با استفاده از بازنمونه‌برداری مکعبی
$ gdal raster resize --size=50%,50% -r cubic in.tif out.tif --overwrite
نویسنده (AUTHOR)
Even Rouault <even.rouault@spatialys.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |