.\" 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-VECTOR-PIPELINE" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-pipeline \- پردازش یک مجموعه‌داده برداری با اعمال چندین مرحله .sp در نسخه 3.11 اضافه شد. .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal vector pipeline\fP می‌تواند برای پردازش یک مجموعه‌داده برداری و اجرای مراحل مختلف پردازشی که ورودی و خروجی برداری دارند استفاده شود. .sp برای خط‌لوله‌هایی که رستر و بردار را با هم ترکیب می‌کنند، به \fI\%gdal pipeline\fP\& مراجعه کنید. .sp بیشتر مراحل، عوارض (features) را برحسب‌تقاضا (on\-demand) ارزیابی می‌کنند، مگر آن‌که در مستندات آن‌ها خلاف این قید شده باشد، بدون آن‌که مجموعه‌داده حاصل از عملیات هر مرحله «ملموس‌سازی» (\(dqmaterializing\(dq) شود. با این حال ممکن است گاهی برای بهبود کارایی، ملموس‌سازی یک مجموعه‌داده میانی روی دیسک با استفاده از \fI\%gdal vector materialize\fP\& مطلوب باشد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal vector pipeline [OPTIONS] پردازش یک مجموعه‌داده برداری با اعمال چندین مرحله. آرگومان‌های مکانی: گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده به‌صورت سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌لوله‌ها در دسترس نیست] گزینه‌ها: \-\-skip\-errors نادیده گرفتن خطاها هنگام نوشتن عوارض [در خط‌لوله‌ها در دسترس نیست] به این صورت است: read|concat [READ\-OPTIONS] ( ! [STEP\-OPTIONS] )* ! write|info [WRITE\-OPTIONS] .EE .UNINDENT .UNINDENT .sp یک خط‌لوله چندین مرحله را که با نویسه \fI!\fP (علامت تعجب) از هم جدا می‌شوند، به یکدیگر زنجیر می‌کند. مرحله نخست باید \fBread\fP یا \fBconcat\fP باشد و مرحله پایانی باید \fBinfo\fP، \fBpartition\fP یا \fBwrite\fP\& باشد. هر مرحله آرگومان‌های مکانی یا غیرمکانی مخصوص به خود را دارد. به‌جز \fBread\fP، \fBconcat\fP، \fBinfo\fP، \fBpartition\fP و \fBwrite\fP، تمام مراحل دیگر می‌توانند بالقوه چندین بار در یک خط‌لوله استفاده شوند. .SH "مراحل (STEPS)" .INDENT 0.0 .IP \(bu 2 \fI\%buffer\fP .IP \(bu 2 \fI\%check\-coverage\fP .IP \(bu 2 \fI\%check\-geometry\fP .IP \(bu 2 \fI\%clean\-coverage\fP .IP \(bu 2 \fI\%clip\fP .IP \(bu 2 \fI\%combine\fP .IP \(bu 2 \fI\%concave\-hull\fP .IP \(bu 2 \fI\%concat\fP .IP \(bu 2 \fI\%convex\-hull\fP .IP \(bu 2 \fI\%create\fP .IP \(bu 2 \fI\%dissolve\fP .IP \(bu 2 \fI\%edit\fP .IP \(bu 2 \fI\%explode\-collections\fP .IP \(bu 2 \fI\%export\-schema\fP .IP \(bu 2 \fI\%external\fP .IP \(bu 2 \fI\%filter\fP .IP \(bu 2 \fI\%info\fP .IP \(bu 2 \fI\%limit\fP .IP \(bu 2 \fI\%make\-point\fP .IP \(bu 2 \fI\%make\-valid\fP .IP \(bu 2 \fI\%materialize\fP .IP \(bu 2 \fI\%partition\fP .IP \(bu 2 \fI\%read\fP .IP \(bu 2 \fI\%rename\-layer\fP .IP \(bu 2 \fI\%reproject\fP .IP \(bu 2 \fI\%segmentize\fP .IP \(bu 2 \fI\%select\fP .IP \(bu 2 \fI\%set\-field\-type\fP .IP \(bu 2 \fI\%set\-geom\-type\fP .IP \(bu 2 \fI\%simplify\fP .IP \(bu 2 \fI\%simplify\-coverage\fP .IP \(bu 2 \fI\%sort\fP .IP \(bu 2 \fI\%sql\fP .IP \(bu 2 \fI\%swap\-xy\fP .IP \(bu 2 \fI\%tee\fP .IP \(bu 2 \fI\%update\fP .IP \(bu 2 \fI\%write\fP .UNINDENT.SS buffer .INDENT 0.0 .INDENT 3.5 .sp .EX * buffer [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- محاسبه بافر در اطراف هندسه‌های یک مجموعه داده برداری. آرگومان‌های موضعی: \-\-distance فاصله‌ای که هندسه باید تا آن گسترش یابد. [الزامی] گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت مشخص نشدن، همه لایه‌ها) \-\-active\-geometry نام فیلد هندسه برای محدود کردن پردازش به آن (در صورت مشخص نشدن، همه فیلدها) \-\-endcap\-style سبک سرپوش انتهایی.. ENDCAP\-STYLE=round|flat|square (پیش‌فرض: round) \-\-join\-style سبک اتصال.. JOIN\-STYLE=round|mitre|bevel (پیش‌فرض: round) \-\-mitre\-limit حد نسبت فارسی‌بُر (تنها بر سبک اتصال mitered اثر می‌گذارد). (پیش‌فرض: 5) \-\-quadrant\-segments تعداد پاره‌خط‌های مورد استفاده برای تقریب یک ربع دایره. (پیش‌فرض: 8) \-\-side تعیین یک‌طرفه بودن یا نبودن بافر محاسبه‌شده.. SIDE=both|left|right (پیش‌فرض: both) .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector buffer\fP\& یافت. .SS check\-coverage .INDENT 0.0 .INDENT 3.5 .sp .EX * check\-coverage [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- بررسی یک پوشش چندضلعی از نظر معتبر بودن گزینه‌ها: \-\-include\-valid گنجاندن ورودی‌های معتبر در خروجی، با هندسه خالی \-\-geometry\-field نام فیلد هندسه برای بررسی \-\-maximum\-gap\-width حداکثر عرض یک شکاف برای علامت‌گذاری شدن .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector check\-coverage\fP\& یافت. .SS check\-geometry .INDENT 0.0 .INDENT 3.5 .sp .EX * check\-geometry [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- بررسی یک مجموعه داده از نظر وجود هندسه‌های نامعتبر گزینه‌ها: \-\-include\-field فیلدهایی از لایه ورودی برای گنجاندن در خروجی (مقادیر ویژه: ALL و NONE) (پیش‌فرض: NONE) [می‌تواند تکرار شود] \-\-include\-valid گنجاندن ورودی‌های معتبر در خروجی، با هندسه خالی \-\-geometry\-field نام فیلد هندسه برای بررسی .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector check\-geometry\fP\& یافت. .SS clean\-coverage .INDENT 0.0 .INDENT 3.5 .sp .EX * clean\-coverage [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- تغییر مرزهای چندضلعی برای یکسان‌سازی لبه‌های مشترک، و حذف شکاف‌ها و همپوشانی‌ها گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت مشخص نشدن، همه لایه‌ها) \-\-snapping\-distance میزان رواداری فاصله برای چسباندن (snapping) گره‌ها \-\-merge\-strategy الگوریتم انتساب همپوشانی‌ها به چندضلعی‌های مجاور. MERGE\-STRATEGY=longest\-border|max\-area|min\-area|min\-index \-\-maximum\-gap\-width حداکثر عرض یک شکاف برای بسته شدن .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector clean\-coverage\fP\& یافت. .SS clip .INDENT 0.0 .INDENT 3.5 .sp .EX * clip [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- بُرش یک مجموعه داده برداری. گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت مشخص نشدن، همه لایه‌ها) \-\-bbox کادر احاطه‌کننده بُرش به‌صورت xmin,ymin,xmax,ymax غیرقابل استفاده هم‌زمان با \-\-geometry، \-\-like \-\-bbox\-crs سامانه مرجع مختصات (CRS) کادر احاطه‌کننده بُرش \-\-geometry هندسه بُرش (WKT یا GeoJSON) غیرقابل استفاده هم‌زمان با \-\-bbox، \-\-like \-\-geometry\-crs سامانه مرجع مختصات (CRS) هندسه بُرش \-\-like مجموعه داده برای استفاده به‌عنوان الگو جهت محدوده‌ها غیرقابل استفاده هم‌زمان با \-\-bbox، \-\-geometry \-\-like\-sql دستور SELECT برای اجرا روی مجموعه داده \(aqlike\(aq غیرقابل استفاده هم‌زمان با \-\-like\-where \-\-like\-layer نام لایه در مجموعه داده \(aqlike\(aq \-\-like\-where بند WHERE در SQL برای اجرا روی مجموعه داده \(aqlike\(aq غیرقابل استفاده هم‌زمان با \-\-like\-sql .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector clip\fP\& یافت. .SS combine .INDENT 0.0 .INDENT 3.5 .sp .EX * combine [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- ترکیب عوارض در مجموعه‌ها گزینه‌ها: \-\-group\-by نام فیلد(هایی) که ورودی‌ها باید بر اساس آن‌ها گروه‌بندی شوند [می‌تواند تکرار شود] \-\-keep\-nested جلوگیری از ترکیب اجزای هندسه‌های چندبخشی \-\-add\-extra\-fields افزودن فیلدهای اضافی بسته به داشتن مقادیر یکسان در هر گروه. ADD\-EXTRA\-FIELDS=no|sometimes\-identical|always\-identical (پیش‌فرض: no) .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector combine\fP\& یافت..SS concave\-hull .INDENT 0.0 .INDENT 3.5 .sp .EX * concave\-hull [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- محاسبه پوسته مقعر هندسه‌های یک مجموعه‌داده برداری. گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-\-active\-geometry نام فیلد هندسه برای محدود کردن پردازش (در صورت عدم تعیین، همه) \-\-ratio نسبت کنترل‌کننده تقعر [الزامی] \-\-allow\-holes مجاز بودن ایجاد حفره‌ها در چندضلعی خروجی \-\-tight الزام پوسته به پیروی از مرزهای بیرونی چندضلعی‌های ورودی .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector concave\-hull\fP یافت.\& .SS concat .INDENT 0.0 .INDENT 3.5 .sp .EX * concat [OPTIONS] ... \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- الحاق مجموعه‌داده‌های برداری. آرگومان‌های موضعی: \-i, \-\-input مجموعه‌داده‌های برداری ورودی [1.. values] [الزامی] گزینه‌ها: \-l, \-\-layer, \-\-input\-layer نام لایه(های) ورودی [قابل تکرار] \-\-mode تعیین راهبرد ایجاد لایه‌های خروجی از لایه‌های مبدأ. MODE=merge\-per\-layer\-name|stack|single (پیش‌فرض: merge\-per\-layer\-name) \-\-output\-layer نام لایه برداری خروجی (حالت single)، یا الگو جهت نام‌گذاری لایه‌های برداری خروجی (حالت stack) \-\-source\-layer\-field\-name نام فیلد جدید جهت افزودن برای نگهداری شناسه لایه مبدأ، با مقدار تعیین‌شده از \(aqsource\-layer\-field\-content\(aq \-\-source\-layer\-field\-content یک رشته، احتمالاً با استفاده از {AUTO_NAME}، {DS_NAME}، {DS_BASENAME}، {DS_INDEX}، {LAYER_NAME}، {LAYER_INDEX} \-\-field\-strategy نحوه تعیین فیلدهای مقصد از فیلدهای مبدأ. FIELD\-STRATEGY=union|intersection (پیش‌فرض: union) \-s, \-\-input\-crs CRS ورودی \-d, \-\-output\-crs CRS خروجی گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [قابل تکرار] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [قابل تکرار] .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector concat\fP یافت.\& .SS convex\-hull .INDENT 0.0 .INDENT 3.5 .sp .EX * convex\-hull [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- محاسبه پوش محدب هندسه‌های یک مجموعه‌داده برداری. گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-\-active\-geometry نام فیلد هندسه برای محدود کردن پردازش (در صورت عدم تعیین، همه) .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector convex\-hull\fP یافت.\& .SS create .INDENT 0.0 .INDENT 3.5 .sp .EX * create [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- ایجاد یک مجموعه‌داده برداری. آرگومان‌های موضعی: \-o, \-\-output مجموعه‌داده برداری خروجی [الزامی] گزینه‌ها: \-i, \-\-like, \-\-input مجموعه‌داده‌های برداری ورودی مانعة‌الجمع با \-\-schema و \-\-field \-l, \-\-layer, \-\-input\-layer نام لایه(های) ورودی [قابل تکرار] \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (\(dqGDALG\(dq مجاز است) \-\-co, \-\-creation\-option = گزینه ساخت [قابل تکرار] \-\-lco, \-\-layer\-creation\-option = گزینه ساخت لایه [قابل تکرار] \-\-overwrite مجاز بودن بازنویسی مجموعه‌داده خروجی موجود \-\-update باز کردن مجموعه‌داده موجود در حالت به‌روزرسانی \-\-overwrite\-layer مجاز بودن بازنویسی لایه خروجی موجود \-\-output\-layer نام لایه خروجی \-\-geometry\-type نوع هندسه لایه \-\-geometry\-field نام فیلد هندسه جهت ایجاد (در صورت پشتیبانی قالب خروجی) (پیش‌فرض: geom) \-\-crs تنظیم CRS \-\-fid نام ستون FID \-\-schema خواندن OGR_SCHEMA و مقداردهی تعاریف فیلد از روی آن مانعة‌الجمع با \-\-input و \-\-field \-\-field :[(,[,])]> افزودن تعریف یک فیلد به لایه خروجی [قابل تکرار] مانعة‌الجمع با \-\-input و \-\-schema گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [قابل تکرار] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [قابل تکرار] \-\-output\-oo, \-\-output\-open\-option = گزینه‌های باز کردن خروجی [قابل تکرار] .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector create\fP یافت.\& .SS dissolve .INDENT 0.0 .INDENT 3.5 .sp .EX * dissolve [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- ادغام عوارض چندبخشی گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-\-active\-geometry نام فیلد هندسه برای محدود کردن پردازش (در صورت عدم تعیین، همه) .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector dissolve\fP یافت.\&.SS edit .INDENT 0.0 .INDENT 3.5 .sp .EX * edit [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- ویرایش متاداده یک مجموعه‌داده برداری. گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-\-output\-layer نام لایه خروجی \-\-geometry\-type نوع هندسه لایه \-\-crs بازنویسی CRS (بدون بازپروژکشن) \-\-metadata = افزودن/به‌روزرسانی مورد متاداده مجموعه‌داده [قابل تکرار] \-\-unset\-metadata حذف مورد متاداده مجموعه‌داده [قابل تکرار] \-\-layer\-metadata = افزودن/به‌روزرسانی مورد متاداده لایه [قابل تکرار] \-\-unset\-layer\-metadata حذف مورد متاداده لایه [قابل تکرار] \-\-unset\-fid حذف شناسه هر عارضه و نام ستون FID .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal vector edit\fP بیابید\&. .SS explode\-collections .INDENT 0.0 .INDENT 3.5 .sp .EX * explode\-collections [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- تفکیک هندسه‌های نوع مجموعه (collection) در یک مجموعه‌داده برداری. گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-\-active\-geometry نام فیلد هندسه برای محدود کردن پردازش به آن (در صورت عدم تعیین، همه) \-\-geometry\-type نوع هندسه \-\-skip\-on\-type\-mismatch نادیده گرفتن عارضه در صورت شکست در تغییر نوع هندسه عارضه .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal vector explode\-collections\fP بیابید\&. .SS export\-schema .sp در نسخه 3.12 اضافه شد. .INDENT 0.0 .INDENT 3.5 .sp .EX * export\-schema [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- برون‌بری OGR_SCHEMA از یک مجموعه‌داده برداری. آرگومان‌های موقعیتی: گزینه‌ها: \-l, \-\-layer, \-\-input\-layer نام لایه ورودی [قابل تکرار] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal vector export\-schema\fP بیابید\&. .SS external .INDENT 0.0 .INDENT 3.5 .sp .EX * external [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- اجرای یک برنامه خارجی به عنوان مرحله‌ای از یک خط‌لوله (pipeline) آرگومان‌های موقعیتی: \-\-command دستور خارجی، اختیاری با جایگزین‌های و/یا یا [الزامی] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal external\fP بیابید\&. .SS filter .INDENT 0.0 .INDENT 3.5 .sp .EX * filter [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- پالایش یک مجموعه‌داده برداری. گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-\-bbox کادر محدودکننده به صورت xmin,ymin,xmax,ymax \-\-where |@ پرس‌وجوی توصیفی در قالبی محدود از پرس‌وجوهای استفاده‌شده در عبارت SQL WHERE \-\-update\-extent به‌روزرسانی محدوده لایه جهت اعمال فیلتر .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal vector filter\fP بیابید\&. .SS info .sp در نسخه 3.12 اضافه شد. .INDENT 0.0 .INDENT 3.5 .sp .EX * info [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- بازگرداندن اطلاعات مربوط به یک مجموعه‌داده برداری. آرگومان‌های موقعیتی: گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی. OUTPUT\-FORMAT=json|text \-l, \-\-layer, \-\-input\-layer نام لایه ورودی [قابل تکرار] غیرقابل استفاده هم‌زمان با \-\-sql، \-\-fid \-\-features فهرست کردن تمام عوارض (مراقب مصرف RAM در لایه‌های بزرگ باشید) غیرقابل استفاده هم‌زمان با \-\-summary \-\-summary فهرست کردن نام‌های لایه‌ها و نوع هندسه غیرقابل استفاده هم‌زمان با \-\-features \-\-limit محدود کردن تعداد عوارض در هر لایه (مستلزم \-\-features) \-\-sql |@ اجرای عبارت SQL مشخص‌شده و بازگرداندن نتیجه غیرقابل استفاده هم‌زمان با \-\-input\-layer، \-\-fid \-\-where |@ پرس‌وجوی توصیفی در قالبی محدود از پرس‌وجوهای مورد استفاده در عبارت SQL WHERE \-\-fid شناسه عارضه غیرقابل استفاده هم‌زمان با \-\-input\-layer، \-\-sql \-\-dialect گویش SQL گزینه‌های تخصصی: \-\-crs\-format قالب مورد استفاده برای گزارش CRS. CRS\-FORMAT=AUTO|WKT2|PROJJSON (پیش‌فرض: AUTO) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal vector info\fP بیابید\&..SS limit .INDENT 0.0 .INDENT 3.5 .sp .EX * limit [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- محدود کردن یک مجموعه‌داده برداری به حداکثر تعداد مشخصی از عوارض. آرگومان‌های مکانی: \-\-limit محدود کردن تعداد عوارض برای خواندن در هر لایه [اجباری] گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) .EE .UNINDENT .UNINDENT .SS make\-point .INDENT 0.0 .INDENT 3.5 .sp .EX * make\-point [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- ایجاد هندسه‌های نقطه‌ای از فیلدهای توصیفی گزینه‌ها: \-\-x فیلدی که مختصات X باید از آن خوانده شود [اجباری] \-\-y فیلدی که مختصات Y باید از آن خوانده شود [اجباری] \-\-z فیلد اختیاری که مختصات Z باید از آن خوانده شود \-\-m فیلد اختیاری که مختصات M باید از آن خوانده شود \-\-output\-crs سامانه مرجع مختصات (CRS) خروجی .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توانید در \fI\%gdal vector make\-point\fP\& بیابید. .SS make\-valid .INDENT 0.0 .INDENT 3.5 .sp .EX * make\-valid [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- اصلاح اعتبار هندسه‌های یک مجموعه‌داده برداری. گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-\-active\-geometry نام فیلد هندسه برای محدود کردن پردازش به آن (در صورت عدم تعیین، همه) \-\-method الگوریتم مورد استفاده هنگام بازسازی هندسه‌های نامعتبر.. METHOD=linework|structure (پیش‌فرض: linework) \-\-keep\-lower\-dim نگه‌داشتن مؤلفه‌های با بُعد پایین‌تر پس از MakeValid() .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توانید در \fI\%gdal vector make\-valid\fP\& بیابید. .SS materialize .INDENT 0.0 .INDENT 3.5 .sp .EX * materialize [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- مادی‌سازی یک مجموعه‌داده پایپ‌شده بر روی دیسک برای افزایش کارایی مراحل بعدی. گزینه‌ها: \-o, \-\-output نام مجموعه‌داده مادی‌سازی‌شده (ایجادشده توسط الگوریتم) \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی \-\-co, \-\-creation\-option = گزینه ساخت [می‌تواند تکرار شود] \-\-lco, \-\-layer\-creation\-option = گزینه ساخت لایه [می‌تواند تکرار شود] \-\-overwrite آیا رونویسی مجموعه‌داده خروجی موجود مجاز است .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توانید در \fI\%gdal vector materialize\fP\& بیابید. .SS partition .sp در نسخه 3.12 افزوده شد. .INDENT 0.0 .INDENT 3.5 .sp .EX * partition [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- افرازش یک مجموعه‌داده برداری به چند فایل. آرگومان‌های مکانی: \-o, \-\-output پوشه خروجی [اجباری] گزینه‌ها: \-\-overwrite آیا رونویسی مجموعه‌داده خروجی موجود مجاز است مانعة‌الجمع با \-\-append \-\-append آیا الحاق به لایه موجود مجاز است مانعة‌الجمع با \-\-overwrite \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی \-\-co, \-\-creation\-option = گزینه ساخت [می‌تواند تکرار شود] \-\-lco, \-\-layer\-creation\-option = گزینه ساخت لایه [می‌تواند تکرار شود] \-\-field فیلد(های) توصیفی یا هندسی برای افرازش بر پایه آن [می‌تواند تکرار شود] \-\-scheme طرح افرازش. SCHEME=hive|flat (پیش‌فرض: hive) \-\-pattern الگوی نام فایل (\(aqpart_%010d\(aq برای scheme=hive، و \(aq{LAYER_NAME}_{FIELD_VALUE}_%010d\(aq برای scheme=flat) \-\-feature\-limit حداکثر تعداد عوارض در هر فایل \-\-max\-file\-size حداکثر اندازه فایل (می‌توان از پسوند MB یا GB استفاده کرد) \-\-omit\-partitioned\-field آیا فیلدهای افرازش‌شده از تعریف لایه مقصد حذف شوند یا خیر \-\-skip\-errors نادیده گرفتن خطاها هنگام نوشتن عوارض .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توانید در \fI\%gdal vector partition\fP\& بیابید. .SS read .INDENT 0.0 .INDENT 3.5 .sp .EX * read [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- خواندن یک مجموعه‌داده برداری. آرگومان‌های مکانی: \-i, \-\-input مجموعه‌داده‌های برداری ورودی [اجباری] گزینه‌ها: \-l, \-\-layer, \-\-input\-layer نام لایه‌(های) ورودی [می‌تواند تکرار شود] گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [می‌تواند تکرار شود] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [می‌تواند تکرار شود] .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توانید در \fI\%gdal vector pipeline read\fP\& بیابید..SS rename\-layer .INDENT 0.0 .INDENT 3.5 .sp .EX * rename\-layer [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- تغییر نام لایه(های) یک مجموعه‌داده برداری. گزینه‌ها: \-l, \-\-input\-layer نام لایه ورودی \-\-output\-layer نام لایه خروجی \-\-ascii اجبار نام‌ها به نویسه‌های ASCII \-\-lower\-case اجبار نام‌ها به حروف کوچک (تنها روی نویسه‌های ASCII) \-\-filename\-compatible اجبار نام‌ها به امکان استفاده به عنوان نام فایل \-\-reserved\-characters نویسه(های) رزروشده برای حذف \-\-replacement\-character نویسه جایگزین در صورت عدم امکان تبدیل به ASCII \-\-max\-length حداکثر طول نام لایه‌ها .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector rename\-layer\fP\& یافت. .SS reproject .INDENT 0.0 .INDENT 3.5 .sp .EX * reproject [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- بازپروژکت کردن یک مجموعه‌داده برداری. گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-s, \-\-input\-crs CRS ورودی \-d, \-\-output\-crs CRS خروجی [الزامی] .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector reproject\fP\& یافت. .SS segmentize .INDENT 0.0 .INDENT 3.5 .sp .EX * segmentize [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- قطعه‌بندی هندسه‌های یک مجموعه‌داده برداری. آرگومان‌های موقعیتی: \-\-max\-length حداکثر طول یک قطعه [الزامی] گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-\-active\-geometry نام فیلد هندسه برای محدود کردن پردازش (در صورت عدم تعیین، همه) .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector segmentize\fP\& یافت. .SS select .INDENT 0.0 .INDENT 3.5 .sp .EX * select [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- انتخاب زیرمجموعه‌ای از فیلدها از یک مجموعه‌داده برداری. آرگومان‌های موقعیتی: \-\-fields فیلدها برای انتخاب (یا مستثنی کردن در صورت \-\-exclude) [قابل تکرار] [الزامی] گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-\-output\-layer نام لایه خروجی \-\-exclude مستثنی کردن فیلدهای مشخص‌شده غیرقابل استفاده هم‌زمان با \-\-ignore\-missing\-fields \-\-ignore\-missing\-fields نادیده گرفتن فیلدهای ناموجود غیرقابل استفاده هم‌زمان با \-\-exclude .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector select\fP\& یافت. .SS set\-field\-type .INDENT 0.0 .INDENT 3.5 .sp .EX * set\-field\-type [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- تغییر نوع یک فیلد از یک مجموعه‌داده برداری. گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-\-field\-name نام فیلد [الزامی] غیرقابل استفاده هم‌زمان با \-\-input\-field\-type \-\-input\-field\-type نوع یا زیرنوع فیلد مبدأ [الزامی] غیرقابل استفاده هم‌زمان با \-\-field\-name \-\-output\-field\-type, \-\-field\-type نوع یا زیرنوع فیلد مقصد [الزامی] .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector set\-field\-type\fP\& یافت. .SS set\-geom\-type .INDENT 0.0 .INDENT 3.5 .sp .EX * set\-geom\-type [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- تغییر نوع هندسه یک مجموعه‌داده برداری. گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت عدم تعیین، همه) \-\-active\-geometry نام فیلد هندسه برای محدود کردن پردازش (در صورت عدم تعیین، همه) \-\-layer\-only تنها تغییر نوع هندسه لایه غیرقابل استفاده هم‌زمان با \-\-feature\-only \-\-feature\-only تنها تغییر نوع هندسه عوارض غیرقابل استفاده هم‌زمان با \-\-layer\-only \-\-geometry\-type نوع هندسه \-\-multi اجبار هندسه‌ها به انواع هندسی MULTI غیرقابل استفاده هم‌زمان با \-\-single \-\-single اجبار هندسه‌ها به انواع هندسی غیر MULTI غیرقابل استفاده هم‌زمان با \-\-multi \-\-linear تبدیل هندسه‌های منحنی به انواع خطی غیرقابل استفاده هم‌زمان با \-\-curve \-\-curve تبدیل هندسه‌های خطی به انواع منحنی غیرقابل استفاده هم‌زمان با \-\-linear \-\-dim اجبار هندسه‌ها به بعد تعیین‌شده. DIM=XY|XYZ|XYM|XYZM \-\-skip رد کردن عارضه در صورت عدم موفقیت تغییر نوع هندسه آن .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector set\-geom\-type\fP\& یافت..SS simplify .INDENT 0.0 .INDENT 3.5 .sp .EX * simplify [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- ساده‌سازی هندسه‌های یک مجموعه داده برداری. آرگومان‌های موقعیتی: \-\-tolerance تلرانس فاصله برای ساده‌سازی. [الزامی] گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت تعیین نشدن، همه) \-\-active\-geometry نام فیلد هندسه برای محدود کردن پردازش (در صورت تعیین نشدن، همه) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal vector simplify\fP\& بیابید. .SS simplify\-coverage .INDENT 0.0 .INDENT 3.5 .sp .EX * simplify\-coverage [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- ساده‌سازی مرزهای مشترک یک مجموعه داده برداری چندضلعی. آرگومان‌های موقعیتی: \-\-tolerance تلرانس فاصله برای ساده‌سازی. [الزامی] گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت تعیین نشدن، همه) \-\-preserve\-boundary تعیین این‌که آیا مرز بیرونی باید حفظ شود یا خیر. .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal vector simplify\-coverage\fP\& بیابید. .SS sort .INDENT 0.0 .INDENT 3.5 .sp .EX * sort [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- مرتب‌سازی مکانی عوارض در یک لایه گزینه‌ها: \-\-geometry\-field نام فیلد هندسه جهت استفاده در مرتب‌سازی \-\-method الگوریتم مرتب‌سازی هندسه. METHOD=hilbert|strtree (پیش‌فرض: hilbert) \-\-use\-tempfile نوشتن عوارض در یک فایل موقت برای جلوگیری از خواندن کل مجموعه داده ورودی در حافظه .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal vector sort\fP\& بیابید. .SS sql .INDENT 0.0 .INDENT 3.5 .sp .EX * sql [OPTIONS] |@ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- اعمال دستور(ات) SQL بر روی یک مجموعه داده. آرگومان‌های موقعیتی: \-\-sql |@ دستور(ات) SQL [قابل تکرار] [الزامی] گزینه‌ها: \-l, \-\-output\-layer نام لایه(های) خروجی [قابل تکرار] \-\-dialect گویش SQL (مانند OGRSQL, SQLITE) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal vector sql\fP\& بیابید. .SS swap\-xy .INDENT 0.0 .INDENT 3.5 .sp .EX * swap\-xy [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- جابه‌جایی مختصات X و Y در هندسه‌های یک مجموعه داده برداری. گزینه‌ها: \-\-active\-layer تنظیم لایه فعال (در صورت تعیین نشدن، همه) \-\-active\-geometry نام فیلد هندسه برای محدود کردن پردازش (در صورت تعیین نشدن، همه) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal vector swap\-xy\fP\& بیابید. .SS tee .INDENT 0.0 .INDENT 3.5 .sp .EX * tee [OPTIONS] [...] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- هدایت ورودی به جریان خروجی و خط‌لوله‌های تودرتوی جانبی. آرگومان‌های موقعیتی: \-\-tee\-pipeline خط‌لوله تودرتو [1.. values] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%Output nested pipeline\fP\& بیابید. .SS update .INDENT 0.0 .INDENT 3.5 .sp .EX * update [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- به‌روزرسانی یک مجموعه داده برداری موجود با یک مجموعه داده برداری ورودی. آرگومان‌های موقعیتی: \-o, \-\-output مجموعه داده برداری خروجی [الزامی] گزینه‌ها: \-\-input\-layer نام لایه ورودی \-\-output\-layer نام لایه خروجی \-\-mode تنظیم حالت به‌روزرسانی. MODE=merge|update\-only|append\-only (پیش‌فرض: merge) \-\-key فیلد(های) مورد استفاده به‌عنوان کلید برای شناسایی عوارض [قابل تکرار] گزینه‌های پیشرفته: \-\-output\-oo, \-\-output\-open\-option = گزینه‌های باز کردن خروجی [قابل تکرار] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها را می‌توانید در \fI\%gdal vector update\fP\& بیابید..SS write .INDENT 0.0 .INDENT 3.5 .sp .EX * write [OPTIONS] \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- نوشتن یک مجموعه داده برداری. آرگومان‌های موضعی: \-o, \-\-output مجموعه داده برداری خروجی [الزامی] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (مقدار \(dqGDALG\(dq مجاز است) \-\-co, \-\-creation\-option = گزینه ساخت [می‌تواند تکرار شود] \-\-lco, \-\-layer\-creation\-option = گزینه ساخت لایه [می‌تواند تکرار شود] \-\-overwrite آیا رونویسی مجموعه داده خروجی موجود مجاز است \-\-update آیا باز کردن مجموعه داده موجود در حالت به‌روزرسانی مجاز است \-\-overwrite\-layer آیا رونویسی لایه خروجی موجود مجاز است \-\-append آیا الحاق به لایه موجود مجاز است ناسازگار با \-\-upsert \-l, \-\-output\-layer نام لایه خروجی \-\-skip\-errors نادیده گرفتن خطاها هنگام نوشتن عوارض \-\-no\-create\-empty\-layers خودداری از ساخت لایه‌هایی که هیچ عارضه‌ای در آن‌ها نوشته نخواهد شد گزینه‌های پیشرفته: \-\-output\-oo, \-\-output\-open\-option = گزینه‌های باز کردن خروجی [می‌تواند تکرار شود] \-\-upsert درج یا به‌روزرسانی (Upsert) عوارض (مستلزم \(aqappend\(aq است) ناسازگار با \-\-append .EE .UNINDENT .UNINDENT .sp جزئیات مربوط به گزینه‌ها را می‌توان در \fI\%gdal vector pipeline write\fP\& یافت. .SH "خروجی GDALG (مجموعه داده حین اجرا / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp یک خط لوله (pipeline) را می‌توان با استفاده از قالب خروجی \fBGDALG\fP به صورت یک فایل JSON سریال‌سازی کرد. سپس فایل حاصل می‌تواند به عنوان یک مجموعه داده برداری با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز شود و خط لوله مشخص‌شده را به صورت حین اجرا / جریانی اعمال کند. .sp عضو \fBcommand_line\fP در فایل JSON قاعدتاً باید کل خط فرمان بدون مرحله پایانی \fBwrite\fP باشد، و این همان چیزی است که توسط \fBgdal vector pipeline ! .... ! write out.gdalg.json\fP\& تولید می‌شود. .INDENT 0.0 .INDENT 3.5 .sp .EX { \(dqtype\(dq: \(dqgdal_streamed_alg\(dq, \(dqcommand_line\(dq: \(dqgdal vector pipeline ! read in.gpkg ! reproject \-\-output\-crs=EPSG:32632\(dq } .EE .UNINDENT .UNINDENT .sp مرحله پایانی \fBwrite\fP را می‌توان اضافه کرد، اما در این صورت باید صراحتاً قالب خروجی \fBstream\fP و یک نام بی‌اهمیت برای مجموعه داده خروجی را مشخص کند. .INDENT 0.0 .INDENT 3.5 .sp .EX { \(dqtype\(dq: \(dqgdal_streamed_alg\(dq, \(dqcommand_line\(dq: \(dqgdal vector pipeline ! read in.gpkg ! reproject \-\-output\-crs=EPSG:32632 ! write \-\-output\-format=streamed streamed_dataset\(dq } .EE .UNINDENT .UNINDENT .SH "جایگزینی‌ها (SUBSTITUTIONS)" .sp در نسخه 3.12 اضافه شد. .sp امکان استفاده از \fBgdal pipeline\fP برای به‌کارگیری خط لوله‌ای که قبلاً در یک فایل .gdal.json سریال‌سازی شده است وجود دارد، و می‌توان مراحل موجود آن را سفارشی‌سازی کرد؛ به طور معمول تغییر نام یک فایل ورودی، مشخص کردن نام فایل خروجی، یا افزودن/تغییر آرگومان‌های مراحل. .sp بخش \fI\%Substitutions\fP\& را ببینید. .SH "خط لوله تو در تو (NESTED PIPELINE)" .sp در نسخه 3.12 اضافه شد. .sp امکان ایجاد \(dqخطوط لوله تو در تو\(dq وجود دارد، یعنی خطوط لوله‌ای در داخل خطوط لوله دیگر. .sp یک خط لوله تو در تو با براکت‌های چهارگوش (\fB[\fP و \fB]\fP) که با یک نویسه فاصله احاطه شده‌اند، محدود می‌شود. .sp دو نوع خط لوله تو در تو وجود دارد: .INDENT 0.0 .IP \(bu 2 خطوط لوله تو در توی ورودی: جایی که مجموعه داده نتیجه خط لوله تو در تو به عنوان مجموعه داده ورودی برای یک آرگومان از خط لوله اصلی استفاده می‌شود. .IP \(bu 2 خطوط لوله تو در توی خروجی: جایی که خروجی مرحله‌ای از خط لوله اصلی به عنوان ورودی خط لوله تو در تو در مرحله بعدی استفاده می‌شود. خطوط لوله تو در توی خروجی تنها می‌توانند با مرحله \fBtee\fP استفاده شوند. .UNINDENT .sp بخش \fI\%Nested pipeline\fP\& را ببینید. .SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0، و در صورت بروز خطا مقداری غیر صفر را برمی‌گرداند (خطاهای غیر مسدودکننده که به عنوان هشدار ارسال می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: بازتصویر یک فایل GeoPackage به سامانه مرجع مختصات EPSG:32632 (\(dqWGS 84 / UTM zone 32N\(dq) .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector pipeline ! read in.gpkg ! reproject \-\-output\-crs=EPSG:32632 ! write out.gpkg \-\-overwrite .EE .UNINDENT .UNINDENT .SS مثال ۲: سریال‌سازی دستور بازتصویر یک فایل GeoPackage در یک فایل GDALG، و خواندن آن در بعد .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector pipeline ! read in.gpkg ! reproject \-\-output\-crs=EPSG:32632 ! write in_epsg_32632.gdalg.json \-\-overwrite $ gdal vector info in_epsg_32632.gdalg.json .EE .UNINDENT .UNINDENT.SS مثال ۳: ادغام ۲ فایل shapefile مبدأ (با ساختار مشابه)، بازتصویر آن‌ها به EPSG:32632، نگه‌داشتن فقط شهرهای با بیش از ۱ میلیون نفر جمعیت و ذخیره در یک GeoPackage .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector pipeline ! concat \-\-single \-\-output\-crs=EPSG:32632 france.shp belgium.shp ! filter \-\-where \(dqpop > 1e6\(dq ! write out.gpkg \-\-overwrite .EE .UNINDENT .UNINDENT .SS مثال ۴: فیلتر کردن و بازتصویر یک لایه GeoPackage به یک فایل GeoJSON .sp هنگام استفاده از \fI\%select\fP برای محدود کردن فیلدهای خروجی، اطمینان حاصل کنید که وقتی عبارت فیلتر به فیلدها ارجاع می‌دهد، این دستور در خط لوله (pipeline) \fBبعد از\fP مرحلهٔ \fI\%filter\fP قرار گیرد. اگر یک فیلد مورد نیاز فیلتر توسط \fBselect\fP حذف شود، در دسترس نخواهد بود و دستور با این خطا شکست می‌خورد: \fBERROR 1: \(dqworldcity\(dq not recognised as an available field.\fP .sp اگر می‌خواهید خروجی حاوی داده‌های مکانی باشد، باید فیلد هندسه (geometry) را نیز در میان فیلدهای انتخاب‌شده قرار دهید. در این مثال، مجموعه داده مبدأ فاقد ستون هندسه با نام مشخص است. در چنین مواردی می‌توان از فیلد ویژهٔ \fB_ogr_geometry_\fP برای ارجاع به هندسه استفاده کرد. اگر هیچ فیلد هندسه‌ای گنجانده نشود، بازتصویر با این خطا شکست خواهد خورد: \fBERROR 1: reproject: Layer \(aqne_110m_populated_places_simple\(aq has no spatial reference system\fP\&. .sp در نهایت، اطمینان حاصل کنید که بین نام فیلدها در فهرست \fBهیچ فاصله‌ای\fP وجود نداشته باشد. برای مثال: \fB\(dq_ogr_geometry_, name\(dq\fP خطای زیر را ایجاد خواهد کرد: \fBERROR 1: Field \(aq name\(aq does not exist in layer \(aqne_110m_populated_places_simple\(aq.\fP Bash .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vector pipeline \e ! read natural_earth_vector.gpkg \-\-layer ne_110m_populated_places_simple \e ! filter \-\-where \(dqworldcity = 1\(dq \e ! select \-\-fields \(dq_ogr_geometry_,name\(dq \e ! reproject \-\-output\-crs=ESRI:53009 \e ! write worldcity_53009.geojson \-\-overwrite .EE .UNINDENT .UNINDENT PowerShell .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vector pipeline \(ga ! read natural_earth_vector.gpkg \-\-layer ne_110m_populated_places_simple \(ga ! filter \-\-where \(dqworldcity = 1\(dq \(ga ! select \-\-fields \(dq_ogr_geometry_,name\(dq \(ga ! reproject \-\-output\-crs=ESRI:53009 \(ga ! write worldcity_53009.geojson \-\-overwrite .EE .UNINDENT .UNINDENT [تصویر] .SH "نویسندگان (AUTHORS)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .