Panduan fitur SIFASYA

Penjelasan

Hampir semua perhitungan astronomi SIFASYA memakai primitif posisi Matahari dan Bulan berbasis rumus low-precision/abridged Jean Meeus (Astronomical Algorithms). Presisinya setingkat menit busur — cukup untuk edukasi dan perencanaan, bukan navigasi presisi tinggi atau penetapan hukum.

Istilah

Julian Day (JD)

Penomoran hari kontinu sejak 1 Januari 4713 SM. Semua waktu dikonversi ke UTC lalu ke JD. Epoch J2000,0 = 2451545,0.

Deklinasi (δ)

Sudut benda langit terhadap ekuator langit, analog "lintang" di bola langit.

Right Ascension (α)

Analog "bujur" di bola langit, diukur dalam jam.

Altitude (alt)

Tinggi benda di atas horizon dalam derajat.

Azimut

Arah kompas dari utara sejati: 0° U, 90° T, 180° S, 270° B.

Sudut jam (H)

Selisih antara waktu sidereal lokal dan right ascension benda.

Rumus perhitungan

sin(alt) = sin(φ)·sin(δ) + cos(φ)·cos(δ)·cos(H)

Penjelasan

Waktu salat dihitung dengan pendekatan angle-based (gaya PrayTimes): tiap waktu adalah momen ketika Matahari berada pada sudut altitude tertentu, dihitung dari deklinasi Matahari dan equation of time. Default aplikasi memakai parameter Indonesia; tersedia juga sumber AlAdhan dan API Indonesia.

Istilah

Equation of Time (EoT)

Selisih antara waktu Matahari sejati dan waktu Matahari rata-rata.

Transit / Zuhur

Saat Matahari melewati meridian (titik tertinggi) lokasi.

Rumus perhitungan

          sin(alt) − sin(φ)·sin(δ)
cos(H) = ─────────────────────────────
              cos(φ)·cos(δ)

Zuhur  = 12 − EoT/60 − bujur/15 + offset_zona
Waktu  = Zuhur ∓ H/15   (− sebelum zuhur, + sesudah)

cot(alt_asar) = k + tan|φ − δ|

Metode yang tersedia

Sumber data

Hybrid: perhitungan lokal + pihak ketiga

• Perhitungan lokal SIFASYA (default) — tanpa internet, parameter Indonesia (Subuh 20°, Isya 18°).
• AlAdhan API method 20 (Kemenag) — https://aladhan.com/prayer-times-api
• API Indonesia — https://apiindonesia.id/produk/jadwal-sholat/ (menyatakan sumber Kemenag, butuh API key).

Penjelasan

Arah kiblat adalah initial great-circle bearing dari lokasi Anda menuju Ka'bah (lintang 21.4224779°, bujur 39.8251832°), diukur dari utara sejati. Dihitung geometris, tidak memerlukan API.

Istilah

Great-circle bearing

Arah awal rute terpendek pada permukaan bola Bumi.

Haversine

Rumus jarak dua titik pada bola dari lintang/bujur.

Rumus perhitungan

θ = atan2( sin(Δλ)·cos(φ₂),  cos(φ₁)·sin(φ₂) − sin(φ₁)·cos(φ₂)·cos(Δλ) )

a = sin²(Δφ/2) + cos(φ₁)·cos(φ₂)·sin²(Δλ/2)
d = R · 2 · atan2( √a, √(1−a) )

Sumber data

Perhitungan lokal (geometri)

• Tanpa API. Koordinat Ka'bah dari config falak.

Penjelasan

Momen ketika bayangan benda tegak menunjuk arah kiblat, yaitu saat azimut Matahari sejajar garis kiblat. SIFASYA memindai tiap menit sepanjang hari lalu mempertajam dengan metode bisection.

Istilah

Bisection

Metode numerik mempersempit rentang waktu untuk menemukan momen tepat.

Rumus perhitungan

Menuju kiblat   : azimut_Matahari = azimut_kiblat + 180°
Menjauhi kiblat : azimut_Matahari = azimut_kiblat

Sumber data

Perhitungan lokal (geometri)

• Tanpa API. Memakai posisi Matahari lokal + azimut kiblat.

Penjelasan

Kalender dua penanggalan. Jika publikasi resmi tersedia dipakai lebih dulu; jika tidak, dipakai konversi tabular Islamic civil calendar dan dilabeli provisional.

Istilah

JDN

Julian Day Number (bilangan bulat hari) untuk konversi antar kalender.

Tabular civil calendar

Kalender Hijriah aritmetika dengan pola tahun kabisat 30-tahunan.

Rumus perhitungan

a = ⌊(14 − bulan)/12⌋
y = tahun + 4800 − a;   m = bulan + 12a − 3
JDN = hari + ⌊(153m+2)/5⌋ + 365y + ⌊y/4⌋ − ⌊y/100⌋ + ⌊y/400⌋ − 32045

tahun  = ⌊(30·(JDN − epoch) + 10646) / 10631⌋

Sumber data

Hybrid: publikasi resmi + hitung

• Publikasi resmi terimpor (jika ada) → label resmi.
• Konversi tabular → label computed/provisional.

Penjelasan

Menghitung azimut, altitude, deklinasi, right ascension, hour angle, equation of time, serta terbit, transit, dan terbenam Matahari untuk lokasi dan waktu tertentu.

Istilah

GMST

Greenwich Mean Sidereal Time, waktu sidereal di Greenwich.

Rumus perhitungan

g = 357,529 + 0,98560028·D      (anomali rata-rata)
q = 280,459 + 0,98564736·D      (bujur rata-rata)
L = q + 1,915·sin(g) + 0,020·sin(2g)   (bujur ekliptika)
δ = arcsin( sin(23,439°)·sin(L) )

Dicari saat altitude = −0,833°  (refraksi + semidiameter)

Sumber data

Perhitungan lokal

• Rumus low-precision Meeus. Untuk presisi tinggi bandingkan JPL Horizons/USNO.

Penjelasan

Posisi Bulan memakai deret utama abridged Meeus (bab 47). Altitude dikoreksi paralaks (topocentrik) karena Bulan dekat; paralaks horizontalnya ~1° memengaruhi ketinggian nyata. Fase dan iluminasi dihitung dari elongasi Matahari–Bulan.

Istilah

Elongasi

Pisah sudut antara Matahari dan Bulan dilihat dari Bumi.

Paralaks

Pergeseran posisi tampak karena pengamat di permukaan Bumi, bukan di pusat.

Bulan sinodik

Periode fase rata-rata 29,53 hari.

Rumus perhitungan

             1 + cos(180° − elongasi)
iluminasi = ───────────────────────────── × 100%
                        2

fase = bujur_ekliptika_Bulan − bujur_ekliptika_Matahari

Sumber data

Perhitungan lokal

• Rumus abridged Meeus. Pembanding: USNO/NASA (tidak dipanggil tiap kunjungan).

Penjelasan

Parameter hilal dihitung pada saat Matahari terbenam: tinggi & azimut Bulan, elongasi, iluminasi, umur Bulan sejak ijtimak, dan lag time (selisih terbenam Bulan dan Matahari). Dievaluasi terhadap kriteria Neo-MABIMS.

Istilah

Ijtimak

Konjungsi — saat bujur Bulan dan Matahari sama (bulan baru astronomis).

Lag time

Selisih waktu terbenam Bulan dikurangi terbenam Matahari.

Rumus perhitungan

tinggi_Bulan ≥ 3°   DAN   elongasi ≥ 6,4°

Sumber data

Perhitungan lokal

• Rumus abridged Meeus. Penetapan awal bulan tetap melalui sidang isbat Kemenag.

Penjelasan

Menggabungkan parameter hilal (hitung lokal) dengan prakiraan cuaca BMKG (tutupan awan, kelembapan, jarak pandang) sebagai konteks pengamatan di lapangan.

Istilah

Tutupan awan

Persentase langit tertutup awan; makin kecil makin baik untuk rukyat.

Sumber data

Hybrid: hitung lokal + BMKG

• Parameter hilal = perhitungan aplikasi.
• Cuaca = BMKG (pihak ketiga), ditampilkan dengan waktu pengambilan.

Penjelasan

Tabel harian Matahari dan Bulan (terbit/transit/terbenam, deklinasi, equation of time, iluminasi, fase) dihitung pada tengah hari lokal tiap tanggal, hingga 62 hari.

Rumus perhitungan

Tiap baris = posisi Matahari & Bulan pada tengah hari lokal

Sumber data

Perhitungan lokal

• Engine abridged Meeus. Untuk presisi tinggi rujuk JPL/USNO.

Penjelasan

SIFASYA memindai ijtimak (kandidat gerhana Matahari) dan purnama (kandidat gerhana Bulan) tiap bulan sinodik, lalu menandai kandidat ketika Bulan cukup dekat dengan titik simpul (lintang ekliptika kecil).

Istilah

Simpul (node)

Titik potong orbit Bulan dengan bidang ekliptika.

Rumus perhitungan

|lintang_ekliptika_Bulan| kecil saat ijtimak/purnama → kandidat gerhana

Sumber data

Perhitungan lokal (perkiraan)

• Untuk data resmi: NASA Eclipse (eclipse.gsfc.nasa.gov) dan BMKG (bmkg.go.id/gerhana).

Penjelasan

Parameter hilal dievaluasi di sejumlah ibu kota provinsi untuk satu tanggal, lalu tiap titik diklasifikasikan: memenuhi, marginal, atau belum.

Rumus perhitungan

Memenuhi : tinggi ≥ 3° dan elongasi ≥ 6,4°
Marginal : tinggi ≥ 2° dan elongasi ≥ 5°
Belum    : di bawah ambang atau sebelum ijtimak

Sumber data

Perhitungan lokal

• Memakai engine hilal untuk tiap titik.

Penjelasan

Membandingkan waktu salat antar metode (Standar Indonesia, MWL, Egypt, Umm al-Qura) untuk satu lokasi/tanggal. Semua baris dihitung dengan engine yang sama; perbedaannya murni dari parameter sudut Subuh/Isya dan metode Asar.

Rumus perhitungan

selisih = waktu_metode − waktu_metode_acuan   (dalam menit)

Sumber data

Perhitungan lokal

• Satu engine, parameter berbeda per metode.

Penjelasan

Prakiraan cuaca diambil dari API publik BMKG berdasarkan kode wilayah tingkat IV (adm4). Lokasi GPS dipetakan ke kode adm4 melalui OpenStreetMap/Nominatim dan katalog Kepmendagri 2022.

Istilah

adm4

Kode wilayah administrasi tingkat IV (desa/kelurahan) Kepmendagri.

Sumber data

Sumber pihak ketiga (BMKG)

• Prakiraan: BMKG — https://api.bmkg.go.id/publik/prakiraan-cuaca?adm4={kode}
• Pemetaan lokasi: OpenStreetMap/Nominatim + katalog Kepmendagri 2022.
• Ditampilkan dengan waktu produksi dan waktu pengambilan data.

Penjelasan

Jam berjalan dengan penghitung monotonic di perangkat dan disinkronkan ke server setiap lima menit. Label "Acuan BMKG terverifikasi" hanya tampil bila bukti sinkronisasi yang masih berlaku tersimpan.

Istilah

NTP

Network Time Protocol — protokol sinkronisasi waktu.

Sumber data

Hybrid

• Jam server aplikasi; acuan BMKG ntp.bmkg.go.id (bukan JSON API publik).

Penjelasan

Jadwal salat bulanan dan tabel ephemeris dapat diunduh sebagai CSV, JSON, atau ICS. Setiap berkas menyertakan baris provenance: lokasi, sumber, waktu dibuat, dan versi engine.

Istilah

ICS

Format kalender (iCalendar) yang bisa diimpor ke aplikasi kalender.

Sumber data

Perhitungan lokal

• Data dari engine lokal; bukan jadwal resmi Kemenag.