READSTAT(1)                 General Commands Manual                READSTAT(1)

نام (NAME)
       readstat - خواندن و نوشتن فایل‌های مجموعه‌داده از SAS، SPSS و Stata

خلاصه دستور (SYNOPSIS)
       readstat input-file

       readstat [-f] input-file output-file

       readstat [-f] input-file metadata-file output-file

توضیحات (DESCRIPTION)
       دستور readstat فایل‌های مجموعه‌داده را از بسته‌های آماری محبوب که در هر دو
       قالب متن ساده و باینری ذخیره شده‌اند، تبدیل می‌کند.

       در روش فراخوانی نخست، readstat متاداده‌های موجود در input-file، از جمله
       تعداد سطرها، تعداد ستون‌ها، کدگذاری متن و برچسب زمانی را نمایش می‌دهد.
       input-file باید فایلی با یکی از پسوندهای زیر باشد:

       sas7bdat
              فایل باینری SAS، ساخته‌شده با SAS نسخهٔ ۷ یا جدیدتر

       xpt    فایل پرتابل SAS، نسخهٔ ۵ یا نسخهٔ ۸، ایجادشده با دستور XPORT در
              SAS

       sav    فایل باینری غیرفشردهٔ SPSS

       zsav   فایل باینری فشردهٔ SPSS

       por    فایل پرتابل SPSS

       dta    فایل باینری Stata، نسخهٔ ۱۰۴ یا جدیدتر

       اگر تشخیص تعداد سطرها از سرآیند فایل امکان‌پذیر نباشد (وضعیتی که گاهی در
       فایل‌های باینری SPSS و همواره در فایل‌های پرتابل SPSS رخ می‌دهد)، readstat
       مقدار -1 را گزارش خواهد داد.

       در روش فراخوانی دوم، readstat فایل input-file را به output-file تبدیل
       می‌کند، مانند تبدیل یک فایل پرتابل SAS به یک فایل باینری Stata.  علاوه
       بر فهرست پسوندهای پیشین، output-file می‌تواند دارای پسوند csv یا xlsx
       باشد که به ترتیب یک فایل CSV یا Excel ایجاد می‌کند.

       روش فراخوانی سوم زمانی استفاده می‌شود که متاداده‌های اضافی دربارهٔ فایل
       ورودی، مانند برچسب مقادیر یا عرض ستون‌ها، در یک فایل جداگانه ذخیره شده
       باشد.  چندین نوع فایل متاداده پشتیبانی می‌شود:

       sas7bcat
              فایل «کاتالوگ» باینری SAS، ایجادشده با SAS نسخهٔ ۷ یا جدیدتر،
              شامل برچسب مقادیر

       json   فایل JavaScript Object Notation (JSON)، شامل متاداده‌های ستونی که
              امکان دریافت آن‌ها از فایل CSV ورودی وجود ندارد. برای جزئیات
              بیشتر، صفحهٔ راهنمای دستور extract_metadata را ببینید.

       dct    فایل دیکشنری Stata، شامل چیدمان داده‌ها و متاداده‌های ستون برای یک
              فایل ورودی متنی ساده.

       sps    فایل دستورات SPSS، توصیف‌کنندهٔ چیدمان داده‌ها و متاداده‌های ستون
              برای یک فایل ورودی متنی ساده.

       sps    فایل دستورات SAS، توصیف‌کنندهٔ چیدمان داده‌ها و متاداده‌های ستون
              برای یک فایل ورودی متنی ساده.

       سه قالب پایانی را می‌توان برای هر دو نوع فایل‌های ورودی با عرض ثابت
       (fixed-width) و جداشده با نویسهٔ جداکننده (مانند جداشده با تب) به کار
       برد. این فایل‌ها معمولاً همراه با مجموعه‌داده‌های متنی ASCII توزیع می‌شوند.

       هر دو قالب ورودی و خروجی بر اساس پسوند فایل تعیین می‌شوند.

گزینه‌ها (OPTIONS)
       -f     بازنویسی روی هر output-file موجود.

گزارش باگ‌ها (BUGS)
       فایل‌های باینری SAS ایجادشده توسط readstat با نسخه‌های فعلی SAS باز
       نمی‌شوند.

       جزئیات دقیق‌تر رشته‌های قالب‌بندی (مانند “%8.2g”) به‌درستی میان قالب‌های
       مختلف فایلی تبدیل نمی‌شوند.

نویسندگان (AUTHORS)
       حق نشر (C) 2012-2019 متعلق به Evan Miller و دیگرانی که مشخص شده است.

                                23 January 2019                    READSTAT(1)