From ec42900ef201662f601ac01fc1c2c4fc487fe09c Mon Sep 17 00:00:00 2001
From: Lauren MacArthur <lauren@astro.princeton.edu>
Date: Sun, 20 Oct 2024 16:55:11 -0700
Subject: [PATCH] Add pixel scale & PSF model metrics to schemas

---
 yml/apdb.yaml              |  5 ++++
 yml/cdb_latiss.yaml        | 32 +++++++++++++++++++++----
 yml/cdb_lsstcomcam.yaml    | 48 ++++++++++++++++++++++++++++++++++++++
 yml/cdb_lsstcomcamsim.yaml | 48 ++++++++++++++++++++++++++++++++++++++
 4 files changed, 129 insertions(+), 4 deletions(-)

diff --git a/yml/apdb.yaml b/yml/apdb.yaml
index 5b60cf97..d406cd10 100644
--- a/yml/apdb.yaml
+++ b/yml/apdb.yaml
@@ -2802,6 +2802,11 @@ tables:
     datatype: double
     description: Declination of detector center.
     fits:tunit: deg
+  - name: pixelScale
+    '@id': '#DetectorVisitProcessingSummary.pixelScale'
+    datatype: float
+    description: Measured detector pixel scale (arcsec/pixel).
+    fits:tunit:
   - name: zeroPoint
     '@id': '#DetectorVisitProcessingSummary.zeroPoint'
     datatype: float
diff --git a/yml/cdb_latiss.yaml b/yml/cdb_latiss.yaml
index 32a6d60b..e81370e7 100644
--- a/yml/cdb_latiss.yaml
+++ b/yml/cdb_latiss.yaml
@@ -921,6 +921,10 @@ tables:
     "@id": "#visit1_quicklook.n_inputs"
     datatype: int
     description: Number of CCDs used to compute the visit aggregates.
+  - name: pixel_scale
+    "@id": "#visit1_quicklook.pixel_scale"
+    datatype: float
+    description: Measured detector pixel scale (arcsec/pixel).
   - name: astrom_offset_mean
     "@id": "#visit1_quicklook.astrom_offset_mean"
     datatype: float
@@ -953,10 +957,6 @@ tables:
     datatype: float
     description: Magnitude limit at fixed SNR (default SNR=5) calculated from exposure summary stats.
     ivoa:unit: mag
-  - name: max_dist_to_nearest_psf
-    "@id": "#visit1_quicklook.max_dist_to_nearest_psf"
-    datatype: float
-    description: Maximum distance of an unmasked pixel to its nearest model PSF star.
   - name: mean_var
     "@id": "#visit1_quicklook.mean_var"
     datatype: float
@@ -1017,6 +1017,18 @@ tables:
     "@id": "#visit1_quicklook.psf_trace_radius_delta"
     datatype: float
     description: Delta (max - min) of model PSF trace radius values evaluated on a grid of unmasked pixels.
+  - name: psf_ap_flux_delta
+    "@id": "#visit1_quicklook.psf_ap_flux_delta"
+    datatype: double
+    description: Delta (max - min) of model psf aperture flux (with aperture radius of max(2, 3*psfSigma)) values evaluated on a grid of unmasked pixels.
+  - name: psf_ap_corr_sigma_scaled_delta
+    "@id": "#visit1_quicklook.psf_ap_corr_sigma_scaled_delta"
+    datatype: double
+    description: Delta (max - min) of psf flux aperture correction factors scaled (divided) by the psfSigma evaluated on a grid of unmasked pixels.
+  - name: max_dist_to_nearest_psf
+    "@id": "#visit1_quicklook.max_dist_to_nearest_psf"
+    datatype: float
+    description: Maximum distance of an unmasked pixel to its nearest model PSF star.
   - name: sky_bg
     "@id": "#visit1_quicklook.sky_bg"
     datatype: float
@@ -1175,6 +1187,10 @@ tables:
     "@id": "#ccdvisit1_quicklook.seeing_zenith_500nm"
     datatype: double
     description: Measured PSF sigma, corrected to 500nm and an airmass of 1.
+  - name: pixel_scale
+    "@id": "#ccdvisit1_quicklook.pixel_scale"
+    datatype: float
+    description: Measured detector pixel scale (arcsec/pixel).
   - name: astrom_offset_mean
     "@id": "#ccdvisit1_quicklook.astrom_offset_mean"
     datatype: float
@@ -1262,6 +1278,14 @@ tables:
     datatype: float
     description: Delta (max - min) of model PSF trace radius values evaluated on a grid of unmasked pixels.
     ivoa:unit: pixel
+   - name: psf_ap_flux_delta
+    "@id": "#ccdvisit1_quicklook.psf_ap_flux_delta"
+    datatype: double
+    description: Delta (max - min) of model psf aperture flux (with aperture radius of max(2, 3*psfSigma)) values evaluated on a grid of unmasked pixels.
+  - name: psf_ap_corr_sigma_scaled_delta
+    "@id": "#ccdvisit1_quicklook.psf_ap_corr_sigma_scaled_delta"
+    datatype: double
+    description: Delta (max - min) of psf flux aperture correction factors scaled (divided) by the psfSigma evaluated on a grid of unmasked pixels.
   - name: max_dist_to_nearest_psf
     "@id": "#ccdvisit1_quicklook.max_dist_to_nearest_psf"
     datatype: float
diff --git a/yml/cdb_lsstcomcam.yaml b/yml/cdb_lsstcomcam.yaml
index c587a983..5fc32589 100644
--- a/yml/cdb_lsstcomcam.yaml
+++ b/yml/cdb_lsstcomcam.yaml
@@ -901,6 +901,18 @@ tables:
     "@id": "#visit1_quicklook.n_inputs"
     datatype: int
     description: Number of CCDs used to compute the visit aggregates.
+  - name: pixel_scale_min
+    "@id": "#visit1_quicklook.pixel_scale_min"
+    datatype: float
+    description: Measured detector pixel scale (arcsec/pixel) (minimum across all detectors).
+  - name: pixel_scale_max
+    "@id": "#visit1_quicklook.pixel_scale_max"
+    datatype: float
+    description: Measured detector pixel scale (arcsec/pixel) (maximum across all detectors).
+  - name: pixel_scale_median
+    "@id": "#visit1_quicklook.pixel_scale_median"
+    datatype: float
+    description: Measured detector pixel scale (arcsec/pixel) (median across all detectors).
   - name: astrom_offset_mean_min
     "@id": "#visit1_quicklook.astrom_offset_mean_min"
     datatype: float
@@ -997,6 +1009,30 @@ tables:
     datatype: float
     description: Magnitude limit at fixed SNR (default SNR=5) calculated from exposure summary stats (median across all detectors).
     ivoa:unit: mag
