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

برنامج:

اسم

funjoin - انضم إلى جدولين أو أكثر من جداول FITS الثنائية على أعمدة محددة

موجز

com.funjoin [مفاتيح] ...

OPTIONS

-عمود # أعمدة للتفعيل في جميع الملفات
-a1 عمودًا ... عمودًا # أعمدة للتنشيط في كل ملف
-b 'c1: bvl، c2: bv2' # قيم فارغة للأعمدة المشتركة في جميع الملفات
-bn 'c1: bv1، c2: bv2' # قيم فارغة للأعمدة في ملفات معينة
-j col # للانضمام إلى جميع الملفات
-j1 col ... عمود jn # للانضمام إلى كل ملف
-m min # min مطابقة لإخراج صف
-M max # max يتطابق مع إخراج صف
-s # إضافة عمود الحالة "jfiles"
-S col # إضافة عمود كعمود حالة
-t tol # التسامح للانضمام إلى الأعمدة الرقمية [ملفان فقط]

الوصف

com.funjoin ينضم إلى صفوف من ملفين أو أكثر (حتى 32) ملف FITS Binary Table ، بناءً على ملف
قيم أعمدة الربط المحددة في كل ملف. ملحوظة: يجب أن تحتوي أعمدة الصلة على فهرس
الملف المرتبط به. يتم إنشاء هذه الملفات باستخدام الامتداد funindex برنامج.

تحدد الوسيطة الأولى للبرنامج أول جدول FITS أو ملف حدث خام.
إذا تم تحديد "stdin" ، تتم قراءة البيانات من الإدخال القياسي. الحجج اللاحقة
تحديد ملفات وجداول أحداث إضافية للانضمام إليها. الوسيطة الأخيرة هي إخراج FITS
ملف.

ملحوظة: افعل ليس استخدم Funtools Bracket Notation لتحديد امتدادات FITS ومرشحات الصفوف عندما
تشغيل funjoin أو ستحصل على نتائج خاطئة. يتم الوصول إلى الصفوف وضمها باستخدام ملف
ملفات الفهرس مباشرة ، وهذا يتجاوز جميع عمليات التصفية.

يتم تحديد أعمدة الصلة باستخدام -j العقيد التبديل (الذي يحدد اسم العمود لـ
تستخدم لجميع الملفات) أو مع -j1 col1, -j2 col2... -جن عمود مفاتيح (التي تحدد أ
اسم العمود المراد استخدامه لكل ملف). يجب تحديد عمود الصلة لكل ملف. إذا كان كل من
-j العقيد و -جن عمود لملف معين ، ثم يتم استخدام الأخير. ربط الأعمدة
يجب أن يكون إما من نوع سلسلة أو نوع رقمي ؛ من غير القانوني خلط الأرقام والسلسلة
أعمدة في صلة معينة. على سبيل المثال ، لضم ثلاثة ملفات باستخدام نفس عمود المفتاح لـ
كل ملف ، استخدم:

funjoin -j key in1.fits in2.fits out.fits

يمكن تحديد مفتاح مختلف للملف الثالث بهذه الطريقة:

funjoin -j مفتاح -j3 مفتاح آخر in1.fits in2.fits in3.fits out.fits

• -a "عمود" التبديل (و -أ 1 "col1", -أ 2 "cols2" نظرائهم) يمكن استخدامها لتحديد
أعمدة للتنشيط (أي الكتابة إلى ملف الإخراج) لكل ملف إدخال. بشكل افتراضي ، كل
يتم إخراج الأعمدة.

إذا كان هناك عمودان أو أكثر من ملفات منفصلة لهما نفس الاسم ، فإن الثاني (واللاحق)
تتم إعادة تسمية الأعمدة بحيث يتم إلحاق شرطة سفلية وقيمة رقمية.

• -m دقيقة و -M ماكس تحدد المفاتيح الحد الأدنى والحد الأقصى لعدد الوصلات المطلوبة
اكتب صفًا. الحد الأدنى الافتراضي هو 0 صلات (أي تمت كتابة جميع الصفوف) و
الحد الأقصى الافتراضي هو 63 (الحد الأقصى لعدد الصلات الممكنة بحد 32 إدخالًا
الملفات). على سبيل المثال ، لكتابة تلك الصفوف التي تحتوي على أعمدة لملفين بالضبط
تلك المطابقة (على سبيل المثال ، انضمام واحد):

funjoin -j مفتاح -m 1 -M 1 in1.fits in2.fits in3.fits ... out.fits

يمكن أن يحتوي صف معين على العدد المطلوب من الصلات دون ضم جميع الملفات
(على سبيل المثال ، يتم ضم ثلاثة ملفات ولكن ملفين فقط لهما قيمة مفتاح ربط معينة). في هذا
في الحالة ، تتم كتابة جميع أعمدة الملف غير المرتبط ، افتراضيًا ، باستخدام الفراغات
(أصفار أو NULL). ال -b c1: bv1 ، c2: bv2 و -b1 'c1: bv1، c2: bv2' -b2 'c1: bv1، c2 - bv2' ...
يمكن استخدام مفاتيح التبديل لتعيين القيمة الفارغة للأعمدة المشتركة لجميع الملفات و / أو الأعمدة
في ملف محدد ، على التوالي. تحتوي كل سلسلة قيمة فارغة على قائمة مفصولة بفواصل
العمود: محددات blank_val. لقيم النقطة العائمة (مفردة أو مزدوجة) ، حالة-
تعني قيمة السلسلة غير الحساسة لـ "nan" أنه يجب استخدام IEEE NaN (ليس رقمًا).
وهكذا ، على سبيل المثال:

