WCSWARE(1)                      دستورهای کاربری                     WCSWARE(1)

نام (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، شامل حافظه تخصیص‌یافته.

wcsware 8.9                        ژوئن 2026                        WCSWARE(1)