.\" 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-DATASET-IDENTIFY" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-dataset-identify \- شناسایی درایور بازکننده مجموعه‌داده(ها)
.sp
افزوده‌شده در نسخه 3.12.

.sp
دستور
\fBgdal dataset identify\fP
نام درایورهایی را که می‌توانند یک یا چند مجموعه‌داده را باز کنند، گزارش می‌دهد.
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal dataset identify [OPTIONS] <FILENAME>

Identify driver opening dataset(s).

Positional arguments:
  \-\-input, \-\-filename <FILENAME>                       File or directory name [may be repeated] [required]

Common Options:
  \-h, \-\-help                                           Display help message and exit
  \-\-json\-usage                                         Display usage as JSON document and exit
  \-\-config <KEY>=<VALUE>                               Configuration option [may be repeated]
  \-q, \-\-quiet                                          Quiet mode (no progress bar or warning message) [not available in pipelines]

Options:
  \-o, \-\-output <OUTPUT>                                Output vector dataset (created by algorithm)
  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  Output format
  \-\-co, \-\-creation\-option <KEY>=<VALUE>                Creation option [may be repeated]
  \-\-lco, \-\-layer\-creation\-option <KEY>=<VALUE>         Layer creation option [may be repeated]
  \-l, \-\-output\-layer <OUTPUT\-LAYER>                    Output layer name
  \-\-overwrite                                          Whether overwriting existing output dataset is allowed
  \-r, \-\-recursive                                      Recursively scan files/folders for datasets
  \-\-force\-recursive                                    Recursively scan folders for datasets, forcing recursion in folders recognized as valid formats
  \-\-detailed                                           Most detailed output. Reports the presence of georeferencing, if a GeoTIFF file is cloud optimized, etc.
  \-\-report\-failures                                    Report failures if file type is unidentified
.EE
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-\-filename <FILENAME>
هر نام فایل یا نام پوشه. الزامی است. می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-o, \-\-output <OUTPUT>
افزوده‌شده در نسخه 3.13.

.sp
مجموعه‌داده برداری خروجی که حداقل شامل فیلدهای \fBfilename\fP و \fBdriver\fP خواهد بود؛
و اگر \fI\%\-\-detailed\fP مشخص شده باشد، همچنین شامل فیلدهای \fBlayout\fP (که مقدار آن می‌تواند
برای نمونه \fBCOG\fP باشد)، \fBfile_list\fP (فایل‌های وابسته / side\-car)، \fBhas_crs\fP،
\fBhas_geotransform\fP و \fBhas_overview\fP\& خواهد بود.
.sp
هنگامی که این آرگومان مشخص نشود، گزارش نتیجه به جریان خروجی استاندارد ارسال می‌شود؛ چه به‌صورت JSON یا متنی (بسته به \fI\%\-\-output\-format\fP)،
برای اجرای خط فرمان، یا در آرگومان \fBoutput\-string\fP هنگام استفاده از طریق API.
.sp
توجه داشته باشید که این یک آرگومان موضعی نیست، بنابراین سوییچ \fB\-o\fP یا \fB\-\-output\fP
باید پیش از مشخص کردن نام، به‌طور صریح استفاده شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-format json|text|<OTHER\-VECTOR\-FORMAT>
تعیین می‌کند کدام قالب خروجی استفاده شود. مقدار پیش‌فرض JSON است، یا در صورت فراخوانی از خط فرمان، متنی (text) خواهد بود.
.sp
از نسخه 3.13 GDAL به بعد، سایر قالب‌های برداری GDAL با قابلیت ایجاد (creation capabilities) نیز
قابل استفاده هستند، که در این صورت باید \fI\%\-\-output\fP مشخص شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-r, \-\-recursive
پویش بازگشتی فایل‌ها/پوشه‌ها برای یافتن مجموعه‌داده‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-force\-recursive
پویش بازگشتی پوشه‌ها برای یافتن مجموعه‌داده‌ها، با اجبار به پیمایش بازگشتی در پوشه‌هایی
که به عنوان قالب‌های معتبر شناخته شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-detailed
افزوده‌شده در نسخه 3.13.

.sp
افزایش سطح جزئیات در خروجی.
وجود زمین‌مرجع (georeferencing)، بهینه‌سازی ابری فایل GeoTIFF و موارد دیگر را گزارش می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-report\-failures
گزارش خطاها و شکست‌ها در صورتی که نوع فایل شناسایی نشود.
.UNINDENT
.SH "کد وضعیت بازگشتی (RETURN STATUS CODE)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر
برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفقیت‌آمیز
در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: شناسایی یک فایل منفرد
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal dataset identify NE1_50M_SR_W.tif

NE1_50M_SR_W.tif: GTiff
.EE
.UNINDENT
.UNINDENT
.SS مثال ۲: شناسایی یک فایل منفرد با خروجی JSON
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal dataset identify \-\-of=JSON NE1_50M_SR_W.tif
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[
   {
     \(dqname\(dq: \(dqNE1_50M_SR_W.tif\(dq,
     \(dqdriver\(dq: \(dqGTiff\(dq
   }
]
.EE
.UNINDENT
.UNINDENT
.SS مثال ۳: حالت بازگشتی برای پویش زیرپوشه‌ها و گزارش قالب داده
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal dataset identify \-r 50m_raster/

NE1_50M_SR_W/ne1_50m.jpg: JPEG
NE1_50M_SR_W/ne1_50m.png: PNG
NE1_50M_SR_W/ne1_50m_20pct.tif: GTiff
NE1_50M_SR_W/ne1_50m_band1.tif: GTiff
NE1_50M_SR_W/ne1_50m_print.png: PNG
NE1_50M_SR_W/NE1_50M_SR_W.aux: HFA
NE1_50M_SR_W/NE1_50M_SR_W.tif: GTiff
NE1_50M_SR_W/ne1_50m_sub.tif: GTiff
NE1_50M_SR_W/ne1_50m_sub2.tif: GTiff
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SS مثال ۴: پویش بازگشتی زیرپوشه‌ها و گزارش اطلاعات تفصیلی در یک فایل CSV
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal dataset identify \-\-output out.csv \-\-detailed \-r 50m_raster/
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SS مثال ۵: بررسی بهینه‌سازی ابری فایل GeoTIFF با استفاده از \-\-detailed
.sp
دستور زیر درایور و جزئیات چیدمان تصویر را برمی‌گرداند: \fBGTiff, layout=COG, has CRS, has geotransform, has overview(s)\fP
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal dataset identify /vsicurl/https://sentinel\-cogs.s3.us\-west\-2.amazonaws.com/sentinel\-s2\-l2a\-cogs/36/Q/WD/2020/7/S2A_36QWD_20200701_0_L2A/TCI.tif \-\-detailed
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.