+  - name: psf_ap_flux_delta_min
+    "@id": "#visit1_quicklook.psf_ap_flux_delta_min"
+    datatype: double
+    description: Delta (max - min) of model psf aperture flux (with aperture radius of max(2, 3*psfSigma)) values evaluated on a grid of unmasked pixels (minimum across all detectors).
+  - name: psf_ap_flux_delta_max
+    "@id": "#visit1_quicklook.psf_ap_flux_delta_max"
+    datatype: double
+    description: Delta (max - min) of model psf aperture flux (with aperture radius of max(2, 3*psfSigma)) values evaluated on a grid of unmasked pixels (maximum across all detectors).
+  - name: psf_ap_flux_delta_median
+    "@id": "#visit1_quicklook.psf_ap_flux_delta_median"
+    datatype: double
+    description: Delta (max - min) of model psf aperture flux (with aperture radius of max(2, 3*psfSigma)) values evaluated on a grid of unmasked pixels (median across all detectors).
+  - name: psf_ap_corr_sigma_scaled_delta_min
+    "@id": "#visit1_quicklook.psf_ap_corr_sigma_scaled_delta_min"
+    datatype: double
+    description: Delta (max - min) of psf flux aperture correction factors scaled (divided) by the psfSigma evaluated on a grid of unmasked pixels (minimum across all detectors).
+  - name: psf_ap_corr_sigma_scaled_delta_max
+    "@id": "#visit1_quicklook.psf_ap_corr_sigma_scaled_delta_max"
+    datatype: double
+    description: Delta (max - min) of psf flux aperture correction factors scaled (divided) by the psfSigma evaluated on a grid of unmasked pixels (maximum across all detectors).
+  - name: psf_ap_corr_sigma_scaled_delta_median
+    "@id": "#visit1_quicklook.psf_ap_corr_sigma_scaled_delta_median"
+    datatype: double
+    description: Delta (max - min) of psf flux aperture correction factors scaled (divided) by the psfSigma evaluated on a grid of unmasked pixels (median across all detectors).
   - name: max_dist_to_nearest_psf_min
     "@id": "#visit1_quicklook.max_dist_to_nearest_psf_min"
     datatype: float
@@ -1423,6 +1459,10 @@ tables:
     "@id": "#ccdvisit1_quicklook.seeing_zenith_500nm"
     datatype: double
     description: Measured PSF sigma, corrected to 500nm and an airmass of 1.
+  - name: pixel_scale
+    "@id": "#ccdvisit1_quicklook.pixel_scale"
+    datatype: float
+    description: Measured detector pixel scale (arcsec/pixel).
   - name: astrom_offset_mean
     "@id": "#ccdvisit1_quicklook.astrom_offset_mean"
     datatype: float
@@ -1515,6 +1555,14 @@ tables:
     datatype: float
     description: Delta (max - min) of model PSF trace radius values evaluated on a grid of unmasked pixels.
     ivoa:unit: pixel
+  - name: psf_ap_flux_delta
+    "@id": "#ccdvisit1_quicklook.psf_ap_flux_delta"
+    datatype: double
+    description: Delta (max - min) of model psf aperture flux (with aperture radius of max(2, 3*psfSigma)) values evaluated on a grid of unmasked pixels.
+  - name: psf_ap_corr_sigma_scaled_delta
+    "@id": "#ccdvisit1_quicklook.psf_ap_corr_sigma_scaled_delta"
+    datatype: double
+    description: Delta (max - min) of psf flux aperture correction factors scaled (divided) by the psfSigma evaluated on a grid of unmasked pixels.
   - name: max_dist_to_nearest_psf
     "@id": "#ccdvisit1_quicklook.max_dist_to_nearest_psf"
     datatype: float
diff --git a/yml/cdb_lsstcomcamsim.yaml b/yml/cdb_lsstcomcamsim.yaml
index 2598e0f5..d80dec3a 100644
--- a/yml/cdb_lsstcomcamsim.yaml
+++ b/yml/cdb_lsstcomcamsim.yaml
@@ -866,6 +866,18 @@ tables:
     "@id": "#visit1_quicklook.n_inputs"
     datatype: int
     description: Number of CCDs used to compute the visit aggregates.
+  - name: pixel_scale_min
+    "@id": "#visit1_quicklook.pixel_scale_min"
+    datatype: float
+    description: Measured detector pixel scale (arcsec/pixel) (minimum across all detectors).
+  - name: pixel_scale_max
+    "@id": "#visit1_quicklook.pixel_scale_max"
+    datatype: float
+    description: Measured detector pixel scale (arcsec/pixel) (maximum across all detectors).
+  - name: pixel_scale_median
+    "@id": "#visit1_quicklook.pixel_scale_median"
+    datatype: float
+    description: Measured detector pixel scale (arcsec/pixel) (median across all detectors).
   - name: astrom_offset_mean_min
     "@id": "#visit1_quicklook.astrom_offset_mean_min"
     datatype: float
