.\" 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-PIXEL-INFO" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-pixel-info \- بازگرداندن اطلاعات مربوط به یک پیکسل از مجموعه‌داده رستر .sp اضافه‌شده در نسخه 3.11. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal raster pixel\-info [OPTIONS] [ یا ] بازگرداندن اطلاعات مربوط به یک پیکسل از مجموعه‌داده رستر. آرگومان‌های موضعی: \-i, \-\-dataset, \-\-input مجموعه‌داده‌های رستر ورودی [الزامی] \-p, \-\-pos, \-\-position or موقعیت پیکسل [ممکن است تکرار شود] مانعه‌الجمع با \-\-position\-dataset گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [ممکن است تکرار شود] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (پیش‌فرض \(aqGeoJSON\(aq است اگر \(aqposition\-dataset\(aq مشخص نشده باشد) [در خط‌لوله‌ها در دسترس نیست] \-\-position\-dataset مجموعه‌داده برداری حاوی مختصات مانعه‌الجمع با \-\-position \-l, \-\-layer, \-\-input\-layer نام لایه ورودی \-o, \-\-output مجموعه‌داده برداری خروجی (ایجاد شده توسط الگوریتم) \-\-co, \-\-creation\-option = گزینه ساخت [ممکن است تکرار شود] [در خط‌لوله‌ها در دسترس نیست] \-\-lco, \-\-layer\-creation\-option = گزینه ساخت لایه [ممکن است تکرار شود] [در خط‌لوله‌ها در دسترس نیست] \-\-overwrite مجاز بودن بازنویسی مجموعه‌داده خروجی موجود [در خط‌لوله‌ها در دسترس نیست] \-b, \-\-band باند(های) ورودی (شاخص بر پایه ۱) [ممکن است تکرار شود] \-\-overview کدام سطح نمای کلی (overview) از فایل مبدأ باید استفاده شود \-\-position\-crs CRS موقعیت (پیش‌فرض \(aqpixel\(aq است اگر \(aqposition\-dataset\(aq مشخص نشده باشد) \-r, \-\-resampling الگوریتم بازنمونه‌برداری برای درون‌یابی. RESAMPLING=nearest|bilinear|cubic|cubicspline (پیش‌فرض: nearest) \-\-promote\-pixel\-value\-to\-z تنظیم مقدار پیکسل به عنوان مؤلفه Z در هندسه GeoJSON \-\-include\-field فیلدهایی از مجموعه‌داده مختصات جهت درج در خروجی (مقادیر ویژه: ALL و NONE) (پیش‌فرض: ALL) [ممکن است تکرار شود] گزینه‌های پیشرفته: \-\-oo, \-\-open\-option = گزینه‌های باز کردن [ممکن است تکرار شود] [در خط‌لوله‌ها در دسترس نیست] \-\-if, \-\-input\-format قالب‌های ورودی [ممکن است تکرار شود] [در خط‌لوله‌ها در دسترس نیست] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster pixel\-info\fP سازوکاری را برای پرس‌وجوی اطلاعات یک پیکسل با توجه به موقعیت مکانی آن در یکی از انواع سامانه‌های مختصات فراهم می‌کند. .sp موارد زیر (در صورت مشخص بودن) گزارش خواهند شد: .INDENT 0.0 .IP \(bu 2 مختصات ورودی .IP \(bu 2 مختصات ورودی تبدیل‌شده به ستون، سطر .IP \(bu 2 مقدار پیکسل به ازای هر باند انتخاب‌شده، همراه با مقدار مقیاس‌بندی‌نشده .IP \(bu 2 برای فایل‌های VRT، این‌که کدام فایل(ها) در مقدار پیکسل نقش دارند (تنها برای خروجی GeoJSON) .UNINDENT .sp ۳ روش ممکن برای ارائه موقعیت(های) ورودی وجود دارد: .INDENT 0.0 .IP \(bu 2 از جریان ورودی، با یک جفت \(dqX Y\(dq در هر خط، که احتمالاً متن‌های دیگری نیز به دنبال آن می‌آید. .IP \(bu 2 از طریق آرگومان \fI\%\-\-position\fP. .IP \(bu 2 از طریق یک مجموعه‌داده برداری GDAL با استفاده از آرگومان \fI\%\-\-position\-dataset\fP. .UNINDENT .sp ۲ حالت ممکن برای خروجی دادن اطلاعات پیکسل وجود دارد: .INDENT 0.0 .IP \(bu 2 یا در جریان خروجی به صورت CSV یا GeoJSON (پیش‌فرض GeoJSON است) .IP \(bu 2 یا به عنوان یک مجموعه‌داده برداری GDAL که نام آن با آرگومان \fI\%\-\-output\fP مشخص می‌شود. .UNINDENT .sp از نسخه GDAL 3.13، این الگوریتم می‌تواند بخشی از یک \fI\%gdal pipeline\fP\& باشد. در این حالت، تنها خواندن مختصات از یک مجموعه‌داده برداری GDAL و ارسال نتایج خروجی به آن پشتیبانی می‌شود. .sp اضافه‌شده در نسخه 3.13..SH "خروجی GDALG (مجموعه‌داده در لحظه / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp این برنامه از سریالی‌سازی خط فرمان به‌عنوان یک فایل JSON با استفاده از فرمت خروجی \fBGDALG\fP پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به‌عنوان یک مجموعه‌داده برداری با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز کرد و خط لوله مشخص‌شده را به‌صورت در لحظه / جریانی اعمال نمود. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 با این حال، این الگوریتم ذاتاً با پردازش جریانی سازگار نیست. در نتیجه، یک مجموعه‌داده موقت در حافظه ایجاد خواهد شد که ممکن است در زمان باز کردن، باعث صرف زمان پردازش چشمگیری شود. .UNINDENT .UNINDENT .sp گزینه‌های زیر در دسترس هستند: .SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-b باندی را برای پرس‌وجو انتخاب می‌کند. چندین باند را می‌توان مشخص کرد. به‌طور پیش‌فرض، همه باندها پرس‌وجو می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format کدام فرمت خروجی برداری استفاده شود. .sp هنگامی که \fI\%\-\-output\fP مشخص نشده باشد، \fBcsv\fP یا \fBgeojson\fP تنها دو گزینه پشتیبانی‌شده هستند که \fBgeojson\fP پیش‌فرض است. در غیر این صورت، هر فرمت برداری پشتیبانی‌شده توسط GDAL با قابلیت نوشتن، پشتیبانی می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-position\-dataset در نسخه 3.13 اضافه شد. .sp مجموعه‌داده برداری سازگار با GDAL که مختصات ورودی از آن خوانده می‌شود. اگر عارضه ورودی دارای هندسه نقطه‌ای باشد، از موقعیت آن برای پرس‌وجوی رستر استفاده می‌شود. برای سایر انواع هندسه، از مرکزوار (centroid) استفاده می‌شود. برای خواندن تمام مقادیر پیکسل برای هندسه‌های غیرنقطه‌ای، از \fI\%gdal raster zonal\-stats\fP استفاده کنید\&. به‌طور پیش‌فرض، تمام فیلدهای توصیفی در خروجی کپی می‌شوند. .sp اگر آرگومان \fI\%\-\-position\-crs\fP مشخص شده باشد، مختصات نقطه مطابق با مقدار آن آرگومان تفسیر می‌شود. .sp در غیر این صورت، اگر لایه برداری ورودی دارای CRS باشد، فرض می‌شود که مختصات در آن بیان شده است. .sp در غیر این صورت، فرض می‌شود مختصات در CRS مجموعه‌داده رستر است، چنانچه دارای CRS باشد. .sp در غیر این صورت، فرض می‌شود مختصات در فضای سطر،ستون رستر بیان شده است. .UNINDENT .INDENT 0.0 .TP .B \-l, \-\-layer, \-\-input\-layer در نسخه 3.13 اضافه شد. .sp نام لایه ورودی از مجموعه‌داده مشخص‌شده با \fI\%\-\-position\-dataset\fP برای استفاده. .UNINDENT .INDENT 0.0 .TP .B \-o, \-\-output در نسخه 3.13 اضافه شد. .sp مجموعه‌داده برداری خروجی (ایجادشده توسط الگوریتم) .UNINDENT .INDENT 0.0 .TP .B \-\-include\-field در نسخه 3.13 اضافه شد. .sp نام فیلد(ها) از \fI\%\-\-position\-dataset\fP برای گنجاندن در خروجی. به‌طور پیش‌فرض، تمام فیلدها گنجانده می‌شوند (که متناظر با مقدار ویژه \fBALL\fP است). می‌توان از مقدار ویژه \fBNONE\fP استفاده کرد تا هیچ فیلدی از مجموعه‌داده موقعیت در خروجی گنجانده نشود. .UNINDENT .INDENT 0.0 .TP .B \-\-ovr, \-\-overview پرس‌وجوی پیش‌نمای (overview_level)ام (overview_level=0 نخستین پیش‌نما است)، به‌جای باند پایه. توجه داشته باشید که موقعیت x,y (چنانچه سیستم مختصات پیکسل/خط باشد) همچنان باید نسبت به باند پایه مشخص شود. .UNINDENT .INDENT 0.0 .TP .B \-p, \-\-pos, \-\-position or الزامی است، در صورتی که \fI\%\-\-position\-dataset\fP مشخص نشده باشد و هیچ محتوایی از طریق جریان ورودی ارائه نشود. .sp این مقدار را می‌توان به‌صورت یک گزینه، یک مقدار مکانی بعد از نام مجموعه‌داده، یا در هنگام فراخوانی از \fBgdal\fP، به‌صورت مقادیری (جداشده با فاصله) در ورودی استاندارد مشخص کرد. .sp به‌طور پیش‌فرض، هنگامی که \fI\%\-\-position\-crs\fP مشخص نشده باشد یا روی \fBpixel\fP تنظیم شده باشد، این مقدار یک چندتایی ستون، سطر است (احتمالاً دارای بخش اعشاری). اگر \fI\%\-\-position\-crs\fP روی \fBdataset\fP تنظیم شده باشد، این یک مختصات زمین‌مرجع بیان‌شده در CRS مجموعه‌داده است. اگر \fI\%\-\-position\-crs\fP روی یک تعریف CRS تعیین شده باشد، این یک مختصات زمین‌مرجع بیان‌شده در این CRS خواهد بود. .sp همواره X به معنای طول جغرافیایی یا شرق‌سو، و Y به معنای عرض جغرافیایی یا شمال‌سو است. .sp می‌توان چندین چندتایی x,y را مشخص کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-position\-crs pixel|dataset| سیستم مرجع مختصات (CRS) موقعیت، یا یکی از دو مقدار ویژه زیر: .INDENT 7.0 .IP \(bu 2 \fBpixel\fP یعنی موقعیت به‌صورت ستون، سطر تعیین شده است (پیش‌فرض) .IP \(bu 2 \fBdataset\fP یعنی موقعیت یک مختصات زمین‌مرجع بیان‌شده در CRS مجموعه‌داده است. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-promote\-pixel\-value\-to\-z در نسخه 3.13 اضافه شد. .sp تعیین می‌کند که آیا مقدار پیکسل به‌عنوان مؤلفه Z هندسه GeoJSON تنظیم شود یا خیر. تنها در صورتی اعمال می‌شود که یک باند منفرد انتخاب شده باشد، و برای فرمت خروجی GeoJSON است. .UNINDENT .INDENT 0.0 .TP .B \-r, \-\-resampling nearest|bilinear|cubic|cubicspline یک الگوریتم نمونه‌برداری را انتخاب می‌کند. پیش‌فرض \fBnearest\fP است\&. .sp روش‌های موجود عبارتند از: .INDENT 7.0 .IP \(bu 2 \fBnearest\fP روش نزدیک‌ترین همسایه را اعمال می‌کند. .IP \(bu 2 \fBbilinear\fP یک هسته پیچش دوخطی را اعمال می‌کند. .IP \(bu 2 \fBcubic\fP یک هسته پیچش درجه سه را اعمال می‌کند. .IP \(bu 2 \fBcubicspline\fP یک هسته پیچش B\-Spline را اعمال می‌کند. .UNINDENT .UNINDENT.SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه داده (مختص هر قالب). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام قالب/درایور جهت تلاش برای باز کردن فایل(های) ورودی. معمولاً مشخص کردن آن ضروری نیست، اما در صورتی که تشخیص خودکار درایور نتواند درایور مناسب را انتخاب کند، می‌توان از آن برای نادیده گرفتن این فرآیند استفاده کرد. این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه داده نمی‌کند؛ به‌ویژه که برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ساخت دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. به عنوان مثال، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و این‌که آیا فایل باید کاشی‌بندی (tiled) شود یا خیر پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات مربوط به هر قالب، منبع اصلی و معتبر اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز در هر قالب، به مستندات اختصاصی \fI\%Raster drivers\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-lco, \-\-layer\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ساخت لایه دارند که می‌توان از آن‌ها برای کنترل جزئیات لایه ایجادشده استفاده کرد. به عنوان مثال، درایور GeoPackage از گزینه‌های ساخت لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و موارد دیگر پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت لایه موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینه ساخت لایه‌ای ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات مربوط به هر قالب، منبع اصلی و معتبر اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز در هر قالب، به مستندات اختصاصی \fI\%Vector drivers\fP مراجعه کنید. .sp توجه داشته باشید که گزینه‌های ساخت لایه با گزینه‌های ساخت مجموعه داده متفاوت هستند. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد تا فایل هدف یا مجموعه داده موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل هدف یا مجموعه داده از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp برنامه در صورت موفقیت، کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر را برمی‌گرداند (خطاهای غیر مسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: گزارش در مورد پیکسل column=5، line=10 روی فایل byte.tif .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster pixel\-info byte.tif 5 10 { \(dqtype\(dq:\(dqFeatureCollection\(dq, \(dqcrs\(dq:{ \(dqtype\(dq:\(dqname\(dq, \(dqproperties\(dq:{ \(dqname\(dq:\(dqurn:ogc:def:crs:EPSG::26711\(dq } }, \(dqfeatures\(dq:[ { \(dqtype\(dq:\(dqFeature\(dq, \(dqproperties\(dq:{ \(dqinput_coordinate\(dq:[ 5.0, 10.0 ], \(dqcolumn\(dq:5.0, \(dqline\(dq:10.0, \(dqbands\(dq:[ { \(dqband_number\(dq:1, \(dqraw_value\(dq:132, \(dqunscaled_value\(dq:132.0 } ] }, \(dqgeometry\(dq:{ \(dqtype\(dq:\(dqPoint\(dq, \(dqcoordinates\(dq:[ 441020.0, 3750720.0 ] } } ] } .EE .UNINDENT .UNINDENT.SS مثال ۲: گزارش نقطه در مختصات UTM 11N با easting=441320 و northing=3750720 روی فایل byte.tif .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster pixel\-info \-\-position\-crs=dataset byte.tif 441320 3750720 { \(dqtype\(dq:\(dqFeatureCollection\(dq, \(dqcrs\(dq:{ \(dqtype\(dq:\(dqname\(dq, \(dqproperties\(dq:{ \(dqname\(dq:\(dqurn:ogc:def:crs:EPSG::26711\(dq } }, \(dqfeatures\(dq:[ { \(dqtype\(dq:\(dqFeature\(dq, \(dqproperties\(dq:{ \(dqinput_coordinate\(dq:[ 441320.0, 3750720.0 ], \(dqcolumn\(dq:10.0, \(dqline\(dq:10.0, \(dqbands\(dq:[ { \(dqband_number\(dq:1, \(dqraw_value\(dq:115, \(dqunscaled_value\(dq:115.0 } ] }, \(dqgeometry\(dq:{ \(dqtype\(dq:\(dqPoint\(dq, \(dqcoordinates\(dq:[ 441320.0, 3750720.0 ] } } ] } .EE .UNINDENT .UNINDENT .SS مثال ۳: گزارش نقطه در مختصات WGS84 با longitude=\-117.6355 و latitude=33.8970 روی فایل byte.tif، با قالب خروجی CSV .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster pixel\-info \-\-of=csv \-\-position\-crs=WGS84 byte.tif \-117.6355 33.8970 geom_x,geom_y,extra_content,column,line,band_1_raw_value,band_1_unscaled_value \-117.6355,33.897,,10.020546288988,9.98330473474925,115,115 .EE .UNINDENT .UNINDENT .SS مثال ۴: گزارش نقطه در مختصات WGS84 داده‌شده از ورودی استاندارد به ترتیب longitude و latitude. .INDENT 0.0 .INDENT 3.5 .sp .EX $ echo \-117.6355 33.8970 | gdal raster pixel\-info \-\-of=csv \-\-position\-crs=WGS84 byte.tif geom_x,geom_y,extra_content,column,line,band_1_raw_value,band_1_unscaled_value \-117.6355,33.897,,10.020546288988,9.98330473474925,115,115 .EE .UNINDENT .UNINDENT .SS مثال ۵: خواندن مختصات برای استخراج از یک فایل ورودی GeoPackage و نوشتن خروجی در یک فایل GeoPackage .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster pixel\-info \-\-position\-dataset input.gpkg \-\-input byte.tif \-\-output output.gpkg .EE .UNINDENT .UNINDENT .SS مثال ۶: دریافت مقادیر پیکسل از یک مجموعه‌داده رستری تغییر اندازه یافته به‌صورت درجا (on\-the\-fly) بر اساس مختصات موجود در input.gpkg. .INDENT 0.0 .INDENT 3.5 .sp .EX gdal pipeline read byte.tif ! resize \-\-size 50%,50% \-r cubic ! pixel\-info input.gpkg ! write output.gpkg .EE .UNINDENT .UNINDENT.SS "مثال ۷: دریافت مقادیر پیکسل از مختصات در یک مجموعه داده برداری هدایت‌شده از طریق پایپ، با استفاده از نام مجموعه داده جای‌نگهدار _" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal pipeline read input.gml ! swap\-xy ! pixel\-info \-\-input byte.tif \-\-position\-dataset _ ! write output.gpkg .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .