use arcsec_core::wcs::TanWcs;
use crate::image_io;
const CARD: usize = 80;
#[derive(Debug, Clone, Default)]
pub struct HeaderCards {
cards: Vec<(String, String)>,
}
impl HeaderCards {
#[must_use]
pub fn parse(text: &str) -> Self {
let lines: Vec<&str> = if text.contains('\n') {
text.lines().collect()
} else {
let mut v = Vec::new();
let mut rest = text;
while !rest.is_empty() {
let mut cut = rest.len().min(CARD);
while !rest.is_char_boundary(cut) {
cut -= 1;
}
if cut == 0 {
break;
}
let (card, tail) = rest.split_at(cut);
v.push(card);
rest = tail;
}
v
};
let mut cards = Vec::new();
for line in lines {
let line = line.trim_end_matches('\r');
let key = line.get(..8.min(line.len())).unwrap_or("").trim();
if key == "END" {
break;
}
let Some(rest) = line.get(8..).and_then(|r| r.strip_prefix('=')) else {
continue;
};
if key.is_empty() {
continue;
}
cards.push((key.to_ascii_uppercase(), value_text(rest).to_string()));
}
Self { cards }
}
#[must_use]
pub fn len(&self) -> usize {
self.cards.len()
}
#[must_use]
pub fn is_empty(&self) -> bool {
self.cards.is_empty()
}
#[must_use]
pub fn raw(&self, key: &str) -> Option<&str> {
self.cards
.iter()
.find(|(k, _)| k.eq_ignore_ascii_case(key))
.map(|(_, v)| v.as_str())
}
#[must_use]
pub fn number(&self, key: &str) -> Option<f64> {
let v = self.raw(key)?.trim().trim_matches('\'').trim();
v.parse::<f64>()
.ok()
.or_else(|| v.replace(['D', 'd'], "E").parse::<f64>().ok())
.filter(|x| x.is_finite())
}
#[must_use]
pub fn ra_dec(&self) -> Option<(f64, f64)> {
image_io::ra_dec_from(
self.number("RA"),
self.number("DEC"),
self.number("CRVAL1"),
self.number("CRVAL2"),
)
}
#[must_use]
pub fn pixel_scale(&self) -> Option<f64> {
image_io::pixel_scale_from(
self.number("FOCALLEN"),
self.number("XPIXSZ"),
self.number("XBINNING"),
)
}
#[must_use]
pub fn tan_wcs(&self) -> Option<TanWcs> {
image_io::tan_wcs_from(|k| self.number(k))
}
}
fn value_text(rest: &str) -> &str {
let mut in_str = false;
for (i, c) in rest.char_indices() {
match c {
'\'' => in_str = !in_str,
'/' if !in_str => return rest[..i].trim(),
_ => {}
}
}
rest.trim()
}
#[cfg(test)]
mod tests {
use super::*;
fn card(s: &str) -> String {
format!("{s:<80}")
}
#[test]
fn parses_run_together_cards() {
let text = [
"SIMPLE = T / conforms",
"RA = 83.8221 / [deg] pointing",
"DEC = -5.3911 / [deg]",
"OBJECT = 'M42 / Orion' / a slash inside a string",
"FOCALLEN= 530.0",
"XPIXSZ = 3.76",
"XBINNING= 2",
"COMMENT RA = 1",
"END",
"DEC = 99",
]
.map(card)
.concat();
let h = HeaderCards::parse(&text);
assert_eq!(h.ra_dec(), Some((83.8221, -5.3911)));
assert_eq!(h.raw("object"), Some("'M42 / Orion'"));
let ps = h.pixel_scale().unwrap();
assert!((ps - 3.76 * 2.0 / 530.0 * 206.265).abs() < 1e-12);
assert!(h.tan_wcs().is_none());
assert_eq!(h.len(), 7, "COMMENT and anything after END are skipped");
}
#[test]
fn parses_lines_and_odd_numbers() {
let text = "CRVAL1 = '150.5'\nCRVAL2 = 2.25D+01 / Fortran exponent\r\nCRPIX1 = 100\nCRPIX2 = 80\nCD1_1 = -1E-4\nCD2_2 = 1E-4\n";
let h = HeaderCards::parse(text);
assert_eq!(h.ra_dec(), Some((150.5, 22.5)));
let w = h.tan_wcs().unwrap();
assert_eq!(w.cd, [[-1e-4, 0.0], [0.0, 1e-4]]);
assert_eq!(h.number("CRPIX1"), Some(100.0));
assert!(h.pixel_scale().is_none());
}
#[test]
fn junk_is_harmless() {
for text in [
"",
"=",
"é",
&"x".repeat(1000),
"RA = 'abc'\nDEC = nan",
] {
let h = HeaderCards::parse(text);
assert!(h.ra_dec().is_none());
}
let h = HeaderCards::parse(&"é".repeat(100));
assert!(h.is_empty());
}
}