@@ -962,6 +974,30 @@ tables:
     datatype: float
     description: Magnitude limit at fixed SNR (default SNR=5) calculated from exposure summary stats (median across all detectors).
     ivoa:unit: mag
+  - name: psf_ap_flux_delta_min
+    "@id": "#visit1_quicklook.psf_ap_flux_delta_min"
+    datatype: double
+    description: Delta (max - min) of model psf aperture flux (with aperture radius of max(2, 3*psfSigma)) values evaluated on a grid of unmasked pixels (minimum across all detectors).
+  - name: psf_ap_flux_delta_max
+    "@id": "#visit1_quicklook.psf_ap_flux_delta_max"
+    datatype: double
+    description: Delta (max - min) of model psf aperture flux (with aperture radius of max(2, 3*psfSigma)) values evaluated on a grid of unmasked pixels (maximum across all detectors).
+  - name: psf_ap_flux_delta_median
+    "@id": "#visit1_quicklook.psf_ap_flux_delta_median"
+    datatype: double
+    description: Delta (max - min) of model psf aperture flux (with aperture radius of max(2, 3*psfSigma)) values evaluated on a grid of unmasked pixels (median across all detectors).
+  - name: psf_ap_corr_sigma_scaled_delta_min
+    "@id": "#visit1_quicklook.psf_ap_corr_sigma_scaled_delta_min"
+    datatype: double
+    description: Delta (max - min) of psf flux aperture correction factors scaled (divided) by the psfSigma evaluated on a grid of unmasked pixels (minimum across all detectors).
+  - name: psf_ap_corr_sigma_scaled_delta_max
+    "@id": "#visit1_quicklook.psf_ap_corr_sigma_scaled_delta_max"
+    datatype: double
+    description: Delta (max - min) of psf flux aperture correction factors scaled (divided) by the psfSigma evaluated on a grid of unmasked pixels (maximum across all detectors).
+  - name: psf_ap_corr_sigma_scaled_delta_median
+    "@id": "#visit1_quicklook.psf_ap_corr_sigma_scaled_delta_median"
+    datatype: double
+    description: Delta (max - min) of psf flux aperture correction factors scaled (divided) by the psfSigma evaluated on a grid of unmasked pixels (median across all detectors).
   - name: max_dist_to_nearest_psf_min
     "@id": "#visit1_quicklook.max_dist_to_nearest_psf_min"
     datatype: float
@@ -1352,6 +1388,10 @@ tables:
     "@id": "#ccdvisit1_quicklook.seeing_zenith_500nm"
     datatype: double
     description: Measured PSF sigma, corrected to 500nm and an airmass of 1.
+  - name: pixel_scale
+    "@id": "#ccdvisit1_quicklook.pixel_scale"
+    datatype: float
+    description: Measured detector pixel scale (arcsec/pixel).
   - name: astrom_offset_mean
     "@id": "#ccdvisit1_quicklook.astrom_offset_mean"
     datatype: float
@@ -1444,6 +1484,14 @@ tables:
     datatype: float
     description: Delta (max - min) of model PSF trace radius values evaluated on a grid of unmasked pixels.
     ivoa:unit: pixel
+  - name: psf_ap_flux_delta
+    "@id": "#ccdvisit1_quicklook.psf_ap_flux_delta"
+    datatype: double
+    description: Delta (max - min) of model psf aperture flux (with aperture radius of max(2, 3*psfSigma)) values evaluated on a grid of unmasked pixels.
+  - name: psf_ap_corr_sigma_scaled_delta
+    "@id": "#ccdvisit1_quicklook.psf_ap_corr_sigma_scaled_delta"
+    datatype: double
+    description: Delta (max - min) of psf flux aperture correction factors scaled (divided) by the psfSigma evaluated on a grid of unmasked pixels.
   - name: max_dist_to_nearest_psf
     "@id": "#ccdvisit1_quicklook.max_dist_to_nearest_psf"
     datatype: float