funcone - מקוון בענן

תָכְנִית:

שֵׁם

funcone - חיפוש קונוס של טבלה בינארית המכילה עמודות RA, Dec

תַקצִיר

funcone [עמודות]

אפשרויות

-d deccol:[hdr] # שם עמודה Dec, units (def: DEC:d)
-j # הצטרף לעמודות מקובץ רשימה
-J # הצטרף לעמודות מקובץ רשימה, פלט את כל השורות
-l listfile # קרא מרכזים ורדיוסים מתוך רשימה
-L listfile # לקרוא מרכזים ורדיוסים מתוך רשימה, שורות רשימת פלט
-n # אל תשתמש במגבלות חרוט כמסנן
-r racol:[hdr] # שם עמודה RA, יחידות (בהגדרה: RA:h)
-x # הוסף RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY cols
-X # הוסף RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY cols, פלט את כל השורות

תיאור

Funcone מבצע חיפוש קונוס בעמודות RA ו-Dec של טבלה בינארית FITS. ה
מרחק מהמרכז RA, מיקום ירידה ל-RA, ירידה בכל שורה בטבלה היא
מְחוֹשָׁב. שורות שהמרחק שלהן קטן מהרדיוס שצוין יוצאות.

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

הטיעונים הדרושים השלישי והרביעי הם עמדת RA ו-Dec במרכז. כברירת מחדל,
RA מצוין בשעות ואילו דצמבר מצוין במעלות. אתה יכול לשנות את היחידות של
כל אחד מאלה על ידי הוספת התו "d" (מעלות), "h" (שעות) או "r" (רדיאנים).
סימון סקסאגסימלי נתמך, כאשר נקודתיים או רווחים מפרידים בין hms ל-dms. (מתי
באמצעות רווחים, אנא ודא שהמחרוזת כולה מצוטטת.)

הארגומנט החמישי הנדרש הוא רדיוס חיפוש החרוט. כברירת מחדל, ערך הרדיוס
ניתן במעלות. ניתן לשנות את היחידות על ידי הוספת התו "d" (מעלות),
"r" (רדיאנים), "'" (דקות קשת) או '"' (שניות קשת).

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

"עמודה 1 עמודה 1 ... עמודה N"

ארגומנט שביעי מאפשר לך להוציא עמודות נבחרות מקובץ הרשימה כאשר -j להחליף
משמש. שים לב שהעמודות RA ו-Dec המשמשות בחישוב החרוט לא חייבות להיות
ביטול הבחירה.

כמו כן, כברירת מחדל, שמות העמודות RA ו-Dec נקראים "RA" ו-"Dec", והם ניתנים ב-
יחידות שעות ומעלות בהתאמה. אתה יכול לשנות גם את השם וגם את היחידות באמצעות
המתגים -r [RA] ו/או -d [Dec]. שוב, אחד מ-"h", "d" או "r" מצורף אליו
שם העמודה כדי לציין יחידות, אבל במקרה זה, חייב להיות נקודתיים ":" בין
שם ומפרט היחידה.

אם -l [קובץ רשימה] נעשה שימוש במתג, ואז אחד או יותר מהמרכז RA, מרכז דצמבר, ו
ניתן לקחת רדיוס מקובץ רשימה (שיכול להיות טבלת FITS או טקסט עמודה ASCII
קוֹבֶץ). במקרה זה, השלישי (מרכז RA), הרביעי (מרכז דצמבר) והחמישי (רדיוס)
ארגומנטים של שורת הפקודה יכולים להיות שם עמודה בקובץ הרשימה (אם פרמטר זה
משתנה) או ערך מספרי (אם פרמטר זה סטטי). כאשר שם עמודה הוא
שצוין עבור ה-RA, Dec או הרדיוס, אתה יכול להוסיף נקודתיים ואחריו "h", "d" או "r"
כדי לציין יחידות (גם ' ו' עבור רדיוס). אלגוריתם החיפוש החרוט מופעל פעם אחת עבור כל
שורה ברשימה, לוקחת ערכי RA, Dec ורדיוס מהעמודות שצוינו או מהעמודות שצוינו
ערכים מספריים סטטיים שצוינו בשורת הפקודה.

בעת שימוש ברשימה, כל השורות התקפות מכל איטרציה נכתבות לקובץ פלט בודד.
השתמש -x מתג כדי לעזור להגדיר איזו שורה בקובץ הרשימה שימשה להפקת ה
שורות פלט נתונות. מתג זה גורם לערכים של המרכז RA, Dec, רדיוס ו-
מספר שורה לצירוף לקובץ הפלט, בעמודות הנקראות RA_CEN, DEC_CEN, RAD_CEN
ו-CONE_KEY, בהתאמה. לחילופין, ה -j מתג (הצטרף) יוסיף את כל העמודות
משורת הרשימה לשורת הפלט (בעצם צירוף של שורת הרשימה ושורת הקלט),
יחד עם מספר השורה CONE_KEY. שני מתגים אלו סותרים זה את זה.

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

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

אם כל אחד מהמתגים של "כל השורות" (-X, -J, או -L) מצוינים, ולאחר מכן עמודה חדשה בשם JSTAT
נוסף לטבלת הפלט. הערכים החיוביים בעמודה זו מציינים את המרכז
מיקום מספר שורה (החל מ-1) בקובץ הרשימה ששורת הנתונים הזו הצליחה
תואם בחיפוש קונוס. ערך של -1 אומר ששורת הנתונים לא התאימה לאף מרכז
עמדה. ערך של -2 פירושו שהמיקום המרכזי לא תואם לשום שורת נתונים.

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

לדוגמה, ברירת המחדל של חיפוש החרוט משתמש בעמודות "RA" ו-"Dec" בשעות ובמעלות
(בהתאמה) ומיקום RA בשעות, דצמבר ורדיוס במעלות:

funone in.fits out.fits 23.45 34.56 0.01

כדי לציין את מיקום ה-RA במעלות:

funcone in.fits out.fits 23.45d 34.56 0.01

כדי לקבל RA ו-Dec מרשימה אבל השתמש בערך סטטי לרדיוס (וגם לכתוב
מידע מזהה עבור כל שורה ברשימה):

funcone -x -l list.txt in.fits out.fits MYRA MYDec 0.01

עמודות שצוינו על ידי המשתמש במעלות, מיקום RA בשעות (סימונים מיניים), דצמבר
מיקום במעלות (סימון מיני) ורדיוס בדקות קשת:

funcone -r myRa:d -d myDec in.fits out.fits 12:30:15.5 30:12 15'

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