| GDAL_CREATE(1) | GDAL | GDAL_CREATE(1) |
نام (NAME)
gdal_create - ایجاد یک فایل رستر (بدون مجموعه داده منبع)
خلاصه دستور (SYNOPSIS)
Usage: gdal_create [--help] [--long-usage] [--help-general]
[-ot Byte|Int8|[U]Int{16|32|64}|CInt{16|32}|[C]Float{32|64}]
[-of <output_format>] [-outsize <xsize> <ysize>]
[-bands <count>] [-burn <value>]... [-a_srs <srs_def>]
[-a_ullr <ulx> <uly> <lrx> <lry>] [-a_nodata <value>]
[-mo <NAME>=<VALUE>]... [-co <NAME>=<VALUE>]... [--quiet]
[-if <input_dataset>]
<out_dataset>
توضیحات (DESCRIPTION)
ابزار gdal_create می‌تواند برای مقداردهی اولیه یک فایل رستر جدید بر اساس ابعاد، تعداد باندها و تنظیم پارامترهای گوناگون، مانند CRS، geotransform، مقدار nodata و متادیتا استفاده شود. همچنین می‌تواند در موارد خاص مانند ساخت یک فایل PDF از یک فایل ترکیب‌بندی XML به کار رود.
نکته:
ببینید gdal raster create.
- --help
- نمایش این پیام راهنما و خروج.
- --help-general
- نمایش یک پیام کاربرد مختصر برای گزینه‌های عمومی خط فرمان GDAL و خروج.
- -q, --quiet
- عدم نمایش پیام‌های پیشرفت و سایر خروجی‌های غیرخطا.
- -ot <type>
- اجبار باندهای تصویر خروجی به داشتن یک نوع داده مشخص که توسط درایور پشتیبانی می‌شود؛ که می‌تواند یکی از موارد زیر باشد: Byte، Int8، UInt16، Int16، UInt32، Int32، UInt64، Int64، Float32، Float64، CInt16، CInt32، CFloat32 یا CFloat64.
- -of <format>
- انتخاب قالب خروجی. در صورت عدم تعیین، قالب از روی پسوند حدس زده می‌شود. از نام کوتاه قالب استفاده کنید.
- -outsize <xsize> <ysize>
- تنظیم اندازه فایل خروجی بر حسب پیکسل. مقدار اول عرض و مقدار دوم ارتفاع است.
- -bands <count>
- تعداد باندها. در صورت مشخص شدن -outsize پیش‌فرض برابر با 1 و در غیر این صورت 0 است.
- -burn <value>
- یک مقدار ثابت برای درج (burn) در یک باند. می‌توان فهرستی از گزینه‌های -burn را ارائه کرد، یکی به ازای هر باند (مقدار اول روی باند اول اعمال می‌شود، مقدار دوم روی باند دوم، و غیره). اگر تنها یک مقدار مشخص شود، بر روی تمام باندها اعمال خواهد شد.
- -a_srs <srs_def>
- بازنویسی سیستم تصویر برای فایل خروجی. مقدار <srs_def> می‌تواند هر یک از حالت‌های معمول GDAL/OGR، ساختار کامل WKT، PROJ.4، EPSG:n یا فایلی حاوی WKT باشد. هیچ بازتصویرسازی‌ای (reprojection) انجام نمی‌شود.
- -a_ullr <ulx> <uly> <lrx> <lry>
- تخصیص مرزهای مکانیِ مختصات‌دار (georeferenced bounds) فایل خروجی.
- -a_nodata <value>
- اختصاص یک مقدار مشخص nodata به باندهای خروجی.
- -mo <META-TAG>=<VALUE>
- ارسال یک کلید و مقدار متادیتا برای اعمال روی مجموعه داده خروجی در صورت امکان.
- -co <NAME>=<VALUE>
- بسیاری از
قالب‌ها یک
یا چند
گزینه ساخت
(creation option) اختیاری
دارند که
می‌توانند
برای کنترل
ویژگی‌های
اختصاصی
فایل
ایجادشده
استفاده
شوند. برای
مثال،
درایور GeoTIFF از
گزینه‌های
ساخت برای
کنترل
فشرده‌سازی
و تعیین
این‌که آیا
فایل باید
به صورت
تایل‌بندی‌شده
(tiled) باشد،
پشتیبانی
می‌کند.
گزینه‌های ساخت موجود بسته به درایور قالب متغیر هستند، و برخی قالب‌های ساده اصولاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان --format مشاهده کرد، اما مستندات مربوط به قالب، منبع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. برای مشاهده گزینه‌های ساخت مجاز هر قالب، مستندات اختصاصی قالب را در بخش Raster drivers ببینید.
- -if <input_dataset>
- در نسخه 3.3
اضافه شد.
نام مجموعه داده ورودی GDAL که به عنوان الگو برای مقادیر پیش‌فرض گزینه‌های -outsize، -bands، -ot، -a_srs، -a_ullr و -a_nodata عمل می‌کند. توجه داشته باشید که مقادیر پیکسل‌ها کپی نخواهند شد.
- <out_dataset>
- نام فایل مقصد.
وضعیت خروج (EXIT STATUS)
این برنامه در صورت موفقیت کد وضعیت 0، و در صورت بروز خطا مقداری غیر از صفر بازمی‌گرداند (خطاهای غیرمسدودکننده‌ای که به صورت هشدار صادر می‌شوند، اجرای موفق در نظر گرفته می‌شوند).
مثال‌ها (EXAMPLES)
مثال ۱: مقداردهی اولیه یک فایل GeoTIFF جدید با مقدار یکنواخت 10
gdal_create -outsize 20 20 -a_srs EPSG:4326 -a_ullr 2 50 3 49 -burn 10 out.tif
مثال ۲: ایجاد یک فایل PDF از یک فایل ترکیب‌بندی XML
gdal_create -co COMPOSITION_FILE=composition.xml out.pdf
مثال ۳: مقداردهی اولیه یک فایل GeoTIFF خالی از روی یک فایل ورودی
gdal_create -if prototype.tif output.tif
نویسندگان (AUTHORS)
Even Rouault <even.rouault@spatialys.com>
کپی‌رایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |