.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.4.
.TH SUNDAZEL "1" "June 2026" "sundazel 8.9" "User Commands"
.SH "نام (NAME)"
sundazel \- محاسبه زمان گذر خورشید
.SH "خلاصه دستور (SYNOPSIS)"
.B sundazel
[\fI<option>\fR] [\fI<yyyymmdd>\fR]
.SH "توضیحات (DESCRIPTION)"
دستور
.B sundazel
زمان محلی گذر خورشید از طول یا عرض ظاهری تعیین‌شده در یک دستگاه مختصات تعریف‌شده توسط کاربر را برای مکان مشخص‌شده در تاریخ مشخص‌شده (به‌طور پیش‌فرض امروز) محاسبه می‌کند.
.PP
زاویه ساعتی ظاهری، سمت و ارتفاع خورشید، و همچنین طول و عرض در مختصات کاربر نیز بر حسب درجه چاپ می‌شوند. اثر شکست نور در محاسبات لحاظ شده است.
.PP
همچنین می‌توان از
.B sundazel
برای محاسبه زمان طلوع و غروب، بُعد و میل خورشید، و معادله زمان استفاده کرد.
.SH "گزینه‌ها (OPTIONS)"
.HP
\fB\-p\fR <option>
.IP
گذر خورشیدی مورد نیاز و در صورت ارتباط، مقدار مختصات بر حسب درجه:
.TP
sunrise
طلوع خورشید.
.TP
sunset
غروب خورشید.
.TP
lng=<lng>
طول خورشید در دستگاه مختصات تعریف‌شده توسط کاربر.
.TP
lat=<lat>
عرض خورشید در دستگاه مختصات تعریف‌شده توسط کاربر.
.HP
\fB\-l\fR <lng>,<lat>
.IP
طول و عرض جغرافیایی ناظر.
.HP
\fB\-t\fR <tz>
.IP
منطقه زمانی ناظر، برای مناطق شرق گرینویچ مثبت است (ساعت).
.HP
\fB\-u\fR <az>,<el>,<zlng>
.IP
سمت و ارتفاع قطب دستگاه مختصات تعریف‌شده توسط کاربر، و طول سمت‌الرأس بر حسب درجه (deg). به توضیحات پایین مراجعه کنید.
.TP
\fB\-n\fR
تنظیم دستگاه مختصات تعریف‌شده توسط کاربر با قطبی دقیقاً در شمال افق و صفرِ طول در سمت‌الرأس.
.TP
\fB\-w\fR
تنظیم دستگاه مختصات تعریف‌شده توسط کاربر با قطبی دقیقاً در غرب افق و صفرِ طول در سمت‌الرأس.
.TP
\fB\-v\fR
همچنین بُعد و میل خورشید (بر حسب درجه) و معادله زمان (بر حسب دقیقه) را چاپ می‌کند.
.PP
دستگاه مختصات تعریف‌شده توسط کاربر یک دستگاه مختصات کروی راست‌گرد با قطبی در سمت و ارتفاع مشخص‌شده است که در آن سمت‌الرأس دارای طول مشخص‌شده می‌باشد. در صورت عدم تعیین، حالت پیش‌فرض یک دستگاه راست‌گرد با قطب در سمت‌الرأس و نصف‌النهار مبدأ دقیقاً در شمال است؛ یعنی مشابه با سمت و ارتفاع، با این تفاوت که طول در جهت عکسِ سمت افزایش می‌یابد، یعنی از شمال به سمت غرب به جای شمال به سمت شرق.
.PP
تعیین محدوده‌ای از سمت یا ارتفاع اغلب معیار ضعیفی برای زمان‌بندی گذر خورشید فراهم می‌کند؛ به عنوان مثال در تعیین زمان تابش مستقیم خورشید از یک نورگیر، یا زمانی که سایه‌بان روی نقطه خاصی از زمین سایه می‌اندازد. در چنین مواردی باید تصویر نورگیر یا سایه‌بان از روی زمین بر روی آسمان در نظر گرفته شود. ممکن است یک دستگاه مختصات دیگر انطباق بهتری با ناحیه تعریف‌شده در آسمان داشته باشد. برای نمونه، گذر خورشید از عرض یک نورگیر که در جهت سمتِ آلفا (alpha) قرار دارد، می‌تواند از طریق دستگاه مختصاتی مدیریت شود که قطب آن روی افق در همان جهت سمت قرار دارد و گذر خورشید از محدوده‌ای از طول در این دستگاه بررسی شود. شاید روش بهتر این باشد که از دستگاه مختصاتی با قطب در alpha\-90 استفاده شده و محدوده‌ای از عرض بررسی گردد.
.PP
طلوع و غروب خورشید متناظر با اولین/آخرین تماس لبه قرص خورشید با افق است که معادل با ارتفاع ظاهری \fB\-0\fR.27 درجه (ارتفاع واقعی \fB\-0\fR.79 درجه) می‌باشد. در صورت عدم تعیین گزینه‌ها، حالت پیش‌فرض محاسبه زمان غروب خورشید است. اگر بیش از یک گزینه p مشخص شود، تنها آخرین گزینه مؤثر خواهد بود.