nsb 0.1.0

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
78
79
80
81
82
83
84
85
86
87

// SPDX-License-Identifier: AGPL-3.0-only
// Copyright (C) 2026 Vallés Puig, Ramon
use pyo3::exceptions::PyValueError;
use pyo3::prelude::*;

use super::selectors::PySiteProfile;
use crate::{AirglowModel, AirglowSelection, MoonlightModel, NsbModelConfig, ZodiacalExtinction};

#[pymethods]
impl NsbModelConfig {
    #[staticmethod]
    #[pyo3(name = "generic_clear_sky")]
    fn py_generic_clear_sky() -> Self {
        Self::generic_clear_sky()
    }

    #[pyo3(name = "with_site_profile")]
    fn py_with_site_profile(&self, profile: PySiteProfile) -> Self {
        profile.apply(self.clone())
    }

    #[pyo3(name = "with_moonlight_model")]
    fn py_with_moonlight_model(&self, model: MoonlightModel) -> Self {
        self.clone().with_moonlight_model(model)
    }

    #[pyo3(name = "with_airglow_model")]
    fn py_with_airglow_model(&self, model: AirglowModel) -> Self {
        self.clone().with_airglow_model(model)
    }

    #[pyo3(name = "with_automatic_airglow")]
    fn py_with_automatic_airglow(&self) -> Self {
        self.clone()
            .with_airglow_selection(AirglowSelection::Automatic)
    }

    #[pyo3(name = "with_zodiacal_extinction")]
    fn py_with_zodiacal_extinction(&self, extinction: ZodiacalExtinction) -> Self {
        self.clone().with_zodiacal_extinction(extinction)
    }

    #[getter(site_profile)]
    fn py_site_profile(&self) -> PyResult<PySiteProfile> {
        PySiteProfile::from_name(self.site_profile_name()).ok_or_else(|| {
            PyValueError::new_err(format!(
                "site profile '{}' has no Python application-layer selector",
                self.site_profile_name()
            ))
        })
    }

    #[getter(moonlight_model)]
    fn py_moonlight_model(&self) -> MoonlightModel {
        self.moonlight_model()
    }

    #[getter(airglow_selection)]
    fn py_airglow_selection(&self) -> &'static str {
        self.airglow_selection().as_str()
    }

    #[getter(airglow_model)]
    fn py_airglow_model(&self) -> Option<AirglowModel> {
        self.airglow_model()
    }

    #[getter(zodiacal_extinction)]
    fn py_zodiacal_extinction(&self) -> ZodiacalExtinction {
        self.zodiacal_extinction()
    }

    #[getter(is_airglow_site_calibrated)]
    fn py_is_airglow_site_calibrated(&self) -> bool {
        self.is_airglow_site_calibrated()
    }

    fn __repr__(&self) -> String {
        format!(
            "NsbModelConfig(site_profile='{}', moonlight_model='{}', airglow_selection='{}', zodiacal_extinction='{}')",
            self.site_profile_name(),
            self.moonlight_model().as_str(),
            self.airglow_selection().as_str(),
            self.zodiacal_extinction().as_str(),
        )
    }
}