funtable - عبر الإنترنت في السحابة

برنامج:

اسم

funtable - نسخ الصفوف المحددة من ملف Funtools إلى جدول ثنائي FITS

موجز

funtable [-a] [-i⎪-z] [-m] [-s cols] [الأعمدة]

OPTIONS

-a # إلحاق بملف الإخراج الموجود كملحق للجدول
-i # بالنسبة لبيانات الصورة، قم بإنشاء أعمدة X وY فقط
-m# بالنسبة للجداول اكتب ملف منفصل لكل منطقة
-s "col1..." # الأعمدة التي سيتم الفرز عليها
-z # لبيانات الصورة، قم بإخراج وحدات بكسل ذات قيمة صفرية

الوصف

funtable تحديد صفوف من ملحق FITS المحدد (الجدول الثنائي فقط) لـ FITS
ملف، أو من ملف حدث أولي غير FITS، ويكتب تلك الصفوف إلى جدول ثنائي FITS
ملف. كما سيتم إنشاء جدول ثنائي FITS من صورة أو ملف صفيف أولي.

تحدد الوسيطة الأولى للبرنامج ملف FITS أو ملف الحدث الخام أو الصفيف الخام
ملف. إذا تم تحديد "stdin" ، تتم قراءة البيانات من الإدخال القياسي. استخدم Funtools
ترميز الأقواس لتحديد امتدادات ومرشحات FITS. الحجة الثانية هي
ملف الإخراج يناسب. إذا تم تحديد "stdout" ، تتم كتابة الجدول الثنائي FITS على
الإخراج القياسي. بشكل افتراضي، يتم نسخ كافة أعمدة ملف الإدخال إلى ملف الإخراج.
يمكن إخراج الأعمدة المحددة باستخدام وسيطة ثالثة اختيارية في النموذج:

"عمود 1 عمود 1 ... عمود N"

• funtable يُستخدم البرنامج عمومًا لتحديد الصفوف من جدول ثنائي FITS باستخدام Table
عوامل التصفية و/أو عوامل تصفية المنطقة المكانية. على سبيل المثال، يمكنك نسخ الصفوف المحددة فقط (و
إخراج الأعمدة المحددة فقط) عن طريق تنفيذ أمر مثل:

[sh] funtable "test.ev[pha==1&&pi==10]" stdout "xy pi pha" ⎪fundisp stdin
XY فا بي
------- ------- ------- ---------
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10

العمود الخاص المنطقة $ يمكن تحديدها لكتابة معرف المنطقة لكل صف:

[sh $] funtable "test.ev[time-(int)time>=.99&&annulus(0 0 0 10 n=3)]" stdout 'xy time $REGION' ⎪fundisp stdin
منطقة زمنية XY
-------- -------- --------------------- ----------
5 -6 40.99000000 3
4 -5 59.99000000 2
-1 0 154.99000000 1
-2 1 168.99000000 1
-3 2 183.99000000 2
-4 3 199.99000000 2
-5 4 216.99000000 2
-6 5 234.99000000 3
-7 6 253.99000000 3

هنا فقط صفوف ذات وقت كسري مناسب وموضعها أيضًا ضمن واحد من
الحلقات الثلاثة مكتوبة.

يمكن استبعاد الأعمدة من العرض باستخدام علامة الطرح قبل العمود:

[sh $] funtable "test.ev[time-(int)time>=.99]" stdout "-time" ⎪fundisp stdin
XY PHA PI DX DY
-------- -------- -------- ---------- ----------- ----- ------
5-6 5 -6 5.50 -6.50
4-5 4 -5 4.50 -5.50
-1 0 -1 0-1.50 0.50
-2 1 -2 1-2.50 1.50
-3 2 -3 2-3.50 2.50
-4 3 -4 3-4.50 3.50
-5 4 -5 4-5.50 4.50
-6 5 -6 5-6.50 5.50
-7 6 -7 6-7.50 6.50

تتم كتابة جميع الأعمدة باستثناء عمود الوقت.

بشكل عام ، قواعد تنشيط وإلغاء تنشيط الأعمدة هي:

· إذا تم تحديد أعمدة الاستبعاد فقط ، فسيتم تحديد جميع الأعمدة باستثناء أعمدة الاستبعاد
يتم تفعيلها.

· إذا تم تحديد تضمين الأعمدة فقط ، فسيتم تنشيط الأعمدة المحددة فقط.

· إذا تم تحديد مزيج من أعمدة التضمين والاستبعاد ، فحينئذٍ يتم تحديد الكل ما عدا الاستثناء
الأعمدة ستكون نشطة ؛ هذه الحالة الأخيرة غامضة والقاعدة تعسفية.

بالإضافة إلى تحديد أسماء الأعمدة بشكل صريح والرموز الخاصة + و - يمكن أن يكون
تستخدم للتنشيط وإلغاء التنشيط من جميع الأعمدة. هذا مفيد إذا كنت تريد تنشيط ملف
العمود $ REGION مع جميع الأعمدة الأخرى. وفقًا للقواعد ، فإن بناء الجملة "$ REGION"
يقوم فقط بتنشيط عمود المنطقة وإلغاء تنشيط الباقي. استخدم "+ $ REGION" للتفعيل
كل الأعمدة بالإضافة إلى عمود المنطقة.

عادةً، يتم نسخ الجدول المحدد فقط إلى ملف الإخراج. في جدول ثنائي FITS،
في بعض الأحيان يكون من المرغوب فيه نسخ كافة ملحقات FITS الأخرى إلى ملف الإخراج كـ
حسنًا. يمكن القيام بذلك عن طريق إلحاق علامة "+" باسم الامتداد في الإدخال
اسم الملف. على سبيل المثال، يقوم الأمر الأول الموجود أدناه بنسخ جدول EVENT فقط، بينما يقوم الأمر
يقوم الأمر الثاني بنسخ الامتدادات الأخرى أيضًا:

[sh] funtable "/proj/rd/data/snr.ev[EVENTS]" events.ev
[sh] funtable "/proj/rd/data/snr.ev[EVENTS+]" eventsandmore.ev

إذا كان ملف الإدخال صورة أو ملف مصفوفة خام، إذن funtable سوف تولد FITS
جدول ثنائي من قيم البكسل في الصورة. لاحظ أنه ليس من الممكن تحديد
الأعمدة المراد إخراجها (باستخدام وسيطة سطر الأوامر 3). بدلا من ذلك، هناك طريقتان ل
إنشاء مثل هذا الجدول الثنائي من الصورة. بشكل افتراضي، يتم إنشاء جدول مكون من 3 أعمدة، حيث
الأعمدة هي "X" و"Y" و"VALUE". لكل بكسل في الصورة صف واحد (حدث)
يتم إنشاؤه باستخدام الأعمدة "X" و"Y" المخصصة لقيم dim1 وdim2 للصورة
بكسل، على التوالي، وقام العمود "VALUE" بتعيين قيمة البكسل. مع نوع من
الجدول، تشغيل com.funhist في العمود "VALUE" سيعطي نفس نتائج التشغيل com.funhist
على الصورة الأصلية.

إذا كان -i تم تحديد مفتاح التبديل ("الصفوف الفردية")، ثم تم تحديد العمودين "X" و"Y" فقط
ولدت. في هذه الحالة، كل قيمة بكسل موجبة في الصورة تولد عدد n من الصفوف (الأحداث)،
حيث n تساوي القيمة الصحيحة لهذا البكسل (بالإضافة إلى 0.5 للنقطة العائمة
بيانات). في الواقع، -i تقريبًا يعيد إنشاء صفوف الجدول التي كان من الممكن أن تكون
تم إهمالها في صورة الإدخال. (وبطبيعة الحال، هذا صحيح تقريبا فقط، منذ
تم دمج مواضع x وy الناتجة.)

إذا كان -s [العمود1 col2 العمود] تم تحديد رمز التبديل ("الفرز") لصفوف الإخراج الثنائية
سيتم فرز الجدول باستخدام الأعمدة المحددة كمفاتيح فرز. يجب أن تكون مفاتيح الفرز
الأعمدة العددية وأيضًا يجب أن تكون جزءًا من ملف الإخراج (أي لا يمكنك الفرز على عمود
ولكن لا تدرجه في الإخراج). يستخدم هذا المرفق _نوع البرنامج (متضمن
funtools)، والتي يجب الوصول إليها عبر المسار الخاص بك.

بالنسبة للجداول الثنائية، -m سيقوم المفتاح ("ملفات متعددة") بإنشاء ملف منفصل لكل منها
المنطقة في مواصفات المرشح، أي أن كل ملف يحتوي فقط على الصفوف من تلك المنطقة.
يتم أيضًا وضع الصفوف التي تجتاز عامل التصفية ولكنها ليست في أي منطقة في ملف منفصل.

أسماء ملفات الإخراج المنفصلة التي تم إنشاؤها بواسطة -m يتم إنتاج التبديل تلقائيا من
ملف الإخراج الجذري الذي يحتوي على معرف المنطقة للمنطقة المرتبطة. (لاحظ تلك المنطقة
تبدأ المعرفات بالرقم 1، بحيث يحتوي اسم الملف المرتبط بالمعرف 0 على صفوف تمرر الملف
filter ولكنها ليست في أي منطقة معينة.) يتم إنشاء أسماء ملفات الإخراج على النحو التالي:

· يمكن استخدام مواصفات $n في أي مكان في اسم الملف الجذر (مقتبس بشكل مناسب لـ
حمايته من الصدفة) وسيتم توسيعه ليكون رقم المعرف المرتبط
منطقة. على سبيل المثال:

funtable -m input.fits'[cir(512,512,1);cir(520,520,1)...]' 'foo.goo_$n.fits'

سيقوم بإنشاء ملفات باسم foo.goo_0.fits (للصفوف غير الموجودة في أي منطقة ولكنها لا تزال تمر
الفلتر)، foo.goo_1.fits (الصفوف في معرف المنطقة رقم 1، المنطقة الأولى)، foo.goo_2.fits
(الصفوف في معرف المنطقة رقم 2)، وما إلى ذلك. لاحظ أن علامات الاقتباس المفردة في جذر الإخراج مطلوبة
لحماية "$" من الصدفة.

· إذا لم يتم تحديد $n، فسيتم وضع معرف المنطقة قبل النقطة الأولى (.) في
اسم الملف. هكذا:

funtable -m input.fits'[cir(512,512,1);cir(520,520,1)...]' foo.evt.fits

سيقوم بإنشاء ملفات باسم foo0.evt.fits (للصفوف غير الموجودة في أي منطقة ولكنها لا تزال تمر
عامل التصفية)، foo1.evt.fits (الصفوف في معرف المنطقة رقم 1)، foo2.evt.fits (الصفوف في معرف المنطقة
رقم 2)، الخ.

· إذا لم يتم تحديد أي نقطة في اسم ملف الإخراج الجذري، فسيتم تحديد معرف المنطقة
تم إلحاقه باسم الملف. هكذا:

funtable -m input.fits'[cir(512,512,1);cir(520,520,1)...]' 'foo_evt'

سيقوم بإنشاء ملفات باسم foo_evt0 (للصفوف غير الموجودة في أي منطقة ولكنها لا تزال تمرر ملف
filter)، foo_evt1 (الصفوف في معرف المنطقة رقم 1)، foo_evt2 (الصفوف في معرف المنطقة رقم 2)، إلخ.

توفر آلية الملفات المتعددة طريقة بسيطة لإنشاء ملفات بيانات مصدر فردية
مع مرور واحد من خلال البيانات.

بشكل افتراضي، يتم إنشاء ملف FITS جديد وتتم كتابة الجدول الثنائي إلى الأول
امتداد. إذا -a (إلحاق) تم تحديد التبديل، ويتم إلحاق الجدول بجدول موجود
FITS الملف كملحق BINTABLE. لاحظ أن ملف الإخراج FITS يجب أن يكون موجودًا بالفعل.

إذا كان -z تم تحديد مفتاح التبديل (قيم البكسل "صفر") و -i لم يتم تحديد، ثم بكسل
سيتم إخراج قيمة صفرية مع تعيين العمود "VALUE" على الصفر. ومن الواضح أن هذا
لا يكون التبديل منطقيًا عند إخراج الأحداث الفردية.

استخدم funtable عبر الإنترنت باستخدام خدمات onworks.net