funcone - آنلاین در ابر

برنامه:

نام

funcone - جستجوی مخروطی یک جدول باینری حاوی ستون‌های RA، Dec

خلاصه

funcone [ستون ها]

OPTIONS

-d deccol:[hdr] # Dec نام ستون، واحدها (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
-X # اضافه کردن کلیدهای RA_CEN، DEC_CEN، RAD_CEN، CONE_KEY، خروجی همه ردیف‌ها

شرح

Funcone یک جستجوی مخروطی در ستون‌های RA و Dec یک جدول باینری FITS انجام می‌دهد. در
فاصله از مرکز RA، موقعیت Dec تا RA، Dec در هر ردیف در جدول است
محاسبه شد. سطرهایی که فاصله آنها کمتر از شعاع مشخص شده باشد خروجی می شوند.

اولین آرگومان برنامه، فایل FITS، فایل رویداد خام یا آرایه خام را مشخص می کند
فایل. اگر "stdin" مشخص شده باشد، داده ها از ورودی استاندارد خوانده می شوند. از Funtools استفاده کنید
علامت گذاری براکت برای تعیین پسوندها و فیلترهای FITS. استدلال دوم این است
خروجی فایل FITS اگر "stdout" مشخص شده باشد، جدول باینری FITS در آن نوشته می شود
خروجی استاندارد

سومین و چهارمین آرگومان مورد نیاز موقعیت RA و Dec center هستند. به صورت پیش فرض،
RA بر حسب ساعت مشخص می شود در حالی که دسامبر بر حسب درجه مشخص می شود. می توانید واحدهای آن را تغییر دهید
هر یک از اینها با اضافه کردن کاراکتر "d" (درجه)، "h" (ساعت) یا "r" (رادیان).
نماد جنسیتی با دو نقطه یا فاصله هایی که hms و dms را از هم جدا می کنند، پشتیبانی می شود. (چه زمانی
با استفاده از فاصله، لطفاً مطمئن شوید که کل رشته نقل قول شده است.)

پنجمین آرگومان مورد نیاز شعاع جستجوی مخروط است. به طور پیش فرض، مقدار شعاع
بر حسب درجه داده می شود. واحدها را می توان با اضافه کردن کاراکتر "d" (درجه) تغییر داد.
"r" (رادیان)، """ (دقیقه قوس) یا """ (ثانیه قوس).

به طور پیش فرض، تمام ستون های فایل ورودی در فایل خروجی کپی می شوند. ستون های انتخاب شده
می توان با استفاده از آرگومان ششم اختیاری به شکل زیر خروجی داد:

"column1 column1 ... columnN"

آرگومان هفتم به شما این امکان را می دهد که ستون های انتخابی را از فایل لیست خروجی بگیرید -j گزینه
استفاده می شود. توجه داشته باشید که ستون های RA و Dec مورد استفاده در محاسبه مخروط نباید باشند
از حالت انتخاب خارج شد.

همچنین به طور پیش فرض، نام ستون RA و Dec "RA" و "Dec" نامیده می شود و در
واحد ساعت و درجه به ترتیب. با استفاده از آن می توانید نام و واحدها را تغییر دهید
سوئیچ های -r [RA] و/یا -d [دسامبر]. یک بار دیگر، یکی از "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. این دو سوئیچ متقابل هستند.

La -X و -J سوئیچ ها داده های مشابهی را با حروف کوچک خود برای هر کدام می نویسند
ردیفی که جستجوی مخروطی را برآورده می کند. علاوه بر این، این سوئیچ ها همچنین ردیف هایی را از روی می نویسند
فایل رویدادی که هیچ جستجوی مخروطی را برآورده نمی کند. در چنین مواردی، آن ستون CONE_KEY خواهد بود
مقدار -1 داده می شود و اطلاعات موقعیت مرکز و لیست روی صفر تنظیم می شود
برای ردیف داده شده بنابراین، تمام ردیف‌های فایل رویداد ورودی تضمین می‌شوند که خروجی باشند.
با ردیف هایی که حداقل یک جستجوی مخروطی را برآورده می کنند و اطلاعات جستجوی بیشتری دارند.

La -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'

با استفاده از خدمات onworks.net از funcone به صورت آنلاین استفاده کنید