.TH READSTAT 1 "23 January 2019"
.SH "نام (NAME)"
readstat \- خواندن و نوشتن فایل‌های مجموعه‌داده از SAS، SPSS و Stata
.SH "خلاصه دستور (SYNOPSIS)"
.B readstat
.IR input-file
.P
.B readstat
[\fB-f\fR]
.IR input-file
.IR output-file
.P
.B readstat
[\fB-f\fR]
.IR input-file
.IR metadata-file
.IR output-file
.SH "توضیحات (DESCRIPTION)"
دستور
.B readstat
فایل‌های مجموعه‌داده را از بسته‌های آماری محبوب که در هر دو قالب متن ساده و باینری ذخیره شده‌اند، تبدیل می‌کند.
.PP
در روش فراخوانی نخست،
.B readstat
متاداده‌های موجود در \fIinput\-file\fR، از جمله تعداد سطرها، تعداد ستون‌ها، کدگذاری متن و برچسب زمانی را نمایش می‌دهد.
.IR input\-file
باید فایلی با یکی از پسوندهای زیر باشد:
.TP
.IR sas7bdat
فایل باینری SAS، ساخته‌شده با SAS نسخهٔ ۷ یا جدیدتر
.TP
.IR xpt
فایل پرتابل SAS، نسخهٔ ۵ یا نسخهٔ ۸، ایجادشده با دستور XPORT در SAS
.TP
.IR sav
فایل باینری غیرفشردهٔ SPSS
.TP
.IR zsav
فایل باینری فشردهٔ SPSS
.TP
.IR por
فایل پرتابل SPSS
.TP
.IR dta
فایل باینری Stata، نسخهٔ ۱۰۴ یا جدیدتر
.PP
اگر تشخیص تعداد سطرها از سرآیند فایل امکان‌پذیر نباشد (وضعیتی که گاهی در فایل‌های باینری SPSS و همواره در فایل‌های پرتابل SPSS رخ می‌دهد)،
.B readstat
مقدار \-1 را گزارش خواهد داد.
.PP
در روش فراخوانی دوم،
.B readstat
فایل
.IR input-file
را به \fIoutput-file\fR تبدیل می‌کند، مانند تبدیل یک فایل پرتابل SAS به یک فایل باینری Stata.
علاوه بر فهرست پسوندهای پیشین، \fIoutput-file\fR می‌تواند دارای پسوند
.IR csv
یا
\fIxlsx\fR
باشد که به ترتیب یک فایل CSV یا Excel ایجاد می‌کند.
.PP
روش فراخوانی سوم زمانی استفاده می‌شود که متاداده‌های اضافی دربارهٔ فایل ورودی، مانند برچسب مقادیر یا عرض ستون‌ها، در یک فایل جداگانه ذخیره شده باشد.
چندین نوع فایل متاداده پشتیبانی می‌شود:
.TP
.IR sas7bcat
فایل «کاتالوگ» باینری SAS، ایجادشده با SAS نسخهٔ ۷ یا جدیدتر، شامل برچسب مقادیر
.TP
.IR json
فایل JavaScript Object Notation (JSON)، شامل متاداده‌های ستونی که امکان دریافت آن‌ها از فایل CSV ورودی وجود ندارد. برای جزئیات بیشتر، صفحهٔ راهنمای دستور \fBextract_metadata\fR را ببینید.
.TP
.IR dct
فایل دیکشنری Stata، شامل چیدمان داده‌ها و متاداده‌های ستون برای یک فایل ورودی متنی ساده.
.TP
.IR sps
فایل دستورات SPSS، توصیف‌کنندهٔ چیدمان داده‌ها و متاداده‌های ستون برای یک فایل ورودی متنی ساده.
.TP
.IR sps
فایل دستورات SAS، توصیف‌کنندهٔ چیدمان داده‌ها و متاداده‌های ستون برای یک فایل ورودی متنی ساده.
.PP
سه قالب پایانی را می‌توان برای هر دو نوع فایل‌های ورودی با عرض ثابت (fixed-width) و جداشده با نویسهٔ جداکننده (مانند جداشده با تب) به کار برد. این فایل‌ها معمولاً همراه با مجموعه‌داده‌های متنی ASCII توزیع می‌شوند.
.PP
هر دو قالب ورودی و خروجی بر اساس پسوند فایل تعیین می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-f
بازنویسی روی هر \fIoutput-file\fR موجود.
.SH "گزارش باگ‌ها (BUGS)"
فایل‌های باینری SAS ایجادشده توسط \fBreadstat\fR با نسخه‌های فعلی SAS باز نمی‌شوند.
.PP
جزئیات دقیق‌تر رشته‌های قالب‌بندی (مانند \(lq%8.2g\(rq) به‌درستی میان قالب‌های مختلف فایلی تبدیل نمی‌شوند.
.SH "نویسندگان (AUTHORS)"
حق نشر (C) 2012-2019 متعلق به Evan Miller و دیگرانی که مشخص شده است.