GDAL_MERGE(1) GDAL GDAL_MERGE(1)

gdal_merge - موزاییک کردن مجموعه‌ای از تصاویر.

gdal_merge [--help] [--help-general]
              [-o <out_filename>] [-of <out_format>] [-co <NAME>=<VALUE>]...
              [-ps <pixelsize_x> <pixelsize_y>] [-tap] [-separate] [-q] [-v] [-pct]
              [-ul_lr <ulx> <uly> <lrx> <lry>] [-init "<value>[ <value>]..."]
              [-n <nodata_value>] [-a_nodata <output_nodata_value>]
              [-ot <datatype>] [-createonly] <input_file> [<input_file>]...

این ابزار به‌طور خودکار مجموعه‌ای از تصاویر را به‌صورت موزاییکی درمی‌آورد. تمام تصاویر باید در یک سامانهٔ مختصات یکسان بوده و تعداد باندهای برابری داشته باشند، اما می‌توانند هم‌پوشانی داشته و وضوح آن‌ها متفاوت باشد. در نواحی هم‌پوشانی، آخرین تصویر بر روی تصاویر قبلی رونویسی خواهد شد. مقادیر nodata/شفافیت (transparency) به‌صورت باند به باند در نظر گرفته می‌شوند؛ به این معنی که یک پیکسل nodata/شفاف در یک باند مبدأ، مقدار nodata/شفاف را روی تمام باندهای پیکسل مقصد در رستر حاصل اعمال نمی‌کند و همچنین مقادیر پیکسل‌های معتبر را بازنویسی نخواهد کرد.

نکته:

ابزار gdal_merge یک ابزار پایتونی است و تنها در صورتی در دسترس خواهد بود که بایندینگ‌های پایتون GDAL در دسترس باشند.

نکتهٔ کاربردی:

معادل در رابط خط فرمان جدید "gdal":

دستور gdal raster mosaic را ببینید.

نمایش این پیام راهنما و خروج.
--help-general
نمایش یک پیام راهنمای مختصر برای گزینه‌های عمومی خط فرمان GDAL و خروج.
نام فایل خروجی که در صورت عدم وجود، ایجاد خواهد شد (پیش‌فرض: "out.tif").
انتخاب قالب خروجی. در صورت عدم تعیین، قالب از روی پسوند فایل حدس زده می‌شود. از نام کوتاه قالب استفاده کنید.
بسیاری از قالب‌ها یک یا چند گزینهٔ اختیاری ساخت دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. برای نمونه، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و کاشی‌بندی (tiled) بودن فایل پشتیبانی می‌کند.

گزینه‌های ساخت موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینهٔ ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینهٔ خط فرمان --format مشاهده کرد، اما مستندات قالب، منبع موثق و نهایی اطلاعات دربارهٔ گزینه‌های ساخت درایور است. برای مشاهدهٔ گزینه‌های ساخت مجاز هر قالب، مستندات اختصاصی قالب Raster drivers را ببینید.

اجبار باندهای تصویر خروجی به داشتن نوع داده‌ای خاص که توسط درایور پشتیبانی می‌شود؛ این مقدار می‌تواند یکی از موارد روبرو باشد: Byte، Int8، UInt16، Int16، UInt32، Int32، UInt64، Int64، Float32، Float64، CInt16، CInt32، CFloat32 یا CFloat64.
اندازهٔ پیکسل مورد استفاده برای فایل خروجی. در صورت عدم تعیین، وضوح اولین فایل ورودی استفاده خواهد شد.
(پیکسل‌های هم‌تراز با هدف - target aligned pixels) مختصات محدودهٔ فایل خروجی را با مقادیر -tr تراز می‌کند، به‌گونه‌ای که محدودهٔ تراز‌شده شامل حداقل محدوده باشد. هم‌ترازی به این معنی است که مقادیر xmin / resx، ymin / resy، xmax / resx و ymax / resy اعدادی صحیح باشند.
محدودهٔ فایل خروجی. در صورت عدم تعیین، مجموع محدودهٔ همهٔ فایل‌های ورودی استفاده خواهد شد.
نادیده گرفتن پیام‌های پیشرفت.
تولید خروجی پرجزئیات (verbose) از عملیات موزاییک‌سازی به هنگام انجام آن‌ها.
قرار دادن هر فایل ورودی در یک باند مجزا.
دریافت یک جدول شبه‌رنگ (pseudo-color) از اولین تصویر ورودی و استفاده از آن برای خروجی. ادغام تصاویر شبه‌رنگی به این روش بر این فرض استوار است که همهٔ فایل‌های ورودی از جدول رنگ یکسانی استفاده می‌کنند.
نادیده گرفتن پیکسل‌هایی از فایل‌های در حال ادغام که دارای این مقدار پیکسل هستند.
اختصاص یک مقدار nodata مشخص به باندهای خروجی.
مقداردهی اولیهٔ باندهای تصویر خروجی با این مقادیر. با این حال، در فایل خروجی به عنوان مقدار nodata علامت‌گذاری نمی‌شود. اگر تنها یک مقدار داده شود، همان مقدار در تمام باندها به کار می‌رود.
فایل خروجی ایجاد شده (و احتمالاً از پیش مقداردهی اولیه می‌شود)، اما هیچ داده‌ای از تصاویر ورودی در آن کپی نمی‌شود.

این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز تلقی می‌گردند).

gdal_merge -init 255 -o out.tif in1.tif in2.tif

gdal_merge -init "0 0 255" -o out.tif in1.tif in2.tif

دو باند اول با مقدار 0 و باند سوم با مقدار 255 مقداردهی اولیه خواهند شد.

ls -1 *.tif > tiff_list.txt

می‌توان فهرست بزرگی از فایل‌ها را با فهرست کردن آن‌ها در یک فایل متنی با استفاده از دستور بالا در لینوکس، یا:

dir /b /s *.tif > tiff_list.txt

در ویندوز، به gdal_merge ارسال کرد. سپس می‌توان فایل متنی را با استفاده از --optfile به gdal_merge منتقل کرد:

gdal_merge -o mosaic.tif --optfile tiff_list.txt

عملیات «ادغام از طریق پشته‌سازی» (merging by stacking) را با پرچم -separate انجام دهید. با فرض داشتن سه فایل مقیاس خاکستری که یک محدوده را پوشش می‌دهند، می‌توانید دستور زیر را اجرا کنید:

gdal_merge -separate 1.tif 2.tif 3.tif -o rgb.tif

این دستور 1.tif را به قرمز، 2.tif را به سبز و 3.tif را به آبی نگاشت می‌کند.

آخرین تصویر در خط ورودی، در بالای پشتهٔ تصویر نهایی قرار می‌گیرد. همچنین ممکن است برای مشخص کردن مقداری که اگر از قبل به عنوان nodata تعریف نشده است نباید در تصویر مقصد کپی شود، نیاز به استفاده از -n داشته باشید.

gdal_merge -o merge.tif -n 0 image1.tif image2.tif image3.tif image4.tif

Frank Warmerdam <warmerdam@pobox.com>, Silke Reimer <silke@intevation.de>

1998-2026

August 18, 2026