نام (NAME)

wcsware - استخراج کلیدواژه‌های FITS WCS برای یک تصویر

خلاصه دستور (SYNOPSIS)

wcsware [<option>]... [<fitsfile>]

توضیحات (DESCRIPTION)

دستور wcsware کلیدواژه‌های WCS را برای یک تصویر از فایل FITS مشخص‌شده استخراج کرده، ساختارهای wcsprm را برای هر نمایش مختصاتِ یافت‌شده ایجاد می‌کند و با استفاده از آن‌ها عملیات متنوعی را انجام می‌دهد. این ابزار از قابلیت «lint» (بررسی صحت) به عنوان یکی از کاربردی‌ترین عملیات خود بهره می‌برد.

به‌طور پیش‌فرض، تمام افزونه‌های شناخته‌شده برای استاندارد FITS WCS مجاز هستند، از جمله کاربردهای منسوخ‌شده. با این حال، در حالت «lint»، انطباق دقیق با استاندارد اعمال می‌شود.

فایل FITS ممکن است بر اساس قواعد نحوی قابل درک برای cfitsio مشخص شود؛ برای نمونه "file.fits.gz+1" به اولین پسوند (دومین HDU) از یک فایل FITS فشرده‌شده با gzip اشاره دارد. برای ورودی از stdin، از «-» استفاده کنید یا نام فایل را حذف نمایید.

گزینه‌ها (OPTIONS)

-a<alt>

مشخص کردن یک نمایش مختصات جایگزین (در صورتی که تنها یکی وجود داشته باشد، نادیده گرفته می‌شود). همچنین می‌تواند به صورت یک نمایهٔ مبتنی بر صفر (0-relative) در محدودهٔ 0 تا 26 مشخص شود، که در آن جایگزین‌ها پس از نمایش اصلی، به ترتیب حروف الفبا قرار می‌گیرند.

-b

استفاده از wcsbth() برای سرایندهای تصویر اصلی؛ معمولاً از wcspih() استفاده می‌شود. (به طور ضمنی -i را نیز فعال می‌کند.)

-c

اعمال wcspcx() بر ساختار wcsprm برای تجزیه CDi_ja به PCi_ja و CDELTia.

-cp

همانند -c، به همراه رفع درهم‌ریختگی محورها.

-C

همانند -c، تجزیه CDi_ja در صورت وجود، در غیر این صورت ترکیب مجدد PCi_ja و CDELTia.

-Cp

همانند -C، به همراه رفع درهم‌ریختگی محورها.

-f

اعمال wcsfix() بر سرایند.

-h<hdu>

انتقال به شماره HDU (مبتنی بر یک / 1-relative) که انتظار می‌رود شامل یک آرایه تصویری باشد. قواعد نحوی نام فایل گسترش‌یافته cfitsio را بازنویسی می‌کند. همچنین برای ورودی از stdin کاربرد دارد.

-i

مجاز دانستن کلیدواژه‌های WCS سرایند تصویر در سرایندهای جدول باینری.

-l

اعتبارسنجی (lint) رکوردهای کلیدی WCS در سرایند FITS مشخص‌شده برای بررسی انطباق با استاندارد WCS. (به طور ضمنی -s را نیز فعال می‌کند.)

-m

اعمال wcstrim() بر ساختار wcsprm.

-o

استفاده از wcshdo() برای تبدیل ساختار wcsprm به یک سرایند FITS و چاپ آن.

-p

چاپ ساختار(ها) با استفاده از wcsprt() (عملیات پیش‌فرض).

-P

مشابه -p اما ساختار پیش‌فرض را چاپ نمی‌کند.

-r

الزام به رعایت دقیق استاندارد FITS WCS، هرچند کلیدواژه‌های منسوخ‌شده طبق قرارداد AIPS شامل CROTAn، EPOCH و VELREF و همچنین برخی دیگر از کاربردهای منسوخ را مجاز می‌داند. (در صورت نیاز به بررسی با سخت‌گیری کمتر، باید پس از -l بیاید.)

-s

الزام به رعایت دقیق استاندارد FITS WCS و غیرمجاز دانستن تمام قابلیت‌های منسوخ‌شده.

-t

خلاصه (همراه با -l)، فقط رکوردهای کلیدی ردشده WCS را گزارش می‌کند.

-v

مشروح (همراه با -l)، رکوردهای کلیدی شناخته‌شده WCS را نیز گزارش می‌دهد.

-w

تبدیل مختصات جهانی (world coordinates)، دریافت‌شده از stdin، به مختصات پیکسلی با استفاده از wcss2p().

-x

تبدیل مختصات پیکسلی، دریافت‌شده از stdin، به مختصات جهانی با استفاده از wcsp2s().

-z

چاپ اندازه ساختار wcsprm، شامل حافظه تخصیص‌یافته.