.TH "pgsql2shp" "1" "" "" "PostGIS"
.SH "نام (NAME)"
.LP 
pgsql2shp \- استخراج‌کننده داده‌های PostGIS به shapefile

.SH "خلاصه دستور (SYNOPSIS)"
.LP 
pgsql2shp [\fIoptions\fR] \fIdatabase\fR [\fIschema\fR\fB.\fR]\fItable\fR
.br 
pgsql2shp [\fIoptions\fR] \fIdatabase\fR \fIquery\fR

.SH "توضیحات (DESCRIPTION)"
.LP 
ابزار استخراج جدول pgsql2shp مستقیماً به پایگاه‌داده متصل شده و یک جدول (که احتمالاً توسط پرس‌وجوی کاربر ایجاد شده است) را به یک shapefile تبدیل می‌کند. این ابزار با تمام نسخه‌های PostGIS سازگار است.

نسخه: 1.1.5 (2006/10/06)

.SH "نحوه استفاده (USAGE)"
.LP
آرگومان <database> نام پایگاه‌داده‌ای است که باید به آن متصل شد.

آرگومان <table> جدول مورد نظر (به‌صورت اختیاری همراه با مشخصه schema) برای خواندن داده‌های مکانی است. همچنین، می‌توانید یک QUERY مشخص کنید که خروجی آن درون shapefile نوشته شود.

.SH "گزینه‌ها (OPTIONS)"
.LP 
گزینه‌های خط فرمان عبارتند از:
.TP 
\fB\-f\fR <\fIfilename\fR>
نوشتن خروجی در یک نام فایل مشخص.
.TP 
\fB\-h\fR <\fIhost\fR>
میزبان پایگاه‌داده برای اتصال.
.TP 
\fB\-p\fR <\fIport\fR>
درگاه (پورت) برای اتصال در میزبان پایگاه‌داده.
.TP 
\fB\-P\fR <\fIpassword\fR>
گذرواژه مورد استفاده هنگام اتصال به پایگاه‌داده.
.TP 
\fB\-u\fR <\fIuser\fR>
نام کاربری مورد استفاده هنگام اتصال به پایگاه‌داده.
.TP 
\fB\-g\fR <\fIgeometry column\fR>
در مورد جداولی با چند ستون هندسی، مشخص‌کننده ستون هندسه‌ای (geometry) است که هنگام نوشتن shapefile استفاده می‌شود.
.TP 
\fB\-b\fR
استفاده از مکان‌نمای باینری (binary cursor). استفاده از این گزینه در نسخه‌های پیش از 1.0.0 در PostGIS احتمال خطای انحراف مختصات به دلیل تبدیل به قالب WKT و برعکس را کاهش می‌دهد. انحراف مختصات در نسخه 1.0.0 و نسخه‌های جدیدتر PostGIS رخ نمی‌دهد. سرعت آن کمی بیشتر خواهد بود، اما اگر هر ستون غیرهندسی فاقد تبدیل به متن (cast to text) باشد، ممکن است با خطا مواجه شود.
.TP 
\fB\-r\fR
حالت خام (Raw mode). فیلد gid را حذف نکرده و نام ستون‌ها را escape نمی‌کند.
.TP 
\fB\-d\fR
برای سازگاری با نسخه‌های پیشین: هنگام استخراج از پایگاه‌های داده قدیمی PostGIS (پیش از نسخه 1.0.0)، یک shapefile سه‌بُعدی ایجاد می‌کند (در آن حالت پیش‌فرض ایجاد shapefile دوبُعدی است). از نسخه postgis\-1.0.0 به بعد، ابعاد به‌طور کامل کدگذاری می‌شوند.
.TP 
\fB\-k\fR
حفظ بزرگی و کوچکی حروف شناسه‌ها (عدم تبدیل نام فیلدها به حروف بزرگ).
.TP 
\fB\-m\fR <\fIfilename\fR>
مشخص کردن فایلی شامل مجموعه‌ای از نگاشت‌های نام ستون‌های (طولانی) به نام‌های ۱۰ نویسه‌ای ستون‌های DBF. محتوای فایل شامل یک یا چند سطر از دو نام است که با فاصله از هم جدا شده‌اند و هیچ فاصله اضافی در ابتدا یا انتهای سطر وجود ندارد:

COLUMNNAME DBFFIELD1\\n
.br
AVERYLONGCOLUMNNAME DBFFIELD2\\n

و غیره.
.TP
\fB\-?\fR
نمایش نسخه و اطلاعات نحوه استفاده.

.SH "نصب (INSTALLATION)"
.LP
برای کامپایل برنامه از کد منبع، کافی است دستور "make" را در دایرکتوری منبع اجرا کنید. سپس فایل باینری را در مسیر جستجوی شل خود (یا هر کجا که مایلید) کپی کنید. این متن همچنین به صورت یک man page در دایرکتوری ../doc/man/ موجود بوده و آماده کپی شدن در مسیر جستجوی صفحات راهنما در سیستم‌های یونیکسی است.

.SH "مثال‌ها (EXAMPLES)"
.LP 
نمونه‌ای از یک نشست برای ایجاد shapefile از یک پایگاه‌داده با استفاده از این ابزار:

# \fBpgsql2shp \-f myfile \-p 5555 my_db roads_table\fR

.SH "نویسندگان (AUTHORS)"
.LP
در ابتدا توسط Jeff Lounsbury <jeffloun@refractions.net> نوشته شده است.
بهبود یافته و نگهداری شده توسط Sandro Santilli <strk@kbt.io>.
همراه با مشارکت‌ها و بهبودهای کوچک توسط افراد دیگر.

این برنامه از قابلیت‌های shapelib 1.2.9 اثر Frank Warmerdam <warmerda@gdal.velocet.ca> برای نوشتن فایل‌های ESRI Shape استفاده می‌کند.

.SH "همچنین ببینید (SEE ALSO)"
.LP 
shp2pgsql(1)

اطلاعات بیشتر در <http://postgis.net> در دسترس است.