GDAL_RASTERIZE(1) GDAL GDAL_RASTERIZE(1)

gdal_rasterize - حک کردن هندسه‌های برداری درون یک رستر.

Usage: gdal_rasterize [--help] [--long-usage] [--help-general]
                      [-b <band>]... [-i] [-at]
                      [[-burn <value>]...|[-a <attribute_name>]|[-3d]]
                      [-add]
                      [[-l <layer_name>]...|[-sql <sql_statement>]]
                      [-where <expression>] [-dialect <sql_dialect>]
                      [-a_nodata <value>] [-init <value>]... [-a_srs <srs_def>]
                      [-to <NAME>=<VALUE>]... [-te <xmin> <ymin> <xmax> <ymax>]
                      [[-tr <xres> <yres>]|[-ts <width> <height>]]
                      [-tap] [-optim AUTO|VECTOR|RASTER] [-co <NAME>=<VALUE>]...
                      [-ot Byte|Int8|[U]Int{16|32|64}|CInt{16|32}|[C]Float{32|64}]
                      [-of <output_format>] [--quiet] [-oo <NAME>=<VALUE>]...
                      <src_datasource> <dst_filename>

این برنامه هندسه‌های برداری (نقطه‌ها، خطوط و چندضلعی‌ها) را در باند(های) یک تصویر رستری حک (رستریزه) می‌کند. داده‌های برداری از قالب‌های برداری پشتیبانی‌شده توسط OGR خوانده می‌شوند. اگر رستر خروجی از قبل وجود داشته باشد، پیکسل‌های تغییریافته به‌صورت درجا (in-place) به‌روزرسانی می‌شوند.

تغییر سیستم مختصات بی‌درنگ (On the fly) داده‌های برداری به سیستم مختصات داده‌های رستری پشتیبانی می‌شود.

نکته:

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

دستور gdal vector rasterize را ببینید.

نمایش این پیام راهنما و خروج
--help-general
نمایش پیام کوتاه راهنما برای گزینه‌های عمومی خط فرمان GDAL و خروج.
نادیده گرفتن پیام‌های پیشرفت و سایر خروجی‌های غیرخطا.
باند(هایی) که مقادیر باید در آن‌ها حک شوند. می‌توان از چندین آرگومان -b برای حک کردن در فهرستی از باندها استفاده کرد. پیش‌فرض حک کردن در باند ۱ است. هنگام ایجاد یک رستر جدید استفاده نمی‌شود.
معکوس کردن رستری‌سازی. مقدار ثابت یا مقدار مرتبط با اولین عارضه در تمام بخش‌هایی از تصویر که درون چندضلعی مشخص‌شده نیستند، حک می‌شود.

نکته:

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

نکته:

هنگامی که این گزینه فعال است، ترتیب عوارض ورودی (خطوط یا چندضلعی‌ها) می‌تواند بر نتایج تأثیر بگذارد. زمانی که دو عارضه یکدیگر را لمس می‌کنند، آخرین عارضه (یعنی بالاترین) مقدار پیکسل حک‌شده در لبه را تعیین می‌کند. ممکن است بخواهید از گزینه -sql برای مرتب‌سازی مجدد عوارض (ORDER BY) به منظور دستیابی به نتیجه‌ای قابل‌پیش‌بینی‌تر استفاده کنید.
یک مقدار ثابت برای حک شدن در یک باند برای تمامی اشیاء. می‌توان فهرستی از گزینه‌های -burn را ارائه داد؛ یک گزینه به ازای هر باندی که در آن نوشته می‌شود.
یک فیلد ویژگی (attribute) را روی عوارض مشخص می‌کند تا به عنوان مقدار حک‌کردن استفاده شود. این مقدار در تمامی باندهای خروجی حک خواهد شد.
-3d
نشان می‌دهد که مقدار حک‌کردن باید از مقادیر "Z" عارضه استخراج شود. برای نقطه‌ها و خطوط کار می‌کند (درون‌یابی خطی در طول هر پاره‌خط). برای چندضلعی‌ها، تنها در صورتی به‌درستی کار می‌کند که مسطح باشند (مقدار Z یکسان برای همه رأس‌ها).
به‌جای حک کردن یک مقدار جدید، مقدار جدید را به رستر موجود اضافه می‌کند. برای مثال برای نقشه‌های حرارتی (heatmaps) مناسب است.
لایه(هایی) از منبع داده را مشخص می‌کند که برای عوارض ورودی استفاده خواهند شد. می‌تواند چندین بار مشخص شود، اما حداقل یک نام لایه یا یک گزینه -sql باید مشخص شود (نه هر دو).
یک عبارت پرس‌وجوی اختیاری به سبک WHERE در SQL برای اعمال جهت انتخاب عوارضی که باید از لایه(های) ورودی حک شوند.
یک دستور SQL که روی منبع داده ارزیابی می‌شود تا یک لایه مجازی از عوارض برای حک شدن تولید کند. از نسخه 3.7 GDAL به بعد، نحو @filename می‌تواند برای مشخص کردن اینکه محتوا در نام فایل اشاره‌شده قرار دارد، استفاده شود.

نکته:

اگر گزینه -l نیز تنظیم شده باشد، این گزینه نادیده گرفته خواهد شد.
-dialect <dialect> لهجهٔ SQL. در برخی موارد می‌توان با مقداردهی OGRSQL، از OGR SQL (بهینه‌سازی‌نشده) به‌جای SQL بومی یک RDBMS استفاده کرد. لهجهٔ "SQLITE" نیز می‌تواند با هر منبع داده‌ای استفاده شود.
انتخاب قالب خروجی. در صورت مشخص نشدن، قالب از روی پسوند حدس زده می‌شود. از نام کوتاه قالب استفاده کنید.
اختصاص یک مقدار nodata مشخص‌شده به باندهای خروجی.
مقداردهی اولیهٔ باندهای تصویر خروجی با این مقادیر. با این حال، در فایل خروجی به عنوان مقدار nodata علامت‌گذاری نمی‌شود. اگر تنها یک مقدار داده شود، همان مقدار در تمام باندها استفاده می‌شود.
جایگزینی سیستم تصویر برای فایل خروجی. در صورت مشخص نشدن، از سیستم تصویر فایل برداری ورودی در صورت وجود استفاده خواهد شد. هنگام استفاده از این گزینه، هیچ بازتصویرسازی برای عوارض از SRS بردار ورودی به SRS مشخص‌شده برای رستر خروجی صورت نمی‌گیرد؛ بنابراین تنها برای تصحیح یک SRS مبدأ نامعتبر از این گزینه استفاده کنید. مقدار <srs_def> می‌تواند هر یک از قالب‌های معمول GDAL/OGR، یعنی WKT کامل، PROJ.4، EPSG:n یا فایلی حاوی WKT باشد.
تنظیم یک گزینهٔ تبدیل‌کننده مناسب برای ارسال به GDALCreateGenImgProjTransformer2(). این گزینه هنگام تبدیل مختصات هندسه‌ها به فضای پیکسلی رستر مقصد استفاده می‌شود. برای مثال، این مورد می‌تواند برای تعیین گزینه‌های تبدیل‌کنندهٔ مرتبط با RPC استفاده شود.
بسیاری از قالب‌ها یک یا چند گزینهٔ ایجاد اختیاری دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. برای نمونه، درایور GeoTIFF از گزینه‌های ایجادی برای کنترل فشرده‌سازی و کاشی‌بندی شدن فایل پشتیبانی می‌کند.

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