funjoin -b "AKEY: ؟؟؟" -b1 "A: -1" -b3 "G: NaN ، E: -1 ، F: -100" ...

يعني أن عمود AKEY غير المرتبط في أي ملف سيحتوي على السلسلة "؟؟؟" ، غير
مرتبط سيحتوي عمود الملف 1 على قيمة -1 ، عمود G غير المرتبط بالملف 3
سيحتوي على IEEE NaN ، بينما سيحتوي الأعمدة E و F غير المرتبطة بالملف نفسه
القيمتان -1 و -100 على التوالي. بالطبع ، حيث توجد قيم فارغة عامة ومحددة
المحدد لنفس العمود ، يتم استخدام القيمة الفارغة المحددة.

لتمييز الملفات التي هي مكونات غير فارغة لصف معين ، يتم استخدام ملف -s (الحالة) التبديل
يمكن استخدامها لإضافة عمود قناع بت باسم "JFILES" إلى ملف الإخراج. في هذا العمود ، أ
يتم تعيين البتة لكل ملف غير فارغ يتألف من صف معين ، مع البت 0 يتوافق مع
الملف الأول ، بت 1 إلى الملف الثاني ، وهكذا. يتم تخزين أسماء الملفات نفسها في
رأس FITS كمعلمات تسمى JFILE1 ، JFILE2 ، إلخ -S العقيد يسمح لك التبديل
تغيير اسم عمود الحالة من الافتراضي "JFILES".

الوصلة بين الصفوف هي المنتج الديكارتي لجميع الصفوف في ملف واحد له صلة معينة
قيمة العمود مع جميع الصفوف في ملف ثانٍ لها نفس القيمة لعمود الصلة و
قريباً. وبالتالي ، إذا كان file1 يحتوي على صفين بقيمة عمود الصلة 2 ، فإن file100 يحتوي على 2 صفوف بامتداد
نفس القيمة ، و file3 بها 4 صفوف ، ثم ينتج عن الصلة 2 * 3 * 4 = 24 صفًا يتم إخراجها.

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

• -t تول يحدد رمز التبديل قيمة التفاوت للأعمدة الرقمية. في الوقت الحاضر ، أ
يمكن لقيمة التسامح ضم ملفين فقط في المرة الواحدة. (خوارزمية مختلفة تمامًا هي
مطلوب للانضمام إلى أكثر من ملفين باستخدام التسامح ، في وقت ما قد نعتبره
التنفيذ في المستقبل.)

يوضح المثال التالي العديد من ميزات funjoin. ملفات الإدخال t1.fits ،
تحتوي t2.fits و t3.fits على الأعمدة التالية:

[sh] Fundisp t1.fits
AKEY KEY AB
----------- ------ ------ ------
أأ 0 0 1
ب ب 1 3 4
سي سي سي 2 6 7
دي دي 3 9 10
4 12 13
صص ٥٥١-١٦
6 18 ggg 19
ههه 7 21 22

Fundisp t2.fits
قرص مضغوط AKEY KEY
----------- ------ ------ ------
ثالثا 8 24 25
6 18 ggg 19
4 12 13
سي سي سي 2 6 7
أأ 0 0 1

Fundisp t3.fits
AKEY KEY EFG ------------ ------ -------- --------- آكي كي إي إف جي
-----------
ggg 6 18 19
jjj 9 27 28
أأ 0 0 1 300.30
ddd 3 9 10

بالنظر إلى ملفات الإدخال هذه ، الأمر funjoin التالي:

funjoin -s -a1 "-B" -a2 "-D" -a3 "-E" -b \
"مفتاح:؟؟؟" -b1 "AKEY: XXX، A: 255" -b3 "G: NaN، E: -1، F: -100" \
-j مفتاح t1.fits t2.fits t3.fits foo.fits

سينضم إلى الملفات الموجودة في العمود KEY ، وإخراج جميع الأعمدة باستثناء B (في t1.fits) ، D (بتنسيق
t2.fits) و E (في t3.fits) ، وتعيين قيم فارغة لـ AKEY (بشكل عام ، ولكن تم تجاوزها
لـ t1.fits) و A (في الملف 1) و G و E و F (في الملف 3). سيكون عمود JFILES
الإخراج للإشارة إلى الملفات التي تم استخدامها في كل صف:

AKEY KEY A AKEY_2 KEY_2 C AKEY_3 KEY_3 FG JFILES
------------ ------ ------ ------------ ------ ------ - ---------- ------ -------- ----------- --------
aaa 0 0 aaa 0 0 aaa 0 1
ب ب 1 3 ؟؟؟ 0 0 ؟؟؟ 0-100 نان 1
ccc 2 6 ccc 2 6 ؟؟؟ 0-100 نان 3
ddd 3 9 ؟؟؟ 0 0 يوم 3 10
eee 4 12 eee 4 12 ؟؟؟ 0-100 نان 3
fff 5 15 ؟؟؟ 0 0 ؟؟؟ 0-100 نان 1
ggg 6 18 gg 6 18 gg 6 19
هههه 7 21 ؟؟؟ 0 0 ؟؟؟ 0-100 نان 1
XXX 0 iii 255 8 ؟؟؟ 24-0 نان 100
XXX 0 ؟؟؟ 255 0 jj 0 9

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