Swiss Ephemeris Validation Framework

{
    "project": "Astro Sindhi Observatory",
    "engine": "ValidationReportEngine",
    "version": "1.0.0",
    "input": {
        "start_year": 2026,
        "years": 5,
        "timezone": "Asia/Karachi"
    },
    "result": {
        "summary": {
            "overall_status": "REFERENCE_DATASET_ACTIVE",
            "meaning": "Reference Dataset Layer is active. Insert trusted Swiss Ephemeris/JPL/NASA values into JSON files to turn pending rows into PASS/WARNING/FAIL comparisons.",
            "next_step": "Populate validation/reference-data/*.json with documented external reference values."
        },
        "reference_dataset_summary": {
            "solar_longitude": {
                "file": "validation/reference-data/solar-longitude.json",
                "exists": true,
                "source": "Swiss Ephemeris 2.10.03 offline calculation",
                "status": "reference_ready",
                "record_count": 4,
                "usable_reference_count": 4
            },
            "lunar_longitude": {
                "file": "validation/reference-data/lunar-longitude.json",
                "exists": true,
                "source": "Swiss Ephemeris 2.10.03 offline calculation",
                "status": "reference_ready",
                "record_count": 4,
                "usable_reference_count": 4
            },
            "equinox": {
                "file": "validation/reference-data/equinox.json",
                "exists": true,
                "source": "Swiss Ephemeris 2.10.03 offline calculation",
                "status": "reference_ready",
                "record_count": 5,
                "usable_reference_count": 5
            },
            "moon_illumination": {
                "file": "validation/reference-data/moon-illumination.json",
                "exists": true,
                "source": "Astro Sindhi Observatory MoonIlluminationEngine v1.0 baseline snapshot; external JPL/Swiss cross-check pending Phase-028B.1",
                "status": "reference_ready_internal_baseline",
                "record_count": 8,
                "usable_reference_count": 8
            }
        },
        "solar_longitude_validation": {
            "title": "Solar Longitude Validation",
            "rows": [
                {
                    "date": "2026-03-21",
                    "measurement": "apparent_solar_longitude_degrees_at_karachi_local_noon",
                    "meeus_value": 0.67856334,
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_value": 0.672215,
                    "difference_degrees": 0.00634834,
                    "status": "PASS"
                },
                {
                    "date": "2026-06-22",
                    "measurement": "apparent_solar_longitude_degrees_at_karachi_local_noon",
                    "meeus_value": 90.90164075,
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_value": 90.89831178,
                    "difference_degrees": 0.00332897,
                    "status": "PASS"
                },
                {
                    "date": "2026-09-23",
                    "measurement": "apparent_solar_longitude_degrees_at_karachi_local_noon",
                    "meeus_value": 180.27966301,
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_value": 180.28177125,
                    "difference_degrees": 0.00210824,
                    "status": "PASS"
                },
                {
                    "date": "2026-12-22",
                    "measurement": "apparent_solar_longitude_degrees_at_karachi_local_noon",
                    "meeus_value": 270.43285345,
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_value": 270.43107811,
                    "difference_degrees": 0.00177534,
                    "status": "PASS"
                }
            ]
        },
        "equinox_validation": {
            "title": "Vernal Equinox Validation",
            "rows": [
                {
                    "year": 2026,
                    "meeus_utc": "2026-03-20T14:45:30Z",
                    "meeus_karachi": "2026-03-20T19:45:30+05:00",
                    "meeus_karachi_date": "2026-03-20",
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_utc": "2026-03-20T14:45:58Z",
                    "difference_minutes": 0.467,
                    "status": "PASS"
                },
                {
                    "year": 2027,
                    "meeus_utc": "2027-03-20T20:24:48Z",
                    "meeus_karachi": "2027-03-21T01:24:48+05:00",
                    "meeus_karachi_date": "2027-03-21",
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_utc": "2027-03-20T20:24:43Z",
                    "difference_minutes": 0.083,
                    "status": "PASS"
                },
                {
                    "year": 2028,
                    "meeus_utc": "2028-03-20T02:17:02Z",
                    "meeus_karachi": "2028-03-20T07:17:02+05:00",
                    "meeus_karachi_date": "2028-03-20",
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_utc": "2028-03-20T02:17:10Z",
                    "difference_minutes": 0.133,
                    "status": "PASS"
                },
                {
                    "year": 2029,
                    "meeus_utc": "2029-03-20T08:01:35Z",
                    "meeus_karachi": "2029-03-20T13:01:35+05:00",
                    "meeus_karachi_date": "2029-03-20",
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_utc": "2029-03-20T08:01:59Z",
                    "difference_minutes": 0.4,
                    "status": "PASS"
                },
                {
                    "year": 2030,
                    "meeus_utc": "2030-03-20T13:51:46Z",
                    "meeus_karachi": "2030-03-20T18:51:46+05:00",
                    "meeus_karachi_date": "2030-03-20",
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_utc": "2030-03-20T13:52:07Z",
                    "difference_minutes": 0.35,
                    "status": "PASS"
                }
            ]
        },
        "lunar_longitude_validation": {
            "title": "Lunar Longitude Validation",
            "rows": [
                {
                    "date": "2026-03-21",
                    "measurement": "geocentric_moon_ecliptic_longitude_degrees_at_karachi_local_noon",
                    "meeus_value": 30.24782488,
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_value": 30.24931539,
                    "difference_degrees": 0.00149051,
                    "status": "PASS"
                },
                {
                    "date": "2026-06-22",
                    "measurement": "geocentric_moon_ecliptic_longitude_degrees_at_karachi_local_noon",
                    "meeus_value": 185.34975941,
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_value": 185.35184938,
                    "difference_degrees": 0.00208997,
                    "status": "PASS"
                },
                {
                    "date": "2026-09-23",
                    "measurement": "geocentric_moon_ecliptic_longitude_degrees_at_karachi_local_noon",
                    "meeus_value": 319.29853356,
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_value": 319.30046259,
                    "difference_degrees": 0.00192903,
                    "status": "PASS"
                },
                {
                    "date": "2026-12-22",
                    "measurement": "geocentric_moon_ecliptic_longitude_degrees_at_karachi_local_noon",
                    "meeus_value": 65.31919744,
                    "reference_source": "Swiss Ephemeris 2.10.03 offline calculation",
                    "reference_value": 65.32092605,
                    "difference_degrees": 0.00172861,
                    "status": "PASS"
                }
            ]
        },
        "moon_illumination_validation": {
            "title": "Moon Illumination Validation",
            "rows": [
                {
                    "date": "2026-06-17",
                    "time_local": "12:00:00",
                    "measurement": "moon_illumination_at_karachi_local_noon",
                    "meeus_moon_age_days": 2.521635,
                    "reference_moon_age_days": 2.521635,
                    "moon_age_difference_days": 0,
                    "meeus_illumination_percent": 7.1125,
                    "reference_illumination_percent": 7.1125,
                    "illumination_difference_percent": 0,
                    "meeus_distance_km": 362229.031,
                    "reference_distance_km": 362229.031,
                    "distance_difference_km": 0,
                    "meeus_phase_english": "Waxing Crescent",
                    "reference_phase_english": "Waxing Crescent",
                    "meeus_phase_sindhi": "وڌندڙ چنڊ",
                    "reference_phase_sindhi": "وڌندڙ چنڊ",
                    "phase_match": true,
                    "waxing_or_waning": "waxing",
                    "reference_waxing_or_waning": "waxing",
                    "waxing_match": true,
                    "reference_source": "Astro Observatory internal baseline snapshot",
                    "status": "PASS"
                },
                {
                    "date": "2026-06-18",
                    "time_local": "12:00:00",
                    "measurement": "moon_illumination_at_karachi_local_noon",
                    "meeus_moon_age_days": 3.640707,
                    "reference_moon_age_days": 3.640707,
                    "moon_age_difference_days": 0,
                    "meeus_illumination_percent": 14.3423,
                    "reference_illumination_percent": 14.3423,
                    "illumination_difference_percent": 0,
                    "meeus_distance_km": 366982.33,
                    "reference_distance_km": 366982.33,
                    "distance_difference_km": 0,
                    "meeus_phase_english": "Waxing Crescent",
                    "reference_phase_english": "Waxing Crescent",
                    "meeus_phase_sindhi": "وڌندڙ چنڊ",
                    "reference_phase_sindhi": "وڌندڙ چنڊ",
                    "phase_match": true,
                    "waxing_or_waning": "waxing",
                    "reference_waxing_or_waning": "waxing",
                    "waxing_match": true,
                    "reference_source": "Astro Observatory internal baseline snapshot",
                    "status": "PASS"
                },
                {
                    "date": "2026-06-19",
                    "time_local": "12:00:00",
                    "measurement": "moon_illumination_at_karachi_local_noon",
                    "meeus_moon_age_days": 4.722525,
                    "reference_moon_age_days": 4.722525,
                    "moon_age_difference_days": 0,
                    "meeus_illumination_percent": 23.2761,
                    "reference_illumination_percent": 23.2761,
                    "illumination_difference_percent": 0,
                    "meeus_distance_km": 372667.769,
                    "reference_distance_km": 372667.769,
                    "distance_difference_km": 0,
                    "meeus_phase_english": "Waxing Crescent",
                    "reference_phase_english": "Waxing Crescent",
                    "meeus_phase_sindhi": "وڌندڙ چنڊ",
                    "reference_phase_sindhi": "وڌندڙ چنڊ",
                    "phase_match": true,
                    "waxing_or_waning": "waxing",
                    "reference_waxing_or_waning": "waxing",
                    "waxing_match": true,
                    "reference_source": "Astro Observatory internal baseline snapshot",
                    "status": "PASS"
                },
                {
                    "date": "2026-06-20",
                    "time_local": "12:00:00",
                    "measurement": "moon_illumination_at_karachi_local_noon",
                    "meeus_moon_age_days": 5.765731,
                    "reference_moon_age_days": 5.765731,
                    "moon_age_difference_days": 0,
                    "meeus_illumination_percent": 33.2475,
                    "reference_illumination_percent": 33.2475,
                    "illumination_difference_percent": 0,
                    "meeus_distance_km": 378777.559,
                    "reference_distance_km": 378777.559,
                    "distance_difference_km": 0,
                    "meeus_phase_english": "First Quarter",
                    "reference_phase_english": "First Quarter",
                    "meeus_phase_sindhi": "پهريون چوٿائي",
                    "reference_phase_sindhi": "پهريون چوٿائي",
                    "phase_match": true,
                    "waxing_or_waning": "waxing",
                    "reference_waxing_or_waning": "waxing",
                    "waxing_match": true,
                    "reference_source": "Astro Observatory internal baseline snapshot",
                    "status": "PASS"
                },
                {
                    "date": "2026-06-21",
                    "time_local": "12:00:00",
                    "measurement": "moon_illumination_at_karachi_local_noon",
                    "meeus_moon_age_days": 6.772562,
                    "reference_moon_age_days": 6.772562,
                    "moon_age_difference_days": 0,
                    "meeus_illumination_percent": 43.6556,
                    "reference_illumination_percent": 43.6556,
                    "illumination_difference_percent": 0,
                    "meeus_distance_km": 384841.806,
                    "reference_distance_km": 384841.806,
                    "distance_difference_km": 0,
                    "meeus_phase_english": "First Quarter",
                    "reference_phase_english": "First Quarter",
                    "meeus_phase_sindhi": "پهريون چوٿائي",
                    "reference_phase_sindhi": "پهريون چوٿائي",
                    "phase_match": true,
                    "waxing_or_waning": "waxing",
                    "reference_waxing_or_waning": "waxing",
                    "waxing_match": true,
                    "reference_source": "Astro Observatory internal baseline snapshot",
                    "status": "PASS"
                },
                {
                    "date": "2026-06-22",
                    "time_local": "12:00:00",
                    "measurement": "moon_illumination_at_karachi_local_noon",
                    "meeus_moon_age_days": 7.747524,
                    "reference_moon_age_days": 7.747524,
                    "moon_age_difference_days": 0,
                    "meeus_illumination_percent": 54.0009,
                    "reference_illumination_percent": 54.0009,
                    "illumination_difference_percent": 0,
                    "meeus_distance_km": 390475.663,
                    "reference_distance_km": 390475.663,
                    "distance_difference_km": 0,
                    "meeus_phase_english": "First Quarter",
                    "reference_phase_english": "First Quarter",
                    "meeus_phase_sindhi": "پهريون چوٿائي",
                    "reference_phase_sindhi": "پهريون چوٿائي",
                    "phase_match": true,
                    "waxing_or_waning": "waxing",
                    "reference_waxing_or_waning": "waxing",
                    "waxing_match": true,
                    "reference_source": "Astro Observatory internal baseline snapshot",
                    "status": "PASS"
                },
                {
                    "date": "2026-06-23",
                    "time_local": "12:00:00",
                    "measurement": "moon_illumination_at_karachi_local_noon",
                    "meeus_moon_age_days": 8.696222,
                    "reference_moon_age_days": 8.696222,
                    "moon_age_difference_days": 0,
                    "meeus_illumination_percent": 63.8852,
                    "reference_illumination_percent": 63.8852,
                    "illumination_difference_percent": 0,
                    "meeus_distance_km": 395400.371,
                    "reference_distance_km": 395400.371,
                    "distance_difference_km": 0,
                    "meeus_phase_english": "First Quarter",
                    "reference_phase_english": "First Quarter",
                    "meeus_phase_sindhi": "پهريون چوٿائي",
                    "reference_phase_sindhi": "پهريون چوٿائي",
                    "phase_match": true,
                    "waxing_or_waning": "waxing",
                    "reference_waxing_or_waning": "waxing",
                    "waxing_match": true,
                    "reference_source": "Astro Observatory internal baseline snapshot",
                    "status": "PASS"
                },
                {
                    "date": "2026-06-24",
                    "time_local": "12:00:00",
                    "measurement": "moon_illumination_at_karachi_local_noon",
                    "meeus_moon_age_days": 9.624527,
                    "reference_moon_age_days": 9.624527,
                    "moon_age_difference_days": 0,
                    "meeus_illumination_percent": 72.9942,
                    "reference_illumination_percent": 72.9942,
                    "illumination_difference_percent": 0,
                    "meeus_distance_km": 399444.035,
                    "reference_distance_km": 399444.035,
                    "distance_difference_km": 0,
                    "meeus_phase_english": "Waxing Gibbous",
                    "reference_phase_english": "Waxing Gibbous",
                    "meeus_phase_sindhi": "مُنو چنڊ",
                    "reference_phase_sindhi": "مُنو چنڊ",
                    "phase_match": true,
                    "waxing_or_waning": "waxing",
                    "reference_waxing_or_waning": "waxing",
                    "waxing_match": true,
                    "reference_source": "Astro Observatory internal baseline snapshot",
                    "status": "PASS"
                }
            ]
        }
    },
    "rules": {
        "comparison_target": "Offline reference datasets from validation/reference-data/*.json. Swiss Ephemeris/JPL values may be inserted there when available.",
        "current_model": "Meeus-style research-reference engines already present in the project.",
        "no_rule_change": "This framework does not alter Sindhu Sambat rules or astronomical engines."
    },
    "status": {
        "calculation_status": "PRODUCTION_VALIDATION_FRAMEWORK",
        "historical_status": "historical_validation_ongoing",
        "scientific_validation": "ongoing",
        "precision_note": "Production Validation Framework is active. Reference datasets may be expanded using NASA, JPL, Swiss Ephemeris and other documented scientific sources."
    }
}