تنظیم محدوده‌های زمین‌مرجع‌شده. مقادیر باید بر حسب واحدهای زمین‌مرجع بیان شوند. در صورت مشخص نشدن، محدودهٔ فایل خروجی همان محدودهٔ لایه‌های برداری خواهد بود.
تنظیم تفکیک‌پذیری مقصد. مقادیر باید بر حسب واحدهای زمین‌مرجع بیان شوند. هر دو باید مقادیری مثبت باشند.
(target aligned pixels) هم‌تراز کردن مختصات محدودهٔ فایل خروجی با مقادیر -tr، به‌گونه‌ای که محدودهٔ هم‌تراز‌شده شامل حداقل محدوده باشد. هم‌ترازی بدین معناست که xmin / resx، ymin / resy، xmax / resx و ymax / resy مقادیری صحیح باشند.
تنظیم اندازهٔ فایل خروجی بر حسب پیکسل و سطر. توجه داشته باشید که -ts را نمی‌توان همراه با -tr استفاده کرد. اگر یکی از دو مقدار روی 0 تنظیم شود، به منظور حفظ نسبت ابعاد، از روی مقدار دیگر محاسبه خواهد شد.
اجبار باندهای خروجی به داشتن نوع دادهٔ مشخص‌شده. مقدار پیش‌فرض Float64 است، مگر اینکه فیلد مشخصه برای درج از نوع Int64 باشد؛ در این حالت اگر درایور خروجی از آن پشتیبانی کند، Int64 برای نوع دادهٔ رستر خروجی استفاده می‌شود.
اجبار الگوریتم مورد استفاده (نتایج یکسان هستند). حالت رستر در بیشتر موارد استفاده می‌شود و عملیات خواندن/نوشتن را بهینه‌سازی می‌کند. حالت برداری با حجم بالایی از عوارض ورودی مفید است و مصرف پردازنده را بهینه‌سازی می‌کند، به شرطی که تصویر خروجی کاشی‌بندی شده باشد. حالت خودکار (پیش‌فرض) الگوریتم را بر اساس مشخصات ورودی و خروجی انتخاب می‌کند.
در نگارش 3.7 اضافه شده است.

گزینهٔ باز کردن مجموعه داده مبدأ (مختص به هر قالب)

<src_datasource>
هر منبع دادهٔ خواندنی که توسط OGR پشتیبانی می‌شود.
<dst_filename>
فایل خروجی پشتیبانی‌شده توسط GDAL. باید از دسترسی در حالت به‌روزرسانی پشتیبانی کند. اگر این فایل از قبل وجود نداشته باشد، ایجاد خواهد شد. اگر رستر خروجی از قبل موجود باشد، پیکسل‌های متأثر در جای خود به‌روزرسانی می‌شوند.

این برنامه در صورت استفاده از هر یک از گزینه‌های -of، -a_nodata، -init، -a_srs، -co، -te، -tr، -tap، -ts یا -ot، یک تصویر رستری مقصد جدید ایجاد می‌کند. تفکیک‌پذیری یا اندازه برای تمام رسترهای جدید باید با استفاده از گزینهٔ -tr یا -ts مشخص شود. اگر رستر مقصد از قبل موجود باشد و هر یک از این گزینه‌های مربوط به ایجاد استفاده شوند، رستر مقصد بازنویسی خواهد شد..SH "کد وضعیت بازگشتی (RETURN STATUS CODE)"

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

این ابزار همچنین از طریق GDALRasterize() در C قابل فراخوانی است.

دستور زیر تمام چندضلعی‌ها را از mask.shp با رنگ قرمز (RGB = 255,0,0) بر روی فایل TIFF از نوع RGB به نام work.tif حک می‌کند.

gdal_rasterize -b 1 -b 2 -b 3 -burn 255 -burn 0 -burn 0 -l mask mask.shp work.tif

دستور زیر تمام ساختمان‌های "class A" را درون فایل ارتفاعی خروجی حک می‌کند و بالاترین ارتفاع را از مشخصهٔ ROOF_H دریافت می‌نماید.

gdal_rasterize -a ROOF_H -where "class='A'" -l footprints footprints.shp city_dem.tif

دستور زیر تمام چندضلعی‌ها را از footprint.shp با رنگ قرمز درون یک فایل TIFF جدید 1000x1000 با فرمت RGB حک می‌کند. توجه داشته باشید که از -b استفاده نشده است؛ ترتیب گزینه‌های -burn باندهای رستر خروجی را تعیین می‌کند.

gdal_rasterize -burn 255 -burn 0 -burn 0 -ot Byte -ts 1000 1000 -l footprints footprints.shp mask.tif

Frank Warmerdam <warmerdam@pobox.com>

1998-2026

August 18, 2026