.\" 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-CREATE" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-create \- ایجاد یک مجموعه‌داده رستر جدید .sp افزوده‌شده در نسخه 3.11. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster create [OPTIONS] ایجاد یک مجموعه‌داده رستر جدید. آرگومان‌های مکانی: \-o, \-\-output مجموعه‌داده رستر خروجی [الزامی] [در خطوط لوله در دسترس نیست] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده در قالب سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست] گزینه‌ها: \-i, \-\-like, \-\-input مجموعه‌داده رستر الگو [در خطوط لوله در دسترس نیست] \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (مقدار \(dqGDALG\(dq مجاز است) [در خطوط لوله در دسترس نیست] \-\-co, \-\-creation\-option = گزینه ایجاد [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-overwrite امکان بازنویسی مجموعه‌داده خروجی موجود [در خطوط لوله در دسترس نیست] ناسازگار با \-\-append \-\-append الحاق به عنوان زیرمجموعه‌داده به خروجی موجود [در خطوط لوله در دسترس نیست] ناسازگار با \-\-overwrite \-\-size , اندازه خروجی بر حسب پیکسل \-\-band\-count تعداد باندها (پیش‌فرض: 1) \-\-ot, \-\-datatype, \-\-output\-data\-type نوع داده خروجی. OUTPUT\-DATA\-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 (پیش‌فرض: Byte) \-\-nodata انتساب یک مقدار nodata مشخص به باندهای خروجی (\(aqnone\(aq، مقدار عددی، \(aqnan\(aq، \(aqinf\(aq، \(aq\-inf\(aq) \-\-burn مقدار ثبت / سوزاندن (burn value) [تکرارپذیر] \-\-crs تنظیم CRS \-\-bbox جعبه محدودکننده به صورت xmin,ymin,xmax,ymax \-\-metadata = افزودن آیتم متادیتا [تکرارپذیر] \-\-copy\-metadata کپی متادیتا از مجموعه‌داده ورودی وابسته به \-\-input \-\-copy\-overviews ایجاد سطوح پیش‌نمایش مشابه مجموعه‌داده ورودی وابسته به \-\-input گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster create\fP می‌تواند برای مقداردهی اولیه یک فایل رستر جدید بر اساس ابعاد، تعداد باند، CRS، تبدیل زمین‌مرجع (geotransform)، مقدار nodata و متادیتای آن استفاده شود. .sp همچنین می‌توان فایل جدید را از یک فایل ورودی الگو با استفاده از گزینه اختیاری \fI\%\-\-like\fP مقداردهی کرد، که ویژگی‌های آن را بدون کپی کردن مقادیر پیکسل‌ها کپی می‌کند. به طور پیش‌فرض، متادیتا و ساختار پیش‌نمایش (overview) از فایل الگوی ورودی کپی نمی‌شوند، مگر اینکه گزینه‌های \fI\%\-\-copy\-metadata\fP و \fI\%\-\-copy\-overviews\fP مشخص شده باشند. گزینه‌های \fI\%\-\-size\fP، \fI\%\-\-band\-count\fP، \fI\%\-\-datatype\fP، \fI\%\-\-nodata\fP، \fI\%\-\-crs\fP، \fI\%\-\-bbox\fP و \fI\%\-\-metadata\fP می‌توانند برای لغو مقادیر به ارث رسیده از فایل الگوی ورودی استفاده شوند. .sp برای خروجی GeoTIFF، تنظیم گزینه ایجاد \fBSPARSE_OK\fP به \fBYES\fP می‌تواند برای ایجاد فایلی با حداقل اندازه مفید باشد. .sp دستور \fBgdal raster create\fP همچنین در موارد خاصی مانند ایجاد یک فایل PDF از روی یک فایل ترکیب XML قابل استفاده است. .sp از نسخه GDAL 3.13 به بعد، \fBcreate\fP می‌تواند به عنوان یک مرحله از \fI\%gdal raster pipeline\fP نیز به کار رود. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-band\-count تعداد باندها. پیش‌فرض 1 است. .UNINDENT .INDENT 0.0 .TP .B \-\-bbox ,,, تنظیم جعبه محدودکننده مکانی، بر حسب واحدهای CRS. \(aqx\(aq مقادیر طول جغرافیایی برای CRS جغرافیایی و مختصات شرقی برای CRS تصویرشده است. \(aqy\(aq مقادیر عرض جغرافیایی برای CRS جغرافیایی و مختصات شمالی برای CRS تصویرشده است. .UNINDENT .INDENT 0.0 .TP .B \-\-burn یک مقدار ثابت جهت ثبت و سوزاندن (burn) در یک باند. فهرستی از گزینه‌های \fI\%\-\-burn\fP می‌تواند ارائه شود، به ازای هر باند یک مقدار (مقدار اول روی باند اول، مقدار دوم روی باند دوم و غیره اعمال می‌شود). اگر یک مقدار واحد مشخص شود، روی تمامی باندها اعمال خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-copy\-metadata کپی متادیتا از مجموعه‌داده ورودی و باندهای رستر. نیازمند مشخص شدن \fI\%\-\-like\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-copy\-overviews ایجاد سطوح پیش‌نمایش مشابه مجموعه‌داده ورودی (اما با محتوای خالی). نیازمند مشخص شدن \fI\%\-\-like\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-crs تنظیم سامانه مرجع مختصات (CRS). .sp سامانه‌های مرجع مختصاتی که می‌توانند ارسال شوند شامل هر موردی است که توسط فراخوانی \fI\%OGRSpatialReference::SetFromUserInput()\fP پشتیبانی می‌شود، که دربرگیرنده CRS تصویرشده EPSG، جغرافیایی یا ترکیبی (مانند EPSG:4296)، یک تعریف متنی CRS به صورت WKT، تعاریف PROJ.4 یا نام یک فایل .prj حاوی تعریف WKT CRS است. .sp برای لغو CRS موجود در مجموعه‌داده \fI\%\-\-like\fP (در صورت تنظیم بودن آن)، می‌توان مقدار \fBnull\fP یا \fBnone\fP را مشخص کرد. .sp توجه داشته باشید که وسعت مکانی نیز بدون تغییر باقی می‌ماند. .UNINDENT .INDENT 0.0 .TP .B \-i, \-\-like, \-\-input نام مجموعه‌داده ورودی GDAL که به عنوان الگو برای مقادیر پیش‌فرض گزینه‌های \fI\%\-\-size\fP، \fI\%\-\-band\-count\fP، \fI\%\-\-datatype\fP، \fI\%\-\-crs\fP، \fI\%\-\-bbox\fP و \fI\%\-\-nodata\fP عمل می‌کند. توجه داشته باشید که مقادیر پیکسل‌ها کپی \fIنخواهند شد\fP. .sp از نسخه GDAL 3.13، در صورتی که مجموعه‌داده ورودی تایل‌بندی شده باشد، و برای قالب‌های خروجی \fBGTiff\fP، \fBCOG\fP و \fBGPKG\fP، ابعاد تایل‌های آن در فایل خروجی تکرار می‌شود، مشروط بر آنکه با قابلیت‌های آن سازگار باشد و کاربر هیچ گزینه ایجادی مربوط به تایل‌بندی را مشخص نکرده باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-metadata = افزودن یک آیتم متادیتا در سطح مجموعه‌داده. .UNINDENT .INDENT 0.0 .TP .B \-\-nodata تنظیم مقدار nodata. .sp برای لغو مقدار nodata موجود در مجموعه‌داده \fI\%\-\-like\fP (در صورت تنظیم بودن آن)، می‌توان مقدار \fBnull\fP یا \fBnone\fP را مشخص کرد. همچنین مقادیر \fBnan\fP، \fBinf\fP یا \fB\-inf\fP برای رسترهای ممیز شناور پذیرفته می‌شوند که به ترتیب به معنای مقادیر ویژه تعریف‌نشده (not-a-number)، بی‌نهایت مثبت و بی‌نهایت منفی هستند. .UNINDENT .INDENT 0.0 .TP .B \-\-size , تنظیم اندازه فایل خروجی بر حسب پیکسل. مقدار اول عرض و مقدار دوم ارتفاع است. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append الحاق رستر ورودی به عنوان یک زیرمجموعه‌داده جدید به یک فایل خروجی موجود. فقط با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده‌ها پشتیبانی می‌کنند مانند \fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP. در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را نیز ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد دارند که می‌توانند برای کنترل ویژگی‌های خاص فایل ایجادشده استفاده شوند. به عنوان مثال، درایور GeoTIFF از گزینه‌های ایجاد برای کنترل فشرده‌سازی و تایل‌بندی شدن فایل پشتیبانی می‌کند. .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 \-\-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 \-f, \-\-of, \-\-format, \-\-output\-format تعیین قالب رستر خروجی مورد استفاده. مقادیر مجاز با اجرای دستور زیر قابل مشاهده است: \fBgdal \-\-formats | grep raster | grep + | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite اجازه دادن به برنامه برای بازنویسی فایل یا مجموعه‌داده هدف موجود. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه‌داده هدف از قبل وجود داشته باشد، \fBgdal\fP خطا می‌دهد. .UNINDENT .SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: مقداردهی اولیه یک فایل GeoTIFF جدید با ۳ باند و مقدار یکنواخت ۱۰" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster create \-\-size=20,20 \-\-band\-count=3 \-\-crs=EPSG:4326 \-\-bbox=2,49,3,50 \-\-burn 10 out.tif .EE .UNINDENT .UNINDENT .SS "مثال ۲: ایجاد یک فایل PDF از روی یک فایل ترکیب XML" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster create \-\-creation\-option COMPOSITION_FILE=composition.xml out.pdf .EE .UNINDENT .UNINDENT .SS "مثال ۳: مقداردهی اولیه یک فایل GeoTIFF خام از روی یک فایل ورودی" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster create \-\-like prototype.tif output.tif .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .