פאנסקי - אונליין בענן

תָכְנִית:

שֵׁם

funsky - המרה בין קואורדינטות תמונה לשמיים

תַקצִיר

פאנסקי iname[ext] # RA,Dec (מעלות) או תמונה פיקסלים מ-stdin
פאנסקי iname[ext] [lname] # RA, Dec (מעלות) או תמונה פיקסלים מהרשימה
פאנסקי iname[ext] [col1] [col2] # עמודות בעלות שם: יחידות מ-stdin
פאנסקי iname[ext] [lname] [col1] [col2] # עמודות:יחידות מהרשימה

אפשרויות

-d # תמיד להשתמש בהמרת tlmin למספרים שלמים (כמו שעושה ds9)
-r # להמיר x,y ל-RA,Dec (ברירת מחדל: להמיר RA,Dec ל-x,y)
-o # כולל היסט ממיקום היעד הנומינלי (ב-arcsecond)
-v # מציג גם ערכי קלט (ברירת מחדל: מציג פלט בלבד)
-T # תצוגת פלט בפורמט rdb (עם כותרת עליונה, מפרידי טאב)

תיאור

פונסקי ממיר קואורדינטות שמיים קלט (RA, Dec) לקואורדינטות תמונה (או להיפך) באמצעות
מידע ה-WCS הכלול בקובץ ה-FITS שצוין. מספר רצפי קריאות נקבעים
נתמך על מנת להקל על ציון מיקומי קואורדינטות בדרכים שונות.

הארגומנט הנדרש הראשון הוא תמיד קובץ הקלט FITS (או הסיומת) המכיל את
מידע WCS בכותרת סיומת. שים לב שהנתונים מקובץ זה אינם בשימוש.
ברירת מחדל, התוכנית ממירה ערכי RA ו-Dec קלט ל-X ו-Y באמצעות WCS זה
מידע. אם ה-WCS משויך לתמונת FITS, אז ערכי ה-X,Y הם תמונה
ערכים. אם ה-WCS משויך לטבלה בינארית, אז ערכי ה-X וה-Y הם פיזיים
ערכים. כדי להמיר X,Y ל-RA ו-Dec, השתמשו ב- -r מתג (הפוך).

אם לא סופקו ארגומנטים אחרים של פקודה, אזי מיקומי הקלט נקראים מה-
קלט סטנדרטי. כל שורה מניחים שהיא מכילה קואורדינטה אחת המורכבת מ
RA במעלות (או X בפיקסלים) ואחריו Dec במעלות (או Y בפיקסלים). הרגיל
מפרידים נתמכים (רווחים, פסיקים, טאבים). לדוגמה:

# קריאה מ-stdin, שמות עמודות ויחידות ברירת מחדל
[sh] פאנסקי snr.ev
22.982695 58.606523 # קלט RA (שעות), דצמבר (מעלות)
510.00 510.00
22.982127 58.607634 # קלט
512.00 510.50
22.981700 58.614301 # קלט
513.50 513.50
^D # סוף הקלט

אם מסופק ארגומנט שני, ארגומנט זה נחשב כקובץ המכיל RA(X)
ו-Dec (Y). הקובץ יכול להיות טבלת ASCII או טבלת FITS בינארית.
סדר העמודות אינו חשוב, אם לטבלה יש כותרת עמודה. במקרה זה, השמות
אחת העמודות חייבת להיות אחת מהן: "RA", "DEC", או "X", "Y" עבור שמיים לתמונה ומתמונה לשמיים
המרות, בהתאמה. אם לטבלה אין כותרת, אז שוב, מניחים RA(X)
תחילה, ולאחר מכן DEC (Y). לדוגמה:

# קריאה מהקובץ, שמות עמודות ויחידות ברירת מחדל
חתול [sh] hd.in
RA DEC
--------- ----------
22.982695 58.606523
22.982127 58.607634
22.981700 58.614301

[sh] פאנסקי snr.ev hd.in
510.00 510.00
512.00 510.50
513.50 513.50

אם מסופקים שלושה ארגומנטים, אזי מיקומי הקלט נקראים שוב מהסטנדרט
קלט. כל שורה מניחים שהיא מכילה קואורדינטה אחת המורכבת מ-RA
(או X בפיקסלים) ואחריו Dec (או Y בפיקסלים), כאשר תומכי המפרידים הרגילים נתמכים.
עם זאת, הארגומנטים השני והשלישי מציינים כעת את שמות העמודות ו/או יחידות השמיים
באמצעות תחביר מופרד באמצעות נקודתיים:

[שם עמודה]:[h⎪d⎪r]

אם שם העמודה מושמט, השמות כברירת מחדל יהיו "RA", "DEC", "X", "Y", "COL1" או "COL2"
כמו לעיל. אם היחידות מושמטות, ברירת המחדל היא מעלות עבור RA וגם עבור Dec. כאשר
נעשה שימוש בבורר -r (המרה מתמונה לשמיים) היחידות מוחלות על הפלט במקום זאת
של הקלט. הדוגמאות הבאות ישמשו להמחשת האפשרויות:

# קריאה מ-stdin, תוך ציון שמות עמודות (יחידות מוגדרות: מעלות)
חתול [sh] hd.in
מירה מידק
--------- ----------
22.982695 58.606523
22.982127 58.607634
22.981700 58.614301

[sh] פאנסקי snr.ev מירה מידק < hd.in
510.00 510.00
512.00 510.50
513.50 513.50

# קריאה מ-stdin, תוך ציון שמות עמודות ויחידות
חתול [sh] dd.in
מירה מידק
--------- ----------
344.740432 58.606523
344.731900 58.607634
344.725500 58.614301

[ש] funksky snr.ev MYRA:d MYDEC:d < dd.in
510.00 510.00
512.00 510.50
513.50 513.50

# קרא stdin, המרת תמונה לשמיים, ציון יחידות שמיים בפלט
חתול im.in
510.00 510.00
512.00 510.50
513.50 513.50

[sh] חתול im.in ⎪ funsky -r snr.ev :d :d
344.740432 58.606523
344.731900 58.607634
344.725500 58.614301

לבסוף, ארבעה ארגומנטים של פקודה מציינים גם וגם שמות קבצי ועמודות קלט ו/או יחידות:

חתול [sh] dd.in
מירה מידק
--------- ----------
344.740432 58.606523
344.731900 58.607634
344.725500 58.614301

[ש] funksky snr.ev dd.in MYRA:d MYDEC:d
510.00 510.00
512.00 510.50
513.50 513.50

# קרא קובץ, המרת תמונה לשמיים, ציון יחידות פלט של שמיים
חתול im.in
510.00 510.00
512.00 510.50
513.50 513.50

[sh] פאנסקי -r snr.ev im.in :d :d
344.740432 58.606523
344.731900 58.607634
344.725500 58.614301

כברירת מחדל, הפלט של funsky מורכב רק ממיקום/י הקואורדינטות שהומרו,
אחד לכל שורת פלט. זה מקל על ניתוח בסקריפטי מעטפת. השתמש ב- -v (מִלוּלִי)
מתג כדי לציין שקואורדינטות הקלט צריכות להיות מוכנות מראש לכל שורה. עבור
דוּגמָה:

חתול [sh] dd.in
מירה מידק
--------- ----------
344.740432 58.606523
344.731900 58.607634
344.725500 58.614301

[ש] funksky snr.ev dd.in MYRA:d MYDEC:d
510.00 510.00
512.00 510.50
513.50 513.50

[sh] funsky -v snr.ev dd.in MYRA:d MYDEC:d
344.740432 58.606523 510.00 510.00
344.731900 58.607634 512.00 510.50
344.725500 58.614301 513.50 513.50

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

# טבלת פלט במצב לא מילולי
[sh] פאנסקי -T snr.ev dd.in MYRA:d MYDEC:d
XY
------------ -------------
510.00 510.00
512.00 510.50
513.50 513.50

# טבלת פלט במצב מפורט
[sh] פאנסקי -T -v snr.ev dd.in MYRA:d MYDEC:d
# IFILE = /Users/eric/data/snr.ev
# ICOL1 = מירה
# ICOL2 = MYDEC
# יחידות1 = ד
# יחידות2 = ד
# OCOL1 = X
# OCOL2 = כן

מירה מידק XY
------------ ------------- ------------- -------------
344.740432 58.606523 510.00 510.00
344.731900 58.607634 512.00 510.50
344.725500 58.614301 513.50 513.50

לבסוף, -d מתג (ds9) מחקה את השימוש של ds9 בערכי TLMIN ו-TLMAX שלמים עבור כל
טרנספורמציות קואורדינטות. נראה כי מוסכמות FITS דורשות שימוש ב-TLMIN של נקודה צפה
ו-TLMAX כאשר הנתונים הם פקודות צפות. מוסכמה זו מלווה ב-funsky אך היא מביאה ל-
פער קטן עם הערכים המומרים של ds9 עבור נתוני נקודה צפה. נתקן זאת
סכסוך בעתיד, אולי.

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