نام (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 و دیگرانی که مشخص شده است.