funjoin - מקוון בענן

תָכְנִית:

שֵׁם

funjoin - חבר שתי טבלאות בינאריות של FITS או יותר בעמודות שצוינו

תַקצִיר

funjoin [מתגים] ...

אפשרויות

-a cols # עמודות להפעלה בכל הקבצים
-a1 cols ... an cols # עמודות להפעלה בכל קובץ
-b 'c1:bvl,c2:bv2' # ערכים ריקים עבור עמודות נפוצות בכל הקבצים
-bn 'c1:bv1,c2:bv2' # ערכים ריקים עבור עמודות בקבצים ספציפיים
-j col # עמודה כדי להצטרף לכל הקבצים
-j1 col ... jn col # עמודה להצטרפות בכל קובץ
-m min # דקות התאמות לפלט שורה
-M max # max התאמות לפלט שורה
-s # הוסף עמודת סטטוס 'jfiles'
-S col # הוסף קול כעמודת המצב
-t tol # סובלנות להצטרפות של עמודים מספריים [2 קבצים בלבד]

תיאור

funjoin מצטרף לשורות משני או יותר (עד 32) קבצי FITS Table Binary Table, בהתבסס על
ערכים של עמודות צירוף שצוינו בכל קובץ. הערה: על עמודות ההצטרפות להיות אינדקס
קובץ המשויך אליו. קבצים אלה נוצרים באמצעות ה funindex תכנית.

הארגומנט הראשון לתוכנית מציין את טבלת הקלט FITS הראשונה או קובץ האירוע הגולמי.
אם מצוין "stdin", הנתונים נקראים מהקלט הסטנדרטי. הטיעונים הבאים
ציין קבצי אירועים נוספים וטבלאות להצטרפות. הארגומנט האחרון הוא הפלט FITS
קובץ.

הערה: תעשה לֹא השתמש ב-Funtools Bracket Notation כדי לציין הרחבות FITS ומסנני שורות מתי
הפעלת funjoin אחרת תקבל תוצאות שגויות. ניתן לגשת לשורות ולהצטרף אליהן באמצעות ה
אינדקס קבצים ישירות, וזה עוקף את כל הסינון.

עמודות ההצטרפות מצוינות באמצעות ה- -j col switch (המציין שם עמודה ל
להשתמש עבור כל הקבצים) או עם -J1 col1, -J2 col2, ... -jn coln מתגים (המציינים א
שם העמודה לשימוש עבור כל קובץ). יש לציין עמודת הצטרפות לכל קובץ. אם שניהם
-j col ו -jn coln מצוינים עבור קובץ נתון, ולאחר מכן נעשה שימוש באחרון. הצטרף לעמודות
חייב להיות מסוג מחרוזת או מסוג מספרי; זה לא חוקי לערבב מספרי מחרוזת
עמודות בצירוף נתון. לדוגמה, כדי לצרף שלושה קבצים באמצעות אותה עמודת מפתח עבור
כל קובץ, השתמש ב:

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

ניתן לציין מפתח אחר עבור הקובץ השלישי בדרך זו:

funjoin -j key -j3 otherkey in1.fits in2.fits in3.fits out.fits

אל האני -a "קולות" מתג (ו -A1 "col1", -A2 "קולס2" עמיתים) ניתן להשתמש כדי לציין
עמודות להפעלה (כלומר לכתוב לקובץ הפלט) עבור כל קובץ קלט. כברירת מחדל, הכל
עמודות יוצאות.

אם לשתי עמודות או יותר מקבצים נפרדים יש את אותו שם, השני (ואחריו)
שמות העמודות משתנים כך שיצרפו קו תחתון וערך מספרי.

אל האני -m דקות ו -M מקסימום מתגים מציינים את המספר המינימלי והמקסימלי של חיבורים הנדרשים
לכתוב שורה. ברירת המחדל המינימלית היא 0 חיבורים (כלומר כל השורות נכתבות החוצה) וה-
ברירת המחדל המקסימלית היא 63 (המספר המרבי של חיבורים אפשריים עם הגבלה של 32 קלט
קבצים). לדוגמה, לכתוב רק את השורות שבהן בדיוק לשני קבצים יש עמודות
אותה התאמה (כלומר הצטרפות אחת):

funjoin -j key -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' ...
ניתן להשתמש במתגים כדי להגדיר את הערך הריק עבור עמודות המשותפות לכל הקבצים ו/או העמודות
בקובץ שצוין, בהתאמה. כל מחרוזת ערך ריקה מכילה רשימה מופרדת בפסיקים
של מפרטי column:blank_val. עבור ערכי נקודה צפה (יחיד או כפול), מקרה-
ערך מחרוזת לא רגישה של "nan" פירושו שיש להשתמש ב-IEEE NaN (לא-מספר).
כך, למשל:

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

פירושו שעמודת AKEY שאינה מצטרפת בכל קובץ תכיל את המחרוזת "???", את הלא-
הצטרף עמודה של קובץ 1 תכיל ערך של -1, עמודת G שאינה מצורפת של קובץ 3
יכיל IEEE NaNs, בעוד העמודות E ו-F שאינן מחוברות של אותו קובץ יכילו
ערכים -1 ו -100, בהתאמה. כמובן, היכן שערכים ריקים נפוצים וספציפיים נמצאים
שצוין עבור אותה עמודה, נעשה שימוש בערך הריק הספציפי.

כדי להבחין אילו קבצים הם רכיבים לא ריקים של שורה נתונה, ה- -s מתג (סטטוס).
ניתן להשתמש כדי להוסיף עמודת bitmask בשם "JFILES" לקובץ הפלט. בטור זה, א
ביט מוגדר עבור כל קובץ שאינו ריק המרכיב את השורה הנתונה, כאשר סיביות 0 מתאימה ל-
הקובץ הראשון, סיביות 1 לקובץ השני וכן הלאה. שמות הקבצים עצמם מאוחסנים ב
הכותרת FITS כפרמטרים בשם JFILE1, JFILE2 וכו' -S col מתג מאפשר לך
שנה את השם של עמודת המצב מברירת המחדל "JFILES".

צירוף בין שורות הוא המכפלה הקרטזית של כל השורות בקובץ אחד עם צירוף נתון
ערך עמודה כאשר לכל השורות בקובץ שני יש את אותו ערך עבור עמודת החיבור שלו ו
בקרוב. לפיכך, אם לקובץ 1 יש 2 שורות עם ערך עמודת הצטרפות 100, לקובץ 2 יש 3 שורות עם
אותו ערך, ולקובץ 3 יש 4 שורות, אז ה-join גורם לפלט של 2*3*4=24 שורות.

אלגוריתם ההצטרפות מעבד ישירות את קובץ האינדקס המשויך לעמודת ההצטרפות של
כל קובץ. הערך הקטן ביותר מבין כל העמודות הנוכחיות נבחר כבסיס, וזה
הערך משמש לצירוף עמודות שוות ערך בקבצים האחרים. בדרך זו, המדד
קבצים עוברים פעם אחת בדיוק.

אל האני -t tol switch מציין ערך סובלנות עבור עמודות מספריות. נכון לעכשיו, א
ערך סובלנות יכול להצטרף רק שני קבצים בו-זמנית. (אלגוריתם שונה לחלוטין הוא
נדרש להצטרף ליותר משני קבצים תוך שימוש בסובלנות, משהו שנוכל לשקול
ליישם בעתיד.)

הדוגמה הבאה מציגה רבות מהתכונות של funjoin. קבצי הקלט t1.fits,
t2.fits ו-t3.fits מכילים את העמודות הבאות:

[ש] fundisp t1.fits
AKEY KEY AB
----------- ------ ------ ------
aaa 0 0 1
bbb 1 3 4
ccc 2 6 7
ddd 3 9 10
eee 4 12 13
fff 5 15 16
ggg 6 18 19
חחח 7 21 22

fundisp t2.fits
תקליטור AKEY KEY
----------- ------ ------ ------
III 8 24 25
ggg 6 18 19
eee 4 12 13
ccc 2 6 7
aaa 0 0 1

fundisp t3.fits
AKEY KEY EFG ------------ ------------------------------
-----------
ggg 6 18 19 100.10
jjj 9 27 28 200.20
aaa 0 0 1 300.30
ddd 3 9 10 400.40

בהתחשב בקבצי הקלט האלה, הפקודה funjoin הבאה:

funjoin -s -a1 "-B" -a2 "-D" -a3 "-E" -b \
"מפתח:???" -b1 "AKEY:XXX,A:255" -b3 "G:NaN,E:-1,F:-100" \
-j key 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 300.30 7
בבב 1 3 ??? 0 0 ??? 0 -100 נאן 1
ccc 2 6 ccc 2 6 ??? 0 -100 נאן 3
ddd 3 9 ??? 0 0 ddd 3 10 400.40 5
eee 4 12 eee 4 12 ??? 0 -100 נאן 3
fff 5 15 ??? 0 0 ??? 0 -100 נאן 1
ggg 6 18 ggg 6 18 ggg 6 19 100.10 7
חחח 7 21 ??? 0 0 ??? 0 -100 נאן 1
XXX 0 255 iii 8 24 ??? 0 -100 נאן 2
XXX 0 255 ??? 0 0 jjj 9 28 200.20 4

השתמש ב-funjoin באינטרנט באמצעות שירותי onworks.net