نام (NAME)

kst - رسم داده‌های علمی

خلاصه دستور (SYNOPSIS)

kst
kst: [ -F DATASOURCE ] [ -f STARTFRAME ] [ -n NUMFRAMES ] [ -s FRAMESPERSAMPLE [ -a ] ] kstfile
kst: datasource [ -f STARTFRAME ] [ -n NUMFRAMES ] [ -s FRAMESPERSAMPLE [ -a ] ] [ -P PLOTNAME ] [ -A] [ -d ] [ -l ] [ -b ] [ -x FIELD ] [ -e FIELD ] [ -r RATE ] [ -y FIELD ] [ -p FIELD ] [ -h FIELD ] [ -z FIELD ] [ --png filename ] [ --print filename [ --landscape | --portrait ] [ --Letter | --A4 ] ]

توضیحات (DESCRIPTION)

برنامه kst یک ابزار گرافیکی برای رسم داده‌ها است که شامل قابلیت رسم داده‌های زنده (به‌روزرسانی مداوم نمودار هم‌زمان با در دسترس قرار گرفتن داده‌های جدید) نیز می‌شود.

‏kst می‌تواند به طور کامل از طریق واسط گرافیکی کاربری (GUI) اجرا شود که در این حالت نیازی به هیچ آرگومان خط فرمانی نیست. kst دارای یک راهنمای مرحله‌به‌مرحله (wizard) قدرتمند برای ایجاد و راه‌اندازی آسان نمودارهای جدید است.

در حالت فراخوانی دوم، kst مشخصات نموداری که از قبل ذخیره شده را از فایل kstfile بارگذاری می‌کند و می‌تواند به صورت اختیاری برخی از تنظیمات موجود در آن فایل را بازنویسی کند.

در حالت فراخوانی سوم، kst نمودارهای داده‌ها را مطابق با حالت پیش‌فرض نمایش می‌دهد. منابع داده‌ی اضافی (datasources) را می‌توان در خط فرمان مشخص کرد و گزینه‌های مربوط به هر منبع داده در ادامه آن می‌آیند. گزینه‌های خط فرمان معمولاً بر تمامی گزینه‌های بعدی اعمال می‌شوند مگر اینکه بعداً بازنویسی شوند.

گزینه‌ها (OPTIONS)

-A: رسم تمام منحنی‌ها در نمودارهای جداگانه.
-a: میانگین‌گیری از فریم‌ها (میانگین حسابی ساده) هنگام رسم با -s.
--A4: استفاده از کاغذ اندازه A4 برای چاپ. نیازمند --print.
-b: رسم به صورت نمودار میله‌ای.
-d: استفاده از نقاط هنگام رسم منحنی‌ها.
-e FIELD: استفاده از FIELD به عنوان اندازه نوارهای خطا (error bars) برای نمودار بعدی.
-F datasource: بازنویسی منبع داده‌ی مشخص‌شده در kstfile و استفاده از datasource به جای آن.
-f STARTFRAME: شروع رسم از فریم STARTFRAME درون داده‌ها. برای شروع از NUMFRAMES مانده به انتهای داده‌ها، مقدار آن را روی -1 قرار دهید.
-h FIELD: رسم FIELD به صورت یک هیستوگرام (بافت‌نگار).
-l: استفاده از خطوط پیوسته هنگام رسم منحنی‌ها.
--landscape: استفاده از جهت افقی (landscape) برای چاپ. نیازمند --print. --Letter استفاده از کاغذ اندازه US Letter برای چاپ. نیازمند --print.
-n NUMFRAMES: رسم حداکثر NUMFRAMES فریم از داده‌ها. برای مشخص کردن کل داده‌ها، مقدار آن را روی -1 تنظیم کنید.
-P PLOTNAME: رسم تمام نمودارها در نموداری با نام PLOTNAME.
-p FIELD: رسم FIELD به صورت نمودار طیف توان (power spectrum).
--png filename: رندر کردن در یک تصویر گرافیک شبکه‌ای قابل‌حمل (png) با نام فایل filename و سپس خروج.
--portrait: استفاده از جهت عمودی (portrait) برای چاپ. نیازمند --print.
--print filename: چاپ نمودار در فایل filename و سپس خروج.
-s FRAMESPERSAMPLE: رسم داده‌ها به ازای هر FRAMESPERSAMPLE فریم در هنگام رسم.
-x FIELD: استفاده از FIELD به عنوان بردار محور X.
-y FIELD: رسم FIELD به صورت یک نمودار XY.
-z FIELD: رسم FIELD به صورت یک تصویر.

مثال‌ها (EXAMPLES)

رسم تمام داده‌های ستون ۲ از data.dat:
kst data.dat -y 2

مشابه بالا، با این تفاوت که فقط ۲۰ خط با شروع از خط ۱۰ خوانده می‌شود:
kst data.dat -f 10 -n 20 -y 2

همچنین خواندن ستون ۱؛ یک نمودار به ازای هر منحنی:
kst data.dat -f 10 -n 20 -y 1 -y 2

خواندن ستون ۱ از data2.dat و ستون ۱ از data.dat:
kst data.dat -f 10 -n 20 -y 2 data2.dat -y 1

مشابه بالا، با این تفاوت که ۴۰ خط با شروع از خط ۳۰ در data2.dat خوانده می‌شود:
kst data.dat -f 10 -n 20 -y 2 data2.dat -f 30 -n 40 -y 1

مشخص کردن بردار X و نوارهای خطا: رسم x = ستون ۱ و Y = ستون ۲ و پرچم‌های خطا = ستون ۳ از data.dat:
kst data.dat -x 1 -e 3 -y 2

دریافت بردار X از data1.dat و بردار Y از data2.dat:
kst data1.dat -x 1 data2.dat -y 1

جای‌گذاری: رسم ستون ۲ و ستون ۳ در نمودار P1 و ستون ۴ در نمودار P2:
kst data.dat -P P1 -y 2 -y 3 -P P2 -y 4

گزارش باگ‌ها (BUGS)

لطفاً باگ‌ها و اشکالات را به فهرست رایانامه kst به نشانی kst@kde.org یا به bugzilla مربوط به kde ذیل محصول kst در http://bugs.kde.org گزارش دهید. در صورتی که می‌توانید kst را اجرا کنید، می‌توانید با انتخاب Bug Report Wizard از منوی Help به‌آسانی اشکالات را گزارش نمایید.

نویسندگان (AUTHORS)

Matthew Truch <matt@truch.net>

مجوز (LICENSE)

اجازه‌ی نسخه‌برداری، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (GNU Free Documentation License)، نسخه ۱.۲ یا هر نسخهٔ متأخر دیگری که توسط بنیاد نرم‌افزارهای آزاد (FSF) منتشر شده است، داده می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد و بدون متون پشت جلد. نسخه‌ای از این مجوز در فایل `COPYING.DOC' به عنوان بخشی از بسته توزیع kst گنجانده شده است.