nsb 0.1.1

Night-sky background evaluation and observation planning for ground-based astronomy.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

// SPDX-License-Identifier: AGPL-3.0-only
// Copyright (C) 2026 Vallés Puig, Ramon
//! Local helpers for repository integration tests and benches.
//!
//! Intentionally not part of the `nsb` public API (#175).

#![allow(dead_code)]

use nsb::components::starlight::StarlightProvenance;
use nsb::site::{AtmosphericConditions, SiteProfile, SiteProfileTag};
use siderust::qtty::{Hectopascals, Kilometers};

/// CTAO-North planning assumptions (application-layer preset mirrored for tests).
pub struct CtaNorth;

impl SiteProfileTag for CtaNorth {
    const NAME: &'static str = "ctao-north-planning";
}

pub struct CtaSouth;

impl SiteProfileTag for CtaSouth {
    const NAME: &'static str = "ctao-south-planning";
}

pub fn ctao_north_planning() -> SiteProfile<CtaNorth> {
    SiteProfile::<CtaNorth>::planning(
        Kilometers::new(2.2),
        AtmosphericConditions::clear_sky_with_pressure(Hectopascals::new(770.0)).unwrap(),
        concat!(
            "CTAO-North planning preset: representative ORM/La Palma ",
            "altitude, fixed planning pressure, Siderust default ",
            "Rayleigh scale height, and bundled Paranal-like clear-sky ",
            "Mie parameterization. This is not yet a validated CTA-N ",
            "aerosol calibration and does not identify the observer as ORM."
        ),
    )
    .unwrap()
}

/// CTAO-South planning assumptions (application-layer preset mirrored for tests).
pub fn ctao_south_planning() -> SiteProfile<CtaSouth> {
    SiteProfile::<CtaSouth>::planning(
        Kilometers::new(2.1),
        AtmosphericConditions::paranal_average(),
        concat!(
            "CTAO-South planning preset: Paranal-like atmosphere from ",
            "Siderust AtmosphereProfile::EL_PARANAL used as a planning ",
            "assumption. This is not yet a dedicated CTA-S aerosol ",
            "calibration and does not identify the observer as Paranal."
        ),
    )
    .unwrap()
}

/// Deterministic provenance for synthetic HEALPix fixtures.
pub fn starlight_test_provenance() -> StarlightProvenance {
    let mut provenance = StarlightProvenance::new(
        "NSB test fixture starlight map",
        "fixture",
        "2026-06-17",
        "synthetic unit-test fixture",
        "test-only",
        "test-only",
        "integrated 300-650 nm photon radiance",
        "HEALPix nside=1 ring 12 pixels",
        None::<String>,
    );
    provenance.source_catalogue_release = Some("test".to_string());
    provenance.photometry_model = Some("fixture".to_string());
    provenance.generated_by = Some("test".to_string());
    provenance.source_selection = Some("synthetic fixture".to_string());
    provenance.generation_command = Some("test fixture generation".to_string());
    provenance.validation_report = Some("test-only".to_string());
    provenance.calibration_status = Some("experimental".to_string());
    provenance
}