.\" 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-SCALE" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-scale \- مقیاس‌بندی مقادیر باندهای یک مجموعه‌داده رستری .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster scale [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 \-\-ot, \-\-datatype, \-\-output\-data\-type نوع داده خروجی. OUTPUT\-DATA\-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 \-b, \-\-band انتخاب باند برای محدود کردن مقیاس‌بندی (شاخص با شروع از ۱) \-\-input\-min حداقل مقدار محدوده منبع وابسته به \-\-input\-max \-\-input\-max حداکثر مقدار محدوده منبع وابسته به \-\-input\-min \-\-output\-min حداقل مقدار محدوده مقصد وابسته به \-\-output\-max \-\-output\-max حداکثر مقدار محدوده مقصد وابسته به \-\-output\-min \-\-exponent نما برای اعمال مقیاس‌بندی غیرخطی با یک تابع توانی \-\-no\-clip برش نزدن مقادیر ورودی به [input\-min, input\-max] گزینه‌های پیشرفته: \-\-if, \-\-input\-format فرمت‌های ورودی [قابل تکرار] [در خط‌لوله‌ها در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [قابل تکرار] [در خط‌لوله‌ها در دسترس نیست] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster scale\fP می‌تواند برای تغییر مقیاس (rescale) مقادیر پیکسل‌های ورودی از محدوده \fI\%\-\-input\-min\fP تا \fI\%\-\-input\-max\fP به محدوده \fI\%\-\-output\-min\fP تا \fI\%\-\-output\-max\fP به کار رود. همچنین اغلب لازم است که نوع داده خروجی با سوئیچ \fI\%\-\-ot\fP بازنشانی شود. در صورت عدم تعیین، محدوده خروجی از حداقل مقدار تا حداکثر مقدار مجاز برای انواع داده عدد صحیح (برای مثال از 0 تا 255 برای خروجی Byte) یا از 0 تا 1 برای انواع داده ممیز شناور در نظر گرفته می‌شود. در صورت عدم تعیین، محدوده ورودی به طور خودکار از مجموعه‌داده منبع محاسبه می‌شود. این ممکن است یک عملیات کند روی یک مجموعه‌داده منبع بزرگ باشد، و اگر چندین بار برای فراخوانی‌های متعدد gdal_translate استفاده شود، فراخوانی قبلی \fBgdal raster edit \-\-stats {source_dataset}\fP برای پیش‌محاسبه آمارها در فرمت‌هایی که از ذخیره‌سازی محاسبات آماری پشتیبانی می‌کنند (GeoTIFF، VRT و...) می‌تواند سودمند باشد. مقادیر منبع به محدوده تعریف‌شده توسط \fBsrcmin\fP و \fBsrcmax\fP برش (clip) داده می‌شوند، مگر اینکه \fI\%\-\-no\-clip\fP تنظیم شده باشد. .sp به طور پیش‌فرض، مقیاس‌بندی روی تمامی باندها اعمال می‌شود. با استفاده از \fI\%\-\-band\fP می‌توان آن را به یک باند منفرد محدود کرد و مقادیر سایر باندها را دست‌نخورده باقی گذاشت. .sp این دستور عملیات معکوس \fI\%gdal raster unscale\fP است. .sp این زیردستور همچنین به عنوان یک مرحله بالقوه در \fI\%gdal raster pipeline\fP در دسترس است. .SH "خروجی GDALG (مجموعه داده برخط / استریم‌شده) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از فرمت خروجی \fBGDALG\fP پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به عنوان یک مجموعه‌داده رستری با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز کرد و پایپ‌لاین مشخص‌شده را به صورت بلادرنگ / جریانی (on\-the\-fly / streamed) اعمال نمود. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-b, \-\-band شاخص (با شروع از 1) باندی که مقیاس‌بندی باید تنها بر روی آن اعمال شود. .UNINDENT .INDENT 0.0 .TP .B \-\-exponent اعمال مقیاس‌بندی غیرخطی با یک تابع توانی. \fBexp_val\fP نمای تابع توانی است (باید مثبت باشد). این گزینه باید همراه با گزینه‌های \fI\%\-\-input\-min\fP / \fI\%\-\-input\-max\fP / \fI\%\-\-output\-min\fP / \fI\%\-\-output\-max\fP استفاده شود. .sp مقدار مقیاس‌بندی‌شده \fBDst\fP از مقدار منبع \fBSrc\fP با فرمول زیر محاسبه می‌شود: .sp .ce {Dst} = \eleft( {Dst}_{max} \- {Dst}_{min} \eright) \etimes \eoperatorname{max} \eleft( 0, \eoperatorname{min} \eleft( 1, \eleft( \efrac{{Src} \- {Src}_{min}}{{Src}_{max}\-{Src}_{min}} \eright)^{exp\e_val} \eright) \eright) + {Dst}_{min} .ce 0 .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 دستور \fI\%gdal raster unscale\fP مقیاس‌بندی خطی را فرض می‌کند و این کار نمی‌تواند مقادیر را به مقادیر اصلی بازگرداند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-input\-max حداکثر مقدار محدوده منبع. در صورت عدم تعیین، از مجموعه‌داده منبع محاسبه خواهد شد. این گزینه باید همراه با \fI\%\-\-input\-min\fP استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-min حداقل مقدار محدوده منبع. در صورت عدم تعیین، از مجموعه‌داده ورودی محاسبه خواهد شد. این گزینه باید همراه با \fI\%\-\-input\-max\fP استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-max حداکثر مقدار محدوده خروجی. این گزینه باید همراه با \fI\%\-\-output\-min\fP استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-min حداقل مقدار محدوده خروجی. این گزینه باید همراه با \fI\%\-\-output\-max\fP استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-clip غیرفعال کردن برش مقادیر ورودی به محدوده منبع. توجه داشته باشید که استفاده از این گزینه همراه با مقیاس‌بندی غیرخطی با یک نمای غیرصحیح باعث می‌شود مقادیر ورودی کمتر از حداقل مقدار محدوده منبع به صورت مقدار تعریف‌نشده (not\-a\-number) نگاشت شوند. .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 \-\-ot, \-\-datatype, \-\-output\-data\-type نوع داده خروجی از میان \fBByte\fP، \fBInt8\fP، \fBUInt16\fP، \fBInt16\fP، \fBUInt32\fP، \fBInt32\fP، \fBUInt64\fP، \fBInt64\fP، \fBCInt16\fP، \fBCInt32\fP، \fBFloat32\fP، \fBFloat64\fP، \fBCFloat32\fP و \fBCFloat64\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد فایل یا مجموعه‌داده هدف موجود را رونویسی کند. در غیر این صورت، به طور پیش‌فرض، در صورتی که فایل یا مجموعه‌داده هدف از قبل موجود باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: مقیاس‌بندی خطی مقادیر یک مجموعه‌داده UInt16 از [0,4095] به یک مجموعه‌داده Byte [0,255]" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster scale \-\-datatype Byte \-\-input\-min 0 \-\-input\-max 4095 uint16.tif byte.tif \-\-overwrite .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .