From e9c8cdc3e278f05cf4cd5bc43746a0c5a0d173b8 Mon Sep 17 00:00:00 2001 From: Paul Grogan Date: Sat, 14 Nov 2026 23:09:40 -0700 Subject: [PATCH 1/8] move catalog validation scripts to validation/catalog and retire the GOES notebook The catalog validation scripts, their helpers, and the element sets only they read move out of docs/validation to a top-level validation/catalog folder, with a README on running them. Scripts take the record, fixture, and element set folders and their own source path from validation_io instead of repeating them, and the validation records cite the new paths. ValidateGeostationaryGOES is removed, as validate_catalog_abi tests the same products; the remaining validation notebooks are grouped by capability. --- .gitignore | 3 +- CHANGELOG.md | 3 +- docs/installation.rst | 2 +- .../ValidateGeostationaryGOES.ipynb | 671 ------------------ docs/validation/index.rst | 76 +- docs/validation/summary.rst | 4 +- src/tatc/resources/instruments/atlas.yml | 2 +- src/tatc/resources/instruments/lsar.yml | 2 +- src/tatc/resources/validation/abi.json | 6 +- src/tatc/resources/validation/ahi.json | 4 +- src/tatc/resources/validation/airs.json | 4 +- src/tatc/resources/validation/amsr2.json | 4 +- src/tatc/resources/validation/amsua.json | 4 +- src/tatc/resources/validation/ascat.json | 2 +- src/tatc/resources/validation/atlas.json | 2 +- src/tatc/resources/validation/atlid.json | 2 +- src/tatc/resources/validation/atms.json | 8 +- src/tatc/resources/validation/avhrr.json | 4 +- src/tatc/resources/validation/bbr.json | 2 +- src/tatc/resources/validation/ceres.json | 2 +- src/tatc/resources/validation/cpr.json | 2 +- src/tatc/resources/validation/cris.json | 4 +- src/tatc/resources/validation/csar.json | 4 +- src/tatc/resources/validation/dpr.json | 4 +- .../resources/validation/earthcare_msi.json | 2 +- src/tatc/resources/validation/ecostress.json | 2 +- src/tatc/resources/validation/emit.json | 2 +- src/tatc/resources/validation/gedi.json | 2 +- src/tatc/resources/validation/gmi.json | 4 +- src/tatc/resources/validation/harp2.json | 2 +- src/tatc/resources/validation/iasi.json | 4 +- src/tatc/resources/validation/karin.json | 2 +- src/tatc/resources/validation/lsar.json | 6 +- src/tatc/resources/validation/mhs.json | 4 +- src/tatc/resources/validation/modis.json | 4 +- src/tatc/resources/validation/msi.json | 2 +- src/tatc/resources/validation/oci.json | 2 +- src/tatc/resources/validation/oco2.json | 4 +- src/tatc/resources/validation/olci.json | 2 +- src/tatc/resources/validation/oli.json | 2 +- src/tatc/resources/validation/omps_nm.json | 4 +- src/tatc/resources/validation/poseidon4.json | 2 +- .../resources/validation/smap_radiometer.json | 4 +- src/tatc/resources/validation/spexone.json | 2 +- src/tatc/resources/validation/ssmis.json | 2 +- src/tatc/resources/validation/tempo.json | 2 +- src/tatc/resources/validation/tmi.json | 4 +- src/tatc/resources/validation/trmm_pr.json | 4 +- src/tatc/resources/validation/tropomi.json | 2 +- src/tatc/resources/validation/viirs.json | 6 +- src/tatc/resources/validation/virs.json | 4 +- tests/catalog/common.py | 2 +- tests/catalog/fixtures/NOTICE.md | 92 +-- tests/catalog/test_abi_fixture.py | 4 +- tests/catalog/test_amsr2_fixture.py | 2 +- tests/catalog/test_atlas_fixture.py | 4 +- tests/catalog/test_gmi_fixture.py | 2 +- tests/catalog/test_pushbroom_fixtures.py | 2 +- tests/catalog/test_scanner_fixtures.py | 24 +- tests/catalog/test_smap_fixture.py | 2 +- tests/catalog/test_tempo_fixture.py | 2 +- tests/catalog/test_tmi_fixture.py | 2 +- validation/README.md | 39 + .../catalog}/compare_swath_time_steps.py | 2 +- .../catalog}/earthcare_io.py | 0 .../elements}/earthcare_2026-09-27.3le | 0 .../catalog/elements}/gpm_2026-07-15.3le | 0 .../catalog/elements}/icesat2_2026-11-04.3le | 0 .../catalog/elements}/iss_2026-04-01.3le | 0 .../catalog/elements}/metop_2026-10-05.3le | 0 .../catalog/elements}/nisar_2026-11-01.3le | 0 .../catalog/elements}/sentinel_2026-08-12.3le | 0 .../catalog/elements}/smap_2026-09-20.3le | 0 .../catalog/elements}/trmm_2013-05-20.3le | 0 .../catalog}/gesdisc_scanner.py | 0 .../catalog}/validate_catalog_abi.py | 26 +- .../catalog}/validate_catalog_ahi.py | 19 +- .../catalog}/validate_catalog_airs.py | 20 +- .../catalog}/validate_catalog_amsr2.py | 13 +- .../catalog}/validate_catalog_amsua.py | 18 +- .../catalog}/validate_catalog_ascat.py | 17 +- .../catalog}/validate_catalog_atlas.py | 23 +- .../catalog}/validate_catalog_atlid.py | 22 +- .../catalog}/validate_catalog_atms.py | 19 +- .../catalog}/validate_catalog_avhrr.py | 24 +- .../catalog}/validate_catalog_bbr.py | 19 +- .../catalog}/validate_catalog_ceres.py | 14 +- .../catalog}/validate_catalog_cpr.py | 21 +- .../catalog}/validate_catalog_cris.py | 16 +- .../catalog}/validate_catalog_csar.py | 19 +- .../catalog}/validate_catalog_dpr.py | 25 +- .../validate_catalog_earthcare_msi.py | 29 +- .../catalog}/validate_catalog_ecostress.py | 26 +- .../catalog}/validate_catalog_emit.py | 16 +- .../catalog}/validate_catalog_gedi.py | 17 +- .../catalog}/validate_catalog_gmi.py | 13 +- .../catalog}/validate_catalog_harp2.py | 18 +- .../catalog}/validate_catalog_iasi.py | 16 +- .../catalog}/validate_catalog_karin.py | 14 +- .../catalog}/validate_catalog_lsar.py | 21 +- .../catalog}/validate_catalog_mhs.py | 23 +- .../catalog}/validate_catalog_modis.py | 18 +- .../catalog}/validate_catalog_msi.py | 19 +- .../catalog}/validate_catalog_oci.py | 20 +- .../catalog}/validate_catalog_oco2.py | 13 +- .../catalog}/validate_catalog_olci.py | 22 +- .../catalog}/validate_catalog_oli.py | 16 +- .../catalog}/validate_catalog_omps.py | 18 +- .../catalog}/validate_catalog_poseidon4.py | 16 +- .../catalog}/validate_catalog_smap.py | 21 +- .../catalog}/validate_catalog_spexone.py | 24 +- .../catalog}/validate_catalog_ssmis.py | 14 +- .../catalog}/validate_catalog_tempo.py | 14 +- .../catalog}/validate_catalog_tmi.py | 18 +- .../catalog}/validate_catalog_trmm_pr.py | 28 +- .../catalog}/validate_catalog_tropomi.py | 16 +- .../catalog}/validate_catalog_viirs.py | 19 +- .../catalog}/validate_catalog_virs.py | 16 +- .../catalog}/validation_io.py | 14 + 119 files changed, 716 insertions(+), 1200 deletions(-) delete mode 100644 docs/validation/ValidateGeostationaryGOES.ipynb create mode 100644 validation/README.md rename {docs/validation => validation/catalog}/compare_swath_time_steps.py (98%) rename {docs/validation => validation/catalog}/earthcare_io.py (100%) rename {docs/validation => validation/catalog/elements}/earthcare_2026-09-27.3le (100%) rename {docs/validation => validation/catalog/elements}/gpm_2026-07-15.3le (100%) rename {docs/validation => validation/catalog/elements}/icesat2_2026-11-04.3le (100%) rename {docs/validation => validation/catalog/elements}/iss_2026-04-01.3le (100%) rename {docs/validation => validation/catalog/elements}/metop_2026-10-05.3le (100%) rename {docs/validation => validation/catalog/elements}/nisar_2026-11-01.3le (100%) rename {docs/validation => validation/catalog/elements}/sentinel_2026-08-12.3le (100%) rename {docs/validation => validation/catalog/elements}/smap_2026-09-20.3le (100%) rename {docs/validation => validation/catalog/elements}/trmm_2013-05-20.3le (100%) rename {docs/validation => validation/catalog}/gesdisc_scanner.py (100%) rename {docs/validation => validation/catalog}/validate_catalog_abi.py (93%) rename {docs/validation => validation/catalog}/validate_catalog_ahi.py (95%) rename {docs/validation => validation/catalog}/validate_catalog_airs.py (90%) rename {docs/validation => validation/catalog}/validate_catalog_amsr2.py (98%) rename {docs/validation => validation/catalog}/validate_catalog_amsua.py (92%) rename {docs/validation => validation/catalog}/validate_catalog_ascat.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_atlas.py (94%) rename {docs/validation => validation/catalog}/validate_catalog_atlid.py (85%) rename {docs/validation => validation/catalog}/validate_catalog_atms.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_avhrr.py (92%) rename {docs/validation => validation/catalog}/validate_catalog_bbr.py (93%) rename {docs/validation => validation/catalog}/validate_catalog_ceres.py (95%) rename {docs/validation => validation/catalog}/validate_catalog_cpr.py (85%) rename {docs/validation => validation/catalog}/validate_catalog_cris.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_csar.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_dpr.py (87%) rename {docs/validation => validation/catalog}/validate_catalog_earthcare_msi.py (89%) rename {docs/validation => validation/catalog}/validate_catalog_ecostress.py (93%) rename {docs/validation => validation/catalog}/validate_catalog_emit.py (96%) rename {docs/validation => validation/catalog}/validate_catalog_gedi.py (96%) rename {docs/validation => validation/catalog}/validate_catalog_gmi.py (98%) rename {docs/validation => validation/catalog}/validate_catalog_harp2.py (92%) rename {docs/validation => validation/catalog}/validate_catalog_iasi.py (98%) rename {docs/validation => validation/catalog}/validate_catalog_karin.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_lsar.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_mhs.py (89%) rename {docs/validation => validation/catalog}/validate_catalog_modis.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_msi.py (98%) rename {docs/validation => validation/catalog}/validate_catalog_oci.py (96%) rename {docs/validation => validation/catalog}/validate_catalog_oco2.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_olci.py (94%) rename {docs/validation => validation/catalog}/validate_catalog_oli.py (98%) rename {docs/validation => validation/catalog}/validate_catalog_omps.py (92%) rename {docs/validation => validation/catalog}/validate_catalog_poseidon4.py (95%) rename {docs/validation => validation/catalog}/validate_catalog_smap.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_spexone.py (93%) rename {docs/validation => validation/catalog}/validate_catalog_ssmis.py (96%) rename {docs/validation => validation/catalog}/validate_catalog_tempo.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_tmi.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_trmm_pr.py (86%) rename {docs/validation => validation/catalog}/validate_catalog_tropomi.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_viirs.py (97%) rename {docs/validation => validation/catalog}/validate_catalog_virs.py (93%) rename {docs/validation => validation/catalog}/validation_io.py (97%) diff --git a/.gitignore b/.gitignore index a82df84f..33a9d658 100644 --- a/.gitignore +++ b/.gitignore @@ -71,9 +71,10 @@ instance/ # Sphinx documentation docs/_build/ -# Reference data downloaded by example and validation notebooks +# Reference data downloaded by example and validation notebooks, and catalog validation scripts docs/validation/data/ docs/examples/data/ +validation/data/ # PyBuilder .pybuilder/ diff --git a/CHANGELOG.md b/CHANGELOG.md index 18866d31..7f74988b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,7 +5,7 @@ Added a catalog of instruments from past and present missions, with a standard for validating them. Fixed instruments losing their fields when serialized. Instruments now reject unknown fields, which can break code that passes misspelled or unused arguments. Added: - - Module `catalog` of instruments from past and present missions (`get_entry`, `list_entries`), starting with GOES-R ABI, GPM GMI, GCOM-W AMSR2, ATMS, CrIS, VIIRS, MODIS, Landsat OLI, Sentinel-2 MSI, Sentinel-1 C-SAR, NISAR L-SAR, SWOT KaRIn, the SMAP radiometer, IASI, Sentinel-5P TROPOMI, GPM DPR, MHS, ICESat-2 ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, Sentinel-3 OLCI, PACE OCI, HARP2, and SPEXone, the OMPS Nadir Mapper, Himawari AHI, CERES, ECOSTRESS, OCO-2, the Sentinel-6 Poseidon-4 altimeter, Metop ASCAT, TEMPO, GEDI, EMIT, EarthCARE ATLID, BBR, CPR, and MSI, and TRMM PR, TMI, and VIRS. `InstrumentEntry.to_satellite` and `build` give an entry's instruments with the attitude they were validated with, and `InstrumentEntry.validation` gives its validation tier, computed from its results and the thresholds of the validation standard (`docs/validation/standard.rst`). GMI, ATMS, VIIRS, MODIS, OLI, MSI, KaRIn, TROPOMI, DPR, MHS, HARP2, SPEXone, Poseidon-4, ASCAT, TEMPO, TMI, VIRS, and EarthCARE's MSI are `validated`, each with stated limitations, and ABI, AMSR2, CrIS, C-SAR, L-SAR, the SMAP radiometer, IASI, ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, OLCI, OCI, OMPS, AHI, CERES, ECOSTRESS, OCO-2, GEDI, EMIT, ATLID, BBR, CPR, and TRMM PR are `partial` and list their gaps. Results on sibling satellites (NOAA-21, Metop-B, Sentinel-1D, Sentinel-6B) are recorded as transfers, which warn on use and do not count toward a tier; ATMS and VIIRS also have configurations fitted on NOAA-21, validated on held-out data, as NOAA-20's angles did not transfer. In an entry with configurations fitted on more than one platform (ATMS, VIIRS, and the OMPS Nadir Mapper), each configuration's name ends with its platform (`swath_noaa_20`, `swath_noaa_21`). Version 2 of the standard adds a lidar class, for ATLAS, version 3 an altimeter class, for Poseidon-4, version 4 a scatterometer class, for ASCAT, with the gates of the SAR class, version 5 a regional geostationary class, for TEMPO, whose gate is the intersection over union of the field of regard with the area a scan images, and version 6 a profiler class, for ATLID and CPR, with the gates of the altimeter class; none changes a threshold of an earlier version. Every pointed configuration with a view tailored to the time step is swept (`is_swept`), so its swaths do not depend on the time step; its records were rescored with swept swaths on the same held-out data, and MSI, TROPOMI, DPR, OCI's swath, and C-SAR's EW mode, whose tiers changed, were tested again on a later held-out day, with the rescored results stated in their limitations. The documentation lists the entries and their results on a page written from the catalog (`docs/validation/catalog_page.py`), and the example `UseInstrumentCatalog` shows their use. The OSSE examples `RunOSSEMonsoon` and `RunOSSEHurricane` take their ATMS and CrIS swaths from the catalog. + - Module `catalog` of instruments from past and present missions (`get_entry`, `list_entries`), starting with GOES-R ABI, GPM GMI, GCOM-W AMSR2, ATMS, CrIS, VIIRS, MODIS, Landsat OLI, Sentinel-2 MSI, Sentinel-1 C-SAR, NISAR L-SAR, SWOT KaRIn, the SMAP radiometer, IASI, Sentinel-5P TROPOMI, GPM DPR, MHS, ICESat-2 ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, Sentinel-3 OLCI, PACE OCI, HARP2, and SPEXone, the OMPS Nadir Mapper, Himawari AHI, CERES, ECOSTRESS, OCO-2, the Sentinel-6 Poseidon-4 altimeter, Metop ASCAT, TEMPO, GEDI, EMIT, EarthCARE ATLID, BBR, CPR, and MSI, and TRMM PR, TMI, and VIRS. `InstrumentEntry.to_satellite` and `build` give an entry's instruments with the attitude they were validated with, and `InstrumentEntry.validation` gives its validation tier, computed from its results and the thresholds of the validation standard (`docs/validation/standard.rst`). GMI, ATMS, VIIRS, MODIS, OLI, MSI, KaRIn, TROPOMI, DPR, MHS, HARP2, SPEXone, Poseidon-4, ASCAT, TEMPO, TMI, VIRS, and EarthCARE's MSI are `validated`, each with stated limitations, and ABI, AMSR2, CrIS, C-SAR, L-SAR, the SMAP radiometer, IASI, ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, OLCI, OCI, OMPS, AHI, CERES, ECOSTRESS, OCO-2, GEDI, EMIT, ATLID, BBR, CPR, and TRMM PR are `partial` and list their gaps. Results on sibling satellites (NOAA-21, Metop-B, Sentinel-1D, Sentinel-6B) are recorded as transfers, which warn on use and do not count toward a tier; ATMS and VIIRS also have configurations fitted on NOAA-21, validated on held-out data, as NOAA-20's angles did not transfer. In an entry with configurations fitted on more than one platform (ATMS, VIIRS, and the OMPS Nadir Mapper), each configuration's name ends with its platform (`swath_noaa_20`, `swath_noaa_21`). Version 2 of the standard adds a lidar class, for ATLAS, version 3 an altimeter class, for Poseidon-4, version 4 a scatterometer class, for ASCAT, with the gates of the SAR class, version 5 a regional geostationary class, for TEMPO, whose gate is the intersection over union of the field of regard with the area a scan images, and version 6 a profiler class, for ATLID and CPR, with the gates of the altimeter class; none changes a threshold of an earlier version. Every pointed configuration with a view tailored to the time step is swept (`is_swept`), so its swaths do not depend on the time step; its records were rescored with swept swaths on the same held-out data, and MSI, TROPOMI, DPR, OCI's swath, and C-SAR's EW mode, whose tiers changed, were tested again on a later held-out day, with the rescored results stated in their limitations. The documentation lists the entries and their results on a page written from the catalog (`docs/validation/catalog_page.py`), and the example `UseInstrumentCatalog` shows their use. The OSSE examples `RunOSSEMonsoon` and `RunOSSEHurricane` take their ATMS and CrIS swaths from the catalog. The scripts that validate the entries and write their records are in `validation/catalog` of the repository, with the element sets they read. - Class `catalog.TiltSchedule` and field `attitude_schedule` of catalog configurations, for an attitude that changes by day, as PACE's tilt does: `build` and `to_satellite` take the `start` and `end` of the analysis and give an `AttitudeSchedule` with an attitude for each day (UTC), blind while the tilt changes. Function `catalog.get_subsolar_latitude` gives the latitude of the subsolar point. - Field `type` of a catalog configuration's `attitude` (`attitude`, `glint`, or `target`), which builds an `Attitude`, `GlintAttitude`, or `TargetAttitude`, as for OCO-2's glint mode. - Field `blind_intervals` of `Attitude`: intervals of argument of latitude in which a space system's instruments do not observe, for example while the body or a mechanism moves. Observations in them are not valid, so point observations, ground tracks (`valid_obs`, and the swaths of `compute_ground_track`), orbit tracks, and ground pixels omit them, and the periods and swaths of region observations end at them. Method `is_observing` of attitudes, schedules, and instruments. @@ -13,6 +13,7 @@ Added: - Field `type` (`instrument`, `pointed`, or `conical`) of `Instrument`, `PointedInstrument`, and `ConicalInstrument`, which identifies the instrument class in serialized data. Data without a `type` loads as the class its fields imply. Changed: + - The validation notebooks are grouped by capability, as in the summary of their results. Notebook `ValidateGeostationaryGOES` is removed: the validation of the catalog's ABI entry tests the same products. - Instruments reject unknown fields, rather than ignoring them: a misspelled field in the data of a `PointedInstrument` previously gave an `Instrument` with a field of regard of 180 degrees. - Dumping a `Satellite` or other system with a `PointedInstrument` or `ConicalInstrument` keeps the fields of its class, and loading the data restores it. Previously, these instruments were written and restored as a base `Instrument`, without a warning. Data written by earlier versions lacks these fields, so it still loads as an `Instrument`. - Dumping a space system with an `attitude` omits the `velocity_frame` of its instruments, which the attitude sets, so the data can be loaded. diff --git a/docs/installation.rst b/docs/installation.rst index 1977146d..9b573c07 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -41,7 +41,7 @@ Note: the following optional dependencies are available with bracket notation: * :console:`pip install -e ".[examples]"`: for running optional examples in :console:`docs/examples` * :console:`pip install -e ".[osse]"`: for running optional observing system simulation experiment (OSSE) examples * :console:`pip install -e ".[preprocess]"`: for preprocessing functions (e.g., terrain masks) - * :console:`pip install -e ".[validation]"`: for running validation notebooks in :console:`docs/validation` (includes :console:`examples` and :console:`preprocess`) + * :console:`pip install -e ".[validation]"`: for running validation notebooks in :console:`docs/validation` and catalog validation scripts in :console:`validation/catalog` (includes :console:`examples` and :console:`preprocess`) Multiple optional dependencies can be installed with a comma-separated list (e.g., :console:`pip install -e ".[dev,examples]"`) diff --git a/docs/validation/ValidateGeostationaryGOES.ipynb b/docs/validation/ValidateGeostationaryGOES.ipynb deleted file mode 100644 index 5fe262f5..00000000 --- a/docs/validation/ValidateGeostationaryGOES.ipynb +++ /dev/null @@ -1,671 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "id": "52abee27", - "metadata": {}, - "source": [ - "# Geostationary Imager Validation: GOES-19 ABI\n", - "\n", - "A geostationary imager sees the same disk of the Earth continuously. The Advanced Baseline Imager (ABI) on [GOES-19](https://www.goes-r.gov/), the operational GOES-East satellite at 75.2 deg west, scans this full disk every 10 minutes. Its products are retrieved only where the satellite is high enough above the horizon: each declares the range of local zenith angles (the angle between the local vertical and the direction to the satellite) where it is retrieved and where it is of good quality. In TAT-C, an instrument observes points within its field of regard, the cone around nadir whose half angle is the maximum angle from nadir; a maximum local zenith angle (or a minimum elevation angle, 90 deg minus it) corresponds to a field of regard (`compute_field_of_regard`). This notebook compares these with GOES-19's full-disk products, and asks:\n", - "\n", - "1. **Earth disk.** Does TAT-C observe the full disk that ABI images, and does its viewing geometry (the satellite's elevation angle) match ABI's?\n", - "2. **Product coverage.** Do fields of regard computed from the products' maximum local zenith angles reproduce the regions where the products are of good quality?" - ] - }, - { - "cell_type": "markdown", - "id": "e02137c6", - "metadata": {}, - "source": [ - "## Reference Data\n", - "\n", - "GOES-19 ABI full-disk products for 3 October 2026, 12:00 UTC, are downloaded from the [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-goes/) archive on Amazon Web Services (anonymous access): the clear sky mask (ACM, 2 km pixels), whose fill values mark pixels off the Earth's disk; the sea surface temperature (SST, 2 km, hourly); and the land surface temperature (LST, 10 km, hourly). Pixel locations follow from ABI's fixed grid (scan angles from a nominal satellite position on the equator). The files (about 50 MB) are cached in a local `data/goes` directory.\n", - "\n", - "GOES-19 is modeled with a two-line element set (TLE) from [CelesTrak](https://celestrak.org/) with an epoch of 4 October 2026." - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "id": "c7177934", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-08T17:39:08.427800Z", - "iopub.status.busy": "2026-10-08T17:39:08.427800Z", - "iopub.status.idle": "2026-10-08T17:39:42.696547Z", - "shell.execute_reply": "2026-10-08T17:39:42.695536Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
pixelsretrieval local zenith angles (deg)good-quality local zenith angles (deg)
ACM5424 x 54240 to 900 to 70
SST5424 x 54240 to 900 to 67
LST1086 x 10860 to 850 to 55
\n", - "
" - ], - "text/plain": [ - " pixels retrieval local zenith angles (deg) \\\n", - "ACM 5424 x 5424 0 to 90 \n", - "SST 5424 x 5424 0 to 90 \n", - "LST 1086 x 1086 0 to 85 \n", - "\n", - " good-quality local zenith angles (deg) \n", - "ACM 0 to 70 \n", - "SST 0 to 67 \n", - "LST 0 to 55 " - ] - }, - "execution_count": 1, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "import concurrent.futures\n", - "import xml.etree.ElementTree as ET\n", - "from datetime import datetime, timedelta, timezone\n", - "from pathlib import Path\n", - "\n", - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "import pandas as pd\n", - "import requests\n", - "import xarray as xr\n", - "from skyfield.framelib import itrs\n", - "\n", - "from tatc.analysis import collect_observations\n", - "from tatc.constants import timescale\n", - "from tatc.schemas import GeneralPerturbationsOrbit, Instrument, Point, Satellite\n", - "from tatc.utils import compute_field_of_regard\n", - "\n", - "DATA_DIR = Path(\"data\") / \"goes\"\n", - "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", - "BUCKET = \"https://noaa-goes19.s3.amazonaws.com/\"\n", - "TIME = datetime(2026, 10, 3, 12, tzinfo=timezone.utc)\n", - "TLE = [\n", - " \"1 60133U 24119A 26277.37537957 -.00000263 00000+0 00000+0 0 9990\",\n", - " \"2 60133 0.0344 24.5665 0000927 249.5134 158.9494 1.00270254 8054\",\n", - "]\n", - "\n", - "\n", - "def download(product):\n", - " \"\"\"Download the first full-disk file of a product starting in the hour of TIME.\"\"\"\n", - " prefix = f\"{product}/{TIME:%Y}/{TIME.timetuple().tm_yday:03d}/{TIME:%H}/\"\n", - " root = ET.fromstring(\n", - " requests.get(\n", - " BUCKET, params={\"list-type\": \"2\", \"prefix\": prefix}, timeout=120\n", - " ).content\n", - " )\n", - " key = root.find(\n", - " \"{http://s3.amazonaws.com/doc/2006-03-01/}Contents/{http://s3.amazonaws.com/doc/2006-03-01/}Key\"\n", - " ).text\n", - " path = DATA_DIR / key.split(\"/\")[-1]\n", - " if not path.exists():\n", - " response = requests.get(BUCKET + key, timeout=600)\n", - " response.raise_for_status()\n", - " path.write_bytes(response.content)\n", - " return path\n", - "\n", - "\n", - "paths = {\n", - " product: sorted(\n", - " DATA_DIR.glob(\n", - " f\"OR_{product}-M6_G19_s{TIME:%Y}{TIME.timetuple().tm_yday:03d}{TIME:%H}*.nc\"\n", - " )\n", - " )\n", - " for product in [\"ABI-L2-ACMF\", \"ABI-L2-SSTF\", \"ABI-L2-LSTF\"]\n", - "}\n", - "paths = {\n", - " product: found[0] if found else download(product)\n", - " for product, found in paths.items()\n", - "}\n", - "\n", - "\n", - "def fixed_grid(ds):\n", - " \"\"\"Geodetic latitude and longitude (deg) of ABI fixed grid pixels (NaN off the Earth).\"\"\"\n", - " projection = ds.goes_imager_projection.attrs\n", - " r_eq, r_pol = projection[\"semi_major_axis\"], projection[\"semi_minor_axis\"]\n", - " h = projection[\"perspective_point_height\"] + r_eq\n", - " lon_0 = np.radians(projection[\"longitude_of_projection_origin\"])\n", - " x, y = np.meshgrid(ds.x.values, ds.y.values)\n", - " a = np.sin(x) ** 2 + np.cos(x) ** 2 * (\n", - " np.cos(y) ** 2 + (r_eq / r_pol) ** 2 * np.sin(y) ** 2\n", - " )\n", - " b = -2 * h * np.cos(x) * np.cos(y)\n", - " c = h**2 - r_eq**2\n", - " discriminant = b**2 - 4 * a * c\n", - " with np.errstate(invalid=\"ignore\"):\n", - " r_s = (-b - np.sqrt(discriminant)) / (2 * a)\n", - " s_x, s_y, s_z = (\n", - " r_s * np.cos(x) * np.cos(y),\n", - " -r_s * np.sin(x),\n", - " r_s * np.cos(x) * np.sin(y),\n", - " )\n", - " latitude = np.degrees(\n", - " np.arctan((r_eq / r_pol) ** 2 * s_z / np.sqrt((h - s_x) ** 2 + s_y**2))\n", - " )\n", - " longitude = np.degrees(lon_0 - np.arctan(s_y / (h - s_x)))\n", - " return latitude, longitude\n", - "\n", - "\n", - "goes19 = GeneralPerturbationsOrbit.from_tle(TLE)\n", - "satellite_itrs = np.array(\n", - " goes19.elements[0].to_skyfield().at(timescale.from_datetime(TIME)).frame_xyz(itrs).m\n", - ")\n", - "\n", - "\n", - "def elevation(latitude, longitude):\n", - " \"\"\"Elevation angle (deg) of GOES-19 (from its TLE) above the local (geodetic) horizon.\"\"\"\n", - " lat, lon = np.radians(latitude), np.radians(longitude)\n", - " a, f = 6378137.0, 1 / 298.257223563\n", - " e2 = f * (2 - f)\n", - " n = a / np.sqrt(1 - e2 * np.sin(lat) ** 2)\n", - " position = np.stack(\n", - " [\n", - " n * np.cos(lat) * np.cos(lon),\n", - " n * np.cos(lat) * np.sin(lon),\n", - " n * (1 - e2) * np.sin(lat),\n", - " ],\n", - " axis=-1,\n", - " )\n", - " up = np.stack(\n", - " [np.cos(lat) * np.cos(lon), np.cos(lat) * np.sin(lon), np.sin(lat)], axis=-1\n", - " )\n", - " line_of_sight = satellite_itrs - position\n", - " return np.degrees(\n", - " np.arcsin(\n", - " np.sum(up * line_of_sight, axis=-1) / np.linalg.norm(line_of_sight, axis=-1)\n", - " )\n", - " )\n", - "\n", - "\n", - "BLUE, ORANGE, AQUA, GRAY, INK, PURPLE = (\n", - " \"#2a78d6\",\n", - " \"#eb6834\",\n", - " \"#1baf7a\",\n", - " \"#8a8984\",\n", - " \"#0b0b0b\",\n", - " \"#8e5bd8\",\n", - ")\n", - "plt.rcParams.update(\n", - " {\n", - " \"axes.spines.top\": False,\n", - " \"axes.spines.right\": False,\n", - " \"axes.grid\": True,\n", - " \"grid.color\": \"#e6e5e0\",\n", - " \"grid.linewidth\": 0.6,\n", - " }\n", - ")\n", - "products = {product: xr.open_dataset(path) for product, path in paths.items()}\n", - "pd.DataFrame(\n", - " {\n", - " product.replace(\"ABI-L2-\", \"\").replace(\"F\", \"\"): {\n", - " \"pixels\": f\"{ds.sizes['x']} x {ds.sizes['y']}\",\n", - " \"retrieval local zenith angles (deg)\": \"0 to {:g}\".format(\n", - " float(ds.retrieval_local_zenith_angle_bounds[1])\n", - " ),\n", - " \"good-quality local zenith angles (deg)\": \"0 to {:g}\".format(\n", - " float(ds.quantitative_local_zenith_angle_bounds[1])\n", - " ),\n", - " }\n", - " for product, ds in products.items()\n", - " }\n", - ").T" - ] - }, - { - "cell_type": "markdown", - "id": "3dcd4730", - "metadata": {}, - "source": [ - "## Test 1: Earth Disk\n", - "\n", - "Every 8th pixel of the clear sky mask's 2 km grid (in both directions) is located on the Earth (or found to be off the disk) from ABI's fixed grid. A pixel is on the imaged disk if its clear sky mask is defined. GOES-19's elevation angle at each pixel is computed from the TLE, and TAT-C's observations are evaluated for a random sample of 2,000 pixels (`collect_observations` over 10 minutes) with an instrument whose field of regard (17.4 deg) spans the Earth's disk from geostationary altitude." - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "id": "5687b4b3", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-08T17:39:42.700066Z", - "iopub.status.busy": "2026-10-08T17:39:42.699067Z", - "iopub.status.idle": "2026-10-08T17:40:15.394854Z", - "shell.execute_reply": "2026-10-08T17:40:15.393844Z" - } - }, - "outputs": [ - { - "data": { - "text/plain": [ - "grid pixels on the Earth 360070.0000\n", - "pixels on the Earth imaged (%) 99.9997\n", - "imaged pixels off the Earth 0.0000\n", - "minimum elevation angle of imaged pixels (deg) 0.0055\n", - "sampled pixels: imaged (%) 100.0000\n", - "sampled pixels: observed by TAT-C (%) 100.0000\n", - "sampled imaged pixels observed by TAT-C (%) 100.0000\n", - "TAT-C sat_alt minus elevation, max |x| (deg) 0.0004\n", - "dtype: float64" - ] - }, - "execution_count": 2, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "acm = products[\"ABI-L2-ACMF\"].isel(x=slice(0, None, 8), y=slice(0, None, 8))\n", - "latitude, longitude = fixed_grid(acm)\n", - "on_grid = np.isfinite(latitude)\n", - "imaged = np.isfinite(acm.ACM.values)\n", - "grid_elevation = np.where(\n", - " on_grid, elevation(np.nan_to_num(latitude), np.nan_to_num(longitude)), np.nan\n", - ")\n", - "abi = Instrument(name=\"ABI\", field_of_regard=17.4)\n", - "satellite = Satellite(name=\"GOES-19\", orbit=goes19, instruments=[abi])\n", - "rng = np.random.default_rng(1)\n", - "sample = rng.choice(np.flatnonzero(on_grid), 2000, replace=False)\n", - "\n", - "\n", - "def observed(index):\n", - " \"\"\"TAT-C's observation of a pixel, and the satellite's elevation angle.\"\"\"\n", - " point = Point(\n", - " id=0,\n", - " latitude=float(latitude.flat[index]),\n", - " longitude=float(longitude.flat[index]),\n", - " )\n", - " obs = collect_observations(point, satellite, TIME, TIME + timedelta(minutes=10))\n", - " return {\n", - " \"index\": index,\n", - " \"observed\": not obs.empty,\n", - " \"sat_alt\": obs.sat_alt.iloc[0] if not obs.empty else np.nan,\n", - " }\n", - "\n", - "\n", - "with concurrent.futures.ThreadPoolExecutor(8) as pool:\n", - " sample1 = pd.DataFrame(list(pool.map(observed, sample)))\n", - "sample1[\"imaged\"] = imaged.ravel()[sample1[\"index\"].to_numpy()]\n", - "sample1[\"elevation\"] = grid_elevation.ravel()[sample1[\"index\"].to_numpy()]\n", - "pd.Series(\n", - " {\n", - " \"grid pixels on the Earth\": int(on_grid.sum()),\n", - " \"pixels on the Earth imaged (%)\": 100 * imaged[on_grid].mean(),\n", - " \"imaged pixels off the Earth\": int((imaged & ~on_grid).sum()),\n", - " \"minimum elevation angle of imaged pixels (deg)\": float(\n", - " np.nanmin(grid_elevation[imaged])\n", - " ),\n", - " \"sampled pixels: imaged (%)\": 100 * sample1.imaged.mean(),\n", - " \"sampled pixels: observed by TAT-C (%)\": 100 * sample1.observed.mean(),\n", - " \"sampled imaged pixels observed by TAT-C (%)\": 100\n", - " * sample1.observed[sample1.imaged].mean(),\n", - " \"TAT-C sat_alt minus elevation, max |x| (deg)\": float(\n", - " (sample1.sat_alt - sample1.elevation).abs().max()\n", - " ),\n", - " }\n", - ").round(4)" - ] - }, - { - "cell_type": "markdown", - "id": "c6111337", - "metadata": {}, - "source": [ - "ABI images the whole Earth disk: all but one of the 360,070 sampled grid pixels on the Earth have a clear sky mask, none off the Earth do, and the imaged pixels extend to the limb (GOES-19 0.006 deg above the horizon). TAT-C, with a 17.4 deg field of regard, observes every sampled pixel, and the satellite elevation angle it reports (`sat_alt`) agrees with the elevation computed from the same orbit and ABI's pixel locations to within 0.0004 deg. A 17.4 deg field of regard thus spans the disk that ABI's full-disk scan images from geostationary altitude.\n", - "\n", - "## Test 2: Product Coverage\n", - "\n", - "The sea and land surface temperature products report a quality flag for each pixel (good, degraded, or worse, and no retrieval where they are not produced). The local zenith angle of each pixel (90 deg minus GOES-19's elevation angle) is compared with the product's declared bounds. TAT-C models each product with an instrument whose field of regard corresponds to its good-quality bound (`compute_field_of_regard` from geostationary altitude with a minimum elevation angle of 90 deg minus the bound), and its observations are evaluated for a random sample of 2,000 retrieved pixels of each product within 5 deg of the bound." - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "id": "323d54de", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-08T17:40:15.398371Z", - "iopub.status.busy": "2026-10-08T17:40:15.397363Z", - "iopub.status.idle": "2026-10-08T17:41:11.682131Z", - "shell.execute_reply": "2026-10-08T17:41:11.681100Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
declared bounds, good / retrieved (deg)max local zenith angle, retrieved pixels (deg)max local zenith angle, good-quality pixels (deg)retrieved pixels beyond the retrieval boundgood-quality pixels beyond the good bound (%)TAT-C field of regard (deg)TAT-C: max local zenith angle observed (deg)TAT-C: min local zenith angle not observed (deg)sampled good-quality pixels observed by TAT-C (%)sampled pixels observed by TAT-C that are good quality (%)sampled pixels not observed by TAT-C that are good quality (%)
SST67 / 9089.65681367.20401300.13326215.99292667.24320766.93786799.49238618.4731390.106496
LST55 / 8588.04207255.2443064070.42814814.22234255.26749155.15224699.59308281.6513760.499376
\n", - "
" - ], - "text/plain": [ - " declared bounds, good / retrieved (deg) \\\n", - "SST 67 / 90 \n", - "LST 55 / 85 \n", - "\n", - " max local zenith angle, retrieved pixels (deg) \\\n", - "SST 89.656813 \n", - "LST 88.042072 \n", - "\n", - " max local zenith angle, good-quality pixels (deg) \\\n", - "SST 67.204013 \n", - "LST 55.244306 \n", - "\n", - " retrieved pixels beyond the retrieval bound \\\n", - "SST 0 \n", - "LST 407 \n", - "\n", - " good-quality pixels beyond the good bound (%) TAT-C field of regard (deg) \\\n", - "SST 0.133262 15.992926 \n", - "LST 0.428148 14.222342 \n", - "\n", - " TAT-C: max local zenith angle observed (deg) \\\n", - "SST 67.243207 \n", - "LST 55.267491 \n", - "\n", - " TAT-C: min local zenith angle not observed (deg) \\\n", - "SST 66.937867 \n", - "LST 55.152246 \n", - "\n", - " sampled good-quality pixels observed by TAT-C (%) \\\n", - "SST 99.492386 \n", - "LST 99.593082 \n", - "\n", - " sampled pixels observed by TAT-C that are good quality (%) \\\n", - "SST 18.473139 \n", - "LST 81.651376 \n", - "\n", - " sampled pixels not observed by TAT-C that are good quality (%) \n", - "SST 0.106496 \n", - "LST 0.499376 " - ] - }, - "execution_count": 3, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "rows2, zenith_by_product = {}, {}\n", - "for product, quality_name in [(\"ABI-L2-SSTF\", \"SST\"), (\"ABI-L2-LSTF\", \"LST\")]:\n", - " ds = products[product]\n", - " step = 4 if ds.sizes[\"x\"] > 2000 else 1\n", - " ds = ds.isel(x=slice(0, None, step), y=slice(0, None, step))\n", - " lat, lon = fixed_grid(ds)\n", - " valid = np.isfinite(lat)\n", - " zenith = np.where(\n", - " valid, 90 - elevation(np.nan_to_num(lat), np.nan_to_num(lon)), np.nan\n", - " )\n", - " retrieved = np.isfinite(ds[quality_name].values)\n", - " good = retrieved & (ds.DQF.values == 0)\n", - " good_bound = float(ds.quantitative_local_zenith_angle_bounds[1])\n", - " retrieval_bound = float(ds.retrieval_local_zenith_angle_bounds[1])\n", - " zenith_by_product[quality_name] = (\n", - " zenith,\n", - " retrieved,\n", - " good,\n", - " good_bound,\n", - " retrieval_bound,\n", - " )\n", - " field_of_regard = compute_field_of_regard(35786e3, 90 - good_bound)\n", - " product_satellite = Satellite(\n", - " name=\"GOES-19\",\n", - " orbit=goes19,\n", - " instruments=[Instrument(name=quality_name, field_of_regard=field_of_regard)],\n", - " )\n", - " near_bound = retrieved & (np.abs(zenith - good_bound) <= 5)\n", - " picks = rng.choice(np.flatnonzero(near_bound), 2000, replace=False)\n", - "\n", - " def observed_with_bound(\n", - " index, lat=lat, lon=lon, product_satellite=product_satellite\n", - " ):\n", - " point = Point(\n", - " id=0, latitude=float(lat.flat[index]), longitude=float(lon.flat[index])\n", - " )\n", - " return not collect_observations(\n", - " point, product_satellite, TIME, TIME + timedelta(minutes=10)\n", - " ).empty\n", - "\n", - " with concurrent.futures.ThreadPoolExecutor(8) as pool:\n", - " tatc = np.array(list(pool.map(observed_with_bound, picks)))\n", - " picked_zenith, picked_good = zenith.flat[picks], good.flat[picks]\n", - " rows2[quality_name] = {\n", - " \"declared bounds, good / retrieved (deg)\": f\"{good_bound:g} / {retrieval_bound:g}\",\n", - " \"max local zenith angle, retrieved pixels (deg)\": float(\n", - " np.nanmax(zenith[retrieved])\n", - " ),\n", - " \"max local zenith angle, good-quality pixels (deg)\": float(\n", - " np.nanmax(zenith[good])\n", - " ),\n", - " \"retrieved pixels beyond the retrieval bound\": int(\n", - " (retrieved & (zenith > retrieval_bound)).sum()\n", - " ),\n", - " \"good-quality pixels beyond the good bound (%)\": 100\n", - " * (good & (zenith > good_bound)).sum()\n", - " / good.sum(),\n", - " \"TAT-C field of regard (deg)\": field_of_regard,\n", - " \"TAT-C: max local zenith angle observed (deg)\": float(\n", - " picked_zenith[tatc].max()\n", - " ),\n", - " \"TAT-C: min local zenith angle not observed (deg)\": float(\n", - " picked_zenith[~tatc].min()\n", - " ),\n", - " \"sampled good-quality pixels observed by TAT-C (%)\": 100\n", - " * tatc[picked_good].mean(),\n", - " \"sampled pixels observed by TAT-C that are good quality (%)\": 100\n", - " * picked_good[tatc].mean(),\n", - " \"sampled pixels not observed by TAT-C that are good quality (%)\": 100\n", - " * picked_good[~tatc].mean(),\n", - " }\n", - "pd.DataFrame(rows2).T.round(3)" - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "id": "c58e5a2c", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-08T17:41:11.684143Z", - "iopub.status.busy": "2026-10-08T17:41:11.684143Z", - "iopub.status.idle": "2026-10-08T17:41:12.163030Z", - "shell.execute_reply": "2026-10-08T17:41:12.162700Z" - } - }, - "outputs": [ - { - "data": { - "image/png": "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nDjheOyOHTsYMGAAnp6eDBs2jCNHjpy3/Rd6/aeH9H/xxRfExcXh5+fH9OnTKSsrczymrKyMm2++GS8vLyIiInj77bcveIWztLSUu+66i9DQUHx9fRk3bhx79uw5b1sXLFjA1KlTa2yzWq089thj+Pv7ExQUxJNPPomiKDUeoygKr7/+OgkJCXh4eNCnTx++++67Go/58ccf6dy5Mx4eHowdO5bPPvvsnCkCU6dOZevWraSkpJy3nUIIIURTklhHYh2JdYRwTpKUEqKdy8zM5LLLLmPgwIHs2bOH2bNn88knn/Dvf//b8ZhnnnmG1157jeeee46DBw8yf/58wsLCHPf7+Pgwb948Dh48yLvvvsucOXN4++23692Gd999l+zsbMe/hx9+mNDQULp27QrYrzht2LCBBQsWsHfvXq677jomT57MsWPHHPuorKzkP//5D1988QVr164lLS2Nxx9/vM7jDR06lL/85S+OY8bExDjuf/bZZ3nzzTfZvn07Wq2W22+//bztr8/rP378OEuWLGHp0qUsXbqUNWvW8Oqrrzruf+yxx9iwYQM//vgjy5cvZ926dezcubPOYyqKwpQpU8jJyWHZsmXs2LGDfv36MX78eIqKiup83rp16xgwYECNbW+++Saffvopn3zyCevXr6eoqIjvv/++xmP+/ve/M3fuXGbPns2BAwd49NFHmTFjBmvWrAHgxIkTXHvttVx55ZXs3r2bu+++m2efffac48fGxhIaGsq6devq/oUKIYQQTUhiHYl1JNYRwokpQog2b9asWcq0adNqve9vf/ubkpiYqNhsNse2Dz74QPH29lasVqtiMBgUvV6vzJkzp97He/3115X+/fs7br/wwgtKnz596vXcRYsWKXq9Xlm3bp2iKIqSnJysqFQqJTMzs8bjxo8frzzzzDOKoijK3LlzFUBJTk6u8RrCwsIct//8Oxg9erTy8MMP19jnqlWrFEBZsWKFY9vPP/+sAIrRaKxX+xWl9tfv6empGAwGx7YnnnhCGTx4sKIoimIwGBSdTqcsXLjQcX9JSYni6elZo42xsbHK22+/rSiKovzxxx+Kr6+vYjKZahy7Y8eOyn//+99a21VcXKwAytq1a2tsj4iIUF599VXHbbPZrERHRzt+X+Xl5Yq7u7uycePGGs+74447lBtvvFFRFEV56qmnlJ49e9a4/9ln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", - "text/plain": [ - "
" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "fig, axes = plt.subplots(1, 2, figsize=(12, 3.6), sharey=True)\n", - "bins = np.arange(0, 91, 1)\n", - "for ax, (name, (zenith, retrieved, good, good_bound, retrieval_bound)) in zip(\n", - " axes, zenith_by_product.items()\n", - "):\n", - " counts_retrieved = np.histogram(zenith[retrieved], bins)[0]\n", - " counts_good = np.histogram(zenith[good], bins)[0]\n", - " total = np.histogram(zenith[np.isfinite(zenith)], bins)[0]\n", - " with np.errstate(invalid=\"ignore\", divide=\"ignore\"):\n", - " ax.plot(\n", - " bins[:-1] + 0.5,\n", - " 100 * counts_retrieved / total,\n", - " color=GRAY,\n", - " lw=2,\n", - " label=\"retrieved\",\n", - " )\n", - " ax.plot(\n", - " bins[:-1] + 0.5,\n", - " 100 * counts_good / total,\n", - " color=BLUE,\n", - " lw=1.5,\n", - " label=\"good quality\",\n", - " )\n", - " ax.axvline(good_bound, color=BLUE, ls=\"--\", lw=1)\n", - " ax.axvline(retrieval_bound, color=GRAY, ls=\"--\", lw=1)\n", - " ax.set(\n", - " xlabel=\"Local zenith angle (deg)\",\n", - " title=f\"{name} pixels by local zenith angle (dashed: declared bounds)\",\n", - " )\n", - "axes[0].set_ylabel(\"Pixels on the disk (%)\")\n", - "axes[0].legend(frameon=False, fontsize=8)\n", - "fig.tight_layout()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "id": "06abcf99", - "metadata": {}, - "source": [ - "Both products respect their declared bounds: the sea surface temperature is retrieved to a local zenith angle of 89.7 deg and is of good quality to 67.2 deg, and the land surface temperature is of good quality to 55.2 deg. A few good-quality pixels (0.13% and 0.43%) lie up to 0.2 deg beyond the bounds, probably from small differences in how the products compute the local zenith angle; the land surface temperature, on a 10 km grid, is also retrieved at 407 pixels up to 88 deg, beyond its 85 deg retrieval bound.\n", - "\n", - "The fields of regard corresponding to the good-quality bounds (16.0 and 14.2 deg) reproduce them to within about 0.3 deg: TAT-C observes pixels up to local zenith angles of 67.2 and 55.3 deg and no pixels beyond 66.9 and 55.2 deg (the boundary varies slightly with latitude, as `compute_field_of_regard` assumes a spherical Earth while observations are evaluated on the ellipsoid). Within 5 deg of the bounds, TAT-C observes 99.5 to 99.6% of the good-quality pixels, and only 0.1 to 0.5% of the pixels it does not observe are of good quality.\n", - "\n", - "## Summary\n", - "\n", - "| Test | Result |\n", - "| --- | --- |\n", - "| 1. Earth disk | a 17.4 deg field of regard observes every pixel ABI images, to the limb; satellite elevation angles within 0.0004 deg |\n", - "| 2. Product coverage (`compute_field_of_regard`) | fields of regard from the products' maximum local zenith angles reproduce their good-quality regions to within about 0.3 deg (99.5% of good-quality pixels near the bounds observed) |\n", - "\n", - "**Earth disk.** TAT-C's geostationary viewing geometry matches ABI's: a field of regard spanning the Earth's disk observes everything ABI images, and its satellite elevation angles match those from ABI's pixel locations.\n", - "\n", - "**Product coverage.** A geostationary product's coverage is limited by a maximum local zenith angle, which TAT-C models with a field of regard computed for the corresponding minimum elevation angle; it reproduces the products' good-quality regions to within a few tenths of a degree of local zenith angle, the difference between a spherical and an ellipsoidal Earth near the bound. (TAT-C points have no minimum elevation angle of their own: elevation limits are set through the instrument's field of regard.)" - ] - } - ], - "metadata": { - "kernelspec": { - "display_name": "tatc", - "language": "python", - "name": "python3" - }, - "language_info": { - "codemirror_mode": { - "name": "ipython", - "version": 3 - }, - "file_extension": ".py", - "mimetype": "text/x-python", - "name": "python", - "nbconvert_exporter": "python", - "pygments_lexer": "ipython3", - "version": "3.12.8" - } - }, - "nbformat": 4, - "nbformat_minor": 5 -} diff --git a/docs/validation/index.rst b/docs/validation/index.rst index b8f0a090..974cf9a1 100644 --- a/docs/validation/index.rst +++ b/docs/validation/index.rst @@ -10,46 +10,74 @@ The following compare TAT-C analysis results with reference data from operationa summary catalog standard - ValidateLimbMLS.ipynb - ValidateLimbSABER.ipynb - ValidateROCOSMIC2.ipynb - ValidateROPlanetiQ.ipynb - ValidateSpaceCOSMIC2.ipynb - ValidateSpaceGRACEFO.ipynb - ValidateSpaceSOCRATES.ipynb - ValidateRadarNEXRAD.ipynb + +The notebooks below are grouped as in the :doc:`summary`. Those on instruments and pointing derive the configurations of several catalog entries and explain the modeling choices behind them; the entries' results on data held out from their fits are on the :doc:`catalog` page. + +.. toctree:: + :maxdepth: 1 + :caption: Orbits and Propagation + + ValidateOrbitGeneration.ipynb + ValidateMaintainedOrbitLandsat9.ipynb + ValidateOrbitISS.ipynb + ValidateConstellationIridium.ipynb + +.. toctree:: + :maxdepth: 1 + :caption: Instruments and Pointing + ValidateImagerATMS.ipynb ValidateImagerCrIS.ipynb ValidateImagerVIIRS.ipynb - ValidateSARSentinel1.ipynb - ValidateSARNISAR.ipynb + ValidateDriftMODIS.ipynb ValidatePushbroomMSI.ipynb - ValidateRevisitSentinel2.ipynb - ValidateRegionSentinel2.ipynb - ValidateRegionPolarSentinel1.ipynb ValidateConicalAMSR2.ipynb ValidateConicalGMI.ipynb - ValidateCoincidenceGMIAMSR2.ipynb - ValidateGridSMAP.ipynb - ValidateOrbitGeneration.ipynb - ValidateDopGNSS.ipynb - ValidateLatencyNOAA20.ipynb - ValidateSolarLandsat.ipynb + ValidateSARNISAR.ipynb + ValidateSARSentinel1.ipynb ValidateSwathSWOT.ipynb ValidateLidarICESat2.ipynb - ValidateConstellationIridium.ipynb - ValidateGeostationaryGOES.ipynb - ValidateOrbitISS.ipynb - ValidateMaintainedOrbitLandsat9.ipynb ValidateTiltPACE.ipynb - ValidateDriftMODIS.ipynb ValidatePointingOCO2.ipynb ValidateYawFlipGPM.ipynb ValidateSampleSizes.ipynb + +.. toctree:: + :maxdepth: 1 + :caption: Coverage Analyses + + ValidateRevisitSentinel2.ipynb + ValidateRegionSentinel2.ipynb + ValidateRegionPolarSentinel1.ipynb ValidateFeaturesTCPRIMED.ipynb + ValidateGridSMAP.ipynb + ValidateSolarLandsat.ipynb + ValidateCoincidenceGMIAMSR2.ipynb + +.. toctree:: + :maxdepth: 1 + :caption: Limb, Occultation, and Satellite-to-Satellite + + ValidateLimbMLS.ipynb + ValidateLimbSABER.ipynb + ValidateROCOSMIC2.ipynb + ValidateROPlanetiQ.ipynb + ValidateSpaceCOSMIC2.ipynb + ValidateSpaceGRACEFO.ipynb + ValidateSpaceSOCRATES.ipynb + +.. toctree:: + :maxdepth: 1 + :caption: Ground Systems and Navigation + + ValidateRadarNEXRAD.ipynb + ValidateLatencyNOAA20.ipynb + ValidateDopGNSS.ipynb These notebooks download reference data on first run, except ``ValidateSampleSizes``, which reuses the data of the imager and conical scanner notebooks, and ``ValidateSpaceCOSMIC2``, which reuses the data of ``ValidateROCOSMIC2``. ``ValidateSpaceSOCRATES`` includes a sample of a SOCRATES run (data from CelesTrak). The MLS, NISAR, AMSR2, GMI, SWOT, ICESat-2, ECOSTRESS, PACE, MODIS, OCO-2, GPM, GRACE-FO, and SMAP data require a free `NASA Earthdata Login `_ account, and the orbit histories of the Landsat 9, TC PRIMED, and GRACE-FO notebooks a free `Space-Track.org `_ account. The notebooks require additional dependencies, which can be installed via:: pip install tatc[validation] using the pip package manager. + +The scripts that validate catalog entries and write their records are in the ``validation/catalog`` folder of the repository; see its `README `_. diff --git a/docs/validation/summary.rst b/docs/validation/summary.rst index f18fd644..0632c07a 100644 --- a/docs/validation/summary.rst +++ b/docs/validation/summary.rst @@ -179,8 +179,8 @@ Instruments and Pointing * - Geostationary imagers - GOES-19 ABI, Himawari-9 AHI, TEMPO - A 17.4 deg field of regard observes the full disk; elevation angles within 0.0004 deg; product coverage limits - within about 0.3 deg of local zenith angle (:doc:`ValidateGeostationaryGOES`). On held-out AHI cloud top - heights, the product's limit within 0.70 deg (:doc:`catalog`). TEMPO's region, as a rectangular view fitted + within 0.36 deg of local zenith angle; on held-out AHI cloud top heights, the product's limit within 0.70 deg + (:doc:`catalog`). TEMPO's region, as a rectangular view fitted to the edges of a full scan: field of regard IoU 0.994 with the area a held-out scan imaged; the hourly east-west sweep is not modeled (:doc:`catalog`) * - Tilted scanners (`pitch_angle_profile`), sun glint (`compute_glint_angle`) diff --git a/src/tatc/resources/instruments/atlas.yml b/src/tatc/resources/instruments/atlas.yml index a3b50e50..2c289b58 100644 --- a/src/tatc/resources/instruments/atlas.yml +++ b/src/tatc/resources/instruments/atlas.yml @@ -78,6 +78,6 @@ configurations: - The views follow the ground track of the element set's orbit, where ICESat-2 points its beams along their reference tracks, as over Antarctica, where the configuration was fitted and tested. Elsewhere, ICESat-2 often points them off the reference tracks (8 to 15 km between 40 deg S and 60 deg N, in ValidateLidarICESat2), which these views do not represent. - Each pair's strong and weak beams, about 90 m apart across track and 2.5 km along track, share one view. - On held-out data (4 November 2026, with an element set of 8 November, about 4 days from the data), the views contained every sampled segment, but TAT-C's epochs preceded the segments' times by 5.5 s (median), failing the timing gate. This is consistent with an along-track error of the element set, such as after an orbit adjustment that it does not represent, as ValidateLidarICESat2 also found; epochs are only as accurate as the element set along track. - - The same held-out data tested afterward with the element set of the day (epoch nearest its middle, from docs/validation/icesat2_2026-11-04.3le; validate_catalog_atlas.py --same-day-element-set) had every sampled segment within its pair's view, the pairs' spacing within 0.021 km, and epochs within 0.37 s (95th percentile; +0.03 s median), passing the timing gate. The record keeps the element set a few days from the data, the age for which the views' widths were fitted, so this result is not counted toward the tier. + - The same held-out data tested afterward with the element set of the day (epoch nearest its middle, from validation/catalog/elements/icesat2_2026-11-04.3le; validate_catalog_atlas.py --same-day-element-set) had every sampled segment within its pair's view, the pairs' spacing within 0.021 km, and epochs within 0.37 s (95th percentile; +0.03 s median), passing the timing gate. The record keeps the element set a few days from the data, the age for which the views' widths were fitted, so this result is not counted toward the tier. limitations: - TAT-C does not find ICESat-2's 91-day repeat cycle from an element set; declare it as a maintained orbit (see ValidateLidarICESat2). diff --git a/src/tatc/resources/instruments/lsar.yml b/src/tatc/resources/instruments/lsar.yml index 7ba387cd..7319a36c 100644 --- a/src/tatc/resources/instruments/lsar.yml +++ b/src/tatc/resources/instruments/lsar.yml @@ -137,7 +137,7 @@ configurations: limitations: - The roll profile has values only for the bins centered at 65 to 115, 235, 245, 295, and 305 deg of argument of latitude, where the 26 products of the mode on the fitting day were acquired, so it is interpolated elsewhere between its neighbors (from 32.81 to 33.00 deg). - The field of view is fixed, while the swath's measured field of view varies from 5.91 to 6.28 deg (5th to 95th percentile) on the fitting day. - - The configuration was added on 2026-11-10, when products of the mode acquired from 2026-11-01 to 2026-11-05 became available, after the other configurations' holdout. It is tested on the products of 2026-11-01, 2026-11-02, 2026-11-03, and 2026-11-05 together (30 to 34 days from the fit, chosen before any results), each with the element set whose epoch is nearest the middle of the day (from docs/validation/nisar_2026-11-01.3le). + - The configuration was added on 2026-11-10, when products of the mode acquired from 2026-11-01 to 2026-11-05 became available, after the other configurations' holdout. It is tested on the products of 2026-11-01, 2026-11-02, 2026-11-03, and 2026-11-05 together (30 to 34 days from the fit, chosen before any results), each with the element set whose epoch is nearest the middle of the day (from validation/catalog/elements/nisar_2026-11-01.3le). - Every product of the mode on the fitting and held-out days is a partial frame, whose bounding polygon outlines only its valid data, so the swath's area is not compared. - On the held-out days (30 products), 100 of the 101 lattice points observed were predicted (99.01%), the near-range and far-range edges were within 3.1 and 2.1 km (95th percentile), and the epochs within 0.13 s (95th percentile; -0.03 s median), passing every gate tested. - The held-out days were first tested, before element sets of those days were at hand, with the element set of 2026-11-04 (epoch 2026-11-08), 3 to 7 days after them, and the configuration was tested again with element sets of each day after those results, without changing it. With the later element set, 100 of the 101 points were predicted, and the near-range and far-range edges were within 8.9 and 8.8 km (95th percentile), but TAT-C's epochs preceded the zero-Doppler times by 1.14 s (median; 1.28 s at the 95th percentile), failing the timing gate. The difference shrinks as the element set's epoch nears the day (1.2 s on 2026-11-01, 0.35 s on 2026-11-05), as does the element set's position ahead of the products' recorded orbits along track (9.2 km on 2026-11-01, 1.7 km on 2026-11-05, against 0.08 km on the fitting day), so it measures the element set's age more than the view; the edges' distances include the same offset along track. On the fitting day, the edges were within 5.4 and 2.1 km and the epochs within 0.21 s. diff --git a/src/tatc/resources/validation/abi.json b/src/tatc/resources/validation/abi.json index f20ee583..022384c8 100644 --- a/src/tatc/resources/validation/abi.json +++ b/src/tatc/resources/validation/abi.json @@ -5,7 +5,7 @@ "full_disk": { "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_abi.py", + "source": "validation/catalog/validate_catalog_abi.py", "period": "2026-10-03T12:00Z", "platform": "goes-19", "digest": "0f24250ef8d0f2c98436fe13b243610e5617b920edc31c6c4ea794c3b1326e73", @@ -28,7 +28,7 @@ "sst_good_quality": { "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_abi.py", + "source": "validation/catalog/validate_catalog_abi.py", "period": "2026-10-03T12:00Z", "platform": "goes-19", "digest": "61f9d59e6d03c56b386b70e62a6f025e9f21eacfcd6bec545120e5d067823023", @@ -50,7 +50,7 @@ "lst_good_quality": { "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_abi.py", + "source": "validation/catalog/validate_catalog_abi.py", "period": "2026-10-03T12:00Z", "platform": "goes-19", "digest": "3c44900855e1fb4542e9f2948171c27c9cec3723ff52a082ecc9d919bf13ffb9", diff --git a/src/tatc/resources/validation/ahi.json b/src/tatc/resources/validation/ahi.json index 0d79d9e7..71b817f3 100644 --- a/src/tatc/resources/validation/ahi.json +++ b/src/tatc/resources/validation/ahi.json @@ -5,7 +5,7 @@ "full_disk": { "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_ahi.py", + "source": "validation/catalog/validate_catalog_ahi.py", "period": "2026-11-08T12:00Z", "platform": "himawari-9", "digest": "5d2ecc67bdbb68e12af30c19e66df0aaa5fcf3e4ff2b13907a799b4f1aeea633", @@ -28,7 +28,7 @@ "cloud_top_height": { "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_ahi.py", + "source": "validation/catalog/validate_catalog_ahi.py", "period": "2026-11-08T12:00Z", "platform": "himawari-9", "digest": "c8a8fcb28e64996bea02ea074e53c4519119687b7252385dd2a7eac09dffaff9", diff --git a/src/tatc/resources/validation/airs.json b/src/tatc/resources/validation/airs.json index 2f0ed4bb..588e3689 100644 --- a/src/tatc/resources/validation/airs.json +++ b/src/tatc/resources/validation/airs.json @@ -5,7 +5,7 @@ "digest": "7862db094b28e96e59d9bd0636934b55923d8779ce990fd0d4320aea07705d4b", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_airs.py", + "source": "validation/catalog/validate_catalog_airs.py", "reference": "Footprints published by the AIRS project; footprint positions of AIRSAQIRL1B version 8.0", "period": "2026-11-04", "platform": "aqua", @@ -47,7 +47,7 @@ "digest": "56f98ad36b5699a06d929cfca0d65c4b4a3f9e1493a0ae384a1f1a028dab8c13", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_airs.py", + "source": "validation/catalog/validate_catalog_airs.py", "reference": "AIRSAQIRL1B version 8.0 (footprint positions and times)", "period": "2026-11-04", "platform": "aqua", diff --git a/src/tatc/resources/validation/amsr2.json b/src/tatc/resources/validation/amsr2.json index f72ad964..27d773d7 100644 --- a/src/tatc/resources/validation/amsr2.json +++ b/src/tatc/resources/validation/amsr2.json @@ -5,7 +5,7 @@ "digest": "f583bcf1c5cd9b1f756f7881c40a6722b24fc50a1998fb984b0c0492192b9d21", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_amsr2.py", + "source": "validation/catalog/validate_catalog_amsr2.py", "reference": "Footprints of JAXA's AMSR2 channel set; spacing of GPM_1CGCOMW1AMSR2 version 08", "period": "2026-11-01", "platform": "gcom-w", @@ -52,7 +52,7 @@ "digest": "3b318e73416bf7866fd7ecf2eabf1bd5bca4a5df50ac8783d9a7dc981d08b737", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_amsr2.py", + "source": "validation/catalog/validate_catalog_amsr2.py", "reference": "GPM_1CGCOMW1AMSR2 version 08", "period": "2026-11-01", "platform": "gcom-w", diff --git a/src/tatc/resources/validation/amsua.json b/src/tatc/resources/validation/amsua.json index aba2b91f..a66715c3 100644 --- a/src/tatc/resources/validation/amsua.json +++ b/src/tatc/resources/validation/amsua.json @@ -5,7 +5,7 @@ "digest": "12c13b6d6059dce8bc645deadf845d3364840f84686bc2d5f1027c27e810a96a", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_amsua.py", + "source": "validation/catalog/validate_catalog_amsua.py", "reference": "Footprint published in the AIRABRAD documentation; footprint positions of AIRABRAD version 005", "period": "2026-11-05", "platform": "aqua", @@ -47,7 +47,7 @@ "digest": "369162ad7568ddcffbc1e3e81552c52f471f7b2232da5e94cc9be7f7f3928bce", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_amsua.py", + "source": "validation/catalog/validate_catalog_amsua.py", "reference": "AIRABRAD version 005 (footprint positions and times)", "period": "2026-11-05", "platform": "aqua", diff --git a/src/tatc/resources/validation/ascat.json b/src/tatc/resources/validation/ascat.json index 6c5350ec..3d48bf0e 100644 --- a/src/tatc/resources/validation/ascat.json +++ b/src/tatc/resources/validation/ascat.json @@ -5,7 +5,7 @@ "digest": "5d9d3f2ba6c6b2a59be1a0fb383cd836acbd56df2a78be1dc5251ce092f002b9", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_ascat.py", + "source": "validation/catalog/validate_catalog_ascat.py", "reference": "ASCATC-L2-25km (wind vector cell positions and row times)", "period": "2026-11-08", "platform": "metop-c", diff --git a/src/tatc/resources/validation/atlas.json b/src/tatc/resources/validation/atlas.json index f9fd9966..ae45bc1f 100644 --- a/src/tatc/resources/validation/atlas.json +++ b/src/tatc/resources/validation/atlas.json @@ -5,7 +5,7 @@ "digest": "667a1dc0178e3b4c539753823f444bec26dcdf558407204a32d80344865bbd9d", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_atlas.py", + "source": "validation/catalog/validate_catalog_atlas.py", "reference": "ATL08QL version 007 (land segments south of 60 deg S)", "period": "2026-11-04", "platform": "icesat-2", diff --git a/src/tatc/resources/validation/atlid.json b/src/tatc/resources/validation/atlid.json index bda4d297..ddbd7850 100644 --- a/src/tatc/resources/validation/atlid.json +++ b/src/tatc/resources/validation/atlid.json @@ -5,7 +5,7 @@ "digest": "e5519e6a3649052d584f93a14cd30790cceb1d49489a3d023983e02f5d6ee636", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_atlid.py", + "source": "validation/catalog/validate_catalog_atlid.py", "reference": "ATL_NOM_1B (profile positions and times)", "period": "2026-11-07", "platform": "earthcare", diff --git a/src/tatc/resources/validation/atms.json b/src/tatc/resources/validation/atms.json index aa708a7e..213beb4a 100644 --- a/src/tatc/resources/validation/atms.json +++ b/src/tatc/resources/validation/atms.json @@ -5,7 +5,7 @@ "digest": "6204bdac0a0a5f41b83b74d9d919ba45e7b5b79523a76b208625e83235f47056", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_atms.py", + "source": "validation/catalog/validate_catalog_atms.py", "reference": "Footprints of the TC PRIMED documentation; beam centers of the ATMS SDR geolocation", "period": "2026-08-12", "platform": "noaa-20", @@ -67,7 +67,7 @@ "digest": "b05ed81204ec49166c38805c94b006e2f976ddcb3019d4860a7334924f5cfb4a", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_atms.py", + "source": "validation/catalog/validate_catalog_atms.py", "reference": "ATMS SDR geolocation", "period": "2026-08-12", "platform": "noaa-20", @@ -128,7 +128,7 @@ "digest": "1d3bd90a9b9d472ec640d20deec56627cd4f3ff0cfadb71b6fc55188f7b29b31", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_atms.py", + "source": "validation/catalog/validate_catalog_atms.py", "reference": "Footprints of the TC PRIMED documentation; beam centers of the ATMS SDR geolocation", "period": "2026-10-02", "platform": "noaa-21", @@ -170,7 +170,7 @@ "digest": "a688ecbd6aa004f86243d81cd600f88b7c6666c27710bbafbcf847afd43c9aaf", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_atms.py", + "source": "validation/catalog/validate_catalog_atms.py", "reference": "ATMS SDR geolocation", "period": "2026-10-02", "platform": "noaa-21", diff --git a/src/tatc/resources/validation/avhrr.json b/src/tatc/resources/validation/avhrr.json index 5a864342..905f81c1 100644 --- a/src/tatc/resources/validation/avhrr.json +++ b/src/tatc/resources/validation/avhrr.json @@ -5,7 +5,7 @@ "digest": "dcfebefeca4069deec30f6a8c67926425d988e24586907d48c43d7a6695f952e", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_avhrr.py", + "source": "validation/catalog/validate_catalog_avhrr.py", "reference": "Footprint published by the NWP SAF; sample positions of AVHRRF_MC-STAR-L2P version 2.80", "period": "2026-10-03", "platform": "metop-c", @@ -67,7 +67,7 @@ "digest": "bf446fbb3e2739c9e8abeb1755bccd57cf220b8259840979cdb26d3fca1f6edd", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_avhrr.py", + "source": "validation/catalog/validate_catalog_avhrr.py", "reference": "AVHRRF_MC-STAR-L2P version 2.80 (sample positions and times)", "period": "2026-10-03", "platform": "metop-c", diff --git a/src/tatc/resources/validation/bbr.json b/src/tatc/resources/validation/bbr.json index f7b8e27b..86903da8 100644 --- a/src/tatc/resources/validation/bbr.json +++ b/src/tatc/resources/validation/bbr.json @@ -5,7 +5,7 @@ "digest": "6287376998a9ec6e1230e2850df062d2266f5336b5e7d8c4d2601a4d98de31e5", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_bbr.py", + "source": "validation/catalog/validate_catalog_bbr.py", "reference": "BBR_SNG_1B (pixel positions of the shortwave band, every second line)", "period": "2026-11-07", "platform": "earthcare", diff --git a/src/tatc/resources/validation/ceres.json b/src/tatc/resources/validation/ceres.json index 1cb46de2..02984139 100644 --- a/src/tatc/resources/validation/ceres.json +++ b/src/tatc/resources/validation/ceres.json @@ -5,7 +5,7 @@ "digest": "502da50334b599f443ad05a8fe9238e13cb97975974b8987353f1a5a7567bbb0", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_ceres.py", + "source": "validation/catalog/validate_catalog_ceres.py", "reference": "CER_ES8_NOAA20-FM6 Edition1 (footprint positions, projected to the ellipsoid, and times)", "period": "2026-09-30", "platform": "noaa-20", diff --git a/src/tatc/resources/validation/cpr.json b/src/tatc/resources/validation/cpr.json index 45afd0de..85e0fb52 100644 --- a/src/tatc/resources/validation/cpr.json +++ b/src/tatc/resources/validation/cpr.json @@ -5,7 +5,7 @@ "digest": "c71562f90b481806dbdbe5d458988cfe622d6e7d4708514f6b7edb1471ab5bcd", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_cpr.py", + "source": "validation/catalog/validate_catalog_cpr.py", "reference": "CPR_NOM_1B (profile positions and times)", "period": "2026-11-07", "platform": "earthcare", diff --git a/src/tatc/resources/validation/cris.json b/src/tatc/resources/validation/cris.json index e19be4d0..dbd8fa08 100644 --- a/src/tatc/resources/validation/cris.json +++ b/src/tatc/resources/validation/cris.json @@ -5,7 +5,7 @@ "digest": "14a2de8b4b2b0fc73bbbd5b728623007b4ecbb20458ddd89c86d64d29dfc9f1c", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_cris.py", + "source": "validation/catalog/validate_catalog_cris.py", "reference": "Footprints published by the NWP SAF; fields of view of the CrIS SDR geolocation", "period": "2026-08-12", "platform": "noaa-20", @@ -51,7 +51,7 @@ "digest": "fc32ce15a3780ef5596decc7d4a8c2f7bd27c888973cfe6adeec5e19d98ad616", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_cris.py", + "source": "validation/catalog/validate_catalog_cris.py", "reference": "CrIS SDR geolocation", "period": "2026-08-12", "platform": "noaa-20", diff --git a/src/tatc/resources/validation/csar.json b/src/tatc/resources/validation/csar.json index 99ccc42f..29188ca6 100644 --- a/src/tatc/resources/validation/csar.json +++ b/src/tatc/resources/validation/csar.json @@ -5,7 +5,7 @@ "digest": "a4281159073196f40a8cb313b9f2ee4f726cfb95a0a68f2f494347f332dd405c", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_csar.py", + "source": "validation/catalog/validate_catalog_csar.py", "reference": "Geolocation grids and restituted orbits of the annotations of Sentinel-1 Level-1 GRD products", "period": "2026-08-12", "platform": "sentinel-1c", @@ -128,7 +128,7 @@ "digest": "d4db44c916245f35b65999b72767e909314348279335144b5abdfc3b64e624b1", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_csar.py", + "source": "validation/catalog/validate_catalog_csar.py", "reference": "Geolocation grids and restituted orbits of the annotations of Sentinel-1 Level-1 GRD products", "period": "2026-11-10", "platform": "sentinel-1c", diff --git a/src/tatc/resources/validation/dpr.json b/src/tatc/resources/validation/dpr.json index f990d575..9097c035 100644 --- a/src/tatc/resources/validation/dpr.json +++ b/src/tatc/resources/validation/dpr.json @@ -5,7 +5,7 @@ "digest": "9160f56cc9b93ca21570ce108b105c8cb7ee2e1b36f2ab9557c787700cff06af", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_dpr.py", + "source": "validation/catalog/validate_catalog_dpr.py", "reference": "Footprints of the TC PRIMED documentation; beam positions of GPM_2ADPR version 08", "period": "2026-11-10", "platform": "gpm", @@ -47,7 +47,7 @@ "digest": "882b5b5f11d8ad70d370902f965b65f3557a5a70d58ea9cb444c02d5e94b5f85", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_dpr.py", + "source": "validation/catalog/validate_catalog_dpr.py", "reference": "GPM_2ADPR version 08 (beam positions of the full swath)", "period": "2026-11-10", "platform": "gpm", diff --git a/src/tatc/resources/validation/earthcare_msi.json b/src/tatc/resources/validation/earthcare_msi.json index fa1ab467..69291c5d 100644 --- a/src/tatc/resources/validation/earthcare_msi.json +++ b/src/tatc/resources/validation/earthcare_msi.json @@ -5,7 +5,7 @@ "digest": "b686125d467695ed4e9e8819886ed578b9b5b4450bf6a5cf152ec7eb72067dc4", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_earthcare_msi.py", + "source": "validation/catalog/validate_catalog_earthcare_msi.py", "reference": "MSI_RGR_1C (pixel positions of every fourth orbit, every eighth line), with spacecraft positions of ATL_NOM_1B", "period": "2026-11-07", "platform": "earthcare", diff --git a/src/tatc/resources/validation/ecostress.json b/src/tatc/resources/validation/ecostress.json index 5f24564c..a198d0af 100644 --- a/src/tatc/resources/validation/ecostress.json +++ b/src/tatc/resources/validation/ecostress.json @@ -5,7 +5,7 @@ "digest": "86d9d7f5ab5a5e0223abd434f481c70367c2182691922da307a3fe9523e3eafc", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_ecostress.py", + "source": "validation/catalog/validate_catalog_ecostress.py", "reference": "ECO_L1B_GEO version 002 (sample positions and times of every fourth sweep, in blocks of eight consecutive scenes of every 32)", "period": "2026-11-08", "platform": "iss", diff --git a/src/tatc/resources/validation/emit.json b/src/tatc/resources/validation/emit.json index c41dcd67..187fc6ac 100644 --- a/src/tatc/resources/validation/emit.json +++ b/src/tatc/resources/validation/emit.json @@ -5,7 +5,7 @@ "digest": "75e98ffbe9347dbffa3aae71f348097c01a6911aa947abaf47b98d264a728327", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_emit.py", + "source": "validation/catalog/validate_catalog_emit.py", "reference": "EMITL1BRAD version 002, observation geometry (pixel positions and line times of every 16th line)", "period": "2026-11-08", "platform": "iss", diff --git a/src/tatc/resources/validation/gedi.json b/src/tatc/resources/validation/gedi.json index bb944a1a..6c4966b8 100644 --- a/src/tatc/resources/validation/gedi.json +++ b/src/tatc/resources/validation/gedi.json @@ -5,7 +5,7 @@ "digest": "c91a076745f0c7ae78527f94f525be947c12960c33fa2cac0922f8782de7bfd9", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_gedi.py", + "source": "validation/catalog/validate_catalog_gedi.py", "reference": "GEDI01_B version 003 (every 200th shot, where the beams' center lies within 1 deg of nadir)", "period": "2026-06-08", "platform": "iss", diff --git a/src/tatc/resources/validation/gmi.json b/src/tatc/resources/validation/gmi.json index cd129850..07486476 100644 --- a/src/tatc/resources/validation/gmi.json +++ b/src/tatc/resources/validation/gmi.json @@ -6,7 +6,7 @@ "digest": "7a88b43962de1f39c462f46e95dc206ac99e019a77f2be98e888feb45e7bf499", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_gmi.py", + "source": "validation/catalog/validate_catalog_gmi.py", "reference": "GPM_1CGPMGMI version 08", "period": "2026-07-20", "platform": "gpm", @@ -72,7 +72,7 @@ "digest": "5ea1adca77c77a9d04b7cb4f546c8c456c1ab0ce5a14d041277a7e0d4fe23a6f", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_gmi.py", + "source": "validation/catalog/validate_catalog_gmi.py", "reference": "Footprints of the GMI L1B ATBD and TC PRIMED; spacing of GPM_1CGPMGMI version 08", "period": "2026-07-20", "platform": "gpm", diff --git a/src/tatc/resources/validation/harp2.json b/src/tatc/resources/validation/harp2.json index 31798d3f..ac5d1152 100644 --- a/src/tatc/resources/validation/harp2.json +++ b/src/tatc/resources/validation/harp2.json @@ -5,7 +5,7 @@ "digest": "dbbda9bbb91e8bfad0332d07dc4e83711dcebe054f8d7c1450c687b22efb47bd", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_harp2.py", + "source": "validation/catalog/validate_catalog_harp2.py", "reference": "PACE_HARP2_L1B_SCI version 4 (positions and times of the near-nadir view)", "period": "2026-11-07", "platform": "pace", diff --git a/src/tatc/resources/validation/iasi.json b/src/tatc/resources/validation/iasi.json index 11ac1084..9d1ef24c 100644 --- a/src/tatc/resources/validation/iasi.json +++ b/src/tatc/resources/validation/iasi.json @@ -5,7 +5,7 @@ "digest": "dd12e9608ac7a89c6963aaa4f142712a52e4bd9926747a972cb2e3b0e1d199fd", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_iasi.py", + "source": "validation/catalog/validate_catalog_iasi.py", "reference": "Published footprints; pixel positions of the OSI SAF IASI sea surface temperature product", "period": "2026-11-04", "platform": "metop-b", @@ -47,7 +47,7 @@ "digest": "69373d1399c8f165b3493f371cf6cd0240848b48c01476ba7ad90fe7c647d36a", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_iasi.py", + "source": "validation/catalog/validate_catalog_iasi.py", "reference": "Pixel positions of the OSI SAF IASI sea surface temperature product", "period": "2026-11-04", "platform": "metop-b", diff --git a/src/tatc/resources/validation/karin.json b/src/tatc/resources/validation/karin.json index cfe8d164..49eced81 100644 --- a/src/tatc/resources/validation/karin.json +++ b/src/tatc/resources/validation/karin.json @@ -5,7 +5,7 @@ "digest": "59e40263c6b54b186c1ce9b1e424f117c7b8adb14ed319fff9d15b8ddf7ab67d", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_karin.py", + "source": "validation/catalog/validate_catalog_karin.py", "reference": "SWOT_L2_LR_SSH_BASIC_D (good-quality pixels and line times)", "period": "2026-11-04", "platform": "swot", diff --git a/src/tatc/resources/validation/lsar.json b/src/tatc/resources/validation/lsar.json index e73cce5b..b4d437a5 100644 --- a/src/tatc/resources/validation/lsar.json +++ b/src/tatc/resources/validation/lsar.json @@ -5,7 +5,7 @@ "digest": "e67e1e5d49acea59d3d35bca921f519a83dd3d31f98c548fb6e2ba0baf85407f", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_lsar.py", + "source": "validation/catalog/validate_catalog_lsar.py", "reference": "Geolocation grids, orbits, and bounding polygons of NISAR Level 1 RSLC products", "period": "2026-11-04", "platform": "nisar", @@ -73,7 +73,7 @@ "digest": "f8b48d01faf157ff78d710527be59e46478af30b6b114a004d996af433de4874", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_lsar.py", + "source": "validation/catalog/validate_catalog_lsar.py", "reference": "Geolocation grids, orbits, and bounding polygons of NISAR Level 1 RSLC products", "period": "2026-11-04", "platform": "nisar", @@ -141,7 +141,7 @@ "digest": "487fa95b160e4567932ce285f6396f7222da083e56cc66a112cab00f0f4bf6f2", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_lsar.py", + "source": "validation/catalog/validate_catalog_lsar.py", "reference": "Geolocation grids, orbits, and bounding polygons of NISAR Level 1 RSLC products", "period": "2026-11-01, 2026-11-02, 2026-11-03, 2026-11-05", "platform": "nisar", diff --git a/src/tatc/resources/validation/mhs.json b/src/tatc/resources/validation/mhs.json index 97de265e..9c441a4b 100644 --- a/src/tatc/resources/validation/mhs.json +++ b/src/tatc/resources/validation/mhs.json @@ -5,7 +5,7 @@ "digest": "291de4c0921c1c0341917876fe99e671a10e1e212e6066f5c5ee2bb79b980eba", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_mhs.py", + "source": "validation/catalog/validate_catalog_mhs.py", "reference": "Footprints of the TC PRIMED documentation; beam positions of GPM_1CMETOPCMHS version 08", "period": "2026-10-05", "platform": "metop-c", @@ -67,7 +67,7 @@ "digest": "5f1d822acf8ea40bca9f0338de998fa0673b72b47e2a05ccec8cd25acd049d1d", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_mhs.py", + "source": "validation/catalog/validate_catalog_mhs.py", "reference": "GPM_1CMETOPCMHS version 08 (beam positions)", "period": "2026-10-05", "platform": "metop-c", diff --git a/src/tatc/resources/validation/modis.json b/src/tatc/resources/validation/modis.json index 6e527acf..a7ce8b6b 100644 --- a/src/tatc/resources/validation/modis.json +++ b/src/tatc/resources/validation/modis.json @@ -5,7 +5,7 @@ "digest": "a518db197f63a99221d3e01edef2bb6e9e17d9e5c01951d6102e5931b86eafcc", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_modis.py", + "source": "validation/catalog/validate_catalog_modis.py", "reference": "Footprints published by NASA LAADS; MOD03 geolocation", "period": "2026-11-05", "platform": "terra", @@ -67,7 +67,7 @@ "digest": "33de100f7a41137444b388fab6660034b57488ec2bf39af2b7d22fb265c2c104", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_modis.py", + "source": "validation/catalog/validate_catalog_modis.py", "reference": "MOD03 geolocation", "period": "2026-11-05", "platform": "terra", diff --git a/src/tatc/resources/validation/msi.json b/src/tatc/resources/validation/msi.json index b83f456f..040b57fa 100644 --- a/src/tatc/resources/validation/msi.json +++ b/src/tatc/resources/validation/msi.json @@ -5,7 +5,7 @@ "digest": "1c2ee659e3483a7f968250f7d5304b6ebaa8318bf52a34f599f927c2e69cf4d5", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_msi.py", + "source": "validation/catalog/validate_catalog_msi.py", "reference": "Valid data footprints of Sentinel-2 Level-2A tiles; viewing angle grids and GPS ephemerides of their metadata", "period": "2026-11-10", "platform": "sentinel-2a, sentinel-2b, sentinel-2c", diff --git a/src/tatc/resources/validation/oci.json b/src/tatc/resources/validation/oci.json index d9fe217e..9cf81564 100644 --- a/src/tatc/resources/validation/oci.json +++ b/src/tatc/resources/validation/oci.json @@ -5,7 +5,7 @@ "digest": "fbfdc468489c8229a04346c1416405cc9aec8a33ed0e9167dc347205575b2878", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_oci.py", + "source": "validation/catalog/validate_catalog_oci.py", "reference": "PACE_OCI_L1B_SCI version 3 (sample positions and times)", "period": "2026-11-10", "platform": "pace", diff --git a/src/tatc/resources/validation/oco2.json b/src/tatc/resources/validation/oco2.json index 118a4bb1..71f7335f 100644 --- a/src/tatc/resources/validation/oco2.json +++ b/src/tatc/resources/validation/oco2.json @@ -5,7 +5,7 @@ "digest": "c449b1266d6a9d23c6f2a3f31c5c29627153d562b2fd4e8802a6bea6b16551fb", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_oco2.py", + "source": "validation/catalog/validate_catalog_oco2.py", "reference": "OCO2_L1B_Science version 11.2 (sounding positions and times, nadir orbits)", "period": "2026-11-07", "platform": "oco-2", @@ -41,7 +41,7 @@ "digest": "5e5e2514972d07b5ca4809fe207647ffce5e74c174837b9fe02d2717dc872f37", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_oco2.py", + "source": "validation/catalog/validate_catalog_oco2.py", "reference": "OCO2_L1B_Science version 11.2 (sounding positions and times, glint orbits)", "period": "2026-11-07", "platform": "oco-2", diff --git a/src/tatc/resources/validation/olci.json b/src/tatc/resources/validation/olci.json index af9b0bb4..9e9b8504 100644 --- a/src/tatc/resources/validation/olci.json +++ b/src/tatc/resources/validation/olci.json @@ -5,7 +5,7 @@ "digest": "1c621fd237a9da173904db099c16b3b49999262d3e3f7e755ea2a833232d9488", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_olci.py", + "source": "validation/catalog/validate_catalog_olci.py", "reference": "S3A_OL_1_EFR (tie point positions and times)", "period": "2026-11-04", "platform": "sentinel-3a", diff --git a/src/tatc/resources/validation/oli.json b/src/tatc/resources/validation/oli.json index b506dcf4..73493b85 100644 --- a/src/tatc/resources/validation/oli.json +++ b/src/tatc/resources/validation/oli.json @@ -5,7 +5,7 @@ "digest": "37118d2d6c5b18ed3b50f4d03d80daae862f69e92a1b567032009ebc33855714", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_oli.py", + "source": "validation/catalog/validate_catalog_oli.py", "reference": "USGS Landsat Collection 2 scene footprints and center times; angle coefficient files of Level-2 products", "period": "2026-10-03", "platform": "landsat-9", diff --git a/src/tatc/resources/validation/omps_nm.json b/src/tatc/resources/validation/omps_nm.json index fe30ff3c..7cdd0d15 100644 --- a/src/tatc/resources/validation/omps_nm.json +++ b/src/tatc/resources/validation/omps_nm.json @@ -5,7 +5,7 @@ "digest": "f4c2a37a0a87cdc3c9d400e4430dce483b27b22ad12b55e827792524736430fe", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_omps.py", + "source": "validation/catalog/validate_catalog_omps.py", "reference": "OMPS-TC-GEO (sample positions and times), NOAA Open Data Dissemination", "period": "2026-11-05", "platform": "noaa-21", @@ -41,7 +41,7 @@ "digest": "4d3ad5fb855d592975f403f34904189470d57ae1c4e35e8c3f99b42fbe1c0e5e", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_omps.py", + "source": "validation/catalog/validate_catalog_omps.py", "reference": "OMPS-TC-GEO (sample positions and times), NOAA Open Data Dissemination", "period": "2026-11-05", "platform": "noaa-20", diff --git a/src/tatc/resources/validation/poseidon4.json b/src/tatc/resources/validation/poseidon4.json index 9606b1fb..856a8be3 100644 --- a/src/tatc/resources/validation/poseidon4.json +++ b/src/tatc/resources/validation/poseidon4.json @@ -5,7 +5,7 @@ "digest": "5270b7e4de6236de4a54677131ec62eefb5c29566aaf188925fd3b6b64fa6910", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_poseidon4.py", + "source": "validation/catalog/validate_catalog_poseidon4.py", "reference": "JASON_CS_S6A_L2_ALT_LR_RED_OST_NRT_F (1 Hz measurement positions and times)", "period": "2026-11-07", "platform": "sentinel-6a", diff --git a/src/tatc/resources/validation/smap_radiometer.json b/src/tatc/resources/validation/smap_radiometer.json index b8a33a43..14b46ca4 100644 --- a/src/tatc/resources/validation/smap_radiometer.json +++ b/src/tatc/resources/validation/smap_radiometer.json @@ -5,7 +5,7 @@ "digest": "ca3c6cdb3aea9144061cb5594ceefedb81608d68f34e565475ea76e6c9343efd", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_smap.py", + "source": "validation/catalog/validate_catalog_smap.py", "reference": "SPL1BTB (footprint positions and times)", "period": "2026-09-20", "platform": "smap", @@ -45,7 +45,7 @@ "digest": "8b58cf9ab3ef01c04ca505141a40751442adc77cb7a856db63baf865a53ce0de", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_smap.py", + "source": "validation/catalog/validate_catalog_smap.py", "reference": "Footprints of Piepmeier et al. (2017) and the JPL SMAP specifications; spacing of SPL1BTB", "period": "2026-09-20", "platform": "smap", diff --git a/src/tatc/resources/validation/spexone.json b/src/tatc/resources/validation/spexone.json index 43d1d363..899145d3 100644 --- a/src/tatc/resources/validation/spexone.json +++ b/src/tatc/resources/validation/spexone.json @@ -5,7 +5,7 @@ "digest": "c5506a9ce8f316f15800faa49ff680a5e44214d784e9b2f0451792de63f0706e", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_spexone.py", + "source": "validation/catalog/validate_catalog_spexone.py", "reference": "PACE_SPEXONE_L1C_SCI version 4 (positions of bins and times of the nadir view)", "period": "2026-11-07", "platform": "pace", diff --git a/src/tatc/resources/validation/ssmis.json b/src/tatc/resources/validation/ssmis.json index 03819720..064061be 100644 --- a/src/tatc/resources/validation/ssmis.json +++ b/src/tatc/resources/validation/ssmis.json @@ -5,7 +5,7 @@ "digest": "9e367bd86d4b2e1cc8e2e50ad0eb46f83fca7b69ae489721bb074803817dd54a", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_ssmis.py", + "source": "validation/catalog/validate_catalog_ssmis.py", "reference": "GPM_1CF18SSMIS version 08 (positions of the S1 samples)", "period": "2026-11-03", "platform": "dmsp-f18", diff --git a/src/tatc/resources/validation/tempo.json b/src/tatc/resources/validation/tempo.json index 5cd80119..d1180167 100644 --- a/src/tatc/resources/validation/tempo.json +++ b/src/tatc/resources/validation/tempo.json @@ -6,7 +6,7 @@ "digest": "c44fd0bd205eb689dfdd9449710a57782ffbb7959072be988dd750364b234842", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_tempo.py", + "source": "validation/catalog/validate_catalog_tempo.py", "reference": "TEMPO_RAD_L1 V04 (outer corners of the outermost pixels of a full scan, ultraviolet band)", "period": "2026-11-08T18:22Z", "platform": "intelsat-40e", diff --git a/src/tatc/resources/validation/tmi.json b/src/tatc/resources/validation/tmi.json index 136e97c9..37eb557b 100644 --- a/src/tatc/resources/validation/tmi.json +++ b/src/tatc/resources/validation/tmi.json @@ -5,7 +5,7 @@ "digest": "d3202819e316ccb7d2d81f515f2e37255dee46024cd2ba668b0e046bcc138a36", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_tmi.py", + "source": "validation/catalog/validate_catalog_tmi.py", "reference": "Footprints of the TC PRIMED documentation; spacing of GPM_1CTRMMTMI version 08", "period": "2013-07-10", "platform": "trmm", @@ -64,7 +64,7 @@ "digest": "06706e6a6316ae9b6c8492e66e39647c96d8019283648a55f030b901a44bce48", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_tmi.py", + "source": "validation/catalog/validate_catalog_tmi.py", "reference": "GPM_1CTRMMTMI version 08 (positions of the S1, S2, and S3 samples)", "period": "2013-07-10", "platform": "trmm", diff --git a/src/tatc/resources/validation/trmm_pr.json b/src/tatc/resources/validation/trmm_pr.json index ceaf134a..fa16c64d 100644 --- a/src/tatc/resources/validation/trmm_pr.json +++ b/src/tatc/resources/validation/trmm_pr.json @@ -5,7 +5,7 @@ "digest": "dd262ee432d302cd5b1c611723d72397ef984a2e7243c409ba50494a2f44a364", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_trmm_pr.py", + "source": "validation/catalog/validate_catalog_trmm_pr.py", "reference": "Footprints of the TC PRIMED documentation; beam positions of GPM_2APR version 07", "period": "2013-07-10", "platform": "trmm", @@ -47,7 +47,7 @@ "digest": "4b6091eef521f2b0a097a5111d95f16de01347d9b1acf2bee3b165b9dd6f0191", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_trmm_pr.py", + "source": "validation/catalog/validate_catalog_trmm_pr.py", "reference": "GPM_2APR version 07 (beam positions of the full swath)", "period": "2013-07-10", "platform": "trmm", diff --git a/src/tatc/resources/validation/tropomi.json b/src/tatc/resources/validation/tropomi.json index be3509db..4084fdaf 100644 --- a/src/tatc/resources/validation/tropomi.json +++ b/src/tatc/resources/validation/tropomi.json @@ -5,7 +5,7 @@ "digest": "6dd777f2374b8062437f0f7437e4b22db0994867904b99869abc86ed890998a5", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_tropomi.py", + "source": "validation/catalog/validate_catalog_tropomi.py", "reference": "Sentinel-5P TROPOMI aerosol index product (near real time)", "period": "2026-11-10", "platform": "sentinel-5p", diff --git a/src/tatc/resources/validation/viirs.json b/src/tatc/resources/validation/viirs.json index 930f68a0..8bac6e0d 100644 --- a/src/tatc/resources/validation/viirs.json +++ b/src/tatc/resources/validation/viirs.json @@ -5,7 +5,7 @@ "digest": "0a3441f63ce27d27721039490a7a8e3830de3f19aec836d8d1534441e21e8197", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_viirs.py", + "source": "validation/catalog/validate_catalog_viirs.py", "reference": "Footprints published by NOAA/CIMSS; samples of the VIIRS moderate-resolution geolocation", "period": "2026-08-12", "platform": "noaa-20", @@ -67,7 +67,7 @@ "digest": "be11dfbef71b6a962c089ff2a0c8e8ccd967dc9f1a21dc16e259d0701aaf8f51", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_viirs.py", + "source": "validation/catalog/validate_catalog_viirs.py", "reference": "VIIRS moderate-resolution geolocation", "period": "2026-08-12", "platform": "noaa-20", @@ -128,7 +128,7 @@ "digest": "edc0174a0abdd30c703180034a05f9323136dd5e104767ee7e596b1fc4e7feaa", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_viirs.py", + "source": "validation/catalog/validate_catalog_viirs.py", "reference": "VIIRS moderate-resolution geolocation", "period": "2026-10-02", "platform": "noaa-21", diff --git a/src/tatc/resources/validation/virs.json b/src/tatc/resources/validation/virs.json index bde921f0..82021ab7 100644 --- a/src/tatc/resources/validation/virs.json +++ b/src/tatc/resources/validation/virs.json @@ -5,7 +5,7 @@ "digest": "b8688736d1951d0235a24974b3cfaf6564f6b7f8f268d8cf26c8e1bb7eb70093", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_virs.py", + "source": "validation/catalog/validate_catalog_virs.py", "reference": "Footprint of the TRMM Version 7 README of GES DISC; sample positions of GPM_1BVIRS version 08", "period": "2013-07-10", "platform": "trmm", @@ -47,7 +47,7 @@ "digest": "61cd341ff4c2a8cc972c0690743595a8c5181eec53f0efcef70d09e1911bc8ae", "evidence": "rerun", "tatc_version": "3.6.0", - "source": "docs/validation/validate_catalog_virs.py", + "source": "validation/catalog/validate_catalog_virs.py", "reference": "GPM_1BVIRS version 08 (sample positions), with spacecraft positions of GPM_2APR version 07", "period": "2013-07-10", "platform": "trmm", diff --git a/tests/catalog/common.py b/tests/catalog/common.py index 01bbc376..4728b3aa 100644 --- a/tests/catalog/common.py +++ b/tests/catalog/common.py @@ -7,7 +7,7 @@ the installed skyfield, which changes between skyfield releases (predicted values become measured ones) and is extrapolated past its last date. So each fixture holds the delta T (TT - UT1) its records were made with, sampled around its days -(`delta_t_tt`, `delta_t`, written by `docs/validation/validation_io.py`), and its +(`delta_t_tt`, `delta_t`, written by `validation/catalog/validation_io.py`), and its tests compute with those samples. Times outside a fixture's days use the installed table. Only the checks of diff --git a/tests/catalog/fixtures/NOTICE.md b/tests/catalog/fixtures/NOTICE.md index f9efd78d..169360e3 100644 --- a/tests/catalog/fixtures/NOTICE.md +++ b/tests/catalog/fixtures/NOTICE.md @@ -6,52 +6,52 @@ underlying data, whose providers' terms apply. | Fixture | Derived from | Provider | Written by | | --- | --- | --- | --- | -| `abi.npz` | GOES-19 ABI full-disk products (ACM, SST, LST) of 3 October 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-goes/) | `docs/validation/validate_catalog_abi.py` | -| `atms_noaa_20.npz` | NOAA-20 ATMS SDR geolocation, 12 August 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `docs/validation/validate_catalog_atms.py` | -| `cris.npz` | NOAA-20 CrIS SDR geolocation, 12 August 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `docs/validation/validate_catalog_cris.py` | -| `viirs_noaa_20.npz` | NOAA-20 VIIRS moderate-resolution geolocation, 12 August 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `docs/validation/validate_catalog_viirs.py` | -| `atms_noaa_21.npz` | NOAA-21 ATMS SDR geolocation, 2 October 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `docs/validation/validate_catalog_atms.py` | -| `viirs_noaa_21.npz` | NOAA-21 VIIRS moderate-resolution geolocation, 2 October 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `docs/validation/validate_catalog_viirs.py` | -| `modis.npz` | Terra MODIS geolocation (`MOD03`, Collection 7), 5 November 2026 | [NASA LAADS DAAC](https://ladsweb.modaps.eosdis.nasa.gov/missions-and-measurements/products/MOD03) | `docs/validation/validate_catalog_modis.py` | -| `oli.npz` | Imaging times of points in Landsat 9 scenes of 3 October 2026, from the angle coefficient files of Landsat Collection 2 Level-2 products | [USGS](https://www.usgs.gov/landsat-missions), through [Microsoft Planetary Computer](https://planetarycomputer.microsoft.com/dataset/landsat-c2-l2) | `docs/validation/validate_catalog_oli.py` | -| `tropomi.npz` | Sentinel-5P TROPOMI aerosol index product (near real time), 10 November 2026. Contains modified Copernicus Sentinel data 2026. | [Sentinel-5P Level 2 on the Registry of Open Data on AWS](https://registry.opendata.aws/sentinel5p/) | `docs/validation/validate_catalog_tropomi.py` | -| `iasi.npz` | Pixel positions of the Metop-B IASI sea surface temperature product, 4 November 2026. Contains modified EUMETSAT OSI SAF IASI sea surface temperature data 2026, under the CC BY 4.0 licence. | [NASA PO.DAAC](https://podaac.jpl.nasa.gov/dataset/IASI_SST_METOP_B-OSISAF-L2P-v1.0) | `docs/validation/validate_catalog_iasi.py` | -| `msi.npz` | Imaging times of points of the viewing angle grids of Sentinel-2B Level-2A tiles, 10 November 2026. Contains modified Copernicus Sentinel data 2026. | [Microsoft Planetary Computer](https://planetarycomputer.microsoft.com/dataset/sentinel-2-l2a) | `docs/validation/validate_catalog_msi.py` | -| `csar.npz` | Zero-Doppler times of points of the geolocation grids of Sentinel-1C Level-1 GRD products, 12 August 2026 (IW mode) and 10 November 2026 (EW mode). Contains modified Copernicus Sentinel data 2026. | [Microsoft Planetary Computer](https://planetarycomputer.microsoft.com/dataset/sentinel-1-grd) | `docs/validation/validate_catalog_csar.py` | -| `amsr2.npz` | `GPM_1CGCOMW1AMSR2` version 08, 1 November 2026; footprint sizes published by JAXA | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1CGCOMW1AMSR2_08/summary) | `docs/validation/validate_catalog_amsr2.py` | -| `karin.npz` | Times of points in good-quality pixels of the SWOT Level 2 KaRIn Low Rate Sea Surface Height product (Basic, version D), 4 November 2026 | [NASA PO.DAAC](https://podaac.jpl.nasa.gov/dataset/SWOT_L2_LR_SSH_BASIC_D) | `docs/validation/validate_catalog_karin.py` | -| `lsar.npz` | Zero-Doppler times of points of the geolocation grids of NISAR Level 1 RSLC products, 4 November 2026 (77 MHz mode: 1 November 2026) | [NASA ASF DAAC](https://asf.alaska.edu/datasets/daac/nisar/) | `docs/validation/validate_catalog_lsar.py` | -| `smap_radiometer.npz` | Times of points in the forward and aft looks of SMAP Level 1B time-ordered brightness temperatures (`SPL1BTB`), 20 September 2026 | [NASA NSIDC DAAC](https://nsidc.org/data/spl1btb) | `docs/validation/validate_catalog_smap.py` | -| `dpr.npz` | Beam positions of `GPM_2ADPR` version 08 (full swath), 10 November 2026; footprint sizes published in the TC PRIMED documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_2ADPR_08/summary) | `docs/validation/validate_catalog_dpr.py` | -| `mhs.npz` | Beam positions of `GPM_1CMETOPCMHS` version 08, 5 October 2026; footprint sizes published in the TC PRIMED documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1CMETOPCMHS_08/summary) | `docs/validation/validate_catalog_mhs.py` | -| `airs.npz` | Footprint positions and times of `AIRSAQIRL1B` version 8.0, 4 November 2026; footprint sizes published by the AIRS project | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/AIRSAQIRL1B_8.0/summary) | `docs/validation/validate_catalog_airs.py` | -| `amsua.npz` | Footprint positions and times of `AIRABRAD` version 005, 5 November 2026; footprint size published in the product's documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/AIRABRAD_005/summary) | `docs/validation/validate_catalog_amsua.py` | -| `avhrr.npz` | Sample positions and times of the NOAA STAR ACSPO Metop-C AVHRR sea surface temperature product (`AVHRRF_MC-STAR-L2P`, version 2.80), 3 October 2026 | [NASA PO.DAAC](https://podaac.jpl.nasa.gov/dataset/AVHRRF_MC-STAR-L2P-v2.80) | `docs/validation/validate_catalog_avhrr.py` | -| `ssmis.npz` | Times of points in the lattice of low-frequency (S1) samples of `GPM_1CF18SSMIS` version 08, 3 November 2026 | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1CF18SSMIS_08/summary) | `docs/validation/validate_catalog_ssmis.py` | -| `olci.npz` | Times of points in the tie points of Sentinel-3A OLCI Level 1 full-resolution products (`S3A_OL_1_EFR`), 4 November 2026. Contains modified Copernicus Sentinel data 2026. | [NASA LAADS DAAC](https://ladsweb.modaps.eosdis.nasa.gov/missions-and-measurements/products/S3A_OL_1_EFR) | `docs/validation/validate_catalog_olci.py` | -| `oci.npz` | Times of points in the samples of the PACE OCI Level 1B product (`PACE_OCI_L1B_SCI`, version 3), 10 November 2026 | [NASA OB.DAAC](https://search.earthdata.nasa.gov/search?q=PACE_OCI_L1B_SCI) | `docs/validation/validate_catalog_oci.py` | -| `atlas.npz` | Positions and times of land segments south of 60 deg S of the ATLAS/ICESat-2 Land and Vegetation Height Quick Look product (`ATL08QL`, version 007), 4 November 2026 | [NASA NSIDC DAAC](https://nsidc.org/data/atl08ql) | `docs/validation/validate_catalog_atlas.py` | -| `omps_nm_noaa_21.npz` | NOAA-21 OMPS Nadir Mapper total column geolocation (`OMPS-TC-GEO`), 5 November 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `docs/validation/validate_catalog_omps.py` | -| `omps_nm_noaa_20.npz` | NOAA-20 OMPS Nadir Mapper total column geolocation (`OMPS-TC-GEO`), 5 November 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `docs/validation/validate_catalog_omps.py` | -| `ahi.npz` | Pixel positions of Himawari-9 AHI full-disk cloud mask and cloud top height products of NOAA's Enterprise algorithms, scan of 8 November 2026 12:00 UTC. Derived from Himawari-9 data of the Japan Meteorological Agency (JMA), accessed on 9 November 2026 from https://registry.opendata.aws/noaa-himawari; modified, not original data, and not endorsed by NOAA or JMA. | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-himawari/) | `docs/validation/validate_catalog_ahi.py` | -| `ceres.npz` | Footprint positions and times of the NOAA-20 CERES FM6 ES-8 product (`CER_ES8_NOAA20-FM6`, Edition1), 30 September 2026 | [NASA Langley ASDC](https://asdc.larc.nasa.gov/project/CERES) | `docs/validation/validate_catalog_ceres.py` | -| `harp2.npz` | Positions and times of the near-nadir view of the PACE HARP2 Level 1B product (`PACE_HARP2_L1B_SCI`, version 4), 7 November 2026 | [NASA OB.DAAC](https://search.earthdata.nasa.gov/search?q=PACE_HARP2_L1B_SCI) | `docs/validation/validate_catalog_harp2.py` | -| `spexone.npz` | Positions and nadir-view times of the bins of the PACE SPEXone Level 1C product (`PACE_SPEXONE_L1C_SCI`, version 4), 7 November 2026 | [NASA OB.DAAC](https://search.earthdata.nasa.gov/search?q=PACE_SPEXONE_L1C_SCI) | `docs/validation/validate_catalog_spexone.py` | -| `oco2_nadir.npz`, `oco2_glint.npz` | Sounding positions and times of the OCO-2 Level 1B science product (`OCO2_L1B_Science`, version 11.2), nadir and glint orbits, 7 November 2026 | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/OCO2_L1B_Science_11.2/summary) | `docs/validation/validate_catalog_oco2.py` | -| `ecostress.npz` | Sample positions and times of the ECOSTRESS Level 1B geolocation product (`ECO_L1B_GEO`, version 002), 8 November 2026 | [NASA LP DAAC](https://lpdaac.usgs.gov/products/eco_l1b_geov002/) | `docs/validation/validate_catalog_ecostress.py` | -| `poseidon4.npz` | Measurement positions and times of the Sentinel-6 Michael Freilich Level 2 low-resolution near-real-time reduced product (`JASON_CS_S6A_L2_ALT_LR_RED_OST_NRT_F`), 7 November 2026. Contains modified Copernicus Sentinel data 2026. | [NASA PO.DAAC](https://podaac.jpl.nasa.gov/dataset/JASON_CS_S6A_L2_ALT_LR_RED_OST_NRT_F) | `docs/validation/validate_catalog_poseidon4.py` | -| `gmi.npz` | `GPM_1CGPMGMI` version 08, 20 July 2026; footprint sizes published in the GMI L1B ATBD and TC PRIMED documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1CGPMGMI_08/summary) | `docs/validation/validate_catalog_gmi.py` | -| `ascat.npz` | Times of lattice points within wind vector cells of the MetOp-C ASCAT Level 2 25 km ocean surface wind vector product (`ASCATC-L2-25km`), 8 November 2026. Contains modified EUMETSAT OSI SAF MetOp-C ASCAT Level 2 25.0 km Ocean Surface Wind Vectors 2026; copyright 2026 EUMETSAT, used under CC BY 4.0. | [NASA PO.DAAC](https://podaac.jpl.nasa.gov/dataset/ASCATC-L2-25km), [EUMETSAT OSI SAF](https://osi-saf.eumetsat.int/licensing-and-attribution) | `docs/validation/validate_catalog_ascat.py` | -| `tempo.npz` | Grid points near and away from the edges of the area imaged by a full scan of the TEMPO Level 1 radiance product (`TEMPO_RAD_L1`, version V04), 8 November 2026, with whether each was imaged | [NASA Langley ASDC](https://asdc.larc.nasa.gov/project/TEMPO) | `docs/validation/validate_catalog_tempo.py` | -| `emit.npz` | Pixel positions and line times of the EMIT Level 1B observation geometry (`EMITL1BRAD`, version 002), 8 November 2026 | [NASA LP DAAC](https://lpdaac.usgs.gov/products/emitl1bradv002/) | `docs/validation/validate_catalog_emit.py` | -| `trmm_pr.npz` | Beam positions and scan times of `GPM_2APR` version 07 (full swath), 10 July 2013; footprint sizes published in the TC PRIMED documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_2APR_07/summary) | `docs/validation/validate_catalog_trmm_pr.py` | -| `virs.npz` | Pixel positions and scan times of `GPM_1BVIRS` version 08, 10 July 2013; footprint size published in the GES DISC TRMM Version 7 documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1BVIRS_08/summary) | `docs/validation/validate_catalog_virs.py` | -| `tmi.npz` | Sample positions and scan times of `GPM_1CTRMMTMI` version 08, 10 July 2013; footprint sizes published in the TC PRIMED documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1CTRMMTMI_08/summary) | `docs/validation/validate_catalog_tmi.py` | -| `atlid.npz` | Profile positions and times of the EarthCARE ATLID Level 1B nominal product (`ATL_NOM_1B`), 7 November 2026. Original data provided by ESA (European Space Agency). | [ESA MAAP](https://earth.esa.int/eogateway/catalog/earthcare-l1-products) | `docs/validation/validate_catalog_atlid.py` | -| `earthcare_msi.npz` | Times of points in the lattice of imaged pixels of the EarthCARE MSI Level 1C regridded product (`MSI_RGR_1C`), 7 November 2026. Original data provided by ESA (European Space Agency). | [ESA MAAP](https://earth.esa.int/eogateway/catalog/earthcare-l1-products) | `docs/validation/validate_catalog_earthcare_msi.py` | -| `cpr.npz` | Profile positions and times of the EarthCARE CPR Level 1B nominal product (`CPR_NOM_1B`), 7 November 2026. Original data provided by JAXA/NICT (Japan Aerospace Exploration Agency, and National Institute of Information and Communications Technology). | [ESA MAAP](https://earth.esa.int/eogateway/catalog/earthcare-l1-products) | `docs/validation/validate_catalog_cpr.py` | -| `bbr.npz` | Times of points in the lattice of pixels of the nadir view of the EarthCARE BBR Level 1B single-pixel product (`BBR_SNG_1B`), 7 November 2026. Original data provided by ESA (European Space Agency). | [ESA MAAP](https://earth.esa.int/eogateway/catalog/earthcare-l1-products) | `docs/validation/validate_catalog_bbr.py` | -| `gedi.npz` | Shot positions and times of the GEDI Level 1B geolocated waveform product (`GEDI01_B`, version 003), 8 June 2026 | [NASA LP DAAC](https://lpdaac.usgs.gov/products/gedi01_bv003/) | `docs/validation/validate_catalog_gedi.py` | +| `abi.npz` | GOES-19 ABI full-disk products (ACM, SST, LST) of 3 October 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-goes/) | `validation/catalog/validate_catalog_abi.py` | +| `atms_noaa_20.npz` | NOAA-20 ATMS SDR geolocation, 12 August 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `validation/catalog/validate_catalog_atms.py` | +| `cris.npz` | NOAA-20 CrIS SDR geolocation, 12 August 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `validation/catalog/validate_catalog_cris.py` | +| `viirs_noaa_20.npz` | NOAA-20 VIIRS moderate-resolution geolocation, 12 August 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `validation/catalog/validate_catalog_viirs.py` | +| `atms_noaa_21.npz` | NOAA-21 ATMS SDR geolocation, 2 October 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `validation/catalog/validate_catalog_atms.py` | +| `viirs_noaa_21.npz` | NOAA-21 VIIRS moderate-resolution geolocation, 2 October 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `validation/catalog/validate_catalog_viirs.py` | +| `modis.npz` | Terra MODIS geolocation (`MOD03`, Collection 7), 5 November 2026 | [NASA LAADS DAAC](https://ladsweb.modaps.eosdis.nasa.gov/missions-and-measurements/products/MOD03) | `validation/catalog/validate_catalog_modis.py` | +| `oli.npz` | Imaging times of points in Landsat 9 scenes of 3 October 2026, from the angle coefficient files of Landsat Collection 2 Level-2 products | [USGS](https://www.usgs.gov/landsat-missions), through [Microsoft Planetary Computer](https://planetarycomputer.microsoft.com/dataset/landsat-c2-l2) | `validation/catalog/validate_catalog_oli.py` | +| `tropomi.npz` | Sentinel-5P TROPOMI aerosol index product (near real time), 10 November 2026. Contains modified Copernicus Sentinel data 2026. | [Sentinel-5P Level 2 on the Registry of Open Data on AWS](https://registry.opendata.aws/sentinel5p/) | `validation/catalog/validate_catalog_tropomi.py` | +| `iasi.npz` | Pixel positions of the Metop-B IASI sea surface temperature product, 4 November 2026. Contains modified EUMETSAT OSI SAF IASI sea surface temperature data 2026, under the CC BY 4.0 licence. | [NASA PO.DAAC](https://podaac.jpl.nasa.gov/dataset/IASI_SST_METOP_B-OSISAF-L2P-v1.0) | `validation/catalog/validate_catalog_iasi.py` | +| `msi.npz` | Imaging times of points of the viewing angle grids of Sentinel-2B Level-2A tiles, 10 November 2026. Contains modified Copernicus Sentinel data 2026. | [Microsoft Planetary Computer](https://planetarycomputer.microsoft.com/dataset/sentinel-2-l2a) | `validation/catalog/validate_catalog_msi.py` | +| `csar.npz` | Zero-Doppler times of points of the geolocation grids of Sentinel-1C Level-1 GRD products, 12 August 2026 (IW mode) and 10 November 2026 (EW mode). Contains modified Copernicus Sentinel data 2026. | [Microsoft Planetary Computer](https://planetarycomputer.microsoft.com/dataset/sentinel-1-grd) | `validation/catalog/validate_catalog_csar.py` | +| `amsr2.npz` | `GPM_1CGCOMW1AMSR2` version 08, 1 November 2026; footprint sizes published by JAXA | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1CGCOMW1AMSR2_08/summary) | `validation/catalog/validate_catalog_amsr2.py` | +| `karin.npz` | Times of points in good-quality pixels of the SWOT Level 2 KaRIn Low Rate Sea Surface Height product (Basic, version D), 4 November 2026 | [NASA PO.DAAC](https://podaac.jpl.nasa.gov/dataset/SWOT_L2_LR_SSH_BASIC_D) | `validation/catalog/validate_catalog_karin.py` | +| `lsar.npz` | Zero-Doppler times of points of the geolocation grids of NISAR Level 1 RSLC products, 4 November 2026 (77 MHz mode: 1 November 2026) | [NASA ASF DAAC](https://asf.alaska.edu/datasets/daac/nisar/) | `validation/catalog/validate_catalog_lsar.py` | +| `smap_radiometer.npz` | Times of points in the forward and aft looks of SMAP Level 1B time-ordered brightness temperatures (`SPL1BTB`), 20 September 2026 | [NASA NSIDC DAAC](https://nsidc.org/data/spl1btb) | `validation/catalog/validate_catalog_smap.py` | +| `dpr.npz` | Beam positions of `GPM_2ADPR` version 08 (full swath), 10 November 2026; footprint sizes published in the TC PRIMED documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_2ADPR_08/summary) | `validation/catalog/validate_catalog_dpr.py` | +| `mhs.npz` | Beam positions of `GPM_1CMETOPCMHS` version 08, 5 October 2026; footprint sizes published in the TC PRIMED documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1CMETOPCMHS_08/summary) | `validation/catalog/validate_catalog_mhs.py` | +| `airs.npz` | Footprint positions and times of `AIRSAQIRL1B` version 8.0, 4 November 2026; footprint sizes published by the AIRS project | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/AIRSAQIRL1B_8.0/summary) | `validation/catalog/validate_catalog_airs.py` | +| `amsua.npz` | Footprint positions and times of `AIRABRAD` version 005, 5 November 2026; footprint size published in the product's documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/AIRABRAD_005/summary) | `validation/catalog/validate_catalog_amsua.py` | +| `avhrr.npz` | Sample positions and times of the NOAA STAR ACSPO Metop-C AVHRR sea surface temperature product (`AVHRRF_MC-STAR-L2P`, version 2.80), 3 October 2026 | [NASA PO.DAAC](https://podaac.jpl.nasa.gov/dataset/AVHRRF_MC-STAR-L2P-v2.80) | `validation/catalog/validate_catalog_avhrr.py` | +| `ssmis.npz` | Times of points in the lattice of low-frequency (S1) samples of `GPM_1CF18SSMIS` version 08, 3 November 2026 | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1CF18SSMIS_08/summary) | `validation/catalog/validate_catalog_ssmis.py` | +| `olci.npz` | Times of points in the tie points of Sentinel-3A OLCI Level 1 full-resolution products (`S3A_OL_1_EFR`), 4 November 2026. Contains modified Copernicus Sentinel data 2026. | [NASA LAADS DAAC](https://ladsweb.modaps.eosdis.nasa.gov/missions-and-measurements/products/S3A_OL_1_EFR) | `validation/catalog/validate_catalog_olci.py` | +| `oci.npz` | Times of points in the samples of the PACE OCI Level 1B product (`PACE_OCI_L1B_SCI`, version 3), 10 November 2026 | [NASA OB.DAAC](https://search.earthdata.nasa.gov/search?q=PACE_OCI_L1B_SCI) | `validation/catalog/validate_catalog_oci.py` | +| `atlas.npz` | Positions and times of land segments south of 60 deg S of the ATLAS/ICESat-2 Land and Vegetation Height Quick Look product (`ATL08QL`, version 007), 4 November 2026 | [NASA NSIDC DAAC](https://nsidc.org/data/atl08ql) | `validation/catalog/validate_catalog_atlas.py` | +| `omps_nm_noaa_21.npz` | NOAA-21 OMPS Nadir Mapper total column geolocation (`OMPS-TC-GEO`), 5 November 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `validation/catalog/validate_catalog_omps.py` | +| `omps_nm_noaa_20.npz` | NOAA-20 OMPS Nadir Mapper total column geolocation (`OMPS-TC-GEO`), 5 November 2026 | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-jpss/) | `validation/catalog/validate_catalog_omps.py` | +| `ahi.npz` | Pixel positions of Himawari-9 AHI full-disk cloud mask and cloud top height products of NOAA's Enterprise algorithms, scan of 8 November 2026 12:00 UTC. Derived from Himawari-9 data of the Japan Meteorological Agency (JMA), accessed on 9 November 2026 from https://registry.opendata.aws/noaa-himawari; modified, not original data, and not endorsed by NOAA or JMA. | [NOAA Open Data Dissemination](https://registry.opendata.aws/noaa-himawari/) | `validation/catalog/validate_catalog_ahi.py` | +| `ceres.npz` | Footprint positions and times of the NOAA-20 CERES FM6 ES-8 product (`CER_ES8_NOAA20-FM6`, Edition1), 30 September 2026 | [NASA Langley ASDC](https://asdc.larc.nasa.gov/project/CERES) | `validation/catalog/validate_catalog_ceres.py` | +| `harp2.npz` | Positions and times of the near-nadir view of the PACE HARP2 Level 1B product (`PACE_HARP2_L1B_SCI`, version 4), 7 November 2026 | [NASA OB.DAAC](https://search.earthdata.nasa.gov/search?q=PACE_HARP2_L1B_SCI) | `validation/catalog/validate_catalog_harp2.py` | +| `spexone.npz` | Positions and nadir-view times of the bins of the PACE SPEXone Level 1C product (`PACE_SPEXONE_L1C_SCI`, version 4), 7 November 2026 | [NASA OB.DAAC](https://search.earthdata.nasa.gov/search?q=PACE_SPEXONE_L1C_SCI) | `validation/catalog/validate_catalog_spexone.py` | +| `oco2_nadir.npz`, `oco2_glint.npz` | Sounding positions and times of the OCO-2 Level 1B science product (`OCO2_L1B_Science`, version 11.2), nadir and glint orbits, 7 November 2026 | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/OCO2_L1B_Science_11.2/summary) | `validation/catalog/validate_catalog_oco2.py` | +| `ecostress.npz` | Sample positions and times of the ECOSTRESS Level 1B geolocation product (`ECO_L1B_GEO`, version 002), 8 November 2026 | [NASA LP DAAC](https://lpdaac.usgs.gov/products/eco_l1b_geov002/) | `validation/catalog/validate_catalog_ecostress.py` | +| `poseidon4.npz` | Measurement positions and times of the Sentinel-6 Michael Freilich Level 2 low-resolution near-real-time reduced product (`JASON_CS_S6A_L2_ALT_LR_RED_OST_NRT_F`), 7 November 2026. Contains modified Copernicus Sentinel data 2026. | [NASA PO.DAAC](https://podaac.jpl.nasa.gov/dataset/JASON_CS_S6A_L2_ALT_LR_RED_OST_NRT_F) | `validation/catalog/validate_catalog_poseidon4.py` | +| `gmi.npz` | `GPM_1CGPMGMI` version 08, 20 July 2026; footprint sizes published in the GMI L1B ATBD and TC PRIMED documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1CGPMGMI_08/summary) | `validation/catalog/validate_catalog_gmi.py` | +| `ascat.npz` | Times of lattice points within wind vector cells of the MetOp-C ASCAT Level 2 25 km ocean surface wind vector product (`ASCATC-L2-25km`), 8 November 2026. Contains modified EUMETSAT OSI SAF MetOp-C ASCAT Level 2 25.0 km Ocean Surface Wind Vectors 2026; copyright 2026 EUMETSAT, used under CC BY 4.0. | [NASA PO.DAAC](https://podaac.jpl.nasa.gov/dataset/ASCATC-L2-25km), [EUMETSAT OSI SAF](https://osi-saf.eumetsat.int/licensing-and-attribution) | `validation/catalog/validate_catalog_ascat.py` | +| `tempo.npz` | Grid points near and away from the edges of the area imaged by a full scan of the TEMPO Level 1 radiance product (`TEMPO_RAD_L1`, version V04), 8 November 2026, with whether each was imaged | [NASA Langley ASDC](https://asdc.larc.nasa.gov/project/TEMPO) | `validation/catalog/validate_catalog_tempo.py` | +| `emit.npz` | Pixel positions and line times of the EMIT Level 1B observation geometry (`EMITL1BRAD`, version 002), 8 November 2026 | [NASA LP DAAC](https://lpdaac.usgs.gov/products/emitl1bradv002/) | `validation/catalog/validate_catalog_emit.py` | +| `trmm_pr.npz` | Beam positions and scan times of `GPM_2APR` version 07 (full swath), 10 July 2013; footprint sizes published in the TC PRIMED documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_2APR_07/summary) | `validation/catalog/validate_catalog_trmm_pr.py` | +| `virs.npz` | Pixel positions and scan times of `GPM_1BVIRS` version 08, 10 July 2013; footprint size published in the GES DISC TRMM Version 7 documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1BVIRS_08/summary) | `validation/catalog/validate_catalog_virs.py` | +| `tmi.npz` | Sample positions and scan times of `GPM_1CTRMMTMI` version 08, 10 July 2013; footprint sizes published in the TC PRIMED documentation | [NASA GES DISC](https://disc.gsfc.nasa.gov/datasets/GPM_1CTRMMTMI_08/summary) | `validation/catalog/validate_catalog_tmi.py` | +| `atlid.npz` | Profile positions and times of the EarthCARE ATLID Level 1B nominal product (`ATL_NOM_1B`), 7 November 2026. Original data provided by ESA (European Space Agency). | [ESA MAAP](https://earth.esa.int/eogateway/catalog/earthcare-l1-products) | `validation/catalog/validate_catalog_atlid.py` | +| `earthcare_msi.npz` | Times of points in the lattice of imaged pixels of the EarthCARE MSI Level 1C regridded product (`MSI_RGR_1C`), 7 November 2026. Original data provided by ESA (European Space Agency). | [ESA MAAP](https://earth.esa.int/eogateway/catalog/earthcare-l1-products) | `validation/catalog/validate_catalog_earthcare_msi.py` | +| `cpr.npz` | Profile positions and times of the EarthCARE CPR Level 1B nominal product (`CPR_NOM_1B`), 7 November 2026. Original data provided by JAXA/NICT (Japan Aerospace Exploration Agency, and National Institute of Information and Communications Technology). | [ESA MAAP](https://earth.esa.int/eogateway/catalog/earthcare-l1-products) | `validation/catalog/validate_catalog_cpr.py` | +| `bbr.npz` | Times of points in the lattice of pixels of the nadir view of the EarthCARE BBR Level 1B single-pixel product (`BBR_SNG_1B`), 7 November 2026. Original data provided by ESA (European Space Agency). | [ESA MAAP](https://earth.esa.int/eogateway/catalog/earthcare-l1-products) | `validation/catalog/validate_catalog_bbr.py` | +| `gedi.npz` | Shot positions and times of the GEDI Level 1B geolocated waveform product (`GEDI01_B`, version 003), 8 June 2026 | [NASA LP DAAC](https://lpdaac.usgs.gov/products/gedi01_bv003/) | `validation/catalog/validate_catalog_gedi.py` | Each fixture also holds two-line element sets, used to propagate the satellite's orbit, and the delta T (TT - UT1) its records were made with, sampled around its days diff --git a/tests/catalog/test_abi_fixture.py b/tests/catalog/test_abi_fixture.py index cd17afa8..91650d9d 100644 --- a/tests/catalog/test_abi_fixture.py +++ b/tests/catalog/test_abi_fixture.py @@ -1,8 +1,8 @@ """ Regression tests that recompute the results of the geostationary entries from reduced fixtures of pixels: GOES-19 ABI pixels, written by -`docs/validation/validate_catalog_abi.py`, and Himawari-9 AHI pixels, written by -`docs/validation/validate_catalog_ahi.py`. +`validation/catalog/validate_catalog_abi.py`, and Himawari-9 AHI pixels, written by +`validation/catalog/validate_catalog_ahi.py`. These detect changes in TAT-C's results without network access. They do not themselves establish agreement with the reference data, which the scripts do. diff --git a/tests/catalog/test_amsr2_fixture.py b/tests/catalog/test_amsr2_fixture.py index c6883abe..cde8ab9e 100644 --- a/tests/catalog/test_amsr2_fixture.py +++ b/tests/catalog/test_amsr2_fixture.py @@ -1,6 +1,6 @@ """ Regression tests that recompute the AMSR2 entry's results from a reduced fixture of -observed passes, written by `docs/validation/validate_catalog_amsr2.py`. +observed passes, written by `validation/catalog/validate_catalog_amsr2.py`. These detect changes in TAT-C's results without network access. They do not themselves establish agreement with the reference data, which the script does. diff --git a/tests/catalog/test_atlas_fixture.py b/tests/catalog/test_atlas_fixture.py index 68a6fd95..64954d23 100644 --- a/tests/catalog/test_atlas_fixture.py +++ b/tests/catalog/test_atlas_fixture.py @@ -1,7 +1,7 @@ """ Regression tests that recompute the results of the lidar entries (ICESat-2 ATLAS and -GEDI) from reduced fixtures, written by `docs/validation/validate_catalog_atlas.py` -and `docs/validation/validate_catalog_gedi.py`. +GEDI) from reduced fixtures, written by `validation/catalog/validate_catalog_atlas.py` +and `validation/catalog/validate_catalog_gedi.py`. These detect changes in TAT-C's results without network access. They do not themselves establish agreement with the reference data, which the script does. diff --git a/tests/catalog/test_gmi_fixture.py b/tests/catalog/test_gmi_fixture.py index b5982c8c..0df591ee 100644 --- a/tests/catalog/test_gmi_fixture.py +++ b/tests/catalog/test_gmi_fixture.py @@ -1,6 +1,6 @@ """ Regression tests that recompute the GMI entry's results from a reduced fixture of -observed passes, written by `docs/validation/validate_catalog_gmi.py`. +observed passes, written by `validation/catalog/validate_catalog_gmi.py`. These detect changes in TAT-C's results without network access. They do not themselves establish agreement with the reference data, which the script does. diff --git a/tests/catalog/test_pushbroom_fixtures.py b/tests/catalog/test_pushbroom_fixtures.py index c47e560d..daf769e5 100644 --- a/tests/catalog/test_pushbroom_fixtures.py +++ b/tests/catalog/test_pushbroom_fixtures.py @@ -3,7 +3,7 @@ synthetic aperture radars, ASCAT, the SMAP radiometer, SSMIS, and OCI's swath from reduced fixtures, written by the scripts -`docs/validation/validate_catalog_.py`. +`validation/catalog/validate_catalog_.py`. These detect changes in TAT-C's results without network access. They do not themselves establish agreement with the reference data, which the scripts do. diff --git a/tests/catalog/test_scanner_fixtures.py b/tests/catalog/test_scanner_fixtures.py index cff5ccda..8183a2a6 100644 --- a/tests/catalog/test_scanner_fixtures.py +++ b/tests/catalog/test_scanner_fixtures.py @@ -1,17 +1,17 @@ """ Regression tests that recompute the results of the entries of cross-track scanners -from reduced fixtures, written by `docs/validation/validate_catalog_atms.py`, -`docs/validation/validate_catalog_viirs.py`, -`docs/validation/validate_catalog_modis.py`, -`docs/validation/validate_catalog_iasi.py`, -`docs/validation/validate_catalog_cris.py`, -`docs/validation/validate_catalog_dpr.py`, -`docs/validation/validate_catalog_mhs.py`, -`docs/validation/validate_catalog_airs.py`, -`docs/validation/validate_catalog_amsua.py`, -`docs/validation/validate_catalog_avhrr.py`, -`docs/validation/validate_catalog_trmm_pr.py`, and -`docs/validation/validate_catalog_virs.py`, and of other swaths and narrow views +from reduced fixtures, written by `validation/catalog/validate_catalog_atms.py`, +`validation/catalog/validate_catalog_viirs.py`, +`validation/catalog/validate_catalog_modis.py`, +`validation/catalog/validate_catalog_iasi.py`, +`validation/catalog/validate_catalog_cris.py`, +`validation/catalog/validate_catalog_dpr.py`, +`validation/catalog/validate_catalog_mhs.py`, +`validation/catalog/validate_catalog_airs.py`, +`validation/catalog/validate_catalog_amsua.py`, +`validation/catalog/validate_catalog_avhrr.py`, +`validation/catalog/validate_catalog_trmm_pr.py`, and +`validation/catalog/validate_catalog_virs.py`, and of other swaths and narrow views written by their validation scripts. These detect changes in TAT-C's results without network access. They do not themselves diff --git a/tests/catalog/test_smap_fixture.py b/tests/catalog/test_smap_fixture.py index 29b5a45c..a9d79e6b 100644 --- a/tests/catalog/test_smap_fixture.py +++ b/tests/catalog/test_smap_fixture.py @@ -1,7 +1,7 @@ """ Regression tests that recompute the results of the SMAP radiometer entry's sample size configuration from a reduced fixture, written by -`docs/validation/validate_catalog_smap.py`. +`validation/catalog/validate_catalog_smap.py`. These detect changes in TAT-C's results without network access. They do not themselves establish agreement with the reference data, which the script does. diff --git a/tests/catalog/test_tempo_fixture.py b/tests/catalog/test_tempo_fixture.py index 9060d5ef..bb321063 100644 --- a/tests/catalog/test_tempo_fixture.py +++ b/tests/catalog/test_tempo_fixture.py @@ -1,6 +1,6 @@ """ Regression tests that recompute the result of the TEMPO entry from a reduced fixture -written by `docs/validation/validate_catalog_tempo.py`: grid points near and away +written by `validation/catalog/validate_catalog_tempo.py`: grid points near and away from the edges of the area a held-out scan imaged, with whether each was imaged. These detect changes in TAT-C's results without network access. They do not themselves diff --git a/tests/catalog/test_tmi_fixture.py b/tests/catalog/test_tmi_fixture.py index 8d213ce5..ee2e667a 100644 --- a/tests/catalog/test_tmi_fixture.py +++ b/tests/catalog/test_tmi_fixture.py @@ -1,6 +1,6 @@ """ Regression tests that recompute the TRMM TMI entry's results from a reduced fixture, -written by `docs/validation/validate_catalog_tmi.py`. +written by `validation/catalog/validate_catalog_tmi.py`. These detect changes in TAT-C's results without network access. They do not themselves establish agreement with the reference data, which the script does. diff --git a/validation/README.md b/validation/README.md new file mode 100644 index 00000000..904d7ee9 --- /dev/null +++ b/validation/README.md @@ -0,0 +1,39 @@ +# Catalog Validation + +Scripts that validate the entries of the instrument catalog (`src/tatc/resources/instruments/*.yml`) against reference data from operational missions, following the [validation standard](../docs/validation/standard.rst). Their results are published on the catalog page of the documentation, which `docs/validation/catalog_page.py` generates from the entries and their records. + +The validation notebooks, which test orbits, analyses, and the modeling choices behind several entries, are in [`docs/validation`](../docs/validation). + +## Layout + +- `catalog/validate_catalog_.py`: one script per entry (some cover several entries' platforms or modes). +- `catalog/validation_io.py`: shared archive access, element sets, geometry, scoring, and the record and fixture writers. +- `catalog/gesdisc_scanner.py`: reading and fitting scanner swaths through `earthaccess` (NASA DAACs). +- `catalog/earthcare_io.py`: reading EarthCARE products from ESA MAAP. +- `catalog/compare_swath_time_steps.py`: compares swaths at different time steps on the unit-test fixtures (no reference data). +- `catalog/elements/`: element sets the scripts read when the archives do not supply them. + +The scripts import each other by module name, so run them as scripts (not as a package), and keep them in one folder. + +## Running + +Install the `validation` extra (`pip install -e ".[validation]"`), then run a script with a data directory and, for most, a day: + + python validation/catalog/validate_catalog_atms.py validation/data 2026-10-02 + +The usage of each script, including the days on which its entry was fitted and tested, is in its docstring. Downloaded data are cached in the data directory; `validation/data` is ignored by git. + +Common options: + +- `--fit`: measures the fitted values of an entry's configurations on the day of the fit, printing them without writing. +- `--write`: writes the entry's validation record (`src/tatc/resources/validation/.json`) and the reduced fixture from which unit tests recompute its results (`tests/catalog/fixtures/.npz`). + +Without `--write`, a script prints its results. The exception is `validate_catalog_abi.py`, which takes only a data directory and always writes. + +## Accounts + +- NOAA Open Data Dissemination (JPSS, GOES, Himawari) and Microsoft Planetary Computer: anonymous. +- NASA DAACs: an Earthdata token in `EARTHDATA_TOKEN` ([NASA Earthdata Login](https://urs.earthdata.nasa.gov/)). +- EarthCARE (ATLID, BBR, CPR, MSI): an ESA MAAP offline token in `ESA_MAAP_KEY`. + +Each script's docstring states what it needs. diff --git a/docs/validation/compare_swath_time_steps.py b/validation/catalog/compare_swath_time_steps.py similarity index 98% rename from docs/validation/compare_swath_time_steps.py rename to validation/catalog/compare_swath_time_steps.py index 6fde0a08..ec8b0d1f 100644 --- a/docs/validation/compare_swath_time_steps.py +++ b/validation/catalog/compare_swath_time_steps.py @@ -15,7 +15,7 @@ The orbit of each configuration is the element set of its fixture. - python docs/validation/compare_swath_time_steps.py [entry ...] + python validation/catalog/compare_swath_time_steps.py [entry ...] @author: Paul T. Grogan """ diff --git a/docs/validation/earthcare_io.py b/validation/catalog/earthcare_io.py similarity index 100% rename from docs/validation/earthcare_io.py rename to validation/catalog/earthcare_io.py diff --git a/docs/validation/earthcare_2026-09-27.3le b/validation/catalog/elements/earthcare_2026-09-27.3le similarity index 100% rename from docs/validation/earthcare_2026-09-27.3le rename to validation/catalog/elements/earthcare_2026-09-27.3le diff --git a/docs/validation/gpm_2026-07-15.3le b/validation/catalog/elements/gpm_2026-07-15.3le similarity index 100% rename from docs/validation/gpm_2026-07-15.3le rename to validation/catalog/elements/gpm_2026-07-15.3le diff --git a/docs/validation/icesat2_2026-11-04.3le b/validation/catalog/elements/icesat2_2026-11-04.3le similarity index 100% rename from docs/validation/icesat2_2026-11-04.3le rename to validation/catalog/elements/icesat2_2026-11-04.3le diff --git a/docs/validation/iss_2026-04-01.3le b/validation/catalog/elements/iss_2026-04-01.3le similarity index 100% rename from docs/validation/iss_2026-04-01.3le rename to validation/catalog/elements/iss_2026-04-01.3le diff --git a/docs/validation/metop_2026-10-05.3le b/validation/catalog/elements/metop_2026-10-05.3le similarity index 100% rename from docs/validation/metop_2026-10-05.3le rename to validation/catalog/elements/metop_2026-10-05.3le diff --git a/docs/validation/nisar_2026-11-01.3le b/validation/catalog/elements/nisar_2026-11-01.3le similarity index 100% rename from docs/validation/nisar_2026-11-01.3le rename to validation/catalog/elements/nisar_2026-11-01.3le diff --git a/docs/validation/sentinel_2026-08-12.3le b/validation/catalog/elements/sentinel_2026-08-12.3le similarity index 100% rename from docs/validation/sentinel_2026-08-12.3le rename to validation/catalog/elements/sentinel_2026-08-12.3le diff --git a/docs/validation/smap_2026-09-20.3le b/validation/catalog/elements/smap_2026-09-20.3le similarity index 100% rename from docs/validation/smap_2026-09-20.3le rename to validation/catalog/elements/smap_2026-09-20.3le diff --git a/docs/validation/trmm_2013-05-20.3le b/validation/catalog/elements/trmm_2013-05-20.3le similarity index 100% rename from docs/validation/trmm_2013-05-20.3le rename to validation/catalog/elements/trmm_2013-05-20.3le diff --git a/docs/validation/gesdisc_scanner.py b/validation/catalog/gesdisc_scanner.py similarity index 100% rename from docs/validation/gesdisc_scanner.py rename to validation/catalog/gesdisc_scanner.py diff --git a/docs/validation/validate_catalog_abi.py b/validation/catalog/validate_catalog_abi.py similarity index 93% rename from docs/validation/validate_catalog_abi.py rename to validation/catalog/validate_catalog_abi.py index 70831bb3..c25025a5 100644 --- a/docs/validation/validate_catalog_abi.py +++ b/validation/catalog/validate_catalog_abi.py @@ -1,12 +1,14 @@ """ -Validates the ABI catalog entry against GOES-19 products, using the exact values -of the entry through public TAT-C methods, as `ValidateGeostationaryGOES` does -with values of its own. Writes the entry's validation record and the reduced -fixture from which unit tests recompute the results. +Validates the ABI catalog entry against GOES-19 full-disk products, using the exact +values of the entry through public TAT-C methods: whether the full disk's imaged pixels +are observed, with the satellite's elevation angle, and the local zenith angles to +which the sea and land surface temperature products are of good quality. Writes the +entry's validation record and the reduced fixture from which unit tests recompute the +results. Reads anonymous public data, and needs the `validation` extra: - python docs/validation/validate_catalog_abi.py + python validation/catalog/validate_catalog_abi.py @author: Paul T. Grogan """ @@ -30,11 +32,15 @@ from tatc.constants import timescale from tatc.schemas import GeneralPerturbationsOrbit, Point from tatc.utils import compute_field_of_regard -from validation_io import add_earth_orientation +from validation_io import ( + add_earth_orientation, + RECORDS, + FIXTURES, + source_of, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "abi.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "abi.npz" +RECORD_PATH = RECORDS / "abi.json" +FIXTURE_PATH = FIXTURES / "abi.npz" BUCKET = "https://noaa-goes19.s3.amazonaws.com/" TIME = datetime(2026, 10, 3, 12, tzinfo=timezone.utc) @@ -154,7 +160,7 @@ def main(directory: pathlib.Path) -> None: common = { "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_abi.py", + "source": source_of(__file__), "period": f"{TIME:%Y-%m-%dT%H:%MZ}", "platform": "goes-19", } diff --git a/docs/validation/validate_catalog_ahi.py b/validation/catalog/validate_catalog_ahi.py similarity index 95% rename from docs/validation/validate_catalog_ahi.py rename to validation/catalog/validate_catalog_ahi.py index b4e9bcd2..ae50c158 100644 --- a/docs/validation/validate_catalog_ahi.py +++ b/validation/catalog/validate_catalog_ahi.py @@ -8,8 +8,8 @@ Reads anonymous public data (about 1.1 GB a scan), and needs the `validation` extra: - python docs/validation/validate_catalog_ahi.py --fit - python docs/validation/validate_catalog_ahi.py --write + python validation/catalog/validate_catalog_ahi.py --fit + python validation/catalog/validate_catalog_ahi.py --write @author: Paul T. Grogan """ @@ -33,11 +33,16 @@ from tatc.constants import timescale from tatc.schemas import GeneralPerturbationsOrbit, Point from tatc.utils import compute_field_of_regard -from validation_io import add_earth_orientation, get_holdout_gap +from validation_io import ( + add_earth_orientation, + get_holdout_gap, + RECORDS, + FIXTURES, + source_of, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "ahi.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "ahi.npz" +RECORD_PATH = RECORDS / "ahi.json" +FIXTURE_PATH = FIXTURES / "ahi.npz" BUCKET = "https://noaa-himawari9.s3.amazonaws.com/" PREFIX = "AHI-L2-FLDK-Clouds" @@ -192,7 +197,7 @@ def validate(directory: pathlib.Path, write: bool) -> None: common = { "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_ahi.py", + "source": source_of(__file__), "period": f"{TIME:%Y-%m-%dT%H:%MZ}", "platform": "himawari-9", } diff --git a/docs/validation/validate_catalog_airs.py b/validation/catalog/validate_catalog_airs.py similarity index 90% rename from docs/validation/validate_catalog_airs.py rename to validation/catalog/validate_catalog_airs.py index f162463a..4f17632c 100644 --- a/docs/validation/validate_catalog_airs.py +++ b/validation/catalog/validate_catalog_airs.py @@ -8,9 +8,9 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. Only the needed fields of the product's files are read, with range requests: - python docs/validation/validate_catalog_airs.py 2026-10-04 --fit - python docs/validation/validate_catalog_airs.py 2026-11-05 - python docs/validation/validate_catalog_airs.py 2026-11-04 + python validation/catalog/validate_catalog_airs.py 2026-10-04 --fit + python validation/catalog/validate_catalog_airs.py 2026-11-05 + python validation/catalog/validate_catalog_airs.py 2026-11-04 It also validates the entry's sample size configuration, following `ValidateSampleSizes`. The gated metrics compare sizes with footprints published by @@ -41,9 +41,13 @@ validate_beams, validate_swath, ) -from validation_io import RemoteFile +from validation_io import ( + RemoteFile, + RECORDS, + FIXTURES, + source_of, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # the public element set of `validate_catalog_modis.py` for Aqua, with an epoch after # the days of data @@ -91,9 +95,9 @@ def read_airs(_product, url: str, session, day: datetime, _directory) -> dict: beams="footprints", size_instrument="AIRS", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=REPOSITORY / "src" / "tatc" / "resources" / "validation" / "airs.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "airs.npz", - source="docs/validation/validate_catalog_airs.py", + record_path=RECORDS / "airs.json", + fixture_path=FIXTURES / "airs.npz", + source=source_of(__file__), reference="AIRSAQIRL1B version 8.0 (footprint positions and times)", published_reference="Footprints published by the AIRS project; footprint " "positions of AIRSAQIRL1B version 8.0", diff --git a/docs/validation/validate_catalog_amsr2.py b/validation/catalog/validate_catalog_amsr2.py similarity index 98% rename from docs/validation/validate_catalog_amsr2.py rename to validation/catalog/validate_catalog_amsr2.py index b9d1ae51..aceb4c42 100644 --- a/docs/validation/validate_catalog_amsr2.py +++ b/validation/catalog/validate_catalog_amsr2.py @@ -9,8 +9,8 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: - python docs/validation/validate_catalog_amsr2.py 2026-09-26 - python docs/validation/validate_catalog_amsr2.py 2026-11-01 + python validation/catalog/validate_catalog_amsr2.py 2026-09-26 + python validation/catalog/validate_catalog_amsr2.py 2026-11-01 It also validates the entry's sample size configuration, following `ValidateSampleSizes`. The gated metric compares sizes with footprints published @@ -54,9 +54,8 @@ from tatc.schemas import CircularOrbit, GeneralPerturbationsOrbit, Point import validation_io -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "amsr2.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "amsr2.npz" +RECORD_PATH = validation_io.RECORDS / "amsr2.json" +FIXTURE_PATH = validation_io.FIXTURES / "amsr2.npz" FIT_DAY = datetime(2026, 9, 26, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data @@ -607,7 +606,7 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non "digest": entry.configurations[SAMPLE_CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_amsr2.py", + "source": validation_io.source_of(__file__), "reference": "Footprints of JAXA's AMSR2 channel set; spacing of " "GPM_1CGCOMW1AMSR2 version 08", "period": f"{day:%Y-%m-%d}", @@ -664,7 +663,7 @@ def write_fixture_and_record(day, tle, entry, orbit, results, table) -> None: "digest": entry.configurations["swath"].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_amsr2.py", + "source": validation_io.source_of(__file__), "reference": "GPM_1CGCOMW1AMSR2 version 08", "period": f"{day:%Y-%m-%d}", "platform": "gcom-w", diff --git a/docs/validation/validate_catalog_amsua.py b/validation/catalog/validate_catalog_amsua.py similarity index 92% rename from docs/validation/validate_catalog_amsua.py rename to validation/catalog/validate_catalog_amsua.py index 292e07de..c83b286c 100644 --- a/docs/validation/validate_catalog_amsua.py +++ b/validation/catalog/validate_catalog_amsua.py @@ -8,8 +8,8 @@ Needs the `validation` extra, `pyhdf`, and an Earthdata token in `EARTHDATA_TOKEN`. The product's files are HDF4 (about 0.5 MB each), so they are downloaded whole: - python docs/validation/validate_catalog_amsua.py 2026-10-04 --fit - python docs/validation/validate_catalog_amsua.py 2026-11-05 + python validation/catalog/validate_catalog_amsua.py 2026-10-04 --fit + python validation/catalog/validate_catalog_amsua.py 2026-11-05 It also validates the entry's sample size configuration, following `ValidateSampleSizes`. The gated metrics compare sizes with the footprint published @@ -41,9 +41,13 @@ validate_beams, validate_swath, ) -from validation_io import get_with_retries +from validation_io import ( + get_with_retries, + RECORDS, + FIXTURES, + source_of, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # the public element set of `validate_catalog_modis.py` for Aqua, with an epoch after # the day of data @@ -122,9 +126,9 @@ def read_amsua(_product, url: str, session, day: datetime, directory) -> dict: beams="footprints", size_instrument="AMSU-A", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=REPOSITORY / "src" / "tatc" / "resources" / "validation" / "amsua.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "amsua.npz", - source="docs/validation/validate_catalog_amsua.py", + record_path=RECORDS / "amsua.json", + fixture_path=FIXTURES / "amsua.npz", + source=source_of(__file__), reference="AIRABRAD version 005 (footprint positions and times)", published_reference="Footprint published in the AIRABRAD documentation; " "footprint positions of AIRABRAD version 005", diff --git a/docs/validation/validate_catalog_ascat.py b/validation/catalog/validate_catalog_ascat.py similarity index 97% rename from docs/validation/validate_catalog_ascat.py rename to validation/catalog/validate_catalog_ascat.py index 3609ce1c..2ee49308 100644 --- a/docs/validation/validate_catalog_ascat.py +++ b/validation/catalog/validate_catalog_ascat.py @@ -27,8 +27,8 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: - python docs/validation/validate_catalog_ascat.py 2026-10-05 --fit - python docs/validation/validate_catalog_ascat.py 2026-11-08 + python validation/catalog/validate_catalog_ascat.py 2026-10-05 --fit + python validation/catalog/validate_catalog_ascat.py 2026-11-08 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -73,11 +73,14 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "ascat.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "ascat.npz" +RECORD_PATH = RECORDS / "ascat.json" +FIXTURE_PATH = FIXTURES / "ascat.npz" SHORT_NAME = "ASCATC-L2-25km" NORAD_ID = 43689 @@ -86,7 +89,7 @@ CONFIGURATION = "swaths" # element sets of the fitting day, and public element sets from CelesTrak, with # epochs after each day of data -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "metop_2026-10-05.3le" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "metop_2026-10-05.3le" ELEMENT_SETS = { "2026-11-08": [ "1 43689U 18087A 26313.63049069 .00000132 00000+0 80485-4 0 9990", @@ -508,7 +511,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_ascat.py", + "source": source_of(__file__), "reference": f"{SHORT_NAME} (wind vector cell positions and row times)", "period": f"{day:%Y-%m-%d}", "platform": PLATFORM, diff --git a/docs/validation/validate_catalog_atlas.py b/validation/catalog/validate_catalog_atlas.py similarity index 94% rename from docs/validation/validate_catalog_atlas.py rename to validation/catalog/validate_catalog_atlas.py index 995e1424..907a318f 100644 --- a/docs/validation/validate_catalog_atlas.py +++ b/validation/catalog/validate_catalog_atlas.py @@ -15,19 +15,19 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: - python docs/validation/validate_catalog_atlas.py 2026-10-01 --fit - python docs/validation/validate_catalog_atlas.py 2026-10-01 - python docs/validation/validate_catalog_atlas.py 2026-11-04 + python validation/catalog/validate_catalog_atlas.py 2026-10-01 --fit + python validation/catalog/validate_catalog_atlas.py 2026-10-01 + python validation/catalog/validate_catalog_atlas.py 2026-11-04 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. A record of the day of the fit has no holdout, which the entry's validation reports as a gap. With `--same-day-element-set`, it tests instead with the element set nearest the middle -of the day from docs/validation/icesat2_2026-11-04.3le, for comparison with the views' +of the day from elements/icesat2_2026-11-04.3le, for comparison with the views' intended use with an element set a few days old; it does not write a record: - python docs/validation/validate_catalog_atlas.py 2026-11-04 --same-day-element-set + python validation/catalog/validate_catalog_atlas.py 2026-11-04 --same-day-element-set @author: Paul T. Grogan """ @@ -57,11 +57,14 @@ read_element_set_file, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "atlas.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "atlas.npz" +RECORD_PATH = RECORDS / "atlas.json" +FIXTURE_PATH = FIXTURES / "atlas.npz" FIT_DAY = datetime(2026, 10, 1, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs a few days after each day of data; @@ -76,7 +79,7 @@ "2 43613 91.9941 329.8453 0000721 8.7128 351.4134 15.28274788454479", ), } -ELEMENT_SET_FILE = pathlib.Path(__file__).parent / "icesat2_2026-11-04.3le" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "icesat2_2026-11-04.3le" NORAD_ID = 43613 CONFIGURATION = "beam_pairs" PAIRS = ("gt1", "gt2", "gt3") @@ -373,7 +376,7 @@ def main() -> None: "digest": entry.configurations[CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_atlas.py", + "source": source_of(__file__), "reference": "ATL08QL version 007 (land segments south of 60 deg S)", "period": f"{day:%Y-%m-%d}", "platform": "icesat-2", diff --git a/docs/validation/validate_catalog_atlid.py b/validation/catalog/validate_catalog_atlid.py similarity index 85% rename from docs/validation/validate_catalog_atlid.py rename to validation/catalog/validate_catalog_atlid.py index f7724319..432c8b77 100644 --- a/docs/validation/validate_catalog_atlid.py +++ b/validation/catalog/validate_catalog_atlid.py @@ -12,8 +12,8 @@ Needs the `validation` extra and a MAAP offline token in `ESA_MAAP_KEY`. Only the profiles' times and positions are read, with range requests: - python docs/validation/validate_catalog_atlid.py 2026-09-27 --fit - python docs/validation/validate_catalog_atlid.py 2026-11-07 + python validation/catalog/validate_catalog_atlid.py 2026-09-27 --fit + python validation/catalog/validate_catalog_atlid.py 2026-11-07 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -37,14 +37,20 @@ to_seconds, validate_profiler, ) -from validation_io import ecef, read_element_set_file +from validation_io import ( + ecef, + read_element_set_file, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "atlid.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "atlid.npz" +RECORD_PATH = RECORDS / "atlid.json" +FIXTURE_PATH = FIXTURES / "atlid.npz" NORAD_ID = 59908 FIT_DAY = datetime(2026, 9, 27, tzinfo=timezone.utc) -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "earthcare_2026-09-27.3le" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "earthcare_2026-09-27.3le" PLATFORM = "earthcare" CONFIGURATION = "profile" @@ -99,7 +105,7 @@ def main() -> None: FIT_DAY, RECORD_PATH, FIXTURE_PATH, - "docs/validation/validate_catalog_atlid.py", + source_of(__file__), "ATL_NOM_1B (profile positions and times)", arguments.write, ) diff --git a/docs/validation/validate_catalog_atms.py b/validation/catalog/validate_catalog_atms.py similarity index 97% rename from docs/validation/validate_catalog_atms.py rename to validation/catalog/validate_catalog_atms.py index e54a85fb..e2aafeec 100644 --- a/docs/validation/validate_catalog_atms.py +++ b/validation/catalog/validate_catalog_atms.py @@ -8,8 +8,8 @@ Reads anonymous public data, and needs the `validation` extra: - python docs/validation/validate_catalog_atms.py 2026-10-02 - python docs/validation/validate_catalog_atms.py 2026-08-12 + python validation/catalog/validate_catalog_atms.py 2026-10-02 + python validation/catalog/validate_catalog_atms.py 2026-08-12 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -18,8 +18,8 @@ 2026-11-05 (the notebooks' angles are NOAA-20's), and tested on a day at least 30 days from it: - python docs/validation/validate_catalog_atms.py 2026-11-05 --platform noaa-21 --fit - python docs/validation/validate_catalog_atms.py 2026-10-02 --platform noaa-21 + python validation/catalog/validate_catalog_atms.py 2026-11-05 --platform noaa-21 --fit + python validation/catalog/validate_catalog_atms.py 2026-10-02 --platform noaa-21 With `--transfer`, it tests NOAA-20's configurations on another platform instead, and adds the results to the record as a transfer, which does not count toward the tier. @@ -69,6 +69,9 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) FIT_PLATFORM = "noaa-20" @@ -79,9 +82,7 @@ "swath_width_median", "footprint_iou_median", ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "atms.json" -FIXTURES = REPOSITORY / "tests" / "catalog" / "fixtures" +RECORD_PATH = RECORDS / "atms.json" # the days to which each platform's angles were fitted, and its configurations # (swath, beams) and fixture @@ -466,7 +467,7 @@ def validate_beams(day, tle, entry, orbit, reference, write: bool, run: Run) -> "digest": entry.configurations[run.beams].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_atms.py", + "source": source_of(__file__), "reference": "Footprints of the TC PRIMED documentation; beam centers of " "the ATMS SDR geolocation", "period": f"{day:%Y-%m-%d}", @@ -548,7 +549,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[run.swath].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_atms.py", + "source": source_of(__file__), "reference": "ATMS SDR geolocation", "period": f"{day:%Y-%m-%d}", "platform": run.platform, diff --git a/docs/validation/validate_catalog_avhrr.py b/validation/catalog/validate_catalog_avhrr.py similarity index 92% rename from docs/validation/validate_catalog_avhrr.py rename to validation/catalog/validate_catalog_avhrr.py index 5b896361..48e3d536 100644 --- a/docs/validation/validate_catalog_avhrr.py +++ b/validation/catalog/validate_catalog_avhrr.py @@ -11,9 +11,9 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. Only the positions and times are read, with range requests (about 2 GB a day): - python docs/validation/validate_catalog_avhrr.py 2026-11-05 --fit - python docs/validation/validate_catalog_avhrr.py 2026-11-05 - python docs/validation/validate_catalog_avhrr.py 2026-10-05 + python validation/catalog/validate_catalog_avhrr.py 2026-11-05 --fit + python validation/catalog/validate_catalog_avhrr.py 2026-11-05 + python validation/catalog/validate_catalog_avhrr.py 2026-10-05 A day is reduced to one scan line a second and every 16th sample (and the last). The product records no spacecraft position, which the fit takes from the element set. @@ -53,9 +53,15 @@ validate_beams, validate_swath, ) -from validation_io import RemoteFile, read_element_set_file +from validation_io import ( + RemoteFile, + read_element_set_file, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] NORAD_ID = 43689 FIT_DAY = datetime(2026, 11, 5, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data @@ -65,7 +71,7 @@ "2 43689 98.7256 9.6406 0001524 126.9326 233.1991 14.21484375415305", ), } -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "metop_2026-10-05.3le" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "metop_2026-10-05.3le" GHRSST_EPOCH = pd.Timestamp("1981-01-01", tz="UTC") SAMPLES = 2048 LINE_RATE = 6 # scan lines a second @@ -148,9 +154,9 @@ def read_avhrr(_product, url: str, session, day: datetime, _directory) -> dict: beams="pixels", size_instrument="AVHRR", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=REPOSITORY / "src" / "tatc" / "resources" / "validation" / "avhrr.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "avhrr.npz", - source="docs/validation/validate_catalog_avhrr.py", + record_path=RECORDS / "avhrr.json", + fixture_path=FIXTURES / "avhrr.npz", + source=source_of(__file__), reference="AVHRRF_MC-STAR-L2P version 2.80 (sample positions and times)", published_reference="Footprint published by the NWP SAF; sample positions of " "AVHRRF_MC-STAR-L2P version 2.80", diff --git a/docs/validation/validate_catalog_bbr.py b/validation/catalog/validate_catalog_bbr.py similarity index 93% rename from docs/validation/validate_catalog_bbr.py rename to validation/catalog/validate_catalog_bbr.py index b57656a3..df9a1816 100644 --- a/docs/validation/validate_catalog_bbr.py +++ b/validation/catalog/validate_catalog_bbr.py @@ -17,9 +17,9 @@ pixels' positions and the lines' times are read (of the shortwave band, every second line), with range requests: - python docs/validation/validate_catalog_bbr.py 2026-09-27 --fit - python docs/validation/validate_catalog_bbr.py 2026-09-27 --fit-view - python docs/validation/validate_catalog_bbr.py 2026-11-07 + python validation/catalog/validate_catalog_bbr.py 2026-09-27 --fit + python validation/catalog/validate_catalog_bbr.py 2026-09-27 --fit-view + python validation/catalog/validate_catalog_bbr.py 2026-11-07 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -57,14 +57,17 @@ score_swath_area, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "bbr.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "bbr.npz" +RECORD_PATH = RECORDS / "bbr.json" +FIXTURE_PATH = FIXTURES / "bbr.npz" NORAD_ID = 59908 FIT_DAY = datetime(2026, 9, 27, tzinfo=timezone.utc) -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "earthcare_2026-09-27.3le" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "earthcare_2026-09-27.3le" PLATFORM = "earthcare" CONFIGURATION = "views" PRODUCT = "BBR_SNG_1B" @@ -200,7 +203,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_bbr.py", + "source": source_of(__file__), "reference": f"{PRODUCT} (pixel positions of the shortwave band, every " "second line)", "period": f"{day:%Y-%m-%d}", diff --git a/docs/validation/validate_catalog_ceres.py b/validation/catalog/validate_catalog_ceres.py similarity index 95% rename from docs/validation/validate_catalog_ceres.py rename to validation/catalog/validate_catalog_ceres.py index af35d540..dcfb0cd7 100644 --- a/docs/validation/validate_catalog_ceres.py +++ b/validation/catalog/validate_catalog_ceres.py @@ -13,8 +13,8 @@ Needs the `validation` extra, `pyhdf`, and an Earthdata token in `EARTHDATA_TOKEN`. Each day's file (about 280 MB, HDF4) is downloaded whole: - python docs/validation/validate_catalog_ceres.py 2026-08-25 --fit - python docs/validation/validate_catalog_ceres.py 2026-09-30 + python validation/catalog/validate_catalog_ceres.py 2026-08-25 --fit + python validation/catalog/validate_catalog_ceres.py 2026-09-30 The product is released about six weeks after the data are taken. A day is reduced to the first sweep of each record. @@ -43,9 +43,11 @@ get_with_retries, load_element_set, use_archive, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] FIT_DAY = datetime(2026, 8, 25, tzinfo=timezone.utc) SHORT_NAME, VERSION = "CER_ES8_NOAA20-FM6", "Edition1" RECORD_SAMPLES, SAMPLE_PERIOD, RECORD_PERIOD = 660, 0.01, 6.6 @@ -189,9 +191,9 @@ def table(name: str) -> np.ndarray: beams="", size_instrument="CERES", published_footprints=(), - record_path=REPOSITORY / "src" / "tatc" / "resources" / "validation" / "ceres.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "ceres.npz", - source="docs/validation/validate_catalog_ceres.py", + record_path=RECORDS / "ceres.json", + fixture_path=FIXTURES / "ceres.npz", + source=source_of(__file__), reference="CER_ES8_NOAA20-FM6 Edition1 (footprint positions, projected to the " "ellipsoid, and times)", published_reference="", diff --git a/docs/validation/validate_catalog_cpr.py b/validation/catalog/validate_catalog_cpr.py similarity index 85% rename from docs/validation/validate_catalog_cpr.py rename to validation/catalog/validate_catalog_cpr.py index 460465bd..878f61c9 100644 --- a/docs/validation/validate_catalog_cpr.py +++ b/validation/catalog/validate_catalog_cpr.py @@ -12,8 +12,8 @@ Needs the `validation` extra and a MAAP offline token in `ESA_MAAP_KEY`. Only the profiles' times and positions are read, with range requests: - python docs/validation/validate_catalog_cpr.py 2026-09-27 --fit - python docs/validation/validate_catalog_cpr.py 2026-11-07 + python validation/catalog/validate_catalog_cpr.py 2026-09-27 --fit + python validation/catalog/validate_catalog_cpr.py 2026-11-07 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -37,14 +37,19 @@ to_seconds, validate_profiler, ) -from validation_io import read_element_set_file +from validation_io import ( + read_element_set_file, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "cpr.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "cpr.npz" +RECORD_PATH = RECORDS / "cpr.json" +FIXTURE_PATH = FIXTURES / "cpr.npz" NORAD_ID = 59908 FIT_DAY = datetime(2026, 9, 27, tzinfo=timezone.utc) -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "earthcare_2026-09-27.3le" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "earthcare_2026-09-27.3le" PLATFORM = "earthcare" CONFIGURATION = "nadir" @@ -97,7 +102,7 @@ def main() -> None: FIT_DAY, RECORD_PATH, FIXTURE_PATH, - "docs/validation/validate_catalog_cpr.py", + source_of(__file__), "CPR_NOM_1B (profile positions and times)", arguments.write, ) diff --git a/docs/validation/validate_catalog_cris.py b/validation/catalog/validate_catalog_cris.py similarity index 97% rename from docs/validation/validate_catalog_cris.py rename to validation/catalog/validate_catalog_cris.py index 9b1afebd..0a6e2497 100644 --- a/docs/validation/validate_catalog_cris.py +++ b/validation/catalog/validate_catalog_cris.py @@ -8,8 +8,8 @@ Reads anonymous public data, and needs the `validation` extra: - python docs/validation/validate_catalog_cris.py 2026-10-02 - python docs/validation/validate_catalog_cris.py 2026-08-12 + python validation/catalog/validate_catalog_cris.py 2026-10-02 + python validation/catalog/validate_catalog_cris.py 2026-08-12 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -58,6 +58,9 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) FIT_PLATFORM = "noaa-20" @@ -68,9 +71,8 @@ "swath_width_median", "footprint_iou_median", ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "cris.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "cris.npz" +RECORD_PATH = RECORDS / "cris.json" +FIXTURE_PATH = FIXTURES / "cris.npz" FIT_DAY = datetime(2026, 10, 2, tzinfo=timezone.utc) FIELDS = ( @@ -370,7 +372,7 @@ def validate_pixels( "digest": entry.configurations[PIXELS].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_cris.py", + "source": source_of(__file__), "reference": "Footprints published by the NWP SAF; fields of view of the " "CrIS SDR geolocation", "period": f"{day:%Y-%m-%d}", @@ -449,7 +451,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[SWATH].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_cris.py", + "source": source_of(__file__), "reference": "CrIS SDR geolocation", "period": f"{day:%Y-%m-%d}", "platform": "noaa-20", diff --git a/docs/validation/validate_catalog_csar.py b/validation/catalog/validate_catalog_csar.py similarity index 97% rename from docs/validation/validate_catalog_csar.py rename to validation/catalog/validate_catalog_csar.py index 57aee6be..5a7bcaac 100644 --- a/docs/validation/validate_catalog_csar.py +++ b/validation/catalog/validate_catalog_csar.py @@ -18,9 +18,9 @@ Needs the `validation` extra: - python docs/validation/validate_catalog_csar.py 2026-10-02 --fit - python docs/validation/validate_catalog_csar.py 2026-08-12 - python docs/validation/validate_catalog_csar.py 2026-11-10 --mode ew + python validation/catalog/validate_catalog_csar.py 2026-10-02 --fit + python validation/catalog/validate_catalog_csar.py 2026-08-12 + python validation/catalog/validate_catalog_csar.py 2026-11-10 --mode ew With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -68,12 +68,15 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "csar.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "csar.npz" -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "sentinel_2026-08-12.3le" +RECORD_PATH = RECORDS / "csar.json" +FIXTURE_PATH = FIXTURES / "csar.npz" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "sentinel_2026-08-12.3le" STAC_URL = "https://planetarycomputer.microsoft.com/api/stac/v1/search" TOKEN_URL = "https://planetarycomputer.microsoft.com/api/sas/v1/token/sentinel-1-grd" @@ -725,7 +728,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[key].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_csar.py", + "source": source_of(__file__), "reference": "Geolocation grids and restituted orbits of the annotations " + "of Sentinel-1 Level-1 GRD products", "period": f"{day:%Y-%m-%d}", diff --git a/docs/validation/validate_catalog_dpr.py b/validation/catalog/validate_catalog_dpr.py similarity index 87% rename from docs/validation/validate_catalog_dpr.py rename to validation/catalog/validate_catalog_dpr.py index c860223c..b2fff8d4 100644 --- a/docs/validation/validate_catalog_dpr.py +++ b/validation/catalog/validate_catalog_dpr.py @@ -9,10 +9,10 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. Only the needed fields of the product's files are read, with range requests: - python docs/validation/validate_catalog_dpr.py 2026-10-03 --fit - python docs/validation/validate_catalog_dpr.py 2026-10-03 - python docs/validation/validate_catalog_dpr.py 2026-07-20 - python docs/validation/validate_catalog_dpr.py 2026-11-10 + python validation/catalog/validate_catalog_dpr.py 2026-10-03 --fit + python validation/catalog/validate_catalog_dpr.py 2026-10-03 + python validation/catalog/validate_catalog_dpr.py 2026-07-20 + python validation/catalog/validate_catalog_dpr.py 2026-11-10 It also validates the entry's sample size configuration, following `ValidateSampleSizes`. The gated metrics compare sizes with footprints published in @@ -40,9 +40,14 @@ validate_beams, validate_swath, ) -from validation_io import read_element_set_file +from validation_io import ( + read_element_set_file, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] NORAD_ID = 39574 FIT_DAY = datetime(2026, 10, 3, tzinfo=timezone.utc) # the element set of `ValidateConicalGMI` for the day of the fit, and a public element @@ -57,7 +62,7 @@ "2 39574 64.9689 174.1431 0011469 256.2485 103.7379 15.44776426720584", ), } -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "gpm_2026-07-15.3le" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "gpm_2026-07-15.3le" PRODUCT = Product( short_name="GPM_2ADPR", version="08", @@ -84,9 +89,9 @@ beams="beams", size_instrument="DPR", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=REPOSITORY / "src" / "tatc" / "resources" / "validation" / "dpr.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "dpr.npz", - source="docs/validation/validate_catalog_dpr.py", + record_path=RECORDS / "dpr.json", + fixture_path=FIXTURES / "dpr.npz", + source=source_of(__file__), reference="GPM_2ADPR version 08 (beam positions of the full swath)", published_reference="Footprints of the TC PRIMED documentation; beam positions " "of GPM_2ADPR version 08", diff --git a/docs/validation/validate_catalog_earthcare_msi.py b/validation/catalog/validate_catalog_earthcare_msi.py similarity index 89% rename from docs/validation/validate_catalog_earthcare_msi.py rename to validation/catalog/validate_catalog_earthcare_msi.py index 5b71d349..ce51105a 100644 --- a/docs/validation/validate_catalog_earthcare_msi.py +++ b/validation/catalog/validate_catalog_earthcare_msi.py @@ -16,9 +16,9 @@ to every eighth line and some of the 357 columns of imaged pixels (of the grid's 384), with range requests: - python docs/validation/validate_catalog_earthcare_msi.py 2026-09-27 --fit - python docs/validation/validate_catalog_earthcare_msi.py 2026-09-27 --fit-view - python docs/validation/validate_catalog_earthcare_msi.py 2026-11-07 + python validation/catalog/validate_catalog_earthcare_msi.py 2026-09-27 --fit + python validation/catalog/validate_catalog_earthcare_msi.py 2026-09-27 --fit-view + python validation/catalog/validate_catalog_earthcare_msi.py 2026-11-07 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -36,13 +36,19 @@ from tatc.schemas import GeneralPerturbationsOrbit from earthcare_io import check_time_scale, load_day, to_seconds from gesdisc_scanner import Reference, Setup, fit, fit_view, fit_yaw, validate_swath -from validation_io import TO_GEODETIC, read_element_set_file +from validation_io import ( + TO_GEODETIC, + read_element_set_file, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, +) from validate_catalog_atlid import read_atlid -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] NORAD_ID = 59908 FIT_DAY = datetime(2026, 9, 27, tzinfo=timezone.utc) -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "earthcare_2026-09-27.3le" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "earthcare_2026-09-27.3le" PRODUCT = "MSI_RGR_1C" # the product's grid has 384 columns, of which 12 to 368 hold the imaged pixels and # the others are always fill @@ -65,14 +71,9 @@ beams="", size_instrument="", published_footprints=(), - record_path=REPOSITORY - / "src" - / "tatc" - / "resources" - / "validation" - / "earthcare_msi.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "earthcare_msi.npz", - source="docs/validation/validate_catalog_earthcare_msi.py", + record_path=RECORDS / "earthcare_msi.json", + fixture_path=FIXTURES / "earthcare_msi.npz", + source=source_of(__file__), reference=f"{PRODUCT} (pixel positions of every fourth orbit, every eighth line), " "with spacecraft positions of ATL_NOM_1B", published_reference="", diff --git a/docs/validation/validate_catalog_ecostress.py b/validation/catalog/validate_catalog_ecostress.py similarity index 93% rename from docs/validation/validate_catalog_ecostress.py rename to validation/catalog/validate_catalog_ecostress.py index bbc699c4..86198892 100644 --- a/docs/validation/validate_catalog_ecostress.py +++ b/validation/catalog/validate_catalog_ecostress.py @@ -16,9 +16,9 @@ requests (about 5 GB a day), and every 50th sample (and the last). The fit of 2026-10-04 read every fourth scene instead. - python docs/validation/validate_catalog_ecostress.py 2026-10-04 --fit - python docs/validation/validate_catalog_ecostress.py 2026-10-04 --fit-view - python docs/validation/validate_catalog_ecostress.py 2026-11-08 + python validation/catalog/validate_catalog_ecostress.py 2026-10-04 --fit + python validation/catalog/validate_catalog_ecostress.py 2026-10-04 --fit-view + python validation/catalog/validate_catalog_ecostress.py 2026-11-08 ECOSTRESS images scenes over land and coastal waters, whose gaps are not compared. @@ -51,9 +51,14 @@ fit_yaw, validate_swath, ) -from validation_io import TO_GEODETIC, RemoteFile +from validation_io import ( + TO_GEODETIC, + RemoteFile, + RECORDS, + FIXTURES, + source_of, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data ELEMENTS = { @@ -162,14 +167,9 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict: beams="", size_instrument="ECOSTRESS", published_footprints=(), - record_path=REPOSITORY - / "src" - / "tatc" - / "resources" - / "validation" - / "ecostress.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "ecostress.npz", - source="docs/validation/validate_catalog_ecostress.py", + record_path=RECORDS / "ecostress.json", + fixture_path=FIXTURES / "ecostress.npz", + source=source_of(__file__), reference="ECO_L1B_GEO version 002 (sample positions and times of every fourth " "sweep, in blocks of eight consecutive scenes of every 32)", published_reference="", diff --git a/docs/validation/validate_catalog_emit.py b/validation/catalog/validate_catalog_emit.py similarity index 96% rename from docs/validation/validate_catalog_emit.py rename to validation/catalog/validate_catalog_emit.py index 1281ff78..b13dce7f 100644 --- a/docs/validation/validate_catalog_emit.py +++ b/validation/catalog/validate_catalog_emit.py @@ -13,9 +13,9 @@ is read, with range requests, and the time of every 8th of those lines, interpolated between them: - python docs/validation/validate_catalog_emit.py 2026-10-04 --fit - python docs/validation/validate_catalog_emit.py 2026-10-04 --fit-view - python docs/validation/validate_catalog_emit.py 2026-11-08 + python validation/catalog/validate_catalog_emit.py 2026-10-04 --fit + python validation/catalog/validate_catalog_emit.py 2026-10-04 --fit-view + python validation/catalog/validate_catalog_emit.py 2026-11-08 The swath, about 75 km wide, is imaged in runs of scenes lasting about a minute (at most about five), too short and sparse for a global lattice of points or grid, so a @@ -55,11 +55,13 @@ recompute_passes, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "emit.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "emit.npz" +RECORD_PATH = RECORDS / "emit.json" +FIXTURE_PATH = FIXTURES / "emit.npz" FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) PLATFORM = "iss" CONFIGURATION = "swath" @@ -281,7 +283,7 @@ def satellite_for(time_step): "digest": entry.configurations[CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_emit.py", + "source": source_of(__file__), "reference": "EMITL1BRAD version 002, observation geometry (pixel " "positions and line times of every 16th line)", "period": f"{day:%Y-%m-%d}", diff --git a/docs/validation/validate_catalog_gedi.py b/validation/catalog/validate_catalog_gedi.py similarity index 96% rename from docs/validation/validate_catalog_gedi.py rename to validation/catalog/validate_catalog_gedi.py index cf873e95..3d369682 100644 --- a/docs/validation/validate_catalog_gedi.py +++ b/validation/catalog/validate_catalog_gedi.py @@ -22,8 +22,8 @@ element sets of the days in `iss_2026-04-01.3le`. Every 200th shot (about 12 km apart) is read, with range requests: - python docs/validation/validate_catalog_gedi.py 2026-05-01 --fit - python docs/validation/validate_catalog_gedi.py 2026-06-08 + python validation/catalog/validate_catalog_gedi.py 2026-05-01 --fit + python validation/catalog/validate_catalog_gedi.py 2026-06-08 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -60,12 +60,15 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "gedi.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "gedi.npz" -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "iss_2026-04-01.3le" +RECORD_PATH = RECORDS / "gedi.json" +FIXTURE_PATH = FIXTURES / "gedi.npz" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "iss_2026-04-01.3le" NORAD_ID = 25544 FIT_DAY = datetime(2026, 5, 1, tzinfo=timezone.utc) PLATFORM = "iss" @@ -415,7 +418,7 @@ def main() -> None: "digest": entry.configurations[CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_gedi.py", + "source": source_of(__file__), "reference": f"{SHORT_NAME} version {VERSION} (every 200th shot, where " "the beams' center lies within 1 deg of nadir)", "period": f"{day:%Y-%m-%d}", diff --git a/docs/validation/validate_catalog_gmi.py b/validation/catalog/validate_catalog_gmi.py similarity index 98% rename from docs/validation/validate_catalog_gmi.py rename to validation/catalog/validate_catalog_gmi.py index b3c90b08..3c9b6e6e 100644 --- a/docs/validation/validate_catalog_gmi.py +++ b/validation/catalog/validate_catalog_gmi.py @@ -10,8 +10,8 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: - python docs/validation/validate_catalog_gmi.py 2026-10-03 - python docs/validation/validate_catalog_gmi.py 2026-07-20 \ + python validation/catalog/validate_catalog_gmi.py 2026-10-03 + python validation/catalog/validate_catalog_gmi.py 2026-07-20 \ --elements It also validates the entry's sample size configuration, following @@ -57,9 +57,8 @@ from tatc.schemas import CircularOrbit, GeneralPerturbationsOrbit, Point import validation_io -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "gmi.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "gmi.npz" +RECORD_PATH = validation_io.RECORDS / "gmi.json" +FIXTURE_PATH = validation_io.FIXTURES / "gmi.npz" FIT_DAY = datetime(2026, 10, 3, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs just after each day of data @@ -609,7 +608,7 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non "digest": entry.configurations[SAMPLE_CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_gmi.py", + "source": validation_io.source_of(__file__), "reference": "Footprints of the GMI L1B ATBD and TC PRIMED; spacing of " "GPM_1CGPMGMI version 08", "period": f"{day:%Y-%m-%d}", @@ -677,7 +676,7 @@ def write_fixture_and_record(day, tle, entry, orbit, results, fixtures) -> None: "digest": entry.configurations["feeds"].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_gmi.py", + "source": validation_io.source_of(__file__), "reference": "GPM_1CGPMGMI version 08", "period": f"{day:%Y-%m-%d}", "platform": "gpm", diff --git a/docs/validation/validate_catalog_harp2.py b/validation/catalog/validate_catalog_harp2.py similarity index 92% rename from docs/validation/validate_catalog_harp2.py rename to validation/catalog/validate_catalog_harp2.py index d5c87624..85480b37 100644 --- a/docs/validation/validate_catalog_harp2.py +++ b/validation/catalog/validate_catalog_harp2.py @@ -12,8 +12,8 @@ near-nadir view's positions, times, and spacecraft positions are read, with range requests: - python docs/validation/validate_catalog_harp2.py 2026-10-04 --fit - python docs/validation/validate_catalog_harp2.py 2026-11-07 + python validation/catalog/validate_catalog_harp2.py 2026-10-04 --fit + python validation/catalog/validate_catalog_harp2.py 2026-11-07 A day is reduced to every fourth line of the view (about 1.8 s) and every eighth sample (and the last). The product covers the sunlit part of each orbit, whose dark @@ -44,9 +44,13 @@ load_day, validate_swath, ) -from validation_io import RemoteFile +from validation_io import ( + RemoteFile, + RECORDS, + FIXTURES, + source_of, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data PACE_ELEMENTS = ( @@ -103,9 +107,9 @@ def read_harp2(_product, url: str, session, day: datetime, _directory) -> dict: beams="", size_instrument="HARP2", published_footprints=(), - record_path=REPOSITORY / "src" / "tatc" / "resources" / "validation" / "harp2.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "harp2.npz", - source="docs/validation/validate_catalog_harp2.py", + record_path=RECORDS / "harp2.json", + fixture_path=FIXTURES / "harp2.npz", + source=source_of(__file__), reference="PACE_HARP2_L1B_SCI version 4 (positions and times of the near-nadir " "view)", published_reference="", diff --git a/docs/validation/validate_catalog_iasi.py b/validation/catalog/validate_catalog_iasi.py similarity index 98% rename from docs/validation/validate_catalog_iasi.py rename to validation/catalog/validate_catalog_iasi.py index a9a6ec46..5a1dc0c2 100644 --- a/docs/validation/validate_catalog_iasi.py +++ b/validation/catalog/validate_catalog_iasi.py @@ -29,8 +29,8 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: - python docs/validation/validate_catalog_iasi.py 2026-10-03 --fit - python docs/validation/validate_catalog_iasi.py 2026-11-04 + python validation/catalog/validate_catalog_iasi.py 2026-10-03 --fit + python validation/catalog/validate_catalog_iasi.py 2026-11-04 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -74,11 +74,13 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "iasi.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "iasi.npz" +RECORD_PATH = RECORDS / "iasi.json" +FIXTURE_PATH = FIXTURES / "iasi.npz" PRODUCT = "IASI_SST_METOP_B-OSISAF-L2P-v1.0" FIT_DAY = datetime(2026, 10, 3, tzinfo=timezone.utc) @@ -546,7 +548,7 @@ def validate_pixels(day, tle, entry, orbit, reference, write) -> None: "digest": entry.configurations[PIXELS].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_iasi.py", + "source": source_of(__file__), "reference": "Published footprints; pixel positions of the OSI SAF IASI " "sea surface temperature product", "period": f"{day:%Y-%m-%d}", @@ -625,7 +627,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[SWATH].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_iasi.py", + "source": source_of(__file__), "reference": "Pixel positions of the OSI SAF IASI sea surface temperature " "product", "period": f"{day:%Y-%m-%d}", diff --git a/docs/validation/validate_catalog_karin.py b/validation/catalog/validate_catalog_karin.py similarity index 97% rename from docs/validation/validate_catalog_karin.py rename to validation/catalog/validate_catalog_karin.py index 35dd796e..9d449844 100644 --- a/docs/validation/validate_catalog_karin.py +++ b/validation/catalog/validate_catalog_karin.py @@ -19,8 +19,8 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: - python docs/validation/validate_catalog_karin.py 2026-10-01 --fit - python docs/validation/validate_catalog_karin.py 2026-11-04 + python validation/catalog/validate_catalog_karin.py 2026-10-01 --fit + python validation/catalog/validate_catalog_karin.py 2026-11-04 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -62,11 +62,13 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "karin.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "karin.npz" +RECORD_PATH = RECORDS / "karin.json" +FIXTURE_PATH = FIXTURES / "karin.npz" FIT_DAY = datetime(2026, 10, 1, tzinfo=timezone.utc) PLATFORM = "swot" @@ -458,7 +460,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_karin.py", + "source": source_of(__file__), "reference": "SWOT_L2_LR_SSH_BASIC_D (good-quality pixels and line times)", "period": f"{day:%Y-%m-%d}", "platform": PLATFORM, diff --git a/docs/validation/validate_catalog_lsar.py b/validation/catalog/validate_catalog_lsar.py similarity index 97% rename from docs/validation/validate_catalog_lsar.py rename to validation/catalog/validate_catalog_lsar.py index 6c411f3e..76edf10f 100644 --- a/docs/validation/validate_catalog_lsar.py +++ b/validation/catalog/validate_catalog_lsar.py @@ -19,14 +19,14 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: - python docs/validation/validate_catalog_lsar.py 2026-10-02 --fit - python docs/validation/validate_catalog_lsar.py 2026-11-04 + python validation/catalog/validate_catalog_lsar.py 2026-10-02 --fit + python validation/catalog/validate_catalog_lsar.py 2026-11-04 Several days pool their results, as for the 77 MHz mode, of which few products are acquired, each with its own element set; the fixture keeps the passes of the first day, with its element set: - python docs/validation/validate_catalog_lsar.py 2026-11-01 \ + python validation/catalog/validate_catalog_lsar.py 2026-11-01 \ 2026-11-02 2026-11-03 2026-11-05 --configuration swath_77mhz With `--write`, it writes the entry's validation record and the reduced fixture from @@ -78,11 +78,14 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "lsar.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "lsar.npz" +RECORD_PATH = RECORDS / "lsar.json" +FIXTURE_PATH = FIXTURES / "lsar.npz" SEARCH_URL = "https://api.daac.asf.alaska.edu/services/search/param" FIT_DAY = datetime(2026, 10, 2, tzinfo=timezone.utc) @@ -101,10 +104,10 @@ } # the 77 MHz mode's held-out days, pooled, whose products became available on # 2026-11-09 and 10, each with the element set nearest the middle of the day from -# docs/validation/nisar_2026-11-01.3le (they were first tested with the element set of +# elements/nisar_2026-11-01.3le (they were first tested with the element set of # 2026-11-04 above, whose epoch is 3 to 7 days after them) POOLED_DAYS = ("2026-11-01", "2026-11-02", "2026-11-03", "2026-11-05") -ELEMENT_SET_FILE = pathlib.Path(__file__).parent / "nisar_2026-11-01.3le" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "nisar_2026-11-01.3le" NORAD_ID = 65053 @@ -655,7 +658,7 @@ def write_results(key, results, tles, entry, metrics) -> None: "digest": entry.configurations[key].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_lsar.py", + "source": source_of(__file__), "reference": "Geolocation grids, orbits, and bounding polygons of NISAR " "Level 1 RSLC products", "period": ", ".join(f"{day:%Y-%m-%d}" for day in days), diff --git a/docs/validation/validate_catalog_mhs.py b/validation/catalog/validate_catalog_mhs.py similarity index 89% rename from docs/validation/validate_catalog_mhs.py rename to validation/catalog/validate_catalog_mhs.py index 53d0f364..c3c31d8c 100644 --- a/docs/validation/validate_catalog_mhs.py +++ b/validation/catalog/validate_catalog_mhs.py @@ -8,9 +8,9 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: - python docs/validation/validate_catalog_mhs.py 2026-11-05 --fit - python docs/validation/validate_catalog_mhs.py 2026-11-05 - python docs/validation/validate_catalog_mhs.py 2026-10-05 + python validation/catalog/validate_catalog_mhs.py 2026-11-05 --fit + python validation/catalog/validate_catalog_mhs.py 2026-11-05 + python validation/catalog/validate_catalog_mhs.py 2026-10-05 It also validates the entry's sample size configuration, following `ValidateSampleSizes`. The gated metrics compare sizes with footprints published in @@ -41,9 +41,14 @@ validate_beams, validate_swath, ) -from validation_io import read_element_set_file +from validation_io import ( + read_element_set_file, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] NORAD_ID = 43689 FIT_DAY = datetime(2026, 11, 5, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data @@ -53,7 +58,7 @@ "2 43689 98.7256 9.6406 0001524 126.9326 233.1991 14.21484375415305", ), } -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "metop_2026-10-05.3le" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "metop_2026-10-05.3le" PRODUCT = Product( short_name="GPM_1CMETOPCMHS", version="08", @@ -97,9 +102,9 @@ beams="beams", size_instrument="MHS", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=REPOSITORY / "src" / "tatc" / "resources" / "validation" / "mhs.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "mhs.npz", - source="docs/validation/validate_catalog_mhs.py", + record_path=RECORDS / "mhs.json", + fixture_path=FIXTURES / "mhs.npz", + source=source_of(__file__), reference="GPM_1CMETOPCMHS version 08 (beam positions)", published_reference="Footprints of the TC PRIMED documentation; beam positions " "of GPM_1CMETOPCMHS version 08", diff --git a/docs/validation/validate_catalog_modis.py b/validation/catalog/validate_catalog_modis.py similarity index 97% rename from docs/validation/validate_catalog_modis.py rename to validation/catalog/validate_catalog_modis.py index f87ab102..cbb63f39 100644 --- a/docs/validation/validate_catalog_modis.py +++ b/validation/catalog/validate_catalog_modis.py @@ -17,9 +17,9 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: - python docs/validation/validate_catalog_modis.py 2026-10-04 - python docs/validation/validate_catalog_modis.py 2026-11-05 - python docs/validation/validate_catalog_modis.py 2026-11-05 \ + python validation/catalog/validate_catalog_modis.py 2026-10-04 + python validation/catalog/validate_catalog_modis.py 2026-11-05 + python validation/catalog/validate_catalog_modis.py 2026-11-05 \ --platform aqua With `--write`, it writes the entry's validation record and, on Terra, the reduced @@ -65,11 +65,13 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "modis.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "modis.npz" +RECORD_PATH = RECORDS / "modis.json" +FIXTURE_PATH = FIXTURES / "modis.npz" FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) FIT_PLATFORM = "terra" @@ -459,7 +461,7 @@ def validate_pixels(day, tle, entry, orbit, reference, platform, write) -> None: "digest": entry.configurations[PIXELS].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_modis.py", + "source": source_of(__file__), "reference": "Footprints published by NASA LAADS; MOD03 geolocation", "period": f"{day:%Y-%m-%d}", "platform": platform, @@ -555,7 +557,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[SWATH].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_modis.py", + "source": source_of(__file__), "reference": "MOD03 geolocation", "period": f"{day:%Y-%m-%d}", "platform": platform, diff --git a/docs/validation/validate_catalog_msi.py b/validation/catalog/validate_catalog_msi.py similarity index 98% rename from docs/validation/validate_catalog_msi.py rename to validation/catalog/validate_catalog_msi.py index efa0a128..cd2b6416 100644 --- a/docs/validation/validate_catalog_msi.py +++ b/validation/catalog/validate_catalog_msi.py @@ -16,9 +16,9 @@ Needs the `validation` extra: - python docs/validation/validate_catalog_msi.py 2026-10-03 --fit - python docs/validation/validate_catalog_msi.py 2026-08-12 - python docs/validation/validate_catalog_msi.py 2026-11-10 + python validation/catalog/validate_catalog_msi.py 2026-10-03 --fit + python validation/catalog/validate_catalog_msi.py 2026-08-12 + python validation/catalog/validate_catalog_msi.py 2026-11-10 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -64,12 +64,15 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "msi.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "msi.npz" -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "sentinel_2026-08-12.3le" +RECORD_PATH = RECORDS / "msi.json" +FIXTURE_PATH = FIXTURES / "msi.npz" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "sentinel_2026-08-12.3le" STAC_URL = "https://planetarycomputer.microsoft.com/api/stac/v1/search" TOKEN_URL = "https://planetarycomputer.microsoft.com/api/sas/v1/token/sentinel-2-l2a" @@ -912,7 +915,7 @@ def satellite_for(platform: str, time_step: float): "digest": entry.configurations[KEY].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_msi.py", + "source": source_of(__file__), "reference": "Valid data footprints of Sentinel-2 Level-2A tiles; viewing " + "angle grids and GPS ephemerides of their metadata", "period": f"{day:%Y-%m-%d}", diff --git a/docs/validation/validate_catalog_oci.py b/validation/catalog/validate_catalog_oci.py similarity index 96% rename from docs/validation/validate_catalog_oci.py rename to validation/catalog/validate_catalog_oci.py index a24ce68f..0e2ae02d 100644 --- a/docs/validation/validate_catalog_oci.py +++ b/validation/catalog/validate_catalog_oci.py @@ -16,11 +16,11 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. Only the positions, times, and tilts are read, with range requests (about 1.2 GB a day): - python docs/validation/validate_catalog_oci.py 2026-10-04 --fit - python docs/validation/validate_catalog_oci.py 2026-08-15 --switches 2026-10-08 - python docs/validation/validate_catalog_oci.py 2026-08-20 --blind 2026-09-15 2026-10-04 2026-10-07 - python docs/validation/validate_catalog_oci.py 2026-11-09 - python docs/validation/validate_catalog_oci.py 2026-11-10 + python validation/catalog/validate_catalog_oci.py 2026-10-04 --fit + python validation/catalog/validate_catalog_oci.py 2026-08-15 --switches 2026-10-08 + python validation/catalog/validate_catalog_oci.py 2026-08-20 --blind 2026-09-15 2026-10-04 2026-10-07 + python validation/catalog/validate_catalog_oci.py 2026-11-09 + python validation/catalog/validate_catalog_oci.py 2026-11-10 A day is reduced to every sixth scan (about 1 s) and every 16th sample (and the last). The product covers the sunlit part of each orbit, whose dark part is a gap. @@ -52,9 +52,11 @@ get_with_retries, normalize, up, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] # the angles are fitted to 2026-10-04, and the schedule of the tilt's change to # 2026-08-15 through 2026-10-08, the last day of fitting data FIT_DAY = datetime(2026, 10, 8, tzinfo=timezone.utc) @@ -131,9 +133,9 @@ def read_oci(_product, url: str, session, day: datetime, _directory) -> dict: beams="", size_instrument="OCI", published_footprints=(), - record_path=REPOSITORY / "src" / "tatc" / "resources" / "validation" / "oci.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "oci.npz", - source="docs/validation/validate_catalog_oci.py", + record_path=RECORDS / "oci.json", + fixture_path=FIXTURES / "oci.npz", + source=source_of(__file__), reference="PACE_OCI_L1B_SCI version 3 (sample positions and times)", published_reference="", fit_day=FIT_DAY, diff --git a/docs/validation/validate_catalog_oco2.py b/validation/catalog/validate_catalog_oco2.py similarity index 97% rename from docs/validation/validate_catalog_oco2.py rename to validation/catalog/validate_catalog_oco2.py index bff53386..464989b5 100644 --- a/docs/validation/validate_catalog_oco2.py +++ b/validation/catalog/validate_catalog_oco2.py @@ -11,8 +11,8 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. Only the geometry is read, with range requests: - python docs/validation/validate_catalog_oco2.py 2026-10-04 --fit - python docs/validation/validate_catalog_oco2.py 2026-11-07 + python validation/catalog/validate_catalog_oco2.py 2026-10-04 --fit + python validation/catalog/validate_catalog_oco2.py 2026-11-07 The swath, about 10 km wide, is too narrow for a global lattice of points or grid, so a sample of soundings is scored instead: whether the view observes each within two @@ -60,9 +60,11 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data OCO2_ELEMENTS = ( @@ -101,8 +103,7 @@ def read_oco2(_product, url: str, session, day: datetime, _directory) -> dict: PRODUCT = Product(short_name="OCO2_L1B_Science", version="11.2", read=read_oco2) -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "oco2.json" -FIXTURES = REPOSITORY / "tests" / "catalog" / "fixtures" +RECORD_PATH = RECORDS / "oco2.json" TIME_STEPS = (10, 30, 120) SAMPLE = 1000 FIXTURE_PASSES = 60 @@ -301,7 +302,7 @@ def satellite_for(time_step): "digest": entry.configurations[key].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_oco2.py", + "source": source_of(__file__), "reference": f"OCO2_L1B_Science version 11.2 (sounding positions and " f"times, {key} orbits)", "period": f"{day:%Y-%m-%d}", diff --git a/docs/validation/validate_catalog_olci.py b/validation/catalog/validate_catalog_olci.py similarity index 94% rename from docs/validation/validate_catalog_olci.py rename to validation/catalog/validate_catalog_olci.py index 2f97c33a..56602d51 100644 --- a/docs/validation/validate_catalog_olci.py +++ b/validation/catalog/validate_catalog_olci.py @@ -13,8 +13,8 @@ points and times are read from each product's archive, with range requests (about 1.3 MB a product): - python docs/validation/validate_catalog_olci.py 2026-10-04 --fit - python docs/validation/validate_catalog_olci.py 2026-11-04 + python validation/catalog/validate_catalog_olci.py 2026-10-04 --fit + python validation/catalog/validate_catalog_olci.py 2026-11-04 A day is reduced to one image line in 23 (about 1 s), at the 77 tie points of each line (every 64th of 4865 columns). The products cover the sunlit part of each orbit, @@ -47,9 +47,17 @@ load_day, validate_swath, ) -from validation_io import RemoteFile, TO_GEODETIC, ecef, normalize, up +from validation_io import ( + RemoteFile, + TO_GEODETIC, + ecef, + normalize, + up, + RECORDS, + FIXTURES, + source_of, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data ELEMENTS = { @@ -150,9 +158,9 @@ def read(name: str, fields: tuple[str, ...]) -> dict: beams="", size_instrument="OLCI", published_footprints=(), - record_path=REPOSITORY / "src" / "tatc" / "resources" / "validation" / "olci.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "olci.npz", - source="docs/validation/validate_catalog_olci.py", + record_path=RECORDS / "olci.json", + fixture_path=FIXTURES / "olci.npz", + source=source_of(__file__), reference="S3A_OL_1_EFR (tie point positions and times)", published_reference="", fit_day=FIT_DAY, diff --git a/docs/validation/validate_catalog_oli.py b/validation/catalog/validate_catalog_oli.py similarity index 98% rename from docs/validation/validate_catalog_oli.py rename to validation/catalog/validate_catalog_oli.py index 47f0e467..d1e519b9 100644 --- a/docs/validation/validate_catalog_oli.py +++ b/validation/catalog/validate_catalog_oli.py @@ -20,9 +20,9 @@ Needs the `validation` extra: - python docs/validation/validate_catalog_oli.py 2026-11-05 --fit - python docs/validation/validate_catalog_oli.py 2026-10-03 - python docs/validation/validate_catalog_oli.py 2026-10-03 \ + python validation/catalog/validate_catalog_oli.py 2026-11-05 --fit + python validation/catalog/validate_catalog_oli.py 2026-10-03 + python validation/catalog/validate_catalog_oli.py 2026-10-03 \ --platform landsat-8 With `--write`, it writes the entry's validation record and, on Landsat 9, the reduced @@ -66,11 +66,13 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "oli.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "oli.npz" +RECORD_PATH = RECORDS / "oli.json" +FIXTURE_PATH = FIXTURES / "oli.npz" SCENES_URL = "https://landsatlook.usgs.gov/stac-server/search" ANGLES_URL = "https://planetarycomputer.microsoft.com/api/stac/v1/search" @@ -744,7 +746,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[KEY].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_oli.py", + "source": source_of(__file__), "reference": "USGS Landsat Collection 2 scene footprints and center times; " + "angle coefficient files of Level-2 products", "period": f"{day:%Y-%m-%d}", diff --git a/docs/validation/validate_catalog_omps.py b/validation/catalog/validate_catalog_omps.py similarity index 92% rename from docs/validation/validate_catalog_omps.py rename to validation/catalog/validate_catalog_omps.py index 3ec66640..5af4e2c8 100644 --- a/docs/validation/validate_catalog_omps.py +++ b/validation/catalog/validate_catalog_omps.py @@ -8,8 +8,8 @@ Reads anonymous public data, and needs the `validation` extra: - python docs/validation/validate_catalog_omps.py 2026-10-01 --platform noaa-21 --fit - python docs/validation/validate_catalog_omps.py 2026-11-05 --platform noaa-21 + python validation/catalog/validate_catalog_omps.py 2026-10-01 --platform noaa-21 --fit + python validation/catalog/validate_catalog_omps.py 2026-11-05 --platform noaa-21 A day is reduced to every second line (2.5 s on NOAA-21, 5 s on NOAA-20) and every fourth sample (and the last). The Nadir Mapper images the sunlit part of each orbit, whose dark part is a @@ -40,10 +40,11 @@ list_keys, load_element_set, use_archive, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -FIXTURES = REPOSITORY / "tests" / "catalog" / "fixtures" GROUP = "All_Data/OMPS-TC-GEO_All/" LINE_STRIDE, SAMPLE_STRIDE = 2, 4 # the day to which each platform's angles were fitted, and its configuration and @@ -130,14 +131,9 @@ def make_setup(platform: str) -> Setup: beams="", size_instrument="OMPS Nadir Mapper", published_footprints=(), - record_path=REPOSITORY - / "src" - / "tatc" - / "resources" - / "validation" - / "omps_nm.json", + record_path=RECORDS / "omps_nm.json", fixture_path=fixture, - source="docs/validation/validate_catalog_omps.py", + source=source_of(__file__), reference="OMPS-TC-GEO (sample positions and times), NOAA Open Data " "Dissemination", published_reference="", diff --git a/docs/validation/validate_catalog_poseidon4.py b/validation/catalog/validate_catalog_poseidon4.py similarity index 95% rename from docs/validation/validate_catalog_poseidon4.py rename to validation/catalog/validate_catalog_poseidon4.py index 8a3f6115..e77a2874 100644 --- a/docs/validation/validate_catalog_poseidon4.py +++ b/validation/catalog/validate_catalog_poseidon4.py @@ -11,8 +11,8 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. Only the measurements' times and positions are read, with range requests: - python docs/validation/validate_catalog_poseidon4.py 2026-11-07 - python docs/validation/validate_catalog_poseidon4.py 2026-11-08 --platform sentinel-6b + python validation/catalog/validate_catalog_poseidon4.py 2026-11-07 + python validation/catalog/validate_catalog_poseidon4.py 2026-11-08 --platform sentinel-6b With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -46,13 +46,13 @@ recompute_passes, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = ( - REPOSITORY / "src" / "tatc" / "resources" / "validation" / "poseidon4.json" -) -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "poseidon4.npz" +RECORD_PATH = RECORDS / "poseidon4.json" +FIXTURE_PATH = FIXTURES / "poseidon4.npz" SHORT_NAMES = { "sentinel-6a": "JASON_CS_S6A_L2_ALT_LR_RED_OST_NRT_F", "sentinel-6b": "JASON_CS_S6B_L2_ALT_LR_RED_OST_NRT_G", @@ -263,7 +263,7 @@ def main() -> None: "digest": entry.configurations["nadir"].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_poseidon4.py", + "source": source_of(__file__), "reference": f"{SHORT_NAMES[platform]} (1 Hz measurement positions and times)", "period": f"{day:%Y-%m-%d}", "platform": "sentinel-6a", diff --git a/docs/validation/validate_catalog_smap.py b/validation/catalog/validate_catalog_smap.py similarity index 97% rename from docs/validation/validate_catalog_smap.py rename to validation/catalog/validate_catalog_smap.py index 72ce9818..f32a1afc 100644 --- a/docs/validation/validate_catalog_smap.py +++ b/validation/catalog/validate_catalog_smap.py @@ -18,8 +18,8 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: - python docs/validation/validate_catalog_smap.py 2026-10-24 - python docs/validation/validate_catalog_smap.py 2026-09-20 + python validation/catalog/validate_catalog_smap.py 2026-10-24 + python validation/catalog/validate_catalog_smap.py 2026-09-20 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -66,14 +66,15 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = ( - REPOSITORY / "src" / "tatc" / "resources" / "validation" / "smap_radiometer.json" -) -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "smap_radiometer.npz" -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "smap_2026-09-20.3le" +RECORD_PATH = RECORDS / "smap_radiometer.json" +FIXTURE_PATH = FIXTURES / "smap_radiometer.npz" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "smap_2026-09-20.3le" FIT_DAY = datetime(2026, 10, 24, tzinfo=timezone.utc) PLATFORM = "smap" @@ -602,7 +603,7 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non "digest": entry.configurations[SAMPLE_CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_smap.py", + "source": source_of(__file__), "reference": "Footprints of Piepmeier et al. (2017) and the JPL SMAP " "specifications; spacing of SPL1BTB", "period": f"{day:%Y-%m-%d}", @@ -700,7 +701,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_smap.py", + "source": source_of(__file__), "reference": "SPL1BTB (footprint positions and times)", "period": f"{day:%Y-%m-%d}", "platform": PLATFORM, diff --git a/docs/validation/validate_catalog_spexone.py b/validation/catalog/validate_catalog_spexone.py similarity index 93% rename from docs/validation/validate_catalog_spexone.py rename to validation/catalog/validate_catalog_spexone.py index 849e9641..dc1cb44a 100644 --- a/docs/validation/validate_catalog_spexone.py +++ b/validation/catalog/validate_catalog_spexone.py @@ -13,8 +13,8 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. Only the needed fields are read, with range requests: - python docs/validation/validate_catalog_spexone.py 2026-10-04 --fit - python docs/validation/validate_catalog_spexone.py 2026-11-07 + python validation/catalog/validate_catalog_spexone.py 2026-10-04 --fit + python validation/catalog/validate_catalog_spexone.py 2026-11-07 The product covers the sunlit part of each orbit, whose dark part is a gap. @@ -46,9 +46,14 @@ load_day, validate_swath, ) -from validation_io import TO_GEODETIC, RemoteFile +from validation_io import ( + TO_GEODETIC, + RemoteFile, + RECORDS, + FIXTURES, + source_of, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data PACE_ELEMENTS = ( @@ -111,14 +116,9 @@ def read_navigation(url: str, session, day: datetime) -> tuple[np.ndarray, np.nd beams="", size_instrument="SPEXone", published_footprints=(), - record_path=REPOSITORY - / "src" - / "tatc" - / "resources" - / "validation" - / "spexone.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "spexone.npz", - source="docs/validation/validate_catalog_spexone.py", + record_path=RECORDS / "spexone.json", + fixture_path=FIXTURES / "spexone.npz", + source=source_of(__file__), reference="PACE_SPEXONE_L1C_SCI version 4 (positions of bins and times of the " "nadir view)", published_reference="", diff --git a/docs/validation/validate_catalog_ssmis.py b/validation/catalog/validate_catalog_ssmis.py similarity index 96% rename from docs/validation/validate_catalog_ssmis.py rename to validation/catalog/validate_catalog_ssmis.py index ebc11493..e78be715 100644 --- a/docs/validation/validate_catalog_ssmis.py +++ b/validation/catalog/validate_catalog_ssmis.py @@ -15,8 +15,8 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. Only the needed fields of the product's files are read, with range requests: - python docs/validation/validate_catalog_ssmis.py 2026-10-04 --fit - python docs/validation/validate_catalog_ssmis.py 2026-11-03 + python validation/catalog/validate_catalog_ssmis.py 2026-10-04 --fit + python validation/catalog/validate_catalog_ssmis.py 2026-11-03 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -51,11 +51,13 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "ssmis.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "ssmis.npz" +RECORD_PATH = RECORDS / "ssmis.json" +FIXTURE_PATH = FIXTURES / "ssmis.npz" FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) PLATFORM = "dmsp-f18" CONFIGURATION = "swath" @@ -285,7 +287,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_ssmis.py", + "source": source_of(__file__), "reference": "GPM_1CF18SSMIS version 08 (positions of the S1 samples)", "period": f"{day:%Y-%m-%d}", "platform": PLATFORM, diff --git a/docs/validation/validate_catalog_tempo.py b/validation/catalog/validate_catalog_tempo.py similarity index 97% rename from docs/validation/validate_catalog_tempo.py rename to validation/catalog/validate_catalog_tempo.py index 80d92daf..c40d0508 100644 --- a/docs/validation/validate_catalog_tempo.py +++ b/validation/catalog/validate_catalog_tempo.py @@ -18,8 +18,8 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. Only the geometry is read, with range requests: - python docs/validation/validate_catalog_tempo.py 2026-10-06 --fit - python docs/validation/validate_catalog_tempo.py 2026-11-08 + python validation/catalog/validate_catalog_tempo.py 2026-10-06 --fit + python validation/catalog/validate_catalog_tempo.py 2026-11-08 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -56,11 +56,13 @@ get_holdout_gap, get_with_retries, up, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "tempo.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "tempo.npz" +RECORD_PATH = RECORDS / "tempo.json" +FIXTURE_PATH = FIXTURES / "tempo.npz" SHORT_NAME, VERSION = "TEMPO_RAD_L1", "V04" FIT_DAY = datetime(2026, 10, 6, tzinfo=timezone.utc) PLATFORM = "intelsat-40e" @@ -401,7 +403,7 @@ def validate(day, tle, scan, write) -> None: "digest": entry.configurations[CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_tempo.py", + "source": source_of(__file__), "reference": f"{SHORT_NAME} {VERSION} (outer corners of the outermost " "pixels of a full scan, ultraviolet band)", "period": f"{time:%Y-%m-%dT%H:%MZ}", diff --git a/docs/validation/validate_catalog_tmi.py b/validation/catalog/validate_catalog_tmi.py similarity index 97% rename from docs/validation/validate_catalog_tmi.py rename to validation/catalog/validate_catalog_tmi.py index 26b63869..cadfb955 100644 --- a/docs/validation/validate_catalog_tmi.py +++ b/validation/catalog/validate_catalog_tmi.py @@ -22,9 +22,9 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. Only the needed fields of the product's files are read, with range requests: - python docs/validation/validate_catalog_tmi.py 2013-06-01 --fit - python docs/validation/validate_catalog_tmi.py 2013-06-01 - python docs/validation/validate_catalog_tmi.py 2013-07-10 + python validation/catalog/validate_catalog_tmi.py 2013-06-01 --fit + python validation/catalog/validate_catalog_tmi.py 2013-06-01 + python validation/catalog/validate_catalog_tmi.py 2013-07-10 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -67,12 +67,14 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) from validate_catalog_trmm_pr import ELEMENT_SET_FILE, FIT_DAY, NORAD_ID -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "tmi.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "tmi.npz" +RECORD_PATH = RECORDS / "tmi.json" +FIXTURE_PATH = FIXTURES / "tmi.npz" PLATFORM = "trmm" CONFIGURATION = "feeds" SAMPLE_CONFIGURATION = "sample_size" @@ -415,7 +417,7 @@ def validate_sample_sizes(day, tle, entry, orbit, references, write: bool) -> No "digest": entry.configurations[SAMPLE_CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_tmi.py", + "source": source_of(__file__), "reference": "Footprints of the TC PRIMED documentation; spacing of " "GPM_1CTRMMTMI version 08", "period": f"{day:%Y-%m-%d}", @@ -502,7 +504,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[CONFIGURATION].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_tmi.py", + "source": source_of(__file__), "reference": "GPM_1CTRMMTMI version 08 (positions of the S1, S2, and S3 " "samples)", "period": f"{day:%Y-%m-%d}", diff --git a/docs/validation/validate_catalog_trmm_pr.py b/validation/catalog/validate_catalog_trmm_pr.py similarity index 86% rename from docs/validation/validate_catalog_trmm_pr.py rename to validation/catalog/validate_catalog_trmm_pr.py index db9f93b3..25f97cc0 100644 --- a/docs/validation/validate_catalog_trmm_pr.py +++ b/validation/catalog/validate_catalog_trmm_pr.py @@ -11,9 +11,9 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. Only the needed fields of the product's files are read, with range requests: - python docs/validation/validate_catalog_trmm_pr.py 2013-06-01 --fit - python docs/validation/validate_catalog_trmm_pr.py 2013-06-01 - python docs/validation/validate_catalog_trmm_pr.py 2013-07-10 + python validation/catalog/validate_catalog_trmm_pr.py 2013-06-01 --fit + python validation/catalog/validate_catalog_trmm_pr.py 2013-06-01 + python validation/catalog/validate_catalog_trmm_pr.py 2013-07-10 It also validates the entry's sample size configuration, following `ValidateSampleSizes`. The gated metrics compare sizes with footprints published in @@ -41,12 +41,17 @@ validate_beams, validate_swath, ) -from validation_io import read_element_set_file +from validation_io import ( + read_element_set_file, + RECORDS, + FIXTURES, + source_of, + ELEMENT_SET_FOLDER, +) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] NORAD_ID = 25063 FIT_DAY = datetime(2013, 6, 1, tzinfo=timezone.utc) -ELEMENT_SET_FILE = REPOSITORY / "docs" / "validation" / "trmm_2013-05-20.3le" +ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "trmm_2013-05-20.3le" PRODUCT = Product( short_name="GPM_2APR", version="07", @@ -71,14 +76,9 @@ beams="beams", size_instrument="PR", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=REPOSITORY - / "src" - / "tatc" - / "resources" - / "validation" - / "trmm_pr.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "trmm_pr.npz", - source="docs/validation/validate_catalog_trmm_pr.py", + record_path=RECORDS / "trmm_pr.json", + fixture_path=FIXTURES / "trmm_pr.npz", + source=source_of(__file__), reference="GPM_2APR version 07 (beam positions of the full swath)", published_reference="Footprints of the TC PRIMED documentation; beam positions " "of GPM_2APR version 07", diff --git a/docs/validation/validate_catalog_tropomi.py b/validation/catalog/validate_catalog_tropomi.py similarity index 97% rename from docs/validation/validate_catalog_tropomi.py rename to validation/catalog/validate_catalog_tropomi.py index 76bcecdb..2232fdad 100644 --- a/docs/validation/validate_catalog_tropomi.py +++ b/validation/catalog/validate_catalog_tropomi.py @@ -19,9 +19,9 @@ Needs the `validation` extra: - python docs/validation/validate_catalog_tropomi.py 2026-10-05 --fit - python docs/validation/validate_catalog_tropomi.py 2026-11-05 - python docs/validation/validate_catalog_tropomi.py 2026-11-10 + python validation/catalog/validate_catalog_tropomi.py 2026-10-05 --fit + python validation/catalog/validate_catalog_tropomi.py 2026-11-05 + python validation/catalog/validate_catalog_tropomi.py 2026-11-10 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -61,11 +61,13 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "tropomi.json" -FIXTURE_PATH = REPOSITORY / "tests" / "catalog" / "fixtures" / "tropomi.npz" +RECORD_PATH = RECORDS / "tropomi.json" +FIXTURE_PATH = FIXTURES / "tropomi.npz" BUCKET = "https://meeo-s5p.s3.amazonaws.com/" PREFIX = "NRTI/L2__AER_AI/" @@ -522,7 +524,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[KEY].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_tropomi.py", + "source": source_of(__file__), "reference": "Sentinel-5P TROPOMI aerosol index product (near real time)", "period": f"{day:%Y-%m-%d}", "platform": PLATFORM, diff --git a/docs/validation/validate_catalog_viirs.py b/validation/catalog/validate_catalog_viirs.py similarity index 97% rename from docs/validation/validate_catalog_viirs.py rename to validation/catalog/validate_catalog_viirs.py index 18f32d97..ea9c1317 100644 --- a/docs/validation/validate_catalog_viirs.py +++ b/validation/catalog/validate_catalog_viirs.py @@ -12,8 +12,8 @@ Reads anonymous public data, and needs the `validation` extra: - python docs/validation/validate_catalog_viirs.py 2026-10-02 - python docs/validation/validate_catalog_viirs.py 2026-08-12 + python validation/catalog/validate_catalog_viirs.py 2026-10-02 + python validation/catalog/validate_catalog_viirs.py 2026-08-12 With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -22,8 +22,8 @@ to 2026-11-05 (the notebooks' angles are NOAA-20's), and tested on a day at least 30 days from it: - python docs/validation/validate_catalog_viirs.py 2026-11-05 --platform noaa-21 --fit - python docs/validation/validate_catalog_viirs.py 2026-10-02 --platform noaa-21 + python validation/catalog/validate_catalog_viirs.py 2026-11-05 --platform noaa-21 --fit + python validation/catalog/validate_catalog_viirs.py 2026-10-02 --platform noaa-21 With `--transfer`, it tests NOAA-20's configurations on another platform instead, and adds the results to the record as a transfer, which does not count toward the tier. @@ -71,6 +71,9 @@ up, update_fixture, update_record, + RECORDS, + FIXTURES, + source_of, ) FIT_PLATFORM = "noaa-20" @@ -81,9 +84,7 @@ "swath_width_median", "footprint_iou_median", ) -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] -RECORD_PATH = REPOSITORY / "src" / "tatc" / "resources" / "validation" / "viirs.json" -FIXTURES = REPOSITORY / "tests" / "catalog" / "fixtures" +RECORD_PATH = RECORDS / "viirs.json" # the days to which each platform's angles were fitted, and its configurations # (swath, and zones if any) and fixture @@ -534,7 +535,7 @@ def validate_zones(day, tle, entry, orbit, reference, write: bool, run: Run) -> "digest": entry.configurations[run.zones].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_viirs.py", + "source": source_of(__file__), "reference": "Footprints published by NOAA/CIMSS; samples of the VIIRS " "moderate-resolution geolocation", "period": f"{day:%Y-%m-%d}", @@ -623,7 +624,7 @@ def satellite_for(time_step: float): "digest": entry.configurations[run.swath].digest, "evidence": "rerun", "tatc_version": tatc.__version__, - "source": "docs/validation/validate_catalog_viirs.py", + "source": source_of(__file__), "reference": "VIIRS moderate-resolution geolocation", "period": f"{day:%Y-%m-%d}", "platform": run.platform, diff --git a/docs/validation/validate_catalog_virs.py b/validation/catalog/validate_catalog_virs.py similarity index 93% rename from docs/validation/validate_catalog_virs.py rename to validation/catalog/validate_catalog_virs.py index 30167eb5..eecb961c 100644 --- a/docs/validation/validate_catalog_virs.py +++ b/validation/catalog/validate_catalog_virs.py @@ -13,9 +13,9 @@ Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`. The positions of samples are read whole, and reduced to every third scan and some samples: - python docs/validation/validate_catalog_virs.py 2013-06-01 --fit - python docs/validation/validate_catalog_virs.py 2013-06-01 - python docs/validation/validate_catalog_virs.py 2013-07-10 + python validation/catalog/validate_catalog_virs.py 2013-06-01 --fit + python validation/catalog/validate_catalog_virs.py 2013-06-01 + python validation/catalog/validate_catalog_virs.py 2013-07-10 It also validates the entry's sample size configuration, following `ValidateSampleSizes`. The gated metrics compare sizes with the footprint published in @@ -53,11 +53,13 @@ RemoteFile, ecef, read_element_set_file, + RECORDS, + FIXTURES, + source_of, ) from validate_catalog_trmm_pr import ELEMENT_SET_FILE, FIT_DAY, NORAD_ID from validate_catalog_trmm_pr import PRODUCT as PR_PRODUCT -REPOSITORY = pathlib.Path(__file__).resolve().parents[2] SAMPLES = 261 LINE_STRIDE = 3 COLUMNS = np.r_[0:SAMPLES:4, SAMPLES - 1] @@ -108,9 +110,9 @@ def read_virs(_product, url: str, session, day: datetime, _directory) -> dict: beams="pixels", size_instrument="VIRS", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=REPOSITORY / "src" / "tatc" / "resources" / "validation" / "virs.json", - fixture_path=REPOSITORY / "tests" / "catalog" / "fixtures" / "virs.npz", - source="docs/validation/validate_catalog_virs.py", + record_path=RECORDS / "virs.json", + fixture_path=FIXTURES / "virs.npz", + source=source_of(__file__), reference="GPM_1BVIRS version 08 (sample positions), with spacecraft positions of " "GPM_2APR version 07", published_reference="Footprint of the TRMM Version 7 README of GES DISC; sample " diff --git a/docs/validation/validation_io.py b/validation/catalog/validation_io.py similarity index 97% rename from docs/validation/validation_io.py rename to validation/catalog/validation_io.py index d260bfd9..59085a47 100644 --- a/docs/validation/validation_io.py +++ b/validation/catalog/validation_io.py @@ -41,6 +41,12 @@ "noaa-21": ("https://noaa-nesdis-n21-pds.s3.amazonaws.com/", "n21"), } BUCKET, ARCHIVE_PREFIX = ARCHIVES["noaa-20"] + +# where the scripts read element sets and write validation records and test fixtures +REPOSITORY = pathlib.Path(__file__).resolve().parents[2] +ELEMENT_SET_FOLDER = pathlib.Path(__file__).resolve().parent / "elements" +RECORDS = REPOSITORY / "src" / "tatc" / "resources" / "validation" +FIXTURES = REPOSITORY / "tests" / "catalog" / "fixtures" IET_EPOCH = pd.Timestamp("1958-01-01", tz="UTC") LEAP_SECONDS = 37 PUBLISHED_EPOCH = pd.Timestamp("2026-10-01", tz="UTC").to_pydatetime() @@ -53,6 +59,14 @@ _SESSION = requests.Session() +def source_of(script): + """ + The path of a script relative to the repository, as validation records + cite their source. + """ + return pathlib.Path(script).resolve().relative_to(REPOSITORY).as_posix() + + def transform_geometry(transform, geometry): """ Transforms the coordinates of a geometry by a function of their x and y From ba4fe8a00f4a2e62c66cd031ab95ea93b004e796 Mon Sep 17 00:00:00 2001 From: Paul Grogan Date: Sat, 14 Nov 2026 23:38:34 -0700 Subject: [PATCH 2/8] measure fitted values in the catalog scripts and trim duplicated notebook tests The CrIS, AMSR2, GMI, MODIS, and SMAP radiometer validation scripts gain a --fit mode that measures their entries' fitted values as the notebooks did, and the entries' provenance cites the scripts. A shared fit_cone helper measures conical scanners, MODIS reductions keep the reported velocity, and the scripts log in to NASA Earthdata with EARTHDATA_TOKEN or ~/.netrc. The ATMS, CrIS, VIIRS, MODIS, AMSR2, GMI, NISAR, and Sentinel-1 notebooks drop the pass, epoch, and swath area tests that the catalog's validation now runs on held-out data; the summary, standard, and scripts cite what remains. --- CHANGELOG.md | 4 +- docs/examples/CollectOrbitGroundTrack.ipynb | 2 +- docs/validation/ValidateConicalAMSR2.ipynb | 206 +----- docs/validation/ValidateConicalGMI.ipynb | 607 +--------------- docs/validation/ValidateDriftMODIS.ipynb | 172 +---- docs/validation/ValidateImagerATMS.ipynb | 652 +----------------- docs/validation/ValidateImagerCrIS.ipynb | 437 +----------- docs/validation/ValidateImagerVIIRS.ipynb | 331 +-------- docs/validation/ValidateSARNISAR.ipynb | 551 +-------------- docs/validation/ValidateSARSentinel1.ipynb | 146 +--- docs/validation/standard.rst | 6 +- docs/validation/summary.rst | 21 +- src/tatc/resources/instruments/amsr2.yml | 4 +- src/tatc/resources/instruments/cris.yml | 10 +- src/tatc/resources/instruments/gmi.yml | 2 +- src/tatc/resources/instruments/modis.yml | 8 +- .../resources/instruments/smap_radiometer.yml | 4 +- tests/catalog/test_entries.py | 4 +- validation/README.md | 2 +- validation/catalog/gesdisc_scanner.py | 4 +- validation/catalog/validate_catalog_amsr2.py | 50 +- validation/catalog/validate_catalog_ascat.py | 4 +- validation/catalog/validate_catalog_atlas.py | 4 +- validation/catalog/validate_catalog_atms.py | 11 +- validation/catalog/validate_catalog_ceres.py | 4 +- validation/catalog/validate_catalog_cris.py | 154 ++++- .../catalog/validate_catalog_ecostress.py | 4 +- validation/catalog/validate_catalog_emit.py | 4 +- validation/catalog/validate_catalog_gedi.py | 4 +- validation/catalog/validate_catalog_gmi.py | 50 +- validation/catalog/validate_catalog_iasi.py | 4 +- validation/catalog/validate_catalog_karin.py | 4 +- validation/catalog/validate_catalog_lsar.py | 4 +- validation/catalog/validate_catalog_modis.py | 115 ++- validation/catalog/validate_catalog_oci.py | 7 +- .../catalog/validate_catalog_poseidon4.py | 4 +- validation/catalog/validate_catalog_smap.py | 80 ++- .../catalog/validate_catalog_spexone.py | 4 +- validation/catalog/validate_catalog_tempo.py | 4 +- validation/catalog/validate_catalog_viirs.py | 10 +- validation/catalog/validation_io.py | 81 ++- 41 files changed, 620 insertions(+), 3159 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 7f74988b..461c17c8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,7 +5,7 @@ Added a catalog of instruments from past and present missions, with a standard for validating them. Fixed instruments losing their fields when serialized. Instruments now reject unknown fields, which can break code that passes misspelled or unused arguments. Added: - - Module `catalog` of instruments from past and present missions (`get_entry`, `list_entries`), starting with GOES-R ABI, GPM GMI, GCOM-W AMSR2, ATMS, CrIS, VIIRS, MODIS, Landsat OLI, Sentinel-2 MSI, Sentinel-1 C-SAR, NISAR L-SAR, SWOT KaRIn, the SMAP radiometer, IASI, Sentinel-5P TROPOMI, GPM DPR, MHS, ICESat-2 ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, Sentinel-3 OLCI, PACE OCI, HARP2, and SPEXone, the OMPS Nadir Mapper, Himawari AHI, CERES, ECOSTRESS, OCO-2, the Sentinel-6 Poseidon-4 altimeter, Metop ASCAT, TEMPO, GEDI, EMIT, EarthCARE ATLID, BBR, CPR, and MSI, and TRMM PR, TMI, and VIRS. `InstrumentEntry.to_satellite` and `build` give an entry's instruments with the attitude they were validated with, and `InstrumentEntry.validation` gives its validation tier, computed from its results and the thresholds of the validation standard (`docs/validation/standard.rst`). GMI, ATMS, VIIRS, MODIS, OLI, MSI, KaRIn, TROPOMI, DPR, MHS, HARP2, SPEXone, Poseidon-4, ASCAT, TEMPO, TMI, VIRS, and EarthCARE's MSI are `validated`, each with stated limitations, and ABI, AMSR2, CrIS, C-SAR, L-SAR, the SMAP radiometer, IASI, ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, OLCI, OCI, OMPS, AHI, CERES, ECOSTRESS, OCO-2, GEDI, EMIT, ATLID, BBR, CPR, and TRMM PR are `partial` and list their gaps. Results on sibling satellites (NOAA-21, Metop-B, Sentinel-1D, Sentinel-6B) are recorded as transfers, which warn on use and do not count toward a tier; ATMS and VIIRS also have configurations fitted on NOAA-21, validated on held-out data, as NOAA-20's angles did not transfer. In an entry with configurations fitted on more than one platform (ATMS, VIIRS, and the OMPS Nadir Mapper), each configuration's name ends with its platform (`swath_noaa_20`, `swath_noaa_21`). Version 2 of the standard adds a lidar class, for ATLAS, version 3 an altimeter class, for Poseidon-4, version 4 a scatterometer class, for ASCAT, with the gates of the SAR class, version 5 a regional geostationary class, for TEMPO, whose gate is the intersection over union of the field of regard with the area a scan images, and version 6 a profiler class, for ATLID and CPR, with the gates of the altimeter class; none changes a threshold of an earlier version. Every pointed configuration with a view tailored to the time step is swept (`is_swept`), so its swaths do not depend on the time step; its records were rescored with swept swaths on the same held-out data, and MSI, TROPOMI, DPR, OCI's swath, and C-SAR's EW mode, whose tiers changed, were tested again on a later held-out day, with the rescored results stated in their limitations. The documentation lists the entries and their results on a page written from the catalog (`docs/validation/catalog_page.py`), and the example `UseInstrumentCatalog` shows their use. The OSSE examples `RunOSSEMonsoon` and `RunOSSEHurricane` take their ATMS and CrIS swaths from the catalog. The scripts that validate the entries and write their records are in `validation/catalog` of the repository, with the element sets they read. + - Module `catalog` of instruments from past and present missions (`get_entry`, `list_entries`), starting with GOES-R ABI, GPM GMI, GCOM-W AMSR2, ATMS, CrIS, VIIRS, MODIS, Landsat OLI, Sentinel-2 MSI, Sentinel-1 C-SAR, NISAR L-SAR, SWOT KaRIn, the SMAP radiometer, IASI, Sentinel-5P TROPOMI, GPM DPR, MHS, ICESat-2 ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, Sentinel-3 OLCI, PACE OCI, HARP2, and SPEXone, the OMPS Nadir Mapper, Himawari AHI, CERES, ECOSTRESS, OCO-2, the Sentinel-6 Poseidon-4 altimeter, Metop ASCAT, TEMPO, GEDI, EMIT, EarthCARE ATLID, BBR, CPR, and MSI, and TRMM PR, TMI, and VIRS. `InstrumentEntry.to_satellite` and `build` give an entry's instruments with the attitude they were validated with, and `InstrumentEntry.validation` gives its validation tier, computed from its results and the thresholds of the validation standard (`docs/validation/standard.rst`). GMI, ATMS, VIIRS, MODIS, OLI, MSI, KaRIn, TROPOMI, DPR, MHS, HARP2, SPEXone, Poseidon-4, ASCAT, TEMPO, TMI, VIRS, and EarthCARE's MSI are `validated`, each with stated limitations, and ABI, AMSR2, CrIS, C-SAR, L-SAR, the SMAP radiometer, IASI, ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, OLCI, OCI, OMPS, AHI, CERES, ECOSTRESS, OCO-2, GEDI, EMIT, ATLID, BBR, CPR, and TRMM PR are `partial` and list their gaps. Results on sibling satellites (NOAA-21, Metop-B, Sentinel-1D, Sentinel-6B) are recorded as transfers, which warn on use and do not count toward a tier; ATMS and VIIRS also have configurations fitted on NOAA-21, validated on held-out data, as NOAA-20's angles did not transfer. In an entry with configurations fitted on more than one platform (ATMS, VIIRS, and the OMPS Nadir Mapper), each configuration's name ends with its platform (`swath_noaa_20`, `swath_noaa_21`). Version 2 of the standard adds a lidar class, for ATLAS, version 3 an altimeter class, for Poseidon-4, version 4 a scatterometer class, for ASCAT, with the gates of the SAR class, version 5 a regional geostationary class, for TEMPO, whose gate is the intersection over union of the field of regard with the area a scan images, and version 6 a profiler class, for ATLID and CPR, with the gates of the altimeter class; none changes a threshold of an earlier version. Every pointed configuration with a view tailored to the time step is swept (`is_swept`), so its swaths do not depend on the time step; its records were rescored with swept swaths on the same held-out data, and MSI, TROPOMI, DPR, OCI's swath, and C-SAR's EW mode, whose tiers changed, were tested again on a later held-out day, with the rescored results stated in their limitations. The documentation lists the entries and their results on a page written from the catalog (`docs/validation/catalog_page.py`), and the example `UseInstrumentCatalog` shows their use. The OSSE examples `RunOSSEMonsoon` and `RunOSSEHurricane` take their ATMS and CrIS swaths from the catalog. The scripts that validate the entries and write their records are in `validation/catalog` of the repository, with the element sets they read. Each script of an entry with fitted values measures them with `--fit`, including those of CrIS, AMSR2, GMI, MODIS, and the SMAP radiometer, which their validation notebooks previously measured. - Class `catalog.TiltSchedule` and field `attitude_schedule` of catalog configurations, for an attitude that changes by day, as PACE's tilt does: `build` and `to_satellite` take the `start` and `end` of the analysis and give an `AttitudeSchedule` with an attitude for each day (UTC), blind while the tilt changes. Function `catalog.get_subsolar_latitude` gives the latitude of the subsolar point. - Field `type` of a catalog configuration's `attitude` (`attitude`, `glint`, or `target`), which builds an `Attitude`, `GlintAttitude`, or `TargetAttitude`, as for OCO-2's glint mode. - Field `blind_intervals` of `Attitude`: intervals of argument of latitude in which a space system's instruments do not observe, for example while the body or a mechanism moves. Observations in them are not valid, so point observations, ground tracks (`valid_obs`, and the swaths of `compute_ground_track`), orbit tracks, and ground pixels omit them, and the periods and swaths of region observations end at them. Method `is_observing` of attitudes, schedules, and instruments. @@ -13,7 +13,7 @@ Added: - Field `type` (`instrument`, `pointed`, or `conical`) of `Instrument`, `PointedInstrument`, and `ConicalInstrument`, which identifies the instrument class in serialized data. Data without a `type` loads as the class its fields imply. Changed: - - The validation notebooks are grouped by capability, as in the summary of their results. Notebook `ValidateGeostationaryGOES` is removed: the validation of the catalog's ABI entry tests the same products. + - The validation notebooks are grouped by capability, as in the summary of their results. Notebook `ValidateGeostationaryGOES` is removed: the validation of the catalog's ABI entry tests the same products. The ATMS, CrIS, VIIRS, MODIS, AMSR2, GMI, NISAR, and Sentinel-1 notebooks no longer test the passes, epochs, and swath areas that the validation of the catalog's entries tests on held-out data. - Instruments reject unknown fields, rather than ignoring them: a misspelled field in the data of a `PointedInstrument` previously gave an `Instrument` with a field of regard of 180 degrees. - Dumping a `Satellite` or other system with a `PointedInstrument` or `ConicalInstrument` keeps the fields of its class, and loading the data restores it. Previously, these instruments were written and restored as a base `Instrument`, without a warning. Data written by earlier versions lacks these fields, so it still loads as an `Instrument`. - Dumping a space system with an `attitude` omits the `velocity_frame` of its instruments, which the attitude sets, so the data can be loaded. diff --git a/docs/examples/CollectOrbitGroundTrack.ipynb b/docs/examples/CollectOrbitGroundTrack.ipynb index e5b5a19b..8df9b644 100644 --- a/docs/examples/CollectOrbitGroundTrack.ipynb +++ b/docs/examples/CollectOrbitGroundTrack.ipynb @@ -1075,7 +1075,7 @@ "id": "fa6b9dd9", "metadata": {}, "source": [ - "Between the equator and 20 deg north, the detailed swath is about 45 km wider than the simple one at one scan period, because VIIRS's measured scan extent is wider than the field of regard of a nominal 3,000 km swath, and contains it entirely. At 2-minute steps, the simple model also misses the scalloped strips along each edge between its circular footprints. Each model suits a purpose: the simple field of regard is fast and adequate for coverage over long periods at coarse time steps, while the detailed model reproduces VIIRS's scans, their bow tie overlap, and their orientation, for analyses at the scale of individual scans (see the [VIIRS validation](../validation/ValidateImagerVIIRS.ipynb) for observation times and swath widths compared with the instrument's data)." + "Between the equator and 20 deg north, the detailed swath is about 45 km wider than the simple one at one scan period, because VIIRS's measured scan extent is wider than the field of regard of a nominal 3,000 km swath, and contains it entirely. At 2-minute steps, the simple model also misses the scalloped strips along each edge between its circular footprints. Each model suits a purpose: the simple field of regard is fast and adequate for coverage over long periods at coarse time steps, while the detailed model reproduces VIIRS's scans, their bow tie overlap, and their orientation, for analyses at the scale of individual scans (see the [instrument catalog](../validation/catalog.rst) for observation times and swath widths of the catalog's VIIRS entry compared with the instrument's data)." ] } ], diff --git a/docs/validation/ValidateConicalAMSR2.ipynb b/docs/validation/ValidateConicalAMSR2.ipynb index 6afdad32..1648d2e0 100644 --- a/docs/validation/ValidateConicalAMSR2.ipynb +++ b/docs/validation/ValidateConicalAMSR2.ipynb @@ -15,7 +15,8 @@ "2. **Scan geometry.** What cone angle, scan sector, orientation, and timing describe AMSR2's scan?\n", "3. **Footprints.** How do the footprints of the candidate TAT-C instruments compare with the scanned arc and swath?\n", "4. **Observations.** Does `collect_observations` predict which points AMSR2 observes in a day, and when?\n", - "5. **Swath coverage.** Do the conical instrument's footprints from `compute_ground_track` reproduce the area AMSR2 scans over an orbit?\n", + "\n", + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `amsr2` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_amsr2.py`; see the [instrument catalog](catalog.rst).\n", "\n", "## Reference Data\n", "\n", @@ -1214,203 +1215,7 @@ "\n", "The swath field of regard reduces the extra predictions to 1.1%, but its narrower cone delays the `start` by 5 s (median) and up to 11 s (95th percentile). The pointed view sweeps over points at the center of the arc at the right time but up to about 100 s early at the swath edges, and it predicts nearly three times as many passes as were observed.\n", "\n", - "The conical instrument matches 99.95% of the observed passes (4,191 of 4,193) with only 7 extra predictions (0.2%), and its `epoch` matches the observation times to 0.02 s (median) and 0.27 s (95th percentile) everywhere in the scan.\n", - "\n", - "## Test 5: Swath Coverage\n", - "\n", - "Over one orbit (starting at 15:00 UTC, after the data gap), the area scanned by AMSR2 (the union of the quadrilaterals formed by adjacent footprint centers on consecutive scans, tested as in Test 4) is compared with the union of the conical instrument's footprints from `compute_ground_track`, at time steps of 1.5 s (one scan), 10 s, and 30 s, on a 0.1 deg grid. The along-track field of view is tailored to each time step with `compute_along_track_field_of_view`: the angle subtended at nadir by the distance the ground track advances (relative to the rotating Earth, at its fastest over the orbit and at perigee) in one time step. For comparison, the cone field of regard's circular footprints are evaluated at a 30 s time step. As in the ATMS notebook, the comparison is limited to grid cells within 300 km of a footprint scanned at least 60 s after the start and before the end of the orbit." - ] - }, - { - "cell_type": "code", - "execution_count": 10, - "id": "1ea69beb", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-26T06:01:42.440459Z", - "iopub.status.busy": "2026-10-26T06:01:42.440219Z", - "iopub.status.idle": "2026-10-26T06:07:08.393865Z", - "shell.execute_reply": "2026-10-26T06:07:08.393025Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
observed (10^6 km^2)TAT-C (10^6 km^2)IoUobserved only (%)TAT-C only (%)
cone field of regard, 30 s64.33366.2960.9700.0062.968
conical instrument, 1.5 s (0.84 deg along track)64.33364.4420.9980.0120.181
conical instrument, 10 s (5.59 deg along track)64.33364.4460.9980.0110.186
conical instrument, 30 s (16.65 deg along track)64.33364.4750.9980.0080.229
\n", - "
" - ], - "text/plain": [ - " observed (10^6 km^2) \\\n", - "cone field of regard, 30 s 64.333 \n", - "conical instrument, 1.5 s (0.84 deg along track) 64.333 \n", - "conical instrument, 10 s (5.59 deg along track) 64.333 \n", - "conical instrument, 30 s (16.65 deg along track) 64.333 \n", - "\n", - " TAT-C (10^6 km^2) IoU \\\n", - "cone field of regard, 30 s 66.296 0.970 \n", - "conical instrument, 1.5 s (0.84 deg along track) 64.442 0.998 \n", - "conical instrument, 10 s (5.59 deg along track) 64.446 0.998 \n", - "conical instrument, 30 s (16.65 deg along track) 64.475 0.998 \n", - "\n", - " observed only (%) \\\n", - "cone field of regard, 30 s 0.006 \n", - "conical instrument, 1.5 s (0.84 deg along track) 0.012 \n", - "conical instrument, 10 s (5.59 deg along track) 0.011 \n", - "conical instrument, 30 s (16.65 deg along track) 0.008 \n", - "\n", - " TAT-C only (%) \n", - "cone field of regard, 30 s 2.968 \n", - "conical instrument, 1.5 s (0.84 deg along track) 0.181 \n", - "conical instrument, 10 s (5.59 deg along track) 0.186 \n", - "conical instrument, 30 s (16.65 deg along track) 0.229 " - ] - }, - "execution_count": 10, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "from shapely import contains_xy, prepare\n", - "\n", - "from tatc.constants import EARTH_MEAN_RADIUS\n", - "from tatc.utils import compute_along_track_field_of_view\n", - "\n", - "orbit_start = 15 * 3600\n", - "orbit_period = 86400 / float(TLE[1][52:63])\n", - "scans5 = np.nonzero(\n", - " (scan_time >= orbit_start) & (scan_time < orbit_start + orbit_period)\n", - ")[0]\n", - "STEP5, MARGIN5 = 0.1, 60 # deg, s\n", - "lon5, lat5 = np.meshgrid(\n", - " np.arange(-180 + STEP5 / 2, 180, STEP5), np.arange(-90 + STEP5 / 2, 90, STEP5)\n", - ")\n", - "cell_area5 = (np.cos(np.radians(lat5)) * (STEP5 * 111.32) ** 2).ravel()\n", - "grid5 = up(lon5.ravel(), lat5.ravel())\n", - "distance5, nearest5 = cKDTree(foot_unit[scans5].reshape(-1, 3)).query(grid5, workers=-1)\n", - "nearest_time5 = scan_time[scans5][nearest5 // N_SAMPLES] - scan_time[scans5[0]]\n", - "duration5 = scan_time[scans5[-1]] - scan_time[scans5[0]]\n", - "compared5 = (\n", - " (distance5 < 2 * np.sin(300 / 6371 / 2))\n", - " & (nearest_time5 > MARGIN5)\n", - " & (nearest_time5 < duration5 - MARGIN5)\n", - ")\n", - "observed5 = np.zeros(len(grid5), dtype=bool)\n", - "_, nearest_eight = cKDTree(foot_unit[scans5].reshape(-1, 3)).query(\n", - " grid5[compared5], k=8, workers=-1\n", - ")\n", - "for column in range(8):\n", - " k, j = np.divmod(nearest_eight[:, column], N_SAMPLES)\n", - " k = scans5[k]\n", - " inside = np.zeros(len(k), dtype=bool)\n", - " for dk in (-1, 0):\n", - " for dj in (-1, 0):\n", - " inside |= in_cell(grid5[compared5], k + dk, j + dj)\n", - " observed5[np.flatnonzero(compared5)] |= inside\n", - "inclination5 = float(TLE[1][8:16])\n", - "\n", - "\n", - "def swath_row(instrument, time_step):\n", - " first, last = scan_time[scans5[0]], scan_time[scans5[-1]]\n", - " n = int((last - first) // time_step)\n", - " times = to_utc(first + time_step * (np.arange(n) + 0.5))\n", - " geometry = compute_ground_track(\n", - " gcomw.model_copy(update={\"instruments\": [instrument]}), times\n", - " ).geometry.iloc[0]\n", - " prepare(geometry)\n", - " predicted = np.zeros(len(grid5), dtype=bool)\n", - " predicted[compared5] = contains_xy(\n", - " geometry, lon5.ravel()[compared5], lat5.ravel()[compared5]\n", - " )\n", - " area = lambda mask: np.sum(mask * cell_area5) / 1e6\n", - " return {\n", - " \"observed (10^6 km^2)\": area(observed5),\n", - " \"TAT-C (10^6 km^2)\": area(predicted),\n", - " \"IoU\": area(observed5 & predicted) / area(observed5 | predicted),\n", - " \"observed only (%)\": 100 * area(observed5 & ~predicted) / area(observed5),\n", - " \"TAT-C only (%)\": 100 * area(predicted & ~observed5) / area(predicted),\n", - " }\n", - "\n", - "\n", - "rows5 = {\n", - " \"cone field of regard, 30 s\": swath_row(candidates[\"cone field of regard\"], 30)\n", - "}\n", - "for time_step in [1.5, 10, 30]:\n", - " width = compute_along_track_field_of_view(\n", - " gcomw.orbit.get_semimajor_axis() - EARTH_MEAN_RADIUS,\n", - " time_step,\n", - " inclination5,\n", - " eccentricity=gcomw.orbit.get_eccentricity(),\n", - " )\n", - " rows5[f\"conical instrument, {time_step:g} s ({width:.2f} deg along track)\"] = (\n", - " swath_row(\n", - " candidates[\"conical instrument\"].model_copy(\n", - " update={\"along_track_field_of_view\": width}\n", - " ),\n", - " time_step,\n", - " )\n", - " )\n", - "pd.DataFrame(rows5).T.round(3)" + "The conical instrument matches 99.95% of the observed passes (4,191 of 4,193) with only 7 extra predictions (0.2%), and its `epoch` matches the observation times to 0.02 s (median) and 0.27 s (95th percentile) everywhere in the scan." ] }, { @@ -1418,8 +1223,6 @@ "id": "8f7b30c6", "metadata": {}, "source": [ - "The conical instrument's swath matches the area AMSR2 scans over an orbit with an IoU of 0.998, and, unlike the cone field of regard (whose circles extend 3% beyond the scanned swath), with little area outside it (0.2%) and almost none of it missed (0.01%). Because its footprint is the arc swept along track by the distance the along-track field of view subtends at nadir, the result is the same for time steps from one scan (1.5 s) to 30 s. The tailoring matters: with the ground track velocity of a non-rotating Earth (as in an earlier version of this notebook), 1.2% of the scanned area was missed in gaps between consecutive footprints, because the Earth's rotation speeds up the ground track of this retrograde orbit, and 0.2% was missed while the field of view was tailored to the mean altitude rather than the satellite's lower height above the ellipsoid at low latitudes.\n", - "\n", "## Summary\n", "\n", "| Test | Result |\n", @@ -1428,11 +1231,10 @@ "| 2. Scan geometry | cone angle 47.56 deg (within 0.1 deg); scan sector 75.3 deg on either side of a center 0.5 deg left of the *inertial* velocity; arc center 844 km ahead of nadir; swath 1,627 km |\n", "| 3. Footprints | cone field of regard: correct cone, swath 58 km too wide; swath field of regard: correct width, wrong cone; pointed view: straight strip, far wider than the arc; conical instrument: the arc, swath within 3 km |\n", "| 4. Observations (`collect_observations`) | conical instrument: 99.95% of passes matched, 0.2% extra, `epoch` within 0.27 s (95th percentile); cone field of regard: 99.9% matched, 3.8% extra, `start` within 0.27 s but `epoch` 40 to 125 s late; pointed view: up to 100 s early, three times too many passes |\n", - "| 5. Swath coverage (`compute_ground_track`) | conical instrument: IoU 0.998 for time steps from 1.5 to 30 s; cone field of regard: IoU 0.970, 3% extra area |\n", "\n", "**Existing models.** Because a conical scanner observes along the forward boundary of a cone, a nadir `Instrument` whose field of regard is twice the cone angle identifies nearly every pass, and the `start` of each observation from `collect_observations` (not its `epoch`) is the time AMSR2 observes the point. It cannot represent the scan sector, so its swath is too wide, its `epoch` (used by downstream analyses such as revisit statistics) is up to two minutes late, and its footprints are full circles. A forward-pitched `PointedInstrument` cannot follow the arc and is a poor substitute.\n", "\n", - "**Conical instrument.** The `ConicalInstrument` closes these gaps. It is specified by a cone angle, a scan sector (a center azimuth and half width, so forward, aft, and full-rotation scanners can be represented), a velocity frame, and an along-track field of view. `collect_observations` reports the time a point crosses the cone within the scan sector as the observation epoch (up to two per pass: entering the cone ahead of the satellite and leaving it behind), and its footprint is the scanned arc, swept along track by the distance the along-track field of view subtends at nadir, as for the tailored fields of view of the other instruments. For AMSR2, with the measured cone angle and scan sector and the inertial velocity frame, it reproduces the observed passes, their times to within a third of a second, the swath width to within 3 km, and the scanned area at any time step tested." + "**Conical instrument.** The `ConicalInstrument` closes these gaps. It is specified by a cone angle, a scan sector (a center azimuth and half width, so forward, aft, and full-rotation scanners can be represented), a velocity frame, and an along-track field of view. `collect_observations` reports the time a point crosses the cone within the scan sector as the observation epoch (up to two per pass: entering the cone ahead of the satellite and leaving it behind), and its footprint is the scanned arc, swept along track by the distance the along-track field of view subtends at nadir, as for the tailored fields of view of the other instruments. For AMSR2, with the measured cone angle and scan sector and the inertial velocity frame, it reproduces the observed passes, their times to within a third of a second, and the swath width to within 3 km." ] } ], diff --git a/docs/validation/ValidateConicalGMI.ipynb b/docs/validation/ValidateConicalGMI.ipynb index 77cc72c6..4834d3db 100644 --- a/docs/validation/ValidateConicalGMI.ipynb +++ b/docs/validation/ValidateConicalGMI.ipynb @@ -12,13 +12,13 @@ "* **Two cones.** Its low-frequency channels (10 to 89 GHz) and high-frequency channels (166 and 183 GHz) use separate feeds that view the ground at different incidence angles (about 53 and 49 deg), so GMI is modeled as two `ConicalInstrument`s on one satellite.\n", "* **Orbit.** GPM flies a non-sun-synchronous orbit inclined 65 deg at about 440 km altitude (raised from 400 km in 2023), so the scan's cone angle, sector, and swath differ from AMSR2's, and observation times drift through the day.\n", "\n", - "The comparison asks five questions:\n", + "The comparison asks three questions:\n", "\n", "1. **Orbit.** Does TAT-C's propagation of a public two-line element (TLE) set reproduce GPM's position?\n", "2. **Scan geometry.** What cone angles, scan sectors, and orientation describe GMI's two feeds?\n", "3. **Footprints.** Do the conical instruments' footprints and swath widths match the scanned arcs?\n", - "4. **Observations.** Does `collect_observations` predict which points GMI observes in a day, and when?\n", - "5. **Swath coverage.** Do the footprints from `compute_ground_track` reproduce the area GMI scans over an orbit?" + "\n", + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of both feeds of the catalog's `gmi` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_gmi.py`; see the [instrument catalog](catalog.rst)." ] }, { @@ -448,7 +448,7 @@ "id": "bd6866c9", "metadata": {}, "source": [ - "The propagated TLE trails the reported positions by 4.2 km (median), a day or more before the TLE epoch, with across-track and radial differences below 0.5 km. At GPM's speed relative to the ground (about 7.2 km/s), TAT-C's satellite reaches each point about 0.6 s late. This offset carries into the observation times of Test 4.\n", + "The propagated TLE trails the reported positions by 4.2 km (median), a day or more before the TLE epoch, with across-track and radial differences below 0.5 km. At GPM's speed relative to the ground (about 7.2 km/s), TAT-C's satellite reaches each point about 0.6 s late. This offset carries into the observation times that TAT-C predicts.\n", "\n", "## Test 2: Scan Geometry\n", "\n", @@ -908,596 +908,7 @@ "id": "3200f2b1", "metadata": {}, "source": [ - "Both conical instruments' footprints follow their scanned arcs, and their swath widths, computed from the cone angle, scan sector, and altitude, are within 0.1 km (median) and 0.4 km (95th percentile) of the observed end-to-end distances. The model built for AMSR2 needs nothing more than the two feeds' measured parameters to describe GMI.\n", - "\n", - "## Test 4: Observations\n", - "\n", - "`collect_observations` is evaluated for the points of a Fibonacci lattice with a typical spacing of 500 km within the latitudes GMI observes (about 70 deg south to 70 deg north).\n", - "\n", - "**Observed.** For each feed, a point is observed on a pass if it lies within a quadrilateral cell of footprint centers (adjacent samples on consecutive scans) next to one of its eight nearest footprints. (Near the ends of the arc, consecutive scans overlap at a shallow angle, and the cell containing a point need not be next to its nearest footprint.) Its observation time is the time at which it crosses the feed's cone ahead of the spacecraft, computed by bisection on the reported spacecraft trajectory near the nearest scan.\n", - "\n", - "**Predicted.** Each feed's conical instrument, and for comparison a nadir `Instrument` whose field of regard is twice the feed's cone angle (whose `start` is the time a point enters that cone), as in the AMSR2 notebook. Observations are matched to observed passes of the same point within 10 minutes; predictions during data gaps are excluded." - ] - }, - { - "cell_type": "code", - "execution_count": 8, - "id": "a0b9d750", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-26T05:41:41.584908Z", - "iopub.status.busy": "2026-10-26T05:41:41.584699Z", - "iopub.status.idle": "2026-10-26T05:46:14.070326Z", - "shell.execute_reply": "2026-10-26T05:46:14.069395Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
observedpredictedmatchedobserved onlypredicted onlytime, median (s)time, p95 |x| (s)
S1 (low frequency)conical instrument, epoch3093.03092.03092.01.00.00.560.69
cone field of regard, start3093.03192.03093.00.099.00.560.69
S2 (high frequency)conical instrument, epoch2730.02731.02730.00.01.00.560.68
cone field of regard, start2730.02824.02730.00.094.00.560.68
\n", - "
" - ], - "text/plain": [ - " observed predicted matched \\\n", - "S1 (low frequency) conical instrument, epoch 3093.0 3092.0 3092.0 \n", - " cone field of regard, start 3093.0 3192.0 3093.0 \n", - "S2 (high frequency) conical instrument, epoch 2730.0 2731.0 2730.0 \n", - " cone field of regard, start 2730.0 2824.0 2730.0 \n", - "\n", - " observed only \\\n", - "S1 (low frequency) conical instrument, epoch 1.0 \n", - " cone field of regard, start 0.0 \n", - "S2 (high frequency) conical instrument, epoch 0.0 \n", - " cone field of regard, start 0.0 \n", - "\n", - " predicted only \\\n", - "S1 (low frequency) conical instrument, epoch 0.0 \n", - " cone field of regard, start 99.0 \n", - "S2 (high frequency) conical instrument, epoch 1.0 \n", - " cone field of regard, start 94.0 \n", - "\n", - " time, median (s) \\\n", - "S1 (low frequency) conical instrument, epoch 0.56 \n", - " cone field of regard, start 0.56 \n", - "S2 (high frequency) conical instrument, epoch 0.56 \n", - " cone field of regard, start 0.56 \n", - "\n", - " time, p95 |x| (s) \n", - "S1 (low frequency) conical instrument, epoch 0.69 \n", - " cone field of regard, start 0.69 \n", - "S2 (high frequency) conical instrument, epoch 0.68 \n", - " cone field of regard, start 0.68 " - ] - }, - "execution_count": 8, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "def make_in_cell(unit):\n", - " def in_cell(points, k, j):\n", - " valid_cell = (\n", - " (k >= 0) & (k < len(scan_time) - 1) & (j >= 0) & (j < N_SAMPLES - 1)\n", - " )\n", - " k, j = np.clip(k, 0, len(scan_time) - 2), np.clip(j, 0, N_SAMPLES - 2)\n", - " valid_cell &= np.diff(scan_time)[k] < 3\n", - " corners = [unit[k, j], unit[k, j + 1], unit[k + 1, j + 1], unit[k + 1, j]]\n", - " signs = np.stack(\n", - " [\n", - " np.sum(np.cross(p, q) * points, axis=-1)\n", - " for p, q in zip(corners, corners[1:] + corners[:1])\n", - " ]\n", - " )\n", - " return valid_cell & (np.all(signs >= 0, axis=0) | np.all(signs <= 0, axis=0))\n", - "\n", - " return in_cell\n", - "\n", - "\n", - "def cone_crossing(target, k, cone_angle):\n", - " \"\"\"Time (s) at which a target crosses a cone near scan k, by bisection on the reported trajectory.\"\"\"\n", - "\n", - " def angle(t):\n", - " i = int(np.clip(np.searchsorted(scan_time, t) - 1, 0, len(scan_time) - 2))\n", - " f = (t - scan_time[i]) / (scan_time[i + 1] - scan_time[i])\n", - " position = sc_pos[i] + f * (sc_pos[i + 1] - sc_pos[i])\n", - " lon, lat, _ = TO_GEODETIC.transform(*position)\n", - " return (\n", - " np.degrees(np.arccos(np.dot(normalize(target - position), -up(lon, lat))))\n", - " - cone_angle\n", - " )\n", - "\n", - " lower, upper = scan_time[k] - 6, scan_time[k] + 6\n", - " if angle(lower) * angle(upper) > 0:\n", - " return np.nan\n", - " for _ in range(30):\n", - " middle = (lower + upper) / 2\n", - " lower, upper = (middle, upper) if angle(middle) > 0 else (lower, middle)\n", - " return (lower + upper) / 2\n", - "\n", - "\n", - "points4 = generate_points_fibonacci_lattice(500e3)\n", - "points4 = points4[np.abs(points4.geometry.y) < 72].reset_index(drop=True)\n", - "point_unit = up(points4.geometry.x.to_numpy(), points4.geometry.y.to_numpy())\n", - "\n", - "\n", - "def in_gap(times):\n", - " return (\n", - " np.any(\n", - " [\n", - " (times >= pd.Timestamp(DAY) + pd.Timedelta(seconds=a))\n", - " & (times <= pd.Timestamp(DAY) + pd.Timedelta(seconds=b))\n", - " for a, b in gaps\n", - " ],\n", - " axis=0,\n", - " )\n", - " if gaps\n", - " else np.zeros(len(times), dtype=bool)\n", - " )\n", - "\n", - "\n", - "observed4, rows4, matched4 = {}, {}, {}\n", - "start4, end4 = DAY + timedelta(seconds=float(scan_time[0])), DAY + timedelta(\n", - " seconds=float(scan_time[-1])\n", - ")\n", - "for index, feed in enumerate(FEEDS):\n", - " unit = up(*foot[feed])\n", - " in_cell = make_in_cell(unit)\n", - " tree = cKDTree(unit.reshape(-1, 3))\n", - " rows = []\n", - " for p, hits in enumerate(\n", - " tree.query_ball_point(point_unit, r=2 * np.sin(40 / 6371 / 2), workers=-1)\n", - " ):\n", - " if not hits:\n", - " continue\n", - " hits = np.array(hits)\n", - " k_all = hits // N_SAMPLES\n", - " order = np.argsort(scan_time[k_all])\n", - " hits, k_all = hits[order], k_all[order]\n", - " for group in np.split(\n", - " np.arange(len(hits)), np.nonzero(np.diff(scan_time[k_all]) > 600)[0] + 1\n", - " ):\n", - " nearest = hits[group][\n", - " np.argsort(\n", - " np.linalg.norm(\n", - " unit.reshape(-1, 3)[hits[group]] - point_unit[p], axis=-1\n", - " )\n", - " )[:8]\n", - " ]\n", - " k, j = divmod(int(nearest[0]), N_SAMPLES)\n", - " if not any(\n", - " in_cell(\n", - " point_unit[[p]],\n", - " np.array([n // N_SAMPLES + dk]),\n", - " np.array([n % N_SAMPLES + dj]),\n", - " )[0]\n", - " for n in nearest\n", - " for dk in (-1, 0)\n", - " for dj in (-1, 0)\n", - " ):\n", - " continue\n", - " crossing = cone_crossing(\n", - " ecef(points4.geometry.x.iloc[p], points4.geometry.y.iloc[p]),\n", - " k,\n", - " geometry[feed][\"cone\"],\n", - " )\n", - " if np.isfinite(crossing):\n", - " rows.append(\n", - " {\n", - " \"point_id\": p,\n", - " \"time\": pd.Timestamp(DAY)\n", - " + pd.Timedelta(seconds=float(crossing)),\n", - " \"azimuth\": float(geometry[feed][\"azimuth\"][j]),\n", - " }\n", - " )\n", - " observed4[feed] = pd.DataFrame(rows).astype({\"point_id\": \"int64\"})\n", - " models = {\n", - " \"conical instrument\": (gpm, index, \"epoch\"),\n", - " \"cone field of regard\": (\n", - " gpm.model_copy(\n", - " update={\n", - " \"instruments\": [\n", - " Instrument(\n", - " name=\"cone\", field_of_regard=2 * geometry[feed][\"cone\"]\n", - " )\n", - " ]\n", - " }\n", - " ),\n", - " 0,\n", - " \"start\",\n", - " ),\n", - " }\n", - " for model, (satellite, instrument_index, column) in models.items():\n", - " predicted = pd.concat(\n", - " [\n", - " collect_observations(\n", - " Point(latitude=g.y, longitude=g.x),\n", - " satellite,\n", - " start4,\n", - " end4,\n", - " instrument_index,\n", - " ).assign(point_id=p)\n", - " for p, g in enumerate(points4.geometry)\n", - " ]\n", - " ).reset_index(drop=True)\n", - " predicted[\"point_id\"] = predicted.point_id.astype(\"int64\")\n", - " predicted = predicted[~in_gap(predicted.epoch)]\n", - " merged = pd.merge_asof(\n", - " observed4[feed].sort_values(\"time\"),\n", - " predicted[[\"point_id\", column]]\n", - " .rename(columns={column: \"predicted\"})\n", - " .sort_values(\"predicted\"),\n", - " left_on=\"time\",\n", - " right_on=\"predicted\",\n", - " by=\"point_id\",\n", - " direction=\"nearest\",\n", - " tolerance=pd.Timedelta(minutes=10),\n", - " )\n", - " hit = merged.predicted.notna()\n", - " dt = (merged.predicted - merged.time).dt.total_seconds()\n", - " matched4[(feed, model)] = merged\n", - " rows4[(f\"{feed} ({FEEDS[feed]})\", f\"{model}, {column}\")] = {\n", - " \"observed\": len(observed4[feed]),\n", - " \"predicted\": len(predicted),\n", - " \"matched\": int(hit.sum()),\n", - " \"observed only\": int((~hit).sum()),\n", - " \"predicted only\": len(predicted) - int(hit.sum()),\n", - " \"time, median (s)\": np.median(dt[hit]),\n", - " \"time, p95 |x| (s)\": np.percentile(np.abs(dt[hit]), 95),\n", - " }\n", - "pd.DataFrame(rows4).T.round(2)" - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "id": "134640f7", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-26T05:46:14.072344Z", - "iopub.status.busy": "2026-10-26T05:46:14.072174Z", - "iopub.status.idle": "2026-10-26T05:46:14.302757Z", - "shell.execute_reply": "2026-10-26T05:46:14.301824Z" - } - }, - "outputs": [ - { - "data": { - "image/png": "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b9WqVXLq1Cm54YYbpFevXvqxZcOGDdKzZ0956623ilUfQgghhBByAQtZpMnCEP4777wjMTExOpQ/YsQIl1wJHPHyyy9L165dNR8sshV8+umn0r59ey3TwieffKLWVghZQgghhBBCijQhQuvWrVXEInPA008/LT/99JPmjB0yZIgsWrRI3AUZC7Zu3ar5YDFLFyY3WLZsmbocWOjevbsKXWdA4Hbp0sXtfRNCCCGEEO/GYHbFobUA9uzZI7fccov6rRazqDIDwV4RERGSmJjIYK/z0Mm8eLD92H7lDfsg24/9z7vhNVxGPrIW9u7dKzNnzlR3gMDAQIfprQghhBBCCPEIIZuamirffPONzJgxQy2wAwcOlM8//1x69+7tMFsAIYQQQgghHiFkq1evrhMWjBw5UsWsZTKD+Pj4POsVNfiLEEIIIYSQUhGymKwAH7gRFORK4C2+soQQQgghpIII2SVLlpReTQghhBBCCCktIXvFFVe4szohhBBCCCGel7XAQkJCgvVvBHwhrRUhhBBCSEXh448/ltDQULnpppvKuyoVDrcmRNi3b1++k4SAL8unUqVKOgsXIYQQQkhmZqa8+eabMmDAALn11ltl6dKledwVMcU8Ps8//3y5C9Evv/yyyNsfOHBADh8+XCplT506VebOnSuezNRyrKNbFtm33npLLrvssnzLf/jhB/1/xYoV8v777+t0s4QQQgip2Dz++OPyxx9/yJNPPinZ2dnyyiuv6P99+vTR2UKfe+451RA7duwo13rCddLX19cjy96/f7+kpKSIJ7O/HOvoVsti+lhMI2sP3rQApprt0aNHydWOEEIIIW6D7EFpWaWfQSjIz1BgHvlVq1ZplqPrrrtOvw8fPlySk5P172rVquln27ZtEhsb6/a+58yZI/PmzdNtL7roIvnoo4/0uGEdXLx4sY4S33///dKuXTtd/7333lP3R4hm7POaa66Re++9V3/77bff8rgGOCobVlVYVyFK69evL4888og0bdq00Hrall1QHfbu3SdPPPmsHDp0SHJycuTFF1+UoKAgtXT6+/vLTz/9JKNGjbLOSooydu7cKfPnz5cpU6ZI+/bt5corr9Sy3n77ba3j9ddfr/vExFWYiXX79u1aD1jBJ06cKHFxcTJ27FjrdpZjx8sFXjgGDx6s56yg9tu4cWO+Oo4YMUI8UsiicevU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2mtl6dKlcuONN0q1atVk1qxZemyYpvbiiy+2WoLBO++8I1dffbX88ccfOhvbrbfeKqmpqfLZZ5/plMGW8+8xFlnMuQtTOhphxIgR1uVff/21dOjQoSTrRwghhJAikppp0o/tbPSZ2WZdlpltcriuyfTfulk5uetmZOVf1xWaNWumvpunTp3S72FhYVKnTp1in0/4m3bp0kX27dsnERERWi745ptv5JprrlGxDOEHwYVp6QG+Q2DB+puYmKiWzF27dlndJCG2IHIh+mBxhXi0B5ZXWGD9/f1VBOIDMe1uORCLQ4cOVWEPq/X333/v9FidHZN9XXwdTOeL9W+55RY95uDgYF32/PPPy6RJkyQrK0vdOyCkLW109913y+uvv67f77nnHl0PxwGwL+wHLhVYx1bIz5w5UwYPHqzWdewH/Q3t+8MPP+iLRmkKWU5RSwghhFygdJy4W///45nGUjk095E/6494eWdxnAzqWEmevyHGum6PF/dIWpZZFj/eUGpG+uuyr9aclZd/jpVr24TLK8NqWte96pV9surZi1wawUWKzoEDB0p8fLwGir/44osqPosDRn8//PBDFYO2wBcXVsp+/frpd1gVv/zySxVlAMHpsBCD5ORkWbZsmTRt2lQmTJggbdu21TgfCDVYUWfPnp3PONe4cWO57rrrVCBahBzEoAVXy3nllVfk888/twbOd+3a1emxFnRM19nVxRG9e/fW7S3HDF9VWK/T0tKkcuXKunz58uXSo0cPmTt3rvrd4vwkJCSopdsCLK4Q1QcPHpQ2bdqo+Lb1e3300Uetxk1YmyGG4XIKq+1ff/1V4DGWuUUWZuWCPu6SmZmpby+2b4yFAVM13mQIIYQQ4pnAiododQiaLVu2qLgpiTSdGE63dQuwABHWqlUr63dYL23z21900X/iGyLOYok8cOCADp9brKwQmLAouour5djX0/Zvd4+pMOC+YVsWLLlwJbDUETFPcEnAHAE1atSwvmTgt1q1alldDmAB//nnn9Xyi7azuIg420/Lli2trgcFHV+5WGS//fbbPN9xgHv37tU3jIceesjlcrDdY489JlOnTtU3FzQefGXw5uaMdevWyfjx41Xdw/8EjYk3M5wIQgghhPzH+km5/plBfrmCAtzevYqMuLSy+NqZsn4/b2EN9P1v3eFdImVwp0ri898iZfHjjVxqZvhM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", - "text/plain": [ - "
" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "fig, ax = plt.subplots(figsize=(7, 3.6))\n", - "edges4 = np.arange(-72, 73, 4)\n", - "for (feed, model), merged in matched4.items():\n", - " hit = merged.predicted.notna()\n", - " q = binned(\n", - " merged.azimuth[hit].to_numpy(),\n", - " (merged.predicted - merged.time).dt.total_seconds()[hit].to_numpy(),\n", - " edges4,\n", - " )\n", - " ax.plot(\n", - " (edges4[:-1] + edges4[1:]) / 2,\n", - " q[:, 1],\n", - " color=FEED_COLORS[feed],\n", - " ls=\"-\" if model == \"conical instrument\" else \":\",\n", - " label=f\"{feed}, {model}\",\n", - " )\n", - "ax.axhline(0, color=GRAY, lw=0.8)\n", - "ax.set(\n", - " xlabel=\"Scan azimuth of the observation (deg, positive left)\",\n", - " ylabel=\"TAT-C minus GMI (s)\",\n", - " title=\"Observation time by position in the scan\",\n", - ")\n", - "ax.legend(frameon=False, fontsize=8)\n", - "fig.tight_layout()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "id": "9c236088", - "metadata": {}, - "source": [ - "The conical instruments predict all but one of the passes observed by the low-frequency feed (3,092 of 3,093) and every pass observed by the high-frequency feed (2,730), with a single extra prediction. Their epochs follow the observation times by 0.56 s (median) and by no more than 0.69 s (95th percentile), uniformly across the scan. The offset is the orbit's: TAT-C's satellite trails GPM by 4.2 km (Test 1), or about 0.6 s, so the times are otherwise consistent to about 0.1 s.\n", - "\n", - "This test exposed an error in the access periods within which `collect_observations` searches for cone crossings. Over a full day, Skyfield's `find_events` returned some rise and set times several seconds late, and passes whose cone crossing came within a few seconds of the start of the access period were missed (about 1.5% of the passes, mostly near GPM's northernmost latitudes). TAT-C now refines rise and set times to within a millisecond.\n", - "\n", - "The cone field of regard, with twice the cone angle, matches every observed pass but predicts 3.3% more passes than were observed: its circle extends beyond the scan sector at the swath edges. Its `start`, the time a point enters the cone, matches the observation times as closely as the conical instrument's epoch (0.56 s median, from the orbit offset, and 0.69 s at the 95th percentile).\n", - "\n", - "## Test 5: Swath Coverage\n", - "\n", - "Over one orbit (starting at 12:00 UTC), the area scanned by each feed (the union of quadrilaterals of footprint centers on consecutive scans, tested as in Test 4) is compared with the union of its conical instrument's footprints from `compute_ground_track`, at time steps of 1.875 s (one scan), 10 s, and 30 s, with the along-track field of view tailored to each time step with `compute_along_track_field_of_view` (the angle subtended at nadir by the distance the ground track advances, relative to the rotating Earth, at its fastest over the orbit and at perigee, in one time step), on a 0.1 deg grid. As in the other notebooks, the comparison is limited to grid cells within 300 km of a footprint scanned at least 60 s after the start and before the end of the orbit." - ] - }, - { - "cell_type": "code", - "execution_count": 10, - "id": "62567c06", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-26T05:46:14.305310Z", - "iopub.status.busy": "2026-10-26T05:46:14.305062Z", - "iopub.status.idle": "2026-10-26T05:56:55.875159Z", - "shell.execute_reply": "2026-10-26T05:56:55.874116Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
observed (10^6 km^2)TAT-C (10^6 km^2)IoUobserved only (%)TAT-C only (%)
S1 (low frequency)1.875 s (1.78 deg along track)38.52038.5221.0000.0210.026
10 s (9.45 deg along track)38.52038.5250.9990.0200.032
30 s (27.85 deg along track)38.52038.5570.9990.0090.104
S2 (high frequency)1.875 s (1.78 deg along track)34.12334.1260.9990.0230.032
10 s (9.45 deg along track)34.12334.1290.9990.0190.037
30 s (27.85 deg along track)34.12334.1550.9990.0100.103
\n", - "
" - ], - "text/plain": [ - " observed (10^6 km^2) \\\n", - "S1 (low frequency) 1.875 s (1.78 deg along track) 38.520 \n", - " 10 s (9.45 deg along track) 38.520 \n", - " 30 s (27.85 deg along track) 38.520 \n", - "S2 (high frequency) 1.875 s (1.78 deg along track) 34.123 \n", - " 10 s (9.45 deg along track) 34.123 \n", - " 30 s (27.85 deg along track) 34.123 \n", - "\n", - " TAT-C (10^6 km^2) IoU \\\n", - "S1 (low frequency) 1.875 s (1.78 deg along track) 38.522 1.000 \n", - " 10 s (9.45 deg along track) 38.525 0.999 \n", - " 30 s (27.85 deg along track) 38.557 0.999 \n", - "S2 (high frequency) 1.875 s (1.78 deg along track) 34.126 0.999 \n", - " 10 s (9.45 deg along track) 34.129 0.999 \n", - " 30 s (27.85 deg along track) 34.155 0.999 \n", - "\n", - " observed only (%) \\\n", - "S1 (low frequency) 1.875 s (1.78 deg along track) 0.021 \n", - " 10 s (9.45 deg along track) 0.020 \n", - " 30 s (27.85 deg along track) 0.009 \n", - "S2 (high frequency) 1.875 s (1.78 deg along track) 0.023 \n", - " 10 s (9.45 deg along track) 0.019 \n", - " 30 s (27.85 deg along track) 0.010 \n", - "\n", - " TAT-C only (%) \n", - "S1 (low frequency) 1.875 s (1.78 deg along track) 0.026 \n", - " 10 s (9.45 deg along track) 0.032 \n", - " 30 s (27.85 deg along track) 0.104 \n", - "S2 (high frequency) 1.875 s (1.78 deg along track) 0.032 \n", - " 10 s (9.45 deg along track) 0.037 \n", - " 30 s (27.85 deg along track) 0.103 " - ] - }, - "execution_count": 10, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "orbit_start = 12 * 3600\n", - "orbit_period = 86400 / float(TLE[1][52:63])\n", - "scans5 = np.nonzero(\n", - " (scan_time >= orbit_start) & (scan_time < orbit_start + orbit_period)\n", - ")[0]\n", - "STEP5, MARGIN5 = 0.1, 60 # deg, s\n", - "lon5, lat5 = np.meshgrid(\n", - " np.arange(-180 + STEP5 / 2, 180, STEP5), np.arange(-90 + STEP5 / 2, 90, STEP5)\n", - ")\n", - "cell_area5 = (np.cos(np.radians(lat5)) * (STEP5 * 111.32) ** 2).ravel()\n", - "grid5 = up(lon5.ravel(), lat5.ravel())\n", - "inclination5 = float(TLE[1][8:16])\n", - "altitude5 = float(np.median(gmi[\"sc_alt\"])) * 1e3\n", - "rows5 = {}\n", - "for feed in FEEDS:\n", - " unit = up(*foot[feed])\n", - " in_cell = make_in_cell(unit)\n", - " tree5 = cKDTree(unit[scans5].reshape(-1, 3))\n", - " distance5, nearest5 = tree5.query(grid5, workers=-1)\n", - " nearest_time5 = scan_time[scans5][nearest5 // N_SAMPLES] - scan_time[scans5[0]]\n", - " duration5 = scan_time[scans5[-1]] - scan_time[scans5[0]]\n", - " compared5 = (\n", - " (distance5 < 2 * np.sin(300 / 6371 / 2))\n", - " & (nearest_time5 > MARGIN5)\n", - " & (nearest_time5 < duration5 - MARGIN5)\n", - " )\n", - " observed5 = np.zeros(len(grid5), dtype=bool)\n", - " _, nearest_eight = tree5.query(grid5[compared5], k=8, workers=-1)\n", - " for column in range(8):\n", - " k, j = np.divmod(nearest_eight[:, column], N_SAMPLES)\n", - " k = scans5[k]\n", - " inside = np.zeros(len(k), dtype=bool)\n", - " for dk in (-1, 0):\n", - " for dj in (-1, 0):\n", - " inside |= in_cell(grid5[compared5], k + dk, j + dj)\n", - " observed5[np.flatnonzero(compared5)] |= inside\n", - " for time_step in [1.875, 10, 30]:\n", - " width = compute_along_track_field_of_view(\n", - " gpm.orbit.get_semimajor_axis() - EARTH_MEAN_RADIUS,\n", - " time_step,\n", - " inclination5,\n", - " eccentricity=gpm.orbit.get_eccentricity(),\n", - " )\n", - " first, last = scan_time[scans5[0]], scan_time[scans5[-1]]\n", - " times = to_utc(\n", - " first + time_step * (np.arange(int((last - first) // time_step)) + 0.5)\n", - " )\n", - " instrument = instruments[feed].model_copy(\n", - " update={\"along_track_field_of_view\": width}\n", - " )\n", - " geometry5 = compute_ground_track(\n", - " gpm.model_copy(update={\"instruments\": [instrument]}), times\n", - " ).geometry.iloc[0]\n", - " prepare(geometry5)\n", - " predicted = np.zeros(len(grid5), dtype=bool)\n", - " predicted[compared5] = contains_xy(\n", - " geometry5, lon5.ravel()[compared5], lat5.ravel()[compared5]\n", - " )\n", - " area = lambda mask: np.sum(mask * cell_area5) / 1e6\n", - " rows5[\n", - " (\n", - " f\"{feed} ({FEEDS[feed]})\",\n", - " f\"{time_step:g} s ({width:.2f} deg along track)\",\n", - " )\n", - " ] = {\n", - " \"observed (10^6 km^2)\": area(observed5),\n", - " \"TAT-C (10^6 km^2)\": area(predicted),\n", - " \"IoU\": area(observed5 & predicted) / area(observed5 | predicted),\n", - " \"observed only (%)\": 100 * area(observed5 & ~predicted) / area(observed5),\n", - " \"TAT-C only (%)\": 100 * area(predicted & ~observed5) / area(predicted),\n", - " }\n", - "pd.DataFrame(rows5).T.round(3)" + "Both conical instruments' footprints follow their scanned arcs, and their swath widths, computed from the cone angle, scan sector, and altitude, are within 0.1 km (median) and 0.4 km (95th percentile) of the observed end-to-end distances. The model built for AMSR2 needs nothing more than the two feeds' measured parameters to describe GMI." ] }, { @@ -1505,8 +916,6 @@ "id": "6041d735", "metadata": {}, "source": [ - "Each conical instrument's swath matches the area its feed scans over an orbit with an IoU of 0.999 or better at every time step: less than 0.03% of the scanned area lies outside the TAT-C swath, and at most 0.1% of the TAT-C swath lies outside the scanned area (at the 30 s step, where the footprints are longest). Unlike for AMSR2, no gaps between consecutive footprints are apparent.\n", - "\n", "## Summary\n", "\n", "| Test | Result |\n", @@ -1514,12 +923,10 @@ "| 1. Orbit (CelesTrak TLE vs. reported position) | 4.2 km behind along track (median), within 0.5 km across track and radially, a day or more before the TLE epoch |\n", "| 2. Scan geometry | constant cone angles of 48.46 deg (low frequency) and 45.28 deg (high frequency); both scan 76.0 deg on either side of a center 0.3 deg right of the *inertial* velocity; arcs 522 and 462 km ahead of nadir; swaths 1,012 and 897 km |\n", "| 3. Footprints | conical instrument footprints follow both arcs; swath width within 0.1 km (median) and 0.4 km (95th percentile) |\n", - "| 4. Observations (`collect_observations`) | conical instruments: 99.97 and 100% of passes matched, one extra, `epoch` 0.56 s late (the orbit offset) and within 0.69 s (95th percentile); cone field of regard: all passes matched, 3.3% extra |\n", - "| 5. Swath coverage (`compute_ground_track`) | IoU of 0.999 or better for both feeds at time steps from 1.875 to 30 s |\n", "\n", - "**Generality of the conical instrument.** The `ConicalInstrument` was developed against AMSR2; GMI tests it on a different orbit (non-sun-synchronous, 65 deg inclination, 440 km altitude) and with two feeds. Two conical instruments on one satellite, each with its measured cone angle and the common scan sector, in the inertial velocity frame, reproduce the observed passes, their times to within the orbit error, the swath widths to within half a kilometer, and the scanned areas at any time step tested. No change to the model was needed.\n", + "**Generality of the conical instrument.** The `ConicalInstrument` was developed against AMSR2; GMI tests it on a different orbit (non-sun-synchronous, 65 deg inclination, 440 km altitude) and with two feeds. Two conical instruments on one satellite, each with its measured cone angle and the common scan sector, in the inertial velocity frame, reproduce the scanned arcs and the swath widths to within half a kilometer. No change to the model was needed.\n", "\n", - "**Access periods.** The comparison of observation times found that the rise and set times from Skyfield's `find_events`, which bound the access periods of `collect_observations` for every instrument, could be several seconds in error over long analysis periods. They are now refined to within a millisecond. The error mattered most for conical instruments, whose cone crossings lie close to the start of the access period." + "**Access periods.** An earlier version of this notebook, comparing GMI's observation times over a day, found that the rise and set times from Skyfield's `find_events`, which bound the access periods of `collect_observations` for every instrument, could be several seconds in error over long analysis periods; about 1.5% of the passes (mostly near GPM's northernmost latitudes) were missed. They are now refined to within a millisecond. The error mattered most for conical instruments, whose cone crossings lie close to the start of the access period." ] } ], diff --git a/docs/validation/ValidateDriftMODIS.ipynb b/docs/validation/ValidateDriftMODIS.ipynb index 544c75f2..fbfc8234 100644 --- a/docs/validation/ValidateDriftMODIS.ipynb +++ b/docs/validation/ValidateDriftMODIS.ipynb @@ -14,7 +14,8 @@ "1. **Orbit.** Does TAT-C's propagation of the TLE reproduce Terra's position?\n", "2. **Local time drift.** Does a TLE reproduce the drift of Terra's local time, and over what period?\n", "3. **Scan geometry.** What are MODIS's scan angles, velocity frame, and along-track extent, and does a scan-geometry view reproduce its pixels and scan footprints?\n", - "4. **Daily observations.** Does `collect_observations` predict which points MODIS observes in a day, and when?" + "\n", + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `modis` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_modis.py`; see the [instrument catalog](catalog.rst)." ] }, { @@ -1267,171 +1268,7 @@ "id": "d0a1d00b", "metadata": {}, "source": [ - "With Terra's reported position and velocity, the scan-geometry `PointedInstrument` places the first and last detectors within 1.5 km of the reported pixels at nadir (median), 2.9 km at the left edge, and 5.3 km at the right edge, where the scan starts; the differences at the edges come from the scan's duration (about 1.5 km) and a roll offset of 0.05 deg, which TAT-C does not model. Its scan footprints have the observed along-track length: 9.9 km at nadir and 19.8 km at the edges (19.9 km observed), twice the nadir length (the bow tie effect), whereas a frame-geometry view would give 16.9 km at the edges.\n", - "\n", - "## Test 4: Daily Observations\n", - "\n", - "The points of interest are those of a Fibonacci lattice with a typical spacing of 500 km. For each point and each MODIS pass over it, the observation time is the time of the scan through the point, interpolated between the centers of consecutive scans (midway between their first and last detectors, to which the scan times refer) at the nearest sampled pixel (within 30 km, excluding the outermost sampled frames). `collect_observations` predicts the observations of the MODIS `PointedInstrument` above with the TLE orbit over the same day." - ] - }, - { - "cell_type": "code", - "execution_count": 8, - "id": "97737e50", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T15:24:30.059344Z", - "iopub.status.busy": "2026-10-25T15:24:30.059344Z", - "iopub.status.idle": "2026-10-25T15:25:08.420263Z", - "shell.execute_reply": "2026-10-25T15:25:08.420263Z" - } - }, - "outputs": [ - { - "data": { - "text/plain": [ - "points 2598.00\n", - "points observed by MODIS 2568.00\n", - "points observed by TAT-C 2572.00\n", - "MODIS observations 6826.00\n", - "matched by TAT-C (%) 99.63\n", - "time difference, median (s) 0.22\n", - "time difference, 95th percentile (s) 0.60\n", - "time difference, max (s) 0.94\n", - "TAT-C observations 6867.00\n", - "found in MODIS data (%) 99.04\n", - "dtype: float64" - ] - }, - "execution_count": 8, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "lattice = generate_points_fibonacci_lattice(500e3)\n", - "points = [\n", - " Point(id=i, latitude=r.geometry.y, longitude=r.geometry.x)\n", - " for i, r in enumerate(lattice.itertuples())\n", - "]\n", - "pixel_xyz, pixel_index = [], []\n", - "for gi, g in enumerate(granules):\n", - " for r in range(0, len(g[\"rows\"]), 2):\n", - " scan = r // 2\n", - " if not g[\"valid\"][scan]:\n", - " continue\n", - " valid = np.isfinite(g[\"latitude\"][r])\n", - " xyz = wgs84.latlon(\n", - " g[\"latitude\"][r][valid], g[\"longitude\"][r][valid], g[\"height\"][r][valid]\n", - " ).itrs_xyz.m.T\n", - " pixel_xyz.append(xyz)\n", - " pixel_index.append(\n", - " np.column_stack(\n", - " [\n", - " np.full(valid.sum(), gi),\n", - " np.full(valid.sum(), scan),\n", - " np.nonzero(valid)[0],\n", - " ]\n", - " )\n", - " )\n", - "pixel_xyz, pixel_index = np.concatenate(pixel_xyz), np.concatenate(pixel_index)\n", - "tree = cKDTree(pixel_xyz)\n", - "reference = []\n", - "for point in points:\n", - " xyz = np.array(wgs84.latlon(point.latitude, point.longitude).itrs_xyz.m)\n", - " nearby = tree.query_ball_point(xyz, 30e3)\n", - " if not nearby:\n", - " continue\n", - " candidates = pd.DataFrame(\n", - " pixel_index[nearby], columns=[\"granule\", \"scan\", \"column\"]\n", - " ).assign(distance=np.linalg.norm(pixel_xyz[nearby] - xyz, axis=1))\n", - " candidates[\"time\"] = [\n", - " scan_times(granules[g], [s]).utc_datetime()[0]\n", - " for g, s in zip(candidates.granule, candidates.scan)\n", - " ]\n", - " candidates = candidates.sort_values(\"time\")\n", - " for _, group in candidates.groupby(\n", - " (candidates.time.diff().dt.total_seconds() > 600).cumsum()\n", - " ):\n", - " best = group.loc[group.distance.idxmin()]\n", - " g, s, c = granules[int(best.granule)], int(best.scan), int(best.column)\n", - " if c in (0, len(g[\"frames\"]) - 1):\n", - " continue\n", - " s0, s1 = (s, s + 1) if s + 1 < len(g[\"ev_center_time\"]) else (s - 1, s)\n", - " # the scan centers (midway between the first and last detectors), to which the scan times refer\n", - " x0, x1 = (\n", - " np.mean(\n", - " [\n", - " wgs84.latlon(g[\"latitude\"][r, c], g[\"longitude\"][r, c]).itrs_xyz.m\n", - " for r in (2 * k, 2 * k + 1)\n", - " ],\n", - " axis=0,\n", - " )\n", - " for k in (s0, s1)\n", - " )\n", - " fraction = float(np.dot(xyz - x0, x1 - x0) / np.dot(x1 - x0, x1 - x0))\n", - " t0, t1 = (scan_times(g, [k]).utc_datetime()[0] for k in (s0, s1))\n", - " reference.append(\n", - " {\n", - " \"point_id\": point.id,\n", - " \"latitude\": point.latitude,\n", - " \"time\": pd.Timestamp(t0)\n", - " + (pd.Timestamp(t1) - pd.Timestamp(t0)) * fraction,\n", - " \"frame\": int(g[\"frames\"][c]),\n", - " }\n", - " )\n", - "reference = pd.DataFrame(reference)\n", - "\n", - "\n", - "def observe(point):\n", - " return collect_observations(point, terra, DAY, DAY + timedelta(days=1)).assign(\n", - " point_id=point.id\n", - " )\n", - "\n", - "\n", - "predicted = pd.concat(\n", - " [\n", - " f\n", - " for f in Parallel(n_jobs=-1)(delayed(observe)(point) for point in points)\n", - " if not f.empty\n", - " ]\n", - ")\n", - "merged = pd.merge_asof(\n", - " reference.sort_values(\"time\"),\n", - " predicted[[\"point_id\", \"epoch\"]].sort_values(\"epoch\"),\n", - " left_on=\"time\",\n", - " right_on=\"epoch\",\n", - " by=\"point_id\",\n", - " direction=\"nearest\",\n", - " tolerance=pd.Timedelta(minutes=3),\n", - ")\n", - "merged[\"difference (s)\"] = (merged.epoch - merged.time).dt.total_seconds()\n", - "found = pd.merge_asof(\n", - " predicted.sort_values(\"epoch\"),\n", - " reference[[\"point_id\", \"time\"]].sort_values(\"time\"),\n", - " left_on=\"epoch\",\n", - " right_on=\"time\",\n", - " by=\"point_id\",\n", - " direction=\"nearest\",\n", - " tolerance=pd.Timedelta(minutes=3),\n", - ")\n", - "covered = reference.point_id.nunique()\n", - "pd.Series(\n", - " {\n", - " \"points\": len(points),\n", - " \"points observed by MODIS\": covered,\n", - " \"points observed by TAT-C\": predicted.point_id.nunique(),\n", - " \"MODIS observations\": len(reference),\n", - " \"matched by TAT-C (%)\": 100 * merged.epoch.notna().mean(),\n", - " \"time difference, median (s)\": merged[\"difference (s)\"].abs().median(),\n", - " \"time difference, 95th percentile (s)\": merged[\"difference (s)\"]\n", - " .abs()\n", - " .quantile(0.95),\n", - " \"time difference, max (s)\": merged[\"difference (s)\"].abs().max(),\n", - " \"TAT-C observations\": len(predicted),\n", - " \"found in MODIS data (%)\": 100 * found.time.notna().mean(),\n", - " }\n", - ").round(2)" + "With Terra's reported position and velocity, the scan-geometry `PointedInstrument` places the first and last detectors within 1.5 km of the reported pixels at nadir (median), 2.9 km at the left edge, and 5.3 km at the right edge, where the scan starts; the differences at the edges come from the scan's duration (about 1.5 km) and a roll offset of 0.05 deg, which TAT-C does not model. Its scan footprints have the observed along-track length: 9.9 km at nadir and 19.8 km at the edges (19.9 km observed), twice the nadir length (the bow tie effect), whereas a frame-geometry view would give 16.9 km at the edges." ] }, { @@ -1439,8 +1276,6 @@ "id": "c6797454", "metadata": {}, "source": [ - "`collect_observations` predicts MODIS's observations: 99.6% of the 6,826 passes over the points are matched by a predicted observation, within 0.22 s (median) and 0.94 s (maximum), and 99.0% of the predicted observations are found in the MODIS data. The remaining differences are at the swath edges, where the sampled pixels are sparse, and at the ends of the day. MODIS observes 99% of the points in a day (2,568 of 2,598); the others lie in the gaps between adjacent swaths near the equator, which TAT-C also predicts (2,572 points observed).\n", - "\n", "## Summary\n", "\n", "| Test | Result |\n", @@ -1448,7 +1283,6 @@ "| 1. Orbit (TLE) | within 1.0 km along track (95th percentile) two days before the TLE epoch; within 0.35 km across track and radially |\n", "| 2. Local time drift | a single TLE reproduces the current drift (39.5 vs. 37.3 minutes per year) and local times within 0.3 minutes over three months, but departs by 4.4 minutes after one year and an hour after four years, as SGP4 keeps the inclination constant |\n", "| 3. Scan geometry (`ViewGeometry.SCAN`, inertial `Attitude`) | scan angles 0.0812 deg per frame; scans perpendicular to the inertial velocity; constant along-track extent (0.731 deg between the first and last detectors); pixels within 1.5 km at nadir and 3 to 5 km at the edges; scan footprints 9.9 km long at nadir and 19.8 km at the edges (19.9 km observed) |\n", - "| 4. Daily observations (`collect_observations`) | 99.6% of passes matched, within 0.22 s (median); 99.0% of predicted observations found |\n", "\n", "**Scan geometry.** A `PointedInstrument` in scan geometry with the inertial velocity frame reproduces MODIS's scans, including their growth along track toward the swath edges, confirming the VIIRS validation for a second scanner and a spacecraft without yaw steering.\n", "\n", diff --git a/docs/validation/ValidateImagerATMS.ipynb b/docs/validation/ValidateImagerATMS.ipynb index bf4cceb4..dd4dfb56 100644 --- a/docs/validation/ValidateImagerATMS.ipynb +++ b/docs/validation/ValidateImagerATMS.ipynb @@ -14,14 +14,15 @@ "* an `Instrument` with a **field of regard**, the cone of view angles from nadir within which a point can be observed. Its instantaneous footprint is a circle, and its swath is the band that circle traces.\n", "* a `PointedInstrument` with cross-track and along-track **fields of view**, a rectangular (or elliptical) view that can be divided into a grid of pixels.\n", "\n", - "TAT-C does not model the scan mechanism. Every pixel in a view is observed at the same instant, and the along-track field of view stands in for the time the instrument takes to sweep the ground: tailored to an analysis time step, consecutive views tile the swath. The comparison asks six questions:\n", + "TAT-C does not model the scan mechanism. Every pixel in a view is observed at the same instant, and the along-track field of view stands in for the time the instrument takes to sweep the ground: tailored to an analysis time step, consecutive views tile the swath. The comparison asks five questions:\n", "\n", "1. **Orbit.** Does TAT-C's propagation of the operational two-line element (TLE) set reproduce NOAA-20's position?\n", "2. **Scan geometry.** Which view angles and which along-track reference direction reproduce ATMS's actual scan?\n", "3. **Beam geolocation.** How closely do TAT-C's pixel positions (`collect_ground_pixels`) match ATMS's beam centers, and how much of the difference comes from scan timing, which TAT-C does not model?\n", - "4. **Swath.** Does TAT-C's swath (`compute_ground_track`) match the area ATMS samples, for time steps from one scan to two minutes?\n", - "5. **Daily observations.** Does `collect_observations` predict which points ATMS observes in a day, when, and at what elevation angle?\n", - "6. **Footprint size.** How large are ATMS footprints (its horizontal resolution), and how do they grow toward the swath edge?\n", + "4. **Swath width.** Does the field of regard reproduce the ATMS swath width (`field_of_regard_to_swath_width`)?\n", + "5. **Footprint size.** How large are ATMS footprints (its horizontal resolution), and how do they grow toward the swath edge?\n", + "\n", + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `atms` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_atms.py`; see the [instrument catalog](catalog.rst).\n", "\n", "A companion notebook, [Imager Validation: NOAA-20 VIIRS](ValidateImagerVIIRS.ipynb), repeats the exercise for a visible and infrared imager on the same spacecraft, and [Imager Validation: NOAA-20 CrIS](ValidateImagerCrIS.ipynb) for an infrared sounder." ] @@ -1100,9 +1101,7 @@ "id": "dca9312f", "metadata": {}, "source": [ - "## Test 4: Swath\n", - "\n", - "### Swath Width\n", + "## Test 4: Swath Width\n", "\n", "For a nadir `Instrument`, TAT-C converts the field of regard to a swath width with `field_of_regard_to_swath_width`, assuming a spherical Earth with the mean radius and the satellite's geodetic altitude. `collect_observations` first bounds its access periods with the minimum elevation angle at which a point is visible from a conservative altitude (the orbit's apogee radius minus the mean radius), relaxed by 1 deg, and then refines them to the field of regard. For comparison, the swath width of that elevation angle (without the relaxation) applied at the actual altitude, as an earlier version of `collect_observations` did, is computed with `compute_min_elevation_angle` and `compute_field_of_regard` (labeled `collect_observations` below). The observed swath width is the distance along the surface from the left to the right edge beam, through the intermediate beams." ] @@ -1266,629 +1265,7 @@ "id": "df09145f", "metadata": {}, "source": [ - "NOAA-20's geodetic altitude varies by about 30 km over an orbit, mostly because of Earth's oblateness, so the swath width varies by about 100 km, from about 2,530 km near the equator to about 2,630 km at high southern latitudes. TAT-C's nominal field of regard reproduces this variation but is about 11 km too narrow (median); the measured field of regard (Test 2) agrees to within about 2 km (median; 3.5 km at the 95th percentile). The swath of the elevation angle at the apogee altitude departs from the field of regard by up to about 30 km: the geodetic altitude exceeds the \"conservative\" apogee altitude at middle and high latitudes, where the elevation threshold is too strict. This is why `collect_observations` relaxes it and refines its access periods to the field of regard.\n", - "\n", - "### Swath Area\n", - "\n", - "Over one orbit (starting at 12:00 UTC), the area sampled by ATMS (the union of the quadrilaterals formed by adjacent beam centers on consecutive scans) is compared with the union of TAT-C footprints from `compute_ground_track`, on a 0.1 deg grid:\n", - "\n", - "* a nadir `Instrument` with the nominal field of regard, at a 60 s time step (circular footprints of 2,600 km diameter); and\n", - "* a rectangular `PointedInstrument` with the nominal field of regard as its cross-track field of view and the inertial velocity frame, at time steps of 8/3 s (one scan), 32 s (one granule), and 128 s, with the along-track field of view tailored to each time step: the angle subtended at nadir by the ground distance traveled in one time step.\n", - "\n", - "Footprints at the first and last time steps extend beyond the orbit (by up to half the 2,600 km circle for the nadir `Instrument`). To compare swaths rather than these end effects, the comparison is limited to grid cells within 300 km of a beam center sampled at least 128 s after the start and before the end of the orbit." - ] - }, - { - "cell_type": "code", - "execution_count": 10, - "id": "5f00a5ef", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T13:48:47.350168Z", - "iopub.status.busy": "2026-10-25T13:48:47.350168Z", - "iopub.status.idle": "2026-10-25T13:49:33.623537Z", - "shell.execute_reply": "2026-10-25T13:49:33.623030Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
observed (10^6 km^2)TAT-C (10^6 km^2)IoUobserved only (%)TAT-C only (%)
field of regard, 60 s98.70697.9550.9880.9880.229
rectangular, 2.67 s (1.20 deg along track)98.70698.0610.9930.6540.000
rectangular, 32 s (14.33 deg along track)98.70698.1840.9940.5510.021
rectangular, 128 s (53.39 deg along track)98.70699.2930.9890.2720.861
\n", - "
" - ], - "text/plain": [ - " observed (10^6 km^2) \\\n", - "field of regard, 60 s 98.706 \n", - "rectangular, 2.67 s (1.20 deg along track) 98.706 \n", - "rectangular, 32 s (14.33 deg along track) 98.706 \n", - "rectangular, 128 s (53.39 deg along track) 98.706 \n", - "\n", - " TAT-C (10^6 km^2) IoU \\\n", - "field of regard, 60 s 97.955 0.988 \n", - "rectangular, 2.67 s (1.20 deg along track) 98.061 0.993 \n", - "rectangular, 32 s (14.33 deg along track) 98.184 0.994 \n", - "rectangular, 128 s (53.39 deg along track) 99.293 0.989 \n", - "\n", - " observed only (%) TAT-C only (%) \n", - "field of regard, 60 s 0.988 0.229 \n", - "rectangular, 2.67 s (1.20 deg along track) 0.654 0.000 \n", - "rectangular, 32 s (14.33 deg along track) 0.551 0.021 \n", - "rectangular, 128 s (53.39 deg along track) 0.272 0.861 " - ] - }, - "execution_count": 10, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "from shapely import contains_xy, prepare\n", - "\n", - "\n", - "def unit_vector(lat, lon):\n", - " return up(lon, lat)\n", - "\n", - "\n", - "beam_unit = unit_vector(beam_lat, beam_lon)\n", - "contiguous = np.diff(atms[\"MidTime\"][good]) < 1.5 * SCAN_PERIOD * 1e6\n", - "\n", - "\n", - "def observed_cells(points, scans):\n", - " \"\"\"Whether unit vectors lie within a quadrilateral cell of adjacent beams on consecutive scans (a contiguous range of scan indices).\"\"\"\n", - " k0, k1 = scans[0], scans[-1]\n", - " cells = beam_unit[k0 : k1 + 1]\n", - " tree = cKDTree(cells.reshape(-1, 3))\n", - " _, nearest = tree.query(points, k=2, workers=-1)\n", - " inside = np.zeros(len(points), dtype=bool)\n", - " for column in range(2):\n", - " k, j = np.divmod(nearest[:, column], N_BEAMS)\n", - " for dk in (-1, 0):\n", - " for dj in (-1, 0):\n", - " kk, jj = k + dk, j + dj\n", - " valid = (\n", - " (kk >= 0) & (kk < len(cells) - 1) & (jj >= 0) & (jj < N_BEAMS - 1)\n", - " )\n", - " kk, jj = np.clip(kk, 0, len(cells) - 2), np.clip(jj, 0, N_BEAMS - 2)\n", - " valid &= contiguous[k0 + kk]\n", - " corners = [\n", - " cells[kk, jj],\n", - " cells[kk, jj + 1],\n", - " cells[kk + 1, jj + 1],\n", - " cells[kk + 1, jj],\n", - " ]\n", - " signs = np.stack(\n", - " [\n", - " np.sum(np.cross(a, b) * points, axis=-1)\n", - " for a, b in zip(corners, corners[1:] + corners[:1])\n", - " ]\n", - " )\n", - " inside |= valid & (\n", - " np.all(signs >= 0, axis=0) | np.all(signs <= 0, axis=0)\n", - " )\n", - " return inside\n", - "\n", - "\n", - "STEP4, MARGIN4 = 0.1, 128 # deg, s\n", - "lon_grid, lat_grid = np.meshgrid(\n", - " np.arange(-180 + STEP4 / 2, 180, STEP4), np.arange(-90 + STEP4 / 2, 90, STEP4)\n", - ")\n", - "cell_area = np.cos(np.radians(lat_grid)) * (STEP4 * 111.32) ** 2 # km^2\n", - "grid_unit = unit_vector(lat_grid.ravel(), lon_grid.ravel())\n", - "orbit_start = datetime(2026, 10, 2, 12, tzinfo=timezone.utc)\n", - "orbit_period = timedelta(days=1 / float(tle[1][52:63]))\n", - "scans4 = np.nonzero((t_mid >= orbit_start) & (t_mid < orbit_start + orbit_period))[0]\n", - "first, last = t_mid[scans4[0]].to_pydatetime(), t_mid[scans4[-1]].to_pydatetime()\n", - "# grid cells near beams sampled away from the ends of the orbit\n", - "distance, nearest = cKDTree(beam_unit[scans4].reshape(-1, 3)).query(\n", - " grid_unit, workers=-1\n", - ")\n", - "nearest_time = (\n", - " (t_mid[scans4] - t_mid[scans4[0]]).total_seconds().to_numpy()[nearest // N_BEAMS]\n", - ")\n", - "compared = (\n", - " (distance < 2 * np.sin(300 / 6371 / 2))\n", - " & (nearest_time > MARGIN4)\n", - " & (nearest_time < (last - first).total_seconds() - MARGIN4)\n", - ")\n", - "observed4 = np.zeros(len(grid_unit), dtype=bool)\n", - "observed4[compared] = observed_cells(grid_unit[compared], scans4)\n", - "ground_speed = (\n", - " 2 * np.pi * 6371.0088e3 / orbit_period.total_seconds()\n", - ") # m/s, approximate\n", - "altitude = float(np.median(sub4.elevation.m))\n", - "\n", - "\n", - "def swath_area_row(instrument, time_step, attitude=None):\n", - " n = int((last - first).total_seconds() // time_step)\n", - " times = [first + timedelta(seconds=time_step * (i + 0.5)) for i in range(n)]\n", - " geometry = compute_ground_track(\n", - " on_noaa20(instrument, attitude), times\n", - " ).geometry.iloc[0]\n", - " prepare(geometry)\n", - " predicted = np.zeros(len(grid_unit), dtype=bool)\n", - " predicted[compared] = contains_xy(\n", - " geometry, lon_grid.ravel()[compared], lat_grid.ravel()[compared]\n", - " )\n", - " area = lambda mask: np.sum(mask * cell_area.ravel()) / 1e6\n", - " return predicted.reshape(lat_grid.shape), {\n", - " \"observed (10^6 km^2)\": area(observed4),\n", - " \"TAT-C (10^6 km^2)\": area(predicted),\n", - " \"IoU\": area(observed4 & predicted) / area(observed4 | predicted),\n", - " \"observed only (%)\": 100 * area(observed4 & ~predicted) / area(observed4),\n", - " \"TAT-C only (%)\": 100 * area(predicted & ~observed4) / area(predicted),\n", - " }\n", - "\n", - "\n", - "swath_rows, swath_maps = {}, {}\n", - "swath_maps[\"field of regard, 60 s\"], swath_rows[\"field of regard, 60 s\"] = (\n", - " swath_area_row(Instrument(name=\"ATMS\", field_of_regard=2 * EDGE), 60)\n", - ")\n", - "for time_step in [SCAN_PERIOD, 32, 128]:\n", - " along_fov = np.degrees(2 * np.arctan(ground_speed * time_step / 2 / altitude))\n", - " name = f\"rectangular, {time_step:.3g} s ({along_fov:.2f} deg along track)\"\n", - " swath_maps[name], swath_rows[name] = swath_area_row(\n", - " PointedInstrument(\n", - " name=\"ATMS\",\n", - " field_of_regard=2 * EDGE,\n", - " cross_track_field_of_view=2 * EDGE,\n", - " along_track_field_of_view=along_fov,\n", - " is_rectangular=True,\n", - " ),\n", - " time_step,\n", - " INERTIAL,\n", - " )\n", - "observed4 = observed4.reshape(lat_grid.shape)\n", - "pd.DataFrame(swath_rows).T.round(3)" - ] - }, - { - "cell_type": "code", - "execution_count": 11, - "id": "bfe341fe", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T13:49:33.625539Z", - "iopub.status.busy": "2026-10-25T13:49:33.625539Z", - "iopub.status.idle": "2026-10-25T13:49:40.785662Z", - "shell.execute_reply": "2026-10-25T13:49:40.785662Z" - } - }, - "outputs": [ - { - "data": { - "image/png": "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0SgPP/wwdrudiooKfv3rX6NQKOjs7JTGP7ocqb6+fswzfzRTGcttt93GF77wBex2O3/7t397zmOel5fHF7/4RWnfz+QTn/gEt956KyaTCaPRyFe/+lX27dsnORU6OjooLy/nmmuuQaFQcO2111JaWjqpY6qjo4PrrrsOq9WK3W5nw4YNhEKhCed98cUX2bp16zn3YTSLFy+WApkKhQKlUklLS8t5zb979250Oh0PP/wwKpWKtWvXctddd/Ff//Vfk66voaGBq666CrPZzDXXXDPOHnU6ndx///0UFhZSWFjIV7/6VaLRqDT9T3/6E9XV1VitVj7/+c9z22238d3vfnfCbZ3rfDiT1tZWbrzxRux2O1VVVWPOu7S9+r3vfY/c3Fzy8vLGTBcEgW9961tj7OfJpDCef/55fvCDH0i2ezo78sEHH+Szn/0s9957LxaLhX/7t3/jyJEjbNy4EbvdTk5ODvfddx8ul0taVywWk2x8s9nM4sWLOXz48ITH4sYbb+T+++8nHo8DcO211/LSSy9NejxkZKaL7JiSkZkDeL1enn32WR588EE+/elP8/LLLzM4ODjt9Wzfvp177rkHtVo9pfkfeeSRMVHWf/iHfxg3z9/93d+xa9cudu7cSX9/P/PmzePjH//4hOt77LHHeOyxx3jvvfdobW3l4MGDZ3XS/O53v+Nf/uVfeP755+nr66Ouro7bbruNRCLB008/zf33388Xv/hFAoEAn/3sZydcx4kTJ1Cr1XR3d/O73/2OV199lb/+67/msccew+12841vfIPbb79dehB/+ctfJhgM0tXVxTvvvDMuJd5ut/Pss8/i8/l48cUX+c///E+eeOKJMfM88cQTvP766/h8PmKxGNu2beNLX/oSXq+Xz3zmM2eNHp7J3r170el0vPLKKxQVFVFRUcHXv/516cF/7NgxCgoKyMvLk5ZZtmwZx44dm3B9//M//8PRo0dpbW2Vzqv8/Pwpj0dGRkZGZm4xWzZCmscee4zvf//7BAIBrrvuOh566CHcbjfHjh2jo6ODeDzOl770JQCCwSDXXXcdixYtorOzk4GBAb785S8DsH//fgAcDgeBQID7778fQRD4xCc+QUdHB4ODgyxfvpx77713TEBo+/btbNiwAZfLxfe//30+97nPSbbF97//fQ4ePEhDQwP19fU899xz0z4uaaYyltde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", - "text/plain": [ - "
" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "fig, axes = plt.subplots(\n", - " 1, 2, figsize=(12, 4.2), subplot_kw={\"projection\": ccrs.PlateCarree()}\n", - ")\n", - "for ax, name in zip(axes, [list(swath_maps)[0], list(swath_maps)[-1]]):\n", - " predicted = swath_maps[name]\n", - " category = np.where(\n", - " observed4 & predicted, 1, np.where(observed4, 2, np.where(predicted, 3, 0))\n", - " ).astype(float)\n", - " category[~compared.reshape(lat_grid.shape)] = 0\n", - " ax.pcolormesh(\n", - " lon_grid,\n", - " lat_grid,\n", - " np.ma.masked_equal(category, 0),\n", - " cmap=plt.matplotlib.colors.ListedColormap([\"#d9d8d3\", ORANGE, BLUE]),\n", - " vmin=0.5,\n", - " vmax=3.5,\n", - " transform=ccrs.PlateCarree(),\n", - " shading=\"auto\",\n", - " )\n", - " ax.coastlines(color=GRAY, linewidth=0.5)\n", - " ax.set_global()\n", - " ax.set_title(f\"TAT-C {name}\", fontsize=9)\n", - "axes[0].plot([], [], color=\"#d9d8d3\", lw=6, label=\"both\")\n", - "axes[0].plot([], [], color=ORANGE, lw=6, label=\"observed only\")\n", - "axes[0].plot([], [], color=BLUE, lw=6, label=\"TAT-C only\")\n", - "axes[0].legend(frameon=False, loc=\"lower left\", fontsize=8)\n", - "fig.tight_layout()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "id": "36151938", - "metadata": {}, - "source": [ - "All configurations reproduce the area sampled over one orbit with an intersection over union (IoU) of 0.99. The differences are thin slivers along the swath edges, mostly area observed but not predicted, consistent with TAT-C's slightly narrow nominal swath (above), plus a small patch where the start and end of the orbit overlap. Tailoring the along-track field of view to the time step makes consecutive rectangular footprints tile the swath at every time step tested, so the time step can be chosen for computational cost: one scan (8/3 s) takes several minutes for an orbit, while 32 s or longer takes seconds. At 128 s, footprints spanning 53 deg along track begin to bulge beyond the swath edges (TAT-C only, 0.9%), because the corners of a rectangle in the tangent plane at nadir project farther from the ground track than its center line.\n", - "\n", - "## Test 5: Daily Observations\n", - "\n", - "Finally, `collect_observations`, which finds continuous-time access periods rather than sampling at time steps, is evaluated for 2,598 points on a Fibonacci lattice with a typical spacing of 500 km.\n", - "\n", - "**Observed.** A point is observed on a pass if it lies within a quadrilateral cell of beam centers (as in Test 4). Beam centers within 60 km of each point are grouped into passes (gaps longer than 20 minutes); for each pass, the observation time is interpolated between the two scans that straddle the point, and the elevation angle is computed from the reported spacecraft position at that time.\n", - "\n", - "**Predicted.** Three instruments are compared, each with the nominal field of regard: a nadir `Instrument`, and rectangular `PointedInstrument`s with the cross-track field of view equal to the field of regard and the along-track field of view tailored to one scan, in either velocity frame. For a `PointedInstrument`, `collect_observations` reports the time at which the view sweeps over the point as the observation epoch; for a nadir `Instrument`, it reports the midpoint of the access period, the time of closest approach.\n", - "\n", - "Predicted and observed passes of the same point are matched if their times differ by less than 10 minutes." - ] - }, - { - "cell_type": "code", - "execution_count": 12, - "id": "b8a9a1f6", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T13:49:40.788669Z", - "iopub.status.busy": "2026-10-25T13:49:40.788669Z", - "iopub.status.idle": "2026-10-25T13:53:04.410446Z", - "shell.execute_reply": "2026-10-25T13:53:04.410446Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
observedpredictedmatchedobserved onlypredicted onlytime, median (s)time, p95 |x| (s)elevation, median (deg)elevation, p95 |x| (deg)
nadir Instrument7402.07407.07380.022.027.00.0611.090.020.08
PointedInstrument, Earth-fixed7402.07382.07380.022.02.00.0910.870.030.08
PointedInstrument, inertial7402.07372.07371.031.01.00.050.260.000.02
\n", - "
" - ], - "text/plain": [ - " observed predicted matched observed only \\\n", - "nadir Instrument 7402.0 7407.0 7380.0 22.0 \n", - "PointedInstrument, Earth-fixed 7402.0 7382.0 7380.0 22.0 \n", - "PointedInstrument, inertial 7402.0 7372.0 7371.0 31.0 \n", - "\n", - " predicted only time, median (s) \\\n", - "nadir Instrument 27.0 0.06 \n", - "PointedInstrument, Earth-fixed 2.0 0.09 \n", - "PointedInstrument, inertial 1.0 0.05 \n", - "\n", - " time, p95 |x| (s) elevation, median (deg) \\\n", - "nadir Instrument 11.09 0.02 \n", - "PointedInstrument, Earth-fixed 10.87 0.03 \n", - "PointedInstrument, inertial 0.26 0.00 \n", - "\n", - " elevation, p95 |x| (deg) \n", - "nadir Instrument 0.08 \n", - "PointedInstrument, Earth-fixed 0.08 \n", - "PointedInstrument, inertial 0.02 " - ] - }, - "execution_count": 12, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "points5 = generate_points_fibonacci_lattice(500e3)\n", - "point_unit = unit_vector(points5.geometry.y.to_numpy(), points5.geometry.x.to_numpy())\n", - "tree5 = cKDTree(beam_unit.reshape(-1, 3))\n", - "mid_s = (t_mid - t_mid[0]).total_seconds().to_numpy()\n", - "beam_s = mid_s[:, np.newaxis] + beam_offset[np.newaxis, :]\n", - "observed_rows = []\n", - "for p, hits in enumerate(\n", - " tree5.query_ball_point(point_unit, r=2 * np.sin(60 / 6371 / 2), workers=-1)\n", - "):\n", - " if not hits:\n", - " continue\n", - " hits = np.array(hits)\n", - " hits = hits[np.argsort(beam_s.ravel()[hits])]\n", - " for group in np.split(\n", - " hits, np.nonzero(np.diff(beam_s.ravel()[hits]) > 1200)[0] + 1\n", - " ):\n", - " k, j = np.divmod(\n", - " group[\n", - " np.argmin(\n", - " np.linalg.norm(\n", - " beam_unit.reshape(-1, 3)[group] - point_unit[p], axis=-1\n", - " )\n", - " )\n", - " ],\n", - " N_BEAMS,\n", - " )\n", - " if not observed_cells(\n", - " point_unit[[p]], np.arange(max(k - 1, 0), min(k + 2, len(t_mid)))\n", - " )[0]:\n", - " continue\n", - " # interpolate between the scans before and after the point\n", - " k0 = (\n", - " k - 1\n", - " if np.sum(\n", - " (point_unit[p] - beam_unit[k, j])\n", - " * (beam_unit[k, j] - beam_unit[k - 1, j])\n", - " )\n", - " < 0\n", - " else k\n", - " )\n", - " k0 = int(np.clip(k0, 0, len(t_mid) - 2))\n", - " a, b = beam_unit[k0, j], beam_unit[k0 + 1, j]\n", - " f = np.clip(np.sum((point_unit[p] - a) * (b - a)) / np.sum((b - a) ** 2), 0, 1)\n", - " seconds = beam_s[k0, j] + f * (beam_s[k0 + 1, j] - beam_s[k0, j])\n", - " position = sc_pos[k0] + sc_vel[k0] * (seconds - mid_s[k0])\n", - " target = ecef(points5.geometry.x.iloc[p], points5.geometry.y.iloc[p])\n", - " u = up(points5.geometry.x.iloc[p], points5.geometry.y.iloc[p])\n", - " observed_rows.append(\n", - " {\n", - " \"point_id\": p,\n", - " \"time\": t_mid[0] + timedelta(seconds=float(seconds)),\n", - " \"scan_angle\": scan_angle[k0, j],\n", - " \"elevation\": np.degrees(\n", - " np.arcsin(np.sum(normalize(position - target) * u))\n", - " ),\n", - " }\n", - " )\n", - "observed5 = pd.DataFrame(observed_rows)\n", - "start5, end5 = t_start[0].to_pydatetime(), t_start[-1].to_pydatetime() + timedelta(\n", - " seconds=SCAN_PERIOD\n", - ")\n", - "along_fov5 = np.degrees(2 * np.arctan(ground_speed * SCAN_PERIOD / 2 / altitude))\n", - "pointed5 = PointedInstrument(\n", - " name=\"ATMS\",\n", - " field_of_regard=2 * EDGE,\n", - " cross_track_field_of_view=2 * EDGE,\n", - " along_track_field_of_view=along_fov5,\n", - " is_rectangular=True,\n", - ")\n", - "satellites5 = {\n", - " \"nadir Instrument\": on_noaa20(Instrument(name=\"ATMS\", field_of_regard=2 * EDGE)),\n", - " \"PointedInstrument, Earth-fixed\": on_noaa20(pointed5),\n", - " \"PointedInstrument, inertial\": on_noaa20(pointed5, INERTIAL),\n", - "}\n", - "\n", - "\n", - "def match(predicted):\n", - " \"\"\"Match predicted and observed passes of each point by time.\"\"\"\n", - " merged = pd.merge_asof(\n", - " observed5.sort_values(\"time\"),\n", - " predicted[[\"point_id\", \"epoch\", \"sat_alt\"]].sort_values(\"epoch\"),\n", - " left_on=\"time\",\n", - " right_on=\"epoch\",\n", - " by=\"point_id\",\n", - " direction=\"nearest\",\n", - " tolerance=pd.Timedelta(minutes=10),\n", - " )\n", - " return merged\n", - "\n", - "\n", - "predicted5, matched5, rows5 = {}, {}, {}\n", - "for name, satellite in satellites5.items():\n", - " predicted5[name] = pd.concat(\n", - " [\n", - " collect_observations(\n", - " Point(latitude=g.y, longitude=g.x), satellite, start5, end5\n", - " ).assign(point_id=p)\n", - " for p, g in enumerate(points5.geometry)\n", - " ]\n", - " ).reset_index(drop=True)\n", - " matched5[name] = match(predicted5[name])\n", - " hit = matched5[name].epoch.notna()\n", - " dt = (matched5[name].epoch - matched5[name].time).dt.total_seconds()[hit]\n", - " rows5[name] = {\n", - " \"observed\": len(observed5),\n", - " \"predicted\": len(predicted5[name]),\n", - " \"matched\": int(hit.sum()),\n", - " \"observed only\": int((~hit).sum()),\n", - " \"predicted only\": len(predicted5[name]) - int(hit.sum()),\n", - " \"time, median (s)\": np.median(dt),\n", - " \"time, p95 |x| (s)\": np.percentile(np.abs(dt), 95),\n", - " \"elevation, median (deg)\": np.median(\n", - " (matched5[name].sat_alt - matched5[name].elevation)[hit]\n", - " ),\n", - " \"elevation, p95 |x| (deg)\": np.percentile(\n", - " np.abs(matched5[name].sat_alt - matched5[name].elevation)[hit], 95\n", - " ),\n", - " }\n", - "pd.DataFrame(rows5).T.round(2)" - ] - }, - { - "cell_type": "code", - "execution_count": 13, - "id": "bcefd495", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T13:53:04.412662Z", - "iopub.status.busy": "2026-10-25T13:53:04.412662Z", - "iopub.status.idle": "2026-10-25T13:53:04.692141Z", - "shell.execute_reply": "2026-10-25T13:53:04.692141Z" - } - }, - "outputs": [ - { - "data": { - "image/png": "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Tx/WrFnDwoULOXDgAF27diUxMfGS5xVCCCFy9O3bF6PRyI8//uhdduLECZo2bcr8+fP59ttveemllzh79izXXHNNkWuOPfjgg6SlpbFixYpcyw8ePMjGjRt54IEHLrn/rFmzuPvuu2nZsiWff/45r776Knv37qVLly557i2cTid9+/ald+/erFmzhkmTJvH2229zxx13eLfZunUrd9xxB40aNeLjjz/m66+/5umnn8blcnm3sVgsdO/enWXLljF58mT+97//8eijj7J06VIGDBiQ68sZgDVr1vDmm2/y9NNP8+2339KrVy9GjRrFZ599htlszrXtRx99hM1m897/2O12UlNTeeSRR1izZg0fffSRt3fO+++/nyvuoKAg+vbt673PWLhwYYHXbcWKFQwcOJDw8HA++ugjFi1aRFpaGj169GDLli15th8yZAhXX301n332GY899hgrVqzgoYceKtJ1E6JMU0KIMi8hIUEB6s4777zkdnfccYcCVGJiolJKqWeeeUYB6qGHHsq13YcffqgA9cEHHyillFq1apUC1O7duws89kcffaQA9dlnn+VavmPHDgWohQsXepfVr19fGY1G9fvvv+fa9ty5c8rf3189/vjjuZYPGzZM1ahRQzmdznzP7Xa7ldPpVM8++6yqXr260nXdu65ly5aqe/fuefY5fvy4AtSSJUu8y6699loVHR2tMjMzvctcLpdq1aqVqlOnjve4S5YsUYCaOHFirmPOmTNHAers2bP5xpnjgQceUAX9ea1fv74aO3as9/nGjRsVoPr3759ruylTpihATZ48Odfy22+/XVWrVs37fOvWrQpQr7zySq7tTp06pYKCgtS0adMuGasQQojKI+f9bceOHQVuU6NGDdW8efMC17tcLpWVlaVCQkLUq6++6l2e8362ceNG77Kc+5ALde/eXcXGxuZadv/996vw8PBc788XS0tLU0FBQapv3765lp88eVIFBASoESNGeJeNHTtWAbniU0qpF154QQFqy5YtSimlXn75ZQWo9PT0As87a9YsZTAY8lyznHundevWeZcBKiIiQqWmpubadu/evQpQ77zzTq7lnTp1Uh06dCjw3C6XSzmdTnX33Xerdu3a5VoXEhKS634ix8Wvg9vtVrVr11atW7dWbrfbu11mZqaKjo5WXbt29S7Leb3mzJmT65gTJ05UgYGB3vukwlw3Icoy6QkiRAWizn8bcXEl9pEjR+Z6PmzYMEwmExs3bgQgNjYWf39/JkyYwLJly/IdRrF27VqqVKlC//79cblc3kdsbCw1a9bM0+2yTZs2XH311bmWVa9enf79+7Ns2TJ0XQcgLS2NL774gjFjxuQa5rNhwwb69OlDREQERqMRPz8/nn76aVJSUq6oen12dja//PILQ4cOzVUx3mg0Mnr0aE6fPs3vv/+ea58BAwbkaROQpwtwcbjttttyPW/evDlAnsKuzZs3JzU11TskZu3atWiaxqhRo3K9LjVr1qRt27ZSHV4IIUSRqIt6NmRlZfHoo4/SpEkTTCYTJpOJ0NBQsrOzCxyGcikPPvggu3fv5qeffgI8Q02WL1/O2LFjLzmjy9atW7FarXlmWKtbty69evXihx9+yLPPxfc/I0aMAPDe/1xzzTWA575o5cqVxMfH5znG2rVradWqFbGxsbneZ2+++eZ8h5306tWLqlWr5lrWunVrOnTowJIlS7zLDh06xPbt2/MMIfn000+57rrrCA0NxWQy4efnx6JFi67oWgP8/vvvnDlzhtGjR2Mw/P3RLzQ0lCFDhrBt27Y8Q4Tyu/+x2Wze+6/CXDchyjJJgghRDkRGRhIcHMzx48cvud2JEycIDg6mWrVquZbXrFkz13OTyUT16tVJSUkBoHHjxqxfv57o6GgeeOABGjduTOPGjXn11Ve9+yQmJpKeno6/vz9+fn65HgkJCXm6xBY0/GP8+PHEx8fz/fffA56uoHa7PddNzfbt27npppsAePfdd/npp5/YsWMHTzzxBECeoTeFkZaWhlIq37hq164N4L0eOapXr57reUBAwBWf/3Iufs38/f0vudxmswGe10UpRY0aNfK8Ltu2bavQ0yMLIYQoXtnZ2aSkpHjfF8GTOFiwYAH33HMP3377Ldu3b2fHjh1ERUVd0fvhwIEDadCggbd+1tKlS8nOzr7sUJic9+iC3scvfg/Pude5UM79UM623bp1Y82aNbhcLsaMGUOdOnVo1aoVH330kXefxMRE9u7dm+c9NiwsDKVUke5/tm7dyuHDhwHPDD0BAQEMHz7cu83nn3/OsGHDiImJ4YMPPmDr1q3s2LGD8ePHe9/3i+py103XddLS0nItv9z9T2GumxBlmcwOI0Q5YDQa6dmzJ9988w2nT5/Oty7I6dOn+fXXX7n11lsxGo251iUkJBATE+N97nK5SElJyfUmd8MNN3DDDTfgdrvZuXMnr7/+OlOmTKFGjRrceeed3uKg33zzTb4xhoWF5Xp+cW+UHDfffDO1a9dmyZIl3HzzzSxZsoTOnTvTokUL7zYff/wxfn5+rF27lsDAQO/y/KaCK6yqVatiMBg4e/ZsnnU5xU4jIyOv+Pi+EhkZiaZpbN682XuTcqH8lgkhhBD5+frrr3G73d4imxkZGaxdu5ZnnnmGxx57zLtdTu2KK2EwGHjggQd4/PHHeeWVV1i4cCG9e/emadOml9wv556loPfxi9/D87vXSUhIyHUs8CRlBg4ciN1uZ9u2bcyaNYsRI0bQoEEDunTpQmRkJEFBQSxevDjfuC4+b0H3P8OHD2fq1KksXbqUF154geXLl3P77bfn6jXywQcf0LBhQz755JNcx7Hb7fkeszAud90MBkOeniuFcbnrJkRZJj1BhCgnpk+fjlKKiRMn5il86na7uf/++1FKMX369Dz7fvjhh7mer1y5EpfL5b3JuZDRaKRz587eb2h27doFeIZrpKSk4Ha76dixY57H5W5eLjz+6NGjWbNmDZs3b2bnzp15uoJqmobJZMqVzLFarSxfvjzP8QICAgr1TVRISAidO3fm888/z7W9rut88MEH1KlTJ8/wnStVkj1GLnbbbbehlCI+Pj7f16V169YlHoMQQojy7+TJkzzyyCNERERw7733Ap73Y6VUnoT6e++9l+depCjuuece/P39GTlyJL///juTJk267D5dunQhKCiIDz74INfy06dPs2HDBnr37p1nn4vvf3IKsuZ3/xMQEED37t156aWXAPjtt98Az/vssWPHqF69er7vszmz0l1O1apVuf3223n//fdZu3YtCQkJ+d7/+Pv750qAJCQk5JkdJifewtxnNG3alJiYGFasWJFrqFN2djafffaZd8aYK1XQdROiLJOeIEKUE9dddx3z589nypQpXH/99UyaNIl69epx8uRJ3njjDX755Rfmz59P165d8+z7+eefYzKZuPHGGzlw4ABPPfUUbdu2ZdiwYQC89dZbbNiwgX79+lGvXj1sNpv3G48+ffoAcOedd/Lhhx/St29fHnzwQTp16oSfnx+nT59m48aNDBw4kEGDBhWqLePHj+ell15ixIgRBAUF5arUDp46GPPmzWPEiBFMmDCB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/foEBQXRtWtXduzY4euw8lU3uiY3WyIASO0SzWuvve7jiER5MXLkSACaN2+OyWTyDt347rvv6NKlC61ateLZZ5/19mKIi4ujX79+1KhRA4AJEyZc8vjjx48vdCyDBw8mKCgIo9FIp06dOHbsGAC9e/dmypQpzJkzh71791KlSpUCj3H99dcXOgECcPvttxMQEEBwcDBNmzalT59eGAwGYmJiqFq1KqdPn+b333/nwIED3HnnncTGxtK1a1cyMzM5ePCg9zgXX0cpUizE3+Lj49m0aRPx8fE+Ob/0BClr3C40czIqIhoMRu9ih1MnweyiZrgJg/QIEUIIUUQXJkDSLW6ybZIAKap77rmH/fv3s3z5cmrXrs0HH3xAnz59OHjwIDExMb4OL49pfe/h27hXCHQqPlv3FVOmPEi1atV8HZa4hB0zmxa4znjR7d+PT15d4Lb/5FYxMDDw73Majbhcbk6ePMnkyZPZvn07jRo1Yu/evfTq1QsApYr2JV1oaOg/iMXzReG8efM4cOAAGzduZOzYsYwcOZJp06YV6nwmkylXbRCbLfdMjRefMyAgIE8MmqYRGRl5yeEsBcUuRGW3bNky/vPgQ+guBwaDgddff52xY8eWagzSE6Qscjs9NUL03DeoOYkQ6REihBCiKC5OgGRJAqTIrFYrn332GXPmzKFbt240adKEGTNm0LBhQ958801fh5evmKho3m85CsvbP/PX4SO5ahaIsinY31DgI8DPUOhtA/2K9xY/IyMDf39/atasiVKKBQsWeNf17NmTdevWeXuMLFq0qFjPnZ/Dhw/TsmVLJk2axP3338+2bdsACA8PJyMj45L7Nm7cmF9++QWA48ePs2XLliKfv2nTpgQHB/P+++97l/3xxx+kpqZedt/CxChERRUfH8+D/32Kmnd8QGiLgei6zuTJk0u9R4gkQcoql+N8IiR3YSuHU4bGCCGEKLwLEyAZVkmAXCmXy4Xb7c717S5AUFBQvh+i7HY7ZrM518MXOrVozeOPeQpQvvnmm6Snp/skDlG+tW7dmn/961+0bNmSHj16UK/e37VJ2rRpw+OPP07Xrl25/vrrqV27donHM336dFq2bEm7du1Yvnw5M2bMADxDcZ599llvYdT8PProo3z//fd06NCBJ554gs6dOxf5/CaTia+++oqVK1fSpk0bWrZsyT333IPVar3s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z5/P8uXLueaaawDYuHHjFccjyqdMm5v7lp4iIcNF0/BP2FE3GINSvN7wehrWbeHr8LwqTBKkZs2agKdHSK1atbzLk5KS8vQOudD06dOZOnWq97nZbKZu3bpERtUq1unsLFkWkk/FF9vxLqSCq0Bw3liD/A1EhZsumQQqqso8X3Zxk2tZfORaFh+5lsWnNK6lbs3yDIMxQlq2jtXuLvZzVK0XTVBIcLEf95968803GT9+POPGjfPeA1ysXr16LFq0qJQjK/tqRUXx8MMP8+CDD/J///d/jB8/nsDAQF+HJcqYunXrcvXVV/Pnn3/SvEUi9913H3/88QdKKSZPnuxNIjRo0IC1a9fSqlUrevToQefOnfn55585c+YMN954I2+99Rbr1q3jyy+/ZP369bz33ntMmjSJe+65h+XLl7NgwQKcTidhYWG88cYbtGrVCofDwX/+8x82btxITExMgcnMEydO0LFjRyZOnMjXX39NRkYGr732Gn379sVqtXLXXXexb98+/Pz8qFGjBt999x333XcfJ0+eJDY2lnr16vHll1/SoEED/v3vf7N+/Xpq167Nv//9bx555BF27twJwP79+7nttts4ceKE95z33XcfX3/9NVarlQ8++IB33nmHbdu2ERgYyJo1a6hd2/P3/+WXX2blypW4XC5q1qzJ22+/Td26dZkxYwZHjhwhMzOTY8eOUbNmTVatWoXL5eLpp5/GbDYTGxvLtddey1tvvXXFr+OoUaM4fPgwDoeDevXqsXjxYqKjo4mLi2PKlCl069aNHTt2cN999+V5jSKrV8HlcjFx4kR++uknXC4Xy5Yty7d3yNChQzl27BijR4+mVatWvPzyy3Ts2JFz585x+PBh+vTpw48//kijRo2YO3cuGzdu5OuvvyYxMZHJkydz4sQJbDYbt99+O88++ywAmzdvZuLEiQQFBdGpUyfp6V7GOVw6/1l+miMJduoY49jVzAkY+G9ANL079vd1eLlUmOEwDRs2pGbNmnz//ffeZQ6Hg02bNtG1a9cC9wsICCA8PDzXo7zRLOlgzTsDjlWGxgghRIWl7FZUZioAZptOdgkkQMqyo0ePMn369AITIAD+/v6MHTu2FKMqP0aNGkWH3jfQ/L6bWLRkia/DEecpu7Xgh9Ne+G0d/3za6H379nH48GFatmzB5MmTadasGfv27WPDhg0899xz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7pqooOfHdu3a8ffff/PMM8/kqhl84brnYhMnTiQ6Otr7vqiuPf5t7ty5NG7cmCpVquSaPmPGDKpWrYrVauWuu+4iISEhz2e//fZbmjdvjtlspkaNGowdOxan0+mdv3v3bm666SbMZjP169dn+fLlKIriPb4g519RfkkSRJRbX331FXXr1qVu3bo8+OCDTJ8+Pc8JqSD69+/vvekET+2SRx55JNcydrsdu93OwoULycrKKtB6nU4nPXr04Oabb2bbtm2sXbuWJ554wnvS/e677+jZsyddu3Zl8+bN3mTGBdnZ2bzyyits3bqVhQsXcvDgwVzNcy4YNWoU//d//8cff/yBXq/PE/u/ORwOZsyYwc6dO3n33Xf56KOPeOedd3Itc+DAARYuXMiSJUtYsmQJK1eu5PXXX/fOf/bZZ/n1119ZvHgxy5YtY/Xq1WzatOmS29Q0ja5du3Ly5Em+//57Nm7cSLNmzejQocNla9KsXr06V5kA/N///R+ffvopn3zyCWvWrOHs2bN5Tt4vvvgi06dP58MPP2THjh0888wzPPjgg6xcuRLwXDD16tWLHj16sGXLFp588klGjRp12XK7lJ9//pldu3bxyy+/8OWXX7JgwQLGjh3rnT9ixAi++eYbZs6cyaZNm6hVqxa33Xabd79feukldu7cyQ8//MCuXbv48MMPCQkJybOdqKgovvnmG8DTfvjEiRO8++67eZbr06cP69at48CBA95pO3bsYPv27fTp0weAjz76iFGjRjFhwgR27drFq6++yksvvcTMmTMLvN/9+/fn119/Zc6cOWzbto177rmH22+/nX379uVKxn3zzTecOHGCxYsXc++993oviE+cOEHr1q2962vRogWrV68u8PaFEEIUPYvF4n0wcqXzV37S09N56623mDVrFqtWreLw4cPemiXDhw+/7Hngci53TVTQ8+P8+fOpUqUK48aNy1Mz+EqK4tojP6tWrcpznbNu3ToeeeQRBg4cyJYtW2jfvj3jx4/PtcyPP/7Igw8+yNChQ9m5cydTp05lxowZTJgwAQC3202PHj2wWq2sW7eOadOmXfI6R86/olzShCinWrdurU2cOFHTNE3LycnRQkJCtGXLluVZDtAWLFiQZ3rfvn21O++8Uzt9+rRmMpm0gwcPaocOHdLMZrN2+vRp7c4779T69u3rXX7evHlaYGCg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", - "text/plain": [ - "
" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "fig, axes = plt.subplots(1, 2, figsize=(11, 3.8))\n", - "edges5 = np.arange(-54, 55, 4)\n", - "for (name, matched), color in zip(matched5.items(), [BLUE, ORANGE, AQUA]):\n", - " hit = matched.epoch.notna()\n", - " dt = (matched.epoch - matched.time).dt.total_seconds()\n", - " q = binned(matched.scan_angle[hit].to_numpy(), dt[hit].to_numpy(), edges5)\n", - " axes[0].fill_between(\n", - " (edges5[:-1] + edges5[1:]) / 2, q[:, 0], q[:, 2], color=color, alpha=0.15, lw=0\n", - " )\n", - " axes[0].plot((edges5[:-1] + edges5[1:]) / 2, q[:, 1], color=color, label=name)\n", - "axes[0].axhline(0, color=GRAY, lw=0.8)\n", - "axes[0].set(\n", - " xlabel=\"ATMS scan angle (deg, positive left)\",\n", - " ylabel=\"TAT-C minus ATMS (s)\",\n", - " title=\"Observation time\",\n", - ")\n", - "axes[0].legend(frameon=False, fontsize=8)\n", - "lat_edges = np.arange(-90, 91, 10)\n", - "point_lat = points5.geometry.y.to_numpy()\n", - "n_points = np.histogram(point_lat, lat_edges)[0]\n", - "axes[1].plot(\n", - " (lat_edges[:-1] + lat_edges[1:]) / 2,\n", - " np.histogram(point_lat[observed5.point_id], lat_edges)[0] / n_points,\n", - " color=INK,\n", - " marker=\"o\",\n", - " ms=3,\n", - " label=\"observed (ATMS)\",\n", - ")\n", - "for (name, predicted), color in zip(predicted5.items(), [BLUE, ORANGE, AQUA]):\n", - " axes[1].plot(\n", - " (lat_edges[:-1] + lat_edges[1:]) / 2,\n", - " np.histogram(point_lat[predicted.point_id.astype(int)], lat_edges)[0]\n", - " / n_points,\n", - " color=color,\n", - " ls=\"--\",\n", - " label=name,\n", - " )\n", - "axes[1].set(\n", - " xlabel=\"Point latitude (deg)\",\n", - " ylabel=\"Observations per point per day\",\n", - " title=\"Daily observations\",\n", - ")\n", - "axes[1].legend(frameon=False, fontsize=8)\n", - "fig.tight_layout()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "id": "bec2a8ff", - "metadata": {}, - "source": [ - "All three instruments predict the observed passes almost one for one (more than 99% matched), from about 2 observations per day at the equator to more than 9 near the poles. The few unmatched passes are at the swath edges (Test 4).\n", - "\n", - "The observation times differ. The nadir `Instrument` reports the time of closest approach, which is about 11 s (95th percentile) from the time ATMS actually scans a point near the swath edges, because the scan line is rotated from the perpendicular to the ground track (Test 2). A `PointedInstrument` in the Earth-fixed frame has the same offset. In the inertial frame, TAT-C's epochs match the actual scan times to within 0.26 s (95th percentile), and the elevation angles at those times to within 0.02 deg." + "NOAA-20's geodetic altitude varies by about 30 km over an orbit, mostly because of Earth's oblateness, so the swath width varies by about 100 km, from about 2,530 km near the equator to about 2,630 km at high southern latitudes. TAT-C's nominal field of regard reproduces this variation but is about 11 km too narrow (median); the measured field of regard (Test 2) agrees to within about 2 km (median; 3.5 km at the 95th percentile). The swath of the elevation angle at the apogee altitude departs from the field of regard by up to about 30 km: the geodetic altitude exceeds the \"conservative\" apogee altitude at middle and high latitudes, where the elevation threshold is too strict. This is why `collect_observations` relaxes it and refines its access periods to the field of regard." ] }, { @@ -1896,7 +1273,7 @@ "id": "a7c1e601", "metadata": {}, "source": [ - "## Test 6: Footprint Size\n", + "## Test 5: Footprint Size\n", "\n", "The ATMS geolocation file does not report footprint dimensions. A footprint is the projection of a beam onto the surface. ATMS has beamwidths (full width at half maximum) of 5.2 deg for channels 1 and 2 (23.8 and 31.4 GHz), 2.2 deg for channels 3 to 16 (the 50 to 60 GHz temperature sounding channels and 88.2 GHz), and 1.1 deg for channels 17 to 22 (165.5 and 183.3 GHz), corresponding to about 75, 32, and 16 km at nadir ([ATMS documentation at GES DISC](https://www.earthdata.nasa.gov/data/catalog/ges-disc-snppatmsl1b-2); [ECMWF](https://www.ecmwf.int/sites/default/files/elibrary/2012/8301-evaluation-and-assimilation-atms-data-ecmwf-system.pdf)). These are published specifications, not derived from the data. The 2.2 deg beam, used here, is that of the temperature sounding channels.\n", "\n", @@ -2216,6 +1593,8 @@ ], "source": [ "# measured spacing (km) between adjacent beam centers within a scan and between the same beam on consecutive scans\n", + "# pairs of consecutive scans without a gap between them\n", + "contiguous = np.diff(atms[\"MidTime\"][good]) < 1.5 * SCAN_PERIOD * 1e6\n", "spacing_cross = (\n", " np.median(np.linalg.norm(np.diff(beam_xyz[i4], axis=1), axis=-1), axis=0) / 1e3\n", ")\n", @@ -2326,15 +1705,14 @@ "| 1. Orbit (operational TLE vs. reported position) | 1.1 km along track (95th percentile), 0.4 km or better radially and cross-track |\n", "| 2. Scan geometry | scan plane perpendicular to the *inertial* velocity (within 0.06 deg); Earth-fixed velocity off by up to 4 deg; effective spacing 1.112 deg and roll 0.04 deg vs. nominal 1.11 deg |\n", "| 3. Beam geolocation (`collect_ground_pixels`) | up to 90 km along track at the edges with the default Earth-fixed frame; about 5 km with the inertial frame (scan timing); 0.7 km median with fitted scan angles and per-beam sample times |\n", - "| 4. Swath (`compute_ground_track`) | swath width 11 km narrow with the nominal field of regard, within 2 km (median) with the measured one; one-orbit IoU 0.99 for time steps from 8/3 to 128 s |\n", - "| 5. Daily observations (`collect_observations`) | more than 99% of passes matched for all instruments; epochs within 0.26 s (95th percentile) for an inertial-frame `PointedInstrument`, vs. 11 s for a nadir `Instrument` |\n", - "| 6. Footprint size | zenith angles within 0.03 deg and slant ranges within 1 km (95th percentile) of reported; 32.2 km footprint at nadir for the 2.2 deg beam, growing to an equivalent diameter of 93 km at the swath edge |\n", + "| 4. Swath width (`field_of_regard_to_swath_width`) | 11 km narrow with the nominal field of regard, within 2 km (median) with the measured one |\n", + "| 5. Footprint size | zenith angles within 0.03 deg and slant ranges within 1 km (95th percentile) of reported; 32.2 km footprint at nadir for the 2.2 deg beam, growing to an equivalent diameter of 93 km at the swath edge |\n", "\n", - "**Along-track reference direction.** The largest difference between TAT-C's default imager geometry and ATMS is the orientation of the scan. Like most Earth observation spacecraft without yaw steering, NOAA-20 keeps its attitude aligned with the orbit plane, so the scan is perpendicular to the inertial velocity, while TAT-C's default view is perpendicular to the ground track (the Earth-fixed velocity, as for a yaw-steered spacecraft). Setting the satellite's attitude to the inertial velocity frame (`Attitude(velocity_frame=VelocityFrame.INERTIAL)`, or a `PointedInstrument`'s `velocity_frame` on a satellite without an attitude) removes along-track errors of up to 90 km at the swath edges and observation time errors of about 10 s.\n", + "**Along-track reference direction.** The largest difference between TAT-C's default imager geometry and ATMS is the orientation of the scan. Like most Earth observation spacecraft without yaw steering, NOAA-20 keeps its attitude aligned with the orbit plane, so the scan is perpendicular to the inertial velocity, while TAT-C's default view is perpendicular to the ground track (the Earth-fixed velocity, as for a yaw-steered spacecraft). Setting the satellite's attitude to the inertial velocity frame (`Attitude(velocity_frame=VelocityFrame.INERTIAL)`, or a `PointedInstrument`'s `velocity_frame` on a satellite without an attitude) removes along-track errors of up to 90 km at the swath edges.\n", "\n", - "**Scan timing.** TAT-C observes all pixels of a view at one instant, whereas ATMS sweeps its 96 beams over about 1.7 s. The resulting along-track error, about 4.5 km at the swath edges, is a fraction of an ATMS footprint and of the 17.6 km between scans. For coverage, the along-track field of view stands in for the scan: tailored to the time step, consecutive views tile the swath at time steps from one scan to two minutes.\n", + "**Scan timing.** TAT-C observes all pixels of a view at one instant, whereas ATMS sweeps its 96 beams over about 1.7 s. The resulting along-track error, about 4.5 km at the swath edges, is a fraction of an ATMS footprint and of the 17.6 km between scans. For coverage, the along-track field of view stands in for the scan: tailored to the time step, consecutive views tile the swath.\n", "\n", - "**Instrument parameters.** Nominal scan angles produce a swath about 11 km narrower than observed; the effective spacing and roll fitted from the geolocation close the gap. For a nadir `Instrument`, the swath width also depends on the satellite's altitude, which varies by about 30 km over NOAA-20's orbit (mostly from Earth's oblateness). `collect_observations` refines its access periods to the times when a point's angle from nadir equals half the field of regard, so they follow the actual altitude (an earlier approximation, a minimum elevation angle at the apogee radius minus the mean Earth radius, narrowed the swath at middle and high latitudes and missed 37 rather than 22 observed passes).\n", + "**Instrument parameters.** Nominal scan angles produce a swath about 11 km narrower than observed; the effective spacing and roll fitted from the geolocation close the gap. For a nadir `Instrument`, the swath width also depends on the satellite's altitude, which varies by about 30 km over NOAA-20's orbit (mostly from Earth's oblateness). `collect_observations` refines its access periods to the times when a point's angle from nadir equals half the field of regard, so they follow the actual altitude (an earlier approximation, a minimum elevation angle at the apogee radius minus the mean Earth radius, narrowed the swath by up to about 30 km at middle and high latitudes).\n", "\n", "**Changes to TAT-C.** This validation led to the `velocity_frame` option and exposed two problems with the rectangular `PointedInstrument`, which have been fixed: rectangular footprint polygons for wide, elongated views were inaccurate (misplaced corners and too few points along the long sides), and `collect_observations` checked a pointed instrument's view only at the midpoint of each access period, missing up to 77% of observations for a view tailored to a scan period. It now checks the view at the time the view sweeps over the point and reports that time as the epoch.\n", "\n", diff --git a/docs/validation/ValidateImagerCrIS.ipynb b/docs/validation/ValidateImagerCrIS.ipynb index 63544621..d46dc163 100644 --- a/docs/validation/ValidateImagerCrIS.ipynb +++ b/docs/validation/ValidateImagerCrIS.ipynb @@ -9,13 +9,14 @@ "\n", "This notebook validates TAT-C's representation of a cross-track sounder against the [Cross-track Infrared Sounder (CrIS)](https://www.star.nesdis.noaa.gov/jpss/CrIS.php) aboard NOAA-20 (JPSS-1). CrIS is a Fourier-transform spectrometer (3.9 to 15.4 um) that scans perpendicular to the flight direction in 30 fields of regard (FORs) spaced about 3.33 deg apart, from -48.33 to +48.33 deg (a swath about 2,200 km wide), every 8 s. Each FOR holds a 3 x 3 array of circular fields of view (FOVs), 0.963 deg in diameter (about 14 km at nadir) on a pitch of about 1.1 deg (about 16 km) ([WMO OSCAR](https://space.oscar.wmo.int/instruments/view/cris)).\n", "\n", - "TAT-C does not model the scan mechanism. As described in the companion notebook, [Imager Validation: NOAA-20 ATMS](ValidateImagerATMS.ipynb), every pixel of a `PointedInstrument` view is observed at the same instant, and the along-track field of view stands in for the time the instrument takes to scan. CrIS is modeled as a rectangular view of 30 x 3 = 90 cross-track and 3 along-track pixels, three pixels for each FOR in each direction. The comparison asks five questions:\n", + "TAT-C does not model the scan mechanism. As described in the companion notebook, [Imager Validation: NOAA-20 ATMS](ValidateImagerATMS.ipynb), every pixel of a `PointedInstrument` view is observed at the same instant, and the along-track field of view stands in for the time the instrument takes to scan. CrIS is modeled as a rectangular view of 30 x 3 = 90 cross-track and 3 along-track pixels, three pixels for each FOR in each direction. The comparison asks four questions:\n", "\n", "1. **Orbit.** Does TAT-C's propagation of the operational two-line element (TLE) set reproduce NOAA-20's position?\n", "2. **Scan geometry.** Which scan angles, array layout, and scan plane orientation reproduce the actual scan?\n", "3. **Geolocation.** How closely do TAT-C's pixel positions (`collect_ground_pixels`) match the reported FOV positions, and how much of the difference comes from scan timing and the rotation of the FOV array, which TAT-C does not model?\n", - "4. **Swath.** Does TAT-C's swath (`compute_ground_track`) match the area CrIS samples, for time steps from one scan to two minutes?\n", - "5. **Footprint size.** Does the satellite viewing geometry reproduce the reported zenith angles and ranges on which the footprint size depends, and how large are CrIS footprints and how do they grow toward the swath edge? Footprint size (horizontal resolution) is the figure of merit of the [monsoon OSSE example](../examples/RunOSSEMonsoon.ipynb), which uses the parameters fit here." + "4. **Footprint size.** Does the satellite viewing geometry reproduce the reported zenith angles and ranges on which the footprint size depends, and how large are CrIS footprints and how do they grow toward the swath edge? Footprint size (horizontal resolution) is the figure of merit of the [monsoon OSSE example](../examples/RunOSSEMonsoon.ipynb), whose CrIS swath comes from the catalog's `cris` entry, with a field of regard and scan plane tilt measured as here.\n", + "\n", + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `cris` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_cris.py`; see the [instrument catalog](catalog.rst)." ] }, { @@ -1630,427 +1631,7 @@ "* **Scan timing.** With all pixels at the scan's middle time, the remaining along-track residual is a tilt across the scan of about 19 km at each edge: CrIS samples its first FOR 2.9 s before the middle time and its last 2.9 s after, while NOAA-20's ground track advances about 6.6 km/s. Projecting each FOR at its sample time removes the tilt. This is the integration time that TAT-C's single-instant view does not resolve, and it is much larger than for ATMS because a CrIS scan takes 5.8 s instead of 1.7 s.\n", "* **Scan angles and tilt.** With the nominal spacing, the cross-track residual grows to about 4 km (95th percentile) at the edges; the fitted spacing and roll angle reduce it to 0.3 km. The fitted scan plane tilt removes a constant along-track bias of about 2.9 km.\n", "\n", - "With all three accounted for, TAT-C reproduces the centers of the CrIS FOR arrays to 0.5 km (median) and 0.7 km (95th percentile) everywhere in the swath, comparable to the orbit error of Test 1. The residuals of all FOVs are larger (95th percentile of about 35 km) only because TAT-C does not rotate the FOV array: its FOVs are displaced from the true ones, by up to about 60 km at the swath edges, which does not affect the extent of the swath or the footprint size.\n", - "\n", - "## Test 4: Swath\n", - "\n", - "### Swath Width\n", - "\n", - "For a nadir `Instrument`, TAT-C converts the field of regard to a swath width with `field_of_regard_to_swath_width`, assuming a spherical Earth with the mean radius and the satellite's geodetic altitude. The observed swath width is the distance along the surface from the first to the last FOR center, through the intermediate FOR centers." - ] - }, - { - "cell_type": "code", - "execution_count": 11, - "id": "23adba58", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T13:54:50.874038Z", - "iopub.status.busy": "2026-10-25T13:54:50.874038Z", - "iopub.status.idle": "2026-10-25T13:54:51.042123Z", - "shell.execute_reply": "2026-10-25T13:54:51.041234Z" - } - }, - "outputs": [ - { - "data": { - "image/png": "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cyd169bFwcGBJk2acOTIkXte/6+//qJNmza4uLjg6upKw4YN+eOPPwBISkqid+/eBAcH4+joSO3atVm+fLn5tf369WP79u189NFHaDQaNBoN586dAyAyMpIuXbrg7OyMn58fL7zwAomJiYWOy+1dC8LCwgCoX78+Go2G1q1bm49bvHgx1atXx8HBgWrVqvHpp58W+hoAX375JY888gguLi74+/vTp08f4uPjAVPc27RpA4CHhwcajYZ+/foBli3RrVu35vz584wcOdIcB4Dx48dTr149i+t9+OGHlC9f3vzcYDAwatQo3N3d8fLy4n//+x9KKYvXKKWYPn06FSpUQK/XU7duXVauXHnP+/r222+pW7cuwcHBFtuXLFlCuXLlcHR0pFevXiQlJeV77fr162nYsCEODg5UqFCB9957j7y8PPP+EydO0KJFCxwcHKhRowZbtmzJ1xWkdu3a+Pv7s2bNmnuWUwhhfZLICiEeGmdnZ5ydnVm7di3Z2dn/+nz//e9/mTFjBvv378fX15fu3buTm5t71+Ofe+45goOD2b9/PwcOHOCtt97C1tYWgKysLBo2bMgPP/zA0aNHefnll3nhhRfYu3cvAB999BHNmjVj0KBBxMbGEhsbS0hICLGxsbRq1Yp69erxxx9/sGHDBq5cucLTTz/9j+5p3759AGzZsoXY2FhWr14NwIIFCxgzZgyTJk3i+PHjTJ48mbFjx7J06dJCnzsnJ4f333+fv/76i7Vr13L27FlzshoSEsKqVasAU3/T2NhYPvroo3znWL16NcHBwUyYMMEch8KaOXMmixYtYuHChfz+++9cvXo1X/L3zjvvsHjxYj777DOOHTvGyJEjef7559m+fftdz7tjxw4eeeQRi2179+5lwIABvPrqqxw6dIg2bdowceJEi2M2btzI888/z7Bhw4iMjGTevHksWbKESZMmAWA0GunZsyeOjo7s3buX+fPnM2bMmDuWoXHjxvz222+FjoUQwkqUEEI8RCtXrlQeHh7KwcFBhYeHq9GjR6u//vrLvP/s2bMKUAcPHjRvS05OVoD69ddflVJK/frrrwpQ33zzjfmYpKQkpdfr1YoVK+56bRcXF7VkyZJCl7VLly7q9ddfNz9v1aqVGj58uMUxY8eOVRERERbbLl68qAB18uTJO74uNDRUzZo1y/wcUGvWrFFK3fn+lVIq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", - "text/plain": [ - "
" - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
nmedianp95 |x|max |x|
nominal field of regard450.0-2.76.76.8
measured field of regard450.0-1.55.55.6
\n", - "
" - ], - "text/plain": [ - " n median p95 |x| max |x|\n", - "nominal field of regard 450.0 -2.7 6.7 6.8\n", - "measured field of regard 450.0 -1.5 5.5 5.6" - ] - }, - "execution_count": 11, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "for_xyz = fov_xyz.mean(axis=2)\n", - "for_unit = normalize(for_xyz)\n", - "i4 = np.arange(0, len(t_mid), 2)\n", - "observed_width = (\n", - " np.sum(np.linalg.norm(np.diff(for_xyz[i4], axis=1), axis=-1), axis=1) / 1e3\n", - ")\n", - "sub4 = wgs84.geographic_position_of(orbit.get_orbit_track(list(t_mid[i4])))\n", - "swath_width = np.vectorize(field_of_regard_to_swath_width)\n", - "widths = {\n", - " \"nominal field of regard\": swath_width(sub4.elevation.m, 2 * EDGE) / 1e3,\n", - " \"measured field of regard\": swath_width(\n", - " sub4.elevation.m, measured.max() - measured.min()\n", - " )\n", - " / 1e3,\n", - "}\n", - "edges4 = np.arange(-90, 91, 5)\n", - "centers4 = (edges4[:-1] + edges4[1:]) / 2\n", - "fig, ax = plt.subplots(figsize=(7, 3.6))\n", - "ax.plot(\n", - " centers4,\n", - " binned(sub4.latitude.degrees, observed_width, edges4)[:, 1],\n", - " color=INK,\n", - " marker=\"o\",\n", - " ms=3,\n", - " label=\"observed (CrIS)\",\n", - ")\n", - "for (name, width), color in zip(widths.items(), [BLUE, ORANGE]):\n", - " ax.plot(\n", - " centers4,\n", - " binned(sub4.latitude.degrees, width, edges4)[:, 1],\n", - " color=color,\n", - " label=f\"TAT-C: {name}\",\n", - " )\n", - "ax.set(\n", - " xlabel=\"Sub-satellite latitude (deg)\",\n", - " ylabel=\"Swath width (km)\",\n", - " title=\"CrIS swath width\",\n", - ")\n", - "ax.legend(frameon=False, fontsize=8)\n", - "fig.tight_layout()\n", - "plt.show()\n", - "pd.DataFrame(\n", - " {name: summarize(width - observed_width) for name, width in widths.items()}\n", - ").T.round(1)" - ] - }, - { - "cell_type": "markdown", - "id": "e8624671", - "metadata": {}, - "source": [ - "NOAA-20's geodetic altitude varies by about 30 km over an orbit, so the swath width varies by about 100 km. TAT-C's nominal field of regard reproduces this variation but is about 3 km too narrow (median); the measured field of regard (Test 2) agrees to within about 1.5 km (median; 5.5 km at the 95th percentile).\n", - "\n", - "### Swath Area\n", - "\n", - "Over one orbit (starting at 12:00 UTC), the area sampled by CrIS (the union of the quadrilaterals formed by the centers of adjacent FORs on consecutive scans) is compared with the union of TAT-C footprints from `compute_ground_track`, on a 0.1 deg grid:\n", - "\n", - "* a nadir `Instrument` with the nominal field of regard, at a 60 s time step (circular footprints of about 2,600 km diameter); and\n", - "* a rectangular `PointedInstrument` with the nominal field of regard as its cross-track field of view and the inertial velocity frame, at time steps of 8 s (one scan), 32 s, and 128 s, with the along-track field of view tailored to each time step: the angle subtended at nadir by the ground distance traveled in one time step.\n", - "\n", - "Footprints at the first and last time steps extend beyond the orbit. To compare swaths rather than these end effects, the comparison is limited to grid cells within 300 km of an FOR center sampled at least 128 s after the start and before the end of the orbit." - ] - }, - { - "cell_type": "code", - "execution_count": 12, - "id": "3c88ae31", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T13:54:51.043748Z", - "iopub.status.busy": "2026-10-25T13:54:51.043748Z", - "iopub.status.idle": "2026-10-25T13:55:04.642981Z", - "shell.execute_reply": "2026-10-25T13:55:04.642981Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
observed (10^6 km^2)TAT-C (10^6 km^2)IoUobserved only (%)TAT-C only (%)
field of regard, 60 s80.82779.8530.9861.2810.076
rectangular, 8 s (3.60 deg along track)80.82780.2490.9910.8150.101
rectangular, 32 s (14.32 deg along track)80.82780.3230.9910.7620.140
rectangular, 128 s (53.36 deg along track)80.82781.1670.9870.4400.857
\n", - "
" - ], - "text/plain": [ - " observed (10^6 km^2) \\\n", - "field of regard, 60 s 80.827 \n", - "rectangular, 8 s (3.60 deg along track) 80.827 \n", - "rectangular, 32 s (14.32 deg along track) 80.827 \n", - "rectangular, 128 s (53.36 deg along track) 80.827 \n", - "\n", - " TAT-C (10^6 km^2) IoU \\\n", - "field of regard, 60 s 79.853 0.986 \n", - "rectangular, 8 s (3.60 deg along track) 80.249 0.991 \n", - "rectangular, 32 s (14.32 deg along track) 80.323 0.991 \n", - "rectangular, 128 s (53.36 deg along track) 81.167 0.987 \n", - "\n", - " observed only (%) TAT-C only (%) \n", - "field of regard, 60 s 1.281 0.076 \n", - "rectangular, 8 s (3.60 deg along track) 0.815 0.101 \n", - "rectangular, 32 s (14.32 deg along track) 0.762 0.140 \n", - "rectangular, 128 s (53.36 deg along track) 0.440 0.857 " - ] - }, - "execution_count": 12, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "from shapely import contains_xy, prepare\n", - "\n", - "contiguous = np.diff(cris[\"MidTime\"][good]) < 1.5 * SCAN_PERIOD * 1e6\n", - "\n", - "\n", - "def observed_cells(points, scans):\n", - " \"\"\"Whether unit vectors lie within a quadrilateral cell of adjacent fields of regard on consecutive scans (a contiguous range of scan indices).\"\"\"\n", - " k0, k1 = scans[0], scans[-1]\n", - " cells = for_unit[k0 : k1 + 1]\n", - " tree = cKDTree(cells.reshape(-1, 3))\n", - " _, nearest = tree.query(points, k=2, workers=-1)\n", - " inside = np.zeros(len(points), dtype=bool)\n", - " for column in range(2):\n", - " k, j = np.divmod(nearest[:, column], N_FOR)\n", - " for dk in (-1, 0):\n", - " for dj in (-1, 0):\n", - " kk, jj = k + dk, j + dj\n", - " valid = (kk >= 0) & (kk < len(cells) - 1) & (jj >= 0) & (jj < N_FOR - 1)\n", - " kk, jj = np.clip(kk, 0, len(cells) - 2), np.clip(jj, 0, N_FOR - 2)\n", - " valid &= contiguous[k0 + kk]\n", - " corners = [\n", - " cells[kk, jj],\n", - " cells[kk, jj + 1],\n", - " cells[kk + 1, jj + 1],\n", - " cells[kk + 1, jj],\n", - " ]\n", - " signs = np.stack(\n", - " [\n", - " np.sum(np.cross(a, b) * points, axis=-1)\n", - " for a, b in zip(corners, corners[1:] + corners[:1])\n", - " ]\n", - " )\n", - " inside |= valid & (\n", - " np.all(signs >= 0, axis=0) | np.all(signs <= 0, axis=0)\n", - " )\n", - " return inside\n", - "\n", - "\n", - "STEP4, MARGIN4 = 0.1, 128 # deg, s\n", - "lon_grid, lat_grid = np.meshgrid(\n", - " np.arange(-180 + STEP4 / 2, 180, STEP4), np.arange(-90 + STEP4 / 2, 90, STEP4)\n", - ")\n", - "cell_area = np.cos(np.radians(lat_grid)) * (STEP4 * 111.32) ** 2 # km^2\n", - "grid_unit = up(lon_grid.ravel(), lat_grid.ravel())\n", - "orbit_start = datetime(2026, 10, 2, 12, tzinfo=timezone.utc)\n", - "orbit_period = timedelta(days=1 / float(tle[1][52:63]))\n", - "scans4 = np.nonzero((t_mid >= orbit_start) & (t_mid < orbit_start + orbit_period))[0]\n", - "first, last = t_mid[scans4[0]].to_pydatetime(), t_mid[scans4[-1]].to_pydatetime()\n", - "# grid cells near fields of regard sampled away from the ends of the orbit\n", - "distance, nearest = cKDTree(for_unit[scans4].reshape(-1, 3)).query(\n", - " grid_unit, workers=-1\n", - ")\n", - "nearest_time = (\n", - " (t_mid[scans4] - t_mid[scans4[0]]).total_seconds().to_numpy()[nearest // N_FOR]\n", - ")\n", - "compared = (\n", - " (distance < 2 * np.sin(300 / 6371 / 2))\n", - " & (nearest_time > MARGIN4)\n", - " & (nearest_time < (last - first).total_seconds() - MARGIN4)\n", - ")\n", - "observed4 = np.zeros(len(grid_unit), dtype=bool)\n", - "observed4[compared] = observed_cells(grid_unit[compared], scans4)\n", - "ground_speed = (\n", - " 2 * np.pi * 6371.0088e3 / orbit_period.total_seconds()\n", - ") # m/s, approximate\n", - "altitude = float(np.median(sub4.elevation.m))\n", - "\n", - "\n", - "def swath_area_row(instrument, time_step, attitude=None):\n", - " n = int((last - first).total_seconds() // time_step)\n", - " times = [first + timedelta(seconds=time_step * (i + 0.5)) for i in range(n)]\n", - " geometry = compute_ground_track(\n", - " on_noaa20(instrument, attitude), times\n", - " ).geometry.iloc[0]\n", - " prepare(geometry)\n", - " predicted = np.zeros(len(grid_unit), dtype=bool)\n", - " predicted[compared] = contains_xy(\n", - " geometry, lon_grid.ravel()[compared], lat_grid.ravel()[compared]\n", - " )\n", - " area = lambda mask: np.sum(mask * cell_area.ravel()) / 1e6\n", - " return predicted.reshape(lat_grid.shape), {\n", - " \"observed (10^6 km^2)\": area(observed4),\n", - " \"TAT-C (10^6 km^2)\": area(predicted),\n", - " \"IoU\": area(observed4 & predicted) / area(observed4 | predicted),\n", - " \"observed only (%)\": 100 * area(observed4 & ~predicted) / area(observed4),\n", - " \"TAT-C only (%)\": 100 * area(predicted & ~observed4) / area(predicted),\n", - " }\n", - "\n", - "\n", - "swath_rows, swath_maps = {}, {}\n", - "swath_maps[\"field of regard, 60 s\"], swath_rows[\"field of regard, 60 s\"] = (\n", - " swath_area_row(Instrument(name=\"CrIS\", field_of_regard=2 * EDGE), 60)\n", - ")\n", - "for time_step in [SCAN_PERIOD, 32, 128]:\n", - " along_fov = np.degrees(2 * np.arctan(ground_speed * time_step / 2 / altitude))\n", - " name = f\"rectangular, {time_step:.3g} s ({along_fov:.2f} deg along track)\"\n", - " swath_maps[name], swath_rows[name] = swath_area_row(\n", - " PointedInstrument(\n", - " name=\"CrIS\",\n", - " field_of_regard=2 * EDGE,\n", - " cross_track_field_of_view=2 * EDGE,\n", - " along_track_field_of_view=along_fov,\n", - " is_rectangular=True,\n", - " ),\n", - " time_step,\n", - " INERTIAL,\n", - " )\n", - "observed4 = observed4.reshape(lat_grid.shape)\n", - "pd.DataFrame(swath_rows).T.round(3)" - ] - }, - { - "cell_type": "code", - "execution_count": 13, - "id": "8856aebf", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T13:55:04.648989Z", - "iopub.status.busy": "2026-10-25T13:55:04.648989Z", - "iopub.status.idle": "2026-10-25T13:55:11.663760Z", - "shell.execute_reply": "2026-10-25T13:55:11.663760Z" - } - }, - "outputs": [ - { - "data": { - "image/png": "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", - "text/plain": [ - "
" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "fig, axes = plt.subplots(\n", - " 1, 2, figsize=(12, 4.2), subplot_kw={\"projection\": ccrs.PlateCarree()}\n", - ")\n", - "for ax, name in zip(axes, [list(swath_maps)[0], list(swath_maps)[-1]]):\n", - " predicted = swath_maps[name]\n", - " category = np.where(\n", - " observed4 & predicted, 1, np.where(observed4, 2, np.where(predicted, 3, 0))\n", - " ).astype(float)\n", - " category[~compared.reshape(lat_grid.shape)] = 0\n", - " ax.pcolormesh(\n", - " lon_grid,\n", - " lat_grid,\n", - " np.ma.masked_equal(category, 0),\n", - " cmap=plt.matplotlib.colors.ListedColormap([\"#d9d8d3\", ORANGE, BLUE]),\n", - " vmin=0.5,\n", - " vmax=3.5,\n", - " transform=ccrs.PlateCarree(),\n", - " shading=\"auto\",\n", - " )\n", - " ax.coastlines(color=GRAY, linewidth=0.5)\n", - " ax.set_global()\n", - " ax.set_title(f\"TAT-C {name}\", fontsize=9)\n", - "axes[0].plot([], [], color=\"#d9d8d3\", lw=6, label=\"both\")\n", - "axes[0].plot([], [], color=ORANGE, lw=6, label=\"observed only\")\n", - "axes[0].plot([], [], color=BLUE, lw=6, label=\"TAT-C only\")\n", - "axes[0].legend(frameon=False, loc=\"lower left\", fontsize=8)\n", - "fig.tight_layout()\n", - "plt.show()" + "With all three accounted for, TAT-C reproduces the centers of the CrIS FOR arrays to 0.5 km (median) and 0.7 km (95th percentile) everywhere in the swath, comparable to the orbit error of Test 1. The residuals of all FOVs are larger (95th percentile of about 35 km) only because TAT-C does not rotate the FOV array: its FOVs are displaced from the true ones, by up to about 60 km at the swath edges, which does not affect the extent of the swath or the footprint size." ] }, { @@ -2058,11 +1639,7 @@ "id": "38f2e5e7", "metadata": {}, "source": [ - "All configurations reproduce the area sampled over one orbit with an intersection over union (IoU) of 0.99. The differences are thin slivers along the swath edges, mostly area observed but not predicted (0.4 to 1.3%), consistent with TAT-C's slightly narrow nominal swath. Tailoring the along-track field of view to the time step makes consecutive rectangular footprints tile the swath at every time step tested, so the time step can be chosen for computational cost. At 128 s, footprints spanning 53 deg along track begin to bulge beyond the swath edges (TAT-C only, 0.9%).\n", - "\n", - "Note that the swath of FOR centers compared here is narrower than the swath of complete footprints: the outermost FORs sample beyond their centers by about half of their cross-track footprint size (Test 5), about 20 km.\n", - "\n", - "## Test 5: Footprint Size\n", + "## Test 4: Footprint Size\n", "\n", "The CrIS geolocation file does not report footprint dimensions. A footprint is the projection of a FOV, a circle 0.963 deg in diameter (a published specification, not derived from the data) onto the surface. Its along-track dimension is the slant range times the angular diameter, and its cross-track dimension is longer by the secant of the satellite zenith angle at the surface (on a flat surface). The reported zenith angles and slant ranges, which describe the viewing geometry, are therefore compared first with TAT-C's: the zenith angle from the satellite's elevation as seen from each pixel (`collect_ground_pixels` with `sat_altaz=True`), and the slant range from the zenith angle and the sub-satellite height on a spherical Earth. The comparison uses the central FOV of each FOR, which the array rotation does not displace." ] @@ -2470,7 +2047,7 @@ "source": [ "## Summary\n", "\n", - "The parameters fitted to the NOAA-20 CrIS data, used by the [monsoon OSSE example](../examples/RunOSSEMonsoon.ipynb):" + "The parameters fitted to the NOAA-20 CrIS data (the catalog's `cris` entry carries a field of regard and scan plane tilt measured in the same way, from which the [monsoon OSSE example](../examples/RunOSSEMonsoon.ipynb) takes its CrIS swath):" ] }, { diff --git a/docs/validation/ValidateImagerVIIRS.ipynb b/docs/validation/ValidateImagerVIIRS.ipynb index 60030667..218c2611 100644 --- a/docs/validation/ValidateImagerVIIRS.ipynb +++ b/docs/validation/ValidateImagerVIIRS.ipynb @@ -9,13 +9,14 @@ "\n", "This notebook validates TAT-C's representation of horizontal imagers against the [Visible Infrared Imaging Radiometer Suite (VIIRS)](https://www.star.nesdis.noaa.gov/jpss/VIIRS.php) aboard NOAA-20 (JPSS-1). VIIRS is a 22-band visible and infrared radiometer with a rotating telescope that scans perpendicular to the flight direction every 1.79 s, within 56.28 deg of nadir (a swath about 3,040 km wide). Each scan images 16 rows of moderate-resolution (M-band) detectors at once, about 750 m apart at nadir, so a scan covers a strip about 12 km long along track: about the distance NOAA-20's ground track advances in one scan period. Across track, the samples of each row are aggregated on board into 3,200 pixels, in three zones that keep the pixel size more uniform across the scan.\n", "\n", - "As described in the companion notebook, [Imager Validation: NOAA-20 ATMS](ValidateImagerATMS.ipynb), TAT-C represents a nadir-pointing imager as an `Instrument` with a field of regard or a `PointedInstrument` with cross-track and along-track fields of view, and does not model the scan mechanism: the along-track field of view stands in for the time the instrument takes to sweep the ground. VIIRS is a natural test of this convention, since its 16-detector array is designed to cover the ground traveled in one scan. The ATMS notebook found that NOAA-20 scans perpendicular to its *inertial* velocity and that a satellite with an inertial velocity frame (`Attitude(velocity_frame=VelocityFrame.INERTIAL)`), whose instruments' views are rotated from its body, reproduces this. This notebook asks five questions:\n", + "As described in the companion notebook, [Imager Validation: NOAA-20 ATMS](ValidateImagerATMS.ipynb), TAT-C represents a nadir-pointing imager as an `Instrument` with a field of regard or a `PointedInstrument` with cross-track and along-track fields of view, and does not model the scan mechanism: the along-track field of view stands in for the time the instrument takes to sweep the ground. VIIRS is a natural test of this convention, since its 16-detector array is designed to cover the ground traveled in one scan. The ATMS notebook found that NOAA-20 scans perpendicular to its *inertial* velocity and that a satellite with an inertial velocity frame (`Attitude(velocity_frame=VelocityFrame.INERTIAL)`), whose instruments' views are rotated from its body, reproduces this. This notebook asks four questions:\n", "\n", "1. **Orbit.** Does TAT-C's propagation of the operational two-line element (TLE) set reproduce NOAA-20's position?\n", "2. **Scan geometry.** What are VIIRS's scan angles and the angular extent of its detector array, and is its scan perpendicular to the inertial velocity like that of ATMS?\n", "3. **Scan footprint.** Does a rectangular `PointedInstrument` view, tailored to one scan period, reproduce the ground footprint of a VIIRS scan, including its growth toward the swath edges (the \"bow tie\" effect)?\n", "4. **Swath width.** Does the field of regard reproduce the VIIRS swath width?\n", - "5. **Daily observations.** Does `collect_observations` predict which points VIIRS observes in a day, when, and at what elevation angle?" + "\n", + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `viirs` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_viirs.py`; see the [instrument catalog](catalog.rst)." ] }, { @@ -1469,324 +1470,7 @@ "id": "3605079f", "metadata": {}, "source": [ - "The VIIRS swath is about 3,020 km wide near the equator and 3,140 km at high southern latitudes, following NOAA-20's geodetic altitude as for ATMS. TAT-C's nominal field of regard makes it about 47 km too wide (median); the measured field of regard (Test 2) agrees to within 3 km (median). The swath of that minimum elevation angle is similarly too wide near the equator.\n", - "\n", - "## Test 5: Daily Observations\n", - "\n", - "`collect_observations` is evaluated for 2,598 points on a Fibonacci lattice with a typical spacing of 500 km, as in the ATMS notebook.\n", - "\n", - "**Observed.** A point is observed by a granule if it lies inside the granule's G-ring (a polygon of 8 vertices on the outermost pixel centers, connected by great circles). Granules observing a point less than 20 minutes apart belong to the same pass. The observation time is interpolated between the granule's first and last scans from the point's distances to the great circles through the G-ring's first and last scan lines, and the elevation angle is computed from the reported spacecraft position at that time.\n", - "\n", - "**Predicted.** A nadir `Instrument` and the rectangular `PointedInstrument` of Test 3 (inertial frame, along-track field of view tailored to one scan), each with the nominal field of regard, and the same `PointedInstrument` with the measured field of regard (Test 2). Predicted and observed passes of the same point are matched if their times differ by less than 10 minutes." - ] - }, - { - "cell_type": "code", - "execution_count": 10, - "id": "fd46c4ea", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T13:56:26.592398Z", - "iopub.status.busy": "2026-10-25T13:56:26.592398Z", - "iopub.status.idle": "2026-10-25T13:59:42.759086Z", - "shell.execute_reply": "2026-10-25T13:59:42.759086Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
observedpredictedmatchedobserved onlypredicted onlytime, median (s)time, p95 |x| (s)elevation, median (deg)elevation, p95 |x| (deg)
nadir Instrument8715.08987.08715.00.0272.00.2613.610.030.10
PointedInstrument, inertial8715.08941.08715.00.0226.00.221.990.000.05
PointedInstrument, inertial, measured field of regard8715.08837.08700.015.0137.00.231.990.000.05
\n", - "
" - ], - "text/plain": [ - " observed predicted \\\n", - "nadir Instrument 8715.0 8987.0 \n", - "PointedInstrument, inertial 8715.0 8941.0 \n", - "PointedInstrument, inertial, measured field of ... 8715.0 8837.0 \n", - "\n", - " matched observed only \\\n", - "nadir Instrument 8715.0 0.0 \n", - "PointedInstrument, inertial 8715.0 0.0 \n", - "PointedInstrument, inertial, measured field of ... 8700.0 15.0 \n", - "\n", - " predicted only \\\n", - "nadir Instrument 272.0 \n", - "PointedInstrument, inertial 226.0 \n", - "PointedInstrument, inertial, measured field of ... 137.0 \n", - "\n", - " time, median (s) \\\n", - "nadir Instrument 0.26 \n", - "PointedInstrument, inertial 0.22 \n", - "PointedInstrument, inertial, measured field of ... 0.23 \n", - "\n", - " time, p95 |x| (s) \\\n", - "nadir Instrument 13.61 \n", - "PointedInstrument, inertial 1.99 \n", - "PointedInstrument, inertial, measured field of ... 1.99 \n", - "\n", - " elevation, median (deg) \\\n", - "nadir Instrument 0.03 \n", - "PointedInstrument, inertial 0.00 \n", - "PointedInstrument, inertial, measured field of ... 0.00 \n", - "\n", - " elevation, p95 |x| (deg) \n", - "nadir Instrument 0.10 \n", - "PointedInstrument, inertial 0.05 \n", - "PointedInstrument, inertial, measured field of ... 0.05 " - ] - }, - "execution_count": 10, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "points5 = generate_points_fibonacci_lattice(500e3)\n", - "point_xyz = up(points5.geometry.x.to_numpy(), points5.geometry.y.to_numpy())\n", - "ring = up(viirs[\"gring_lon\"], viirs[\"gring_lat\"]) # (granule, vertex, 3)\n", - "last_scan = viirs[\"n_scans\"] - 1\n", - "gran_first = iet_to_utc(viirs[\"MidTime\"][:, 0])\n", - "gran_last = iet_to_utc(viirs[\"MidTime\"][np.arange(len(ring)), last_scan])\n", - "first_sub = normalize(viirs[\"SCPosition\"][:, 0].astype(float))\n", - "observed_rows = []\n", - "for g in range(len(ring)):\n", - " vertices = ring[g]\n", - " edges = np.cross(vertices, np.roll(vertices, -1, axis=0))\n", - " # inside every edge's great circle, on the same side as the polygon's centroid\n", - " orientation = np.sign(edges @ vertices.mean(axis=0))\n", - " inside = np.all((point_xyz @ edges.T) * orientation >= 0, axis=1)\n", - " if not inside.any():\n", - " continue\n", - " # scan lines through G-ring vertices 2-4 and 6-0; the first is the one nearest the first scan's nadir\n", - " lines = [\n", - " normalize(np.cross(vertices[2], vertices[4])),\n", - " normalize(np.cross(vertices[6], vertices[0])),\n", - " ]\n", - " if np.abs(lines[1] @ first_sub[g]) < np.abs(lines[0] @ first_sub[g]):\n", - " lines = lines[::-1]\n", - " d_first, d_last = (np.abs(point_xyz[inside] @ line) for line in lines)\n", - " fraction = d_first / (d_first + d_last)\n", - " times = gran_first[g] + (gran_last[g] - gran_first[g]) * fraction\n", - " for p, t in zip(np.flatnonzero(inside), times):\n", - " observed_rows.append({\"point_id\": p, \"granule\": g, \"time\": t})\n", - "observed5 = (\n", - " pd.DataFrame(observed_rows)\n", - " .astype({\"point_id\": \"int64\"})\n", - " .sort_values([\"point_id\", \"time\"])\n", - ")\n", - "# one observation per pass (granules less than 20 minutes apart)\n", - "new_pass = observed5.groupby(\"point_id\").time.diff().fillna(\n", - " pd.Timedelta(days=1)\n", - ") > pd.Timedelta(minutes=20)\n", - "observed5 = observed5[new_pass.to_numpy()].reset_index(drop=True)\n", - "# elevation angle from the reported spacecraft position, interpolated linearly in time between scans\n", - "scan_seconds = (scan_mid - scan_mid[0]).total_seconds().to_numpy()\n", - "obs_seconds = (observed5.time - scan_mid[0]).dt.total_seconds().to_numpy()\n", - "k = np.clip(np.searchsorted(scan_seconds, obs_seconds) - 1, 0, len(scan_seconds) - 2)\n", - "position = scan_pos[k] + scan_vel[k] * (obs_seconds - scan_seconds[k])[:, np.newaxis]\n", - "target = ecef(\n", - " points5.geometry.x.to_numpy()[observed5.point_id],\n", - " points5.geometry.y.to_numpy()[observed5.point_id],\n", - ")\n", - "observed5[\"elevation\"] = np.degrees(\n", - " np.arcsin(\n", - " np.sum(normalize(position - target) * point_xyz[observed5.point_id], axis=-1)\n", - " )\n", - ")\n", - "\n", - "start5, end5 = scan_mid[0].to_pydatetime(), scan_mid[-1].to_pydatetime()\n", - "instruments5 = {\n", - " \"nadir Instrument\": Instrument(name=\"VIIRS\", field_of_regard=2 * EDGE),\n", - " \"PointedInstrument, inertial\": viirs_view,\n", - " \"PointedInstrument, inertial, measured field of regard\": viirs_view.model_copy(\n", - " update={\n", - " \"field_of_regard\": measured_for,\n", - " \"cross_track_field_of_view\": measured_for,\n", - " }\n", - " ),\n", - "}\n", - "\n", - "\n", - "def match(predicted):\n", - " \"\"\"Match predicted and observed passes of each point by time.\"\"\"\n", - " return pd.merge_asof(\n", - " observed5.sort_values(\"time\"),\n", - " predicted[[\"point_id\", \"epoch\", \"sat_alt\"]].sort_values(\"epoch\"),\n", - " left_on=\"time\",\n", - " right_on=\"epoch\",\n", - " by=\"point_id\",\n", - " direction=\"nearest\",\n", - " tolerance=pd.Timedelta(minutes=10),\n", - " )\n", - "\n", - "\n", - "predicted5, matched5, rows5 = {}, {}, {}\n", - "for name, instrument in instruments5.items():\n", - " satellite = noaa20.model_copy(update={\"instruments\": [instrument]})\n", - " predicted5[name] = pd.concat(\n", - " [\n", - " collect_observations(\n", - " Point(latitude=g.y, longitude=g.x), satellite, start5, end5\n", - " ).assign(point_id=p)\n", - " for p, g in enumerate(points5.geometry)\n", - " ]\n", - " ).reset_index(drop=True)\n", - " predicted5[name][\"point_id\"] = predicted5[name].point_id.astype(\"int64\")\n", - " matched5[name] = match(predicted5[name])\n", - " hit = matched5[name].epoch.notna()\n", - " dt = (matched5[name].epoch - matched5[name].time).dt.total_seconds()[hit]\n", - " rows5[name] = {\n", - " \"observed\": len(observed5),\n", - " \"predicted\": len(predicted5[name]),\n", - " \"matched\": int(hit.sum()),\n", - " \"observed only\": int((~hit).sum()),\n", - " \"predicted only\": len(predicted5[name]) - int(hit.sum()),\n", - " \"time, median (s)\": np.median(dt),\n", - " \"time, p95 |x| (s)\": np.percentile(np.abs(dt), 95),\n", - " \"elevation, median (deg)\": np.median(\n", - " (matched5[name].sat_alt - matched5[name].elevation)[hit]\n", - " ),\n", - " \"elevation, p95 |x| (deg)\": np.percentile(\n", - " np.abs(matched5[name].sat_alt - matched5[name].elevation)[hit], 95\n", - " ),\n", - " }\n", - "pd.DataFrame(rows5).T.round(2)" - ] - }, - { - "cell_type": "code", - "execution_count": 11, - "id": "7f814559", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T13:59:42.761090Z", - "iopub.status.busy": "2026-10-25T13:59:42.761090Z", - "iopub.status.idle": "2026-10-25T13:59:43.139997Z", - "shell.execute_reply": "2026-10-25T13:59:43.139997Z" - } - }, - "outputs": [ - { - "data": { - "image/png": "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", - "text/plain": [ - "
" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "fig, axes = plt.subplots(1, 2, figsize=(11, 3.8))\n", - "for (name, matched), color in zip(matched5.items(), [BLUE, AQUA, ORANGE]):\n", - " hit = matched.epoch.notna()\n", - " dt = (matched.epoch - matched.time).dt.total_seconds()\n", - " axes[0].hist(\n", - " dt[hit],\n", - " bins=np.arange(-20, 20.5, 0.5),\n", - " color=color,\n", - " histtype=\"step\",\n", - " lw=1.5,\n", - " label=name,\n", - " )\n", - "axes[0].set(xlabel=\"TAT-C minus VIIRS (s)\", ylabel=\"Passes\", title=\"Observation time\")\n", - "axes[0].legend(frameon=False, fontsize=8)\n", - "lat_edges = np.arange(-90, 91, 10)\n", - "point_lat = points5.geometry.y.to_numpy()\n", - "n_points = np.histogram(point_lat, lat_edges)[0]\n", - "axes[1].plot(\n", - " (lat_edges[:-1] + lat_edges[1:]) / 2,\n", - " np.histogram(point_lat[observed5.point_id], lat_edges)[0] / n_points,\n", - " color=INK,\n", - " marker=\"o\",\n", - " ms=3,\n", - " label=\"observed (VIIRS)\",\n", - ")\n", - "for (name, predicted), color in zip(predicted5.items(), [BLUE, AQUA, ORANGE]):\n", - " axes[1].plot(\n", - " (lat_edges[:-1] + lat_edges[1:]) / 2,\n", - " np.histogram(point_lat[predicted.point_id], lat_edges)[0] / n_points,\n", - " color=color,\n", - " ls=\"--\",\n", - " label=name,\n", - " )\n", - "axes[1].set(\n", - " xlabel=\"Point latitude (deg)\",\n", - " ylabel=\"Observations per point per day\",\n", - " title=\"Daily observations\",\n", - ")\n", - "axes[1].legend(frameon=False, fontsize=8)\n", - "fig.tight_layout()\n", - "plt.show()" + "The VIIRS swath is about 3,020 km wide near the equator and 3,140 km at high southern latitudes, following NOAA-20's geodetic altitude as for ATMS. TAT-C's nominal field of regard makes it about 47 km too wide (median); the measured field of regard (Test 2) agrees to within 3 km (median). The swath of that minimum elevation angle is similarly too wide near the equator." ] }, { @@ -1794,10 +1478,6 @@ "id": "95cd8009", "metadata": {}, "source": [ - "Every observed pass is predicted by the nadir `Instrument` and the `PointedInstrument` with the nominal field of regard, from about 2 observations per day at the equator to about 11 near the poles. About 2 to 3% of predicted passes were not observed: with the nominal field of regard, TAT-C's swath is about 47 km too wide (Test 4), and the excess shows near the poles, where many points lie near swath edges. The measured field of regard reduces these to 1.6% while matching 99.8% of observed passes; the remainder are at the swath edges, where the G-ring (three vertices per 570 km granule edge) only approximates the outermost pixels.\n", - "\n", - "As for ATMS, the nadir `Instrument`'s epochs (the time of closest approach) differ from the time VIIRS scans a point by about 14 s (95th percentile), because the scan is rotated from the perpendicular to the ground track, while an inertial-frame `PointedInstrument` agrees to within 2 s (95th percentile), the precision of the observation times interpolated from the G-ring. Elevation angles agree to a few hundredths of a degree.\n", - "\n", "## Summary\n", "\n", "| Test | Result |\n", @@ -1806,9 +1486,8 @@ "| 2. Scan geometry | outermost samples 56.13 and 55.96 deg from nadir (field of regard 112.09 deg vs. nominal 112.56 deg); detector array 0.817 deg along track at all scan angles, matching the 0.814 deg tailored to one scan period; scan perpendicular to the *inertial* velocity (within 0.12 deg) |\n", "| 3. Scan footprint | view tailored to one scan matches the 11.9 km scan length at nadir; at the edges, 25.9 km in scan geometry (`ViewGeometry.SCAN`) vs. 25 km observed, but only 14.5 km in the default frame geometry; consecutive footprints tile the swath |\n", "| 4. Swath width | 47 km too wide with the nominal field of regard, 3 km with the measured one (median) |\n", - "| 5. Daily observations (`collect_observations`) | all observed passes predicted with the nominal field of regard (2 to 3% extra), 99.8% with the measured one (1.6% extra); epochs within 2 s (95th percentile) for an inertial-frame `PointedInstrument`, vs. 14 s for a nadir `Instrument` |\n", "\n", - "**Scan orientation and timing.** VIIRS confirms the ATMS findings: NOAA-20's instruments scan perpendicular to the inertial velocity, so the inertial velocity frame (`Attitude(velocity_frame=VelocityFrame.INERTIAL)` of the satellite) is the appropriate setting for either instrument, and it makes the observation epochs of `collect_observations` match the actual scan times. VIIRS's Earth view lasts only 0.56 s, so the along-track error from observing a whole view at one instant is under 2 km at the swath edges.\n", + "**Scan orientation and timing.** VIIRS confirms the ATMS findings: NOAA-20's instruments scan perpendicular to the inertial velocity, so the inertial velocity frame (`Attitude(velocity_frame=VelocityFrame.INERTIAL)` of the satellite) is the appropriate setting for either instrument. VIIRS's Earth view lasts only 0.56 s, so the along-track error from observing a whole view at one instant is under 2 km at the swath edges.\n", "\n", "**Along-track field of view as integration time.** VIIRS's 16-detector array is designed to cover the ground traveled in one scan period, and the along-track field of view tailored to one scan period (0.814 deg) matches its angular extent (0.817 deg). At nadir, TAT-C's footprint therefore matches a VIIRS scan. Toward the swath edges, however, TAT-C's default (frame geometry) view is a rectangle in the plane perpendicular to the boresight, like the focal plane of a framing camera or pushbroom imager, so its angular along-track extent shrinks as the cosine of the scan angle. A scanning imager such as VIIRS keeps a constant angular extent, so its scans grow to about twice their nadir length at the edges and overlap (the bow tie effect). The scan geometry (`view_geometry=ViewGeometry.SCAN`) reproduces this; with the frame geometry, footprints still tile the swath, so coverage and revisit are unaffected, but footprint and pixel sizes near the edges of a scanning imager's swath are underestimated by up to about 40%.\n", "\n", diff --git a/docs/validation/ValidateSARNISAR.ipynb b/docs/validation/ValidateSARNISAR.ipynb index 4d2b53cf..f7e2f202 100644 --- a/docs/validation/ValidateSARNISAR.ipynb +++ b/docs/validation/ValidateSARNISAR.ipynb @@ -11,13 +11,13 @@ "\n", "In TAT-C, a side-looking instrument is a `PointedInstrument` whose view is rotated from nadir by a roll angle (positive to the left of the direction of motion), with a cross-track field of view spanning the swath. TAT-C rotates the view rigidly and, by default, orients it relative to the Earth-fixed velocity (`VelocityFrame.EARTH_FIXED`). SAR images are formed in *zero-Doppler* geometry: each image line contains the targets at the closest approach to the radar, which lie in the plane perpendicular to the Earth-fixed velocity, whatever the spacecraft's attitude. TAT-C's default frame should therefore match a SAR's imaging geometry, as the companion notebooks on NOAA-20 imagers ([ATMS](ValidateImagerATMS.ipynb), [VIIRS](ValidateImagerVIIRS.ipynb)) found the inertial frame matches an instrument that scans without yaw steering.\n", "\n", - "The comparison asks five questions:\n", + "The comparison asks three questions:\n", "\n", "1. **Orbit.** Does TAT-C's propagation of a public two-line element (TLE) set reproduce NISAR's position?\n", "2. **Imaging geometry.** What look direction, look angles, and imaging plane do NISAR's products describe, and which TAT-C roll angle, field of view, and velocity frame reproduce them?\n", "3. **Swath edges.** How closely do the edges of TAT-C's view match the near-range and far-range edges of NISAR's images?\n", - "4. **Frame footprints.** Does `compute_ground_track` reproduce the footprints of all the frames NISAR acquired in a day?\n", - "5. **Observation times.** Does `collect_observations` predict when NISAR images a point?" + "\n", + "Passes, swath edges, swath intersection over union (IoU), and observation epochs of the catalog's `lsar` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_lsar.py`; see the [instrument catalog](catalog.rst)." ] }, { @@ -1305,540 +1305,7 @@ "id": "f07b498f", "metadata": {}, "source": [ - "With the Earth-fixed velocity frame, TAT-C's view edges match the image edges to within about 2 km along track and 5 to 7 km across track (95th percentile). The cross-track residual reflects the variation of the look angles within each mode (Test 2). The inertial velocity frame displaces the edges by 30 to 50 km along track (95th percentile), the rotation of the zero-Doppler plane over the slant range to the swath.\n", - "\n", - "## Test 4: Frame Footprints\n", - "\n", - "For every RSLC product acquired on the day, TAT-C's footprints from `compute_ground_track`, with its mode's roll angle and field of view, at time steps of about 5 s between the product's zero-Doppler start and end times (with the along-track field of view tailored to the time step, as in the imager notebooks), are merged and compared with the product's bounding polygon, in an azimuthal equidistant projection centered on the product." - ] - }, - { - "cell_type": "code", - "execution_count": 8, - "id": "f80b0a1d", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T14:00:49.372860Z", - "iopub.status.busy": "2026-10-25T14:00:49.372860Z", - "iopub.status.idle": "2026-10-25T14:01:06.296143Z", - "shell.execute_reply": "2026-10-25T14:01:06.296143Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
countmeanstdmin5%50%maxgroup
IoU855.00.9310.0410.7130.8510.9440.970all
full596.00.9480.0140.8800.9220.9510.970coverage
partial259.00.8900.0520.7130.7850.9060.961coverage
0005_NADV33.00.9440.0270.8790.8840.9580.965mode
0005_NASV273.00.9320.0380.7220.8700.9440.970mode
0500_SHNA4.00.9520.0160.9280.9330.9600.963mode
0505_SHSV3.00.9640.0030.9620.9620.9630.968mode
0505_SVSH45.00.9460.0330.7930.8780.9580.968mode
2000_DVNA1.00.965NaN0.9650.9650.9650.965mode
2005_DHDH204.00.9220.0390.7130.8470.9340.961mode
2005_DVDV2.00.9630.0040.9600.9600.9630.966mode
2005_QPDH10.00.9370.0340.8740.8780.9570.965mode
2005_SHSH2.00.9460.0090.9400.9400.9460.952mode
4005_DHDH174.00.9300.0490.7410.7980.9500.968mode
4005_SHSH84.00.9280.0450.7510.8560.9470.960mode
7700_SHNA20.00.9310.0250.8810.8850.9410.961mode
\n", - "
" - ], - "text/plain": [ - " count mean std min 5% 50% max group\n", - "IoU 855.0 0.931 0.041 0.713 0.851 0.944 0.970 all\n", - "full 596.0 0.948 0.014 0.880 0.922 0.951 0.970 coverage\n", - "partial 259.0 0.890 0.052 0.713 0.785 0.906 0.961 coverage\n", - "0005_NADV 33.0 0.944 0.027 0.879 0.884 0.958 0.965 mode\n", - "0005_NASV 273.0 0.932 0.038 0.722 0.870 0.944 0.970 mode\n", - "0500_SHNA 4.0 0.952 0.016 0.928 0.933 0.960 0.963 mode\n", - "0505_SHSV 3.0 0.964 0.003 0.962 0.962 0.963 0.968 mode\n", - "0505_SVSH 45.0 0.946 0.033 0.793 0.878 0.958 0.968 mode\n", - "2000_DVNA 1.0 0.965 NaN 0.965 0.965 0.965 0.965 mode\n", - "2005_DHDH 204.0 0.922 0.039 0.713 0.847 0.934 0.961 mode\n", - "2005_DVDV 2.0 0.963 0.004 0.960 0.960 0.963 0.966 mode\n", - "2005_QPDH 10.0 0.937 0.034 0.874 0.878 0.957 0.965 mode\n", - "2005_SHSH 2.0 0.946 0.009 0.940 0.940 0.946 0.952 mode\n", - "4005_DHDH 174.0 0.930 0.049 0.741 0.798 0.950 0.968 mode\n", - "4005_SHSH 84.0 0.928 0.045 0.751 0.856 0.947 0.960 mode\n", - "7700_SHNA 20.0 0.931 0.025 0.881 0.885 0.941 0.961 mode" - ] - }, - "execution_count": 8, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "TIME_STEP = 5 # s\n", - "ground_speed = 2 * np.pi * 6371.0088e3 / (86400 / float(TLE[1][52:63]))\n", - "altitude = float(np.median(geometry[\"altitude (km)\"])) * 1e3\n", - "\n", - "\n", - "def nisar_view(mode, time_step=TIME_STEP):\n", - " \"\"\"Rectangular, left-looking view of a NISAR mode, with the along-track field of view tailored to a time step (s).\"\"\"\n", - " return PointedInstrument(\n", - " name=\"NISAR L-SAR\",\n", - " field_of_regard=2 * (modes[\"far look (deg)\"].max() + 1),\n", - " cross_track_field_of_view=modes.loc[mode, \"field of view (deg)\"],\n", - " along_track_field_of_view=np.degrees(\n", - " 2 * np.arctan(ground_speed * time_step / 2 / altitude)\n", - " ),\n", - " roll_angle=modes.loc[mode, \"roll (deg)\"],\n", - " is_rectangular=True,\n", - " )\n", - "\n", - "\n", - "def unwrap(geometry):\n", - " \"\"\"Shift longitudes of a polygon that crosses the antimeridian to be continuous.\"\"\"\n", - " lon = np.array(geometry.exterior.coords)[:, 0]\n", - " if lon.max() - lon.min() > 180:\n", - " return shapely.ops.transform(\n", - " lambda x, y, z=None: (\n", - " np.where(np.asarray(x) < 0, np.asarray(x) + 360, x),\n", - " y,\n", - " ),\n", - " geometry,\n", - " )\n", - " return geometry\n", - "\n", - "\n", - "def footprint_row(product):\n", - " start, end = pd.Timestamp(product.zero_doppler_start, tz=\"UTC\"), pd.Timestamp(\n", - " product.zero_doppler_end, tz=\"UTC\"\n", - " )\n", - " n = max(1, int(round((end - start).total_seconds() / TIME_STEP)))\n", - " step = (end - start) / n\n", - " times = [(start + step * (i + 0.5)).floor(\"us\").to_pydatetime() for i in range(n)]\n", - " satellite = nisar.model_copy(\n", - " update={\"instruments\": [nisar_view(product[\"mode\"], step.total_seconds())]}\n", - " )\n", - " predicted = compute_ground_track(satellite, times).geometry.iloc[0]\n", - " observed = unwrap(shapely.force_2d(shapely.from_wkt(product.polygon)))\n", - " center = observed.centroid\n", - " project = Transformer.from_crs(\n", - " \"EPSG:4326\",\n", - " f\"+proj=aeqd +lat_0={center.y} +lon_0={center.x} +units=m\",\n", - " always_xy=True,\n", - " ).transform\n", - " a, b = transform_geometry(project, observed).buffer(0), transform_geometry(\n", - " project, predicted\n", - " ).buffer(0)\n", - " return {\n", - " \"granule\": product.granule,\n", - " \"observed (km^2)\": a.area / 1e6,\n", - " \"TAT-C (km^2)\": b.area / 1e6,\n", - " \"IoU\": a.intersection(b).area / a.union(b).area,\n", - " \"latitude\": center.y,\n", - " }\n", - "\n", - "\n", - "footprints = pd.DataFrame(\n", - " [footprint_row(product) for _, product in catalog.iterrows()]\n", - ").merge(catalog[[\"granule\", \"mode\", \"direction\", \"coverage\"]])\n", - "pd.concat(\n", - " [\n", - " footprints[[\"IoU\"]].describe(percentiles=[0.05, 0.5]).T.assign(group=\"all\"),\n", - " footprints.groupby(\"coverage\")\n", - " .IoU.describe(percentiles=[0.05, 0.5])\n", - " .assign(group=\"coverage\"),\n", - " footprints.groupby(\"mode\")\n", - " .IoU.describe(percentiles=[0.05, 0.5])\n", - " .assign(group=\"mode\"),\n", - " ]\n", - ").round(3)" - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "id": "b45eb238", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T14:01:06.298147Z", - "iopub.status.busy": "2026-10-25T14:01:06.298147Z", - "iopub.status.idle": "2026-10-25T14:01:14.369320Z", - "shell.execute_reply": "2026-10-25T14:01:14.369320Z" - } - }, - "outputs": [ - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAABKUAAAGZCAYAAABYPYI6AAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjEwLjAsIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvlHJYcgAAAAlwSFlzAAAPYQAAD2EBqD+naQABAABJREFUeJzsnXecFPX9/58z2+v1fnBw9N5EKVIEEbF3UVEwajREE2MSEzVG1BgT89WfsffeK/aCYkEBBSlKkc4dcL3v3vaZ+f2xt8vt3c5xh0fRfJ6Pxz3gMzvzmc/nM5+Z3c9r3kXSNE1DIBAIBAKBQCAQCAQCgUAgOIjIh7oBAoFAIBAIBAKBQCAQCASC/z2EKCUQCAQCgUAgEAgEAoFAIDjoCFFKIBAIBAKBQCAQCAQCgUBw0BGilEAgEAgEAoFAIBAIBAKB4KAjRCmBQCAQCAQCgUAgEAgEAsFBR4hSAoFAIBAIBAKBQCAQCASCg44QpQQCgUAgEAgEAoFAIBAIBAcdIUoJBAKBQCAQCAQCgUAgEAgOOkKUEggEAoFAIBAIBAKBQCAQHHSEKCUQCAQCgUAgEAi6naeeegpJkpL+/elPfzrUzes2Pv30U4444ggcDgeSJLFw4cJuP0dZWRkLFixgzZo13V53DEmSWLBgwX4d+8ADD/DUU091a3sEnedgzA+B4EBhPNQNEAgEAoFAIBAIBL9cnnzySQYOHJiwLT8//xC1pnvRNI1zzjmH/v378/bbb+NwOBgwYEC3n6esrIybb76ZXr16MXLkyG6vH2DZsmUUFhbu17EPPPAAmZmZzJs3r3sbJegUB2N+CAQHCiFKCQQCgUAgEAgEggPG0KFDOeKIIzq1bzgcRpIkjMafxzKlrKyMuro6Tj/9dKZPn36om9NlNE0jEAhgs9kYN27coW5Ot/Jzm0sCwf8qwn1PIBAIBAKBQCAQHHQ+//xzJEni2Wef5Y9//CMFBQVYLBa2bt1KdXU18+fPZ/DgwTidTrKzs5k2bRpLlixJqGPnzp1IksR//vMf/v3vf9OrVy9sNhtTp05l8+bNhMNh/vrXv5Kfn09KSgqnn346VVVV7dry8ssvM378eBwOB06nk5kzZ7J69eoO279gwYK4ZdFf/vIXJEmiV69e8c+/+uorpk+fjsvlwm63M2HCBN5777129axbt45TTz2VtLQ0rFYrI0eO5Omnn04Yp7FjxwJw8cUXx10gY6528+bNw+l0sn79eqZPn47D4SArK4srr7wSn8+XcC5Jkrjyyit56KGHGDRoEBaLJX6utu57MffLzz77jN/85jdkZmaSkZHBGWecQVlZWXy/Xr16sX79er744ot421qPQzLuv/9+Jk+eTHZ2Ng6Hg2HDhnHHHXcQDocT9tM0jX/+858UFRVhtVo54ogjWLRoEVOnTmXq1KkJY6Q3lwA++eQTpk+fjtvtxm63M3HiRD799NN27dqyZQvnn38+2dnZWCwWBg0axP3335+wT+xcL7zwAn/5y1/Iy8vD6XRy8sknU1lZicfj4de//jWZmZlkZmZy8cUX4/V62/XrgQceYOTIkdhsNtLS0jjrrLPYvn17wn5Tp05l6NChrFixgkmTJmG32ykuLuZf//oXqqrG29PR/BAIDneEKCUQCAQCgUAgEAgOGIqiEIlEEv5ac91111FaWspDDz3EO++8Q3Z2NnV1dQDcdNNNvPfeezz55JMUFxczdepUPv/883bnuP/++/n666+5//77eeyxx/jxxx85+eSTueSSS6iuruaJJ57gjjvu4JNPPuHSSy9NOPaf//wn5513HoMHD+aVV17h2WefxePxMGnSJDZs2KDbr0svvZQ33ngDgKuuuoply5bx5ptvAvDFF18wbdo0Ghsbefzxx3nxxRdxuVycfPLJvPzyy/E6Nm3axIQJE1i/fj333HMPb7zxBoMHD2bevHnccccdAIwePZonn3wSgL/97W8sW7aMZcuWJfQjHA5zwgknMH36dBYuXMiVV17Jww8/zLnnntuu3QsXLuTBBx/k73//Ox999BGTJk3S7WOsnyaTiRdeeIE77riDzz//nDlz5sQ/f/PNNykuLmbUqFHxtsXGQY9t27Zx/vnn8+yzz/Luu+9yySWX8J///IfLL788Yb8bbriBG264geOPP5633nqLK664gksvvZTNmzcnrTfZXHruuec47rjjcLvdPP3007zyyiukp6czc+bMBGFqw4YNjB07lnXr1nHnnXfy7rvvcuKJJ/K73/2Om2++ud25rr/+eqqqqnjqqae48847+fzzzznvvPM488wzSUlJ4cUXX+Taa6/l2Wef5frrr0849vLLL+fqq6/m2GOPZeHChTzwwAOsX7+eCRMmUFlZmbBvRUUFF1xwAXPmzOHtt99m1qxZ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SQljcdNNN2knnXSSdvnll2tut1vr1auXtnjxYu2NN97Q+vTpo6WmpmrXX399wrkXLVqkjR07VktJSdEGDx6svfXWW/HPPv74Y23YsGGa0+nUsrOztSuuuKJT/dm6dasmy7JWUVER3zZ//nztoosu0j0mLS1N+/TTT5N+tm3bNk2WZe2rr75K2B6JRLSBAwdqN910U3zbypUrtWOOOUZLS0vTMjMztSuvvFKrqanRrFarBmgOh0NzOBzal19+qWmapj377LPawIEDtZSUFG3ixInaqlWr4nVNmTJF+9Of/qRNmTJFczqd2rhx47QNGzbEP/d4PNpvf/tbrUePHlpWVpZ24YUXag0NDZqmadqOHTs0QHviiSe0Pn36aNnZ2Z0au1GjRmmPP/64pmma1tzcrJnNZm3FihXxz++44w5t8uTJnTo+EoloOTk52kcffdSpcwsEgkNPY2OjBmiNjY2HuikHlarKPYe6CT8rxHh1DTFeXUOMV9cQ49U1xHh1nsN9rISllOCwJT09nWuvvZa//vWv+9w3IyODgQMHcvHFF/PKK69QUlKSdL/HH3+cUaNGceqppzJp0iRdaymAyspKXn31Vfr379/pNv/www98+eWXCcccffTR3HLLLTzyyCN8//33aJrW6fo++ugjzjvvvE7v/+qrr3LBBRcwf/58vF4vl1xyCQDr1q3DaDRSWlrKs88+i6qqnH/++ezYsYPKykpGjRrFOeeck9C2jz76iGOPPZa6ujouuOAC5syZw8KFC1m7di1fffUV//d//8eqVasA+P777zn77LP517/+RV1dHQ8//DAXXnghmzZtAmDu3Ln8+c9/xuPxsH37di688MJO9ef7778nLy+PnJyc+LaRI0cmuHW25ocffsDj8TB48OCkny9atIiCggImTpyYsN1gMHDWWWfx8ccfA7Bnzx6mTZvGWWedRVlZGSUlJZxzzjlkZGTwwQcfxK3jvF4vkyZNYsmSJfzmN7/h4Ycfprq6mrPOOouZM2cmWF49/vjj3H777dTW1jJt2jROPfXUuNXTr371K+rq6vj+++/ZsWMH4XCYK6+8MqGNb7/9NitXrmTHjh37HLeqqio2btzI8OHDgahraygUSnB37Wgckx1fWVnJli1b6N27N4WFhVx++eV4PJ59tkUgEAgEAoFAIBAI9BCilOCw5uqrr6akpISFCxd2uJ8kSXz22WeMGDGCm2++meLiYgYPHsyiRYvi+yiKwtNPP83cuXMBuOiii3j++ecJBoMJdU2aNAmXy0Vubi6BQID77ruvw3M3NjaSmpqKzWZj+PDhnHjiicyfPz/++X//+1+uuOIKnnrqKY488khycnK46667OtX/6upqCgoKOrVvR6SkpHDDDTdgNpux2+243W7OPfdcHA4HVquVm2++mc2bN1NWVhY/ZvTo0Zx11lkYDAbOP/98ysrKuO6663A4HAwZMoQRI0bERamHH36YefPmMW3aNGRZ5uijj+akk07ilVdeAcBkMrF161aqq6txOBxMmDChU+32er3t4jelpqYmFUPq6+uZPXs2119/Pbm5uUnrq6mpIT8/P+ln+fn5VFdXA/Dcc88xZswY5s+fj9VqxW63M2nSJN12PvPMM8yZM4fJkydjMpm4+uqrSUtL47333ovvM3v2bMaPH4/ZbGbBggVUVlayfPlyqquref3117nvvvtITU3F4XBwyy238PLLL6MoSvz4m266idTUVOx2u247AILBILNnz+acc87hiCOOAKLj6HA4MBqN8f30xjHZ8XV1dQAsXLiQFStWsGbNGrZt28Y111zTYVsEAoFAIBAIBAKBoCOEKCU4rLHZbNx0001cf/31CQv0ZOTm5nLnnXeyfv16qqurmTVrFqeffnp8Qf3+++9TU1PD+eefD8DZZ5+N3+/nzTffTKhnyZIleDweli1bxq5duxKEmmSkpKTQ0NCA1+vlkUceYcmSJfh8vvjnFouFP/7xjyxdupTGxkbuuusu/vrXv8atcjoiMzOTPXv27HO/fVFQUJAQY8rv9zN//nx69eqF2+2mV69eAAmxmFoLOzEhpO02r9cLwM6dO3nooYdITU2N/7311lvxsXvzzTdZt24dAwYMYNSoUXGxal84nc52cZ4aGxtxuVztth1//PEcffTRLFiwQLe+zMxM3etZVlZGVlYWACUlJfTr169TbQTYvXt3fAxj9O7dm927d8fLRUVF8f+bTCby8vLYs2cPO3fuRFVViouL42M3duxYZFmmoqIifkzPnj332Y5QKMTZZ5+N3W5PCAjvdDrx+XwJ8aiSjWNHxwP89a9/JTMzk8zMTK677joR6FwgEAgEAoFAIPgZUVob4ph/bmHY9Rs55p9bKK0NHeomCVFKcPhzySWXoKoqTz/9dKeP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HQ2LMgM4X2ylwXzzfjqUb2PjijsJCQ11fScIAklJydTU1IAgcN99D7hcm4kJSezbt5tXX/1fUlLTWLHizh4dnWPSMjh65BCLFi9DEAQWpvuxeVspokqPIAgIosCO842kRfv0273j5daJCdKgVYGtpfsIUFYvMTvVj8fmh/By6RGeXD8eH13Hn9esrPFcvnyRu9fdy6lTJzhx4hg+eh+KigrZcP+DLpfecOGXv/wl165dY+3atezatWtY5WU6efIkr776Km+99RY6nY6HH36YF198kZSUFAB+97vf8W//9m/cf783z9tQprM3x939reWtcl/cDa2dISI4q242O0SGajiEFy/9xVB0zgwGQ2nCP5zca55wmDmPzznfaznekZzrrDd9ras+0HIuhnK/GFKi1JYtW/jRj37E7t27SUzsWBntdqTR4uClPdXUNjmwO2R8tCILM/xZmO4UpC5cOIdKpWbUqOR+bYfdofDagVoqGuw4FFCLAqPCddwzLQixOZ+TVVKwSTIaUUQUQdVP8+rt541cr7IjApKiYNCKbJgehK/OOZjpNc7QRpNVRqsWkGS4fv06R48cYHTKGGbPme8Kyzh37gzlZaVYrVbuXLXaK0b1EkVRuHQpl9OnTqLRahAQEAQBlUpFaFgYKKAoMqKooq6ulpCQUARBIDlcR0G1jdQoHenRehKCZC5duojDIREWFo7BYGDnzu34+vpx34YHkB0Oduz4nIiISMLDI1iydAVHDh+gtKSEhYuW8PhXv85nWz5h4qTJpKamoVL1/IOmUQksyvDjo1P12OwyoihwtdhEvdQx9FUQhA65xAD0Pj4sX3Eni5csZ/MH7/KPf7zEQw99pVtn56RJUzh8+AC5uRdcItuPHlvCD14/TUODEb3BD4es8OnpOu6f6XXmDVVEUSAiQENxrR0FhSaznYIq5xiokk2khTk6FaQAGhrqUavUXL9+nVmz5jJz5hxqa2pQa9R8tuUT1qxdj8HQvy8XPIkoirz22mssXryYr371q7z++usDVrzgVhg/fjy5ubksX76cV155hdWrV3cYOx5++GG+853vDFILvfSW5z8oZecFIzKw44KRMwVm3nrU4PpbV5OTvkxcOsup4hWivHi5vRlKQtBQzPvUFZ4Qj55fH01hcRERAWrX8a7749UhIxJ6mt70te76gEqUhrSrcciIUhcuXODB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p59mwoQJfPrpp3z77bcsX768Wd6TEEIIIURzkaCUEEIIIcQJuu666ygsLOSvf/0rOTk59O3blwULFoRW08vJyWH//v01XlNaWsqcOXN44YUX6jzmueeey+zZs/nzn//MI488QteuXfnwww8ZNmxYk7+fU5nNZuPRRx+tVcYo6ibz1TAyXw0j89UwMl8NI/NVf6fCXGlKKdXSgxBCCCGEEEIIIYQQZxbpKSWEEEIIIYQQQgghmp0EpYQQQgghhBBCCCFEs5OglBBCCCGEEEIIIYRodhKUEkIIIYQQQgghhBDNToJSQgghhBDilLV48WI0TavzZ+3ataH96nr+tddea8GRt4zU1NRa8/DHP/6xxj779+/niiuuIDw8nISEBH7zm9/g9XpbaMQtZ+/evUybNo3OnTvjcDjo2rUrjz76aK25kGurpldeeYXOnTtjt9sZPHgwy5Yta+khtQpPPvkkQ4cOJTIykqSkJCZOnEhGRkaNfW699dZa19I555zTQiNuWdOnT681F23atAk9r5Ri+vTptG3bFofDwejRo9m6dWsLjrhl1fXdrmka99xzD9C6ry1zSw9ACCGEEEKIE3XuueeSk5NTY9sjjzzCt99+y5AhQ2psnzFjBhdffHHocXR0dLOMsbX561//yh133BF6HBEREfrvQCDAZZddRmJiIsuXL6ewsJBbbrkFpRT//ve/W2K4LWb79u0YhsHrr79Ot27d+Omnn7jjjjtwuVw888wzNfaVayvoww8/5L777uOVV17hvPPO4/XXX+eSSy4hPT2djh07tvTwWtSSJUu45557GDp0KH6/n4cffphx48aRnp5OeHh4aL+LL76YGTNmhB5brdaWGG6r0KdPH7799tvQY5PJFPrvf/zjHzz33HPMnDmTHj168Pe//52LLrqIjIwMIiMjW2K4LWrt2rUEAoHQ459++omLLrqIyZNMcCv6AAAVP0lEQVQnh7a11mtLglJCCCGEEOKUZbVaa/z13Ofz8dlnn3HvvfeiaVqNfWNiYmrse6aKjIw86jx88803pKenk5WVRdu2bQF49tlnufXWW3n88ceJiopqzqG2qIsvvrhGoKlLly5kZGTw6quv1gpKybUV9NxzzzFt2jRuv/12AJ5//nm+/vprXn31VZ588skWHl3L+uqrr2o8njFjBklJSaxfv56RI0eGtttsNrmWqpjN5jrnQinF888/z8MPP8ykSZMAmDVrFsnJybz//vvcddddzT3UFpeYmFjj8VNPPUXXrl0ZNWpUaFtrvbakfE8IIYQQQpw2PvvsMwoKCrj11ltrPXfvvfeSkJDA0KFDee211zAMo/kH2Ao8/fTTxMfHM2DAAB5//PEa5WirVq2ib9++oYAUwPjx4/F4PKxfv74lhtuqlJaWEhcXV2u7XFvg9XpZv34948aNq7F93LhxrFy5soVG1XqVlpYC1LqeFi9eTFJSEj169OCOO+4gLy+vJYbXKuzcuZO2bdvSuXNnpkyZwu7duwHYs2cPubm5Na41m83GqFGj5Foj+Fl87733+MUvflHjjzOt9dqSTCkhhBBCCHHaePvttxk/fjwdOnSosf1vf/sbF1xwAQ6Hg++++44HH3yQgoIC/vznP7fQSFvGb3/7WwYNGkRsbCxr1qzhoYceYs+ePbz11lsA5ObmkpycXOM1sbGxWK1WcnNzW2LIrcauXbv497//zbPPPltju1xbQQUFBQQCgVrXT3Jy8hl/7fycUooHHniAESNG0Ldv39D2Sy65hMmTJ9OpUyf27NnDI488wtixY1m/fj02m60FR9z8hg0bxn/+8x969OjBoUOH+Pvf/865557L1q1bQ9dTXdfavn37WmK4rconn3xCSUlJjT/OtOprSwkhhBBCCNHKPProowo45s/atWtrvCYrK0vpuq4+/vjj4x7/mWeeUVFRUU01/GZ1InNV7eOPP1aAKigoUEopdccdd6hx48bV2s9isagPPvigSd9HczmR+Tp48KDq1q2bmjZt2nGPfzpdWw1x8OBBBaiVK1fW2P73v/9d9ezZs4VG1TrdfffdqlOnTiorK+uY+2VnZyuLxaLmzJnTTCNrvcrLy1VycrJ69tln1YoVKxSgsrOza+xz++23q/Hjx7fQCFuPcePGqcsvv/yY+7Sma0sypYQQQgghRKtz7733MmXKlGPuk5qaWuPxjBkziI+P58orrzzu8c855xycTieHDh2q9df2U82JzFW16tWXMjMziY+Pp02bNqxevbrGPsXFxfh8vlN+nqo1dL6ys7MZM2YMw4cP54033jju8U+na6shEhISMJlMtbKi8vLyzqh5OJ5f//rXfPbZZyxdupT27dsfc9+UlBQ6derEzp07m2l0rVd4eDj9+vVj586dTJw4EQhmdqakpIT2kWsN9u3bx7fffsvcuXOPuV9rurYkKCWEEEIIIVqdhIQEEhIS6r2/UooZM2Zw8803Y7FYjrv/xo0bsdvtxMTEnMQoW4eGztWRNm7cCBC6sRs+fDiPP/44OTk5oW3ffPMNNpuNwYMHN86AW1hD5uvgwYOMGTOGwYMHM2PGDHT9+C15T6drqyGsViuDBw9m4cKFXHXVVaHtCxcuZMKECS04stZBKcWvf/1r5s2bx+LFi+ncufNxX1NYWEhWVlaNwMuZyuPxsG3bNs4//3w6d+5MmzZtWLhwIQMHDgSCfZSWLFnC008/3cIjbVnVDfQvu+yyY+7Xmq4tCUoJIYQQQohT3qJFi9izZw/Tpk2r9dz8+fPJzc1l+PDhOBwOvv/+ex5++GHuvPPOlu+l0YxWrVrFDz/8wJgxY4iOjmbt2rXcf//9XHnllXTs2BEINqXu3bs3N910E//85z8pKirid7/7HXfccccZtfIeBDOkRo8eTceOHXnmmWfIz88PPVe9gpVcWzU98MAD3HTTTQwZMiSUWbZ//35++ctftvTQWtw999zD+++/z6effkpkZGQooyw6OhqHw0F5eTnTp0/n6quvJiUlhb179/KnP/2JhISEGkG+M8Xvfvc7rrjiCjp27EheXh5///vfcTqd3HLLLWiaxn333ccTTzxB9+7d6d69O0888QRhYWFcf/31LT30FmMYBjNmzOCWW27BbD4c6mn111ZL1w8KIYQQQghxsqZOnarOPffcOp/78ssv1YABA1RERIQKCwtTffv2Vc8//7zy+XzNPMqWtX79ejVs2DAVHR2t7Ha76tmzp3r00UeVy+Wqsd++ffvUZZddphwOh4qLi1P33nuvcrvdLTTqljNjxoyj9pyqJtdWbS+//LLq1KmTslqtatCgQWrJkiUtPaRW4WjX0owZM5RSSlVUVKhx48apxMREZbFYVMeOHdUtt9yi9u/f37IDbyHXXXedSklJURaLRbVt21ZNmjRJbd26NfS8YRjq0UcfVW3atFE2m02NHDlSbdmypQVH3PK+/vprBaiMjIwa21v7taUppVSLRMOEEEIIIYQQQgghxBnr+EXRQgghhBBCCCGEEEI0MglKCSGEEEIIIYQQQohmJ0EpIYQQQgghhBBCCNHsJCglhBBCCCGEEEIIIZqdBKWEEEIIIYQQQgghRLOToJQQQgghhBBCCCGEaHYSlBJCCCGEEEIIIYQQzU6CUkIIIYQQQgghhBCi2UlQSgghhBBCCCFEnTRN45NPPmk1x6lLamoqzz///Ekf5+2332bcuHHH3OfWW29l4sSJJ32uI33++ecMHDgQwzAa9bhCnAokKCWEEEIIIYRolW699VY0Tav1k5mZ2dJDaxX27t2Lpmls2rSppYcSMn36dAYMGFBre05ODpdccgnQOsft8Xj4y1/+wiOPPNLs57788svRNI3333+/2c8tREuToJQQQgghhBCi1br44ovJycmp8dO5c+da+3m93hYY3enD5/M16fHbtGmDzWZr0nOcjDlz5hAREcH555/fIue/7bbb+Pe//90i5xaiJUlQSgghhBBCCNFq2Ww22rRpU+PHZDIxevRo7r33Xh544AESEhK46KKLAHjuuefo168f4eHhdOjQgbvvvpvy8vLQ8WbOnElMTAyff/45PXv2JCwsjGuuuQaXy8WsWbNITU0lNjaWX//61wQCgdDrvF4vv//972nXrh3h4eEMGzaMxYsXH3PsJSUl3HnnnSQnJ2O32+nbty+ff/556PmVK1cycuRIHA4HHTp04De/+Q0ulyv0fGpqKk888QS/+MUviIyMpGPHjrzxxhuh56uDcwMHDkTTNEaPHh16bsaMGfTq1Qu73U5aWhqvvPJK6LnqTKWPPvqI0aNHY7fbee+99+r1+/jDH/5Ajx49CAsLo0uXLjzyyCOhgNbMmTN57LHH2Lx5cyirbebMmUDN8r2jjXv06NHcd999Nc43ceJEbr311tDjvLw8rrjiChwOB507d+a///1vrTGWlpZy5513kpSURFRUFGPHjmXz5s3HfF+zZ8/myiuvrLEtEAjwwAMPEBMTQ3x8PL///e9RStXYRynFP/7xD7p06YLD4aB///58/PHHNfb57LPP6N69Ow6HgzFjxjBr1iw0TaOkpCS0z5VXXsmaNWvYvXv3MccpxOlGglJCCCGEEEKIU9KsWbMwm82sWLGC119/HQBd13nxxRf56aefmDVrFosWLeL3v/99jddVVFTw4osvMnv2bL766isWL17MpEmTWLBgAQsWLODdd9/ljTfeqBFcuO2221ixYgWzZ8/mxx9/ZPLkyVx88cXs3LmzzrEZhsEll1zCypUree+990hPT+epp57CZDIBsGXLFsaPH8+kSZP48ccf+fDDD1m+fDn33ntvjeM8++yzDBkyhI0bN3L33Xfzq1/9iu3btwOwZs0aAL799ltycnKYO3cuAG+++SYPP/wwjz/+ONu2beOJJ57gkUceYdasWTWO/Yc//IHf/OY3bNu2jfHjx9drziMjI5k5cybp6em88MILvPnmm/zrX/8C4LrrruPBBx+kT58+oay26667rtYxjjbu+rj11lvZu3cvixYt4uOPP+aVV14hLy8v9LxSissuu4zc3FwWLFjA+vXrGTRoEBdccAFFRUVHPe6yZcsYMmRIjW3PPvss77zzDm+//TbLly+nqKiIefPm1djnz3/+MzNmzODVV19l69at3H///dx4440sWbIECAYAr7nmGiZOnMimTZu46667ePjhh2udv1OnTiQlJbFs2bJ6z4UQpwUlhBBCCCGEEK3QLbfcokwmkwoPDw/9XHPNNUoppUaNGqUGDBhw3GN89NFHKj4+PvR4xowZClCZmZmhbXfddZcKCwtTZWVloW3jx49Xd911l1JKqczMTKVpmjp48GCNY19wwQXqoYceqvO8X3/9tdJ1XWVkZNT5/E033aTuvPPOGtuWLVumdF1XlZWVSimlOnXqpG688cbQ84ZhqKSkJPXqq68qpZTas2ePAtTGjRtrHKdDhw7q/fffr7Htb3/7mxo+fHiN1z3//PN1ju1IgJo3b95Rn//HP/6hBg8eHHr86KOPqv79+x/zOEcb96hRo9Rvf/vbGtsmTJigbrnlFqWUUhkZGQpQP/zwQ+j5bdu2KUD961//Ukop9d1336moqCjldrtrHKdr167q9ddfr/M9FBcXK0AtXbq0xvaUlBT11FNPhR77fD7Vvn17NWHCBKWUUuXl5cput6uVK1fWeN20adPU1KlTlVJK/eEPf1B9+/at8fzDDz+sAFVcXFxj+8CBA9X06dPrHKMQpytzSwXDhBBCCCGEEOJ4xowZw6uvvhp6HB4eHvrvn2e2AHz//fc88cQTpKen43Q68fv9uN1uXC5X6LVhYWF07do19Jrk5GRSU1OJiIiosa06A2fDhg0opejRo0eNc3k8HuLj4+sc96ZNm2jfvn2t11Rbv349mZmZNcrPlFIYhsGePXvo1asXAGeddVboeU3TaNOmTY3MoJ/Lz88nKyuLadOmcccdd4S2+/1+oqOja+xb1/wdz8cff8zzzz9PZmYm5eXl+P1+oqKiGnycE7Ft2zbMZnONcaelpRETExN6vH79esrLy2v9XiorK9m1a1edx62srATAbreHtpWWlpKTk8Pw4cND26rPrapK+NLT03G73aHS0Wper5eBAwcCkJGRwdChQ2s8f/bZZ9c5DofDQUVFRZ3PCXG6kqCUEEIIIYQQotUKDw+nW7duR33uSPv27ePSSy/ll7/8JX/729+Ii4tj+fLlTJs2rUYjb4vFUuN1mqbVuc0wDCBYimcymVi/fn2o/K7akYGsIzkcjmO+L8MwuOuuu/jNb35T67mOHTsec6zV4zracSFYwjds2LAaz/187D+fv+P54YcfmDJlCo899hjjx48nOjqa2bNn8+yzzzboOEej63qtnk1H/t6qn9M07ajHMAyDlJSUOvt9HRm8OlJ8fDyaplFcXNyg8VbP9RdffEG7du1qPFfd1F0pVWu8P3+P1YqKikhMTGzQGIQ41UlQSgghhBBCCHFaWLduHX6/n2effRZdD7bP/eijj076uAMHDiQQCJCXl1fv1dnOOussDhw4wI4dO+rMlho0aBBbt249asCtPqxWK0CNhuzJycm0a9eO3bt3c8MNN5zwseuyYsUKOnXqVKMn0r59+2qN6cjx1KWucQMkJiaSk5MTehwIBPjpp58YM2YMAL169cLv97Nu3bpQtlFGRkaNhuGDBg0iNzcXs9lMampqvd6X1Wqld+/epKenM27cOACio6NJSUnhhx9+YOTIkUAw26y6RxVA7969sdls7N+/n1GjRtV57LS0NBYsWFBj27p162rt53a72bVrVyjDSogzhTQ6F0IIIYQQQpwWunbtit/v59///je7d+/m3Xff5bXXXjvp4/bo0YMbbriBm2++mblz57Jnzx7Wrl3L008/XSvgUG3UqFGMHDmSq6++moULF7Jnzx6+/PJLvvrqKyDYZHzVqlXcc889bNq0iZ07d/LZZ5/x61//ut7jSkpKwuFw8NVXX3Ho0CFKS0sBmD59Ok8++SQvvPACO3bsYMuWLcyYMYPnnnvupOahW7du7N+/n9mzZ7Nr1y5efPHFWo2/U1NT2bNnD5s2baKgoACPx1PvcY8dO5YvvviCL774gu3bt3P33XfXCDj17NmTiy++mDvuuIPVq1ezfv16br/99hpZaRdeeCHDhw9n4sSJfP311+zdu5eVK1fy5z//uc5gULXx48ezfPnyGtt++9vf8tRTTzFv3rw6xxMZGcnvfvc77r//fmbNmsWuXbvYuHEjL7/8cqip/F133cX27dv5wx/+wI4dO/joo49qrEhY7YcffsBms9UoFxTiTCBBKSGEEEIIIcRpYcCAATz33HM8/fTT9O3bl//+9788+eSTjXLsGTNmcPPNN/Pggw/Ss2dPrrzySlavXk2HDh2O+po5c+YwdOhQpk6dSu/evfn9738fyg4666yzWLJkCTt37uT8889n4MCBPPLII6SkpNR7TGazmRdffJHXX3+dtm3bMmHCBABuv/123nrrLWbOnEm/fv0YNWoUM2fOpHPnzic1BxMmTOD+++/n3nvvZcCAAaxcuZJHHnmkxj5XX301F198MWPGjCExMZEPPvig3uP+xS9+wS233MLNN9/MqFGj6Ny5cyhLqtqMGTPo0KEDo0aNYtKkSdx5550kJSWFntc0jQULFjBy5Eh+8Ytf0KNHD6ZMmcLevXtJTk4+6nu74447WLBgQShABvDggw9y8803c+uttzJ8+HAiIyO56qqrarzub3/7G3/5y1948skn6dWrF+PHj2f+/Pmhue7cuTMff/wxc+fO5ayzzuLVV18NZZpVl/gBfPDBB9xwww2EhYUd83cgxOlGU0craBVCCCGEEEIIIc4Q1157LQMHDuShhx5q0vM8/vjjvPbaa2RlZQHB5vRpaWmsW7fupAOHQpxqJFNKCCGEEEIIIcQZ75///OdRG9efjFdeeYW1a9eGSkr/+c9/csstt4Se37NnD6+88ooEpMQZSTKlhBBCCCGEEEKIJnL//ffz4YcfUlRURMeOHbnpppt46KGHMJtl3TEhJCglhBBCCCGEEEIIIZqdlO8JIYQQQgghhBBCiGYnQSkhhBBCCCGEEEII0ewkKCWEEEIIIYQQQgghmp0EpYQQQgghhBBCCCFEs5OglBBCCCGEEEIIIYRodhKUEkIIIYQQQgghhBDNToJSQgghhBBCCCGEEKLZSVBKiP9vDw4JAAAAAAT9f+0LEwAAAADsAgkNdxOLtvE9AAAAAElFTkSuQmCC", - "text/plain": [ - "
" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "fig = plt.figure(figsize=(12, 4.2))\n", - "ax = fig.add_subplot(1, 2, 1, projection=ccrs.Robinson())\n", - "ax.set_global()\n", - "ax.coastlines(color=GRAY, linewidth=0.5)\n", - "for polygon in catalog.polygon:\n", - " # split footprints that cross the antimeridian for plotting\n", - " footprint = unwrap(shapely.force_2d(shapely.from_wkt(polygon)))\n", - " parts = [\n", - " footprint.intersection(shapely.box(-180, -90, 180, 90)),\n", - " shapely.affinity.translate(\n", - " footprint.intersection(shapely.box(180, -90, 540, 90)), -360\n", - " ),\n", - " ]\n", - " ax.add_geometries(\n", - " [part for part in parts if not part.is_empty],\n", - " crs=ccrs.PlateCarree(),\n", - " facecolor=BLUE,\n", - " edgecolor=\"none\",\n", - " alpha=0.6,\n", - " )\n", - "ax.set_title(f\"NISAR RSLC frames, {DAY:%d %B %Y}\", fontsize=9)\n", - "ax2 = fig.add_subplot(1, 2, 2)\n", - "ax2.scatter(footprints.latitude, footprints.IoU, s=6, color=BLUE)\n", - "ax2.set(\n", - " xlabel=\"Frame center latitude (deg)\",\n", - " ylabel=\"IoU (TAT-C vs. bounding polygon)\",\n", - " title=\"Frame footprint agreement\",\n", - ")\n", - "fig.tight_layout()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "id": "792b4c36", - "metadata": {}, - "source": [ - "TAT-C reproduces the footprints of full frames with an intersection over union (IoU) of 0.95 (median; 0.92 at the 5th percentile) and of all frames with 0.94, for every mode including the narrow 77 MHz mode. Partial frames agree less well (0.91), because their bounding polygons outline only the part of the frame with valid data. The remaining differences reflect the look angle variation within modes (Test 3) and terrain: bounding polygons are at the terrain height, whereas TAT-C's footprints are on the ellipsoid.\n", - "\n", - "## Test 5: Observation Times\n", - "\n", - "Each geolocation grid point is a ground point with a known zero-Doppler time: the time at which NISAR imaged it. For interior grid points of each sampled product (excluding the outer 10% of the slant range extent and the first and last grid lines), `collect_observations` is run over a window of 10 minutes around the zero-Doppler time with the product's mode's `PointedInstrument` in each velocity frame, and the observation epoch nearest the zero-Doppler time is compared with it." - ] - }, - { - "cell_type": "code", - "execution_count": 10, - "id": "f20d1904", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T14:01:14.373326Z", - "iopub.status.busy": "2026-10-25T14:01:14.373326Z", - "iopub.status.idle": "2026-10-25T14:01:50.095134Z", - "shell.execute_reply": "2026-10-25T14:01:50.094626Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
pointsmissedtime, median (s)time, p95 |x| (s)time, max |x| (s)
earth_fixed660.00.0-0.0010.3010.337
inertial660.00.00.6586.3687.150
\n", - "
" - ], - "text/plain": [ - " points missed time, median (s) time, p95 |x| (s) \\\n", - "earth_fixed 660.0 0.0 -0.001 0.301 \n", - "inertial 660.0 0.0 0.658 6.368 \n", - "\n", - " time, max |x| (s) \n", - "earth_fixed 0.337 \n", - "inertial 7.150 " - ] - }, - "execution_count": 10, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "rows5 = {}\n", - "for frame in [VelocityFrame.EARTH_FIXED, VelocityFrame.INERTIAL]:\n", - " differences, missed = [], 0\n", - " for mode, m in zip(geometry[\"mode\"], meta):\n", - " satellite = nisar.model_copy(\n", - " update={\n", - " \"instruments\": [nisar_view(mode)],\n", - " \"attitude\": Attitude(velocity_frame=frame),\n", - " }\n", - " )\n", - " for i in np.linspace(1, len(m[\"time\"]) - 2, 3).astype(int):\n", - " for j in (\n", - " (np.linspace(0.1, 0.9, 5) * (len(m[\"slant_range\"]) - 1))\n", - " .round()\n", - " .astype(int)\n", - " ):\n", - " point = Point(\n", - " id=0,\n", - " latitude=float(m[\"lat\"][i, j]),\n", - " longitude=float(m[\"lon\"][i, j]),\n", - " )\n", - " truth = DAY + timedelta(seconds=float(m[\"time\"][i]))\n", - " observations = collect_observations(\n", - " point,\n", - " satellite,\n", - " truth - timedelta(minutes=5),\n", - " truth + timedelta(minutes=5),\n", - " )\n", - " if observations.empty:\n", - " missed += 1\n", - " continue\n", - " seconds = (\n", - " (observations.epoch - pd.Timestamp(truth))\n", - " .dt.total_seconds()\n", - " .to_numpy()\n", - " )\n", - " differences.append(seconds[np.argmin(np.abs(seconds))])\n", - " rows5[frame.value] = pd.concat(\n", - " [\n", - " pd.Series({\"points\": len(differences) + missed, \"missed\": missed}),\n", - " summarize(differences).drop(\"n\"),\n", - " ]\n", - " )\n", - "pd.DataFrame(rows5).T.rename(\n", - " columns={\n", - " \"median\": \"time, median (s)\",\n", - " \"p95 |x|\": \"time, p95 |x| (s)\",\n", - " \"max |x|\": \"time, max |x| (s)\",\n", - " }\n", - ").round(3)" + "With the Earth-fixed velocity frame, TAT-C's view edges match the image edges to within about 2 km along track and 5 to 7 km across track (95th percentile). The cross-track residual reflects the variation of the look angles within each mode (Test 2). The inertial velocity frame displaces the edges by 30 to 50 km along track (95th percentile), the rotation of the zero-Doppler plane over the slant range to the swath." ] }, { @@ -1846,8 +1313,6 @@ "id": "f609fd2d", "metadata": {}, "source": [ - "With the Earth-fixed velocity frame, `collect_observations` reports each point's observation epoch within 0.3 s of its zero-Doppler time (95th percentile), about 2 km of travel along the orbit, and observes every point. The inertial velocity frame shifts the epochs by up to about 7 s.\n", - "\n", "## Summary\n", "\n", "| Test | Result |\n", @@ -1855,14 +1320,10 @@ "| 1. Orbit (CelesTrak TLE vs. orbit ephemeris) | 0.9 km along track (95th percentile) 26 to 46 hours before the TLE epoch |\n", "| 2. Imaging geometry | left-looking; images in the plane perpendicular to the *Earth-fixed* velocity (inertial: up to 2.4 deg); roll about 35.3 deg and field of view about 11 deg (77 MHz mode: 32.9 and 6.1 deg); look angles vary by up to 0.6 deg within a mode |\n", "| 3. Swath edges | 2 km along track and 5 to 7 km across track (95th percentile) with the Earth-fixed frame; 30 to 50 km along track with the inertial frame |\n", - "| 4. Frame footprints (`compute_ground_track`) | IoU 0.95 for full frames, 0.94 for all 855 frames (median) |\n", - "| 5. Observation times (`collect_observations`) | 0.3 s (95th percentile) with the Earth-fixed frame; up to 7 s with the inertial frame |\n", - "\n", - "**Velocity frame.** A SAR forms its images in zero-Doppler geometry, in the plane perpendicular to the Earth-fixed velocity, whatever the attitude of the spacecraft. TAT-C's default `VelocityFrame.EARTH_FIXED` reproduces this, while `VelocityFrame.INERTIAL` (appropriate for imagers that scan without yaw steering, such as those of NOAA-20) would displace NISAR's swath edges by up to 50 km along track and its observation times by up to 7 s.\n", "\n", - "**Roll angle and field of view.** A left-looking `PointedInstrument` with a positive roll angle, rotated rigidly so that its edge rays lie at the image's edge look angles, reproduces NISAR's swath to within a few kilometers. Parameters should be chosen per mode: most modes share a swath of about 240 km, but the 77 MHz mode images a narrower swath. Because NISAR fixes the slant range of its swath rather than its look angles, the look angles at the swath edges vary by up to 0.6 deg around the orbit, which a fixed roll angle and field of view do not follow; the resulting edge errors of about 5 km are small compared with the swath.\n", + "**Velocity frame.** A SAR forms its images in zero-Doppler geometry, in the plane perpendicular to the Earth-fixed velocity, whatever the attitude of the spacecraft. TAT-C's default `VelocityFrame.EARTH_FIXED` reproduces this, while `VelocityFrame.INERTIAL` (appropriate for imagers that scan without yaw steering, such as those of NOAA-20) would displace NISAR's swath edges by up to 50 km along track.\n", "\n", - "**Along-track field of view.** As for the imagers, an along-track field of view tailored to the analysis time step lets consecutive TAT-C views tile the swath, and `collect_observations` reports the time at which the view sweeps over a point, matching NISAR's zero-Doppler times." + "**Roll angle and field of view.** A left-looking `PointedInstrument` with a positive roll angle, rotated rigidly so that its edge rays lie at the image's edge look angles, reproduces NISAR's swath to within a few kilometers. Parameters should be chosen per mode: most modes share a swath of about 240 km, but the 77 MHz mode images a narrower swath. Because NISAR fixes the slant range of its swath rather than its look angles, the look angles at the swath edges vary by up to 0.6 deg around the orbit, which a fixed roll angle and field of view do not follow; the resulting edge errors of about 5 km are small compared with the swath." ] } ], diff --git a/docs/validation/ValidateSARSentinel1.ipynb b/docs/validation/ValidateSARSentinel1.ipynb index 655f9d05..4f6283ea 100644 --- a/docs/validation/ValidateSARSentinel1.ipynb +++ b/docs/validation/ValidateSARSentinel1.ipynb @@ -17,7 +17,7 @@ "2. **Imaging geometry.** What look direction, look angles, and imaging plane do the products describe, and which TAT-C roll angle, field of view, and velocity frame reproduce them?\n", "3. **Swath edges.** How closely do the edges of TAT-C's view match the near-range and far-range edges of the images?\n", "4. **Product footprints.** Does `compute_ground_track` reproduce the footprints of all the products acquired in a day?\n", - "5. **Observation times.** Does `collect_observations` predict when Sentinel-1C images a point?\n", + "5. **Observation times.** Does `collect_observations` predict when Sentinel-1C images a point? This test has moved from this notebook: passes, swath edges, swath intersection over union (IoU), and observation epochs of the catalog's `csar` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_csar.py`; see the [instrument catalog](catalog.rst).\n", "6. **Roll steering.** Does a satellite attitude whose roll angle varies around the orbit (an `Attitude` with a `roll_angle_profile`) reproduce Sentinel-1's roll steering?" ] }, @@ -861,7 +861,7 @@ "source": [ "All lines of sight fall to the right of the ground track and lie in the plane perpendicular to the Earth-fixed velocity (to within 0.002 deg): the images are in zero-Doppler geometry, which TAT-C's default Earth-fixed velocity frame reproduces. The inertial velocity frame would tilt the imaging plane by up to about 2.3 deg.\n", "\n", - "The IW mode images look angles from about 27.1 to 40.4 deg (median; incidence angles of 30.4 to 46.0 deg), a roll angle of 33.8 deg to the right and a cross-track field of view of 13.3 deg; the EW mode images 17.2 to 40.7 deg (incidence 19.1 to 46.4 deg), a roll angle of 29.0 deg and a field of view of 23.6 deg. The look angles vary smoothly with latitude by up to about 2.5 deg within each mode: Sentinel-1 steers its roll angle around the orbit to keep the slant range to the swath nearly constant as its altitude changes. Tests 3 to 5 use a fixed roll angle and field of view from the median look angles; Test 6 models the roll steering with a roll angle that varies around the orbit.\n", + "The IW mode images look angles from about 27.1 to 40.4 deg (median; incidence angles of 30.4 to 46.0 deg), a roll angle of 33.8 deg to the right and a cross-track field of view of 13.3 deg; the EW mode images 17.2 to 40.7 deg (incidence 19.1 to 46.4 deg), a roll angle of 29.0 deg and a field of view of 23.6 deg. The look angles vary smoothly with latitude by up to about 2.5 deg within each mode: Sentinel-1 steers its roll angle around the orbit to keep the slant range to the swath nearly constant as its altitude changes. Tests 3 and 4 use a fixed roll angle and field of view from the median look angles; Test 6 models the roll steering with a roll angle that varies around the orbit.\n", "\n", "## Test 3: Swath Edges\n", "\n", @@ -1300,141 +1300,7 @@ "id": "760ba454", "metadata": {}, "source": [ - "TAT-C reproduces the product footprints with an IoU of 0.93 (median) for IW and 0.96 for EW products. The agreement follows the roll steering: it is best where the look angles are near their medians and worst at high southern latitudes, where the IW look angles are about 1.5 deg smaller.\n", - "\n", - "## Test 5: Observation Times\n", - "\n", - "Each geolocation grid point is a ground point with a known zero-Doppler time: the time at which Sentinel-1C imaged it. For interior grid points of every tenth product (excluding the outer 10% of the slant range extent and the first and last grid lines), `collect_observations` is run over a window of 10 minutes around the zero-Doppler time with the product's mode's `PointedInstrument` in each velocity frame, and the observation epoch nearest the zero-Doppler time is compared with it." - ] - }, - { - "cell_type": "code", - "execution_count": 10, - "id": "ae19443f", - "metadata": { - "execution": { - "iopub.execute_input": "2026-10-25T13:59:45.590130Z", - "iopub.status.busy": "2026-10-25T13:59:45.590130Z", - "iopub.status.idle": "2026-10-25T14:00:26.110700Z", - "shell.execute_reply": "2026-10-25T14:00:26.110700Z" - } - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
pointsmissedtime, median (s)time, p95 |x| (s)time, max |x| (s)
earth_fixed750.00.0-0.0680.4390.495
inertial750.00.0-0.9745.2365.785
\n", - "
" - ], - "text/plain": [ - " points missed time, median (s) time, p95 |x| (s) \\\n", - "earth_fixed 750.0 0.0 -0.068 0.439 \n", - "inertial 750.0 0.0 -0.974 5.236 \n", - "\n", - " time, max |x| (s) \n", - "earth_fixed 0.495 \n", - "inertial 5.785 " - ] - }, - "execution_count": 10, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "rows5 = {}\n", - "for frame in [VelocityFrame.EARTH_FIXED, VelocityFrame.INERTIAL]:\n", - " differences, missed = [], 0\n", - " for mode, m in zip(geometry[\"mode\"][::10], meta[::10]):\n", - " satellite = sentinel1.model_copy(\n", - " update={\n", - " \"instruments\": [sentinel1_view(mode)],\n", - " \"attitude\": Attitude(velocity_frame=frame),\n", - " }\n", - " )\n", - " for i in np.linspace(1, len(m[\"time\"]) - 2, 3).astype(int):\n", - " for j in (\n", - " (np.linspace(0.1, 0.9, 5) * (len(m[\"slant_range\"]) - 1))\n", - " .round()\n", - " .astype(int)\n", - " ):\n", - " point = Point(\n", - " id=0,\n", - " latitude=float(m[\"lat\"][i, j]),\n", - " longitude=float(m[\"lon\"][i, j]),\n", - " )\n", - " truth = DAY + timedelta(seconds=float(m[\"time\"][i]))\n", - " observations = collect_observations(\n", - " point,\n", - " satellite,\n", - " truth - timedelta(minutes=5),\n", - " truth + timedelta(minutes=5),\n", - " )\n", - " if observations.empty:\n", - " missed += 1\n", - " continue\n", - " seconds = (\n", - " (observations.epoch - pd.Timestamp(truth))\n", - " .dt.total_seconds()\n", - " .to_numpy()\n", - " )\n", - " differences.append(seconds[np.argmin(np.abs(seconds))])\n", - " rows5[frame.value] = pd.concat(\n", - " [\n", - " pd.Series({\"points\": len(differences) + missed, \"missed\": missed}),\n", - " summarize(differences).drop(\"n\"),\n", - " ]\n", - " )\n", - "pd.DataFrame(rows5).T.rename(\n", - " columns={\n", - " \"median\": \"time, median (s)\",\n", - " \"p95 |x|\": \"time, p95 |x| (s)\",\n", - " \"max |x|\": \"time, max |x| (s)\",\n", - " }\n", - ").round(3)" + "TAT-C reproduces the product footprints with an IoU of 0.93 (median) for IW and 0.96 for EW products. The agreement follows the roll steering: it is best where the look angles are near their medians and worst at high southern latitudes, where the IW look angles are about 1.5 deg smaller." ] }, { @@ -1442,8 +1308,6 @@ "id": "c5f7743d", "metadata": {}, "source": [ - "With the Earth-fixed velocity frame, `collect_observations` reports each point's observation epoch within 0.44 s of its zero-Doppler time (95th percentile) and observes every point. The inertial velocity frame shifts the epochs by up to about 6 s.\n", - "\n", "## Test 6: Roll Steering\n", "\n", "Sentinel-1 steers by rolling the spacecraft, so the steering is represented as the satellite's `Attitude`, whose roll angle can vary around the orbit with a `roll_angle_profile`: a table of roll angles at arguments of latitude (the angle around the orbit from the ascending node), interpolated linearly. The instrument's view is rotated from the satellite's body, so the instrument keeps the fixed roll angle of its mode, and the attitude's profile is the steering relative to it. For each grid line of the products of Test 2, the satellite's argument of latitude is computed from the TLE at the line's zero-Doppler time, and the roll angle (the mean of the near and far look angles) from the grid. Each mode's profile is the median roll angle in 10 deg bins of argument of latitude, from the even-numbered products; the swath edges of Test 3 are then compared for the odd-numbered products, with the fixed roll angle and with the profile (and the same field of view), and the frame footprints of Test 4 are recomputed with the profiles." @@ -1736,10 +1600,10 @@ "| 2. Imaging geometry | right-looking; images in the plane perpendicular to the *Earth-fixed* velocity (inertial: up to 2.3 deg); IW roll 33.8 deg and field of view 13.3 deg, EW 29.0 and 23.6 deg; roll steering varies look angles by up to 2.5 deg |\n", "| 3. Swath edges | 3 km along track and 14 to 20 km across track (95th percentile) with the Earth-fixed frame; 24 to 41 km along track with the inertial frame |\n", "| 4. Product footprints (`compute_ground_track`) | IoU 0.93 (IW) and 0.96 (EW), median, for all 499 products |\n", - "| 5. Observation times (`collect_observations`) | 0.44 s (95th percentile) with the Earth-fixed frame; up to 6 s with the inertial frame |\n", + "| 5. Observation times (`collect_observations`) | tested by the catalog's validation of the `csar` entry (see the [instrument catalog](catalog.rst)) |\n", "| 6. Roll steering (`Attitude` with a `roll_angle_profile`) | swath edges within 6 to 7 km across track (95th percentile), instead of 14 to 20 km with a fixed roll angle; footprint IoU 5th percentile 0.92 (IW) and 0.94 (EW) |\n", "\n", - "**Velocity frame.** As for NISAR, Sentinel-1's zero-Doppler images lie in the plane perpendicular to the Earth-fixed velocity, which TAT-C's default `VelocityFrame.EARTH_FIXED` reproduces; the inertial frame would displace swath edges by up to 41 km along track and observation times by up to 6 s.\n", + "**Velocity frame.** As for NISAR, Sentinel-1's zero-Doppler images lie in the plane perpendicular to the Earth-fixed velocity, which TAT-C's default `VelocityFrame.EARTH_FIXED` reproduces; the inertial frame would displace swath edges by up to 41 km along track.\n", "\n", "**Roll steering.** A right-looking `PointedInstrument` with a negative roll angle and rigid rotation reproduces Sentinel-1C's swath geometry, with per-mode parameters. Sentinel-1 steers its roll angle around the orbit, so its look angles vary by up to 2.5 deg; a fixed roll angle and field of view, set to the median look angles, misplace the swath edges by up to about 20 km (95th percentile) where the look angles depart most from the median. The satellite's attitude with a roll angle profile (an `Attitude` with a `roll_angle_profile`, as a function of argument of latitude), from which the instrument's fixed view is rotated, models the roll steering and reduces these errors to about 7 km." ] diff --git a/docs/validation/standard.rst b/docs/validation/standard.rst index b03c03dc..0d9e61f4 100644 --- a/docs/validation/standard.rst +++ b/docs/validation/standard.rst @@ -238,8 +238,10 @@ Back-Test ========= Results from :doc:`summary` against the thresholds. These come from each notebook -as it was run, generally with fitted values and without holdout, so passing here -does not make an instrument `validated`. Failures are listed, not explained away: +as it was run when this standard was drafted, generally with fitted values and +without holdout, so passing here does not make an instrument `validated`. Some of +these tests have since moved from the notebooks to the catalog's validation +scripts, whose results are on the :doc:`catalog` page. Failures are listed, not explained away: no threshold was loosened to pass one of them. .. list-table:: diff --git a/docs/validation/summary.rst b/docs/validation/summary.rst index 0632c07a..83259451 100644 --- a/docs/validation/summary.rst +++ b/docs/validation/summary.rst @@ -122,10 +122,12 @@ Instruments and Pointing set, swath IoU 0.963 to 0.978, but still 97.5 to 98.6% of passes predicted (:doc:`catalog`) * - Conical scanners (`ConicalInstrument`) - GCOM-W AMSR2, GPM GMI, SMAP radiometer, DMSP F18 SSMIS, TRMM TMI - - 99.95 to 100% of passes, epochs within 0.27 s (AMSR2) and 0.69 s (GMI) at the 95th percentile; swath IoU 0.998 - to 0.999; SMAP's forward and aft looks within 0.2 s (median) (:doc:`ValidateConicalAMSR2`, - :doc:`ValidateConicalGMI`, :doc:`ValidateGridSMAP`). On held-out AMSR2 data, 99.98% of passes predicted, - epochs within 0.79 s (95th percentile), swath width within 2.8 km, and swath IoU 0.998; on held-out SMAP Level + - AMSR2: 99.95% of passes, epochs within 0.27 s (95th percentile) (:doc:`ValidateConicalAMSR2`); GMI: swath + width within 0.4 km (95th percentile) (:doc:`ValidateConicalGMI`); SMAP's forward and aft looks within 0.2 s + (median) (:doc:`ValidateGridSMAP`). On held-out AMSR2 data, 99.98% of passes predicted, + epochs within 0.79 s (95th percentile), swath width within 2.8 km, and swath IoU 0.998; on held-out GMI data, + 99.93 to 100% of passes predicted with both feeds, epochs within 0.63 s (95th percentile), swath width within + 0.25 km, and swath IoU 0.999; on held-out SMAP Level 1B footprints, 100% of passes predicted with both looks, epochs within 0.14 s (95th percentile), swath width within 2.1 km, and swath IoU 0.998; on held-out SSMIS data, 99.7% of passes predicted, epochs within 0.51 s (95th percentile), swath width within 2.6 km, and swath IoU 0.992 (:doc:`catalog`). TMI's three feeds, on @@ -133,11 +135,12 @@ Instruments and Pointing 2.9 km, and swath IoU 0.995 or more (:doc:`catalog`) * - Side-looking SAR (`PointedInstrument` with roll, `roll_angle_profile`) - NISAR, Sentinel-1C - - Epochs within 0.3 and 0.44 s (95th percentile) of zero-Doppler times; footprint IoU 0.93 to 0.96 (median); roll - steering profiles bring swath edges within 6 to 7 km (:doc:`ValidateSARNISAR`, :doc:`ValidateSARSentinel1`). - On held-out Sentinel-1C data, IW's swath edges within 6.7 to 6.9 km (95th percentile) and swath IoU 0.974, but - 98.98% of its passes predicted, the misses at the swath edges; EW, on a later held-out day, predicted 99.16% of - passes, with edges within 7.6 to 9.5 km and swath IoU 0.989 (:doc:`catalog`). On held-out NISAR data of its modes with a 20 or 40 MHz band, + - NISAR's swath edges within 5 to 7 km across track (95th percentile) (:doc:`ValidateSARNISAR`); roll + steering profiles bring Sentinel-1C's within 6 to 7 km (:doc:`ValidateSARSentinel1`). + On held-out Sentinel-1C data, IW's swath edges within 6.7 to 6.9 km (95th percentile), epochs within 0.43 s + of zero-Doppler times, and swath IoU 0.974, but 98.98% of its passes predicted, the misses at the swath edges; + EW, on a later held-out day, predicted 99.16% of passes, with edges within 7.6 to 9.5 km, epochs within + 0.34 s, and swath IoU 0.989 (:doc:`catalog`). On held-out NISAR data of its modes with a 20 or 40 MHz band, 99.27% of passes predicted, epochs within 0.92 s, and far-range edges within 6.8 km, but near-range edges within 12.1 km (95th percentile) with a fixed field of view, and swath IoU 0.974 (:doc:`catalog`). NISAR's 77 MHz mode, on four held-out days with an element set of each day: 99.01% of passes predicted, edges within 3.1 km and epochs within 0.13 s (95th percentile); with an element set diff --git a/src/tatc/resources/instruments/amsr2.yml b/src/tatc/resources/instruments/amsr2.yml index e97d1f56..cd9d11fc 100644 --- a/src/tatc/resources/instruments/amsr2.yml +++ b/src/tatc/resources/instruments/amsr2.yml @@ -32,7 +32,7 @@ configurations: provenance: cone_angle: &measured kind: measured - source: ValidateConicalAMSR2, Test 2 (printed to 3 decimals) + source: validate_catalog_amsr2.py --fit, medians over every 20th scan of the 10.65 GHz group (printed to 3 decimals), first measured in ValidateConicalAMSR2 on the 49,695 scans then archived; the 57,606 scans archived since give a half width of 75.333 platform: gcom-w period: "2026-09-26" scan_center_azimuth: *measured @@ -68,7 +68,7 @@ configurations: source: JAXA AMSR2 channel set (beam width) scan_sample_spacing: kind: measured - source: ValidateSampleSizes, Test 3 (243 samples of the 10.65 GHz group) + source: validate_catalog_amsr2.py --fit, the median azimuth step between the 243 samples of the 10.65 GHz group platform: gcom-w period: "2026-09-26" - type: conical diff --git a/src/tatc/resources/instruments/cris.yml b/src/tatc/resources/instruments/cris.yml index 770995f0..98edef70 100644 --- a/src/tatc/resources/instruments/cris.yml +++ b/src/tatc/resources/instruments/cris.yml @@ -39,7 +39,7 @@ configurations: provenance: field_of_regard: &measured_extent kind: measured - source: ValidateImagerCrIS, between the outermost centers of fields of regard (printed to 6 decimals) + source: validate_catalog_cris.py --fit, between the outermost centers of fields of regard (printed to 6 decimals) platform: noaa-20 period: "2026-10-02" cross_track_field_of_view: *measured_extent @@ -49,7 +49,7 @@ configurations: source: compute_along_track_field_of_view, from the orbit and time step pitch_angle: &measured_tilt kind: measured - source: ValidateImagerCrIS, the median forward tilt of the scan plane (printed to 3 decimals) + source: validate_catalog_cris.py --fit, the median forward tilt of the scan plane (the median over every 5th scan of each scan's median, printed to 3 decimals) platform: noaa-20 period: "2026-10-02" is_rectangular: @@ -85,12 +85,12 @@ configurations: source: Wider than the field of view, so that it does not clip the scan cross_track_field_of_view: kind: measured - source: ValidateImagerCrIS, 30 fields of regard at a fitted spacing of 3.33399 deg + source: validate_catalog_cris.py --fit, 30 fields of regard at a fitted spacing of 3.33399 deg platform: noaa-20 period: "2026-10-02" along_track_field_of_view: &measured_pitch kind: measured - source: ValidateImagerCrIS, three fields of view at a fitted pitch of 1.0918 deg + source: validate_catalog_cris.py --fit, three fields of view at a fitted pitch of 1.0918 deg platform: noaa-20 period: "2026-10-02" cross_track_pixels: @@ -101,7 +101,7 @@ configurations: source: CrIS has three rows of fields of view in a field of regard roll_angle: kind: measured - source: ValidateImagerCrIS, the fitted roll + source: validate_catalog_cris.py --fit, the fitted roll platform: noaa-20 period: "2026-10-02" pitch_angle: *measured_tilt diff --git a/src/tatc/resources/instruments/gmi.yml b/src/tatc/resources/instruments/gmi.yml index e3b7e4ec..0d07686d 100644 --- a/src/tatc/resources/instruments/gmi.yml +++ b/src/tatc/resources/instruments/gmi.yml @@ -33,7 +33,7 @@ configurations: provenance: cone_angle: &measured kind: measured - source: ValidateConicalGMI, Test 2 (printed to 3 decimals) + source: validate_catalog_gmi.py --fit, medians over every 20th scan of each feed (printed to 3 decimals) platform: gpm period: "2026-10-03" scan_center_azimuth: *measured diff --git a/src/tatc/resources/instruments/modis.yml b/src/tatc/resources/instruments/modis.yml index 390bdc22..c48dcfc5 100644 --- a/src/tatc/resources/instruments/modis.yml +++ b/src/tatc/resources/instruments/modis.yml @@ -42,7 +42,7 @@ configurations: provenance: field_of_regard: &measured_extent kind: measured - source: ValidateDriftMODIS, Test 3, 1,353 frame spacings of a fitted 0.08124 deg + source: validate_catalog_modis.py --fit, 1,353 frame spacings of a fitted 0.08124 deg platform: terra period: "2026-10-04" cross_track_field_of_view: *measured_extent @@ -80,12 +80,12 @@ configurations: source: Wider than the field of view, so that it does not clip the scan cross_track_field_of_view: kind: measured - source: ValidateDriftMODIS, Test 3, 1,354 frames of a fitted 0.08124 deg + source: validate_catalog_modis.py --fit, 1,354 frames of a fitted 0.08124 deg platform: terra period: "2026-10-04" along_track_field_of_view: kind: measured - source: ValidateDriftMODIS, Test 3, 10 detectors, from 0.7311 deg over the 9 spacings between the first and last + source: validate_catalog_modis.py --fit, 10 detectors, from 0.7311 deg over the 9 spacings between the first and last platform: terra period: "2026-10-04" cross_track_pixels: @@ -96,7 +96,7 @@ configurations: source: The 1 km bands have 10 detectors roll_angle: kind: measured - source: ValidateDriftMODIS, Test 3, the fitted offset of the scan angle + source: validate_catalog_modis.py --fit, the fitted offset of the scan angle platform: terra period: "2026-10-04" view_geometry: diff --git a/src/tatc/resources/instruments/smap_radiometer.yml b/src/tatc/resources/instruments/smap_radiometer.yml index 5e9d5690..ec177aba 100644 --- a/src/tatc/resources/instruments/smap_radiometer.yml +++ b/src/tatc/resources/instruments/smap_radiometer.yml @@ -32,7 +32,7 @@ configurations: provenance: cone_angle: kind: measured - source: ValidateGridSMAP, the angle from nadir of a boresight at the median incidence angle of a day of looks (39.97 deg), at the mean altitude, on a spherical Earth (printed to 3 decimals) + source: validate_catalog_smap.py --fit, the angle from nadir of a boresight at the median incidence angle of a day of forward looks of SPL1CTB (39.97 deg), at the mean altitude, on a spherical Earth (printed to 3 decimals) platform: smap period: "2026-10-24" scan_center_azimuth: @@ -64,7 +64,7 @@ configurations: provenance: cone_angle: kind: measured - source: ValidateGridSMAP, as for the looks configuration + source: validate_catalog_smap.py --fit, as for the looks configuration platform: smap period: "2026-10-24" scan_center_azimuth: diff --git a/tests/catalog/test_entries.py b/tests/catalog/test_entries.py index 4cc1be04..06c2fb3f 100644 --- a/tests/catalog/test_entries.py +++ b/tests/catalog/test_entries.py @@ -339,8 +339,8 @@ def test_payload(self): def test_tailored_field_of_view(self): """ - Test that tailored fields of view match those of the GMI notebook, whose - tests reported these values for this orbit. + Test that tailored fields of view match the values of 1.78, 9.45, and 27.85 + deg reported for this orbit when the configuration was validated. """ for time_step, expected in ((1.875, 1.78), (10, 9.45), (30, 27.85)): payload = self.entry.build(orbit=self.orbit, time_step=time_step) diff --git a/validation/README.md b/validation/README.md index 904d7ee9..8a69b239 100644 --- a/validation/README.md +++ b/validation/README.md @@ -33,7 +33,7 @@ Without `--write`, a script prints its results. The exception is `validate_catal ## Accounts - NOAA Open Data Dissemination (JPSS, GOES, Himawari) and Microsoft Planetary Computer: anonymous. -- NASA DAACs: an Earthdata token in `EARTHDATA_TOKEN` ([NASA Earthdata Login](https://urs.earthdata.nasa.gov/)). +- NASA DAACs: a [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account, as a token in `EARTHDATA_TOKEN` or, failing that, the credentials of `urs.earthdata.nasa.gov` in `~/.netrc`. - EarthCARE (ATLID, BBR, CPR, MSI): an ESA MAAP offline token in `ESA_MAAP_KEY`. Each script's docstring states what it needs. diff --git a/validation/catalog/gesdisc_scanner.py b/validation/catalog/gesdisc_scanner.py index adaeeefd..083c9258 100644 --- a/validation/catalog/gesdisc_scanner.py +++ b/validation/catalog/gesdisc_scanner.py @@ -54,6 +54,7 @@ up, update_fixture, update_record, + login_earthdata, ) EARTH_ROTATION = 7.2921150e-5 # rad/s @@ -164,8 +165,7 @@ def load_day(product: Product, day: datetime, directory: pathlib.Path) -> dict: cache = directory / f"{product.short_name.lower()}_{day:%Y%m%d}.npz" if cache.exists(): return dict(np.load(cache)) - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() urls = find_granules(product, day) read = product.read or read_gpm diff --git a/validation/catalog/validate_catalog_amsr2.py b/validation/catalog/validate_catalog_amsr2.py index aceb4c42..3e1ce98e 100644 --- a/validation/catalog/validate_catalog_amsr2.py +++ b/validation/catalog/validate_catalog_amsr2.py @@ -1,17 +1,24 @@ """ Validates the AMSR2 catalog entry against the GPM Level 1C AMSR2 product, using -the exact values of the entry through public TAT-C methods. The tests follow -`ValidateConicalAMSR2`, whose day of data the entry's angles were fitted to: -running on that day checks this script against the notebook, while running on a -day at least 30 days from it tests the fitted angles on data held out from the -fit. Element sets for other days can be given in a file of the history of +the exact values of the entry through public TAT-C methods. The tests of passes, +epochs, and swath width follow `ValidateConicalAMSR2`, on whose day of data the +entry's angles were fitted; the test of swath area is this script's own. Running on +that day checks the shared tests against the notebook, while running on a day at +least 30 days from it tests the fitted angles on data held out from the fit. Element sets for other days can be given in a file of the history of GCOM-W's element sets. -Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: +Needs the `validation` extra and a NASA Earthdata login: + python validation/catalog/validate_catalog_amsr2.py 2026-09-26 --fit python validation/catalog/validate_catalog_amsr2.py 2026-09-26 python validation/catalog/validate_catalog_amsr2.py 2026-11-01 +With `--fit`, it measures the angles of the entry's configurations instead, on the +day of the fit, as `ValidateConicalAMSR2` did: the cone angle of the lines of sight +from geodetic nadir and the center and half width of the scan sector in azimuth +from the inertial velocity (medians over every 20th scan with contiguous +neighbors), of the 10.65 GHz group (S1), with the azimuth step between its samples. It prints them, without writing. + It also validates the entry's sample size configuration, following `ValidateSampleSizes`. The gated metric compares sizes with footprints published by JAXA, which are independent of the fit of the angles. The spacing of samples on @@ -104,8 +111,7 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: """Downloads and reduces all orbits of a day, or loads them from a cache.""" cache = directory / f"amsr2_l1c_{day:%Y%m%d}.npz" if not cache.exists(): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + validation_io.login_earthdata() session = earthaccess.get_requests_https_session() granules = requests.get( "https://cmr.earthdata.nasa.gov/search/granules.umm_json", @@ -363,7 +369,7 @@ def predict(item): def get_orbit_scans(reference: Reference, period: float) -> np.ndarray: """ Gets the scans of the first orbit from 12:00 UTC without a gap in the data, as - `ValidateConicalAMSR2` used an orbit after the gap of its day. + an earlier version of `ValidateConicalAMSR2` used an orbit after the gap of its day. """ time = reference.time start = 12 * 3600 @@ -695,18 +701,44 @@ def read_elements(path: pathlib.Path, day: datetime) -> list[str]: return [line for epoch in sorted(pairs) for line in pairs[epoch]] +def fit(reference: Reference) -> None: + """ + Prints the cone and scan sector of the 10.65 GHz group (S1), measured on every + 20th scan with contiguous neighbors, as `ValidateConicalAMSR2` measured them. + """ + velocity = np.gradient(reference.position, reference.time, axis=0) + scans = np.nonzero(reference.contiguous)[0][::20] + lon, lat = reference.foot["S1"] + values = validation_io.fit_cone( + reference.position[scans], velocity[scans], lon[scans], lat[scans] + ) + print(f"{len(reference.time)} scans, {len(scans)} measured") + for key in ("cone_angle", "scan_center_azimuth", "scan_half_width"): + print(f"{key}: {values[key]:.3f}") + print(f"scan_sample_spacing: {values['scan_sample_spacing']:.4f}") + print( + f"azimuths of the first and last samples: {values['first_azimuth']:.2f}, " + f"{values['last_azimuth']:.2f}; center from the Earth-fixed velocity: " + f"{values['scan_center_azimuth_earth_fixed']:.3f}" + ) + + def main() -> None: """Validates the entry on a day of data.""" parser = argparse.ArgumentParser(description=__doc__) parser.add_argument("directory", type=pathlib.Path) parser.add_argument("day") parser.add_argument("--elements", type=pathlib.Path) + parser.add_argument("--fit", action="store_true") parser.add_argument("--sample-sizes-only", action="store_true") parser.add_argument("--write", action="store_true") arguments = parser.parse_args() arguments.directory.mkdir(parents=True, exist_ok=True) day = datetime.fromisoformat(arguments.day).replace(tzinfo=timezone.utc) + if arguments.fit: + fit(Reference(day, load_day(day, arguments.directory))) + return if arguments.elements is not None: tle = read_elements(arguments.elements, day) elif arguments.day in ELEMENTS: diff --git a/validation/catalog/validate_catalog_ascat.py b/validation/catalog/validate_catalog_ascat.py index 2ee49308..02c4e591 100644 --- a/validation/catalog/validate_catalog_ascat.py +++ b/validation/catalog/validate_catalog_ascat.py @@ -77,6 +77,7 @@ FIXTURES, source_of, ELEMENT_SET_FOLDER, + login_earthdata, ) RECORD_PATH = RECORDS / "ascat.json" @@ -176,8 +177,7 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict: if u["URL"].startswith("https://archive.podaac") and u["URL"].endswith(".nc") ) - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() folder = directory / f"ascat_{day:%Y%m%d}" folder.mkdir(exist_ok=True) diff --git a/validation/catalog/validate_catalog_atlas.py b/validation/catalog/validate_catalog_atlas.py index 907a318f..059411a6 100644 --- a/validation/catalog/validate_catalog_atlas.py +++ b/validation/catalog/validate_catalog_atlas.py @@ -61,6 +61,7 @@ FIXTURES, source_of, ELEMENT_SET_FOLDER, + login_earthdata, ) RECORD_PATH = RECORDS / "atlas.json" @@ -104,8 +105,7 @@ def load_day(day: datetime, directory: pathlib.Path) -> pd.DataFrame: """ cache = directory / f"atl08ql_{day:%Y%m%d}.csv" if not cache.exists(): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() results = earthaccess.search_data( short_name="ATL08QL", diff --git a/validation/catalog/validate_catalog_atms.py b/validation/catalog/validate_catalog_atms.py index e2aafeec..5d88f83d 100644 --- a/validation/catalog/validate_catalog_atms.py +++ b/validation/catalog/validate_catalog_atms.py @@ -1,10 +1,11 @@ """ Validates the ATMS catalog entry against the NOAA-20 ATMS geolocation product, using -the exact values of the entry through public TAT-C methods. The tests follow -`ValidateImagerATMS`, whose day of data the entry's angles were fitted to, and -`ValidateSampleSizes`: running on that day checks this script against the notebooks, -while running on a day at least 30 days from it tests the fitted angles on data held -out from the fit. +the exact values of the entry through public TAT-C methods. The tests of pixels and +swath width follow `ValidateImagerATMS`, on whose day of data the entry's angles were +fitted, and those of sizes and spacing follow `ValidateSampleSizes`; the tests of +passes, epochs, and swath area are this script's own. Running on that day checks the +shared tests against the notebooks, while running on a day at least 30 days from it +tests the fitted angles on data held out from the fit. Reads anonymous public data, and needs the `validation` extra: diff --git a/validation/catalog/validate_catalog_ceres.py b/validation/catalog/validate_catalog_ceres.py index dcfb0cd7..6bb1c431 100644 --- a/validation/catalog/validate_catalog_ceres.py +++ b/validation/catalog/validate_catalog_ceres.py @@ -46,6 +46,7 @@ RECORDS, FIXTURES, source_of, + login_earthdata, ) FIT_DAY = datetime(2026, 8, 25, tzinfo=timezone.utc) @@ -81,8 +82,7 @@ def download(day: datetime, directory: pathlib.Path) -> pathlib.Path: ) path = directory / url.split("/")[-1] if not path.exists(): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() with session.get(url, stream=True, timeout=600) as response: response.raise_for_status() diff --git a/validation/catalog/validate_catalog_cris.py b/validation/catalog/validate_catalog_cris.py index 0a6e2497..d0ac6fdf 100644 --- a/validation/catalog/validate_catalog_cris.py +++ b/validation/catalog/validate_catalog_cris.py @@ -1,16 +1,27 @@ """ Validates the CrIS catalog entry against the NOAA-20 CrIS geolocation product, using -the exact values of the entry through public TAT-C methods. The tests follow -`ValidateImagerCrIS`, whose day of data the entry's angles were fitted to, and -`ValidateSampleSizes`: running on that day checks this script against the notebooks, -while running on a day at least 30 days from it tests the fitted angles on data held -out from the fit. +the exact values of the entry through public TAT-C methods. The tests of pixels +follow `ValidateImagerCrIS`, on whose day of data the entry's angles were fitted, and +those of sizes and spacing follow `ValidateSampleSizes`; the tests of passes, epochs, +and swath width and area are this script's own. Running on that day checks the shared +tests against the notebooks, while running on a day at least 30 days from it tests the +fitted angles on data held out from the fit. Reads anonymous public data, and needs the `validation` extra: + python validation/catalog/validate_catalog_cris.py 2026-10-02 --fit python validation/catalog/validate_catalog_cris.py 2026-10-02 python validation/catalog/validate_catalog_cris.py 2026-08-12 +With `--fit`, it measures the values of the entry's configurations instead, as +`ValidateImagerCrIS` did, on the scans of the day of the fit from 12:00 to 14:00 UTC: +the scan plane of each scan (normal to the lines of sight to the centers of its fields +of regard, from the spacecraft at each field of regard's time), the spacing and roll +of a line fitted to the median scan angles of the fields of regard in that plane, the +outermost of those angles, the pitch of the three by three fields of view, and the +forward tilt of the scan plane from nadir. It prints them, with the values derived +from them, without writing. + With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -34,6 +45,7 @@ from skyfield.api import wgs84 import tatc +import validation_io from tatc.catalog import get_entry from tatc.catalog.metrics import summarize from tatc.generation import generate_points_fibonacci_lattice @@ -98,6 +110,20 @@ PIXEL_SCAN_STRIDE, WIDTH_SCAN_STRIDE = 100, 5 FIXTURE_PASSES, FIXTURE_PIXELS = 60, 200 NADIR_FORS = (14, 15) +# the hours (UTC) of the day of the fit whose scans the fit measures, the fields it +# reads, and the published diameter of a field of view (deg) +FIT_HOURS = (12, 14) +FIT_FIELDS = ( + "MidTime", + "FORTime", + "SCPosition", + "SCVelocity", + "Latitude", + "Longitude", + "Height", + "QF1_CRISSDRGEO", +) +FOV_DIAMETER = 0.963 def load_day(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: @@ -471,11 +497,125 @@ def satellite_for(time_step: float): ) +def load_fit_hours(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: + """ + Downloads the geolocation, with the spacecraft's position and velocity, of the + hours of a day that the fit measures, or loads it from a cache. + """ + first, last = FIT_HOURS + path = directory / f"cris_gcrso_{day:%Y%m%d}_{first:02d}-{last:02d}h.npz" + if not path.exists(): + + def read(key): + with h5py.File(io.BytesIO(fetch(key))) as f: + return {k: f["All_Data/CrIS-SDR-GEO_All/" + k][:] for k in FIT_FIELDS} + + keys = [ + k + for k in list_keys(f"CrIS-SDR-GEO/{day:%Y/%m/%d}/") + if first <= int(k.split("_t")[1][:2]) < last + ] + with concurrent.futures.ThreadPoolExecutor(16) as pool: + granules = list(pool.map(read, keys)) + np.savez_compressed( + path, **{k: np.concatenate([g[k] for g in granules]) for k in FIT_FIELDS} + ) + return dict(np.load(path)) + + +def fit(data: dict[str, np.ndarray]) -> None: + """ + Prints the values of the entry's configurations measured from scans with their + spacecraft's position and velocity, as `ValidateImagerCrIS` measured them. + """ + good = (data["QF1_CRISSDRGEO"] == 0) & np.all( + np.abs(data["Latitude"]) <= 90, axis=(1, 2) + ) + seconds = (data["FORTime"][good] - data["MidTime"][good][:, np.newaxis]) / 1e6 + position = data["SCPosition"][good].astype(float) + velocity = data["SCVelocity"][good].astype(float) + # the spacecraft at each field of regard's time, extrapolated from the middle time + spacecraft = position[:, None] + velocity[:, None] * seconds[..., None] + sub_lon, sub_lat, _ = validation_io.TO_GEODETIC.transform( + *np.moveaxis(spacecraft, -1, 0) + ) + nadir = -up(sub_lon, sub_lat) + lines = normalize( + ecef( + data["Longitude"][good].astype(float), + data["Latitude"][good].astype(float), + data["Height"][good].astype(float), + ) + - spacecraft[:, :, None] + ) + # the scan plane of each scan, normal to the lines of sight to the centers of its + # fields of regard, facing forward + centers = normalize(lines.mean(axis=2)) + normal = np.array([np.linalg.svd(c)[2][-1] for c in centers]) + normal *= np.sign(np.sum(normal * velocity, axis=-1))[:, None] + n = normal[:, None] + # scan angles in the plane, positive to the left, and angles out of it, forward + nadir_plane = normalize(nadir - np.sum(nadir * n, axis=-1, keepdims=True) * n) + left_plane = np.cross(n, nadir_plane) + in_plane = ( + lines - np.sum(lines * n[:, :, None], axis=-1, keepdims=True) * n[:, :, None] + ) + cross = np.degrees( + np.arctan2( + np.sum(in_plane * left_plane[:, :, None], axis=-1), + np.sum(in_plane * nadir_plane[:, :, None], axis=-1), + ) + ) + along = np.degrees(np.arcsin(np.einsum("kjic,kc->kji", lines, normal))) + scan_angles = cross.mean(axis=2) + measured = np.median(scan_angles, axis=0) + # a line in the index of fields of regard: roll + spacing * (14.5 - index), with + # the sign of the side of field of regard 0 + orientation = np.sign(measured[0] - measured[-1]) + spacing, roll = np.polyfit( + orientation * ((N_FOR - 1) / 2 - np.arange(N_FOR)), measured, 1 + ) + # the pitch of the fields of view: the mean distance of the central view's four + # nearest neighbors, from the median offsets of the fields of regard nearest nadir + offsets = np.stack( + [ + np.median(cross - scan_angles[..., None], axis=0), + np.median(along - along.mean(axis=2, keepdims=True), axis=0), + ], + axis=-1, + )[list(NADIR_FORS)].mean(axis=0) + pitch = float(np.sort(np.hypot(*offsets.T))[1:5].mean()) + # the forward tilt of the scan plane from nadir, at every field of regard + tilt = -np.degrees(np.arcsin(np.sum(nadir * n, axis=-1))) + cross_track_field_of_view = N_FOR * round(spacing, 5) + print(f"{good.sum()} scans from {FIT_HOURS[0]:02d}:00 to {FIT_HOURS[1]:02d}:00 UTC") + print(f"spacing of fields of regard: {spacing:.5f} deg") + print(f"roll_angle: {roll:.6f}") + print( + f"outermost scan angles: {measured.max():.6f} (left), {measured.min():.6f} " + f"(right); field_of_regard (swath): {measured.max() - measured.min():.6f}" + ) + print(f"pitch of fields of view: {pitch:.4f} deg") + print( + "pitch_angle (median over every 5th scan of each scan's median tilt): " + f"{np.median(np.median(tilt[::5], axis=1)):.3f}; median over all fields of " + f"regard: {np.median(tilt):.6f}" + ) + print( + f"pixels: cross_track_field_of_view {cross_track_field_of_view:.4f}, " + f"along_track_field_of_view {3 * round(pitch, 4):.4f}, " + "cross_track_oversampling " + f"{1 - cross_track_field_of_view / (3 * N_FOR) / FOV_DIAMETER:.6f}, " + f"along_track_oversampling {1 - round(pitch, 4) / FOV_DIAMETER:.6f}" + ) + + def main() -> None: """Validates the entry on a day of data.""" parser = argparse.ArgumentParser(description=__doc__) parser.add_argument("directory", type=pathlib.Path) parser.add_argument("day") + parser.add_argument("--fit", action="store_true") parser.add_argument("--sample-sizes-only", action="store_true") parser.add_argument("--write", action="store_true") parser.add_argument("--platform", default=FIT_PLATFORM) @@ -483,6 +623,10 @@ def main() -> None: arguments.directory.mkdir(parents=True, exist_ok=True) day = datetime.fromisoformat(arguments.day).replace(tzinfo=timezone.utc) + if arguments.fit: + use_archive(arguments.platform) + fit(load_fit_hours(day, arguments.directory)) + return prefix = use_archive(arguments.platform) directory = ( arguments.directory diff --git a/validation/catalog/validate_catalog_ecostress.py b/validation/catalog/validate_catalog_ecostress.py index 86198892..76d84f86 100644 --- a/validation/catalog/validate_catalog_ecostress.py +++ b/validation/catalog/validate_catalog_ecostress.py @@ -57,6 +57,7 @@ RECORDS, FIXTURES, source_of, + login_earthdata, ) FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) @@ -116,8 +117,7 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict: """Reads and reduces the scenes of a day, or loads them from a cache.""" cache = directory / f"ecostress_{day:%Y%m%d}.npz" if not cache.exists(): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() scenes = [ url diff --git a/validation/catalog/validate_catalog_emit.py b/validation/catalog/validate_catalog_emit.py index b13dce7f..3dba53f3 100644 --- a/validation/catalog/validate_catalog_emit.py +++ b/validation/catalog/validate_catalog_emit.py @@ -58,6 +58,7 @@ RECORDS, FIXTURES, source_of, + login_earthdata, ) RECORD_PATH = RECORDS / "emit.json" @@ -127,8 +128,7 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict: """Reads and reduces the scenes of a day, or loads them from a cache.""" cache = directory / f"emit_{day:%Y%m%d}.npz" if not cache.exists(): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() scenes = [ url diff --git a/validation/catalog/validate_catalog_gedi.py b/validation/catalog/validate_catalog_gedi.py index 3d369682..6f4d047b 100644 --- a/validation/catalog/validate_catalog_gedi.py +++ b/validation/catalog/validate_catalog_gedi.py @@ -64,6 +64,7 @@ FIXTURES, source_of, ELEMENT_SET_FOLDER, + login_earthdata, ) RECORD_PATH = RECORDS / "gedi.json" @@ -179,8 +180,7 @@ def load_day(day: datetime, directory: pathlib.Path) -> pd.DataFrame: ) for item in items ] - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() with concurrent.futures.ThreadPoolExecutor(8) as pool: parts = [ diff --git a/validation/catalog/validate_catalog_gmi.py b/validation/catalog/validate_catalog_gmi.py index 3c9b6e6e..39315bcc 100644 --- a/validation/catalog/validate_catalog_gmi.py +++ b/validation/catalog/validate_catalog_gmi.py @@ -1,19 +1,26 @@ """ Validates the GMI catalog entry against the GPM Level 1C GMI product, using the -exact values of the entry through public TAT-C methods. The tests follow -`ValidateConicalGMI`, whose day of data the entry's angles were fitted to: -running on that day checks this script against the notebook, while running on a -day at least 30 days from it tests the fitted angles on data held out from the -fit. The day must be one on which GPM flew forward, as it does for about 40 days +exact values of the entry through public TAT-C methods. The test of swath width +follows `ValidateConicalGMI`, on whose day of data the entry's angles were fitted; +the tests of passes, epochs, and swath area are this script's own. Running on that day +checks the shared test against the notebook, while running on a day at least 30 days +from it tests the fitted angles on data held out from the fit. The day must be one on which GPM flew forward, as it does for about 40 days at a time, because the configuration represents forward flight. Element sets for other days can be given in a file of the history of GPM's element sets. -Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: +Needs the `validation` extra and a NASA Earthdata login: + python validation/catalog/validate_catalog_gmi.py 2026-10-03 --fit python validation/catalog/validate_catalog_gmi.py 2026-10-03 python validation/catalog/validate_catalog_gmi.py 2026-07-20 \ --elements +With `--fit`, it measures the angles of the entry's configurations instead, on the +day of the fit, as `ValidateConicalGMI` did: for each feed, the cone angle of the +lines of sight from geodetic nadir and the center and half width of the scan sector +in azimuth from the inertial velocity (medians over every 20th scan with contiguous +neighbors). It prints them, without writing. + It also validates the entry's sample size configuration, following `ValidateSampleSizes`. The gated metric compares sizes with footprints published for two altitudes, which are independent of the fit of the angles. The spacing of @@ -111,8 +118,7 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: """Downloads and reduces all orbits of a day, or loads them from a cache.""" cache = directory / f"gmi_l1c_{day:%Y%m%d}.npz" if not cache.exists(): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + validation_io.login_earthdata() session = earthaccess.get_requests_https_session() granules = requests.get( "https://cmr.earthdata.nasa.gov/search/granules.umm_json", @@ -708,18 +714,46 @@ def read_elements(path: pathlib.Path, day: datetime) -> list[str]: return [line for epoch in sorted(pairs) for line in pairs[epoch]] +def fit(reference: Reference) -> None: + """ + Prints the cone and scan sector of each feed, measured on every 20th scan with + contiguous neighbors, as `ValidateConicalGMI` measured them. + """ + scans = np.nonzero(reference.contiguous)[0][::20] + print(f"{len(reference.time)} scans, {len(scans)} measured") + for feed in FEEDS: + lon, lat = reference.foot[feed] + values = validation_io.fit_cone( + reference.position[scans], + reference.velocity[scans], + lon[scans], + lat[scans], + ) + print( + f"{feed}: cone_angle {values['cone_angle']:.3f}, " + f"scan_center_azimuth {values['scan_center_azimuth']:.3f}, " + f"scan_half_width {values['scan_half_width']:.3f} " + f"(azimuth step {values['scan_sample_spacing']:.4f}; center from the " + f"Earth-fixed velocity {values['scan_center_azimuth_earth_fixed']:.3f})" + ) + + def main() -> None: """Validates the entry on a day of data.""" parser = argparse.ArgumentParser(description=__doc__) parser.add_argument("directory", type=pathlib.Path) parser.add_argument("day") parser.add_argument("--elements", type=pathlib.Path) + parser.add_argument("--fit", action="store_true") parser.add_argument("--sample-sizes-only", action="store_true") parser.add_argument("--write", action="store_true") arguments = parser.parse_args() arguments.directory.mkdir(parents=True, exist_ok=True) day = datetime.fromisoformat(arguments.day).replace(tzinfo=timezone.utc) + if arguments.fit: + fit(Reference(day, load_day(day, arguments.directory))) + return if arguments.elements is not None: tle = read_elements(arguments.elements, day) elif arguments.day in ELEMENTS: diff --git a/validation/catalog/validate_catalog_iasi.py b/validation/catalog/validate_catalog_iasi.py index 5a1dc0c2..b2af639b 100644 --- a/validation/catalog/validate_catalog_iasi.py +++ b/validation/catalog/validate_catalog_iasi.py @@ -77,6 +77,7 @@ RECORDS, FIXTURES, source_of, + login_earthdata, ) RECORD_PATH = RECORDS / "iasi.json" @@ -145,8 +146,7 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict: """Downloads and reduces the pixel positions of a day, or loads them from a cache.""" path = directory / f"iasi_{day:%Y%m%d}.npz" if not path.exists(): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() entries = requests.get( "https://cmr.earthdata.nasa.gov/search/granules.json", diff --git a/validation/catalog/validate_catalog_karin.py b/validation/catalog/validate_catalog_karin.py index 9d449844..ab6de516 100644 --- a/validation/catalog/validate_catalog_karin.py +++ b/validation/catalog/validate_catalog_karin.py @@ -65,6 +65,7 @@ RECORDS, FIXTURES, source_of, + login_earthdata, ) RECORD_PATH = RECORDS / "karin.json" @@ -103,8 +104,7 @@ def load_day(day: datetime, directory: pathlib.Path) -> list[dict]: """Downloads and reduces the passes that start on a day, or loads them.""" path = directory / f"swot_karin_{day:%Y%m%d}.npz" if not path.exists(): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() results = earthaccess.search_data( short_name="SWOT_L2_LR_SSH_BASIC_D", temporal=(f"{day:%Y-%m-%d}T00:00:00Z", f"{day:%Y-%m-%d}T23:59:59Z"), diff --git a/validation/catalog/validate_catalog_lsar.py b/validation/catalog/validate_catalog_lsar.py index 76edf10f..501060ac 100644 --- a/validation/catalog/validate_catalog_lsar.py +++ b/validation/catalog/validate_catalog_lsar.py @@ -82,6 +82,7 @@ FIXTURES, source_of, ELEMENT_SET_FOLDER, + login_earthdata, ) RECORD_PATH = RECORDS / "lsar.json" @@ -311,8 +312,7 @@ def load_day(day: datetime, directory: pathlib.Path) -> tuple[pd.DataFrame, list bounds_path = directory / f"lsar_bounds_{day:%Y%m%d}.csv" grids_path = directory / f"lsar_grids_{day:%Y%m%d}.npz" if not (bounds_path.exists() and grids_path.exists()): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() catalog = search(day) print(f"reading {len(catalog)} products", flush=True) diff --git a/validation/catalog/validate_catalog_modis.py b/validation/catalog/validate_catalog_modis.py index cbb63f39..17b100dd 100644 --- a/validation/catalog/validate_catalog_modis.py +++ b/validation/catalog/validate_catalog_modis.py @@ -1,27 +1,38 @@ """ Validates the MODIS catalog entry against the 1 km geolocation products of Terra and Aqua, using the exact values of the entry through public TAT-C methods. The tests of -passes and pixels follow `ValidateDriftMODIS`, whose day of Terra data the entry's -angles were fitted to, and those of sizes and spacing follow `ValidateSampleSizes`: -running on that day checks this script against the notebooks, while running on a day -at least 30 days from it tests the fitted angles on data held out from the fit. +pixels follow `ValidateDriftMODIS`, on whose day of Terra data the entry's angles were +fitted, and those of sizes and spacing follow `ValidateSampleSizes`; the tests of +passes are this script's own, following an earlier version of `ValidateDriftMODIS`. +Running on that day checks the shared tests against the notebooks, while running on a +day at least 30 days from it tests the fitted angles on data held out from the fit. The notebooks do not test the swath's width or area, which the standard requires. The observed width is the length through the frames of a scan, midway between its first and last detectors, and the observed area is the union of the cells between those -lines over one orbit. Unlike the notebook, the reference time of a pass includes the +lines over one orbit. Unlike the earlier notebook, the reference time of a pass includes the time within a scan of its frame, since MODIS sweeps the Earth in about 0.45 s. The entry is fitted on Terra. On Aqua, results are reported as a transfer to a sibling platform, under metric names that do not count toward the entry's validation. -Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: +Needs the `validation` extra and a NASA Earthdata login: + python validation/catalog/validate_catalog_modis.py 2026-10-04 --fit python validation/catalog/validate_catalog_modis.py 2026-10-04 python validation/catalog/validate_catalog_modis.py 2026-11-05 python validation/catalog/validate_catalog_modis.py 2026-11-05 \ --platform aqua +With `--fit`, it measures the angles of the entry's configurations instead, as +`ValidateDriftMODIS` did, on Terra's day of the fit: the roll and pitch of the first +and last detectors (inertial frame) at every fourth sampled frame of every 40th scan +of every sixth granule, from the reported position and velocity of the spacecraft. +The scan angle is fitted as a line in the frame, whose slope is the spacing of the +frames and whose value at the scan's center is the roll; the along-track extent is +the median difference of the detectors' pitch. It prints them, with the values derived +from them, without writing. + With `--write`, it writes the entry's validation record and, on Terra, the reduced fixture from which unit tests recompute the results. @@ -40,12 +51,18 @@ import pandas as pd import requests from scipy.spatial import cKDTree +from skyfield.api import wgs84 +from skyfield.framelib import itrs +from skyfield.positionlib import Geocentric +from skyfield.units import Distance, Velocity import tatc from tatc.catalog import get_entry from tatc.catalog.metrics import summarize from tatc.generation import generate_points_fibonacci_lattice +from tatc.constants import timescale from tatc.schemas import GeneralPerturbationsOrbit +from tatc.utils import VelocityFrame, compute_view_angles from validation_io import ( TO_GEODETIC, RemoteFile, @@ -68,6 +85,7 @@ RECORDS, FIXTURES, source_of, + login_earthdata, ) RECORD_PATH = RECORDS / "modis.json" @@ -92,7 +110,8 @@ ], } GEO = "HDFEOS/SWATHS/MODIS_Swath_Type_GEO/" -FRAMES = np.r_[np.arange(0, 1354, 8), 1353] +N_FRAMES = 1354 +FRAMES = np.r_[np.arange(0, N_FRAMES, 8), N_FRAMES - 1] N_DETECTORS = 10 FRAME_PERIOD = 0.45 / 1354 CENTER_FRAME = 676.5 @@ -139,6 +158,7 @@ def grid(name: str) -> np.ndarray: arrays = { "time": f["EV center time"][:], "position": f["orb_pos"][:], + "velocity": f["orb_vel"][:], "latitude": grid("Geolocation Fields/Latitude"), "longitude": grid("Geolocation Fields/Longitude"), "height": grid("Data Fields/Height"), @@ -155,8 +175,7 @@ def load_day(platform: str, day: datetime, directory: pathlib.Path) -> dict: product = PRODUCTS[platform] path = directory / f"{product}_{day:%Y%m%d}.npz" if not path.exists(): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() items = requests.get( "https://cmr.earthdata.nasa.gov/search/granules.umm_json", @@ -228,7 +247,7 @@ def in_cells(self, points: np.ndarray, first: int, last: int) -> np.ndarray: def observe_passes(self, points) -> pd.DataFrame: """ - Finds the passes on which MODIS observed points, as `ValidateDriftMODIS` does: + Finds the passes on which MODIS observed points, as an earlier version of `ValidateDriftMODIS` did: the nearest sampled pixel of the first detectors, excluding the outermost frames, within a distance. Gets their times, and those at the scan's center. """ @@ -505,7 +524,7 @@ def satellite_for(time_step: float): predicted, observed.drop(columns="time").rename(columns={"center_time": "time"}) ) print( - "at scan centers, as in the notebook: " + "at scan centers, as in the earlier notebook: " f"median {at_center['epoch_median']:.3f} s, p95 {at_center['epoch_p95']:.3f} s", flush=True, ) @@ -570,12 +589,82 @@ def satellite_for(time_step: float): ) +def fit(platform: str, day: datetime, directory: pathlib.Path) -> None: + """ + Prints the scan angles and along-track extent of the detectors, measured from the + reduced granules of a day as `ValidateDriftMODIS` measured them. + """ + paths = sorted((directory / f"{PRODUCTS[platform]}_{day:%Y%m%d}").glob("*.npz")) + rows = [] + for path in paths[::6]: + with np.load(path) as granule: + if "velocity" not in granule.files: + raise SystemExit( + f"{path} has no velocity: remove the day's reduced granules and " + "download them again" + ) + position = granule["position"].astype(float) + valid = np.all(np.isfinite(position), axis=1) & ( + np.linalg.norm(position, axis=1) > 6e6 + ) + for scan in np.nonzero(valid)[0][5::40]: + # the reported position and velocity at the scan's time, as a track + track = Geocentric.from_time_and_frame_vectors( + timescale.tai(1993, 1, 1, 0, 0, 27 + float(granule["time"][scan])), + itrs, + Distance(m=position[scan]), + Velocity(km_per_s=granule["velocity"][scan].astype(float) / 1e3), + ) + for column in range(0, len(FRAMES), 4): + (roll_1, pitch_1), (roll_10, pitch_10) = ( + compute_view_angles( + track, + wgs84.latlon( + *( + float(granule[k][scan, detector, column]) + for k in ("latitude", "longitude", "height") + ) + ), + velocity_frame=VelocityFrame.INERTIAL, + ) + for detector in (0, 1) + ) + rows.append( + (FRAMES[column], (roll_1 + roll_10) / 2, pitch_10 - pitch_1) + ) + frame, roll, extent = np.array(rows, dtype=float).T + finite = np.isfinite(roll) & np.isfinite(extent) + frame, roll, extent = frame[finite], roll[finite], extent[finite] + spacing, offset = np.polyfit(frame - CENTER_FRAME, roll, 1) + residual = roll - (spacing * (frame - CENTER_FRAME) + offset) + detectors = float(np.median(extent)) + print( + f"{len(paths[::6])} of {len(paths)} granules, {len(roll)} samples; scan angle = " + f"{spacing:.5f} deg x (frame - {CENTER_FRAME}) {offset:+.3f} deg, residual " + f"95th percentile {np.percentile(np.abs(residual), 95):.3f} deg" + ) + print( + f"scan angles {spacing * -CENTER_FRAME + offset:.2f} to " + f"{spacing * CENTER_FRAME + offset:.2f} deg" + ) + print( + f"swath: field_of_regard {(N_FRAMES - 1) * round(spacing, 5):.3f} " + f"({N_FRAMES - 1} frame spacings); pixels: cross_track_field_of_view " + f"{N_FRAMES * round(spacing, 5):.3f}, roll_angle {offset:.3f}" + ) + print( + f"along-track extent of detectors 1 to 10: {detectors:.4f} deg; " + f"along_track_field_of_view {round(detectors, 4) * N_DETECTORS / (N_DETECTORS - 1):.4f}" + ) + + def main() -> None: """Validates the entry on a day of data.""" parser = argparse.ArgumentParser(description=__doc__) parser.add_argument("directory", type=pathlib.Path) parser.add_argument("day") parser.add_argument("--platform", choices=sorted(PRODUCTS), default=FIT_PLATFORM) + parser.add_argument("--fit", action="store_true") parser.add_argument("--sample-sizes-only", action="store_true") parser.add_argument("--download-only", action="store_true") parser.add_argument("--write", action="store_true") @@ -583,6 +672,10 @@ def main() -> None: arguments.directory.mkdir(parents=True, exist_ok=True) day = datetime.fromisoformat(arguments.day).replace(tzinfo=timezone.utc) + if arguments.fit: + load_day(arguments.platform, day, arguments.directory) + fit(arguments.platform, day, arguments.directory) + return tle = ELEMENT_SETS[(arguments.platform, arguments.day)] orbit = GeneralPerturbationsOrbit.from_tle(tle) entry = get_entry("modis") diff --git a/validation/catalog/validate_catalog_oci.py b/validation/catalog/validate_catalog_oci.py index 0e2ae02d..5e2bcf2e 100644 --- a/validation/catalog/validate_catalog_oci.py +++ b/validation/catalog/validate_catalog_oci.py @@ -55,6 +55,7 @@ RECORDS, FIXTURES, source_of, + login_earthdata, ) # the angles are fitted to 2026-10-04, and the schedule of the tilt's change to @@ -310,8 +311,7 @@ def fit_blind(days: list[datetime]) -> None: no valid scans, over days, at full resolution: from the end of the last valid scan (its start plus a scan period) to the start of the first. """ - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() changes = [] for day in days: @@ -357,8 +357,7 @@ def fit_switches(first: datetime, last: datetime, directory: pathlib.Path) -> No subsolar latitude at noon (UTC) of each day, by the parity of the day of the year, over a period of days, and the changes far from their day's median. """ - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() rows = [] for i in range((last - first).days + 1): diff --git a/validation/catalog/validate_catalog_poseidon4.py b/validation/catalog/validate_catalog_poseidon4.py index e77a2874..c879a2cb 100644 --- a/validation/catalog/validate_catalog_poseidon4.py +++ b/validation/catalog/validate_catalog_poseidon4.py @@ -49,6 +49,7 @@ RECORDS, FIXTURES, source_of, + login_earthdata, ) RECORD_PATH = RECORDS / "poseidon4.json" @@ -115,8 +116,7 @@ def load_day(day: datetime, directory: pathlib.Path, platform: str) -> pd.DataFr ) for item in items ] - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() with concurrent.futures.ThreadPoolExecutor(4) as pool: parts = list(pool.map(lambda url: read_granule(url, session), urls)) diff --git a/validation/catalog/validate_catalog_smap.py b/validation/catalog/validate_catalog_smap.py index f32a1afc..5925813a 100644 --- a/validation/catalog/validate_catalog_smap.py +++ b/validation/catalog/validate_catalog_smap.py @@ -13,14 +13,21 @@ 90 deg to either side. * The swath area over an orbit is compared with the union of the cells of both halves. -The cone angle was derived in `ValidateGridSMAP` from the incidence angles of a day of -data, so running on a day at least 30 days from it tests it on data held out from it. +The cone angle is derived from the incidence angles of a day of data, so running on +a day at least 30 days from it tests it on data held out from it. -Needs the `validation` extra and an Earthdata token in `EARTHDATA_TOKEN`: +Needs the `validation` extra and a NASA Earthdata login: + python validation/catalog/validate_catalog_smap.py 2026-10-24 --fit python validation/catalog/validate_catalog_smap.py 2026-10-24 python validation/catalog/validate_catalog_smap.py 2026-09-20 +With `--fit`, it derives the cone angle instead, as `ValidateGridSMAP` did, from the +gridded brightness temperatures of the day (`SPL1CTB`, the half orbits from two hours +before the day to two hours after it): the angle from nadir of a boresight at the +median incidence angle of the forward looks, at the mean altitude of the day's element +set, on a spherical Earth. It prints it, without writing. + With `--write`, it writes the entry's validation record and the reduced fixture from which unit tests recompute the results. @@ -70,6 +77,7 @@ FIXTURES, source_of, ELEMENT_SET_FOLDER, + login_earthdata, ) RECORD_PATH = RECORDS / "smap_radiometer.json" @@ -111,6 +119,10 @@ FIXTURE_SPACING_SAMPLES = 150 +# the mean radius (m) of the spherical Earth on which the cone angle is derived +FIT_EARTH_RADIUS = 6371.0088e3 + + def get_element_set(day: datetime) -> list[str]: """Gets the element set of a day.""" key = f"{day:%Y-%m-%d}" @@ -134,8 +146,7 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: """Downloads and reduces the half orbits that overlap a day, or loads them.""" path = directory / f"smap_l1b_{day:%Y%m%d}.npz" if not path.exists(): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() granules = earthaccess.search_data( short_name="SPL1BTB", temporal=( @@ -624,17 +635,76 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non ) +def load_fit_incidence(day: datetime, directory: pathlib.Path) -> np.ndarray: + """ + Downloads the incidence angles (deg) of the forward looks of the gridded brightness + temperatures of the half orbits around a day, or loads them from a cache. + """ + path = directory / f"smap_l1c_incidence_{day:%Y%m%d}.npy" + if not path.exists(): + login_earthdata() + granules = earthaccess.search_data( + short_name="SPL1CTB", + temporal=( + f"{day - timedelta(hours=2):%Y-%m-%dT%H:%M:%S}", + f"{day + timedelta(hours=26):%Y-%m-%dT%H:%M:%S}", + ), + ) + # the latest version of each half orbit + latest = {} + for granule in sorted(granules, key=lambda g: g["umm"]["GranuleUR"]): + name = granule["umm"]["GranuleUR"] + latest[re.search(r"_TB_(\d+_[AD])_", name).group(1)] = granule + files = earthaccess.download( + list(latest.values()), str(directory / f"raw_l1c_{day:%Y%m%d}") + ) + parts = [] + for file in sorted(files): + with h5py.File(file) as f: + parts.append(f["Global_Projection/cell_boresight_incidence_fore"][:]) + pathlib.Path(file).unlink() + np.save(path, np.concatenate(parts)) + return np.load(path) + + +def fit(day: datetime, directory: pathlib.Path) -> None: + """ + Prints the cone angle of a boresight at the median incidence angle of a day's + forward looks, at the mean altitude of its element set, on a spherical Earth. + """ + incidence = float(np.nanmedian(load_fit_incidence(day, directory))) + altitude = GeneralPerturbationsOrbit.from_tle( + get_element_set(day) + ).get_mean_altitude() + cone = np.degrees( + np.arcsin( + FIT_EARTH_RADIUS + * np.sin(np.radians(incidence)) + / (FIT_EARTH_RADIUS + altitude) + ) + ) + print( + f"median incidence angle {incidence:.2f} deg, mean altitude " + f"{altitude / 1e3:.1f} km" + ) + print(f"cone_angle: {cone:.3f}") + + def main() -> None: """Validates the entry on a day of data.""" parser = argparse.ArgumentParser(description=__doc__) parser.add_argument("directory", type=pathlib.Path) parser.add_argument("day") + parser.add_argument("--fit", action="store_true") parser.add_argument("--write", action="store_true") parser.add_argument("--download-only", action="store_true") parser.add_argument("--sample-sizes-only", action="store_true") arguments = parser.parse_args() arguments.directory.mkdir(parents=True, exist_ok=True) day = datetime.fromisoformat(arguments.day).replace(tzinfo=timezone.utc) + if arguments.fit: + fit(day, arguments.directory) + return data = load_day(day, arguments.directory) if arguments.download_only: return diff --git a/validation/catalog/validate_catalog_spexone.py b/validation/catalog/validate_catalog_spexone.py index dc1cb44a..736ba2f0 100644 --- a/validation/catalog/validate_catalog_spexone.py +++ b/validation/catalog/validate_catalog_spexone.py @@ -52,6 +52,7 @@ RECORDS, FIXTURES, source_of, + login_earthdata, ) FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) @@ -133,8 +134,7 @@ def load_navigation(day: datetime, directory: pathlib.Path): """Reads the spacecraft positions of a day, or loads them from a cache.""" cache = directory / f"spexone_navigation_{day:%Y%m%d}.npz" if not cache.exists(): - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() with concurrent.futures.ThreadPoolExecutor(4) as pool: parts = list( diff --git a/validation/catalog/validate_catalog_tempo.py b/validation/catalog/validate_catalog_tempo.py index c40d0508..7fa80061 100644 --- a/validation/catalog/validate_catalog_tempo.py +++ b/validation/catalog/validate_catalog_tempo.py @@ -59,6 +59,7 @@ RECORDS, FIXTURES, source_of, + login_earthdata, ) RECORD_PATH = RECORDS / "tempo.json" @@ -154,8 +155,7 @@ def load_scan(day: datetime, directory: pathlib.Path) -> dict: cache = directory / f"tempo_{day:%Y%m%d}.npz" if not cache.exists(): urls = find_scan(day) - if earthaccess.login(strategy="environment") is None: - raise RuntimeError("Earthdata login failed: is EARTHDATA_TOKEN set?") + login_earthdata() session = earthaccess.get_requests_https_session() with concurrent.futures.ThreadPoolExecutor(GRANULES) as pool: parts = list( diff --git a/validation/catalog/validate_catalog_viirs.py b/validation/catalog/validate_catalog_viirs.py index ea9c1317..e11d6aa1 100644 --- a/validation/catalog/validate_catalog_viirs.py +++ b/validation/catalog/validate_catalog_viirs.py @@ -1,10 +1,12 @@ """ Validates the VIIRS catalog entry against the NOAA-20 VIIRS moderate-resolution geolocation product, using the exact values of the entry through public TAT-C -methods. The tests follow `ValidateImagerVIIRS`, whose day of data the entry's angles -were fitted to, and `ValidateSampleSizes`: running on that day checks this script -against the notebooks, while running on a day at least 30 days from it tests the -fitted angles on data held out from the fit. +methods. The tests of pixels and swath width follow `ValidateImagerVIIRS`, on whose +day of data the entry's angles were fitted, and those of sizes and spacing follow +`ValidateSampleSizes`; the tests of passes, epochs, and swath area are this script's +own. Running on that day checks the shared tests against the notebooks, while running +on a day at least 30 days from it tests the fitted angles on data held out from the +fit. The notebooks do not test the swath's area, which the standard requires. The observed area over one orbit is the union of the outlines (G-rings) of the granules and of the diff --git a/validation/catalog/validation_io.py b/validation/catalog/validation_io.py index 59085a47..bfea86af 100644 --- a/validation/catalog/validation_io.py +++ b/validation/catalog/validation_io.py @@ -31,7 +31,7 @@ ) from tatc.catalog import STANDARD_VERSION from tatc.catalog.metrics import compute_mask_iou, compute_pass_scores, summarize -from tatc.constants import timescale +from tatc.constants import EARTH_ROTATION_RATE, timescale from tatc.schemas import CircularOrbit, Point from tatc.utils import VelocityFrame, compute_projected_ray_position @@ -59,6 +59,27 @@ _SESSION = requests.Session() +def login_earthdata(): + """ + Logs in to NASA Earthdata with a token in `EARTHDATA_TOKEN` (or a username and + password in `EARTHDATA_USERNAME` and `EARTHDATA_PASSWORD`), or else with the + credentials of urs.earthdata.nasa.gov in `~/.netrc`. + """ + import earthaccess # pylint: disable=import-outside-toplevel + + for strategy in ("environment", "netrc"): + try: + auth = earthaccess.login(strategy=strategy) + except Exception: # pylint: disable=broad-exception-caught + continue + if auth is not None and auth.authenticated: + return auth + raise RuntimeError( + "Earthdata login failed: set EARTHDATA_TOKEN, or add urs.earthdata.nasa.gov " + "to ~/.netrc" + ) + + def source_of(script): """ The path of a script relative to the repository, as validation records @@ -273,6 +294,64 @@ def normalize(x: np.ndarray) -> np.ndarray: return x / np.linalg.norm(x, axis=-1, keepdims=True) +def inertial_velocity(position: np.ndarray, velocity: np.ndarray) -> np.ndarray: + """Gets the inertial velocity (m/s) of Earth-fixed positions and velocities.""" + return velocity + EARTH_ROTATION_RATE * np.stack( + [-position[..., 1], position[..., 0], np.zeros(position.shape[:-1])], axis=-1 + ) + + +def fit_cone(position, velocity, lon, lat) -> dict[str, float]: + """ + Measures the cone of a conical scanner from the Earth-fixed positions (m) and + velocities (m/s) of its scans and the geodetic positions of their footprints + (scans by samples): the median angle of the lines of sight from geodetic nadir, + and the scan azimuths (deg, positive to the left) of the first and last samples + from the horizontal direction of the inertial velocity, with the center and half + width of the sector they span (medians over scans), and the median azimuth step + between samples. The center from the Earth-fixed velocity is also given, for + comparison. + """ + lines = normalize(ecef(lon, lat) - position[:, np.newaxis]) + sub_lon, sub_lat, _ = TO_GEODETIC.transform(*position.T) + nadir = -up(sub_lon, sub_lat) + horizontal = ( + lines + - np.sum(lines * nadir[:, np.newaxis], axis=-1, keepdims=True) + * nadir[:, np.newaxis] + ) + + def azimuth(v): + forward = normalize(v - np.sum(v * nadir, axis=-1, keepdims=True) * nadir) + left = np.cross(forward, nadir) + return np.degrees( + np.arctan2( + np.sum(horizontal * left[:, np.newaxis], axis=-1), + np.sum(horizontal * forward[:, np.newaxis], axis=-1), + ) + ) + + inertial = azimuth(inertial_velocity(position, velocity)) + earth = azimuth(velocity) + return { + "cone_angle": float( + np.median( + np.degrees(np.arccos(np.sum(lines * nadir[:, np.newaxis], axis=-1))) + ) + ), + "first_azimuth": float(np.median(inertial[:, 0])), + "last_azimuth": float(np.median(inertial[:, -1])), + "scan_center_azimuth": float(np.median(inertial[:, -1] + inertial[:, 0]) / 2), + "scan_half_width": float( + np.median(np.abs(inertial[:, -1] - inertial[:, 0])) / 2 + ), + "scan_sample_spacing": float(np.median(np.diff(inertial, axis=1))), + "scan_center_azimuth_earth_fixed": float( + np.median(earth[:, -1] + earth[:, 0]) / 2 + ), + } + + def in_lattice_cells(cells, is_next_contiguous, points, neighbors=2) -> np.ndarray: """ Gets whether unit vectors lie in the cells of a lattice of unit vectors, with rows From 7c736e76b10ddf9b060f34421d36a81b62f3fe8b Mon Sep 17 00:00:00 2001 From: Paul Grogan Date: Sun, 15 Nov 2026 08:49:48 -0700 Subject: [PATCH 3/8] review the instrument catalog: select configurations by platform and grade, compute the holdout gap from the periods of fitting and test data, record transfers apart and the standard version of each configuration, check record platforms and class versions, build payloads of several entries (also in build_constellation, with start and end for tilt schedules), give the analysis index of unions, rename attitude_schedule to tilt_schedule, move the subsolar latitude to utils, default the provenance of tailored and swept views, keep the gates in one table, trim the exports, write records through the schema, pass JPSS archives explicitly, deduplicate the conical scripts, and test the status of entries from one table --- CHANGELOG.md | 6 +- docs/api_reference/catalog.rst | 34 +- docs/api_reference/utils/index.rst | 4 + docs/examples/UseInstrumentCatalog.ipynb | 408 +++--- docs/examples/osse/RunOSSEHurricane.ipynb | 4 +- docs/examples/osse/RunOSSEMonsoon.ipynb | 4 +- docs/validation/catalog_page.py | 77 +- docs/validation/standard.rst | 19 +- src/tatc/catalog/__init__.py | 43 +- src/tatc/catalog/loader.py | 87 +- src/tatc/catalog/schemas.py | 577 +++++--- src/tatc/catalog/standard.py | 108 +- src/tatc/resources/instruments/ahi.yml | 2 +- src/tatc/resources/instruments/airs.yml | 4 - src/tatc/resources/instruments/amsr2.yml | 9 +- src/tatc/resources/instruments/amsua.yml | 4 - src/tatc/resources/instruments/ascat.yml | 10 +- src/tatc/resources/instruments/atlas.yml | 10 +- src/tatc/resources/instruments/atlid.yml | 6 +- src/tatc/resources/instruments/atms.yml | 20 +- src/tatc/resources/instruments/avhrr.yml | 10 +- src/tatc/resources/instruments/bbr.yml | 6 +- src/tatc/resources/instruments/ceres.yml | 6 +- src/tatc/resources/instruments/cpr.yml | 4 - src/tatc/resources/instruments/cris.yml | 14 +- src/tatc/resources/instruments/csar.yml | 16 +- src/tatc/resources/instruments/dpr.yml | 12 +- .../resources/instruments/earthcare_msi.yml | 6 +- src/tatc/resources/instruments/ecostress.yml | 6 +- src/tatc/resources/instruments/emit.yml | 6 +- src/tatc/resources/instruments/gedi.yml | 20 +- src/tatc/resources/instruments/gmi.yml | 8 +- src/tatc/resources/instruments/harp2.yml | 8 +- src/tatc/resources/instruments/iasi.yml | 10 +- src/tatc/resources/instruments/karin.yml | 10 +- src/tatc/resources/instruments/lsar.yml | 24 +- src/tatc/resources/instruments/mhs.yml | 4 - src/tatc/resources/instruments/modis.yml | 12 +- src/tatc/resources/instruments/msi.yml | 6 +- src/tatc/resources/instruments/oci.yml | 18 +- src/tatc/resources/instruments/oco2.yml | 12 +- src/tatc/resources/instruments/olci.yml | 6 +- src/tatc/resources/instruments/oli.yml | 6 +- src/tatc/resources/instruments/omps_nm.yml | 12 +- src/tatc/resources/instruments/poseidon4.yml | 4 - .../resources/instruments/smap_radiometer.yml | 10 +- src/tatc/resources/instruments/spexone.yml | 6 +- src/tatc/resources/instruments/ssmis.yml | 5 +- src/tatc/resources/instruments/tempo.yml | 2 +- src/tatc/resources/instruments/tmi.yml | 10 +- src/tatc/resources/instruments/trmm_pr.yml | 12 +- src/tatc/resources/instruments/tropomi.yml | 24 +- src/tatc/resources/instruments/viirs.yml | 18 +- src/tatc/resources/instruments/virs.yml | 12 +- src/tatc/resources/validation/abi.json | 34 +- src/tatc/resources/validation/ahi.json | 24 +- src/tatc/resources/validation/airs.json | 19 +- src/tatc/resources/validation/amsr2.json | 19 +- src/tatc/resources/validation/amsua.json | 19 +- src/tatc/resources/validation/ascat.json | 11 +- src/tatc/resources/validation/atlas.json | 11 +- src/tatc/resources/validation/atlid.json | 11 +- src/tatc/resources/validation/atms.json | 128 +- src/tatc/resources/validation/avhrr.json | 112 +- src/tatc/resources/validation/bbr.json | 11 +- src/tatc/resources/validation/ceres.json | 11 +- src/tatc/resources/validation/cpr.json | 11 +- src/tatc/resources/validation/cris.json | 94 +- src/tatc/resources/validation/csar.json | 229 ++- src/tatc/resources/validation/dpr.json | 19 +- .../resources/validation/earthcare_msi.json | 11 +- src/tatc/resources/validation/ecostress.json | 11 +- src/tatc/resources/validation/emit.json | 11 +- src/tatc/resources/validation/gedi.json | 11 +- src/tatc/resources/validation/gmi.json | 17 +- src/tatc/resources/validation/harp2.json | 11 +- src/tatc/resources/validation/iasi.json | 19 +- src/tatc/resources/validation/karin.json | 11 +- src/tatc/resources/validation/lsar.json | 27 +- src/tatc/resources/validation/mhs.json | 112 +- src/tatc/resources/validation/modis.json | 112 +- src/tatc/resources/validation/msi.json | 13 +- src/tatc/resources/validation/oci.json | 11 +- src/tatc/resources/validation/oco2.json | 19 +- src/tatc/resources/validation/olci.json | 11 +- src/tatc/resources/validation/oli.json | 80 +- src/tatc/resources/validation/omps_nm.json | 19 +- src/tatc/resources/validation/poseidon4.json | 43 +- .../resources/validation/smap_radiometer.json | 19 +- src/tatc/resources/validation/spexone.json | 11 +- src/tatc/resources/validation/ssmis.json | 11 +- src/tatc/resources/validation/tempo.json | 9 +- src/tatc/resources/validation/tmi.json | 19 +- src/tatc/resources/validation/trmm_pr.json | 19 +- src/tatc/resources/validation/tropomi.json | 11 +- src/tatc/resources/validation/viirs.json | 120 +- src/tatc/resources/validation/virs.json | 19 +- src/tatc/tradespace/constellations.py | 66 +- src/tatc/utils/__init__.py | 9 +- src/tatc/utils/glint.py | 25 +- src/tatc/utils/orbital.py | 32 + tests/catalog/test_abi_fixture.py | 7 +- tests/catalog/test_amsr2_fixture.py | 5 +- tests/catalog/test_atlas_fixture.py | 10 +- tests/catalog/test_catalog_page.py | 3 +- tests/catalog/test_entries.py | 1255 ++++++++--------- tests/catalog/test_gmi_fixture.py | 5 +- tests/catalog/test_pushbroom_fixtures.py | 2 +- tests/catalog/test_scanner_fixtures.py | 9 +- tests/catalog/test_smap_fixture.py | 5 +- tests/catalog/test_standard.py | 159 ++- tests/catalog/test_tilt_schedule.py | 18 +- tests/catalog/test_tmi_fixture.py | 5 +- tests/tradespace/test_constellations.py | 21 +- .../catalog/compare_swath_time_steps.py | 8 +- validation/catalog/earthcare_io.py | 49 +- validation/catalog/gesdisc_scanner.py | 105 +- validation/catalog/validate_catalog_abi.py | 24 +- validation/catalog/validate_catalog_ahi.py | 26 +- validation/catalog/validate_catalog_airs.py | 2 - validation/catalog/validate_catalog_amsr2.py | 110 +- validation/catalog/validate_catalog_amsua.py | 2 - validation/catalog/validate_catalog_ascat.py | 27 +- validation/catalog/validate_catalog_atlas.py | 53 +- validation/catalog/validate_catalog_atlid.py | 2 - validation/catalog/validate_catalog_atms.py | 143 +- validation/catalog/validate_catalog_avhrr.py | 2 - validation/catalog/validate_catalog_bbr.py | 31 +- validation/catalog/validate_catalog_ceres.py | 8 +- validation/catalog/validate_catalog_cpr.py | 2 - validation/catalog/validate_catalog_cris.py | 140 +- validation/catalog/validate_catalog_csar.py | 40 +- validation/catalog/validate_catalog_dpr.py | 2 - .../catalog/validate_catalog_earthcare_msi.py | 2 - .../catalog/validate_catalog_ecostress.py | 2 - validation/catalog/validate_catalog_emit.py | 49 +- validation/catalog/validate_catalog_gedi.py | 55 +- validation/catalog/validate_catalog_gmi.py | 115 +- validation/catalog/validate_catalog_harp2.py | 2 - validation/catalog/validate_catalog_iasi.py | 83 +- validation/catalog/validate_catalog_karin.py | 27 +- validation/catalog/validate_catalog_lsar.py | 38 +- validation/catalog/validate_catalog_mhs.py | 2 - validation/catalog/validate_catalog_modis.py | 91 +- validation/catalog/validate_catalog_msi.py | 35 +- validation/catalog/validate_catalog_oci.py | 11 +- validation/catalog/validate_catalog_oco2.py | 53 +- validation/catalog/validate_catalog_olci.py | 2 - validation/catalog/validate_catalog_oli.py | 42 +- validation/catalog/validate_catalog_omps.py | 45 +- .../catalog/validate_catalog_poseidon4.py | 47 +- validation/catalog/validate_catalog_smap.py | 77 +- .../catalog/validate_catalog_spexone.py | 2 - validation/catalog/validate_catalog_ssmis.py | 47 +- validation/catalog/validate_catalog_tempo.py | 64 +- validation/catalog/validate_catalog_tmi.py | 66 +- .../catalog/validate_catalog_trmm_pr.py | 2 - .../catalog/validate_catalog_tropomi.py | 33 +- validation/catalog/validate_catalog_viirs.py | 158 +-- validation/catalog/validate_catalog_virs.py | 3 +- validation/catalog/validation_io.py | 190 ++- 161 files changed, 3611 insertions(+), 3475 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 465ee204..b098913c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,8 +5,8 @@ Added a catalog of instruments from past and present missions, with a standard for validating them. Fixed instruments losing their fields when serialized. Instruments now reject unknown fields, which can break code that passes misspelled or unused arguments. Added: - - Module `catalog` of instruments from past and present missions (`get_entry`, `list_entries`), starting with GOES-R ABI, GPM GMI, GCOM-W AMSR2, ATMS, CrIS, VIIRS, MODIS, Landsat OLI, Sentinel-2 MSI, Sentinel-1 C-SAR, NISAR L-SAR, SWOT KaRIn, the SMAP radiometer, IASI, Sentinel-5P TROPOMI, GPM DPR, MHS, ICESat-2 ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, Sentinel-3 OLCI, PACE OCI, HARP2, and SPEXone, the OMPS Nadir Mapper, Himawari AHI, CERES, ECOSTRESS, OCO-2, the Sentinel-6 Poseidon-4 altimeter, Metop ASCAT, TEMPO, GEDI, EMIT, EarthCARE ATLID, BBR, CPR, and MSI, and TRMM PR, TMI, and VIRS. `InstrumentEntry.to_satellite` and `build` give an entry's instruments with the attitude they were validated with, and `InstrumentEntry.validation` gives its validation tier, computed from its results and the thresholds of the validation standard (`docs/validation/standard.rst`). GMI, ATMS, VIIRS, MODIS, OLI, MSI, KaRIn, TROPOMI, DPR, MHS, HARP2, SPEXone, Poseidon-4, ASCAT, TEMPO, TMI, VIRS, and EarthCARE's MSI are `validated`, each with stated limitations, and ABI, AMSR2, CrIS, C-SAR, L-SAR, the SMAP radiometer, IASI, ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, OLCI, OCI, OMPS, AHI, CERES, ECOSTRESS, OCO-2, GEDI, EMIT, ATLID, BBR, CPR, and TRMM PR are `partial` and list their gaps. Results on sibling satellites (NOAA-21, Metop-B, Sentinel-1D, Sentinel-6B) are recorded as transfers, which warn on use and do not count toward a tier; ATMS and VIIRS also have configurations fitted on NOAA-21, validated on held-out data, as NOAA-20's angles did not transfer. In an entry with configurations fitted on more than one platform (ATMS, VIIRS, and the OMPS Nadir Mapper), each configuration's name ends with its platform (`swath_noaa_20`, `swath_noaa_21`). Version 2 of the standard adds a lidar class, for ATLAS, version 3 an altimeter class, for Poseidon-4, version 4 a scatterometer class, for ASCAT, with the gates of the SAR class, version 5 a regional geostationary class, for TEMPO, whose gate is the intersection over union of the field of regard with the area a scan images, and version 6 a profiler class, for ATLID and CPR, with the gates of the altimeter class; none changes a threshold of an earlier version. Every pointed configuration with a view tailored to the time step is swept (`is_swept`), so its swaths do not depend on the time step; its records were rescored with swept swaths on the same held-out data, and MSI, TROPOMI, DPR, OCI's swath, and C-SAR's EW mode, whose tiers changed, were tested again on a later held-out day, with the rescored results stated in their limitations. The documentation lists the entries and their results on a page written from the catalog (`docs/validation/catalog_page.py`), and the example `UseInstrumentCatalog` shows their use. The OSSE examples `RunOSSEMonsoon` and `RunOSSEHurricane` take their ATMS and CrIS swaths from the catalog. The scripts that validate the entries and write their records are in `validation/catalog` of the repository, with the element sets they read. Each script of an entry with fitted values measures them with `--fit`, including those of CrIS, AMSR2, GMI, MODIS, and the SMAP radiometer, which their validation notebooks previously measured. - - Class `catalog.TiltSchedule` and field `attitude_schedule` of catalog configurations, for an attitude that changes by day, as PACE's tilt does: `build` and `to_satellite` take the `start` and `end` of the analysis and give an `AttitudeSchedule` with an attitude for each day (UTC), blind while the tilt changes. Function `catalog.get_subsolar_latitude` gives the latitude of the subsolar point. + - Module `catalog` of instruments from past and present missions (`get_entry`, `list_entries`, with the schemas of entries and records in `catalog.schemas` and the standard in `catalog.standard`), starting with GOES-R ABI, GPM GMI, GCOM-W AMSR2, ATMS, CrIS, VIIRS, MODIS, Landsat OLI, Sentinel-2 MSI, Sentinel-1 C-SAR, NISAR L-SAR, SWOT KaRIn, the SMAP radiometer, IASI, Sentinel-5P TROPOMI, GPM DPR, MHS, ICESat-2 ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, Sentinel-3 OLCI, PACE OCI, HARP2, and SPEXone, the OMPS Nadir Mapper, Himawari AHI, CERES, ECOSTRESS, OCO-2, the Sentinel-6 Poseidon-4 altimeter, Metop ASCAT, TEMPO, GEDI, EMIT, EarthCARE ATLID, BBR, CPR, and MSI, and TRMM PR, TMI, and VIRS. `InstrumentEntry.to_satellite` and `build` give an entry's instruments with the attitude they were validated with, and the `instrument_index` to analyze them with (`None` for the parts of one view); the platform modeled (`platform`) selects the configuration tested on it, and a grade (`grade`) one for its use (`select_configuration`). `catalog.build_payload` gives the instruments of several configurations (such as `"atms:swath_noaa_20"`) carried together, which must share an attitude. `InstrumentEntry.validation` gives its validation tier, computed from its results and the thresholds of the validation standard (`docs/validation/standard.rst`): each configuration's record states the version of the standard of its test, and the gap between the data of its fitted values and of its test (`holdout_gap_days`) is computed from the periods of each, which provenance and records state. GMI, ATMS, VIIRS, MODIS, OLI, MSI, KaRIn, TROPOMI, DPR, MHS, HARP2, SPEXone, Poseidon-4, ASCAT, TEMPO, TMI, VIRS, and EarthCARE's MSI are `validated`, each with stated limitations, and ABI, AMSR2, CrIS, C-SAR, L-SAR, the SMAP radiometer, IASI, ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, OLCI, OCI, OMPS, AHI, CERES, ECOSTRESS, OCO-2, GEDI, EMIT, ATLID, BBR, CPR, and TRMM PR are `partial` and list their gaps. Results on sibling satellites (NOAA-21, Metop-B, Aqua, Landsat 8, Sentinel-1D, Sentinel-6B) are recorded as transfers (`ConfigurationRecord.transfers`), which warn on use and do not count toward a tier; ATMS and VIIRS also have configurations fitted on NOAA-21, validated on held-out data, as NOAA-20's angles did not transfer. In an entry with configurations fitted on more than one platform (ATMS, VIIRS, and the OMPS Nadir Mapper), each configuration's name ends with its platform (`swath_noaa_20`, `swath_noaa_21`). Version 2 of the standard adds a lidar class, for ATLAS, version 3 an altimeter class, for Poseidon-4, version 4 a scatterometer class, for ASCAT, with the gates of the SAR class, version 5 a regional geostationary class, for TEMPO, whose gate is the intersection over union of the field of regard with the area a scan images, and version 6 a profiler class, for ATLID and CPR, with the gates of the altimeter class; none changes a threshold of an earlier version. Every pointed configuration with a view tailored to the time step is swept (`is_swept`), so its swaths do not depend on the time step; its records were rescored with swept swaths on the same held-out data, and MSI, TROPOMI, DPR, OCI's swath, and C-SAR's EW mode, whose tiers changed, were tested again on a later held-out day, with the rescored results stated in their limitations. The documentation lists the entries and their results on a page written from the catalog (`docs/validation/catalog_page.py`), and the example `UseInstrumentCatalog` shows their use. The OSSE examples `RunOSSEMonsoon` and `RunOSSEHurricane` take their ATMS and CrIS swaths from the catalog. The scripts that validate the entries and write their records are in `validation/catalog` of the repository, with the element sets they read. Each script of an entry with fitted values measures them with `--fit`, including those of CrIS, AMSR2, GMI, MODIS, and the SMAP radiometer, which their validation notebooks previously measured. + - Class `catalog.schemas.TiltSchedule` and field `tilt_schedule` of catalog configurations, for an attitude that changes by day, as PACE's tilt does: `build` and `to_satellite` take the `start` and `end` of the analysis and give an `AttitudeSchedule` with an attitude for each day (UTC), blind while the tilt changes. Utility methods `compute_subsolar_latitude` and `compute_ascending_argument_of_latitude`. - Field `type` of a catalog configuration's `attitude` (`attitude`, `glint`, or `target`), which builds an `Attitude`, `GlintAttitude`, or `TargetAttitude`, as for OCO-2's glint mode. - Field `blind_intervals` of `Attitude`: intervals of argument of latitude in which a space system's instruments do not observe, for example while the body or a mechanism moves. Observations in them are not valid, so point observations, ground tracks (`valid_obs`, and the swaths of `compute_ground_track`), orbit tracks, and ground pixels omit them, and the periods and swaths of region observations end at them. Method `is_observing` of attitudes, schedules, and instruments. - Field `is_swept` of `PointedInstrument`, for an instrument whose view sweeps along track: its footprint over a time step is the strip its cross-track line (the directions at an along-track angle of zero, which `collect_observations` checks) sweeps between the step's bounds, trimmed to blind intervals, so that ground track swaths (`compute_ground_track`) and region swaths do not depend on the time step, while its along-track field of view still sets the instantaneous view. Method `PointedInstrument.compute_swept_footprints`, utility method `compute_swept_footprints`, argument `time_step` of `collect_ground_track` and `compute_ground_track` (the span of each footprint, by default half the gap to the neighboring times on each side), and runtime configuration `swept_footprint_max_substep`. The default, `False`, leaves footprints unchanged. @@ -19,7 +19,7 @@ Added: - Criteria by which designs are judged (`tradespace.Criteria`): objectives to minimize or maximize, requirements (`Requirement`, output constraints that designs meet or violate once evaluated, by an amount relative to the required value or a `scale`), the statistics over replicates that they name (`Mean`, `StandardDeviation`, `Minimum`, `Maximum`, `Quantile`, and `Probability`, the share of replicates that meet a threshold; other names are means of metrics), tolerances of objectives, and the columns that group the records of an evaluation (`by`, such as a sensor), whose designs are judged separately. `summarize` gives statistics of each design (and, with criteria, the violations of their requirements), with the standard deviations and standard errors of means. `pareto_front`, `pareto_ranks` (which ranks designs that miss requirements after those that meet them), `hypervolume`, `pareto_probability` (which also gives the probability of meeting the requirements), `refine`, `confirm`, `screen`, `optimize_optuna` (a constraint of each trial for each requirement), and `optimize_pymoo` (a constraint for each requirement) take criteria, or a mapping of objectives to their directions. Results with several records of an evaluation that `by` does not separate raise an error. - Function `tradespace.refine` (and class `Refinement`), which adds replicates only to the designs whose Pareto efficiency is uncertain, until it is settled, optionally with a tolerance of differences that do not matter (also of `pareto_probability`), and within a `budget` of evaluations (refining the least settled designs first). Designs about a tolerance from the front, which more replicates settle only slowly, are `indifferent` and not refined once their objectives are known to within a share of their tolerances (`precision`, from the standard errors of the objectives that `pareto_probability` gives). `Study.run` evaluates given replicates (`replicate_indices`). - Class `tradespace.ResultStore`, a persistent store (SQLite) of the evaluations of a study (argument `store` of `Study`), from which a study that is interrupted or extended takes the evaluations stored before (except evaluations that failed and designs that failed validation, which are evaluated again). Workers add each evaluation as it completes, so that an interrupted run loses only the evaluations in progress, and records are kept as JSON (with values such as dates and infinite numbers tagged, so that they are read exactly). Function `tradespace.sensitivity` (and `main_effects`), the share of the variance of metrics explained by each design variable where it is active. Tolerances of objectives may be percentages of their values (such as `"5%"`). `Uncertain.seed` draws a seed of random numbers for each replicate, and `remove_failures` removes the satellites that fail, the same in every design. - - Building blocks of constellations: fragments of design spaces of Walker constellations (`tradespace.walker_space`) and planes of sun-synchronous orbits (`sso_planes_space`, whose planes have different crossing times), `build_constellation`, which builds the satellites of either with instruments or entries of the instrument catalog (with their validated attitudes, and several entries on one satellite), and `count_satellites` and `count_planes`. The phase and node of the lead satellite of a Walker constellation (`phase_fraction` and `node_fraction`, design variables or uncertain parameters) are fractions of the intervals over which they give distinct constellations (`360 / per_plane` degrees of phase, and `360 / planes` degrees of node for a delta configuration or 360 for a star), so that a search does not evaluate the same constellation at several phases or nodes. Planes of inclined orbits (`planes_space`), each with its own inclination and node (uncertain by default, as of satellites launched as secondary payloads). Streets-of-coverage constellations (`soc_space`), whose planes and satellites in each plane the fragment derives from a swath width, inclination, and altitude, and mutual orbiting groups (`mog_space`), launched together as one plane. The fragments name the number of planes `planes` and the satellites in each plane `per_plane`. The satellites of the planes of `sso_planes_space` and `planes_space` are evenly spaced, or follow each other in a train at an `interval` (minutes), on the same ground track or in the same plane (`repeat_ground_track`). The phase of each plane (`phase_fraction`) is a fraction of the interval over which it gives distinct planes (`360 / per_plane` degrees for evenly spaced satellites, 360 for a train), from which each fragment derives the plane's `true_anomaly`, as for the lead satellite of a Walker constellation. `build_constellation`, `count_satellites`, and `count_planes` take several layouts (a list, or a `Repeat` of a `Choice` of layouts), such as the shells of a mixed constellation. The values of each fragment in a design are those of a `Layout` (`layout_of`, with `WalkerLayout`, `SSOPlanesLayout`, `PlanesLayout`, `SOCLayout`, `MOGLayout`, and `Layouts` of several), which gives its `Plane`s and the orbits of their satellites in order; other layouts subclass it and are built, counted (`plane_sizes`), deployed, and costed as the others. + - Building blocks of constellations: fragments of design spaces of Walker constellations (`tradespace.walker_space`) and planes of sun-synchronous orbits (`sso_planes_space`, whose planes have different crossing times), `build_constellation`, which builds the satellites of either with instruments or entries of the instrument catalog (with their validated attitudes, several entries on one satellite if they share an attitude, and the `start` and `end` of the analysis for an attitude scheduled by day), and `count_satellites` and `count_planes`. The phase and node of the lead satellite of a Walker constellation (`phase_fraction` and `node_fraction`, design variables or uncertain parameters) are fractions of the intervals over which they give distinct constellations (`360 / per_plane` degrees of phase, and `360 / planes` degrees of node for a delta configuration or 360 for a star), so that a search does not evaluate the same constellation at several phases or nodes. Planes of inclined orbits (`planes_space`), each with its own inclination and node (uncertain by default, as of satellites launched as secondary payloads). Streets-of-coverage constellations (`soc_space`), whose planes and satellites in each plane the fragment derives from a swath width, inclination, and altitude, and mutual orbiting groups (`mog_space`), launched together as one plane. The fragments name the number of planes `planes` and the satellites in each plane `per_plane`. The satellites of the planes of `sso_planes_space` and `planes_space` are evenly spaced, or follow each other in a train at an `interval` (minutes), on the same ground track or in the same plane (`repeat_ground_track`). The phase of each plane (`phase_fraction`) is a fraction of the interval over which it gives distinct planes (`360 / per_plane` degrees for evenly spaced satellites, 360 for a train), from which each fragment derives the plane's `true_anomaly`, as for the lead satellite of a Walker constellation. `build_constellation`, `count_satellites`, and `count_planes` take several layouts (a list, or a `Repeat` of a `Choice` of layouts), such as the shells of a mixed constellation. The values of each fragment in a design are those of a `Layout` (`layout_of`, with `WalkerLayout`, `SSOPlanesLayout`, `PlanesLayout`, `SOCLayout`, `MOGLayout`, and `Layouts` of several), which gives its `Plane`s and the orbits of their satellites in order; other layouts subclass it and are built, counted (`plane_sizes`), deployed, and costed as the others. - Function `tradespace.screen` (and class `Screening`), which screens designs with studies of increasing fidelity, keeping whole fronts of the best designs of each stage for the next. - Searches of design spaces with optional optimizers: `tradespace.optimize_optuna` suggests designs with Optuna trials (define-by-run over the hierarchical space), and `optimize_pymoo` and `make_pymoo_problem` search the unit hypercube that encodes a design space (a dimension per decision) with pymoo, whose algorithms eliminate the proposals of designs proposed or evaluated before (`distinct`, by design, `make_pymoo_problem`'s `duplicates`). Each design is evaluated once, and the designs proposed together are evaluated together, in parallel if the study is. A search returns its results and designs (`Search`), which `refine` and `confirm` refine and confirm as for any study. Constraints of a design space may return the amount of their violation (`Infeasible.violation`), which Optuna's trials record (`set_constraint`) for its constraint-aware samplers, and which is the constraint value of pymoo problems. Optional dependencies `tradespace` (joblib, Optuna, and pymoo). - Deployment of constellations (`tradespace.DeploymentSchedule`): from the rates and durations of a study (the mission, the design life, development, and production rate of each type of satellite, its production on a line, and launches at a cadence and capacity, in number or mass, optionally in an order of planes), each design's deployment (`DeploymentSchedule.plan`, a `Deployment` of its `Production`, `Launch`es, and replacements), so that a design of more satellites and planes takes longer to deploy. A sustained constellation (`DeploymentSchedule.sustained`, such as of an operational program over the period of a study) is replaced after the end of the mission as before it, and its costs are those incurred by the end, which count the units in production then by the share produced and later blocks by the share of their development done. A deployment's launches divide the mission into phases of constant sets of operating satellites (`Deployment.phases`), evaluated over the study's representative period from the observations of the full constellation (`evaluate_phases`) and combined over the mission (`summarize_phases`: the time-weighted mean of each metric and the time until it first meets a requirement). diff --git a/docs/api_reference/catalog.rst b/docs/api_reference/catalog.rst index 0a8dd006..4e978684 100644 --- a/docs/api_reference/catalog.rst +++ b/docs/api_reference/catalog.rst @@ -14,17 +14,12 @@ Entries .. autofunction:: tatc.catalog.list_entries +.. autofunction:: tatc.catalog.build_payload + .. autopydantic_model:: tatc.catalog.InstrumentEntry .. autoclass:: tatc.catalog.InstrumentPayload -Attitudes by Day ----------------- - -.. autopydantic_model:: tatc.catalog.TiltSchedule - -.. autofunction:: tatc.catalog.get_subsolar_latitude - Validation Status ----------------- @@ -45,9 +40,30 @@ See :doc:`/validation/standard`. .. autoclass:: tatc.catalog.InstrumentClass :members: -.. autofunction:: tatc.catalog.get_gates +Schemas +------- + +The schemas of the files of entries and of their validation records. + +.. autopydantic_model:: tatc.catalog.schemas.Configuration + +.. autopydantic_model:: tatc.catalog.schemas.InstrumentSpecification + +.. autopydantic_model:: tatc.catalog.schemas.Provenance + +.. autopydantic_model:: tatc.catalog.schemas.TiltSchedule + +.. autopydantic_model:: tatc.catalog.schemas.ConfigurationRecord + +.. autopydantic_model:: tatc.catalog.schemas.Transfer + +.. autofunction:: tatc.catalog.schemas.get_period_days + +Standard +-------- -.. autofunction:: tatc.catalog.get_required_grades +.. automodule:: tatc.catalog.standard + :members: STANDARD_VERSION, COMPATIBLE_VERSIONS, MIN_HOLDOUT_GAP_DAYS, Gate, get_gates, get_required_grades, is_compatible Metrics ------- diff --git a/docs/api_reference/utils/index.rst b/docs/api_reference/utils/index.rst index 293fa0d0..37ed402c 100644 --- a/docs/api_reference/utils/index.rst +++ b/docs/api_reference/utils/index.rst @@ -40,6 +40,8 @@ Utility Functions .. autofunction:: tatc.utils.compute_glint_angle +.. autofunction:: tatc.utils.compute_subsolar_latitude + .. autoclass:: tatc.utils.VelocityFrame :members: @@ -75,6 +77,8 @@ Utility Functions .. autofunction:: tatc.utils.compute_argument_of_latitude +.. autofunction:: tatc.utils.compute_ascending_argument_of_latitude + .. autofunction:: tatc.utils.compute_j2_raan_rate .. autofunction:: tatc.utils.compute_j2_aop_rate diff --git a/docs/examples/UseInstrumentCatalog.ipynb b/docs/examples/UseInstrumentCatalog.ipynb index 0e5bdaad..bf328f39 100644 --- a/docs/examples/UseInstrumentCatalog.ipynb +++ b/docs/examples/UseInstrumentCatalog.ipynb @@ -32,10 +32,10 @@ "id": "7906c8ba", "metadata": { "execution": { - "iopub.execute_input": "2026-11-11T23:29:10.131969Z", - "iopub.status.busy": "2026-11-11T23:29:10.131077Z", - "iopub.status.idle": "2026-11-11T23:29:12.502601Z", - "shell.execute_reply": "2026-11-11T23:29:12.501405Z" + "iopub.execute_input": "2026-11-15T15:42:29.550736Z", + "iopub.status.busy": "2026-11-15T15:42:29.550413Z", + "iopub.status.idle": "2026-11-15T15:42:35.597917Z", + "shell.execute_reply": "2026-11-15T15:42:35.597419Z" } }, "outputs": [ @@ -134,6 +134,15 @@ " \n", " \n", " 7\n", + " atlid\n", + " ATLID\n", + " profiler\n", + " partial\n", + " profile\n", + " EarthCARE\n", + " \n", + " \n", + " 8\n", " atms\n", " ATMS\n", " cross_track\n", @@ -142,7 +151,7 @@ " NOAA-20, NOAA-21\n", " \n", " \n", - " 8\n", + " 9\n", " avhrr\n", " AVHRR\n", " cross_track\n", @@ -151,7 +160,16 @@ " Metop-C, Metop-B\n", " \n", " \n", - " 9\n", + " 10\n", + " bbr\n", + " BBR\n", + " pushbroom\n", + " partial\n", + " views\n", + " EarthCARE\n", + " \n", + " \n", + " 11\n", " ceres\n", " CERES\n", " cross_track\n", @@ -160,7 +178,16 @@ " NOAA-20\n", " \n", " \n", - " 10\n", + " 12\n", + " cpr\n", + " CPR\n", + " profiler\n", + " partial\n", + " nadir\n", + " EarthCARE\n", + " \n", + " \n", + " 13\n", " cris\n", " CrIS\n", " cross_track\n", @@ -169,7 +196,7 @@ " NOAA-20, NOAA-21\n", " \n", " \n", - " 11\n", + " 14\n", " csar\n", " C-SAR\n", " sar\n", @@ -178,7 +205,7 @@ " Sentinel-1C, Sentinel-1D\n", " \n", " \n", - " 12\n", + " 15\n", " dpr\n", " DPR\n", " cross_track\n", @@ -187,7 +214,16 @@ " GPM Core Observatory\n", " \n", " \n", - " 13\n", + " 16\n", + " earthcare_msi\n", + " EarthCARE MSI\n", + " pushbroom\n", + " validated\n", + " swath\n", + " EarthCARE\n", + " \n", + " \n", + " 17\n", " ecostress\n", " ECOSTRESS\n", " cross_track\n", @@ -196,7 +232,7 @@ " International Space Station\n", " \n", " \n", - " 14\n", + " 18\n", " emit\n", " EMIT\n", " pushbroom\n", @@ -205,7 +241,7 @@ " International Space Station\n", " \n", " \n", - " 15\n", + " 19\n", " gedi\n", " GEDI\n", " lidar\n", @@ -214,7 +250,7 @@ " International Space Station\n", " \n", " \n", - " 16\n", + " 20\n", " gmi\n", " GMI\n", " conical\n", @@ -223,7 +259,7 @@ " GPM Core Observatory\n", " \n", " \n", - " 17\n", + " 21\n", " harp2\n", " HARP2\n", " pushbroom\n", @@ -232,7 +268,7 @@ " PACE\n", " \n", " \n", - " 18\n", + " 22\n", " iasi\n", " IASI\n", " cross_track\n", @@ -241,7 +277,7 @@ " Metop-B\n", " \n", " \n", - " 19\n", + " 23\n", " karin\n", " KaRIn\n", " sar\n", @@ -250,7 +286,7 @@ " SWOT\n", " \n", " \n", - " 20\n", + " 24\n", " lsar\n", " L-SAR\n", " sar\n", @@ -259,7 +295,7 @@ " NISAR\n", " \n", " \n", - " 21\n", + " 25\n", " mhs\n", " MHS\n", " cross_track\n", @@ -268,7 +304,7 @@ " Metop-C, Metop-B\n", " \n", " \n", - " 22\n", + " 26\n", " modis\n", " MODIS\n", " cross_track\n", @@ -277,7 +313,7 @@ " Terra, Aqua\n", " \n", " \n", - " 23\n", + " 27\n", " msi\n", " MSI\n", " pushbroom\n", @@ -286,7 +322,7 @@ " Sentinel-2A, Sentinel-2B, Sentinel-2C\n", " \n", " \n", - " 24\n", + " 28\n", " oci\n", " OCI\n", " cross_track\n", @@ -295,7 +331,7 @@ " PACE\n", " \n", " \n", - " 25\n", + " 29\n", " oco2\n", " OCO-2\n", " pushbroom\n", @@ -304,7 +340,7 @@ " OCO-2\n", " \n", " \n", - " 26\n", + " 30\n", " olci\n", " OLCI\n", " pushbroom\n", @@ -313,7 +349,7 @@ " Sentinel-3A\n", " \n", " \n", - " 27\n", + " 31\n", " oli\n", " OLI\n", " pushbroom\n", @@ -322,7 +358,7 @@ " Landsat 9, Landsat 8\n", " \n", " \n", - " 28\n", + " 32\n", " omps_nm\n", " OMPS Nadir Mapper\n", " pushbroom\n", @@ -331,7 +367,7 @@ " NOAA-21, NOAA-20\n", " \n", " \n", - " 29\n", + " 33\n", " poseidon4\n", " Poseidon-4\n", " altimeter\n", @@ -340,7 +376,7 @@ " Sentinel-6 Michael Freilich, Sentinel-6B\n", " \n", " \n", - " 30\n", + " 34\n", " smap_radiometer\n", " SMAP radiometer\n", " conical\n", @@ -349,7 +385,7 @@ " SMAP\n", " \n", " \n", - " 31\n", + " 35\n", " spexone\n", " SPEXone\n", " pushbroom\n", @@ -358,7 +394,7 @@ " PACE\n", " \n", " \n", - " 32\n", + " 36\n", " ssmis\n", " SSMIS\n", " conical\n", @@ -367,7 +403,7 @@ " DMSP F18\n", " \n", " \n", - " 33\n", + " 37\n", " tempo\n", " TEMPO\n", " geostationary_regional\n", @@ -376,7 +412,25 @@ " Intelsat 40e\n", " \n", " \n", - " 34\n", + " 38\n", + " tmi\n", + " TMI\n", + " conical\n", + " validated\n", + " feeds, sample_size\n", + " TRMM\n", + " \n", + " \n", + " 39\n", + " trmm_pr\n", + " PR\n", + " cross_track\n", + " partial\n", + " swath, beams\n", + " TRMM\n", + " \n", + " \n", + " 40\n", " tropomi\n", " TROPOMI\n", " pushbroom\n", @@ -385,7 +439,7 @@ " Sentinel-5P\n", " \n", " \n", - " 35\n", + " 41\n", " viirs\n", " VIIRS\n", " cross_track\n", @@ -393,6 +447,15 @@ " swath_noaa_20, swath_noaa_21, zones_noaa_20\n", " NOAA-20, NOAA-21\n", " \n", + " \n", + " 42\n", + " virs\n", + " VIRS\n", + " cross_track\n", + " validated\n", + " swath, pixels\n", + " TRMM\n", + " \n", " \n", "\n", "" @@ -406,35 +469,42 @@ "4 amsua AMSU-A cross_track partial \n", "5 ascat ASCAT scatterometer validated \n", "6 atlas ATLAS lidar partial \n", - "7 atms ATMS cross_track validated \n", - "8 avhrr AVHRR cross_track partial \n", - "9 ceres CERES cross_track partial \n", - "10 cris CrIS cross_track partial \n", - "11 csar C-SAR sar partial \n", - "12 dpr DPR cross_track validated \n", - "13 ecostress ECOSTRESS cross_track partial \n", - "14 emit EMIT pushbroom partial \n", - "15 gedi GEDI lidar partial \n", - "16 gmi GMI conical validated \n", - "17 harp2 HARP2 pushbroom validated \n", - "18 iasi IASI cross_track partial \n", - "19 karin KaRIn sar validated \n", - "20 lsar L-SAR sar partial \n", - "21 mhs MHS cross_track validated \n", - "22 modis MODIS cross_track validated \n", - "23 msi MSI pushbroom validated \n", - "24 oci OCI cross_track partial \n", - "25 oco2 OCO-2 pushbroom partial \n", - "26 olci OLCI pushbroom partial \n", - "27 oli OLI pushbroom validated \n", - "28 omps_nm OMPS Nadir Mapper pushbroom partial \n", - "29 poseidon4 Poseidon-4 altimeter validated \n", - "30 smap_radiometer SMAP radiometer conical partial \n", - "31 spexone SPEXone pushbroom validated \n", - "32 ssmis SSMIS conical partial \n", - "33 tempo TEMPO geostationary_regional validated \n", - "34 tropomi TROPOMI pushbroom validated \n", - "35 viirs VIIRS cross_track validated \n", + "7 atlid ATLID profiler partial \n", + "8 atms ATMS cross_track validated \n", + "9 avhrr AVHRR cross_track partial \n", + "10 bbr BBR pushbroom partial \n", + "11 ceres CERES cross_track partial \n", + "12 cpr CPR profiler partial \n", + "13 cris CrIS cross_track partial \n", + "14 csar C-SAR sar partial \n", + "15 dpr DPR cross_track validated \n", + "16 earthcare_msi EarthCARE MSI pushbroom validated \n", + "17 ecostress ECOSTRESS cross_track partial \n", + "18 emit EMIT pushbroom partial \n", + "19 gedi GEDI lidar partial \n", + "20 gmi GMI conical validated \n", + "21 harp2 HARP2 pushbroom validated \n", + "22 iasi IASI cross_track partial \n", + "23 karin KaRIn sar validated \n", + "24 lsar L-SAR sar partial \n", + "25 mhs MHS cross_track validated \n", + "26 modis MODIS cross_track validated \n", + "27 msi MSI pushbroom validated \n", + "28 oci OCI cross_track partial \n", + "29 oco2 OCO-2 pushbroom partial \n", + "30 olci OLCI pushbroom partial \n", + "31 oli OLI pushbroom validated \n", + "32 omps_nm OMPS Nadir Mapper pushbroom partial \n", + "33 poseidon4 Poseidon-4 altimeter validated \n", + "34 smap_radiometer SMAP radiometer conical partial \n", + "35 spexone SPEXone pushbroom validated \n", + "36 ssmis SSMIS conical partial \n", + "37 tempo TEMPO geostationary_regional validated \n", + "38 tmi TMI conical validated \n", + "39 trmm_pr PR cross_track partial \n", + "40 tropomi TROPOMI pushbroom validated \n", + "41 viirs VIIRS cross_track validated \n", + "42 virs VIRS cross_track validated \n", "\n", " configurations \\\n", "0 full_disk, sst_good_quality, lst_good_quality \n", @@ -444,35 +514,42 @@ "4 swath, footprints \n", "5 swaths \n", "6 beam_pairs \n", - "7 swath_noaa_20, beams_noaa_20, swath_noaa_21, beams_noaa_21 \n", - "8 swath, pixels \n", - "9 swath \n", - "10 swath, pixels \n", - "11 iw, ew \n", - "12 swath, beams \n", - "13 swath \n", - "14 swath \n", - "15 beams \n", - "16 feeds, sample_size \n", + "7 profile \n", + "8 swath_noaa_20, beams_noaa_20, swath_noaa_21, beams_noaa_21 \n", + "9 swath, pixels \n", + "10 views \n", + "11 swath \n", + "12 nadir \n", + "13 swath, pixels \n", + "14 iw, ew \n", + "15 swath, beams \n", + "16 swath \n", "17 swath \n", - "18 swath, pixels \n", - "19 swaths \n", - "20 swath_20_40mhz, swath_5mhz, swath_77mhz \n", - "21 swath, beams \n", + "18 swath \n", + "19 beams \n", + "20 feeds, sample_size \n", + "21 swath \n", "22 swath, pixels \n", - "23 swath \n", - "24 swath \n", - "25 nadir, glint \n", - "26 swath \n", + "23 swaths \n", + "24 swath_20_40mhz, swath_5mhz, swath_77mhz \n", + "25 swath, beams \n", + "26 swath, pixels \n", "27 swath \n", - "28 swath_noaa_21, swath_noaa_20 \n", - "29 nadir \n", - "30 looks, footprints \n", + "28 swath \n", + "29 nadir, glint \n", + "30 swath \n", "31 swath \n", - "32 swath \n", - "33 field_of_regard \n", - "34 swath \n", - "35 swath_noaa_20, swath_noaa_21, zones_noaa_20 \n", + "32 swath_noaa_21, swath_noaa_20 \n", + "33 nadir \n", + "34 looks, footprints \n", + "35 swath \n", + "36 swath \n", + "37 field_of_regard \n", + "38 feeds, sample_size \n", + "39 swath, beams \n", + "40 swath \n", + "41 swath_noaa_20, swath_noaa_21, zones_noaa_20 \n", + "42 swath, pixels \n", "\n", " platforms \n", "0 GOES-19 \n", @@ -482,35 +559,42 @@ "4 Aqua \n", "5 Metop-C \n", "6 ICESat-2 \n", - "7 NOAA-20, NOAA-21 \n", - "8 Metop-C, Metop-B \n", - "9 NOAA-20 \n", - "10 NOAA-20, NOAA-21 \n", - "11 Sentinel-1C, Sentinel-1D \n", - "12 GPM Core Observatory \n", - "13 International Space Station \n", - "14 International Space Station \n", - "15 International Space Station \n", - "16 GPM Core Observatory \n", - "17 PACE \n", - "18 Metop-B \n", - "19 SWOT \n", - "20 NISAR \n", - "21 Metop-C, Metop-B \n", - "22 Terra, Aqua \n", - "23 Sentinel-2A, Sentinel-2B, Sentinel-2C \n", - "24 PACE \n", - "25 OCO-2 \n", - "26 Sentinel-3A \n", - "27 Landsat 9, Landsat 8 \n", - "28 NOAA-21, NOAA-20 \n", - "29 Sentinel-6 Michael Freilich, Sentinel-6B \n", - "30 SMAP \n", - "31 PACE \n", - "32 DMSP F18 \n", - "33 Intelsat 40e \n", - "34 Sentinel-5P \n", - "35 NOAA-20, NOAA-21 " + "7 EarthCARE \n", + "8 NOAA-20, NOAA-21 \n", + "9 Metop-C, Metop-B \n", + "10 EarthCARE \n", + "11 NOAA-20 \n", + "12 EarthCARE \n", + "13 NOAA-20, NOAA-21 \n", + "14 Sentinel-1C, Sentinel-1D \n", + "15 GPM Core Observatory \n", + "16 EarthCARE \n", + "17 International Space Station \n", + "18 International Space Station \n", + "19 International Space Station \n", + "20 GPM Core Observatory \n", + "21 PACE \n", + "22 Metop-B \n", + "23 SWOT \n", + "24 NISAR \n", + "25 Metop-C, Metop-B \n", + "26 Terra, Aqua \n", + "27 Sentinel-2A, Sentinel-2B, Sentinel-2C \n", + "28 PACE \n", + "29 OCO-2 \n", + "30 Sentinel-3A \n", + "31 Landsat 9, Landsat 8 \n", + "32 NOAA-21, NOAA-20 \n", + "33 Sentinel-6 Michael Freilich, Sentinel-6B \n", + "34 SMAP \n", + "35 PACE \n", + "36 DMSP F18 \n", + "37 Intelsat 40e \n", + "38 TRMM \n", + "39 TRMM \n", + "40 Sentinel-5P \n", + "41 NOAA-20, NOAA-21 \n", + "42 TRMM " ] }, "execution_count": 1, @@ -552,17 +636,17 @@ "id": "c69286ad", "metadata": { "execution": { - "iopub.execute_input": "2026-11-11T23:29:12.509183Z", - "iopub.status.busy": "2026-11-11T23:29:12.508703Z", - "iopub.status.idle": "2026-11-11T23:29:12.535742Z", - "shell.execute_reply": "2026-11-11T23:29:12.533768Z" + "iopub.execute_input": "2026-11-15T15:42:35.599336Z", + "iopub.status.busy": "2026-11-15T15:42:35.599115Z", + "iopub.status.idle": "2026-11-15T15:42:35.618123Z", + "shell.execute_reply": "2026-11-15T15:42:35.617585Z" } }, "outputs": [ { "data": { "text/plain": [ - "['HARP2', 'MSI', 'OLI', 'SPEXone', 'TROPOMI']" + "['EarthCARE MSI', 'HARP2', 'MSI', 'OLI', 'SPEXone', 'TROPOMI']" ] }, "execution_count": 2, @@ -590,10 +674,10 @@ "id": "7d66e7a1", "metadata": { "execution": { - "iopub.execute_input": "2026-11-11T23:29:12.539475Z", - "iopub.status.busy": "2026-11-11T23:29:12.539193Z", - "iopub.status.idle": "2026-11-11T23:29:12.551824Z", - "shell.execute_reply": "2026-11-11T23:29:12.551154Z" + "iopub.execute_input": "2026-11-15T15:42:35.619173Z", + "iopub.status.busy": "2026-11-15T15:42:35.619034Z", + "iopub.status.idle": "2026-11-15T15:42:35.625378Z", + "shell.execute_reply": "2026-11-15T15:42:35.624854Z" } }, "outputs": [ @@ -817,10 +901,10 @@ "id": "d67191d6", "metadata": { "execution": { - "iopub.execute_input": "2026-11-11T23:29:12.555707Z", - "iopub.status.busy": "2026-11-11T23:29:12.555476Z", - "iopub.status.idle": "2026-11-11T23:29:12.560686Z", - "shell.execute_reply": "2026-11-11T23:29:12.559189Z" + "iopub.execute_input": "2026-11-15T15:42:35.626832Z", + "iopub.status.busy": "2026-11-15T15:42:35.626670Z", + "iopub.status.idle": "2026-11-15T15:42:35.629104Z", + "shell.execute_reply": "2026-11-15T15:42:35.628626Z" } }, "outputs": [ @@ -846,7 +930,7 @@ "source": [ "## Build a Satellite\n", "\n", - "The catalog holds no orbits, as element sets age. Supply an orbit for the analysis period, here from a two-line element set of NOAA-20. `to_satellite` builds a satellite with the instruments of a configuration (the default, if none is given) and the attitude they were tested with. VIIRS's view is tailored to the analysis time step, so the time step is needed too. Naming the platform gives a warning if the configuration was not tested on it." + "The catalog holds no orbits, as element sets age. Supply an orbit for the analysis period, here from a two-line element set of NOAA-20. `to_satellite` builds a satellite with the instruments of a configuration and the attitude they were tested with. Naming the platform selects the configuration tested on it: VIIRS has one fitted on NOAA-20 (`swath_noaa_20`) and one on NOAA-21 (`swath_noaa_21`). VIIRS's view is tailored to the analysis time step, so the time step is needed too." ] }, { @@ -855,10 +939,10 @@ "id": "884f4304", "metadata": { "execution": { - "iopub.execute_input": "2026-11-11T23:29:12.563558Z", - "iopub.status.busy": "2026-11-11T23:29:12.563309Z", - "iopub.status.idle": "2026-11-11T23:29:12.583659Z", - "shell.execute_reply": "2026-11-11T23:29:12.582491Z" + "iopub.execute_input": "2026-11-15T15:42:35.630123Z", + "iopub.status.busy": "2026-11-15T15:42:35.629964Z", + "iopub.status.idle": "2026-11-15T15:42:35.665240Z", + "shell.execute_reply": "2026-11-15T15:42:35.664748Z" } }, "outputs": [ @@ -905,10 +989,10 @@ "id": "194e1030", "metadata": { "execution": { - "iopub.execute_input": "2026-11-11T23:29:12.587304Z", - "iopub.status.busy": "2026-11-11T23:29:12.587092Z", - "iopub.status.idle": "2026-11-11T23:29:12.594828Z", - "shell.execute_reply": "2026-11-11T23:29:12.593785Z" + "iopub.execute_input": "2026-11-15T15:42:35.666535Z", + "iopub.status.busy": "2026-11-15T15:42:35.666229Z", + "iopub.status.idle": "2026-11-15T15:42:35.670203Z", + "shell.execute_reply": "2026-11-15T15:42:35.669711Z" } }, "outputs": [ @@ -962,10 +1046,10 @@ "id": "93910923", "metadata": { "execution": { - "iopub.execute_input": "2026-11-11T23:29:12.597808Z", - "iopub.status.busy": "2026-11-11T23:29:12.597619Z", - "iopub.status.idle": "2026-11-11T23:29:13.086115Z", - "shell.execute_reply": "2026-11-11T23:29:13.084564Z" + "iopub.execute_input": "2026-11-15T15:42:35.671293Z", + "iopub.status.busy": "2026-11-15T15:42:35.671128Z", + "iopub.status.idle": "2026-11-15T15:42:35.856615Z", + "shell.execute_reply": "2026-11-15T15:42:35.856115Z" } }, "outputs": [ @@ -1063,10 +1147,10 @@ "id": "eae9ba46", "metadata": { "execution": { - "iopub.execute_input": "2026-11-11T23:29:13.091894Z", - "iopub.status.busy": "2026-11-11T23:29:13.091602Z", - "iopub.status.idle": "2026-11-11T23:29:15.415049Z", - "shell.execute_reply": "2026-11-11T23:29:15.412942Z" + "iopub.execute_input": "2026-11-15T15:42:35.857776Z", + "iopub.status.busy": "2026-11-15T15:42:35.857595Z", + "iopub.status.idle": "2026-11-15T15:42:37.102685Z", + "shell.execute_reply": "2026-11-15T15:42:37.102048Z" } }, "outputs": [ @@ -1107,7 +1191,7 @@ "source": [ "## Untested Platforms\n", "\n", - "A configuration's results hold for the platforms it was tested on. Using it for another platform, here the default configuration of VIIRS on NOAA-21, gives a warning. Where angles differ between sister platforms, an entry has a configuration fitted on each, named for its platform, as VIIRS's `swath_noaa_20` and `swath_noaa_21`; results of a configuration on a sister platform it was not fitted on are recorded as transfers, which do not count toward its tier." + "A configuration's results hold for the platforms it was tested on. A platform selects the configuration tested on it, and a grade one for that use (`coverage`, `timing`, or `sample_size`). Where none was tested on the platform, as VIIRS's aggregation zones on NOAA-21, one tested on another platform is selected, and using it gives a warning, as does naming a configuration tested on another platform. Results of a configuration on a sister platform it was not fitted on are recorded as transfers, which do not count toward its tier." ] }, { @@ -1116,10 +1200,10 @@ "id": "844749e4", "metadata": { "execution": { - "iopub.execute_input": "2026-11-11T23:29:15.420766Z", - "iopub.status.busy": "2026-11-11T23:29:15.419819Z", - "iopub.status.idle": "2026-11-11T23:29:15.430493Z", - "shell.execute_reply": "2026-11-11T23:29:15.429342Z" + "iopub.execute_input": "2026-11-15T15:42:37.104012Z", + "iopub.status.busy": "2026-11-15T15:42:37.103761Z", + "iopub.status.idle": "2026-11-15T15:42:37.107423Z", + "shell.execute_reply": "2026-11-15T15:42:37.106859Z" } }, "outputs": [ @@ -1127,6 +1211,8 @@ "name": "stdout", "output_type": "stream", "text": [ + "swath_noaa_21\n", + "zones_noaa_20\n", "configuration 'swath_noaa_20' of 'viirs' was tested on ['noaa-20'], not on 'noaa-21'\n" ] } @@ -1134,9 +1220,12 @@ "source": [ "import warnings\n", "\n", + "print(viirs.select_configuration(platform=\"noaa-21\"))\n", + "print(viirs.select_configuration(grade=\"sample_size\", platform=\"noaa-21\"))\n", "with warnings.catch_warnings(record=True) as caught:\n", " warnings.simplefilter(\"always\")\n", " viirs.build(\n", + " configuration=\"swath_noaa_20\",\n", " orbit=GeneralPerturbationsOrbit.from_tle(noaa20_tle),\n", " time_step=time_step,\n", " platform=\"noaa-21\",\n", @@ -1152,7 +1241,7 @@ "source": [ "## Multiple Instruments\n", "\n", - "Some configurations have several instruments. The configuration's `grouping` states how to analyze them: `union` instruments together form the swath, so analyze them with `instrument_index=None`, while `alternatives` are different views, analyzed one at a time. `build` returns the instruments with the attitude and the index to use, without building a satellite:" + "Some configurations have several instruments. `build` returns the instruments with the attitude and the `instrument_index` to analyze them with, without building a satellite: `None` for instruments that together form the swath, as TROPOMI's views, or the index of the view to analyze of alternative views, analyzed one at a time. Its `references` name the configuration built." ] }, { @@ -1161,10 +1250,10 @@ "id": "e2921c0c", "metadata": { "execution": { - "iopub.execute_input": "2026-11-11T23:29:15.434828Z", - "iopub.status.busy": "2026-11-11T23:29:15.434427Z", - "iopub.status.idle": "2026-11-11T23:29:15.448496Z", - "shell.execute_reply": "2026-11-11T23:29:15.446388Z" + "iopub.execute_input": "2026-11-15T15:42:37.108584Z", + "iopub.status.busy": "2026-11-15T15:42:37.108392Z", + "iopub.status.idle": "2026-11-15T15:42:37.111999Z", + "shell.execute_reply": "2026-11-15T15:42:37.111438Z" } }, "outputs": [ @@ -1172,7 +1261,7 @@ "name": "stdout", "output_type": "stream", "text": [ - "10 instruments, grouping: union\n" + "('tropomi:swath',): 10 instruments, instrument_index=None\n" ] } ], @@ -1181,7 +1270,8 @@ "payload = tropomi.build(\n", " orbit=GeneralPerturbationsOrbit.from_tle(noaa20_tle), time_step=time_step\n", ")\n", - "print(f\"{len(payload.instruments)} instruments, grouping: {payload.grouping}\")" + "print(f\"{payload.references}: {len(payload.instruments)} instruments, \"\n", + " f\"instrument_index={payload.instrument_index}\")" ] }, { @@ -1189,7 +1279,7 @@ "id": "8d474d54", "metadata": {}, "source": [ - "Here the orbit only sets the tailored along-track field of view; for an analysis of TROPOMI, use an orbit of Sentinel-5P." + "Here the orbit only sets the tailored along-track field of view; for an analysis of TROPOMI, use an orbit of Sentinel-5P. To carry the instruments of several entries on one satellite, as `tatc.tradespace.build_constellation` does, `build_payload` takes their references (such as `[\"atms\", \"cris:swath\"]`), which must share an attitude." ] } ], @@ -1209,7 +1299,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.14.9" + "version": "3.14.10" } }, "nbformat": 4, diff --git a/docs/examples/osse/RunOSSEHurricane.ipynb b/docs/examples/osse/RunOSSEHurricane.ipynb index 3c6df58e..80776214 100644 --- a/docs/examples/osse/RunOSSEHurricane.ipynb +++ b/docs/examples/osse/RunOSSEHurricane.ipynb @@ -1456,7 +1456,9 @@ " \"\"\"A satellite carrying the swaths of ATMS and CrIS (the catalog's swath configurations), tailored to the time\n", " step, with the attitude they were tested with (scanning perpendicular to the inertial velocity).\"\"\"\n", " payloads = [\n", - " entry.build(SWATHS[sensor], orbit=orbit, time_step=TIME_STEP)\n", + " entry.build(\n", + " configuration=SWATHS[sensor], orbit=orbit, time_step=TIME_STEP\n", + " )\n", " for sensor, entry in entries.items()\n", " ]\n", " return Satellite(\n", diff --git a/docs/examples/osse/RunOSSEMonsoon.ipynb b/docs/examples/osse/RunOSSEMonsoon.ipynb index eebc547f..9958f9f5 100644 --- a/docs/examples/osse/RunOSSEMonsoon.ipynb +++ b/docs/examples/osse/RunOSSEMonsoon.ipynb @@ -1312,7 +1312,9 @@ " \"\"\"A satellite carrying the swaths of ATMS and CrIS (the catalog's swath configurations), tailored to the time\n", " step, with the attitude they were tested with (scanning perpendicular to the inertial velocity).\"\"\"\n", " payloads = [\n", - " entry.build(SWATHS[sensor], orbit=orbit, time_step=TIME_STEP)\n", + " entry.build(\n", + " configuration=SWATHS[sensor], orbit=orbit, time_step=TIME_STEP\n", + " )\n", " for sensor, entry in entries.items()\n", " ]\n", " return Satellite(\n", diff --git a/docs/validation/catalog_page.py b/docs/validation/catalog_page.py index 40763f84..21a7e398 100644 --- a/docs/validation/catalog_page.py +++ b/docs/validation/catalog_page.py @@ -9,13 +9,8 @@ import pathlib import re -from tatc.catalog import ( - MIN_HOLDOUT_GAP_DAYS, - STANDARD_VERSION, - Tier, - get_entry, - get_entry_ids, -) +from tatc.catalog import STANDARD_VERSION, get_entry, get_entry_ids +from tatc.catalog.standard import MIN_HOLDOUT_GAP_DAYS REPOSITORY = "https://github.com/code-lab-org/tatc/blob/main/" METRIC_LABELS = { @@ -31,7 +26,6 @@ "product_limit": "Product limit of local zenith angle", } DECIMALS = {"%": 2, "s": 2, "km": 2, "deg": 2, "": 4} -ORDER = {Tier.VALIDATED: 0, Tier.PARTIAL: 1, Tier.NOMINAL: 2} def escape(text: str) -> str: @@ -161,24 +155,25 @@ def render_configuration(entry, key: str) -> str: f"``instrument_index={configuration.instrument_index}`` unless " "another is given.\n" ) - if configuration.attitude_schedule is not None: + if configuration.tilt_schedule is not None: parts.append( - "Its attitude is scheduled by day: build it with the start and end of " - "the analysis (``start`` and ``end``).\n" + "Its tilt is scheduled by day: build it with the start and end of the " + "analysis (``start`` and ``end``).\n" ) if record is not None: - gap = ( - "no holdout" - if record.holdout_gap_days is None - else f"{record.holdout_gap_days:g} days from the fitting data" - ) - if not configuration.is_fitted: + if validation.holdout_gap_days is None: gap = "no fitted values" + elif validation.holdout_gap_days == 0: + gap = "no holdout" + else: + gap = f"{validation.holdout_gap_days} days from the fitting data" source = f"`{record.source} <{REPOSITORY}{record.source}>`_" + tested = ", ".join(names.get(p, p) for p in record.platforms) parts.append( f"**Reference:** {escape(record.reference)}, {record.period} " - f"({escape(record.platform)}; {gap}). **Results:** {source}, " - f"TAT-C {record.tatc_version}.\n" + f"({escape(tested)}; {gap}). **Results:** {source}, " + f"TAT-C {record.tatc_version}, version {record.standard_version} of " + "the standard.\n" ) rows = [] for result in validation.gates: @@ -204,12 +199,22 @@ def render_configuration(entry, key: str) -> str: ] ) parts.append( - "Gates, with the worst result over the scopes tested (such as platforms " - "and time steps):\n" + "Gates, with the worst result over the scopes tested (such as " + "instruments and time steps):\n" ) parts.append( list_table(["Metric", "Result", "Limit", "Outcome"], rows, [34, 36, 15, 15]) ) + if record is not None and record.transfers: + parts.append( + "**Transfers**, results on other platforms, which do not count toward " + "its tier: " + + ", ".join( + f"{escape(names.get(p, p))} ({transfer.period})" + for p, transfer in record.transfers.items() + ) + + ".\n" + ) if record is not None: path = f"src/tatc/resources/validation/{entry.id}.json" parts.append( @@ -302,7 +307,7 @@ def render() -> str: """ entries = sorted( (get_entry(entry_id) for entry_id in get_entry_ids()), - key=lambda e: (ORDER[e.validation.tier], e.name.lower()), + key=lambda e: (-e.validation.tier.rank, e.name.lower()), ) summary = list_table( ["Instrument", "Class", "Tier", "Configurations", "Platforms"], @@ -347,19 +352,23 @@ def render() -> str: from tatc.catalog import get_entry, list_entries list_entries(tier="validated") - entry = get_entry("viirs") + entry = get_entry("atms") entry.validation # tier, gate results, and gaps of each configuration - satellite = entry.to_satellite(orbit, time_step=10, platform="noaa-20") - -Pass the analysis time step to configurations whose along-track field of view -is tailored to it, and keep the attitude of the configuration: a scanner modeled -in another velocity frame can misplace its swath edges by tens of kilometers. -Pass the start and end of the analysis to configurations whose attitude is -scheduled by day, such as OCI's tilt. Where an entry has configurations fitted -on more than one platform (ATMS, VIIRS, and the OMPS Nadir Mapper), each -configuration's name ends with its platform, such as ``swath_noaa_21``; use -those of the platform analyzed. The entries hold no element sets, as they age; -supply a recent one for the analysis period. + satellite = entry.to_satellite(orbit, time_step=10, platform="noaa-21") + pixels = entry.to_satellite(orbit, grade="sample_size", platform="noaa-21") + +Name the platform analyzed: it selects the configuration tested on it, and +using a configuration on a platform on which it was not tested gives a +warning. Where an entry has configurations fitted on more than one platform +(ATMS, VIIRS, and the OMPS Nadir Mapper), each configuration's name ends with +its platform, such as ``swath_noaa_21``. A grade (``coverage``, ``timing``, or +``sample_size``) selects a configuration for that use. Pass the analysis time +step to configurations whose along-track field of view is tailored to it, and +keep the attitude of the configuration: a scanner modeled in another velocity +frame can misplace its swath edges by tens of kilometers. Pass the start and +end of the analysis to configurations whose tilt is scheduled by day, such as +OCI's. The entries hold no element sets, as they age; supply a recent one for +the analysis period. """ body = "\n".join(render_entry(entry) for entry in entries) diff --git a/docs/validation/standard.rst b/docs/validation/standard.rst index 0d9e61f4..70b0e686 100644 --- a/docs/validation/standard.rst +++ b/docs/validation/standard.rst @@ -63,19 +63,26 @@ Rules ===== 1. **Public methods, exact values.** A result counts only if it comes from public - TAT-C methods using the entry's exact values. Results from notebook-only - refinements, or from rounded or other values, are recorded as `reported` and - cannot make a configuration `validated`. + TAT-C methods using the entry's exact values. A record identifies the + configuration it tested by a digest of its values, so results of a + configuration that changed after its test cannot make it `validated`. 2. **Holdout.** Values fitted to reference data are tested on data at least 30 - days from their fitting data. Values from published specifications or computed - from other values need no holdout. Results on another platform of the same - instrument do not count: using a configuration on an untested platform warns. + days from their fitting data. The gap is computed, not declared: it is the + days between the nearest days of the period of each fitted value's data, + which its provenance states, and of the test's data, which its record states. + Values from published specifications or computed from other values need no + holdout. Results on another platform of the same instrument are recorded as + transfers, which do not count: using a configuration on an untested platform + warns. 3. **Geometry, not acquisition.** Passes are scored before solar limits or acquisition plans. TAT-C predicts what a system can observe, not what it chose to observe. 4. **Provenance.** Each parameter states whether it is `nominal`, `measured`, `derived`, or a `placeholder`, and its source. A published specification is never reported as measured. +5. **Version.** Each configuration's record states the version of the standard + of its test. Its results apply under a compatible version that has the gates + of its class. Tiers ===== diff --git a/src/tatc/catalog/__init__.py b/src/tatc/catalog/__init__.py index 1d5ef51c..0f4046e9 100644 --- a/src/tatc/catalog/__init__.py +++ b/src/tatc/catalog/__init__.py @@ -4,67 +4,34 @@ An entry's `validation` states how far each configuration has been validated: not every entry is fully `validated`, and only `validated` configurations have -passed every test of the standard (see `tatc.catalog.standard`). +passed every test of the standard (see `tatc.catalog.standard`). The schemas of +entries and their records are in `tatc.catalog.schemas`. @author: Paul T. Grogan """ -from .loader import get_entry, get_entry_ids, list_entries +from .loader import build_payload, get_entry, get_entry_ids, list_entries from .schemas import ( - Configuration, - ConfigurationRecord, ConfigurationValidation, - DataProduct, EntryValidation, GateResult, InstrumentEntry, InstrumentPayload, - InstrumentSpecification, - Metric, - Platform, - Provenance, - TiltSchedule, - ValidationRecord, - get_subsolar_latitude, -) -from .standard import ( - COMPATIBLE_VERSIONS, - MIN_HOLDOUT_GAP_DAYS, - STANDARD_VERSION, - Gate, - Grade, - InstrumentClass, - Tier, - get_gates, - get_required_grades, ) +from .standard import STANDARD_VERSION, Grade, InstrumentClass, Tier __all__ = [ - "COMPATIBLE_VERSIONS", - "Configuration", - "ConfigurationRecord", "ConfigurationValidation", - "DataProduct", "EntryValidation", - "Gate", "GateResult", "Grade", "InstrumentClass", "InstrumentEntry", "InstrumentPayload", - "InstrumentSpecification", - "MIN_HOLDOUT_GAP_DAYS", - "Metric", - "Platform", - "Provenance", "STANDARD_VERSION", "Tier", - "TiltSchedule", - "ValidationRecord", + "build_payload", "get_entry", "get_entry_ids", - "get_gates", - "get_required_grades", - "get_subsolar_latitude", "list_entries", ] diff --git a/src/tatc/catalog/loader.py b/src/tatc/catalog/loader.py index 33f1bfab..3c92f0c6 100644 --- a/src/tatc/catalog/loader.py +++ b/src/tatc/catalog/loader.py @@ -12,10 +12,13 @@ import functools import json import pathlib +from collections.abc import Sequence +from datetime import datetime import yaml -from .schemas import InstrumentEntry +from ..schemas.orbit import AllOrbits +from .schemas import InstrumentEntry, InstrumentPayload from .standard import InstrumentClass, Tier _RESOURCES = pathlib.Path(__file__).parents[1] / "resources" @@ -104,3 +107,85 @@ def list_entries( if (wanted_class is None or entry.instrument_class == wanted_class) and (wanted_tier is None or entry.validation.tier == wanted_tier) ] + + +def build_payload( + references: str | Sequence[str], + *, + orbit: AllOrbits, + time_step: float | None = None, + platform: str | None = None, + start: datetime | None = None, + end: datetime | None = None, +) -> InstrumentPayload: + """ + Builds the instruments of one or more catalog configurations for a + satellite that carries them together, with the attitude they share, to be + analyzed together. Each reference is the identifier of an entry (or of one + of its aliases), optionally with a configuration after a colon (such as + `"atms:swath_noaa_20"`), whose configuration is otherwise selected for the + platform (see `InstrumentEntry.select_configuration`). A configuration of + `alternatives` gives only the instrument it analyzes by default. + + Args: + references (str | Sequence[str]): The references. + orbit (AllOrbits): The orbit. + time_step (float | None): The analysis time step (seconds), for + configurations that tailor a field of view to it. + platform (str | None): The identifier of the platform modeled, if any. + start (datetime.datetime | None): The start of the analysis, for + configurations that schedule their tilt by day. + end (datetime.datetime | None): The end of the analysis, for + configurations that schedule their tilt by day. + + Returns: + InstrumentPayload: The instruments, with an `instrument_index` of 0 for + one instrument and `None` (analyzed together) for several. + + Raises: + KeyError: If an entry is unknown. + ValueError: If there are no references, or the configurations have + different attitudes. + """ + references = [references] if isinstance(references, str) else list(references) + if not references: + raise ValueError("a payload needs at least one catalog reference") + payloads = [] + for reference in references: + entry_id, _, configuration = reference.partition(":") + payloads.append( + get_entry(entry_id).build( + configuration=configuration or None, + orbit=orbit, + time_step=time_step, + platform=platform, + start=start, + end=end, + ) + ) + attitude = payloads[0].attitude + for payload in payloads[1:]: + if payload.attitude != attitude: + raise ValueError( + "the configurations have different attitudes, so they cannot be " + f"carried together: {references}" + ) + instruments = [ + instrument + for payload in payloads + for instrument in ( + payload.instruments + if payload.instrument_index is None + else payload.instruments[payload.instrument_index :][:1] + ) + ] + return InstrumentPayload( + instruments=instruments, + attitude=attitude, + instrument_index=0 if len(instruments) == 1 else None, + references=tuple(r for payload in payloads for r in payload.references), + transferred=any(payload.transferred for payload in payloads), + limitations=tuple( + dict.fromkeys(text for payload in payloads for text in payload.limitations) + ), + ) diff --git a/src/tatc/catalog/schemas.py b/src/tatc/catalog/schemas.py index 2c4d74ad..c1663a4f 100644 --- a/src/tatc/catalog/schemas.py +++ b/src/tatc/catalog/schemas.py @@ -12,13 +12,11 @@ import warnings from dataclasses import dataclass from datetime import date, datetime, time, timedelta, timezone -from typing import Any, Literal +from typing import Annotated, Any, Literal import numpy as np -from pydantic import BaseModel, ConfigDict, Field, model_validator -from skyfield.framelib import itrs +from pydantic import AfterValidator, BaseModel, ConfigDict, Field, model_validator -from .. import constants from ..schemas import ( Attitude, AttitudeSchedule, @@ -29,8 +27,14 @@ Satellite, TargetAttitude, ) +from ..schemas.orbit import AllOrbits from ..schemas.space.base import AllAttitudes -from ..utils import VelocityFrame, compute_along_track_field_of_view +from ..utils import ( + VelocityFrame, + compute_along_track_field_of_view, + compute_ascending_argument_of_latitude, + compute_subsolar_latitude, +) from .standard import ( MIN_HOLDOUT_GAP_DAYS, Gate, @@ -39,15 +43,28 @@ Tier, get_gates, get_required_grades, + is_compatible, ) +# the instrument schemas, by their `type` _INSTRUMENT_CLASSES: dict[str, type[Instrument]] = { - "instrument": Instrument, - "pointed": PointedInstrument, - "conical": ConicalInstrument, + cls.model_fields["type"].default: cls # pylint: disable=unsubscriptable-object + for cls in (Instrument, PointedInstrument, ConicalInstrument) } _TAILORED = {"tailor": "time_step"} _TAILORED_FIELD = "along_track_field_of_view" +# the provenance of parameters whose origin is the same in every configuration +_DEFAULT_PROVENANCE = { + _TAILORED_FIELD: { + "kind": "derived", + "source": "compute_along_track_field_of_view, from the orbit and time step", + }, + "is_swept": { + "kind": "derived", + "source": "Models the view as sweeping along track, so that its swaths are " + "the strips its cross-track line sweeps, as observations of points do", + }, +} # the attitudes that a configuration may give, by their `type` _ATTITUDE_TYPES = { "attitude": Attitude, @@ -56,6 +73,69 @@ } +def _parse_day(text: str) -> date: + """ + Parses an ISO 8601 date, or the UTC date of an ISO 8601 time with a zone. + """ + try: + return date.fromisoformat(text) + except ValueError: + moment = datetime.fromisoformat(text.replace("Z", "+00:00")) + if moment.tzinfo is None: + raise ValueError(f"the time {text!r} needs a time zone") from None + return moment.astimezone(timezone.utc).date() + + +def get_period_days(period: str) -> tuple[tuple[date, date], ...]: + """ + Gets the days of a period: one or more items separated by commas, each a + date or a time with a zone in ISO 8601 (such as `2026-10-02` or + `2026-10-03T12:00Z`), or a range of dates (`2026-08-15 to 2026-10-08`). + + Args: + period (str): The period. + + Returns: + tuple[tuple[datetime.date, datetime.date], ...]: The first and last day + (UTC) of each item. + + Raises: + ValueError: If the period is not of this form. + """ + intervals = [] + for item in period.split(","): + first, separator, last = item.strip().partition(" to ") + start = _parse_day(first) + end = _parse_day(last) if separator else start + if end < start: + raise ValueError(f"the range {item.strip()!r} ends before it starts") + intervals.append((start, end)) + return tuple(intervals) + + +def _check_period(period: str) -> str: + get_period_days(period) + return period + + +Period = Annotated[str, AfterValidator(_check_period)] +""" +A period of dates (see `get_period_days`), such as `2026-10-02`, +`2026-10-03T12:00Z`, `2026-08-15 to 2026-10-08`, or `2026-11-01, 2026-11-03`. +""" + + +def _get_days_apart(first: str, second: str) -> int: + """ + Gets the days between the nearest days of two periods (0 if they share one). + """ + return min( + max(0, (b_start - a_end).days, (a_start - b_end).days) + for a_start, a_end in get_period_days(first) + for b_start, b_end in get_period_days(second) + ) + + class _CatalogModel(BaseModel): """ Base class that rejects unknown fields, as catalog files are written by hand. @@ -76,27 +156,46 @@ class Provenance(_CatalogModel): + "values; or `placeholder`, without physical meaning.", ) source: str = Field(..., description="Where the value comes from.") - platform: str | None = Field( - default=None, description="The platform to which a measured value was fitted." + platforms: tuple[str, ...] | None = Field( + default=None, + min_length=1, + description="The platforms to whose data a measured value was fitted.", ) - period: str | None = Field( - default=None, description="The period to which a measured value was fitted." + period: Period | None = Field( + default=None, + description="The period of the data to which a measured value was fitted, " + + "from which the gap to the data of its tests is computed.", ) @model_validator(mode="after") def _check_measured(self) -> "Provenance": - if self.kind == "measured" and (self.platform is None or self.period is None): - raise ValueError("a measured value needs its platform and period") + if self.kind == "measured" and (self.platforms is None or self.period is None): + raise ValueError("a measured value needs its platforms and period") return self +def _check_provenance(described: set[str], provenance: dict[str, Any]) -> None: + """ + Checks that each value has a provenance. + """ + if described != set(provenance): + raise ValueError( + "each value needs provenance: " + f"{sorted(described.symmetric_difference(provenance))}" + ) + + class InstrumentSpecification(_CatalogModel): """ The class and parameters of an instrument, from which objects are constructed. + The provenance of an along-track field of view tailored to the time step and + of `is_swept` may be omitted, as it is the same in every configuration. """ - type: Literal["instrument", "pointed", "conical"] = Field( - ..., description="The instrument class." + type: str = Field( + ..., + description="The instrument class: `instrument`, `pointed`, or `conical` " + + "(the `type` of its schema).", ) parameters: dict[str, Any] = Field(..., description="The instrument's fields.") provenance: dict[str, Provenance] = Field( @@ -104,8 +203,28 @@ class InstrumentSpecification(_CatalogModel): description="The origin of each parameter, except for its name.", ) + @model_validator(mode="before") + @classmethod + def _add_default_provenance(cls, data: Any) -> Any: + if not isinstance(data, dict) or not isinstance(data.get("parameters"), dict): + return data + parameters, provenance = data["parameters"], dict(data.get("provenance", {})) + for field, default in _DEFAULT_PROVENANCE.items(): + applies = ( + parameters.get(field) == _TAILORED + if field == _TAILORED_FIELD + else field in parameters + ) + if applies and field not in provenance: + provenance[field] = default + return {**data, "provenance": provenance} + @model_validator(mode="after") def _check_parameters(self) -> "InstrumentSpecification": + if self.type not in _INSTRUMENT_CLASSES: + raise ValueError( + f"unknown instrument type {self.type!r}: {sorted(_INSTRUMENT_CLASSES)}" + ) fields = set(_INSTRUMENT_CLASSES[self.type].model_fields) - {"type"} if "velocity_frame" in self.parameters: raise ValueError( @@ -115,12 +234,7 @@ def _check_parameters(self) -> "InstrumentSpecification": unknown = set(self.parameters) - fields if unknown: raise ValueError(f"unknown {self.type} parameters: {sorted(unknown)}") - described = set(self.parameters) - {"name"} - if described != set(self.provenance): - raise ValueError( - "each parameter needs provenance: " - f"{sorted(described.symmetric_difference(self.provenance))}" - ) + _check_provenance(set(self.parameters) - {"name"}, self.provenance) if "name" not in self.parameters: raise ValueError("an instrument specification needs a name") if ( @@ -162,58 +276,6 @@ def construct_instrument(self, tailored_field_of_view: float | None) -> Instrume return _INSTRUMENT_CLASSES[self.type](**parameters) -def get_subsolar_latitude(at: datetime) -> float: - """ - Gets the subsolar latitude (degrees): the geocentric latitude of the Sun's - apparent direction, or its declination of date. - - Args: - at (datetime.datetime): The time (timezone-aware). - - Returns: - float: The subsolar latitude (degrees). - """ - t = constants.timescale.from_datetime(at) - x, y, z = ( - constants.de421["earth"] - .at(t) - .observe(constants.de421["sun"]) - .apparent() - .frame_xyz(itrs) - .m - ) - return float(np.degrees(np.arctan2(z, np.hypot(x, y)))) - - -def _get_ascending_argument_of_latitude( - latitude: float, altitude: float, inclination: float -) -> float: - """ - Gets the argument of latitude (degrees) at which a circular orbit, ascending, - passes over a geodetic latitude. - - Args: - latitude (float): The geodetic latitude (degrees) of the satellite. - altitude (float): The satellite's altitude (meters). - inclination (float): The orbit's inclination (degrees). - - Returns: - float: The argument of latitude (degrees, from 0 to 360). - """ - phi = np.radians(latitude) - e2 = constants.EARTH_ECCENTRICITY**2 - normal = constants.EARTH_EQUATORIAL_RADIUS / np.sqrt(1 - e2 * np.sin(phi) ** 2) - geocentric = np.arctan2( - (normal * (1 - e2) + altitude) * np.sin(phi), (normal + altitude) * np.cos(phi) - ) - ratio = np.sin(geocentric) / np.sin(np.radians(inclination)) - if abs(ratio) > 1: - raise ValueError( - f"an orbit inclined by {inclination} deg does not reach latitude {latitude}" - ) - return float(np.mod(np.degrees(np.arcsin(ratio)), 360)) - - class TiltSchedule(_CatalogModel): """ A pitch of the body that changes between aft and fore twice an orbit, on a @@ -279,12 +341,9 @@ class TiltSchedule(_CatalogModel): @model_validator(mode="after") def _check_provenance(self) -> "TiltSchedule": - described = set(type(self).model_fields) - {"provenance"} - if described != set(self.provenance): - raise ValueError( - "each value needs provenance: " - f"{sorted(described.symmetric_difference(self.provenance))}" - ) + _check_provenance( + set(type(self).model_fields) - {"provenance"}, self.provenance + ) return self def get_switch_latitude(self, day: date) -> float: @@ -304,10 +363,10 @@ def get_switch_latitude(self, day: date) -> float: if day.timetuple().tm_yday % 2 == 1 else self.even_day_offset ) - return get_subsolar_latitude(noon) + offset + return compute_subsolar_latitude(noon) + offset def get_pitch_angle_profile( - self, day: date, orbit: Any + self, day: date, orbit: AllOrbits ) -> list[tuple[float, float]]: """ Gets the pitch angle profile of a day, as (argument of latitude, pitch angle) @@ -315,7 +374,7 @@ def get_pitch_angle_profile( Args: day (datetime.date): The day (UTC). - orbit (Any): The orbit. + orbit (AllOrbits): The orbit. Returns: list[tuple[float, float]]: The profile. @@ -334,7 +393,7 @@ def get_pitch_angle_profile( ) def get_blind_intervals( - self, day: date, orbit: Any + self, day: date, orbit: AllOrbits ) -> list[tuple[float, float]] | None: """ Gets the intervals of argument of latitude (degrees) of a day in which the @@ -342,7 +401,7 @@ def get_blind_intervals( Args: day (datetime.date): The day (UTC). - orbit (Any): The orbit. + orbit (AllOrbits): The orbit. Returns: list[tuple[float, float]] | None: The (start, end) pairs, or `None` if @@ -362,12 +421,12 @@ def get_blind_intervals( ) ) - def _get_switch_argument_of_latitude(self, day: date, orbit: Any) -> float: + def _get_switch_argument_of_latitude(self, day: date, orbit: AllOrbits) -> float: """ Gets the argument of latitude (degrees) of the middle of the change from aft to fore on a day. """ - return _get_ascending_argument_of_latitude( + return compute_ascending_argument_of_latitude( self.get_switch_latitude(day), orbit.get_mean_altitude(), orbit.get_inclination(), @@ -375,7 +434,7 @@ def _get_switch_argument_of_latitude(self, day: date, orbit: Any) -> float: def build_schedule( self, - orbit: Any, + orbit: AllOrbits, start: datetime, end: datetime, velocity_frame: VelocityFrame, @@ -386,7 +445,7 @@ def build_schedule( end of an analysis. Args: - orbit (Any): The orbit. + orbit (AllOrbits): The orbit. start (datetime.datetime): The start of the analysis (timezone-aware). end (datetime.datetime): The end of the analysis (timezone-aware). velocity_frame (VelocityFrame): The velocity frame of the attitude. @@ -430,7 +489,7 @@ class Configuration(_CatalogModel): default_factory=dict, description="Other fields of the attitude of the space system.", ) - attitude_schedule: TiltSchedule | None = Field( + tilt_schedule: TiltSchedule | None = Field( default=None, description="A pitch of the body that changes by day, from which a " + "schedule of attitudes is built for the period of an analysis.", @@ -441,7 +500,8 @@ class Configuration(_CatalogModel): instrument_index: int = Field( default=0, ge=0, - description="The index of the instrument to analyze by default.", + description="The index of the instrument to analyze by default, of " + + "`alternatives`.", ) grouping: Literal["single", "union", "alternatives"] = Field( default="single", @@ -461,17 +521,18 @@ def _check_instruments(self) -> "Configuration": raise ValueError(f"instrument names must be unique: {names}") if self.instrument_index >= len(self.instruments): raise ValueError("instrument_index is out of range") + if self.instrument_index and self.grouping != "alternatives": + raise ValueError("only alternatives have an instrument_index") if (self.grouping == "single") != (len(self.instruments) == 1): raise ValueError("grouping is `single` only for one instrument") self.make_attitude() - if self.attitude_schedule is not None and { + if self.tilt_schedule is not None and { "pitch_angle", "pitch_angle_profile", "blind_intervals", } & set(self.attitude): raise ValueError( - "an attitude schedule sets the pitch and blind intervals of the " - "attitude" + "a tilt schedule sets the pitch and blind intervals of the attitude" ) return self @@ -487,19 +548,43 @@ def make_attitude(self) -> Attitude | GlintAttitude | TargetAttitude: kind = _ATTITUDE_TYPES[fields.pop("type", "attitude")] return kind(velocity_frame=self.velocity_frame, **fields) - @property - def is_fitted(self) -> bool: + def _get_measured(self) -> list[Provenance]: """ - Whether any parameter was fitted to reference data. + Gets the provenance of the values fitted to reference data. """ provenances = [ provenance for instrument in self.instruments for provenance in instrument.provenance.values() ] - if self.attitude_schedule is not None: - provenances += list(self.attitude_schedule.provenance.values()) - return any(provenance.kind == "measured" for provenance in provenances) + if self.tilt_schedule is not None: + provenances += list(self.tilt_schedule.provenance.values()) + return [ + provenance for provenance in provenances if provenance.kind == "measured" + ] + + @property + def is_fitted(self) -> bool: + """ + Whether any parameter was fitted to reference data. + """ + return bool(self._get_measured()) + + def get_holdout_gap(self, period: str) -> int | None: + """ + Gets the days between the data to which values were fitted and the data + of a test: between the nearest days of the periods. + + Args: + period (str): The period of the data of the test (see `Period`). + + Returns: + int | None: The days, or `None` if no value was fitted. + """ + measured = self._get_measured() + if not measured: + return None + return min(_get_days_apart(p.period, period) for p in measured) @property def digest(self) -> str: @@ -514,13 +599,32 @@ def digest(self) -> str: {"type": i.type, "parameters": i.parameters} for i in self.instruments ], } - if self.attitude_schedule is not None: - content["attitude_schedule"] = self.attitude_schedule.model_dump( + if self.tilt_schedule is not None: + # keyed as when the field was named `attitude_schedule`, so that the + # digests of the records stay those of the configurations they tested + content["attitude_schedule"] = self.tilt_schedule.model_dump( mode="json", exclude={"provenance"} ) encoded = json.dumps(content, sort_keys=True, separators=(",", ":")) return hashlib.sha256(encoded.encode("utf-8")).hexdigest() + def serves(self, grade: Grade | str) -> bool: + """ + Checks whether this configuration serves a use: its grade, or the + coverage grade for a configuration at the timing grade, which also tests + coverage. + + Args: + grade (Grade | str): The grade of the use. + + Returns: + bool: `True`, if it serves the use. + """ + grade = Grade(grade) + return self.grade == grade or ( + grade == Grade.COVERAGE and self.grade == Grade.TIMING + ) + class Platform(_CatalogModel): """ @@ -562,34 +666,45 @@ class Metric(_CatalogModel): name: str = Field(..., description="The metric (see `get_gates`).") value: float = Field(..., description="The value.") scope: str | None = Field( - default=None, description="What it applies to, if not the whole configuration." + default=None, + description="The part or condition of the test it applies to (such as an " + + "instrument or a time step), if not all of it. A gate takes the worst " + + "value of its metric over scopes.", ) +class Transfer(_CatalogModel): + """ + The results of a configuration on a platform on which it was not tested, + which do not count toward its validation. + """ + + period: Period = Field(..., description="The period of the reference data.") + metrics: tuple[Metric, ...] = Field(..., min_length=1, description="The results.") + + class ConfigurationRecord(_CatalogModel): """ The results of validating a configuration, written by a validation script. """ digest: str = Field(..., description="The `Configuration.digest` tested.") - evidence: Literal["rerun", "reported"] = Field( - ..., - description="`rerun`, computed with the configuration's exact values " - + "through public methods; or `reported`, taken from the outputs of a " - + "notebook that did not use them exactly.", + standard_version: int = Field( + ..., description="The `STANDARD_VERSION` of the test." ) tatc_version: str = Field(..., description="The version of TAT-C tested.") - source: str = Field(..., description="The notebook or script of the results.") + source: str = Field(..., description="The script of the results.") reference: str = Field(..., description="The reference data.") - period: str = Field(..., description="The period of the reference data.") - platform: str = Field(..., description="The platform of the reference data.") - holdout_gap_days: float | None = Field( - default=None, - description="For fitted values, the days between their fitting data and " - + "the reference data of these metrics, or `None` if tested on the " - + "fitting data.", + period: Period = Field(..., description="The period of the reference data.") + platforms: tuple[str, ...] = Field( + ..., min_length=1, description="The platforms of the reference data." ) metrics: tuple[Metric, ...] = Field(..., description="The results.") + transfers: dict[str, Transfer] = Field( + default_factory=dict, + description="Results on platforms on which the configuration was not " + + "tested, by platform.", + ) fixture_metrics: dict[str, float] = Field( default_factory=dict, description="Results from the reduced test fixture, which detect " @@ -604,7 +719,6 @@ class ValidationRecord(_CatalogModel): """ entry_id: str = Field(..., description="The identifier of the entry.") - standard_version: int = Field(..., description="The `STANDARD_VERSION` applied.") configurations: dict[str, ConfigurationRecord] = Field( ..., description="The results of each configuration." ) @@ -630,13 +744,16 @@ def passed(self) -> bool | None: @dataclass(frozen=True) class ConfigurationValidation: """ - The validation status of a configuration. + The validation status of a configuration. Its `holdout_gap_days` are the + days between the data to which its values were fitted and the data of its + test, or `None` if it has no fitted values or no test. """ tier: Tier gates: tuple[GateResult, ...] gaps: tuple[str, ...] record: ConfigurationRecord | None + holdout_gap_days: int | None = None @dataclass(frozen=True) @@ -653,15 +770,19 @@ class EntryValidation: @dataclass(frozen=True) class InstrumentPayload: """ - Instruments with the attitude and analysis settings that they were validated - with, which must be used together. + Instruments with the attitude that they were validated with, which must be + used together. Analyze them with the `instrument_index`: of the instrument + to analyze, or `None` to analyze the instruments together (as the parts of + one view). """ instruments: list[Instrument] - attitude: Any - instrument_index: int - grouping: str + attitude: AllAttitudes | AttitudeSchedule | None + instrument_index: int | None + references: tuple[str, ...] + """The configurations, as `entry:configuration`.""" transferred: bool + """Whether a configuration was not tested on the platform modeled.""" limitations: tuple[str, ...] @@ -712,6 +833,18 @@ def _check_references(self) -> "InstrumentEntry": unknown = set(self.record.configurations) - set(self.configurations) if unknown: raise ValueError(f"records of unknown {sorted(unknown)}") + for key, record in self.record.configurations.items(): + tested = set(self.configurations[key].platforms) + if not set(record.platforms) <= tested: + raise ValueError( + f"{key}: the record's platforms {list(record.platforms)} " + f"are not those tested, {sorted(tested)}" + ) + transferred = set(record.transfers) + if transferred & tested or not transferred <= platforms: + raise ValueError( + f"{key}: transfers must be to other platforms of the entry" + ) return self def _evaluate_configuration(self, key: str) -> ConfigurationValidation: @@ -752,12 +885,13 @@ def _evaluate_configuration(self, key: str) -> ConfigurationValidation: ] if record.digest != configuration.digest: gaps.append("the configuration changed after it was tested") - if record.evidence != "rerun": - gaps.append("results are not reproduced with its exact values") - if configuration.is_fitted and ( - record.holdout_gap_days is None - or record.holdout_gap_days < MIN_HOLDOUT_GAP_DAYS - ): + if not is_compatible(self.instrument_class, record.standard_version): + gaps.append( + f"version {record.standard_version} of the standard, of the test, " + f"does not apply to the {self.instrument_class.value} class" + ) + holdout = configuration.get_holdout_gap(record.period) + if holdout is not None and holdout < MIN_HOLDOUT_GAP_DAYS: gaps.append( "fitted values are not tested on data at least " f"{MIN_HOLDOUT_GAP_DAYS} days from their fitting data" @@ -767,6 +901,7 @@ def _evaluate_configuration(self, key: str) -> ConfigurationValidation: tuple(results), tuple(gaps), record, + holdout, ) @property @@ -779,16 +914,12 @@ def validation(self) -> EntryValidation: configurations = { key: self._evaluate_configuration(key) for key in self.configurations } - grades = {configuration.grade for configuration in self.configurations.values()} - if Grade.TIMING in grades: - grades.add(Grade.COVERAGE) gaps = [ f"no configuration at the {grade.value} grade" for grade in get_required_grades(self.instrument_class) - if grade not in grades + if not any(c.serves(grade) for c in self.configurations.values()) ] - order = [Tier.NOMINAL, Tier.PARTIAL, Tier.VALIDATED] - tier = min((c.tier for c in configurations.values()), key=order.index) + tier = min((c.tier for c in configurations.values()), key=lambda t: t.rank) if tier == Tier.VALIDATED and gaps: tier = Tier.PARTIAL if tier == Tier.NOMINAL and any( @@ -797,13 +928,75 @@ def validation(self) -> EntryValidation: tier = Tier.PARTIAL return EntryValidation(tier, configurations, tuple(gaps)) - def build( + def select_configuration( self, configuration: str | None = None, *, - orbit: Any = None, + grade: Grade | str | None = None, + platform: str | None = None, + ) -> str: + """ + Selects a configuration: the one named, or else one that serves a use + (see `Configuration.serves`) and was tested on a platform, preferring + the default configuration and then those at the grade of the default. + Without a configuration tested on the platform, it selects among the + others (a transfer, on which `build` warns). + + Args: + configuration (str | None): The identifier of the configuration, or + `None` to select one. + grade (Grade | str | None): The grade of the use, if any. + platform (str | None): The identifier of the platform modeled, if + any. + + Returns: + str: The identifier of the configuration. + + Raises: + ValueError: If the configuration is unknown, or none serves the use. + """ + if configuration is not None: + if configuration not in self.configurations: + raise ValueError( + f"unknown configuration {configuration!r} of {self.id!r}: " + f"{sorted(self.configurations)}" + ) + if grade is not None and not self.configurations[configuration].serves( + grade + ): + raise ValueError( + f"configuration {configuration!r} of {self.id!r} is at the " + f"{self.configurations[configuration].grade.value} grade" + ) + return configuration + candidates = [ + key + for key, c in self.configurations.items() + if grade is None or c.serves(grade) + ] + if not candidates: + raise ValueError( + f"{self.id!r} has no configuration at the {Grade(grade).value} grade" + ) + tested = [k for k in candidates if platform in self.configurations[k].platforms] + candidates = tested or candidates + default = self.configurations[self.default_configuration] + return min( + candidates, + key=lambda k: ( + k != self.default_configuration, + self.configurations[k].grade != default.grade, + ), + ) + + def build( + self, + *, + configuration: str | None = None, + grade: Grade | str | None = None, + orbit: AllOrbits | None = None, time_step: float | None = None, - attitude: Any = None, + attitude: AllAttitudes | AttitudeSchedule | None = None, platform: str | None = None, start: datetime | None = None, end: datetime | None = None, @@ -814,37 +1007,37 @@ def build( Args: configuration (str | None): The identifier of the configuration, or - `None` for the default. - orbit (Any): The orbit, if the configuration tailors a field of view - to a time step or schedules its attitude. + `None` to select one by grade and platform (see + `select_configuration`), by default the default configuration. + grade (Grade | str | None): The grade of the use, if any. + orbit (AllOrbits | None): The orbit, if the configuration tailors a + field of view to a time step or schedules its tilt. time_step (float | None): The analysis time step (seconds), if the configuration tailors a field of view to it. - attitude (Any): An attitude to use instead of the validated one (for - example, a schedule of yaw flips), in the same velocity frame. - platform (str | None): The identifier of the platform being modeled, - if any. Using a configuration on a platform on which it was not - tested gives a warning. + attitude (AllAttitudes | AttitudeSchedule | None): An attitude to use + instead of the validated one (for example, a schedule of yaw + flips), in the same velocity frame. + platform (str | None): The identifier of the platform modeled, if + any, which selects the configuration tested on it. Using a + configuration on a platform on which it was not tested gives a + warning. start (datetime.datetime | None): The start of the analysis - (timezone-aware), if the configuration schedules its attitude - by day. + (timezone-aware), if the configuration schedules its tilt by + day. end (datetime.datetime | None): The end of the analysis - (timezone-aware), if the configuration schedules its attitude - by day. + (timezone-aware), if the configuration schedules its tilt by + day. Returns: InstrumentPayload: The instruments, attitude, and analysis settings. Raises: - ValueError: If the configuration is unknown, tailoring lacks an - orbit or time step, a schedule lacks an orbit or the period of - the analysis, or an attitude has another velocity frame. + ValueError: If the configuration is unknown or does not serve the + grade, tailoring lacks an orbit or time step, a schedule lacks + an orbit or the period of the analysis, or an attitude has + another velocity frame. """ - key = self.default_configuration if configuration is None else configuration - if key not in self.configurations: - raise ValueError( - f"unknown configuration {key!r} of {self.id!r}: " - f"{sorted(self.configurations)}" - ) + key = self.select_configuration(configuration, grade=grade, platform=platform) selected = self.configurations[key] tailored = None if any(instrument.is_tailored for instrument in selected.instruments): @@ -866,17 +1059,13 @@ def build( f"{list(selected.platforms)}, not on {platform!r}", stacklevel=2, ) - if ( - selected.attitude_schedule is not None - and attitude is None - and (orbit is None or start is None or end is None) - ): - raise ValueError( - f"configuration {key!r} of {self.id!r} schedules its attitude by " - "day, which needs an orbit and the start and end of the analysis" - ) - if attitude is None and selected.attitude_schedule is not None: - attitude = selected.attitude_schedule.build_schedule( + if attitude is None and selected.tilt_schedule is not None: + if orbit is None or start is None or end is None: + raise ValueError( + f"configuration {key!r} of {self.id!r} schedules its tilt by " + "day, which needs an orbit and the start and end of the analysis" + ) + attitude = selected.tilt_schedule.build_schedule( orbit, start, end, selected.velocity_frame, selected.attitude ) return InstrumentPayload( @@ -885,24 +1074,30 @@ def build( for instrument in selected.instruments ], attitude=self._build_attitude(selected, attitude), - instrument_index=selected.instrument_index, - grouping=selected.grouping, + instrument_index=( + None if selected.grouping == "union" else selected.instrument_index + ), + references=(f"{self.id}:{key}",), transferred=transferred, limitations=(*self.limitations, *selected.limitations), ) @staticmethod - def _build_attitude(selected: Configuration, attitude: Any) -> AllAttitudes | None: + def _build_attitude( + selected: Configuration, attitude: AllAttitudes | AttitudeSchedule | None + ) -> AllAttitudes | AttitudeSchedule | None: """ Gets the attitude of a configuration, or checks one that replaces it. Args: selected (Configuration): The configuration. - attitude (Any): The replacement, or `None`. + attitude (AllAttitudes | AttitudeSchedule | None): The replacement, + or `None`. Returns: - AllAttitudes | None: The attitude, or `None` for a body aligned with - the nadir frame (as for an Earth-fixed frame without other fields). + AllAttitudes | AttitudeSchedule | None: The attitude, or `None` for a + body aligned with the nadir frame (as for an Earth-fixed frame + without other fields). Raises: ValueError: If the replacement has another velocity frame. @@ -929,41 +1124,45 @@ def _build_attitude(selected: Configuration, attitude: Any) -> AllAttitudes | No def to_satellite( self, - orbit: Any, - configuration: str | None = None, + orbit: AllOrbits, *, + configuration: str | None = None, + grade: Grade | str | None = None, time_step: float | None = None, - attitude: Any = None, + attitude: AllAttitudes | AttitudeSchedule | None = None, platform: str | None = None, name: str | None = None, start: datetime | None = None, end: datetime | None = None, ) -> Satellite: """ - Builds a satellite that carries the instruments of a configuration. To - analyze an instrument other than the first, use the `instrument_index` - of `build` in analysis methods. + Builds a satellite that carries the instruments of a configuration (see + `build`). Analyze it with the `instrument_index` of `build`, which is 0 + for a configuration of one instrument. Args: - orbit (Any): The orbit. + orbit (AllOrbits): The orbit. configuration (str | None): The identifier of the configuration, or - `None` for the default. + `None` to select one by grade and platform. + grade (Grade | str | None): The grade of the use, if any. time_step (float | None): The analysis time step (seconds), if the configuration tailors a field of view to it. - attitude (Any): An attitude to use instead of the validated one. - platform (str | None): The identifier of the platform being modeled. + attitude (AllAttitudes | AttitudeSchedule | None): An attitude to use + instead of the validated one. + platform (str | None): The identifier of the platform modeled. name (str | None): The satellite's name, or `None` for the instrument's. start (datetime.datetime | None): The start of the analysis, if the - configuration schedules its attitude by day. + configuration schedules its tilt by day. end (datetime.datetime | None): The end of the analysis, if the - configuration schedules its attitude by day. + configuration schedules its tilt by day. Returns: Satellite: The satellite. """ payload = self.build( - configuration, + configuration=configuration, + grade=grade, orbit=orbit, time_step=time_step, attitude=attitude, diff --git a/src/tatc/catalog/standard.py b/src/tatc/catalog/standard.py index 3d204c3e..8c172f36 100644 --- a/src/tatc/catalog/standard.py +++ b/src/tatc/catalog/standard.py @@ -16,11 +16,27 @@ STANDARD_VERSION = 6 """The version of the thresholds in `get_gates`.""" -COMPATIBLE_VERSIONS = (1, 2, 3, 4, 5, 6) +_LAST_THRESHOLD_CHANGE = 1 +# the version of the standard that added each class's gates +_CLASS_VERSIONS = { + "cross_track": 1, + "pushbroom": 1, + "conical": 1, + "sar": 1, + "geostationary": 1, + "lidar": 2, + "altimeter": 3, + "scatterometer": 4, + "geostationary_regional": 5, + "profiler": 6, +} + +COMPATIBLE_VERSIONS = tuple(range(_LAST_THRESHOLD_CHANGE, STANDARD_VERSION + 1)) """ -Versions whose results still apply: version 2 only added the lidar class, version 3 -the altimeter class, version 4 the scatterometer class, version 5 the regional -geostationary class, and version 6 the profiler class. +Versions whose results still apply, as no threshold changed after the first: +version 2 only added the lidar class, version 3 the altimeter class, version 4 +the scatterometer class, version 5 the regional geostationary class, and +version 6 the profiler class. """ MIN_HOLDOUT_GAP_DAYS = 30 @@ -67,7 +83,14 @@ class Tier(str, Enum): PARTIAL = "partial" """Some gates are unmet or untested, or the evidence is incomplete.""" VALIDATED = "validated" - """All applicable gates pass, with evidence reproduced with exact parameters.""" + """All applicable gates pass, with results of the configuration as cataloged.""" + + @property + def rank(self) -> int: + """ + The strength of the tier, from 0 (`nominal`) to 2 (`validated`). + """ + return list(Tier).index(self) @dataclass(frozen=True) @@ -117,7 +140,7 @@ def is_met(self, value: float) -> bool: # field of regard with the area imaged in a scan of a region _FIELD_OF_REGARD_IOU = Gate("field_of_regard_iou", 0.95, False, "") -# gates that do not depend on the epoch accuracy of a grade +# gates of the coverage and timing grades that do not depend on epoch accuracy _SWEEP_GATES: dict[InstrumentClass, tuple[Gate, ...]] = { InstrumentClass.CROSS_TRACK: (_PASS_RECALL, _PASS_PRECISION, _SWATH_WIDTH, _IOU), # the acquisitions of pushbroom imagers and SAR follow plans, so predicted @@ -144,9 +167,22 @@ def is_met(self, value: float) -> bool: _IOU_SAR_LOW, ), } -_SAMPLE_GATES: dict[InstrumentClass, tuple[Gate, ...]] = { - InstrumentClass.CROSS_TRACK: (_SAMPLE_SIZE, _PIXEL_POSITION), - InstrumentClass.CONICAL: (_SAMPLE_SIZE,), + +# the gates of each class at each of its grades +_GATES: dict[tuple[InstrumentClass, Grade], tuple[Gate, ...]] = { + **{ + (instrument_class, grade): (*gates, epoch) + for instrument_class, gates in _SWEEP_GATES.items() + for grade, epoch in ( + (Grade.COVERAGE, _EPOCH_COVERAGE), + (Grade.TIMING, _EPOCH_TIMING), + ) + }, + # geostationary instruments have only a coverage grade + (InstrumentClass.GEOSTATIONARY, Grade.COVERAGE): (_PRODUCT_LIMIT,), + (InstrumentClass.GEOSTATIONARY_REGIONAL, Grade.COVERAGE): (_FIELD_OF_REGARD_IOU,), + (InstrumentClass.CROSS_TRACK, Grade.SAMPLE_SIZE): (_SAMPLE_SIZE, _PIXEL_POSITION), + (InstrumentClass.CONICAL, Grade.SAMPLE_SIZE): (_SAMPLE_SIZE,), } @@ -164,28 +200,20 @@ def get_gates(instrument_class: InstrumentClass, grade: Grade) -> tuple[Gate, .. Raises: ValueError: If the class is not validated at the grade. """ - if instrument_class == InstrumentClass.GEOSTATIONARY: - if grade != Grade.COVERAGE: - raise ValueError("geostationary instruments have only a coverage grade") - return (_PRODUCT_LIMIT,) - if instrument_class == InstrumentClass.GEOSTATIONARY_REGIONAL: - if grade != Grade.COVERAGE: - raise ValueError( - "regional geostationary instruments have only a coverage grade" - ) - return (_FIELD_OF_REGARD_IOU,) - if grade == Grade.SAMPLE_SIZE: - if instrument_class not in _SAMPLE_GATES: - raise ValueError(f"{instrument_class.value} has no sample_size grade") - return _SAMPLE_GATES[instrument_class] - epoch = _EPOCH_TIMING if grade == Grade.TIMING else _EPOCH_COVERAGE - return (*_SWEEP_GATES[instrument_class], epoch) + instrument_class, grade = InstrumentClass(instrument_class), Grade(grade) + if (instrument_class, grade) not in _GATES: + grades = [g.value for c, g in _GATES if c == instrument_class] + raise ValueError( + f"{instrument_class.value} has no {grade.value} grade, only {grades}" + ) + return _GATES[instrument_class, grade] def get_required_grades(instrument_class: InstrumentClass) -> tuple[Grade, ...]: """ - Gets the grades that an entry needs to be validated. Any one of the coverage - and timing grades suffices, as timing also tests coverage. + Gets the grades that an entry needs to be validated: the coverage grade, and + the sample size grade if its class has one. A configuration at the timing + grade also meets the coverage grade, as timing also tests coverage. Args: instrument_class (InstrumentClass): The class of the instrument. @@ -193,6 +221,26 @@ def get_required_grades(instrument_class: InstrumentClass) -> tuple[Grade, ...]: Returns: tuple[Grade, ...]: The required grades. """ - if instrument_class in _SAMPLE_GATES: - return (Grade.COVERAGE, Grade.SAMPLE_SIZE) - return (Grade.COVERAGE,) + return tuple( + grade + for grade in (Grade.COVERAGE, Grade.SAMPLE_SIZE) + if (InstrumentClass(instrument_class), grade) in _GATES + ) + + +def is_compatible(instrument_class: InstrumentClass, version: int) -> bool: + """ + Checks whether results tested under a version of the standard apply to a + class: the version is compatible and has the class's gates. + + Args: + instrument_class (InstrumentClass): The class of the instrument. + version (int): The version of the standard. + + Returns: + bool: `True`, if the results apply. + """ + return ( + version in COMPATIBLE_VERSIONS + and version >= _CLASS_VERSIONS[InstrumentClass(instrument_class).value] + ) diff --git a/src/tatc/resources/instruments/ahi.yml b/src/tatc/resources/instruments/ahi.yml index ba1840d9..f45941b4 100644 --- a/src/tatc/resources/instruments/ahi.yml +++ b/src/tatc/resources/instruments/ahi.yml @@ -46,7 +46,7 @@ configurations: field_of_regard: kind: measured source: validate_catalog_ahi.py --fit, compute_field_of_regard(35785863, 90 - 79.3798), from the greatest local zenith angle at which the cloud top height is retrieved at full resolution, with the fixed grid's nominal position - platform: himawari-9 + platforms: [himawari-9] period: "2026-10-01T12:00Z" limitations: - The product declares no bound of local zenith angle; the bound is measured as the greatest angle at which it retrieves a height, which it does only for cloudy pixels. diff --git a/src/tatc/resources/instruments/airs.yml b/src/tatc/resources/instruments/airs.yml index af644503..b45dd1a7 100644 --- a/src/tatc/resources/instruments/airs.yml +++ b/src/tatc/resources/instruments/airs.yml @@ -35,10 +35,6 @@ configurations: kind: nominal source: The outermost of AIRS's 90 footprints, spaced 1.1 deg, are 48.95 deg from nadir cross_track_field_of_view: *nominal_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view diff --git a/src/tatc/resources/instruments/amsr2.yml b/src/tatc/resources/instruments/amsr2.yml index cd9d11fc..ea427b4d 100644 --- a/src/tatc/resources/instruments/amsr2.yml +++ b/src/tatc/resources/instruments/amsr2.yml @@ -33,13 +33,10 @@ configurations: cone_angle: &measured kind: measured source: validate_catalog_amsr2.py --fit, medians over every 20th scan of the 10.65 GHz group (printed to 3 decimals), first measured in ValidateConicalAMSR2 on the 49,695 scans then archived; the 57,606 scans archived since give a half width of 75.333 - platform: gcom-w + platforms: [gcom-w] period: "2026-09-26" scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: &tailored - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step limitations: - The 89 GHz samples (groups S5 and S6) were not used to fit the scan, which assumes they share the cone and sector of the 10.65 GHz samples. sample_size: @@ -62,14 +59,13 @@ configurations: cone_angle: *measured scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: *tailored beam_width: &beam_width kind: nominal source: JAXA AMSR2 channel set (beam width) scan_sample_spacing: kind: measured source: validate_catalog_amsr2.py --fit, the median azimuth step between the 243 samples of the 10.65 GHz group - platform: gcom-w + platforms: [gcom-w] period: "2026-09-26" - type: conical parameters: @@ -105,7 +101,6 @@ configurations: cone_angle: *measured scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: *tailored beam_width: *beam_width scan_sample_spacing: kind: derived diff --git a/src/tatc/resources/instruments/amsua.yml b/src/tatc/resources/instruments/amsua.yml index 9aba915a..886cfc4d 100644 --- a/src/tatc/resources/instruments/amsua.yml +++ b/src/tatc/resources/instruments/amsua.yml @@ -35,10 +35,6 @@ configurations: kind: nominal source: The outermost of AMSU-A's 30 footprints, spaced 3.333 deg, are 48.33 deg from nadir cross_track_field_of_view: *nominal_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view diff --git a/src/tatc/resources/instruments/ascat.yml b/src/tatc/resources/instruments/ascat.yml index 13f3a1d2..0fb82f1b 100644 --- a/src/tatc/resources/instruments/ascat.yml +++ b/src/tatc/resources/instruments/ascat.yml @@ -35,13 +35,9 @@ configurations: roll_angle: &left kind: measured source: validate_catalog_ascat.py --fit, the mean of the median look angles of the inner and outer bounds of the cells of 2,304 rows (23.4862 and 44.8449 deg) - platform: metop-c + platforms: [metop-c] period: "2026-10-05" cross_track_field_of_view: *left - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: &tailored - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: &rectangular kind: derived source: Models the swath of each row of cells as a rectangular view @@ -57,11 +53,9 @@ configurations: roll_angle: &right kind: measured source: validate_catalog_ascat.py --fit, the mean of the median look angles of the inner and outer bounds of the cells of 2,304 rows (-23.4851 and -44.8447 deg) - platform: metop-c + platforms: [metop-c] period: "2026-10-05" cross_track_field_of_view: *right - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular limitations: - The swaths are those of the 25 km wind vector cells, each of which ASCAT's fore, mid, and aft beams observe at different times, the fore and aft beams (45 deg ahead of and behind the mid beam) about one to two minutes before and after, by the swaths' distance from the ground track (about 370 to 850 km); a cell's epoch is that of its row. diff --git a/src/tatc/resources/instruments/atlas.yml b/src/tatc/resources/instruments/atlas.yml index 2c289b58..b8aa38de 100644 --- a/src/tatc/resources/instruments/atlas.yml +++ b/src/tatc/resources/instruments/atlas.yml @@ -35,13 +35,9 @@ configurations: roll_angle: &measured kind: measured source: validate_catalog_atlas.py --fit, the median and spread (99.5th percentile) of the pair's offsets from the ground track over Antarctica - platform: icesat-2 + platforms: [icesat-2] period: "2026-10-01" cross_track_field_of_view: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: &tailored - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: &rectangular kind: derived source: Models the band containing a pair's track as a rectangular view @@ -56,8 +52,6 @@ configurations: provenance: roll_angle: *measured cross_track_field_of_view: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -70,8 +64,6 @@ configurations: provenance: roll_angle: *measured cross_track_field_of_view: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular limitations: - Each view is about 4.9 km wide, whereas a beam's footprint is about 11 m wide. The width holds the error of an element set a few days old (about 2.5 days at the fit), so a view shows where a pair may observe, not the area it observes. Older element sets need wider views. diff --git a/src/tatc/resources/instruments/atlid.yml b/src/tatc/resources/instruments/atlid.yml index 02078fca..a3d78ad8 100644 --- a/src/tatc/resources/instruments/atlid.yml +++ b/src/tatc/resources/instruments/atlid.yml @@ -42,13 +42,9 @@ configurations: roll_angle: &measured kind: measured source: validate_catalog_atlid.py --fit, the median angles of the profiles from the geodetic nadir across and along the ground track (Earth-fixed frame), from the recorded sensor positions - platform: earthcare + platforms: [earthcare] period: "2026-09-27" pitch_angle: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models the band along the track as a rectangular view diff --git a/src/tatc/resources/instruments/atms.yml b/src/tatc/resources/instruments/atms.yml index 5260f8a4..8765ce74 100644 --- a/src/tatc/resources/instruments/atms.yml +++ b/src/tatc/resources/instruments/atms.yml @@ -39,13 +39,9 @@ configurations: field_of_regard: &measured_extent kind: measured source: ValidateImagerATMS, Test 2, between the outermost beams (printed to 4 decimals) - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" cross_track_field_of_view: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view @@ -76,7 +72,7 @@ configurations: field_of_regard: &measured_spacing kind: measured source: ValidateImagerATMS, Test 2, a fitted spacing of 1.112 deg over 96 beams - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" cross_track_field_of_view: *measured_spacing along_track_field_of_view: *measured_spacing @@ -86,7 +82,7 @@ configurations: roll_angle: kind: measured source: ValidateImagerATMS, Test 2, the fitted roll - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" is_rectangular: kind: derived @@ -135,13 +131,9 @@ configurations: field_of_regard: &noaa_21_extent kind: measured source: validate_catalog_atms.py --fit, between the outermost beams (52.6252 deg left, 52.8073 deg right) - platform: noaa-21 + platforms: [noaa-21] period: "2026-11-05" cross_track_field_of_view: *noaa_21_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view @@ -173,7 +165,7 @@ configurations: field_of_regard: &noaa_21_spacing kind: measured source: validate_catalog_atms.py --fit, a fitted spacing of 1.10981 deg over 96 beams - platform: noaa-21 + platforms: [noaa-21] period: "2026-11-05" cross_track_field_of_view: *noaa_21_spacing along_track_field_of_view: *noaa_21_spacing @@ -183,7 +175,7 @@ configurations: roll_angle: kind: measured source: validate_catalog_atms.py --fit, the fitted roll - platform: noaa-21 + platforms: [noaa-21] period: "2026-11-05" is_rectangular: kind: derived diff --git a/src/tatc/resources/instruments/avhrr.yml b/src/tatc/resources/instruments/avhrr.yml index 219811f8..3f54364e 100644 --- a/src/tatc/resources/instruments/avhrr.yml +++ b/src/tatc/resources/instruments/avhrr.yml @@ -41,13 +41,9 @@ configurations: field_of_regard: &measured_extent kind: measured source: validate_catalog_avhrr.py --fit, between the outermost samples (printed to 4 decimals) - platform: metop-c + platforms: [metop-c] period: "2026-11-05" cross_track_field_of_view: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view @@ -80,7 +76,7 @@ configurations: cross_track_field_of_view: kind: measured source: validate_catalog_avhrr.py --fit, a fitted spacing of 0.0539816 deg over 2048 samples - platform: metop-c + platforms: [metop-c] period: "2026-11-05" along_track_field_of_view: kind: nominal @@ -91,7 +87,7 @@ configurations: roll_angle: kind: measured source: validate_catalog_avhrr.py --fit, the offset of the fitted sample angles - platform: metop-c + platforms: [metop-c] period: "2026-11-05" is_rectangular: kind: derived diff --git a/src/tatc/resources/instruments/bbr.yml b/src/tatc/resources/instruments/bbr.yml index edf247a8..4c4d585e 100644 --- a/src/tatc/resources/instruments/bbr.yml +++ b/src/tatc/resources/instruments/bbr.yml @@ -40,14 +40,10 @@ configurations: cross_track_field_of_view: &measured kind: measured source: validate_catalog_bbr.py --fit-view, the view that TAT-C centers on the outermost pixels of the shortwave band, with the instrument's pitch (Earth-fixed frame), from the recorded platform positions - platform: earthcare + platforms: [earthcare] period: "2026-09-27" roll_angle: *measured pitch_angle: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models an imaged line as a rectangular view diff --git a/src/tatc/resources/instruments/ceres.yml b/src/tatc/resources/instruments/ceres.yml index a4b9af4f..5477f92e 100644 --- a/src/tatc/resources/instruments/ceres.yml +++ b/src/tatc/resources/instruments/ceres.yml @@ -34,13 +34,9 @@ configurations: field_of_regard: &measured_extent kind: measured source: validate_catalog_ceres.py --fit, between the outermost footprint centers projected to the ellipsoid (59.9884 deg left, 59.9808 deg right of the geodetic nadir, inertial frame) - platform: noaa-20 + platforms: [noaa-20] period: "2026-08-25" cross_track_field_of_view: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view diff --git a/src/tatc/resources/instruments/cpr.yml b/src/tatc/resources/instruments/cpr.yml index 5c158f5d..1f92ad1b 100644 --- a/src/tatc/resources/instruments/cpr.yml +++ b/src/tatc/resources/instruments/cpr.yml @@ -35,10 +35,6 @@ configurations: kind: derived source: 2 atan(5 km / 400 km), a view about 10 km wide at the orbit's altitude, which contains the footprint (about 0.8 km wide) at nadir given the error of an element set near the day cross_track_field_of_view: *width - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models the band along the ground track as a rectangular view diff --git a/src/tatc/resources/instruments/cris.yml b/src/tatc/resources/instruments/cris.yml index 98edef70..82f9c8e7 100644 --- a/src/tatc/resources/instruments/cris.yml +++ b/src/tatc/resources/instruments/cris.yml @@ -40,17 +40,13 @@ configurations: field_of_regard: &measured_extent kind: measured source: validate_catalog_cris.py --fit, between the outermost centers of fields of regard (printed to 6 decimals) - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" cross_track_field_of_view: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step pitch_angle: &measured_tilt kind: measured source: validate_catalog_cris.py --fit, the median forward tilt of the scan plane (the median over every 5th scan of each scan's median, printed to 3 decimals) - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" is_rectangular: kind: derived @@ -86,12 +82,12 @@ configurations: cross_track_field_of_view: kind: measured source: validate_catalog_cris.py --fit, 30 fields of regard at a fitted spacing of 3.33399 deg - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" along_track_field_of_view: &measured_pitch kind: measured source: validate_catalog_cris.py --fit, three fields of view at a fitted pitch of 1.0918 deg - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" cross_track_pixels: kind: nominal @@ -102,7 +98,7 @@ configurations: roll_angle: kind: measured source: validate_catalog_cris.py --fit, the fitted roll - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" pitch_angle: *measured_tilt is_rectangular: diff --git a/src/tatc/resources/instruments/csar.yml b/src/tatc/resources/instruments/csar.yml index 4b5b390b..af0727ea 100644 --- a/src/tatc/resources/instruments/csar.yml +++ b/src/tatc/resources/instruments/csar.yml @@ -43,16 +43,12 @@ configurations: cross_track_field_of_view: kind: measured source: validate_catalog_csar.py --fit, the median difference of the look angles of the near-range and far-range points of 4,067 grid lines of 402 IW products - platform: sentinel-1c + platforms: [sentinel-1c] period: "2026-10-02" - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step roll_angle_profile: kind: measured source: validate_catalog_csar.py --fit, the median roll angle (the mean of the near-range and far-range look angles) of the grid lines in each 10 deg bin of argument of latitude - platform: sentinel-1c + platforms: [sentinel-1c] period: "2026-10-02" is_rectangular: kind: derived @@ -86,16 +82,12 @@ configurations: cross_track_field_of_view: kind: measured source: validate_catalog_csar.py --fit, the median difference of the look angles of the near-range and far-range points of 1,927 grid lines of 97 EW products - platform: sentinel-1c + platforms: [sentinel-1c] period: "2026-10-02" - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step roll_angle_profile: kind: measured source: validate_catalog_csar.py --fit, the median roll angle (the mean of the near-range and far-range look angles) of the grid lines in each 10 deg bin of argument of latitude - platform: sentinel-1c + platforms: [sentinel-1c] period: "2026-10-02" is_rectangular: kind: derived diff --git a/src/tatc/resources/instruments/dpr.yml b/src/tatc/resources/instruments/dpr.yml index 2178a278..5d14c5ae 100644 --- a/src/tatc/resources/instruments/dpr.yml +++ b/src/tatc/resources/instruments/dpr.yml @@ -34,13 +34,9 @@ configurations: field_of_regard: &measured_extent kind: measured source: validate_catalog_dpr.py --fit, between the outermost beams of the full swath (printed to 4 decimals) - platform: gpm + platforms: [gpm] period: "2026-10-03" cross_track_field_of_view: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view @@ -71,7 +67,7 @@ configurations: field_of_regard: &measured_spacing kind: measured source: validate_catalog_dpr.py --fit, a fitted spacing of 0.70846 deg over 49 beams - platform: gpm + platforms: [gpm] period: "2026-10-03" cross_track_field_of_view: *measured_spacing along_track_field_of_view: *measured_spacing @@ -81,7 +77,7 @@ configurations: roll_angle: kind: measured source: validate_catalog_dpr.py --fit, the offset of the fitted beam angles - platform: gpm + platforms: [gpm] period: "2026-10-03" is_rectangular: kind: derived @@ -93,7 +89,7 @@ configurations: scan_period: kind: measured source: validate_catalog_dpr.py --fit, the median time between scans - platform: gpm + platforms: [gpm] period: "2026-10-03" limitations: - TAT-C projects all pixels of a scan at one instant, at the time the product gives for the scan. diff --git a/src/tatc/resources/instruments/earthcare_msi.yml b/src/tatc/resources/instruments/earthcare_msi.yml index 03502e6c..24bb9bd7 100644 --- a/src/tatc/resources/instruments/earthcare_msi.yml +++ b/src/tatc/resources/instruments/earthcare_msi.yml @@ -39,14 +39,10 @@ configurations: cross_track_field_of_view: &measured kind: measured source: validate_catalog_earthcare_msi.py --fit-view, the view that TAT-C centers on the outermost imaged pixels (columns 12 and 368 of MSI_RGR_1C), with the instrument's pitch (Earth-fixed frame), from spacecraft positions of ATL_NOM_1B - platform: earthcare + platforms: [earthcare] period: "2026-09-27" roll_angle: *measured pitch_angle: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models an imaged line as a rectangular view diff --git a/src/tatc/resources/instruments/ecostress.yml b/src/tatc/resources/instruments/ecostress.yml index 05bc774d..1226fd0a 100644 --- a/src/tatc/resources/instruments/ecostress.yml +++ b/src/tatc/resources/instruments/ecostress.yml @@ -41,13 +41,9 @@ configurations: cross_track_field_of_view: &measured_view kind: measured source: validate_catalog_ecostress.py --fit-view, the roll and field of view that center the outermost samples in TAT-C's view frame, with the body's yaw and pitch, and the station's position and velocity of the product (inertial frame) - platform: iss + platforms: [iss] period: "2026-10-04" roll_angle: *measured_view - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a swept swath as a rectangular view diff --git a/src/tatc/resources/instruments/emit.yml b/src/tatc/resources/instruments/emit.yml index 7af151c1..50aae34f 100644 --- a/src/tatc/resources/instruments/emit.yml +++ b/src/tatc/resources/instruments/emit.yml @@ -41,13 +41,9 @@ configurations: cross_track_field_of_view: &measured_view kind: measured source: validate_catalog_emit.py --fit-view, the roll and field of view that center the outermost pixels in TAT-C's view frame, with the body's yaw and pitch, and the station's position and velocity of the product (inertial frame) - platform: iss + platforms: [iss] period: "2026-10-04" roll_angle: *measured_view - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a pushbroom's swath as a rectangular view diff --git a/src/tatc/resources/instruments/gedi.yml b/src/tatc/resources/instruments/gedi.yml index 258559aa..957c4d6d 100644 --- a/src/tatc/resources/instruments/gedi.yml +++ b/src/tatc/resources/instruments/gedi.yml @@ -37,13 +37,9 @@ configurations: roll_angle: &measured kind: measured source: validate_catalog_gedi.py --fit, the median and spread (99.5th percentile) of the beam's offsets from the ground track of the element set nearest the middle of the day, where the beams' center lay within 1 deg of nadir - platform: iss + platforms: [iss] period: "2026-05-01" cross_track_field_of_view: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: &tailored - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: &rectangular kind: derived source: Models the band containing a beam's track as a rectangular view @@ -58,8 +54,6 @@ configurations: provenance: roll_angle: *measured cross_track_field_of_view: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -72,8 +66,6 @@ configurations: provenance: roll_angle: *measured cross_track_field_of_view: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -86,8 +78,6 @@ configurations: provenance: roll_angle: *measured cross_track_field_of_view: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -100,8 +90,6 @@ configurations: provenance: roll_angle: *measured cross_track_field_of_view: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -114,8 +102,6 @@ configurations: provenance: roll_angle: *measured cross_track_field_of_view: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -128,8 +114,6 @@ configurations: provenance: roll_angle: *measured cross_track_field_of_view: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -142,8 +126,6 @@ configurations: provenance: roll_angle: *measured cross_track_field_of_view: *measured - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular limitations: - Each view is about 15 km wide (2.06 deg), whereas a beam's footprint is about 25 m wide and the eight tracks span about 4.5 km. The width holds where the beams lie while GEDI points within 1 deg of nadir (80.9% of shots on the fitting day), with the error of an element set of the day, so a view shows where a beam may observe, not the area it observes. diff --git a/src/tatc/resources/instruments/gmi.yml b/src/tatc/resources/instruments/gmi.yml index 0d07686d..19fe1177 100644 --- a/src/tatc/resources/instruments/gmi.yml +++ b/src/tatc/resources/instruments/gmi.yml @@ -34,13 +34,10 @@ configurations: cone_angle: &measured kind: measured source: validate_catalog_gmi.py --fit, medians over every 20th scan of each feed (printed to 3 decimals) - platform: gpm + platforms: [gpm] period: "2026-10-03" scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: &tailored - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step - type: conical parameters: name: GMI S2 @@ -52,7 +49,6 @@ configurations: cone_angle: *measured scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: *tailored limitations: - GPM periodically flies backward, when GMI scans behind the satellite. These configurations represent forward flight; supply an attitude schedule for yaw flips. sample_size: @@ -75,7 +71,6 @@ configurations: cone_angle: *measured scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: *tailored beam_width: &beam_width kind: nominal source: GMI L1B ATBD, Table 1-1 @@ -119,7 +114,6 @@ configurations: cone_angle: *measured scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: *tailored beam_width: *beam_width scan_sample_spacing: *sample_spacing - type: conical diff --git a/src/tatc/resources/instruments/harp2.yml b/src/tatc/resources/instruments/harp2.yml index 4ff8ec8b..c268c2cb 100644 --- a/src/tatc/resources/instruments/harp2.yml +++ b/src/tatc/resources/instruments/harp2.yml @@ -41,18 +41,14 @@ configurations: cross_track_field_of_view: &measured_view kind: measured source: validate_catalog_harp2.py --fit, the outermost samples of the near-nadir view 43.7042 deg left and 50.4493 deg right of the geodetic nadir (Earth-fixed frame) - platform: pace + platforms: [pace] period: "2026-10-04" roll_angle: *measured_view pitch_angle: kind: measured source: validate_catalog_harp2.py --fit, the along-track angle of the sample nearest nadir (the view's nominal angle is 0.6 deg) - platform: pace + platforms: [pace] period: "2026-10-04" - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models an imaged swath as a rectangular view diff --git a/src/tatc/resources/instruments/iasi.yml b/src/tatc/resources/instruments/iasi.yml index d5ec4d5f..4e7f4b94 100644 --- a/src/tatc/resources/instruments/iasi.yml +++ b/src/tatc/resources/instruments/iasi.yml @@ -34,13 +34,9 @@ configurations: field_of_regard: &measured_extent kind: measured source: validate_catalog_iasi.py --fit, between the outermost centers of fields of regard, over 1,082 scans - platform: metop-b + platforms: [metop-b] period: "2026-10-03" cross_track_field_of_view: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view @@ -74,7 +70,7 @@ configurations: cross_track_field_of_view: &measured_spacing kind: measured source: validate_catalog_iasi.py --fit, 30 fields of regard at a fitted spacing of 3.332 deg - platform: metop-b + platforms: [metop-b] period: "2026-10-03" along_track_field_of_view: *measured_spacing cross_track_pixels: @@ -83,7 +79,7 @@ configurations: roll_angle: kind: measured source: validate_catalog_iasi.py --fit, the fitted offset of the scan - platform: metop-b + platforms: [metop-b] period: "2026-10-03" is_rectangular: kind: derived diff --git a/src/tatc/resources/instruments/karin.yml b/src/tatc/resources/instruments/karin.yml index e0577dcb..5faad9a8 100644 --- a/src/tatc/resources/instruments/karin.yml +++ b/src/tatc/resources/instruments/karin.yml @@ -35,13 +35,9 @@ configurations: roll_angle: &left kind: measured source: validate_catalog_karin.py --fit, the mean of the median look angles of the inner and outer edges of the good-quality heights of 13,474 lines over the open ocean - platform: swot + platforms: [swot] period: "2026-10-01" cross_track_field_of_view: *left - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: &tailored - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: &rectangular kind: derived source: Models the swath of each zero-Doppler line as a rectangular view @@ -57,11 +53,9 @@ configurations: roll_angle: &right kind: measured source: validate_catalog_karin.py --fit, the mean of the median look angles of the inner and outer edges of the good-quality heights of 13,444 lines over the open ocean - platform: swot + platforms: [swot] period: "2026-10-01" cross_track_field_of_view: *right - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular limitations: - The edges are those of good-quality sea surface heights over the open ocean, which extend from about 7.5 to 61 km from the ground track, beyond the nominal 10 to 60 km. Heights over land, ice, and inland water were not tested. diff --git a/src/tatc/resources/instruments/lsar.yml b/src/tatc/resources/instruments/lsar.yml index 7319a36c..13ecfca4 100644 --- a/src/tatc/resources/instruments/lsar.yml +++ b/src/tatc/resources/instruments/lsar.yml @@ -38,16 +38,12 @@ configurations: cross_track_field_of_view: kind: measured source: validate_catalog_lsar.py --fit, the median difference of the look angles of the near-range and far-range points of 45,538 grid lines of 95 RSLC products - platform: nisar + platforms: [nisar] period: "2026-10-02" - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step roll_angle_profile: kind: measured source: validate_catalog_lsar.py --fit, the median roll angle (the mean of the near-range and far-range look angles) of the grid lines in each 10 deg bin of argument of latitude - platform: nisar + platforms: [nisar] period: "2026-10-02" is_rectangular: kind: derived @@ -79,16 +75,12 @@ configurations: cross_track_field_of_view: kind: measured source: validate_catalog_lsar.py --fit, the median difference of the look angles of the near-range and far-range points of 23,573 grid lines of 55 RSLC products - platform: nisar + platforms: [nisar] period: "2026-10-02" - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step roll_angle_profile: kind: measured source: validate_catalog_lsar.py --fit, the median roll angle (the mean of the near-range and far-range look angles) of the grid lines in each 10 deg bin of argument of latitude - platform: nisar + platforms: [nisar] period: "2026-10-02" is_rectangular: kind: derived @@ -120,16 +112,12 @@ configurations: cross_track_field_of_view: kind: measured source: validate_catalog_lsar.py --fit, the median difference of the look angles of the near-range and far-range points of 11,022 grid lines of 26 RSLC products - platform: nisar + platforms: [nisar] period: "2026-10-02" - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step roll_angle_profile: kind: measured source: validate_catalog_lsar.py --fit, the median roll angle (the mean of the near-range and far-range look angles) of the grid lines in each 10 deg bin of argument of latitude - platform: nisar + platforms: [nisar] period: "2026-10-02" is_rectangular: kind: derived diff --git a/src/tatc/resources/instruments/mhs.yml b/src/tatc/resources/instruments/mhs.yml index 902c037a..dd2dec99 100644 --- a/src/tatc/resources/instruments/mhs.yml +++ b/src/tatc/resources/instruments/mhs.yml @@ -40,10 +40,6 @@ configurations: kind: nominal source: The outermost of MHS's 90 beams, spaced 10/9 deg, are 49.444 deg from nadir cross_track_field_of_view: *nominal_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view diff --git a/src/tatc/resources/instruments/modis.yml b/src/tatc/resources/instruments/modis.yml index c48dcfc5..728ec4f1 100644 --- a/src/tatc/resources/instruments/modis.yml +++ b/src/tatc/resources/instruments/modis.yml @@ -43,13 +43,9 @@ configurations: field_of_regard: &measured_extent kind: measured source: validate_catalog_modis.py --fit, 1,353 frame spacings of a fitted 0.08124 deg - platform: terra + platforms: [terra] period: "2026-10-04" cross_track_field_of_view: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view @@ -81,12 +77,12 @@ configurations: cross_track_field_of_view: kind: measured source: validate_catalog_modis.py --fit, 1,354 frames of a fitted 0.08124 deg - platform: terra + platforms: [terra] period: "2026-10-04" along_track_field_of_view: kind: measured source: validate_catalog_modis.py --fit, 10 detectors, from 0.7311 deg over the 9 spacings between the first and last - platform: terra + platforms: [terra] period: "2026-10-04" cross_track_pixels: kind: nominal @@ -97,7 +93,7 @@ configurations: roll_angle: kind: measured source: validate_catalog_modis.py --fit, the fitted offset of the scan angle - platform: terra + platforms: [terra] period: "2026-10-04" view_geometry: kind: derived diff --git a/src/tatc/resources/instruments/msi.yml b/src/tatc/resources/instruments/msi.yml index e0d4ebb2..855f1867 100644 --- a/src/tatc/resources/instruments/msi.yml +++ b/src/tatc/resources/instruments/msi.yml @@ -48,13 +48,9 @@ configurations: cross_track_field_of_view: &measured_extent kind: measured source: validate_catalog_msi.py --fit, the median view angles of the edges of the tiles' valid data in 2,041 cross sections of 122 datatakes of Sentinel-2A, 2B, and 2C - platform: sentinel-2a, sentinel-2b, sentinel-2c + platforms: [sentinel-2a, sentinel-2b, sentinel-2c] period: "2026-10-03" roll_angle: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a pushbroom swath as a rectangular view diff --git a/src/tatc/resources/instruments/oci.yml b/src/tatc/resources/instruments/oci.yml index 96666166..2e42e4ce 100644 --- a/src/tatc/resources/instruments/oci.yml +++ b/src/tatc/resources/instruments/oci.yml @@ -21,7 +21,7 @@ configurations: description: The swath scanned between the outermost samples, tilted aft over the southern part of the sunlit half orbit and forward over the northern part, changing at a latitude scheduled by day, with a view tailored to the analysis time step. Build it with the start and end of the analysis. platforms: [pace] velocity_frame: earth_fixed - attitude_schedule: + tilt_schedule: fore_pitch_angle: 19.8555 aft_pitch_angle: -19.8149 odd_day_offset: 5.2097 @@ -34,19 +34,19 @@ configurations: fore_pitch_angle: &measured_tilt kind: measured source: validate_catalog_oci.py --fit, the along-track angle of the samples forward and aft - platform: pace + platforms: [pace] period: "2026-10-04" aft_pitch_angle: *measured_tilt odd_day_offset: &measured_schedule kind: measured source: validate_catalog_oci.py --switches, the median by day of the spacecraft's geodetic latitude where the tilt changes to forward, less the subsolar latitude at noon (UTC), by the parity of the day of the year (standard deviation 0.018 deg over 55 days) - platform: pace + platforms: [pace] period: 2026-08-15 to 2026-10-08 even_day_offset: *measured_schedule transition: kind: measured source: validate_catalog_oci.py --fit, the arc of argument of latitude over which the tilt changes, about 26 s - platform: pace + platforms: [pace] period: "2026-10-04" return_argument_of_latitude: kind: placeholder @@ -54,8 +54,8 @@ configurations: blind_before: &measured_blind kind: measured source: validate_catalog_oci.py --blind, at full resolution, the median over 51 changes to forward of the end of the last valid scan before the tilt crosses zero (14.96 s before) and of the start of the first valid scan after it (19.37 s after); every scan between is flagged - platform: pace - period: 2026-08-20, 2026-09-15, 2026-10-04 and 2026-10-07 + platforms: [pace] + period: 2026-08-20, 2026-09-15, 2026-10-04, 2026-10-07 blind_after: *measured_blind instruments: - type: pointed @@ -73,12 +73,8 @@ configurations: cross_track_field_of_view: kind: measured source: validate_catalog_oci.py --fit, between the outermost samples in the tilted view (113.234 deg forward, 113.237 deg aft) - platform: pace + platforms: [pace] period: "2026-10-04" - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view diff --git a/src/tatc/resources/instruments/oco2.yml b/src/tatc/resources/instruments/oco2.yml index ddb45b8f..4648e437 100644 --- a/src/tatc/resources/instruments/oco2.yml +++ b/src/tatc/resources/instruments/oco2.yml @@ -37,12 +37,8 @@ configurations: cross_track_field_of_view: kind: measured source: validate_catalog_oco2.py --fit, the median angle between the first and eighth soundings seen from the spacecraft in nadir mode - platform: oco-2 + platforms: [oco-2] period: "2026-10-04" - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models the slit's swath as a rectangular view @@ -73,12 +69,8 @@ configurations: cross_track_field_of_view: kind: measured source: validate_catalog_oco2.py --fit, the median angle between the first and eighth soundings seen from the spacecraft in nadir mode - platform: oco-2 + platforms: [oco-2] period: "2026-10-04" - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models the slit's swath as a rectangular view diff --git a/src/tatc/resources/instruments/olci.yml b/src/tatc/resources/instruments/olci.yml index e27a92e5..588ab0bf 100644 --- a/src/tatc/resources/instruments/olci.yml +++ b/src/tatc/resources/instruments/olci.yml @@ -38,12 +38,8 @@ configurations: cross_track_field_of_view: &measured kind: measured source: validate_catalog_olci.py --fit, between the outermost tie points (22.33 deg to the left and 47.68 deg to the right) - platform: sentinel-3a + platforms: [sentinel-3a] period: "2026-10-04" - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step roll_angle: *measured is_rectangular: kind: derived diff --git a/src/tatc/resources/instruments/oli.yml b/src/tatc/resources/instruments/oli.yml index 7b2e8e03..8835fbd1 100644 --- a/src/tatc/resources/instruments/oli.yml +++ b/src/tatc/resources/instruments/oli.yml @@ -43,13 +43,9 @@ configurations: field_of_regard: &measured_extent kind: measured source: validate_catalog_oli.py --fit, the median view angles of the edges of 673 scenes at their centers - platform: landsat-9 + platforms: [landsat-9] period: "2026-11-05" cross_track_field_of_view: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a pushbroom swath as a rectangular view diff --git a/src/tatc/resources/instruments/omps_nm.yml b/src/tatc/resources/instruments/omps_nm.yml index 5f4a4eda..5af72c1d 100644 --- a/src/tatc/resources/instruments/omps_nm.yml +++ b/src/tatc/resources/instruments/omps_nm.yml @@ -46,13 +46,9 @@ configurations: cross_track_field_of_view: &measured_noaa_21 kind: measured source: validate_catalog_omps.py --fit, the outermost samples 55.3251 deg left and 54.6747 deg right of the geodetic nadir (inertial frame) - platform: noaa-21 + platforms: [noaa-21] period: "2026-10-01" roll_angle: *measured_noaa_21 - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models an imaged swath as a rectangular view @@ -83,13 +79,9 @@ configurations: cross_track_field_of_view: &measured_noaa_20 kind: measured source: validate_catalog_omps.py --fit, the outermost samples 54.0714 deg left and 54.5302 deg right of the geodetic nadir (inertial frame) - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-01" roll_angle: *measured_noaa_20 - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models an imaged swath as a rectangular view diff --git a/src/tatc/resources/instruments/poseidon4.yml b/src/tatc/resources/instruments/poseidon4.yml index 628752e9..c8f46b06 100644 --- a/src/tatc/resources/instruments/poseidon4.yml +++ b/src/tatc/resources/instruments/poseidon4.yml @@ -40,10 +40,6 @@ configurations: kind: derived source: 2 atan(5 km / 1336 km), a view about 10 km wide at the orbit's altitude, which contains the pulse-limited footprint (a few kilometers wide) at nadir cross_track_field_of_view: *footprint - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models the band along the ground track as a rectangular view diff --git a/src/tatc/resources/instruments/smap_radiometer.yml b/src/tatc/resources/instruments/smap_radiometer.yml index ec177aba..1d00d228 100644 --- a/src/tatc/resources/instruments/smap_radiometer.yml +++ b/src/tatc/resources/instruments/smap_radiometer.yml @@ -33,7 +33,7 @@ configurations: cone_angle: kind: measured source: validate_catalog_smap.py --fit, the angle from nadir of a boresight at the median incidence angle of a day of forward looks of SPL1CTB (39.97 deg), at the mean altitude, on a spherical Earth (printed to 3 decimals) - platform: smap + platforms: [smap] period: "2026-10-24" scan_center_azimuth: kind: nominal @@ -41,9 +41,6 @@ configurations: scan_half_width: kind: nominal source: The antenna rotates through a full circle - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step limitations: - A pass observes each point twice, about two minutes apart; `collect_observations` reports each look as an observation. footprints: @@ -65,7 +62,7 @@ configurations: cone_angle: kind: measured source: validate_catalog_smap.py --fit, as for the looks configuration - platform: smap + platforms: [smap] period: "2026-10-24" scan_center_azimuth: kind: nominal @@ -73,9 +70,6 @@ configurations: scan_half_width: kind: nominal source: The antenna rotates through a full circle - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step beam_width: kind: nominal source: The radiometer's 3 dB beamwidth of 2.4 deg (Piepmeier et al., IEEE Transactions on Geoscience and Remote Sensing, 2017) diff --git a/src/tatc/resources/instruments/spexone.yml b/src/tatc/resources/instruments/spexone.yml index a40979f6..c731e2b5 100644 --- a/src/tatc/resources/instruments/spexone.yml +++ b/src/tatc/resources/instruments/spexone.yml @@ -34,13 +34,9 @@ configurations: field_of_regard: &measured_view kind: measured source: validate_catalog_spexone.py --fit, between the outermost bins observed by the nadir view (3.9037 deg left, 3.9374 deg right of the geodetic nadir, Earth-fixed frame) - platform: pace + platforms: [pace] period: "2026-10-04" cross_track_field_of_view: *measured_view - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models an imaged swath as a rectangular view diff --git a/src/tatc/resources/instruments/ssmis.yml b/src/tatc/resources/instruments/ssmis.yml index 9999f48a..1ee07ae2 100644 --- a/src/tatc/resources/instruments/ssmis.yml +++ b/src/tatc/resources/instruments/ssmis.yml @@ -33,13 +33,10 @@ configurations: cone_angle: &measured kind: measured source: validate_catalog_ssmis.py --fit, from the S1 samples and the recorded spacecraft positions (printed to 3 decimals) - platform: dmsp-f18 + platforms: [dmsp-f18] period: "2026-10-04" scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step limitations: - The arc is that of the centers of the S1 samples, about 142 deg of the 144 deg active scan; the other groups of samples (37, 91, and 150 to 183 GHz) were not used to fit it. limitations: diff --git a/src/tatc/resources/instruments/tempo.yml b/src/tatc/resources/instruments/tempo.yml index 24ed3352..6502a3a2 100644 --- a/src/tatc/resources/instruments/tempo.yml +++ b/src/tatc/resources/instruments/tempo.yml @@ -38,7 +38,7 @@ configurations: cross_track_field_of_view: &measured kind: measured source: validate_catalog_tempo.py --fit, the view that centers the median tangents of the edges of the area a full scan imaged (the outer corners of its outermost pixels, ultraviolet band), seen from the satellite's position in the product - platform: intelsat-40e + platforms: [intelsat-40e] period: "2026-10-06" along_track_field_of_view: *measured roll_angle: *measured diff --git a/src/tatc/resources/instruments/tmi.yml b/src/tatc/resources/instruments/tmi.yml index 6fa99375..98781317 100644 --- a/src/tatc/resources/instruments/tmi.yml +++ b/src/tatc/resources/instruments/tmi.yml @@ -34,13 +34,10 @@ configurations: cone_angle: &measured kind: measured source: validate_catalog_tmi.py --fit, from each group's samples and the recorded spacecraft positions (printed to 3 decimals) - platform: trmm + platforms: [trmm] period: "2013-06-01" scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: &tailored - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step - type: conical parameters: name: TMI S2 @@ -52,7 +49,6 @@ configurations: cone_angle: *measured scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: *tailored - type: conical parameters: name: TMI S3 @@ -64,7 +60,6 @@ configurations: cone_angle: *measured scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: *tailored limitations: - TRMM periodically flew backward (yaw maneuvers every two to four weeks, as on 2013-06-15 and 2013-06-28), when TMI scanned behind the satellite. These configurations represent forward flight (the products' SCorientation of 0); supply an attitude schedule for backward flight. sample_size: @@ -87,7 +82,6 @@ configurations: cone_angle: *measured scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: *tailored beam_width: &beam_width kind: nominal source: Kummerow et al. (1998), TMI characteristics (vertical polarization), as reproduced by NOAA MiRS @@ -107,7 +101,6 @@ configurations: cone_angle: *measured scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: *tailored beam_width: *beam_width scan_sample_spacing: *sample_spacing - type: conical @@ -135,7 +128,6 @@ configurations: cone_angle: *measured scan_center_azimuth: *measured scan_half_width: *measured - along_track_field_of_view: *tailored beam_width: *beam_width scan_sample_spacing: *sample_spacing limitations: diff --git a/src/tatc/resources/instruments/trmm_pr.yml b/src/tatc/resources/instruments/trmm_pr.yml index 8468eb3f..3b0e9bdc 100644 --- a/src/tatc/resources/instruments/trmm_pr.yml +++ b/src/tatc/resources/instruments/trmm_pr.yml @@ -34,13 +34,9 @@ configurations: field_of_regard: &measured_extent kind: measured source: validate_catalog_trmm_pr.py --fit, between the outermost beams (printed to 4 decimals) - platform: trmm + platforms: [trmm] period: "2013-06-01" cross_track_field_of_view: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view @@ -68,7 +64,7 @@ configurations: field_of_regard: &measured_spacing kind: measured source: validate_catalog_trmm_pr.py --fit, a fitted spacing of 0.70803 deg over 49 beams - platform: trmm + platforms: [trmm] period: "2013-06-01" cross_track_field_of_view: *measured_spacing along_track_field_of_view: *measured_spacing @@ -78,7 +74,7 @@ configurations: roll_angle: kind: measured source: validate_catalog_trmm_pr.py --fit, the offset of the fitted beam angles - platform: trmm + platforms: [trmm] period: "2013-06-01" is_rectangular: kind: derived @@ -90,7 +86,7 @@ configurations: scan_period: kind: measured source: validate_catalog_trmm_pr.py --fit, the median time between scans - platform: trmm + platforms: [trmm] period: "2013-06-01" limitations: - TAT-C projects all pixels of a scan at one instant, at the time the product gives for the scan. diff --git a/src/tatc/resources/instruments/tropomi.yml b/src/tatc/resources/instruments/tropomi.yml index 092bbc58..eacaf0dd 100644 --- a/src/tatc/resources/instruments/tropomi.yml +++ b/src/tatc/resources/instruments/tropomi.yml @@ -40,14 +40,10 @@ configurations: cross_track_field_of_view: &fitted kind: measured source: validate_catalog_tropomi.py --fit, the median directions of the ends of pixels of 6,188 lines, from recorded satellite positions - platform: sentinel-5p + platforms: [sentinel-5p] period: "2026-10-05" roll_angle: *fitted pitch_angle: *fitted - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: &tailored - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: &rectangular kind: derived source: Models part of a line of a pushbroom swath as a rectangular view @@ -66,8 +62,6 @@ configurations: cross_track_field_of_view: *fitted roll_angle: *fitted pitch_angle: *fitted - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -84,8 +78,6 @@ configurations: cross_track_field_of_view: *fitted roll_angle: *fitted pitch_angle: *fitted - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -102,8 +94,6 @@ configurations: cross_track_field_of_view: *fitted roll_angle: *fitted pitch_angle: *fitted - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -120,8 +110,6 @@ configurations: cross_track_field_of_view: *fitted roll_angle: *fitted pitch_angle: *fitted - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -138,8 +126,6 @@ configurations: cross_track_field_of_view: *fitted roll_angle: *fitted pitch_angle: *fitted - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -156,8 +142,6 @@ configurations: cross_track_field_of_view: *fitted roll_angle: *fitted pitch_angle: *fitted - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -174,8 +158,6 @@ configurations: cross_track_field_of_view: *fitted roll_angle: *fitted pitch_angle: *fitted - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -192,8 +174,6 @@ configurations: cross_track_field_of_view: *fitted roll_angle: *fitted pitch_angle: *fitted - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular - type: pointed parameters: @@ -210,8 +190,6 @@ configurations: cross_track_field_of_view: *fitted roll_angle: *fitted pitch_angle: *fitted - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: *tailored is_rectangular: *rectangular limitations: - The views are a union, so analyze them with instrument_index=None. The default analyzes only the first view, at one edge of the swath. diff --git a/src/tatc/resources/instruments/viirs.yml b/src/tatc/resources/instruments/viirs.yml index de9805fc..407f88df 100644 --- a/src/tatc/resources/instruments/viirs.yml +++ b/src/tatc/resources/instruments/viirs.yml @@ -39,13 +39,9 @@ configurations: field_of_regard: &measured_extent kind: measured source: ValidateImagerVIIRS, Test 2, between the outermost samples (printed to 4 decimals) - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" cross_track_field_of_view: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view @@ -70,13 +66,9 @@ configurations: field_of_regard: &noaa_21_extent kind: measured source: validate_catalog_viirs.py --fit, between the outermost samples - platform: noaa-21 + platforms: [noaa-21] period: "2026-11-05" cross_track_field_of_view: *noaa_21_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view @@ -111,12 +103,12 @@ configurations: cross_track_field_of_view: &measured_zone kind: measured source: ValidateSampleSizes, Test 1, the zone's pixels and spacing (printed to 3 decimals) - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" along_track_field_of_view: &measured_array kind: measured source: ValidateImagerVIIRS, Test 2, 16 detectors of 0.05104 deg - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" cross_track_pixels: *measured_zone along_track_pixels: @@ -132,7 +124,7 @@ configurations: scan_period: kind: measured source: ValidateImagerVIIRS, the median period between scans - platform: noaa-20 + platforms: [noaa-20] period: "2026-10-02" - type: pointed parameters: diff --git a/src/tatc/resources/instruments/virs.yml b/src/tatc/resources/instruments/virs.yml index 46b46dee..4d2ca8c0 100644 --- a/src/tatc/resources/instruments/virs.yml +++ b/src/tatc/resources/instruments/virs.yml @@ -34,13 +34,9 @@ configurations: field_of_regard: &measured_extent kind: measured source: validate_catalog_virs.py --fit, between the outermost samples (printed to 4 decimals) - platform: trmm + platforms: [trmm] period: "2013-06-01" cross_track_field_of_view: *measured_extent - is_swept: {kind: derived, source: "Models the view as sweeping along track, so that its swaths are the strips its cross-track line sweeps, as observations of points do"} - along_track_field_of_view: - kind: derived - source: compute_along_track_field_of_view, from the orbit and time step is_rectangular: kind: derived source: Models a scanned swath as a rectangular view @@ -69,7 +65,7 @@ configurations: cross_track_field_of_view: &measured_spacing kind: measured source: validate_catalog_virs.py --fit, a fitted spacing of 0.34511 deg over 261 samples - platform: trmm + platforms: [trmm] period: "2013-06-01" along_track_field_of_view: kind: derived @@ -80,7 +76,7 @@ configurations: roll_angle: kind: measured source: validate_catalog_virs.py --fit, the offset of the fitted sample angles - platform: trmm + platforms: [trmm] period: "2013-06-01" is_rectangular: kind: derived @@ -88,7 +84,7 @@ configurations: scan_period: kind: measured source: validate_catalog_virs.py --fit, the median time between scans - platform: trmm + platforms: [trmm] period: "2013-06-01" limitations: - TAT-C projects all pixels of a scan at one instant, at the time the product gives for the scan. diff --git a/src/tatc/resources/validation/abi.json b/src/tatc/resources/validation/abi.json index 022384c8..018917f3 100644 --- a/src/tatc/resources/validation/abi.json +++ b/src/tatc/resources/validation/abi.json @@ -1,15 +1,16 @@ { "entry_id": "abi", - "standard_version": 1, "configurations": { "full_disk": { - "evidence": "rerun", + "digest": "0f24250ef8d0f2c98436fe13b243610e5617b920edc31c6c4ea794c3b1326e73", + "standard_version": 1, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_abi.py", - "period": "2026-10-03T12:00Z", - "platform": "goes-19", - "digest": "0f24250ef8d0f2c98436fe13b243610e5617b920edc31c6c4ea794c3b1326e73", "reference": "ABI-L2-ACMF clear sky mask, every 8th pixel", + "period": "2026-10-03T12:00Z", + "platforms": [ + "goes-19" + ], "metrics": [ { "name": "imaged_pixels_observed", @@ -20,19 +21,22 @@ "value": 0.00037989186479592263 } ], + "transfers": {}, "fixture_metrics": { "imaged_pixels_observed": 100.0, "elevation_error_max": 0.00037431447341873536 } }, "sst_good_quality": { - "evidence": "rerun", + "digest": "61f9d59e6d03c56b386b70e62a6f025e9f21eacfcd6bec545120e5d067823023", + "standard_version": 1, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_abi.py", - "period": "2026-10-03T12:00Z", - "platform": "goes-19", - "digest": "61f9d59e6d03c56b386b70e62a6f025e9f21eacfcd6bec545120e5d067823023", "reference": "ABI-L2-SSTF SST and quality flags", + "period": "2026-10-03T12:00Z", + "platforms": [ + "goes-19" + ], "metrics": [ { "name": "product_limit", @@ -43,18 +47,21 @@ "value": 99.15966386554622 } ], + "transfers": {}, "fixture_metrics": { "product_limit": 0.31548953875399377 } }, "lst_good_quality": { - "evidence": "rerun", + "digest": "3c44900855e1fb4542e9f2948171c27c9cec3723ff52a082ecc9d919bf13ffb9", + "standard_version": 1, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_abi.py", - "period": "2026-10-03T12:00Z", - "platform": "goes-19", - "digest": "3c44900855e1fb4542e9f2948171c27c9cec3723ff52a082ecc9d919bf13ffb9", "reference": "ABI-L2-LSTF LST and quality flags", + "period": "2026-10-03T12:00Z", + "platforms": [ + "goes-19" + ], "metrics": [ { "name": "product_limit", @@ -65,6 +72,7 @@ "value": 99.67672413793103 } ], + "transfers": {}, "fixture_metrics": { "product_limit": 0.2588730783312698 } diff --git a/src/tatc/resources/validation/ahi.json b/src/tatc/resources/validation/ahi.json index 71b817f3..59af9048 100644 --- a/src/tatc/resources/validation/ahi.json +++ b/src/tatc/resources/validation/ahi.json @@ -1,15 +1,16 @@ { "entry_id": "ahi", - "standard_version": 2, "configurations": { "full_disk": { - "evidence": "rerun", + "digest": "5d2ecc67bdbb68e12af30c19e66df0aaa5fcf3e4ff2b13907a799b4f1aeea633", + "standard_version": 2, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_ahi.py", - "period": "2026-11-08T12:00Z", - "platform": "himawari-9", - "digest": "5d2ecc67bdbb68e12af30c19e66df0aaa5fcf3e4ff2b13907a799b4f1aeea633", "reference": "AHI-CMSK cloud mask, every 8th pixel", + "period": "2026-11-08T12:00Z", + "platforms": [ + "himawari-9" + ], "metrics": [ { "name": "imaged_pixels_observed", @@ -20,20 +21,22 @@ "value": 0.0004886105113826034 } ], + "transfers": {}, "fixture_metrics": { "imaged_pixels_observed": 100.0, "elevation_error_max": 0.00034229839168631315 } }, "cloud_top_height": { - "evidence": "rerun", + "digest": "c8a8fcb28e64996bea02ea074e53c4519119687b7252385dd2a7eac09dffaff9", + "standard_version": 2, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_ahi.py", - "period": "2026-11-08T12:00Z", - "platform": "himawari-9", - "digest": "c8a8fcb28e64996bea02ea074e53c4519119687b7252385dd2a7eac09dffaff9", "reference": "AHI-CHGT cloud top height, the greatest local zenith angle at which it is retrieved", - "holdout_gap_days": 38, + "period": "2026-11-08T12:00Z", + "platforms": [ + "himawari-9" + ], "metrics": [ { "name": "product_limit", @@ -44,6 +47,7 @@ "value": 79.38443040242265 } ], + "transfers": {}, "fixture_metrics": { "product_limit": 0.4968281089902149 } diff --git a/src/tatc/resources/validation/airs.json b/src/tatc/resources/validation/airs.json index 588e3689..4141f46f 100644 --- a/src/tatc/resources/validation/airs.json +++ b/src/tatc/resources/validation/airs.json @@ -3,13 +3,14 @@ "configurations": { "footprints": { "digest": "7862db094b28e96e59d9bd0636934b55923d8779ce990fd0d4320aea07705d4b", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_airs.py", "reference": "Footprints published by the AIRS project; footprint positions of AIRSAQIRL1B version 8.0", "period": "2026-11-04", - "platform": "aqua", - "holdout_gap_days": 31, + "platforms": [ + "aqua" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -36,6 +37,7 @@ "value": 0.9995765508002952 } ], + "transfers": {}, "fixture_metrics": { "sample_size_within_3pct": 75.0, "pixel_position_median": 3.264360510248955, @@ -45,13 +47,14 @@ }, "swath": { "digest": "56f98ad36b5699a06d929cfca0d65c4b4a3f9e1493a0ae384a1f1a028dab8c13", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_airs.py", "reference": "AIRSAQIRL1B version 8.0 (footprint positions and times)", "period": "2026-11-04", - "platform": "aqua", - "holdout_gap_days": 31, + "platforms": [ + "aqua" + ], "metrics": [ { "name": "pass_recall", @@ -74,11 +77,11 @@ "value": 0.9976421381679229 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.47663218209999997 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/amsr2.json b/src/tatc/resources/validation/amsr2.json index 27d773d7..e0125482 100644 --- a/src/tatc/resources/validation/amsr2.json +++ b/src/tatc/resources/validation/amsr2.json @@ -3,13 +3,14 @@ "configurations": { "sample_size": { "digest": "f583bcf1c5cd9b1f756f7881c40a6722b24fc50a1998fb984b0c0492192b9d21", - "evidence": "rerun", + "standard_version": 1, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_amsr2.py", "reference": "Footprints of JAXA's AMSR2 channel set; spacing of GPM_1CGCOMW1AMSR2 version 08", "period": "2026-11-01", - "platform": "gcom-w", - "holdout_gap_days": 36, + "platforms": [ + "gcom-w" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -40,6 +41,7 @@ "scope": "S5" } ], + "transfers": {}, "fixture_metrics": { "sample_size_within_3pct": 83.33333333333334, "spacing_arc_ratio_median_S1": 1.0015214046175638, @@ -50,13 +52,14 @@ }, "swath": { "digest": "3b318e73416bf7866fd7ecf2eabf1bd5bca4a5df50ac8783d9a7dc981d08b737", - "evidence": "rerun", + "standard_version": 1, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_amsr2.py", "reference": "GPM_1CGCOMW1AMSR2 version 08", "period": "2026-11-01", - "platform": "gcom-w", - "holdout_gap_days": 36, + "platforms": [ + "gcom-w" + ], "metrics": [ { "name": "pass_recall", @@ -79,11 +82,11 @@ "value": 0.9976790180773127 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.7200056528 } } - }, - "standard_version": 1 + } } diff --git a/src/tatc/resources/validation/amsua.json b/src/tatc/resources/validation/amsua.json index a66715c3..a724335c 100644 --- a/src/tatc/resources/validation/amsua.json +++ b/src/tatc/resources/validation/amsua.json @@ -3,13 +3,14 @@ "configurations": { "footprints": { "digest": "12c13b6d6059dce8bc645deadf845d3364840f84686bc2d5f1027c27e810a96a", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_amsua.py", "reference": "Footprint published in the AIRABRAD documentation; footprint positions of AIRABRAD version 005", "period": "2026-11-05", - "platform": "aqua", - "holdout_gap_days": 32, + "platforms": [ + "aqua" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -36,6 +37,7 @@ "value": 0.9958033875057757 } ], + "transfers": {}, "fixture_metrics": { "sample_size_within_3pct": 0.0, "pixel_position_median": 4.4112185989226536, @@ -45,13 +47,14 @@ }, "swath": { "digest": "369162ad7568ddcffbc1e3e81552c52f471f7b2232da5e94cc9be7f7f3928bce", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_amsua.py", "reference": "AIRABRAD version 005 (footprint positions and times)", "period": "2026-11-05", - "platform": "aqua", - "holdout_gap_days": 32, + "platforms": [ + "aqua" + ], "metrics": [ { "name": "pass_recall", @@ -74,11 +77,11 @@ "value": 0.9979001473835111 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 2.1124676153499995 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/ascat.json b/src/tatc/resources/validation/ascat.json index 3d48bf0e..2b1ec1ab 100644 --- a/src/tatc/resources/validation/ascat.json +++ b/src/tatc/resources/validation/ascat.json @@ -3,13 +3,14 @@ "configurations": { "swaths": { "digest": "5d9d3f2ba6c6b2a59be1a0fb383cd836acbd56df2a78be1dc5251ce092f002b9", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_ascat.py", "reference": "ASCATC-L2-25km (wind vector cell positions and row times)", "period": "2026-11-08", - "platform": "metop-c", - "holdout_gap_days": 34, + "platforms": [ + "metop-c" + ], "metrics": [ { "name": "pass_recall", @@ -74,11 +75,11 @@ "value": 0.371873582 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 1.8460118375499996 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/atlas.json b/src/tatc/resources/validation/atlas.json index ae45bc1f..c09bbdd1 100644 --- a/src/tatc/resources/validation/atlas.json +++ b/src/tatc/resources/validation/atlas.json @@ -3,13 +3,14 @@ "configurations": { "beam_pairs": { "digest": "667a1dc0178e3b4c539753823f444bec26dcdf558407204a32d80344865bbd9d", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_atlas.py", "reference": "ATL08QL version 007 (land segments south of 60 deg S)", "period": "2026-11-04", - "platform": "icesat-2", - "holdout_gap_days": 34, + "platforms": [ + "icesat-2" + ], "metrics": [ { "name": "segment_recall", @@ -61,11 +62,11 @@ "value": 0.02074784303558941 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 6.85040269705 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/atlid.json b/src/tatc/resources/validation/atlid.json index ddbd7850..e4018c62 100644 --- a/src/tatc/resources/validation/atlid.json +++ b/src/tatc/resources/validation/atlid.json @@ -3,13 +3,14 @@ "configurations": { "profile": { "digest": "e5519e6a3649052d584f93a14cd30790cceb1d49489a3d023983e02f5d6ee636", - "evidence": "rerun", + "standard_version": 6, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_atlid.py", "reference": "ATL_NOM_1B (profile positions and times)", "period": "2026-11-07", - "platform": "earthcare", - "holdout_gap_days": 41, + "platforms": [ + "earthcare" + ], "metrics": [ { "name": "segment_recall", @@ -28,11 +29,11 @@ "value": 0.176493774 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.4253327837999999 } } - }, - "standard_version": 6 + } } diff --git a/src/tatc/resources/validation/atms.json b/src/tatc/resources/validation/atms.json index 213beb4a..25a4bf0b 100644 --- a/src/tatc/resources/validation/atms.json +++ b/src/tatc/resources/validation/atms.json @@ -3,13 +3,14 @@ "configurations": { "beams_noaa_20": { "digest": "6204bdac0a0a5f41b83b74d9d919ba45e7b5b79523a76b208625e83235f47056", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_atms.py", "reference": "Footprints of the TC PRIMED documentation; beam centers of the ATMS SDR geolocation", "period": "2026-08-12", - "platform": "noaa-20", - "holdout_gap_days": 51, + "platforms": [ + "noaa-20" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -34,28 +35,31 @@ { "name": "spacing_cross_ratio_median", "value": 0.9996077625644662 - }, - { - "name": "transfer_pixel_position_median", - "value": 10.465413785361328, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_pixel_position_p95", - "value": 26.295214680110742, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_spacing_along_ratio_median", - "value": 0.9999908099704082, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_spacing_cross_ratio_median", - "value": 1.0013790873553656, - "scope": "noaa-21, 2026-11-05" } ], + "transfers": { + "noaa-21": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pixel_position_median", + "value": 10.465413785361328 + }, + { + "name": "pixel_position_p95", + "value": 26.295214680110742 + }, + { + "name": "spacing_along_ratio_median", + "value": 0.9999908099704082 + }, + { + "name": "spacing_cross_ratio_median", + "value": 1.0013790873553656 + } + ] + } + }, "fixture_metrics": { "sample_size_within_3pct": 100.0, "pixel_position_median": 2.8692399074004333, @@ -65,13 +69,14 @@ }, "swath_noaa_20": { "digest": "b05ed81204ec49166c38805c94b006e2f976ddcb3019d4860a7334924f5cfb4a", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_atms.py", "reference": "ATMS SDR geolocation", "period": "2026-08-12", - "platform": "noaa-20", - "holdout_gap_days": 51, + "platforms": [ + "noaa-20" + ], "metrics": [ { "name": "pass_recall", @@ -92,33 +97,35 @@ { "name": "footprint_iou_median", "value": 0.9989132282156962 - }, - { - "name": "transfer_pass_recall", - "value": 99.98644435407347, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_pass_precision", - "value": 99.54116059379217, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_epoch_p95", - "value": 3.293412317, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_swath_width_median", - "value": 13.908579539331608, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median", - "value": 0.9948722191554508, - "scope": "noaa-21, 2026-11-05" } ], + "transfers": { + "noaa-21": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pass_recall", + "value": 99.98644435407347 + }, + { + "name": "pass_precision", + "value": 99.54116059379217 + }, + { + "name": "epoch_p95", + "value": 3.293412317 + }, + { + "name": "swath_width_median", + "value": 13.908579539331608 + }, + { + "name": "footprint_iou_median", + "value": 0.9948722191554508 + } + ] + } + }, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.21595644864999994 @@ -126,13 +133,14 @@ }, "beams_noaa_21": { "digest": "1d3bd90a9b9d472ec640d20deec56627cd4f3ff0cfadb71b6fc55188f7b29b31", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_atms.py", "reference": "Footprints of the TC PRIMED documentation; beam centers of the ATMS SDR geolocation", "period": "2026-10-02", - "platform": "noaa-21", - "holdout_gap_days": 34, + "platforms": [ + "noaa-21" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -159,6 +167,7 @@ "value": 0.9994635130399332 } ], + "transfers": {}, "fixture_metrics": { "sample_size_within_3pct": 100.0, "pixel_position_median": 3.0711510048337605, @@ -168,13 +177,14 @@ }, "swath_noaa_21": { "digest": "a688ecbd6aa004f86243d81cd600f88b7c6666c27710bbafbcf847afd43c9aaf", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_atms.py", "reference": "ATMS SDR geolocation", "period": "2026-10-02", - "platform": "noaa-21", - "holdout_gap_days": 34, + "platforms": [ + "noaa-21" + ], "metrics": [ { "name": "pass_recall", @@ -197,11 +207,11 @@ "value": 0.9955844942739329 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.2672554863499998 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/avhrr.json b/src/tatc/resources/validation/avhrr.json index 905f81c1..163704d7 100644 --- a/src/tatc/resources/validation/avhrr.json +++ b/src/tatc/resources/validation/avhrr.json @@ -3,13 +3,14 @@ "configurations": { "pixels": { "digest": "dcfebefeca4069deec30f6a8c67926425d988e24586907d48c43d7a6695f952e", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_avhrr.py", "reference": "Footprint published by the NWP SAF; sample positions of AVHRRF_MC-STAR-L2P version 2.80", "period": "2026-10-03", - "platform": "metop-c", - "holdout_gap_days": 33, + "platforms": [ + "metop-c" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -34,28 +35,31 @@ { "name": "spacing_cross_ratio_median", "value": 0.9995512240575739 - }, - { - "name": "transfer_pixel_position_median", - "value": 3.5772483028056428, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_pixel_position_p95", - "value": 10.562146610291842, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_spacing_along_ratio_median", - "value": 1.0001178280515057, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_spacing_cross_ratio_median", - "value": 0.998824579342425, - "scope": "metop-b, 2026-11-05" } ], + "transfers": { + "metop-b": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pixel_position_median", + "value": 3.5772483028056428 + }, + { + "name": "pixel_position_p95", + "value": 10.562146610291842 + }, + { + "name": "spacing_along_ratio_median", + "value": 1.0001178280515057 + }, + { + "name": "spacing_cross_ratio_median", + "value": 0.998824579342425 + } + ] + } + }, "fixture_metrics": { "sample_size_within_3pct": 0.0, "pixel_position_median": 0.4312066820797901, @@ -65,13 +69,14 @@ }, "swath": { "digest": "bf446fbb3e2739c9e8abeb1755bccd57cf220b8259840979cdb26d3fca1f6edd", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_avhrr.py", "reference": "AVHRRF_MC-STAR-L2P version 2.80 (sample positions and times)", "period": "2026-10-03", - "platform": "metop-c", - "holdout_gap_days": 33, + "platforms": [ + "metop-c" + ], "metrics": [ { "name": "pass_recall", @@ -92,38 +97,39 @@ { "name": "footprint_iou_median", "value": 0.9941550719962053 - }, - { - "name": "transfer_pass_recall", - "value": 99.63817185826039, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_pass_precision", - "value": 99.8015792670581, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_epoch_p95", - "value": 0.9961136716499998, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_swath_width_median", - "value": 4.809549974447349, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median", - "value": 0.9934098601993996, - "scope": "metop-b, 2026-11-05" } ], + "transfers": { + "metop-b": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pass_recall", + "value": 99.63817185826039 + }, + { + "name": "pass_precision", + "value": 99.8015792670581 + }, + { + "name": "epoch_p95", + "value": 0.9961136716499998 + }, + { + "name": "swath_width_median", + "value": 4.809549974447349 + }, + { + "name": "footprint_iou_median", + "value": 0.9934098601993996 + } + ] + } + }, "fixture_metrics": { "passes_found": 98.33333333333333, "epoch_p95": 0.15150611120000002 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/bbr.json b/src/tatc/resources/validation/bbr.json index 86903da8..b0227a27 100644 --- a/src/tatc/resources/validation/bbr.json +++ b/src/tatc/resources/validation/bbr.json @@ -3,13 +3,14 @@ "configurations": { "views": { "digest": "6287376998a9ec6e1230e2850df062d2266f5336b5e7d8c4d2601a4d98de31e5", - "evidence": "rerun", + "standard_version": 6, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_bbr.py", "reference": "BBR_SNG_1B (pixel positions of the shortwave band, every second line)", "period": "2026-11-07", - "platform": "earthcare", - "holdout_gap_days": 41, + "platforms": [ + "earthcare" + ], "metrics": [ { "name": "pass_recall", @@ -87,11 +88,11 @@ "scope": "FORE" } ], + "transfers": {}, "fixture_metrics": { "passes_found": 96.66666666666667, "epoch_p95": 0.501839136 } } - }, - "standard_version": 6 + } } diff --git a/src/tatc/resources/validation/ceres.json b/src/tatc/resources/validation/ceres.json index 02984139..b20c3e7a 100644 --- a/src/tatc/resources/validation/ceres.json +++ b/src/tatc/resources/validation/ceres.json @@ -3,13 +3,14 @@ "configurations": { "swath": { "digest": "502da50334b599f443ad05a8fe9238e13cb97975974b8987353f1a5a7567bbb0", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_ceres.py", "reference": "CER_ES8_NOAA20-FM6 Edition1 (footprint positions, projected to the ellipsoid, and times)", "period": "2026-09-30", - "platform": "noaa-20", - "holdout_gap_days": 36, + "platforms": [ + "noaa-20" + ], "metrics": [ { "name": "pass_recall", @@ -32,11 +33,11 @@ "value": 0.9994761831424892 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.23780964599999993 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/cpr.json b/src/tatc/resources/validation/cpr.json index 85e0fb52..0545a9c4 100644 --- a/src/tatc/resources/validation/cpr.json +++ b/src/tatc/resources/validation/cpr.json @@ -3,13 +3,14 @@ "configurations": { "nadir": { "digest": "c71562f90b481806dbdbe5d458988cfe622d6e7d4708514f6b7edb1471ab5bcd", - "evidence": "rerun", + "standard_version": 6, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_cpr.py", "reference": "CPR_NOM_1B (profile positions and times)", "period": "2026-11-07", - "platform": "earthcare", - "holdout_gap_days": 41, + "platforms": [ + "earthcare" + ], "metrics": [ { "name": "segment_recall", @@ -28,11 +29,11 @@ "value": 0.2038715585 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.4574536675499999 } } - }, - "standard_version": 6 + } } diff --git a/src/tatc/resources/validation/cris.json b/src/tatc/resources/validation/cris.json index dbd8fa08..49aaca95 100644 --- a/src/tatc/resources/validation/cris.json +++ b/src/tatc/resources/validation/cris.json @@ -3,13 +3,14 @@ "configurations": { "pixels": { "digest": "14a2de8b4b2b0fc73bbbd5b728623007b4ecbb20458ddd89c86d64d29dfc9f1c", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_cris.py", "reference": "Footprints published by the NWP SAF; fields of view of the CrIS SDR geolocation", "period": "2026-08-12", - "platform": "noaa-20", - "holdout_gap_days": 51, + "platforms": [ + "noaa-20" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -30,18 +31,23 @@ { "name": "pixel_position_central_median", "value": 10.012495649217449 - }, - { - "name": "transfer_pixel_position_median", - "value": 12.265464759977313, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_pixel_position_p95", - "value": 43.828535562194325, - "scope": "noaa-21, 2026-11-05" } ], + "transfers": { + "noaa-21": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pixel_position_median", + "value": 12.265464759977313 + }, + { + "name": "pixel_position_p95", + "value": 43.828535562194325 + } + ] + } + }, "fixture_metrics": { "sample_size_within_3pct": 75.0, "pixel_position_median": 10.13770124804699 @@ -49,13 +55,14 @@ }, "swath": { "digest": "fc32ce15a3780ef5596decc7d4a8c2f7bd27c888973cfe6adeec5e19d98ad616", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_cris.py", "reference": "CrIS SDR geolocation", "period": "2026-08-12", - "platform": "noaa-20", - "holdout_gap_days": 51, + "platforms": [ + "noaa-20" + ], "metrics": [ { "name": "pass_recall", @@ -76,38 +83,39 @@ { "name": "footprint_iou_median", "value": 0.9961643275378533 - }, - { - "name": "transfer_pass_recall", - "value": 99.8507710164152, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_pass_precision", - "value": 99.9667994687915, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_epoch_p95", - "value": 1.1227140565999998, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_swath_width_median", - "value": 2.099583696063026, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median", - "value": 0.9984279738261294, - "scope": "noaa-21, 2026-11-05" } ], + "transfers": { + "noaa-21": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pass_recall", + "value": 99.8507710164152 + }, + { + "name": "pass_precision", + "value": 99.9667994687915 + }, + { + "name": "epoch_p95", + "value": 1.1227140565999998 + }, + { + "name": "swath_width_median", + "value": 2.099583696063026 + }, + { + "name": "footprint_iou_median", + "value": 0.9984279738261294 + } + ] + } + }, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.28104180079999985 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/csar.json b/src/tatc/resources/validation/csar.json index 29188ca6..e6708f3a 100644 --- a/src/tatc/resources/validation/csar.json +++ b/src/tatc/resources/validation/csar.json @@ -3,13 +3,14 @@ "configurations": { "iw": { "digest": "a4281159073196f40a8cb313b9f2ee4f726cfb95a0a68f2f494347f332dd405c", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_csar.py", "reference": "Geolocation grids and restituted orbits of the annotations of Sentinel-1 Level-1 GRD products", "period": "2026-08-12", - "platform": "sentinel-1c", - "holdout_gap_days": 51, + "platforms": [ + "sentinel-1c" + ], "metrics": [ { "name": "pass_recall", @@ -62,63 +63,59 @@ { "name": "epoch_median", "value": -0.05725999500000001 - }, - { - "name": "transfer_pass_recall", - "value": 98.63574351978171, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_swath_edge_p95_near_range", - "value": 6.578916929712105, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_swath_edge_p95_far_range", - "value": 7.8387009808722805, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median_time_step_10_s", - "value": 0.9744452010937642, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_p5_time_step_10_s", - "value": 0.9565603985068362, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median_time_step_30_s", - "value": 0.9744442113156698, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_p5_time_step_30_s", - "value": 0.9565604000666803, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median_time_step_120_s", - "value": 0.9744435423361394, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_p5_time_step_120_s", - "value": 0.9565604155573993, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_epoch_p95", - "value": 0.44427412699999996, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_epoch_median", - "value": 0.040464019, - "scope": "sentinel-1d, 2026-11-05" } ], + "transfers": { + "sentinel-1d": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pass_recall", + "value": 98.63574351978171 + }, + { + "name": "swath_edge_p95_near_range", + "value": 6.578916929712105 + }, + { + "name": "swath_edge_p95_far_range", + "value": 7.8387009808722805 + }, + { + "name": "footprint_iou_median_time_step_10_s", + "value": 0.9744452010937642 + }, + { + "name": "footprint_iou_p5_time_step_10_s", + "value": 0.9565603985068362 + }, + { + "name": "footprint_iou_median_time_step_30_s", + "value": 0.9744442113156698 + }, + { + "name": "footprint_iou_p5_time_step_30_s", + "value": 0.9565604000666803 + }, + { + "name": "footprint_iou_median_time_step_120_s", + "value": 0.9744435423361394 + }, + { + "name": "footprint_iou_p5_time_step_120_s", + "value": 0.9565604155573993 + }, + { + "name": "epoch_p95", + "value": 0.44427412699999996 + }, + { + "name": "epoch_median", + "value": 0.040464019 + } + ] + } + }, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.44815166794999994 @@ -126,13 +123,14 @@ }, "ew": { "digest": "d4db44c916245f35b65999b72767e909314348279335144b5abdfc3b64e624b1", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_csar.py", "reference": "Geolocation grids and restituted orbits of the annotations of Sentinel-1 Level-1 GRD products", "period": "2026-11-10", - "platform": "sentinel-1c", - "holdout_gap_days": 39, + "platforms": [ + "sentinel-1c" + ], "metrics": [ { "name": "pass_recall", @@ -185,68 +183,63 @@ { "name": "epoch_median", "value": -0.060779662999999984 - }, - { - "name": "transfer_pass_recall", - "value": 98.69020501138952, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_swath_edge_p95_near_range", - "value": 7.5611920183202725, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_swath_edge_p95_far_range", - "value": 11.056278170799077, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median_time_step_10_s", - "value": 0.9884457495183735, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_p5_time_step_10_s", - "value": 0.9622722405977889, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median_time_step_30_s", - "value": 0.9884461417226443, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_p5_time_step_30_s", - "value": 0.9622723000479346, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median_time_step_120_s", - "value": 0.9884458216809694, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_p5_time_step_120_s", - "value": 0.9622722346932403, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_epoch_p95", - "value": 0.3822467272499999, - "scope": "sentinel-1d, 2026-11-05" - }, - { - "name": "transfer_epoch_median", - "value": -0.046273713999999966, - "scope": "sentinel-1d, 2026-11-05" } ], + "transfers": { + "sentinel-1d": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pass_recall", + "value": 98.69020501138952 + }, + { + "name": "swath_edge_p95_near_range", + "value": 7.5611920183202725 + }, + { + "name": "swath_edge_p95_far_range", + "value": 11.056278170799077 + }, + { + "name": "footprint_iou_median_time_step_10_s", + "value": 0.9884457495183735 + }, + { + "name": "footprint_iou_p5_time_step_10_s", + "value": 0.9622722405977889 + }, + { + "name": "footprint_iou_median_time_step_30_s", + "value": 0.9884461417226443 + }, + { + "name": "footprint_iou_p5_time_step_30_s", + "value": 0.9622723000479346 + }, + { + "name": "footprint_iou_median_time_step_120_s", + "value": 0.9884458216809694 + }, + { + "name": "footprint_iou_p5_time_step_120_s", + "value": 0.9622722346932403 + }, + { + "name": "epoch_p95", + "value": 0.3822467272499999 + }, + { + "name": "epoch_median", + "value": -0.046273713999999966 + } + ] + } + }, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.32735908755 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/dpr.json b/src/tatc/resources/validation/dpr.json index 9097c035..2c5d34f4 100644 --- a/src/tatc/resources/validation/dpr.json +++ b/src/tatc/resources/validation/dpr.json @@ -3,13 +3,14 @@ "configurations": { "beams": { "digest": "9160f56cc9b93ca21570ce108b105c8cb7ee2e1b36f2ab9557c787700cff06af", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_dpr.py", "reference": "Footprints of the TC PRIMED documentation; beam positions of GPM_2ADPR version 08", "period": "2026-11-10", - "platform": "gpm", - "holdout_gap_days": 38, + "platforms": [ + "gpm" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -36,6 +37,7 @@ "value": 0.9997279049149927 } ], + "transfers": {}, "fixture_metrics": { "sample_size_within_3pct": 100.0, "pixel_position_median": 1.4406098527651623, @@ -45,13 +47,14 @@ }, "swath": { "digest": "882b5b5f11d8ad70d370902f965b65f3557a5a70d58ea9cb444c02d5e94b5f85", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_dpr.py", "reference": "GPM_2ADPR version 08 (beam positions of the full swath)", "period": "2026-11-10", - "platform": "gpm", - "holdout_gap_days": 38, + "platforms": [ + "gpm" + ], "metrics": [ { "name": "pass_recall", @@ -74,11 +77,11 @@ "value": 0.996068973072096 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.5795258645499999 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/earthcare_msi.json b/src/tatc/resources/validation/earthcare_msi.json index 69291c5d..c70538fc 100644 --- a/src/tatc/resources/validation/earthcare_msi.json +++ b/src/tatc/resources/validation/earthcare_msi.json @@ -3,13 +3,14 @@ "configurations": { "swath": { "digest": "b686125d467695ed4e9e8819886ed578b9b5b4450bf6a5cf152ec7eb72067dc4", - "evidence": "rerun", + "standard_version": 6, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_earthcare_msi.py", "reference": "MSI_RGR_1C (pixel positions of every fourth orbit, every eighth line), with spacecraft positions of ATL_NOM_1B", "period": "2026-11-07", - "platform": "earthcare", - "holdout_gap_days": 41, + "platforms": [ + "earthcare" + ], "metrics": [ { "name": "pass_recall", @@ -32,11 +33,11 @@ "value": 0.989315821762553 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.5024910009499999 } } - }, - "standard_version": 6 + } } diff --git a/src/tatc/resources/validation/ecostress.json b/src/tatc/resources/validation/ecostress.json index a198d0af..c37426af 100644 --- a/src/tatc/resources/validation/ecostress.json +++ b/src/tatc/resources/validation/ecostress.json @@ -3,13 +3,14 @@ "configurations": { "swath": { "digest": "86d9d7f5ab5a5e0223abd434f481c70367c2182691922da307a3fe9523e3eafc", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_ecostress.py", "reference": "ECO_L1B_GEO version 002 (sample positions and times of every fourth sweep, in blocks of eight consecutive scenes of every 32)", "period": "2026-11-08", - "platform": "iss", - "holdout_gap_days": 35, + "platforms": [ + "iss" + ], "metrics": [ { "name": "pass_recall", @@ -32,11 +33,11 @@ "value": 0.9883062031327718 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.7579137259 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/emit.json b/src/tatc/resources/validation/emit.json index 187fc6ac..480d9020 100644 --- a/src/tatc/resources/validation/emit.json +++ b/src/tatc/resources/validation/emit.json @@ -3,13 +3,14 @@ "configurations": { "swath": { "digest": "75e98ffbe9347dbffa3aae71f348097c01a6911aa947abaf47b98d264a728327", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_emit.py", "reference": "EMITL1BRAD version 002, observation geometry (pixel positions and line times of every 16th line)", "period": "2026-11-08", - "platform": "iss", - "holdout_gap_days": 35, + "platforms": [ + "iss" + ], "metrics": [ { "name": "pass_recall", @@ -32,11 +33,11 @@ "value": 0.9253723173007395 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 93.33333333333333, "epoch_p95": 0.23672306925 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/gedi.json b/src/tatc/resources/validation/gedi.json index 6c4966b8..52c9242b 100644 --- a/src/tatc/resources/validation/gedi.json +++ b/src/tatc/resources/validation/gedi.json @@ -3,13 +3,14 @@ "configurations": { "beams": { "digest": "c91a076745f0c7ae78527f94f525be947c12960c33fa2cac0922f8782de7bfd9", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_gedi.py", "reference": "GEDI01_B version 003 (every 200th shot, where the beams' center lies within 1 deg of nadir)", "period": "2026-06-08", - "platform": "iss", - "holdout_gap_days": 38, + "platforms": [ + "iss" + ], "metrics": [ { "name": "segment_recall", @@ -61,11 +62,11 @@ "value": 0.026380082429530827 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 1.5583851070999999 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/gmi.json b/src/tatc/resources/validation/gmi.json index 07486476..8df25e45 100644 --- a/src/tatc/resources/validation/gmi.json +++ b/src/tatc/resources/validation/gmi.json @@ -1,16 +1,16 @@ { "entry_id": "gmi", - "standard_version": 1, "configurations": { "feeds": { "digest": "7a88b43962de1f39c462f46e95dc206ac99e019a77f2be98e888feb45e7bf499", - "evidence": "rerun", + "standard_version": 1, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_gmi.py", "reference": "GPM_1CGPMGMI version 08", "period": "2026-07-20", - "platform": "gpm", - "holdout_gap_days": 75, + "platforms": [ + "gpm" + ], "metrics": [ { "name": "pass_recall", @@ -63,6 +63,7 @@ "scope": "S2" } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.637898751 @@ -70,13 +71,14 @@ }, "sample_size": { "digest": "5ea1adca77c77a9d04b7cb4f546c8c456c1ab0ce5a14d041277a7e0d4fe23a6f", - "evidence": "rerun", + "standard_version": 1, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_gmi.py", "reference": "Footprints of the GMI L1B ATBD and TC PRIMED; spacing of GPM_1CGPMGMI version 08", "period": "2026-07-20", - "platform": "gpm", - "holdout_gap_days": 75, + "platforms": [ + "gpm" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -107,6 +109,7 @@ "scope": "S2" } ], + "transfers": {}, "fixture_metrics": { "sample_size_within_3pct": 100.0, "spacing_arc_ratio_median_S1": 1.0071002751057956, diff --git a/src/tatc/resources/validation/harp2.json b/src/tatc/resources/validation/harp2.json index ac5d1152..5267dbbe 100644 --- a/src/tatc/resources/validation/harp2.json +++ b/src/tatc/resources/validation/harp2.json @@ -3,13 +3,14 @@ "configurations": { "swath": { "digest": "dbbda9bbb91e8bfad0332d07dc4e83711dcebe054f8d7c1450c687b22efb47bd", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_harp2.py", "reference": "PACE_HARP2_L1B_SCI version 4 (positions and times of the near-nadir view)", "period": "2026-11-07", - "platform": "pace", - "holdout_gap_days": 34, + "platforms": [ + "pace" + ], "metrics": [ { "name": "pass_recall", @@ -32,11 +33,11 @@ "value": 0.9995809395635673 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.42397417094999984 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/iasi.json b/src/tatc/resources/validation/iasi.json index 9d1ef24c..a8861935 100644 --- a/src/tatc/resources/validation/iasi.json +++ b/src/tatc/resources/validation/iasi.json @@ -3,13 +3,14 @@ "configurations": { "pixels": { "digest": "dd12e9608ac7a89c6963aaa4f142712a52e4bd9926747a972cb2e3b0e1d199fd", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_iasi.py", "reference": "Published footprints; pixel positions of the OSI SAF IASI sea surface temperature product", "period": "2026-11-04", - "platform": "metop-b", - "holdout_gap_days": 32, + "platforms": [ + "metop-b" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -36,6 +37,7 @@ "value": 0.9975775507546547 } ], + "transfers": {}, "fixture_metrics": { "sample_size_within_3pct": 75.0, "pixel_position_median": 1.8465413045951906, @@ -45,13 +47,14 @@ }, "swath": { "digest": "69373d1399c8f165b3493f371cf6cd0240848b48c01476ba7ad90fe7c647d36a", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_iasi.py", "reference": "Pixel positions of the OSI SAF IASI sea surface temperature product", "period": "2026-11-04", - "platform": "metop-b", - "holdout_gap_days": 32, + "platforms": [ + "metop-b" + ], "metrics": [ { "name": "pass_recall", @@ -78,11 +81,11 @@ "value": 0.9977234918616522 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.39956124489999995 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/karin.json b/src/tatc/resources/validation/karin.json index 49eced81..96c2261a 100644 --- a/src/tatc/resources/validation/karin.json +++ b/src/tatc/resources/validation/karin.json @@ -3,13 +3,14 @@ "configurations": { "swaths": { "digest": "59e40263c6b54b186c1ce9b1e424f117c7b8adb14ed319fff9d15b8ddf7ab67d", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_karin.py", "reference": "SWOT_L2_LR_SSH_BASIC_D (good-quality pixels and line times)", "period": "2026-11-04", - "platform": "swot", - "holdout_gap_days": 34, + "platforms": [ + "swot" + ], "metrics": [ { "name": "pass_recall", @@ -74,11 +75,11 @@ "value": -0.335281265 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.5138719532999999 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/lsar.json b/src/tatc/resources/validation/lsar.json index b4d437a5..54fca5a2 100644 --- a/src/tatc/resources/validation/lsar.json +++ b/src/tatc/resources/validation/lsar.json @@ -3,13 +3,14 @@ "configurations": { "swath_20_40mhz": { "digest": "e67e1e5d49acea59d3d35bca921f519a83dd3d31f98c548fb6e2ba0baf85407f", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_lsar.py", "reference": "Geolocation grids, orbits, and bounding polygons of NISAR Level 1 RSLC products", "period": "2026-11-04", - "platform": "nisar", - "holdout_gap_days": 33, + "platforms": [ + "nisar" + ], "metrics": [ { "name": "pass_recall", @@ -64,6 +65,7 @@ "value": -0.678647302 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.9402862115499999 @@ -71,13 +73,14 @@ }, "swath_5mhz": { "digest": "f8b48d01faf157ff78d710527be59e46478af30b6b114a004d996af433de4874", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_lsar.py", "reference": "Geolocation grids, orbits, and bounding polygons of NISAR Level 1 RSLC products", "period": "2026-11-04", - "platform": "nisar", - "holdout_gap_days": 33, + "platforms": [ + "nisar" + ], "metrics": [ { "name": "pass_recall", @@ -132,6 +135,7 @@ "value": -0.352374686 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.36542056 @@ -139,13 +143,14 @@ }, "swath_77mhz": { "digest": "487fa95b160e4567932ce285f6396f7222da083e56cc66a112cab00f0f4bf6f2", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_lsar.py", "reference": "Geolocation grids, orbits, and bounding polygons of NISAR Level 1 RSLC products", "period": "2026-11-01, 2026-11-02, 2026-11-03, 2026-11-05", - "platform": "nisar", - "holdout_gap_days": 30, + "platforms": [ + "nisar" + ], "metrics": [ { "name": "pass_recall", @@ -170,11 +175,11 @@ "value": -0.02563027200000001 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.1304822434 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/mhs.json b/src/tatc/resources/validation/mhs.json index 9c441a4b..e583655c 100644 --- a/src/tatc/resources/validation/mhs.json +++ b/src/tatc/resources/validation/mhs.json @@ -3,13 +3,14 @@ "configurations": { "beams": { "digest": "291de4c0921c1c0341917876fe99e671a10e1e212e6066f5c5ee2bb79b980eba", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_mhs.py", "reference": "Footprints of the TC PRIMED documentation; beam positions of GPM_1CMETOPCMHS version 08", "period": "2026-10-05", - "platform": "metop-c", - "holdout_gap_days": 31, + "platforms": [ + "metop-c" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -34,28 +35,31 @@ { "name": "spacing_cross_ratio_median", "value": 0.9997300910893527 - }, - { - "name": "transfer_pixel_position_median", - "value": 5.967680944473871, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_pixel_position_p95", - "value": 11.102676423572087, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_spacing_along_ratio_median", - "value": 1.000322520547596, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_spacing_cross_ratio_median", - "value": 0.9997213580621862, - "scope": "metop-b, 2026-11-05" } ], + "transfers": { + "metop-b": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pixel_position_median", + "value": 5.967680944473871 + }, + { + "name": "pixel_position_p95", + "value": 11.102676423572087 + }, + { + "name": "spacing_along_ratio_median", + "value": 1.000322520547596 + }, + { + "name": "spacing_cross_ratio_median", + "value": 0.9997213580621862 + } + ] + } + }, "fixture_metrics": { "sample_size_within_3pct": 100.0, "pixel_position_median": 5.775344627565959, @@ -65,13 +69,14 @@ }, "swath": { "digest": "5f1d822acf8ea40bca9f0338de998fa0673b72b47e2a05ccec8cd25acd049d1d", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_mhs.py", "reference": "GPM_1CMETOPCMHS version 08 (beam positions)", "period": "2026-10-05", - "platform": "metop-c", - "holdout_gap_days": 31, + "platforms": [ + "metop-c" + ], "metrics": [ { "name": "pass_recall", @@ -92,38 +97,39 @@ { "name": "footprint_iou_median", "value": 0.9990627777941308 - }, - { - "name": "transfer_pass_recall", - "value": 100.0, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_pass_precision", - "value": 100.0, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_epoch_p95", - "value": 1.7365758375, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_swath_width_median", - "value": 0.7861793352242094, - "scope": "metop-b, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median", - "value": 0.9990795352690144, - "scope": "metop-b, 2026-11-05" } ], + "transfers": { + "metop-b": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pass_recall", + "value": 100.0 + }, + { + "name": "pass_precision", + "value": 100.0 + }, + { + "name": "epoch_p95", + "value": 1.7365758375 + }, + { + "name": "swath_width_median", + "value": 0.7861793352242094 + }, + { + "name": "footprint_iou_median", + "value": 0.9990795352690144 + } + ] + } + }, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 1.63393000305 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/modis.json b/src/tatc/resources/validation/modis.json index a7ce8b6b..e10110b4 100644 --- a/src/tatc/resources/validation/modis.json +++ b/src/tatc/resources/validation/modis.json @@ -3,13 +3,14 @@ "configurations": { "pixels": { "digest": "a518db197f63a99221d3e01edef2bb6e9e17d9e5c01951d6102e5931b86eafcc", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_modis.py", "reference": "Footprints published by NASA LAADS; MOD03 geolocation", "period": "2026-11-05", - "platform": "terra", - "holdout_gap_days": 32, + "platforms": [ + "terra" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -34,28 +35,31 @@ { "name": "spacing_cross_ratio_median", "value": 0.9999225631079388 - }, - { - "name": "transfer_pixel_position_median", - "value": 1.8119314703862845, - "scope": "aqua, 2026-11-05" - }, - { - "name": "transfer_pixel_position_p95", - "value": 3.8946324062800604, - "scope": "aqua, 2026-11-05" - }, - { - "name": "transfer_spacing_along_ratio_median", - "value": 0.9999624256280701, - "scope": "aqua, 2026-11-05" - }, - { - "name": "transfer_spacing_cross_ratio_median", - "value": 0.9998962197197073, - "scope": "aqua, 2026-11-05" } ], + "transfers": { + "aqua": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pixel_position_median", + "value": 1.8119314703862845 + }, + { + "name": "pixel_position_p95", + "value": 3.8946324062800604 + }, + { + "name": "spacing_along_ratio_median", + "value": 0.9999624256280701 + }, + { + "name": "spacing_cross_ratio_median", + "value": 0.9998962197197073 + } + ] + } + }, "fixture_metrics": { "sample_size_within_3pct": 100.0, "pixel_position_median": 1.5303687163298507, @@ -65,13 +69,14 @@ }, "swath": { "digest": "33de100f7a41137444b388fab6660034b57488ec2bf39af2b7d22fb265c2c104", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_modis.py", "reference": "MOD03 geolocation", "period": "2026-11-05", - "platform": "terra", - "holdout_gap_days": 32, + "platforms": [ + "terra" + ], "metrics": [ { "name": "pass_recall", @@ -92,38 +97,39 @@ { "name": "footprint_iou_median", "value": 0.997479756905639 - }, - { - "name": "transfer_pass_recall", - "value": 100.0, - "scope": "aqua, 2026-11-05" - }, - { - "name": "transfer_pass_precision", - "value": 99.06787066705505, - "scope": "aqua, 2026-11-05" - }, - { - "name": "transfer_epoch_p95", - "value": 0.41956022709999996, - "scope": "aqua, 2026-11-05" - }, - { - "name": "transfer_swath_width_median", - "value": 1.5080473417232279, - "scope": "aqua, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median", - "value": 0.9979547218582268, - "scope": "aqua, 2026-11-05" } ], + "transfers": { + "aqua": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pass_recall", + "value": 100.0 + }, + { + "name": "pass_precision", + "value": 99.06787066705505 + }, + { + "name": "epoch_p95", + "value": 0.41956022709999996 + }, + { + "name": "swath_width_median", + "value": 1.5080473417232279 + }, + { + "name": "footprint_iou_median", + "value": 0.9979547218582268 + } + ] + } + }, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.41702069909999995 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/msi.json b/src/tatc/resources/validation/msi.json index 040b57fa..88bc077a 100644 --- a/src/tatc/resources/validation/msi.json +++ b/src/tatc/resources/validation/msi.json @@ -3,13 +3,16 @@ "configurations": { "swath": { "digest": "1c2ee659e3483a7f968250f7d5304b6ebaa8318bf52a34f599f927c2e69cf4d5", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_msi.py", "reference": "Valid data footprints of Sentinel-2 Level-2A tiles; viewing angle grids and GPS ephemerides of their metadata", "period": "2026-11-10", - "platform": "sentinel-2a, sentinel-2b, sentinel-2c", - "holdout_gap_days": 38, + "platforms": [ + "sentinel-2a", + "sentinel-2b", + "sentinel-2c" + ], "metrics": [ { "name": "swath_width_median", @@ -162,11 +165,11 @@ "scope": "sentinel-2c, time step 120 s" } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 2.40976103835 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/oci.json b/src/tatc/resources/validation/oci.json index 9cf81564..00b138f9 100644 --- a/src/tatc/resources/validation/oci.json +++ b/src/tatc/resources/validation/oci.json @@ -3,13 +3,14 @@ "configurations": { "swath": { "digest": "fbfdc468489c8229a04346c1416405cc9aec8a33ed0e9167dc347205575b2878", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_oci.py", "reference": "PACE_OCI_L1B_SCI version 3 (sample positions and times)", "period": "2026-11-10", - "platform": "pace", - "holdout_gap_days": 33, + "platforms": [ + "pace" + ], "metrics": [ { "name": "pass_recall", @@ -32,11 +33,11 @@ "value": 0.9971063735252174 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.44427739664999993 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/oco2.json b/src/tatc/resources/validation/oco2.json index 71f7335f..343ba118 100644 --- a/src/tatc/resources/validation/oco2.json +++ b/src/tatc/resources/validation/oco2.json @@ -3,13 +3,14 @@ "configurations": { "nadir": { "digest": "c449b1266d6a9d23c6f2a3f31c5c29627153d562b2fd4e8802a6bea6b16551fb", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_oco2.py", "reference": "OCO2_L1B_Science version 11.2 (sounding positions and times, nadir orbits)", "period": "2026-11-07", - "platform": "oco-2", - "holdout_gap_days": 34, + "platforms": [ + "oco-2" + ], "metrics": [ { "name": "pass_recall", @@ -32,6 +33,7 @@ "value": 0.448221500705728 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 96.66666666666667, "epoch_p95": 0.8599056667499999 @@ -39,13 +41,14 @@ }, "glint": { "digest": "5e5e2514972d07b5ca4809fe207647ffce5e74c174837b9fe02d2717dc872f37", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_oco2.py", "reference": "OCO2_L1B_Science version 11.2 (sounding positions and times, glint orbits)", "period": "2026-11-07", - "platform": "oco-2", - "holdout_gap_days": 34, + "platforms": [ + "oco-2" + ], "metrics": [ { "name": "pass_recall", @@ -68,11 +71,11 @@ "value": 0.4077767374507504 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 91.66666666666666, "epoch_p95": 1.2700150375999997 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/olci.json b/src/tatc/resources/validation/olci.json index 9e9b8504..9738ecb8 100644 --- a/src/tatc/resources/validation/olci.json +++ b/src/tatc/resources/validation/olci.json @@ -3,13 +3,14 @@ "configurations": { "swath": { "digest": "1c621fd237a9da173904db099c16b3b49999262d3e3f7e755ea2a833232d9488", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_olci.py", "reference": "S3A_OL_1_EFR (tie point positions and times)", "period": "2026-11-04", - "platform": "sentinel-3a", - "holdout_gap_days": 31, + "platforms": [ + "sentinel-3a" + ], "metrics": [ { "name": "pass_recall", @@ -32,11 +33,11 @@ "value": 0.9902064346272009 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.128510134 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/oli.json b/src/tatc/resources/validation/oli.json index 73493b85..0d8c26ff 100644 --- a/src/tatc/resources/validation/oli.json +++ b/src/tatc/resources/validation/oli.json @@ -3,13 +3,14 @@ "configurations": { "swath": { "digest": "37118d2d6c5b18ed3b50f4d03d80daae862f69e92a1b567032009ebc33855714", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_oli.py", "reference": "USGS Landsat Collection 2 scene footprints and center times; angle coefficient files of Level-2 products", "period": "2026-10-03", - "platform": "landsat-9", - "holdout_gap_days": 33, + "platforms": [ + "landsat-9" + ], "metrics": [ { "name": "pass_recall", @@ -38,48 +39,47 @@ { "name": "footprint_iou_p5", "value": 0.9832772502058373 - }, - { - "name": "transfer_pass_recall", - "value": 99.93434011818779, - "scope": "landsat-8, 2026-10-03" - }, - { - "name": "transfer_epoch_p95", - "value": 1.3622517328, - "scope": "landsat-8, 2026-10-03" - }, - { - "name": "transfer_epoch_median", - "value": 0.377211151, - "scope": "landsat-8, 2026-10-03" - }, - { - "name": "transfer_epoch_scene_center_p95", - "value": 0.5171684911, - "scope": "landsat-8, 2026-10-03" - }, - { - "name": "transfer_swath_width_median", - "value": 0.41581098942962125, - "scope": "landsat-8, 2026-10-03" - }, - { - "name": "transfer_footprint_iou_median", - "value": 0.9925913178292143, - "scope": "landsat-8, 2026-10-03" - }, - { - "name": "transfer_footprint_iou_p5", - "value": 0.983689751013026, - "scope": "landsat-8, 2026-10-03" } ], + "transfers": { + "landsat-8": { + "period": "2026-10-03", + "metrics": [ + { + "name": "pass_recall", + "value": 99.93434011818779 + }, + { + "name": "epoch_p95", + "value": 1.3622517328 + }, + { + "name": "epoch_median", + "value": 0.377211151 + }, + { + "name": "epoch_scene_center_p95", + "value": 0.5171684911 + }, + { + "name": "swath_width_median", + "value": 0.41581098942962125 + }, + { + "name": "footprint_iou_median", + "value": 0.9925913178292143 + }, + { + "name": "footprint_iou_p5", + "value": 0.983689751013026 + } + ] + } + }, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 1.25379784005 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/omps_nm.json b/src/tatc/resources/validation/omps_nm.json index 7cdd0d15..7f6c7eb7 100644 --- a/src/tatc/resources/validation/omps_nm.json +++ b/src/tatc/resources/validation/omps_nm.json @@ -3,13 +3,14 @@ "configurations": { "swath_noaa_21": { "digest": "f4c2a37a0a87cdc3c9d400e4430dce483b27b22ad12b55e827792524736430fe", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_omps.py", "reference": "OMPS-TC-GEO (sample positions and times), NOAA Open Data Dissemination", "period": "2026-11-05", - "platform": "noaa-21", - "holdout_gap_days": 35, + "platforms": [ + "noaa-21" + ], "metrics": [ { "name": "pass_recall", @@ -32,6 +33,7 @@ "value": 0.9900281696947634 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 18.04092930554999 @@ -39,13 +41,14 @@ }, "swath_noaa_20": { "digest": "4d3ad5fb855d592975f403f34904189470d57ae1c4e35e8c3f99b42fbe1c0e5e", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_omps.py", "reference": "OMPS-TC-GEO (sample positions and times), NOAA Open Data Dissemination", "period": "2026-11-05", - "platform": "noaa-20", - "holdout_gap_days": 35, + "platforms": [ + "noaa-20" + ], "metrics": [ { "name": "pass_recall", @@ -68,11 +71,11 @@ "value": 0.9950646182896654 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 19.3603290015 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/poseidon4.json b/src/tatc/resources/validation/poseidon4.json index 856a8be3..fff56a8e 100644 --- a/src/tatc/resources/validation/poseidon4.json +++ b/src/tatc/resources/validation/poseidon4.json @@ -3,12 +3,14 @@ "configurations": { "nadir": { "digest": "5270b7e4de6236de4a54677131ec62eefb5c29566aaf188925fd3b6b64fa6910", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_poseidon4.py", "reference": "JASON_CS_S6A_L2_ALT_LR_RED_OST_NRT_F (1 Hz measurement positions and times)", "period": "2026-11-07", - "platform": "sentinel-6a", + "platforms": [ + "sentinel-6a" + ], "metrics": [ { "name": "segment_recall", @@ -25,28 +27,31 @@ { "name": "epoch_median", "value": 0.014979299 - }, - { - "name": "transfer_segment_recall", - "value": 100.0, - "scope": "sentinel-6b, 2026-11-08" - }, - { - "name": "transfer_track_offset_median", - "value": 0.10737384730044729, - "scope": "sentinel-6b, 2026-11-08" - }, - { - "name": "transfer_epoch_p95", - "value": 0.11049452034999996, - "scope": "sentinel-6b, 2026-11-08" } ], + "transfers": { + "sentinel-6b": { + "period": "2026-11-08", + "metrics": [ + { + "name": "segment_recall", + "value": 100.0 + }, + { + "name": "track_offset_median", + "value": 0.10737384730044729 + }, + { + "name": "epoch_p95", + "value": 0.11049452034999996 + } + ] + } + }, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.1335472115499999 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/smap_radiometer.json b/src/tatc/resources/validation/smap_radiometer.json index 14b46ca4..a09bf020 100644 --- a/src/tatc/resources/validation/smap_radiometer.json +++ b/src/tatc/resources/validation/smap_radiometer.json @@ -3,13 +3,14 @@ "configurations": { "looks": { "digest": "ca3c6cdb3aea9144061cb5594ceefedb81608d68f34e565475ea76e6c9343efd", - "evidence": "rerun", + "standard_version": 2, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_smap.py", "reference": "SPL1BTB (footprint positions and times)", "period": "2026-09-20", - "platform": "smap", - "holdout_gap_days": 34, + "platforms": [ + "smap" + ], "metrics": [ { "name": "pass_recall", @@ -36,6 +37,7 @@ "value": 0.9975498341560446 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.14018917109999995 @@ -43,13 +45,14 @@ }, "footprints": { "digest": "8b58cf9ab3ef01c04ca505141a40751442adc77cb7a856db63baf865a53ce0de", - "evidence": "rerun", + "standard_version": 2, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_smap.py", "reference": "Footprints of Piepmeier et al. (2017) and the JPL SMAP specifications; spacing of SPL1BTB", "period": "2026-09-20", - "platform": "smap", - "holdout_gap_days": 34, + "platforms": [ + "smap" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -68,12 +71,12 @@ "value": 1.017490613864489 } ], + "transfers": {}, "fixture_metrics": { "sample_size_within_3pct": 50.0, "spacing_arc_ratio_median": 1.000688552543529, "spacing_scan_ratio_median": 1.0163489921080546 } } - }, - "standard_version": 2 + } } diff --git a/src/tatc/resources/validation/spexone.json b/src/tatc/resources/validation/spexone.json index 899145d3..23d29f29 100644 --- a/src/tatc/resources/validation/spexone.json +++ b/src/tatc/resources/validation/spexone.json @@ -3,13 +3,14 @@ "configurations": { "swath": { "digest": "c5506a9ce8f316f15800faa49ff680a5e44214d784e9b2f0451792de63f0706e", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_spexone.py", "reference": "PACE_SPEXONE_L1C_SCI version 4 (positions of bins and times of the nadir view)", "period": "2026-11-07", - "platform": "pace", - "holdout_gap_days": 34, + "platforms": [ + "pace" + ], "metrics": [ { "name": "pass_recall", @@ -32,11 +33,11 @@ "value": 0.9787303146603152 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.20900241199999994 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/ssmis.json b/src/tatc/resources/validation/ssmis.json index 064061be..b71c459d 100644 --- a/src/tatc/resources/validation/ssmis.json +++ b/src/tatc/resources/validation/ssmis.json @@ -3,13 +3,14 @@ "configurations": { "swath": { "digest": "9e367bd86d4b2e1cc8e2e50ad0eb46f83fca7b69ae489721bb074803817dd54a", - "evidence": "rerun", + "standard_version": 2, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_ssmis.py", "reference": "GPM_1CF18SSMIS version 08 (positions of the S1 samples)", "period": "2026-11-03", - "platform": "dmsp-f18", - "holdout_gap_days": 30, + "platforms": [ + "dmsp-f18" + ], "metrics": [ { "name": "pass_recall", @@ -32,11 +33,11 @@ "value": 0.9923645765603081 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.48150465934999936 } } - }, - "standard_version": 2 + } } diff --git a/src/tatc/resources/validation/tempo.json b/src/tatc/resources/validation/tempo.json index d1180167..c34db939 100644 --- a/src/tatc/resources/validation/tempo.json +++ b/src/tatc/resources/validation/tempo.json @@ -1,16 +1,16 @@ { "entry_id": "tempo", - "standard_version": 5, "configurations": { "field_of_regard": { "digest": "c44fd0bd205eb689dfdd9449710a57782ffbb7959072be988dd750364b234842", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_tempo.py", "reference": "TEMPO_RAD_L1 V04 (outer corners of the outermost pixels of a full scan, ultraviolet band)", "period": "2026-11-08T18:22Z", - "platform": "intelsat-40e", - "holdout_gap_days": 33, + "platforms": [ + "intelsat-40e" + ], "metrics": [ { "name": "field_of_regard_iou", @@ -29,6 +29,7 @@ "value": 100.0 } ], + "transfers": {}, "fixture_metrics": { "points_agreeing": 98.0 } diff --git a/src/tatc/resources/validation/tmi.json b/src/tatc/resources/validation/tmi.json index 37eb557b..3324c063 100644 --- a/src/tatc/resources/validation/tmi.json +++ b/src/tatc/resources/validation/tmi.json @@ -3,13 +3,14 @@ "configurations": { "sample_size": { "digest": "d3202819e316ccb7d2d81f515f2e37255dee46024cd2ba668b0e046bcc138a36", - "evidence": "rerun", + "standard_version": 6, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_tmi.py", "reference": "Footprints of the TC PRIMED documentation; spacing of GPM_1CTRMMTMI version 08", "period": "2013-07-10", - "platform": "trmm", - "holdout_gap_days": 39, + "platforms": [ + "trmm" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -50,6 +51,7 @@ "scope": "S3" } ], + "transfers": {}, "fixture_metrics": { "sample_size_within_3pct": 90.0, "spacing_arc_ratio_median_S1": 1.0063197849779906, @@ -62,13 +64,14 @@ }, "feeds": { "digest": "06706e6a6316ae9b6c8492e66e39647c96d8019283648a55f030b901a44bce48", - "evidence": "rerun", + "standard_version": 6, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_tmi.py", "reference": "GPM_1CTRMMTMI version 08 (positions of the S1, S2, and S3 samples)", "period": "2013-07-10", - "platform": "trmm", - "holdout_gap_days": 39, + "platforms": [ + "trmm" + ], "metrics": [ { "name": "pass_recall", @@ -146,11 +149,11 @@ "scope": "S3" } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.7493399012999999 } } - }, - "standard_version": 6 + } } diff --git a/src/tatc/resources/validation/trmm_pr.json b/src/tatc/resources/validation/trmm_pr.json index fa16c64d..d8b78989 100644 --- a/src/tatc/resources/validation/trmm_pr.json +++ b/src/tatc/resources/validation/trmm_pr.json @@ -3,13 +3,14 @@ "configurations": { "beams": { "digest": "dd262ee432d302cd5b1c611723d72397ef984a2e7243c409ba50494a2f44a364", - "evidence": "rerun", + "standard_version": 6, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_trmm_pr.py", "reference": "Footprints of the TC PRIMED documentation; beam positions of GPM_2APR version 07", "period": "2013-07-10", - "platform": "trmm", - "holdout_gap_days": 39, + "platforms": [ + "trmm" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -36,6 +37,7 @@ "value": 0.9999036149143976 } ], + "transfers": {}, "fixture_metrics": { "sample_size_within_3pct": 75.0, "pixel_position_median": 1.4943282339928428, @@ -45,13 +47,14 @@ }, "swath": { "digest": "4b6091eef521f2b0a097a5111d95f16de01347d9b1acf2bee3b165b9dd6f0191", - "evidence": "rerun", + "standard_version": 6, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_trmm_pr.py", "reference": "GPM_2APR version 07 (beam positions of the full swath)", "period": "2013-07-10", - "platform": "trmm", - "holdout_gap_days": 39, + "platforms": [ + "trmm" + ], "metrics": [ { "name": "pass_recall", @@ -74,11 +77,11 @@ "value": 0.9972156199996317 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.5281053159499999 } } - }, - "standard_version": 6 + } } diff --git a/src/tatc/resources/validation/tropomi.json b/src/tatc/resources/validation/tropomi.json index 4084fdaf..4299050f 100644 --- a/src/tatc/resources/validation/tropomi.json +++ b/src/tatc/resources/validation/tropomi.json @@ -3,13 +3,14 @@ "configurations": { "swath": { "digest": "6dd777f2374b8062437f0f7437e4b22db0994867904b99869abc86ed890998a5", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_tropomi.py", "reference": "Sentinel-5P TROPOMI aerosol index product (near real time)", "period": "2026-11-10", - "platform": "sentinel-5p", - "holdout_gap_days": 36, + "platforms": [ + "sentinel-5p" + ], "metrics": [ { "name": "pass_recall", @@ -32,11 +33,11 @@ "value": 0.9992485574844769 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 2.0062314133499988 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/viirs.json b/src/tatc/resources/validation/viirs.json index 8bac6e0d..74ff237a 100644 --- a/src/tatc/resources/validation/viirs.json +++ b/src/tatc/resources/validation/viirs.json @@ -3,13 +3,14 @@ "configurations": { "zones_noaa_20": { "digest": "0a3441f63ce27d27721039490a7a8e3830de3f19aec836d8d1534441e21e8197", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_viirs.py", "reference": "Footprints published by NOAA/CIMSS; samples of the VIIRS moderate-resolution geolocation", "period": "2026-08-12", - "platform": "noaa-20", - "holdout_gap_days": 51, + "platforms": [ + "noaa-20" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -34,28 +35,31 @@ { "name": "spacing_cross_ratio_median", "value": 1.0000895927623745 - }, - { - "name": "transfer_pixel_position_median", - "value": 3.1827709546028604, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_pixel_position_p95", - "value": 11.06625086753721, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_spacing_along_ratio_median", - "value": 0.9996453552709741, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_spacing_cross_ratio_median", - "value": 1.0018471560957558, - "scope": "noaa-21, 2026-11-05" } ], + "transfers": { + "noaa-21": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pixel_position_median", + "value": 3.1827709546028604 + }, + { + "name": "pixel_position_p95", + "value": 11.06625086753721 + }, + { + "name": "spacing_along_ratio_median", + "value": 0.9996453552709741 + }, + { + "name": "spacing_cross_ratio_median", + "value": 1.0018471560957558 + } + ] + } + }, "fixture_metrics": { "sample_size_within_3pct": 100.0, "pixel_position_median": 1.653632588211428, @@ -65,13 +69,14 @@ }, "swath_noaa_20": { "digest": "be11dfbef71b6a962c089ff2a0c8e8ccd967dc9f1a21dc16e259d0701aaf8f51", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_viirs.py", "reference": "VIIRS moderate-resolution geolocation", "period": "2026-08-12", - "platform": "noaa-20", - "holdout_gap_days": 51, + "platforms": [ + "noaa-20" + ], "metrics": [ { "name": "pass_recall", @@ -92,33 +97,35 @@ { "name": "footprint_iou_median", "value": 0.9869957393856083 - }, - { - "name": "transfer_pass_recall", - "value": 100.0, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_pass_precision", - "value": 97.89915966386555, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_epoch_p95", - "value": 2.1965354919999998, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_swath_width_median", - "value": 20.9986018617847, - "scope": "noaa-21, 2026-11-05" - }, - { - "name": "transfer_footprint_iou_median", - "value": 0.9853331982861818, - "scope": "noaa-21, 2026-11-05" } ], + "transfers": { + "noaa-21": { + "period": "2026-11-05", + "metrics": [ + { + "name": "pass_recall", + "value": 100.0 + }, + { + "name": "pass_precision", + "value": 97.89915966386555 + }, + { + "name": "epoch_p95", + "value": 2.1965354919999998 + }, + { + "name": "swath_width_median", + "value": 20.9986018617847 + }, + { + "name": "footprint_iou_median", + "value": 0.9853331982861818 + } + ] + } + }, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 1.96924972965 @@ -126,13 +133,14 @@ }, "swath_noaa_21": { "digest": "edc0174a0abdd30c703180034a05f9323136dd5e104767ee7e596b1fc4e7feaa", - "evidence": "rerun", + "standard_version": 5, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_viirs.py", "reference": "VIIRS moderate-resolution geolocation", "period": "2026-10-02", - "platform": "noaa-21", - "holdout_gap_days": 34, + "platforms": [ + "noaa-21" + ], "metrics": [ { "name": "pass_recall", @@ -155,11 +163,11 @@ "value": 0.9897826330491215 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 2.2811480393999997 } } - }, - "standard_version": 5 + } } diff --git a/src/tatc/resources/validation/virs.json b/src/tatc/resources/validation/virs.json index 82021ab7..11445f6d 100644 --- a/src/tatc/resources/validation/virs.json +++ b/src/tatc/resources/validation/virs.json @@ -3,13 +3,14 @@ "configurations": { "pixels": { "digest": "b8688736d1951d0235a24974b3cfaf6564f6b7f8f268d8cf26c8e1bb7eb70093", - "evidence": "rerun", + "standard_version": 6, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_virs.py", "reference": "Footprint of the TRMM Version 7 README of GES DISC; sample positions of GPM_1BVIRS version 08", "period": "2013-07-10", - "platform": "trmm", - "holdout_gap_days": 39, + "platforms": [ + "trmm" + ], "metrics": [ { "name": "sample_size_within_3pct", @@ -36,6 +37,7 @@ "value": 0.9995835694555084 } ], + "transfers": {}, "fixture_metrics": { "sample_size_within_3pct": 100.0, "pixel_position_median": 2.263626748871494, @@ -45,13 +47,14 @@ }, "swath": { "digest": "61cd341ff4c2a8cc972c0690743595a8c5181eec53f0efcef70d09e1911bc8ae", - "evidence": "rerun", + "standard_version": 6, "tatc_version": "3.6.0", "source": "validation/catalog/validate_catalog_virs.py", "reference": "GPM_1BVIRS version 08 (sample positions), with spacecraft positions of GPM_2APR version 07", "period": "2013-07-10", - "platform": "trmm", - "holdout_gap_days": 39, + "platforms": [ + "trmm" + ], "metrics": [ { "name": "pass_recall", @@ -74,11 +77,11 @@ "value": 0.993953665594313 } ], + "transfers": {}, "fixture_metrics": { "passes_found": 100.0, "epoch_p95": 0.6144587818 } } - }, - "standard_version": 6 + } } diff --git a/src/tatc/tradespace/constellations.py b/src/tatc/tradespace/constellations.py index b6e4c0aa..18a11718 100644 --- a/src/tatc/tradespace/constellations.py +++ b/src/tatc/tradespace/constellations.py @@ -672,6 +672,8 @@ def build( altitude: float | None = None, name: str = "satellite", time_step: float | None = None, + start: datetime | None = None, + end: datetime | None = None, ) -> list[Satellite]: """ Builds the satellites, in the order of the planes, each with a @@ -685,6 +687,10 @@ def build( name (str): The prefix of the names of the satellites. time_step (float | None): The analysis time step (seconds), for catalog configurations that tailor a field of view to it. + start (datetime.datetime | None): The start of the analysis, for + catalog configurations that schedule their tilt by day. + end (datetime.datetime | None): The end of the analysis, for + catalog configurations that schedule their tilt by day. Returns: list[Satellite]: the satellites @@ -704,7 +710,9 @@ def build( if [len(o) for o in orbits] != counts or [len(n) for n in names] != counts: raise ValueError("the orbits and names of a layout must match its planes") return [ - _make_satellite(payload, satellite, orbit, time_step) + _make_satellite( + payload, satellite, orbit, time_step=time_step, start=start, end=end + ) for plane_names, plane_orbits in zip(names, orbits) for satellite, orbit in zip(plane_names, plane_orbits) ] @@ -1148,7 +1156,13 @@ def hours_to_time(hours: float) -> time: def _make_satellite( - payload: Any, name: str, orbit: Any, time_step: float | None + payload: Any, + name: str, + orbit: Any, + *, + time_step: float | None, + start: datetime | None, + end: datetime | None, ) -> Satellite: """ Makes a satellite with a payload in an orbit (see `build_constellation`). @@ -1161,18 +1175,14 @@ def _make_satellite( if not all(isinstance(item, str) for item in payloads): raise ValueError("a payload mixes instruments and catalog entries") # pylint: disable=import-outside-toplevel - from ..catalog import get_entry + from ..catalog import build_payload - instruments, attitude = [], None - for item in payloads: - entry_id, _, configuration = item.partition(":") - built = get_entry(entry_id).build( - configuration or None, orbit=orbit, time_step=time_step - ) - instruments.extend(built.instruments) - if attitude is None: - attitude = built.attitude - return Satellite(name=name, orbit=orbit, instruments=instruments, attitude=attitude) + built = build_payload( + payloads, orbit=orbit, time_step=time_step, start=start, end=end + ) + return Satellite( + name=name, orbit=orbit, instruments=built.instruments, attitude=built.attitude + ) def _plane_orbits( @@ -1217,6 +1227,8 @@ def build_constellation( altitude: float | None = None, name: str = "satellite", time_step: float | None = None, + start: datetime | None = None, + end: datetime | None = None, ) -> list[Satellite]: """ Builds the satellites of a layout: the values of a fragment (such as @@ -1225,13 +1237,15 @@ def build_constellation( with a payload: * an `Instrument` (or a list of instruments); - * the identifier of an entry of the instrument catalog (see - `tatc.catalog.get_entry`), optionally with a configuration after a - colon (such as `"atms:swath_noaa_20"`), whose instruments are built for the - orbit with the attitude they were validated with (and, if the - configuration tailors a field of view, the analysis `time_step`), or - a list of identifiers, whose instruments the satellite carries - together (with the attitude of the first); + * the identifier of an entry of the instrument catalog, optionally with + a configuration after a colon (such as `"atms:swath_noaa_20"`), or a + list of them, whose instruments the satellite carries together with + the attitude they share (see `tatc.catalog.build_payload`), built for + the orbit and, if a configuration tailors a field of view, the + analysis `time_step`, or, if it schedules its tilt by day, the + analysis `start` and `end`; a satellite with several instruments (of + several entries, or the parts of one view) is analyzed with + `instrument_index=None`; * a function of a name and an orbit that builds a satellite. Satellites of Walker and streets-of-coverage constellations and of @@ -1254,12 +1268,22 @@ def build_constellation( name (str): The prefix of the names of the satellites. time_step (float | None): The analysis time step (seconds), for catalog configurations that tailor a field of view to it. + start (datetime.datetime | None): The start of the analysis, for + catalog configurations that schedule their tilt by day. + end (datetime.datetime | None): The end of the analysis, for + catalog configurations that schedule their tilt by day. Returns: list[Satellite]: the satellites """ return layout_of(layout).build( - payload, epoch=epoch, altitude=altitude, name=name, time_step=time_step + payload, + epoch=epoch, + altitude=altitude, + name=name, + time_step=time_step, + start=start, + end=end, ) diff --git a/src/tatc/utils/__init__.py b/src/tatc/utils/__init__.py index 7b80bacb..3a82e017 100644 --- a/src/tatc/utils/__init__.py +++ b/src/tatc/utils/__init__.py @@ -21,7 +21,11 @@ project_polygon_to_elevation, split_polygon, ) -from .glint import compute_glint_angle, compute_specular_point +from .glint import ( + compute_glint_angle, + compute_specular_point, + compute_subsolar_latitude, +) from .observation import ( compute_along_track_field_of_view, compute_field_of_regard, @@ -37,6 +41,7 @@ from .orbital import ( compute_apoapsis_radius, compute_argument_of_latitude, + compute_ascending_argument_of_latitude, compute_ground_inertial_velocity, compute_ground_surface_velocity, compute_j2_aop_rate, @@ -92,6 +97,7 @@ "buffer_target", "compute_apoapsis_radius", "compute_argument_of_latitude", + "compute_ascending_argument_of_latitude", "compute_cone_and_azimuth", "compute_field_of_regard", "compute_footprint", @@ -117,6 +123,7 @@ "compute_radar_ground_range_bounds", "compute_radar_slant_range", "compute_specular_point", + "compute_subsolar_latitude", "compute_static_track", "compute_swept_footprints", "compute_terrain_elevation_angle", diff --git a/src/tatc/utils/glint.py b/src/tatc/utils/glint.py index e3e292cc..62a81080 100644 --- a/src/tatc/utils/glint.py +++ b/src/tatc/utils/glint.py @@ -1,12 +1,15 @@ """ -Methods to compute the geometry of sun glint: the specular reflection of the -Sun on the WGS 84 ellipsoid (as on a calm water surface) toward a satellite. +Methods to compute the geometry of the Sun and of sun glint: the specular +reflection of the Sun on the WGS 84 ellipsoid (as on a calm water surface) +toward a satellite. @author: Paul T. Grogan """ from __future__ import annotations +from datetime import datetime + import numpy as np import numpy.typing as npt from skyfield.api import wgs84 @@ -15,7 +18,7 @@ from skyfield.timelib import Time from skyfield.toposlib import GeographicPosition -from ..constants import de421 +from ..constants import de421, timescale from .ellipsoid import geodetic_to_rectangular, rectangular_to_geodetic @@ -182,3 +185,19 @@ def compute_glint_angle( if np.ndim(orbit_track.t.tt) == 0 and np.ndim(target.latitude.degrees) == 0: return angle[0] return angle + + +def compute_subsolar_latitude(at: datetime) -> float: + """ + Computes the subsolar latitude (degrees): the geocentric latitude of the + Sun's apparent direction, or its declination of date. + + Args: + at (datetime.datetime): The time (timezone-aware). + + Returns: + float: The subsolar latitude (degrees). + """ + t = timescale.from_datetime(at) + x, y, z = de421["earth"].at(t).observe(de421["sun"]).apparent().frame_xyz(itrs).m + return float(np.degrees(np.arctan2(z, np.hypot(x, y)))) diff --git a/src/tatc/utils/orbital.py b/src/tatc/utils/orbital.py index 64c7bac5..1761dec7 100644 --- a/src/tatc/utils/orbital.py +++ b/src/tatc/utils/orbital.py @@ -400,6 +400,38 @@ def compute_argument_of_latitude( return float(u) if np.ndim(u) == 0 else u +def compute_ascending_argument_of_latitude( + latitude: float, altitude: float, inclination: float +) -> float: + """ + Computes the argument of latitude (degrees, from 0 to 360) at which a + circular orbit, ascending, passes over a geodetic latitude. + + Args: + latitude (float): The geodetic latitude (degrees) of the satellite. + altitude (float): The satellite's altitude (meters). + inclination (float): The orbit's inclination (degrees). + + Returns: + float: The argument of latitude (degrees, from 0 to 360). + + Raises: + ValueError: If the orbit does not reach the latitude. + """ + phi = np.radians(latitude) + e2 = constants.EARTH_ECCENTRICITY**2 + normal = constants.EARTH_EQUATORIAL_RADIUS / np.sqrt(1 - e2 * np.sin(phi) ** 2) + geocentric = np.arctan2( + (normal * (1 - e2) + altitude) * np.sin(phi), (normal + altitude) * np.cos(phi) + ) + ratio = np.sin(geocentric) / np.sin(np.radians(inclination)) + if abs(ratio) > 1: + raise ValueError( + f"an orbit inclined by {inclination} deg does not reach latitude {latitude}" + ) + return float(np.mod(np.degrees(np.arcsin(ratio)), 360)) + + def compute_vnb_frame( orbit_track: Geocentric, ) -> tuple[npt.NDArray, npt.NDArray, npt.NDArray]: diff --git a/tests/catalog/test_abi_fixture.py b/tests/catalog/test_abi_fixture.py index 91650d9d..110c7f6a 100644 --- a/tests/catalog/test_abi_fixture.py +++ b/tests/catalog/test_abi_fixture.py @@ -17,7 +17,8 @@ import numpy as np from tatc.analysis import collect_observations -from tatc.catalog import get_entry, get_gates +from tatc.catalog import get_entry +from tatc.catalog.standard import get_gates from tatc.catalog.metrics import compute_product_limit_error from tatc.schemas import GeneralPerturbationsOrbit, Point @@ -50,7 +51,9 @@ def setUpClass(cls): def _predict(self, key): rows = self.data[key] - satellite = self.entry.to_satellite(self.orbit, key, platform=self.platform) + satellite = self.entry.to_satellite( + self.orbit, configuration=key, platform=self.platform + ) results = [ collect_observations( Point(latitude=float(latitude), longitude=float(longitude)), diff --git a/tests/catalog/test_amsr2_fixture.py b/tests/catalog/test_amsr2_fixture.py index cde8ab9e..fa1f0d14 100644 --- a/tests/catalog/test_amsr2_fixture.py +++ b/tests/catalog/test_amsr2_fixture.py @@ -17,7 +17,8 @@ import pandas as pd from tatc.analysis import collect_observations, compute_sample_sizes -from tatc.catalog import get_entry, get_gates +from tatc.catalog import get_entry +from tatc.catalog.standard import get_gates from tatc.catalog.metrics import summarize from tatc.schemas import CircularOrbit, GeneralPerturbationsOrbit, Point @@ -117,7 +118,7 @@ def setUpClass(cls): def _build(self, orbit): return self.entry.to_satellite( - orbit, "sample_size", time_step=SCAN_PERIOD, platform=PLATFORM + orbit, configuration="sample_size", time_step=SCAN_PERIOD, platform=PLATFORM ) def test_published_dimensions(self): diff --git a/tests/catalog/test_atlas_fixture.py b/tests/catalog/test_atlas_fixture.py index 64954d23..d50ba42a 100644 --- a/tests/catalog/test_atlas_fixture.py +++ b/tests/catalog/test_atlas_fixture.py @@ -59,7 +59,10 @@ def test_segments(self): recorded epochs. """ satellite = self.entry.to_satellite( - self.orbit, self.configuration, time_step=1, platform=self.platform + self.orbit, + configuration=self.configuration, + time_step=1, + platform=self.platform, ) differences = [] for latitude, longitude, seconds, pair in self.data["passes"]: @@ -94,7 +97,10 @@ def test_views_ordered_left_to_right(self): Test that the views are ordered from left to right, without gaps between them. """ satellite = self.entry.to_satellite( - self.orbit, self.configuration, time_step=1, platform=self.platform + self.orbit, + configuration=self.configuration, + time_step=1, + platform=self.platform, ) rolls = [i.roll_angle for i in satellite.instruments] self.assertEqual(rolls, sorted(rolls, reverse=True)) diff --git a/tests/catalog/test_catalog_page.py b/tests/catalog/test_catalog_page.py index abf4f81b..964785af 100644 --- a/tests/catalog/test_catalog_page.py +++ b/tests/catalog/test_catalog_page.py @@ -10,7 +10,8 @@ import pathlib import unittest -from tatc.catalog import Gate, get_entry, get_entry_ids +from tatc.catalog import get_entry, get_entry_ids +from tatc.catalog.standard import Gate SCRIPT = pathlib.Path(__file__).parents[2] / "docs" / "validation" / "catalog_page.py" diff --git a/tests/catalog/test_entries.py b/tests/catalog/test_entries.py index 06c2fb3f..094cdde7 100644 --- a/tests/catalog/test_entries.py +++ b/tests/catalog/test_entries.py @@ -14,17 +14,15 @@ from tatc.analysis import collect_observations from tatc.catalog import ( - COMPATIBLE_VERSIONS, - STANDARD_VERSION, Grade, - InstrumentClass, InstrumentEntry, - Tier, + build_payload, get_entry, get_entry_ids, list_entries, ) from tatc.catalog import loader +from tatc.catalog.standard import is_compatible from tatc.schemas import ( Attitude, AttitudeSchedule, @@ -47,6 +45,352 @@ "2 40059 98.2167 252.4180 0000990 88.3344 271.7968 14.57127601657173", ] +# the validation status of each entry: its tier, and for each configuration its +# tier, the days between its fitting data and its test (`None` without fitted +# values), and its gaps (by metric, for its gates), and the gaps of the entry +EXPECTED_STATUS = { + "abi": ( + "partial", + { + "full_disk": ("partial", None, ["product_limit"]), + "sst_good_quality": ("validated", None, []), + "lst_good_quality": ("validated", None, []), + }, + [], + ), + "ahi": ( + "partial", + { + "full_disk": ("partial", None, ["product_limit"]), + "cloud_top_height": ("partial", 38, ["product_limit"]), + }, + [], + ), + "airs": ( + "partial", + { + "swath": ("validated", None, []), + "footprints": ("partial", None, ["sample_size_within_3pct"]), + }, + [], + ), + "amsr2": ( + "partial", + { + "swath": ("validated", 36, []), + "sample_size": ("partial", 36, ["sample_size_within_3pct"]), + }, + [], + ), + "amsua": ( + "partial", + { + "swath": ("validated", None, []), + "footprints": ("partial", None, ["sample_size_within_3pct"]), + }, + [], + ), + "ascat": ( + "validated", + { + "swaths": ("validated", 34, []), + }, + [], + ), + "atlas": ( + "partial", + { + "beam_pairs": ("partial", 34, ["epoch_p95"]), + }, + [], + ), + "atlid": ( + "partial", + { + "profile": ("partial", 41, ["track_offset_median"]), + }, + [], + ), + "atms": ( + "validated", + { + "swath_noaa_20": ("validated", 51, []), + "beams_noaa_20": ("validated", 51, []), + "swath_noaa_21": ("validated", 34, []), + "beams_noaa_21": ("validated", 34, []), + }, + [], + ), + "avhrr": ( + "partial", + { + "swath": ("validated", 33, []), + "pixels": ("partial", 33, ["sample_size_within_3pct"]), + }, + [], + ), + "bbr": ( + "partial", + { + "views": ("partial", 41, ["pass_recall", "footprint_iou_median"]), + }, + [], + ), + "ceres": ( + "partial", + { + "swath": ("partial", 36, ["swath_width_median"]), + }, + ["no configuration at the sample_size grade"], + ), + "cpr": ( + "partial", + { + "nadir": ("partial", None, ["track_offset_median"]), + }, + [], + ), + "cris": ( + "partial", + { + "swath": ("validated", 51, []), + "pixels": ( + "partial", + 51, + ["sample_size_within_3pct", "pixel_position_median"], + ), + }, + [], + ), + "csar": ( + "partial", + { + "iw": ("partial", 51, ["pass_recall"]), + "ew": ("validated", 39, []), + }, + [], + ), + "dpr": ( + "validated", + { + "swath": ("validated", 38, []), + "beams": ("validated", 38, []), + }, + [], + ), + "earthcare_msi": ( + "validated", + { + "swath": ("validated", 41, []), + }, + [], + ), + "ecostress": ( + "partial", + { + "swath": ("partial", 35, ["pass_recall"]), + }, + ["no configuration at the sample_size grade"], + ), + "emit": ( + "partial", + { + "swath": ("partial", 35, ["pass_recall", "footprint_iou_median"]), + }, + [], + ), + "gedi": ( + "partial", + { + "beams": ("partial", 38, ["epoch_p95"]), + }, + [], + ), + "gmi": ( + "validated", + { + "feeds": ("validated", 75, []), + "sample_size": ("validated", 75, []), + }, + [], + ), + "harp2": ( + "validated", + { + "swath": ("validated", 34, []), + }, + [], + ), + "iasi": ( + "partial", + { + "swath": ("validated", 32, []), + "pixels": ("partial", 32, ["sample_size_within_3pct"]), + }, + [], + ), + "karin": ( + "validated", + { + "swaths": ("validated", 34, []), + }, + [], + ), + "lsar": ( + "partial", + { + "swath_20_40mhz": ("partial", 33, ["swath_edge_p95"]), + "swath_5mhz": ("partial", 33, ["pass_recall"]), + "swath_77mhz": ( + "partial", + 30, + ["footprint_iou_median", "footprint_iou_p5"], + ), + }, + [], + ), + "mhs": ( + "validated", + { + "swath": ("validated", None, []), + "beams": ("validated", None, []), + }, + [], + ), + "modis": ( + "validated", + { + "swath": ("validated", 32, []), + "pixels": ("validated", 32, []), + }, + [], + ), + "msi": ( + "validated", + { + "swath": ("validated", 38, []), + }, + [], + ), + "oci": ( + "partial", + { + "swath": ("validated", 33, []), + }, + ["no configuration at the sample_size grade"], + ), + "oco2": ( + "partial", + { + "nadir": ("partial", 34, ["pass_recall", "footprint_iou_median"]), + "glint": ( + "partial", + 34, + ["pass_recall", "footprint_iou_median", "epoch_p95"], + ), + }, + [], + ), + "olci": ( + "partial", + { + "swath": ("partial", 31, ["swath_width_median"]), + }, + [], + ), + "oli": ( + "validated", + { + "swath": ("validated", 33, []), + }, + [], + ), + "omps_nm": ( + "partial", + { + "swath_noaa_21": ("partial", 35, ["swath_width_median", "epoch_p95"]), + "swath_noaa_20": ("partial", 35, ["swath_width_median", "epoch_p95"]), + }, + [], + ), + "poseidon4": ( + "validated", + { + "nadir": ("validated", None, []), + }, + [], + ), + "smap_radiometer": ( + "partial", + { + "looks": ("validated", 34, []), + "footprints": ("partial", 34, ["sample_size_within_3pct"]), + }, + [], + ), + "spexone": ( + "validated", + { + "swath": ("validated", 34, []), + }, + [], + ), + "ssmis": ( + "partial", + { + "swath": ("validated", 30, []), + }, + ["no configuration at the sample_size grade"], + ), + "tempo": ( + "validated", + { + "field_of_regard": ("validated", 33, []), + }, + [], + ), + "tmi": ( + "validated", + { + "feeds": ("validated", 39, []), + "sample_size": ("validated", 39, []), + }, + [], + ), + "trmm_pr": ( + "partial", + { + "swath": ("validated", 39, []), + "beams": ("partial", 39, ["sample_size_within_3pct"]), + }, + [], + ), + "tropomi": ( + "validated", + { + "swath": ("validated", 36, []), + }, + [], + ), + "viirs": ( + "validated", + { + "swath_noaa_20": ("validated", 51, []), + "swath_noaa_21": ("validated", 34, []), + "zones_noaa_20": ("validated", 51, []), + }, + [], + ), + "virs": ( + "validated", + { + "swath": ("validated", 39, []), + "pixels": ("validated", 39, []), + }, + [], + ), +} + class TestLoading(unittest.TestCase): """ @@ -69,17 +413,14 @@ def test_records_current(self): """ for entry in list_entries(): self.assertIsNotNone(entry.record, entry.id) - self.assertIn(entry.record.standard_version, COMPATIBLE_VERSIONS, entry.id) - self.assertLessEqual( - entry.record.standard_version, STANDARD_VERSION, entry.id - ) - if entry.instrument_class == InstrumentClass.LIDAR: - # the lidar class was added in version 2 - self.assertGreaterEqual(entry.record.standard_version, 2, entry.id) for key, record in entry.record.configurations.items(): self.assertEqual( record.digest, entry.configurations[key].digest, (entry.id, key) ) + self.assertTrue( + is_compatible(entry.instrument_class, record.standard_version), + (entry.id, key), + ) def test_platform_names(self): """ @@ -132,33 +473,7 @@ def test_list_filters(self): ) self.assertEqual( [e.id for e in list_entries(tier="partial")], - [ - "abi", - "ahi", - "airs", - "amsr2", - "amsua", - "atlas", - "atlid", - "avhrr", - "bbr", - "ceres", - "cpr", - "cris", - "csar", - "ecostress", - "emit", - "gedi", - "iasi", - "lsar", - "oci", - "oco2", - "olci", - "omps_nm", - "smap_radiometer", - "ssmis", - "trmm_pr", - ], + [k for k, (tier, _, _) in EXPECTED_STATUS.items() if tier == "partial"], ) with self.assertRaises(ValueError): list_entries(tier="approved") @@ -296,10 +611,48 @@ def test_tailored_pointed_instrument_is_swept(self): InstrumentEntry(**data) instrument = data["configurations"]["swath"]["instruments"][0] del instrument["parameters"]["is_swept"] - del instrument["provenance"]["is_swept"] with self.assertRaises(ValidationError): InstrumentEntry(**data) + def test_default_provenance(self): + """ + Test that the provenance of a field of view tailored to the time step and of + `is_swept` is the same in every configuration, and that of other modeling + choices is not. + """ + with open( + loader._ENTRIES / "msi.yml", # pylint: disable=protected-access + "r", + encoding="utf-8", + ) as f: + data = yaml.safe_load(f) + instrument = data["configurations"]["swath"]["instruments"][0] + self.assertNotIn("along_track_field_of_view", instrument["provenance"]) + self.assertNotIn("is_swept", instrument["provenance"]) + entry = InstrumentEntry(**data) + provenance = entry.configurations["swath"].instruments[0].provenance + self.assertEqual(provenance["along_track_field_of_view"].kind, "derived") + self.assertEqual(provenance["is_swept"].kind, "derived") + del instrument["provenance"]["is_rectangular"] + with self.assertRaisesRegex(ValidationError, "is_rectangular"): + InstrumentEntry(**data) + + def test_unknown_instrument_type(self): + """ + Test that an instrument's type is one of the instrument schemas. + """ + self.instrument["type"] = "conic" + self._assert_invalid() + + def test_index_only_of_alternatives(self): + """ + Test that only alternatives have an instrument to analyze by default. + """ + self.feeds["instrument_index"] = 1 + InstrumentEntry(**self.data) + self.feeds["grouping"] = "union" + self._assert_invalid() + def test_index_out_of_range(self): """ Test that the default instrument exists. @@ -333,7 +686,7 @@ def test_payload(self): self.assertIsInstance(payload.instruments[0], ConicalInstrument) self.assertEqual(payload.attitude.velocity_frame, VelocityFrame.INERTIAL) self.assertEqual(payload.instrument_index, 0) - self.assertEqual(payload.grouping, "alternatives") + self.assertEqual(payload.references, ("gmi:feeds",)) self.assertFalse(payload.transferred) self.assertTrue(any("flies backward" in l for l in payload.limitations)) @@ -490,7 +843,18 @@ def test_unknown_configuration(self): Test that an unknown configuration is an error that lists those available. """ with self.assertRaisesRegex(ValueError, "feeds"): - self.entry.build("other", orbit=self.orbit, time_step=10) + self.entry.build(configuration="other", orbit=self.orbit, time_step=10) + + +def _summarize_gaps(validation) -> list[str]: + """ + Gets the gaps of a configuration, with those of its gates as their metrics. + """ + metrics = [result.gate.metric for result in validation.gates] + return [ + next((m for m in metrics if text.startswith(f"{m}:")), text) + for text in validation.gaps + ] class TestEntryStatus(unittest.TestCase): @@ -498,44 +862,24 @@ class TestEntryStatus(unittest.TestCase): Unit tests for the status of the entries, which must not be overstated. """ - def test_gmi_validated(self): - """ - Test that GMI's configurations pass with its exact values, with fitted - values tested on held-out data, at each of the grades of its class. - """ - validation = get_entry("gmi").validation - self.assertEqual(validation.tier, Tier.VALIDATED) - self.assertEqual(validation.gaps, ()) - for key in ("feeds", "sample_size"): - configuration = validation.configurations[key] - self.assertEqual(configuration.tier, Tier.VALIDATED, key) - self.assertEqual(configuration.record.evidence, "rerun", key) - self.assertEqual(configuration.record.holdout_gap_days, 75, key) - self.assertTrue(all(r.passed for r in configuration.gates), key) - self.assertEqual(configuration.gaps, (), key) - - def test_jpss_entries_validated(self): - """ - Test that the entries validated against NOAA-20 and NOAA-21 data pass with - their exact values, with fitted values tested on held-out data, at each - required grade, and that each platform's configurations were fitted and - tested on that platform. - """ - gaps = {"noaa-20": 51, "noaa-21": 34} - for entry_id in ("atms", "viirs"): - entry = get_entry(entry_id) - validation = entry.validation - self.assertEqual(validation.tier, Tier.VALIDATED, entry_id) - self.assertEqual(validation.gaps, (), entry_id) - for key, configuration in validation.configurations.items(): - (platform,) = entry.configurations[key].platforms - self.assertEqual(configuration.record.platform, platform, key) - self.assertTrue(key.endswith(platform.replace("-", "_")), key) - self.assertEqual(configuration.record.evidence, "rerun", key) - self.assertEqual( - configuration.record.holdout_gap_days, gaps[platform], key - ) - self.assertTrue(all(r.passed for r in configuration.gates), key) + def test_status(self): + """ + Test the status of each entry against the table of expected status, so + that no change to an entry, its record, or the standard changes a status + unnoticed. + """ + self.assertEqual(sorted(EXPECTED_STATUS), get_entry_ids()) + for entry_id, (tier, configurations, gaps) in EXPECTED_STATUS.items(): + with self.subTest(entry_id): + validation = get_entry(entry_id).validation + self.assertEqual(validation.tier.value, tier) + self.assertEqual(list(validation.gaps), gaps) + self.assertEqual(set(validation.configurations), set(configurations)) + for key, (c_tier, holdout, c_gaps) in configurations.items(): + configuration = validation.configurations[key] + self.assertEqual(configuration.tier.value, c_tier, key) + self.assertEqual(configuration.holdout_gap_days, holdout, key) + self.assertEqual(_summarize_gaps(configuration), c_gaps, key) def test_atms_noaa21_models_yaw(self): """ @@ -552,578 +896,32 @@ def test_atms_noaa21_models_yaw(self): for key in ("swath_noaa_20", "beams_noaa_20"): self.assertEqual(entry.configurations[key].attitude, {}, key) - def test_modis_entry_validated_on_terra(self): - """ - Test that the MODIS entry passes with its exact values on held-out Terra data, - and that its results on Aqua, a transfer, are not those of any gate. - """ - entry = get_entry("modis") - self.assertEqual(entry.validation.tier, Tier.VALIDATED) - self.assertEqual(entry.validation.gaps, ()) - for key, configuration in entry.validation.configurations.items(): - record = configuration.record - self.assertEqual(record.evidence, "rerun", key) - self.assertEqual(record.platform, "terra", key) - self.assertEqual(record.holdout_gap_days, 32, key) - self.assertTrue(all(r.passed for r in configuration.gates), key) - transfers = [m for m in record.metrics if m.scope is not None] - self.assertTrue(transfers, key) - gated = {r.gate.metric for r in configuration.gates} - for metric in transfers: - self.assertTrue(metric.name.startswith("transfer_"), metric.name) - self.assertNotIn(metric.name, gated) - - def test_oli_entry_validated_on_landsat_9(self): - """ - Test that the OLI entry passes on held-out Landsat 9 data, and that its results - on Landsat 8, a transfer, are not those of any gate. - """ - entry = get_entry("oli") - self.assertEqual(entry.validation.tier, Tier.VALIDATED) - configuration = entry.validation.configurations["swath"] - record = configuration.record - self.assertEqual(record.platform, "landsat-9") - self.assertEqual(record.holdout_gap_days, 33) - self.assertTrue(all(r.passed for r in configuration.gates)) - transfers = [m for m in record.metrics if m.scope is not None] - self.assertTrue(transfers) - for metric in transfers: - self.assertTrue(metric.name.startswith("transfer_"), metric.name) - - def test_iasi_entry_partial_on_published_footprints(self): - """ - Test that the IASI entry is partial because of the published footprint at its - swath edge alone, with its swath validated on held-out data. - """ - entry = get_entry("iasi") - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - swath = entry.validation.configurations["swath"] - self.assertEqual(swath.tier, Tier.VALIDATED) - self.assertEqual(swath.record.holdout_gap_days, 32) - pixels = entry.validation.configurations["pixels"] - self.assertEqual(pixels.tier, Tier.PARTIAL) - self.assertEqual( - [r.gate.metric for r in pixels.gates if not r.passed], - ["sample_size_within_3pct"], - ) - - def test_tropomi_entry_validated(self): - """ - Test that the TROPOMI entry, a union of swept views, is validated on a day held - out after swept swaths were added, which its limitations disclose. - """ - entry = get_entry("tropomi") - self.assertEqual(entry.validation.tier, Tier.VALIDATED) - configuration = entry.validation.configurations["swath"] - self.assertEqual(entry.configurations["swath"].grouping, "union") - self.assertEqual(configuration.record.holdout_gap_days, 36) - self.assertTrue(all(r.passed for r in configuration.gates)) - self.assertTrue( - any( - "Rescored with swept swaths" in text - for text in entry.configurations["swath"].limitations - ) - ) - - def test_msi_entry_validated(self): - """ - Test that the MSI entry, tested on three satellites, is validated on a day held - out after swept swaths were added, which its limitations disclose. - """ - entry = get_entry("msi") - self.assertEqual(entry.validation.tier, Tier.VALIDATED) - configuration = entry.validation.configurations["swath"] - self.assertEqual(configuration.record.holdout_gap_days, 38) - scopes = {m.scope for m in configuration.record.metrics} - for platform in entry.configurations["swath"].platforms: - self.assertIn(platform, scopes) - self.assertTrue(all(r.passed for r in configuration.gates)) - self.assertTrue( - any( - "Rescored with swept swaths" in text - for text in entry.configurations["swath"].limitations - ) - ) - - def test_cris_entry_partial_on_pixels(self): - """ - Test that the CrIS entry is partial because of its pixels alone, with its swath - validated at the timing grade on held-out data. - """ - entry = get_entry("cris") - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - swath = entry.validation.configurations["swath"] - self.assertEqual(swath.tier, Tier.VALIDATED) - self.assertEqual(entry.configurations["swath"].grade, Grade.TIMING) - self.assertEqual(swath.record.holdout_gap_days, 51) - pixels = entry.validation.configurations["pixels"] - self.assertEqual(pixels.record.holdout_gap_days, 51) - self.assertEqual( - [r.gate.metric for r in pixels.gates if not r.passed], - ["sample_size_within_3pct", "pixel_position_median"], - ) - - def test_csar_entry_partial(self): - """ - Test that the C-SAR entry is partial because its IW mode misses points at the - swath edges, with its EW mode validated on a later held-out day. - """ - entry = get_entry("csar") - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - failed = { - key: [r.gate.metric for r in configuration.gates if not r.passed] - for key, configuration in entry.validation.configurations.items() - } - self.assertEqual(failed, {"iw": ["pass_recall"], "ew": []}) - configurations = entry.validation.configurations - self.assertEqual(configurations["ew"].tier, Tier.VALIDATED) - self.assertEqual(configurations["iw"].record.holdout_gap_days, 51) - self.assertEqual(configurations["ew"].record.holdout_gap_days, 39) - for configuration in configurations.values(): - self.assertEqual(configuration.record.platform, "sentinel-1c") - - def test_amsr2_entry_partial_on_published_footprints(self): - """ - Test that the AMSR2 entry is partial because of its published footprints - alone, with its swath validated at the timing grade on held-out data. - """ - entry = get_entry("amsr2") - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - swath = entry.validation.configurations["swath"] - self.assertEqual(swath.tier, Tier.VALIDATED) - self.assertEqual(entry.configurations["swath"].grade, Grade.TIMING) - self.assertEqual(swath.record.holdout_gap_days, 36) - sample_size = entry.validation.configurations["sample_size"] - self.assertEqual( - [r.gate.metric for r in sample_size.gates if not r.passed], - ["sample_size_within_3pct"], - ) - - def test_karin_entry_validated(self): - """ - Test that the KaRIn entry, a union of two swaths, passes with its exact values - on held-out data. - """ - entry = get_entry("karin") - self.assertEqual(entry.validation.tier, Tier.VALIDATED) - self.assertEqual(entry.configurations["swaths"].grouping, "union") - configuration = entry.validation.configurations["swaths"] - self.assertEqual(configuration.record.holdout_gap_days, 34) - self.assertTrue(all(r.passed for r in configuration.gates)) - - def test_dpr_entry_validated(self): - """ - Test that the DPR entry is validated, with its swept swath and its beams, on - data held out 38 days from the fit. + def test_mhs_has_no_fitted_values(self): """ - entry = get_entry("dpr") - self.assertEqual(entry.validation.tier, Tier.VALIDATED) - for configuration in entry.validation.configurations.values(): - self.assertTrue(all(r.passed for r in configuration.gates)) - self.assertEqual(configuration.record.holdout_gap_days, 38) - - def test_mhs_entry_validated_on_published_values(self): - """ - Test that the MHS entry, whose values are all published, is validated without - a holdout, at the coverage grade. + Test that the MHS entry, whose values are all published, needs no holdout. """ entry = get_entry("mhs") - self.assertEqual(entry.validation.tier, Tier.VALIDATED) - self.assertEqual(entry.configurations["swath"].grade, Grade.COVERAGE) for configuration in entry.configurations.values(): - for instrument in configuration.instruments: - self.assertNotIn( - "measured", [p.kind for p in instrument.provenance.values()] - ) - - def test_atlas_entry_partial_on_epochs(self): - """ - Test that the ATLAS entry, of the lidar class added in version 2 of the - standard, is partial because of its epochs alone on held-out data. - """ - entry = get_entry("atlas") - self.assertEqual(entry.instrument_class, InstrumentClass.LIDAR) - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - configuration = entry.validation.configurations["beam_pairs"] - self.assertEqual( - [r.gate.metric for r in configuration.gates if not r.passed], - ["epoch_p95"], - ) - self.assertEqual(configuration.record.holdout_gap_days, 34) - self.assertGreaterEqual(entry.record.standard_version, 2) - - def test_smap_entry_partial_on_published_footprints(self): - """ - Test that the SMAP radiometer entry is partial because of its published - footprints alone, with its looks validated on held-out data. - """ - entry = get_entry("smap_radiometer") - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - self.assertEqual(entry.validation.gaps, ()) - looks = entry.validation.configurations["looks"] - self.assertEqual(looks.tier, Tier.VALIDATED) - self.assertEqual(looks.record.holdout_gap_days, 34) - footprints = entry.validation.configurations["footprints"] - self.assertEqual( - [r.gate.metric for r in footprints.gates if not r.passed], - ["sample_size_within_3pct"], - ) - self.assertEqual(footprints.record.holdout_gap_days, 34) - - def test_lsar_entry_partial(self): - """ - Test that the L-SAR entry is partial: its modes with a 20 or 40 MHz band miss - the near-range edges, and those with only a 5 MHz band miss a point of a small - sample, while their swept swaths pass the swath area at every time step. The - 77 MHz mode, tested on four pooled days with an element set of each day, - passes every gate tested, but its swath area is not tested, as its frames are - partial. - """ - entry = get_entry("lsar") - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - failed = { - key: [r.gate.metric for r in configuration.gates if not r.passed] - for key, configuration in entry.validation.configurations.items() - } - self.assertEqual( - failed, - { - "swath_20_40mhz": ["swath_edge_p95"], - "swath_5mhz": ["pass_recall"], - "swath_77mhz": ["footprint_iou_median", "footprint_iou_p5"], - }, - ) - self.assertEqual( - { - key: configuration.record.holdout_gap_days - for key, configuration in entry.validation.configurations.items() - }, - {"swath_20_40mhz": 33, "swath_5mhz": 33, "swath_77mhz": 30}, - ) - - def test_aqua_sounder_entries_partial_on_published_footprints(self): - """ - Test that the AIRS and AMSU-A entries, whose values are all published, are - partial because of their published footprints alone, with their swaths - validated, AIRS's at the timing grade and AMSU-A's at the coverage grade. - """ - for entry_id, grade in (("airs", Grade.TIMING), ("amsua", Grade.COVERAGE)): - entry = get_entry(entry_id) - self.assertEqual(entry.validation.tier, Tier.PARTIAL, entry_id) - swath = entry.validation.configurations["swath"] - self.assertEqual(swath.tier, Tier.VALIDATED, entry_id) - self.assertEqual(entry.configurations["swath"].grade, grade) - footprints = entry.validation.configurations["footprints"] - self.assertEqual( - [r.gate.metric for r in footprints.gates if not r.passed], - ["sample_size_within_3pct"], - entry_id, - ) - for configuration in entry.configurations.values(): - for instrument in configuration.instruments: - self.assertNotIn( - "measured", [p.kind for p in instrument.provenance.values()] - ) - - def test_avhrr_entry_partial_on_published_footprint(self): - """ - Test that the AVHRR entry is partial on data held out 33 days from the fit - because of its published footprint alone, with its yawed swath validated at - the timing grade. - """ - entry = get_entry("avhrr") - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - failed = { - key: [r.gate.metric for r in configuration.gates if not r.passed] - for key, configuration in entry.validation.configurations.items() - } - self.assertEqual(failed, {"swath": [], "pixels": ["sample_size_within_3pct"]}) - self.assertEqual(entry.configurations["swath"].grade, Grade.TIMING) - for configuration in entry.validation.configurations.values(): - self.assertEqual(configuration.record.holdout_gap_days, 33) - for key in ("swath", "pixels"): - self.assertEqual(entry.configurations[key].attitude, {"yaw_angle": 0.2943}) - - def test_ssmis_entry_partial_without_sample_size(self): - """ - Test that the SSMIS entry is partial only for want of a sample size - configuration, with its swath validated on data held out 30 days from the fit. - """ - entry = get_entry("ssmis") - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - self.assertEqual( - entry.validation.gaps, ("no configuration at the sample_size grade",) - ) - swath = entry.validation.configurations["swath"] - self.assertEqual(swath.tier, Tier.VALIDATED) - self.assertEqual(swath.record.holdout_gap_days, 30) - - def test_olci_entry_partial_on_swath_width(self): - """ - Test that the OLCI entry, a rolled pushbroom, is partial because of its swath - width alone on data held out 31 days from the fit. - """ - entry = get_entry("olci") - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - swath = entry.validation.configurations["swath"] - self.assertEqual( - [r.gate.metric for r in swath.gates if not r.passed], - ["swath_width_median"], - ) - self.assertEqual(swath.record.holdout_gap_days, 31) - - def test_oci_entry_partial(self): - """ - Test that the OCI entry, whose tilt follows a daily schedule and is blind while - it changes, is partial without a sample size configuration alone, with its - swept swath validated on data held out 33 days from the fit. - """ - entry = get_entry("oci") - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - self.assertEqual( - entry.validation.gaps, ("no configuration at the sample_size grade",) - ) - swath = entry.validation.configurations["swath"] - self.assertEqual(swath.tier, Tier.VALIDATED) - self.assertEqual(swath.record.holdout_gap_days, 33) - - def test_pace_polarimeters_validated(self): - """ - Test that the HARP2 and SPEXone entries pass with their exact values on data - held out 34 days from the fit. - """ - for entry_id in ("harp2", "spexone"): - entry = get_entry(entry_id) - self.assertEqual(entry.validation.tier, Tier.VALIDATED, entry_id) - swath = entry.validation.configurations["swath"] - self.assertEqual(swath.record.holdout_gap_days, 34, entry_id) - - def test_poseidon4_entry_validated(self): - """ - Test that the Poseidon-4 entry, of the altimeter class added in version 3 of - the standard, passes with its derived values. - """ - entry = get_entry("poseidon4") - self.assertEqual(entry.instrument_class, InstrumentClass.ALTIMETER) - self.assertEqual(entry.validation.tier, Tier.VALIDATED) - self.assertGreaterEqual(entry.record.standard_version, 3) - - def test_omps_entry_partial_on_bowed_swath(self): - """ - Test that the OMPS Nadir Mapper entry is partial on both platforms because of - its swath width and epochs alone, which the bowed swath sets. - """ - validation = get_entry("omps_nm").validation - self.assertEqual(validation.tier, Tier.PARTIAL) - for key in ("swath_noaa_21", "swath_noaa_20"): - configuration = validation.configurations[key] - self.assertEqual( - sorted(r.gate.metric for r in configuration.gates if not r.passed), - ["epoch_p95", "swath_width_median"], - key, - ) - self.assertEqual(configuration.record.holdout_gap_days, 35, key) - - def test_scanner_entries_partial(self): - """ - Test that the CERES entry is partial because of its swath width, and the - ECOSTRESS entry because of its recall, each without a sample size - configuration. - """ - for entry_id, failed in ( - ("ceres", ["swath_width_median"]), - ("ecostress", ["pass_recall"]), - ): - validation = get_entry(entry_id).validation - self.assertEqual(validation.tier, Tier.PARTIAL, entry_id) - self.assertEqual( - validation.gaps, ("no configuration at the sample_size grade",) - ) - swath = validation.configurations["swath"] - self.assertEqual( - [r.gate.metric for r in swath.gates if not r.passed], failed - ) - - def test_ahi_partial_on_product_limit(self): - """ - Test that the AHI entry is partial: its product's limit fails, and its full - disk configuration has no discriminating test. - """ - validation = get_entry("ahi").validation - self.assertEqual(validation.tier, Tier.PARTIAL) - for configuration in validation.configurations.values(): - self.assertEqual(configuration.tier, Tier.PARTIAL) - self.assertEqual( - validation.configurations["cloud_top_height"].record.holdout_gap_days, 38 - ) - - def test_ascat_entry_validated(self): - """ - Test that the ASCAT entry, of the scatterometer class added in version 4 of the - standard, passes on data held out 34 days from the fit, as a union of two - swaths. - """ - entry = get_entry("ascat") - self.assertEqual(entry.instrument_class, InstrumentClass.SCATTEROMETER) - self.assertEqual(entry.validation.tier, Tier.VALIDATED) - self.assertEqual(entry.configurations["swaths"].grouping, "union") - swaths = entry.validation.configurations["swaths"] - self.assertEqual(swaths.record.holdout_gap_days, 34) - self.assertGreaterEqual(entry.record.standard_version, 4) - - def test_tempo_entry_validated(self): - """ - Test that the TEMPO entry, of the regional geostationary class added in version - 5 of the standard, passes on a scan held out 33 days from the fit. - """ - entry = get_entry("tempo") - self.assertEqual(entry.instrument_class, InstrumentClass.GEOSTATIONARY_REGIONAL) - self.assertEqual(entry.validation.tier, Tier.VALIDATED) - configuration = entry.validation.configurations["field_of_regard"] - self.assertEqual( - [r.gate.metric for r in configuration.gates], ["field_of_regard_iou"] - ) - self.assertEqual(configuration.record.holdout_gap_days, 33) - - def test_gedi_entry_partial_on_epochs(self): - """ - Test that the GEDI entry, eight beams of the lidar class, is partial because of - its epochs alone on data held out 38 days from the fit. - """ - entry = get_entry("gedi") - self.assertEqual(entry.instrument_class, InstrumentClass.LIDAR) - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - configuration = entry.validation.configurations["beams"] - self.assertEqual(len(entry.configurations["beams"].instruments), 8) - self.assertEqual( - [r.gate.metric for r in configuration.gates if not r.passed], - ["epoch_p95"], - ) - self.assertEqual(configuration.record.holdout_gap_days, 38) - - def test_emit_entry_partial_on_shifted_swath(self): - """ - Test that the EMIT entry is partial because of its recall and swath area on - data held out 35 days from the fit, with its epochs and width passing. - """ - swath = get_entry("emit").validation.configurations["swath"] - self.assertEqual(swath.tier, Tier.PARTIAL) - self.assertEqual( - sorted(r.gate.metric for r in swath.gates if not r.passed), - ["footprint_iou_median", "pass_recall"], - ) - self.assertEqual(swath.record.holdout_gap_days, 35) - - def test_virs_entry_validated(self): - """ - Test that the TRMM VIRS entry passes with its fitted values on data held out 39 - days from the fit. - """ - validation = get_entry("virs").validation - self.assertEqual(validation.tier, Tier.VALIDATED) - for key in ("swath", "pixels"): - configuration = validation.configurations[key] - self.assertEqual(configuration.tier, Tier.VALIDATED, key) - self.assertEqual(configuration.record.holdout_gap_days, 39, key) - - def test_tmi_entry_validated(self): - """ - Test that the TRMM TMI entry passes with its fitted feeds on data held out 39 - days from the fit, as alternatives scored one at a time. - """ - entry = get_entry("tmi") - self.assertEqual(entry.instrument_class, InstrumentClass.CONICAL) - self.assertEqual(entry.validation.tier, Tier.VALIDATED) - self.assertEqual(entry.configurations["feeds"].grouping, "alternatives") - for key in ("feeds", "sample_size"): - configuration = entry.validation.configurations[key] - self.assertEqual(configuration.tier, Tier.VALIDATED, key) - self.assertEqual(configuration.record.holdout_gap_days, 39, key) - - def test_trmm_pr_entry_partial_on_published_footprint(self): - """ - Test that the TRMM PR entry is partial because its published footprint at the - scan's edge does not meet the sample size gate, with its swath validated on data - held out 39 days from the fit. - """ - validation = get_entry("trmm_pr").validation - self.assertEqual(validation.tier, Tier.PARTIAL) - self.assertEqual(validation.configurations["swath"].tier, Tier.VALIDATED) - beams = validation.configurations["beams"] - self.assertEqual( - [r.gate.metric for r in beams.gates if not r.passed], - ["sample_size_within_3pct"], - ) - self.assertEqual(beams.record.holdout_gap_days, 39) - - def test_earthcare_msi_entry_validated(self): - """ - Test that the EarthCARE MSI entry passes with its fitted view on data held out - 41 days from the fit. - """ - validation = get_entry("earthcare_msi").validation - self.assertEqual(validation.tier, Tier.VALIDATED) - swath = validation.configurations["swath"] - self.assertEqual(swath.record.holdout_gap_days, 41) - - def test_earthcare_profilers_partial_on_track_offset(self): - """ - Test that the ATLID and CPR entries, of the profiler class added in version 6 - of the standard, are partial because of their track offset alone on data held - out 41 days from the fit. - """ - for entry_id, key in (("atlid", "profile"), ("cpr", "nadir")): - entry = get_entry(entry_id) - self.assertEqual(entry.instrument_class, InstrumentClass.PROFILER) - self.assertEqual(entry.validation.tier, Tier.PARTIAL, entry_id) - self.assertGreaterEqual(entry.record.standard_version, 6) - configuration = entry.validation.configurations[key] - self.assertEqual( - [r.gate.metric for r in configuration.gates if not r.passed], - ["track_offset_median"], - entry_id, - ) - self.assertEqual(configuration.record.holdout_gap_days, 41, entry_id) - - def test_bbr_entry_partial_on_held_out_day(self): - """ - Test that the BBR entry, whose three views are alternatives scored on data - held out 41 days from the fit, is partial on pass recall and footprint IoU - (the gates take the worst view) and passes its width and epoch gates. - """ - entry = get_entry("bbr") - self.assertEqual(entry.instrument_class, InstrumentClass.PUSHBROOM) - self.assertEqual(entry.validation.tier, Tier.PARTIAL) - views = entry.validation.configurations["views"] - self.assertEqual( - sorted(r.gate.metric for r in views.gates if not r.passed), - ["footprint_iou_median", "pass_recall"], - ) - self.assertEqual(views.record.holdout_gap_days, 41) - self.assertEqual( - {m.scope for m in views.record.metrics}, {"AFT", "NADIR", "FORE"} - ) + self.assertFalse(configuration.is_fitted) def test_oco2_glint_builds_glint_attitude(self): """ Test that OCO-2's glint configuration builds the glint attitude it declares, - and its nadir configuration a plain attitude, with both modes partial. + and its nadir configuration a plain attitude. """ entry = get_entry("oco2") orbit = GeneralPerturbationsOrbit.from_tle(OCO2_TLE) - glint = entry.build("glint", orbit=orbit, time_step=10) + glint = entry.build(configuration="glint", orbit=orbit, time_step=10) self.assertIsInstance(glint.attitude, GlintAttitude) self.assertEqual(glint.attitude.max_off_nadir_angle, 51.0) self.assertEqual(glint.attitude.velocity_frame, VelocityFrame.EARTH_FIXED) - nadir = entry.build("nadir", orbit=orbit, time_step=10) + nadir = entry.build(configuration="nadir", orbit=orbit, time_step=10) self.assertNotIsInstance(nadir.attitude, GlintAttitude) - for configuration in entry.validation.configurations.values(): - self.assertEqual(configuration.tier, Tier.PARTIAL) def test_transfers_recorded_apart(self): """ - Test that results on sibling platforms are recorded as transfer metrics, which - no gate reads, and that the configurations transferred warn on those + Test that results on sibling platforms are recorded as transfers, which no + gate reads, and that the configurations transferred warn on those platforms. """ transfers = { @@ -1133,27 +931,31 @@ def test_transfers_recorded_apart(self): "mhs": "metop-b", "avhrr": "metop-b", "csar": "sentinel-1d", + "modis": "aqua", + "oli": "landsat-8", "poseidon4": "sentinel-6b", } + recorded = { + entry.id: { + platform + for record in entry.record.configurations.values() + for platform in record.transfers + } + for entry in list_entries() + } + self.assertEqual( + {k: v for k, v in recorded.items() if v}, + {k: {v} for k, v in transfers.items()}, + ) for entry_id, platform in transfers.items(): entry = get_entry(entry_id) - self.assertIn(platform, [p.id for p in entry.platforms], entry_id) - transferred = { - key: [ - metric.name - for metric in record.metrics - if metric.scope and metric.scope.startswith(platform) - ] - for key, record in entry.record.configurations.items() - } - transferred = {key: names for key, names in transferred.items() if names} - self.assertTrue(transferred, entry_id) - for key, names in transferred.items(): - self.assertTrue(all(n.startswith("transfer_") for n in names), key) + for key, record in entry.record.configurations.items(): + if platform not in record.transfers: + continue self.assertNotIn(platform, entry.configurations[key].platforms, key) with self.assertWarns(UserWarning): entry.build( - key, + configuration=key, orbit=GeneralPerturbationsOrbit.from_tle(GPM_TLE), time_step=10, platform=platform, @@ -1177,24 +979,13 @@ def test_gmi_reports_spacing_limitation(self): any( "spacing between scans" in limitation for limitation in entry.build( - "sample_size", + configuration="sample_size", orbit=GeneralPerturbationsOrbit.from_tle(GPM_TLE), time_step=1.875, ).limitations ) ) - def test_abi_partial(self): - """ - Test that ABI's product coverage is validated, but not the entry: its - full disk configuration has no discriminating test. - """ - validation = get_entry("abi").validation - self.assertEqual(validation.tier, Tier.PARTIAL) - self.assertEqual(validation.configurations["full_disk"].tier, Tier.PARTIAL) - for key in ("sst_good_quality", "lst_good_quality"): - self.assertEqual(validation.configurations[key].tier, Tier.VALIDATED, key) - def test_abi_builds_without_attitude(self): """ Test that an Earth-fixed configuration without other attitude fields @@ -1205,5 +996,151 @@ def test_abi_builds_without_attitude(self): self.assertIsInstance(payload.instruments[0], Instrument) +class TestSelection(unittest.TestCase): + """ + Unit tests for selecting configurations by platform and grade. + """ + + def setUp(self): + self.orbit = GeneralPerturbationsOrbit.from_tle(GPM_TLE) + + def test_platform_selects_its_configuration(self): + """ + Test that the platform modeled selects the configuration tested on it, + without a warning, and the default configuration otherwise. + """ + viirs = get_entry("viirs") + self.assertEqual(viirs.select_configuration(), "swath_noaa_20") + self.assertEqual( + viirs.select_configuration(platform="noaa-21"), "swath_noaa_21" + ) + with warnings.catch_warnings(): + warnings.simplefilter("error") + payload = viirs.build(orbit=self.orbit, time_step=10, platform="noaa-21") + self.assertEqual(payload.references, ("viirs:swath_noaa_21",)) + self.assertFalse(payload.transferred) + + def test_grade_selects_a_configuration(self): + """ + Test that a grade selects a configuration for its use, preferring the + platform's, and that the timing grade serves coverage. + """ + atms = get_entry("atms") + self.assertEqual( + atms.select_configuration(grade="sample_size", platform="noaa-21"), + "beams_noaa_21", + ) + self.assertEqual( + atms.select_configuration(grade="coverage", platform="noaa-21"), + "swath_noaa_21", + ) + self.assertEqual( + get_entry("gmi").select_configuration(grade="coverage"), "feeds" + ) + self.assertEqual( + get_entry("modis").select_configuration(grade=Grade.SAMPLE_SIZE), "pixels" + ) + + def test_transfer_when_untested(self): + """ + Test that, without a configuration of the grade tested on the platform, one + tested on another is selected, with a warning. + """ + viirs = get_entry("viirs") + with self.assertWarnsRegex(UserWarning, "noaa-21"): + payload = viirs.build(grade="sample_size", platform="noaa-21") + self.assertEqual(payload.references, ("viirs:zones_noaa_20",)) + self.assertTrue(payload.transferred) + + def test_grade_errors(self): + """ + Test that a grade without a configuration, or a configuration of another + grade, is an error. + """ + with self.assertRaisesRegex(ValueError, "sample_size"): + get_entry("csar").select_configuration(grade="sample_size") + with self.assertRaisesRegex(ValueError, "timing"): + get_entry("gmi").select_configuration("feeds", grade="sample_size") + + def test_analysis_index(self): + """ + Test the index with which a payload is analyzed: `None` for a union, the + configured index of alternatives, and 0 for a single instrument. + """ + orbit = self.orbit + self.assertIsNone( + get_entry("ascat").build(orbit=orbit, time_step=10).instrument_index + ) + self.assertEqual( + get_entry("viirs").build(grade="sample_size").instrument_index, 2 + ) + self.assertEqual( + get_entry("msi").build(orbit=orbit, time_step=10).instrument_index, 0 + ) + + +class TestBuildPayload(unittest.TestCase): + """ + Unit tests for the payloads of several catalog configurations. + """ + + def setUp(self): + self.orbit = GeneralPerturbationsOrbit.from_tle(GPM_TLE) + + def test_carried_together(self): + """ + Test that configurations with the same attitude are carried together, + analyzed together, with only the analyzed instrument of alternatives. + """ + payload = build_payload( + ["viirs", "cris", "atms:beams_noaa_20"], orbit=self.orbit, time_step=10 + ) + self.assertEqual( + payload.references, + ("viirs:swath_noaa_20", "cris:swath", "atms:beams_noaa_20"), + ) + beams = get_entry("atms").configurations["beams_noaa_20"] + self.assertEqual( + [i.name for i in payload.instruments][-1], + beams.instruments[beams.instrument_index].parameters["name"], + ) + self.assertEqual(len(payload.instruments), 3) + self.assertIsNone(payload.instrument_index) + self.assertEqual(payload.attitude.velocity_frame, VelocityFrame.INERTIAL) + + def test_one_reference(self): + """ + Test that one instrument is analyzed alone, by an alias. + """ + payload = build_payload("GPM Microwave Imager", orbit=self.orbit, time_step=10) + self.assertEqual(payload.references, ("gmi:feeds",)) + self.assertEqual(len(payload.instruments), 1) + self.assertEqual(payload.instrument_index, 0) + + def test_different_attitudes(self): + """ + Test that configurations of different attitudes cannot be carried + together. + """ + with self.assertRaisesRegex(ValueError, "different attitudes"): + build_payload(["viirs", "oco2:glint"], orbit=self.orbit, time_step=10) + with self.assertRaises(ValueError): + build_payload([], orbit=self.orbit) + + def test_tilt_schedule_needs_period(self): + """ + Test that a configuration whose tilt is scheduled by day is built for the + period of the analysis. + """ + orbit = GeneralPerturbationsOrbit.from_tle(OCO2_TLE) + with self.assertRaisesRegex(ValueError, "start and end"): + build_payload("oci", orbit=orbit, time_step=10) + start = datetime(2026, 11, 10, tzinfo=timezone.utc) + payload = build_payload( + "oci", orbit=orbit, time_step=10, start=start, end=start + timedelta(days=1) + ) + self.assertIsInstance(payload.attitude, AttitudeSchedule) + + if __name__ == "__main__": unittest.main() diff --git a/tests/catalog/test_gmi_fixture.py b/tests/catalog/test_gmi_fixture.py index 0df591ee..f84fc033 100644 --- a/tests/catalog/test_gmi_fixture.py +++ b/tests/catalog/test_gmi_fixture.py @@ -17,7 +17,8 @@ import pandas as pd from tatc.analysis import collect_observations, compute_sample_sizes -from tatc.catalog import get_entry, get_gates +from tatc.catalog import get_entry +from tatc.catalog.standard import get_gates from tatc.catalog.metrics import summarize from tatc.schemas import CircularOrbit, GeneralPerturbationsOrbit, Point @@ -115,7 +116,7 @@ def setUpClass(cls): def _build(self, orbit): return self.entry.to_satellite( - orbit, "sample_size", time_step=SCAN_PERIOD, platform="gpm" + orbit, configuration="sample_size", time_step=SCAN_PERIOD, platform="gpm" ) def test_published_dimensions(self): diff --git a/tests/catalog/test_pushbroom_fixtures.py b/tests/catalog/test_pushbroom_fixtures.py index daf769e5..9639ca54 100644 --- a/tests/catalog/test_pushbroom_fixtures.py +++ b/tests/catalog/test_pushbroom_fixtures.py @@ -54,7 +54,7 @@ def setUpClass(cls): # the day is the period of the analysis, for a schedule of the attitude cls.satellite = cls.entry.to_satellite( GeneralPerturbationsOrbit.from_tle(cls.data[cls.tle_key].tolist()), - cls.configuration, + configuration=cls.configuration, time_step=cls.time_step, platform=cls.platform, start=cls.day, diff --git a/tests/catalog/test_scanner_fixtures.py b/tests/catalog/test_scanner_fixtures.py index 8183a2a6..68763049 100644 --- a/tests/catalog/test_scanner_fixtures.py +++ b/tests/catalog/test_scanner_fixtures.py @@ -30,7 +30,8 @@ from pyproj import Transformer from tatc.analysis import collect_observations, compute_sample_sizes -from tatc.catalog import get_entry, get_gates +from tatc.catalog import get_entry +from tatc.catalog.standard import get_gates from tatc.catalog.metrics import summarize from tatc.schemas import CircularOrbit, GeneralPerturbationsOrbit, Point from tatc.utils import VelocityFrame, compute_projected_ray_position @@ -101,7 +102,7 @@ def test_passes(self): """ satellite = self.entry.to_satellite( self.orbit, - self.swath_key, + configuration=self.swath_key, time_step=self.time_step(), platform=self.platform, ) @@ -148,7 +149,7 @@ class _ScannerFixture(_SwathFixture): def setUpClass(cls): super().setUpClass() cls.satellite = cls.entry.to_satellite( - cls.orbit, cls.sizes_key, platform=cls.platform + cls.orbit, configuration=cls.sizes_key, platform=cls.platform ) cls.names = np.array([i.name for i in cls.satellite.instruments]) cls.recorded = cls.entry.record.configurations[cls.sizes_key].fixture_metrics @@ -174,7 +175,7 @@ def test_published_dimensions(self): orbit = CircularOrbit( altitude=altitude * 1e3, inclination=inclination, epoch=PUBLISHED_EPOCH ) - satellite = self.entry.to_satellite(orbit, self.sizes_key) + satellite = self.entry.to_satellite(orbit, configuration=self.sizes_key) time = PUBLISHED_EPOCH + timedelta(minutes=10) target = compute_projected_ray_position( orbit.to_gp_orbit().get_orbit_track(time), diff --git a/tests/catalog/test_smap_fixture.py b/tests/catalog/test_smap_fixture.py index a9d79e6b..3ac8fc54 100644 --- a/tests/catalog/test_smap_fixture.py +++ b/tests/catalog/test_smap_fixture.py @@ -18,7 +18,8 @@ import pandas as pd from tatc.analysis import compute_sample_sizes -from tatc.catalog import get_entry, get_gates +from tatc.catalog import get_entry +from tatc.catalog.standard import get_gates from tatc.schemas import CircularOrbit, GeneralPerturbationsOrbit from .common import use_fixture_earth_orientation @@ -57,7 +58,7 @@ def setUpClass(cls): def _build(self, orbit): return self.entry.to_satellite( - orbit, CONFIGURATION, time_step=SCAN_PERIOD, platform=PLATFORM + orbit, configuration=CONFIGURATION, time_step=SCAN_PERIOD, platform=PLATFORM ) def test_published_dimensions(self): diff --git a/tests/catalog/test_standard.py b/tests/catalog/test_standard.py index 2592898f..a718ab46 100644 --- a/tests/catalog/test_standard.py +++ b/tests/catalog/test_standard.py @@ -5,16 +5,18 @@ """ import unittest +from datetime import date, timedelta -from tatc.catalog import ( +from pydantic import ValidationError + +from tatc.catalog import STANDARD_VERSION, Grade, InstrumentClass, InstrumentEntry, Tier +from tatc.catalog.schemas import get_period_days +from tatc.catalog.standard import ( + COMPATIBLE_VERSIONS, MIN_HOLDOUT_GAP_DAYS, - STANDARD_VERSION, - Grade, - InstrumentClass, - InstrumentEntry, - Tier, get_gates, get_required_grades, + is_compatible, ) # (metric, limit, at most) by class and grade. These thresholds are frozen: they @@ -181,13 +183,74 @@ def test_required_grades(self): get_required_grades(InstrumentClass.GEOSTATIONARY), (Grade.COVERAGE,) ) + def test_compatible_versions(self): + """ + Test that results apply under the compatible versions that have their + class's gates, as each version after the first only added a class. + """ + self.assertEqual(COMPATIBLE_VERSIONS, tuple(range(1, STANDARD_VERSION + 1))) + self.assertTrue(is_compatible(InstrumentClass.CROSS_TRACK, 1)) + self.assertFalse(is_compatible(InstrumentClass.LIDAR, 1)) + self.assertTrue(is_compatible(InstrumentClass.LIDAR, 2)) + self.assertFalse(is_compatible(InstrumentClass.PROFILER, 5)) + self.assertFalse( + is_compatible(InstrumentClass.CROSS_TRACK, STANDARD_VERSION + 1) + ) + + def test_tier_rank(self): + """ + Test that tiers rank from weakest to strongest. + """ + self.assertEqual( + sorted(Tier, key=lambda tier: tier.rank), + [Tier.NOMINAL, Tier.PARTIAL, Tier.VALIDATED], + ) + + +class TestPeriods(unittest.TestCase): + """ + Unit tests for the periods of fitting and test data. + """ + + def test_forms(self): + """ + Test a date, a time with a zone, a range, and a list. + """ + day = date(2026, 10, 2) + self.assertEqual(get_period_days("2026-10-02"), ((day, day),)) + self.assertEqual(get_period_days("2026-10-02T23:30Z"), ((day, day),)) + self.assertEqual( + get_period_days("2026-10-02T23:30-02:00"), + ((day + timedelta(days=1), day + timedelta(days=1)),), + ) + self.assertEqual( + get_period_days("2026-08-15 to 2026-10-02"), ((date(2026, 8, 15), day),) + ) + self.assertEqual( + get_period_days("2026-10-01, 2026-10-02"), + ((day - timedelta(days=1),) * 2, (day, day)), + ) + + def test_invalid(self): + """ + Test that periods of other forms are rejected. + """ + for period in ( + "October 2026", + "2026-10-02 and 2026-10-03", + "2026-10-02T12:00", + "2026-10-03 to 2026-10-02", + ): + with self.assertRaises(ValueError, msg=period): + get_period_days(period) + def _measured(): return { "kind": "measured", "source": "test", - "platform": "test", - "period": "2026-01-01", + "platforms": ["test"], + "period": "2025-12-01 to 2026-01-01", } @@ -205,12 +268,13 @@ def _entry( "selection": "test", "platforms": [ { - "id": "test", - "name": "Test", + "id": platform, + "name": platform, "norad_id": 1, "status": "operational", "as_of": "2026-01-01", } + for platform in ("test", "other") ], "data_products": [ {"name": "T", "provider": "T", "url": "http://t", "access": "open"} @@ -237,16 +301,15 @@ def _entry( digest = InstrumentEntry(**data).configurations["c"].digest data["record"] = { "entry_id": "test", - "standard_version": 1, "configurations": { "c": { "digest": digest, - "evidence": "rerun", + "standard_version": 1, "tatc_version": "0", "source": "test", "reference": "test", - "period": "2026-01-01", - "platform": "test", + "period": "2026-03-01", + "platforms": ["test"], "metrics": metrics, **(record or {}), } @@ -317,14 +380,32 @@ def test_worst_scope_decides(self): self.assertEqual(result.value, 0.9) self.assertIs(result.passed, False) - def test_reported_evidence_is_partial(self): + def test_incompatible_version_is_partial(self): """ - Test that results not reproduced with exact values are not validated. + Test that results under a version of the standard that does not apply are + not validated. """ validation = _entry( - metrics=self.good, record={"evidence": "reported"} + metrics=self.good, record={"standard_version": STANDARD_VERSION + 1} ).validation self.assertEqual(validation.tier, Tier.PARTIAL) + self.assertIn("does not apply", validation.configurations["c"].gaps[0]) + + def test_record_of_untested_platform_invalid(self): + """ + Test that a record is of the platforms on which its configuration is + tested, and its transfers of other platforms of the entry. + """ + with self.assertRaisesRegex(ValidationError, "not those tested"): + _entry(metrics=self.good, record={"platforms": ["other"]}) + transfer = {"period": "2026-03-02", "metrics": self.good} + validation = _entry( + metrics=self.good, record={"transfers": {"other": transfer}} + ).validation + self.assertEqual(validation.tier, Tier.VALIDATED) + for platform in ("test", "unknown"): + with self.assertRaisesRegex(ValidationError, "transfers", msg=platform): + _entry(metrics=self.good, record={"transfers": {platform: transfer}}) def test_changed_configuration_is_partial(self): """ @@ -335,17 +416,28 @@ def test_changed_configuration_is_partial(self): def test_fitted_values_need_holdout(self): """ - Test the holdout rule for fitted values, at the limit of its gap. + Test the holdout rule for fitted values, at the limit of its gap, which is + computed from the periods of the fitting data and the test, before or + after the fit. """ - for gap, expected in ( - (None, Tier.PARTIAL), - (MIN_HOLDOUT_GAP_DAYS - 1, Tier.PARTIAL), - (MIN_HOLDOUT_GAP_DAYS, Tier.VALIDATED), + fit_first, fit_last = date(2025, 12, 1), date(2026, 1, 1) + for period, gap, expected in ( + ("2025-12-15", 0, Tier.PARTIAL), + ( + str(fit_last + timedelta(days=MIN_HOLDOUT_GAP_DAYS - 1)), + 29, + Tier.PARTIAL, + ), + (str(fit_last + timedelta(days=MIN_HOLDOUT_GAP_DAYS)), 30, Tier.VALIDATED), + (str(fit_first - timedelta(days=MIN_HOLDOUT_GAP_DAYS)), 30, Tier.VALIDATED), + # the nearest day of a test of several days decides + ("2025-12-31, 2026-03-01", 0, Tier.PARTIAL), ): validation = _entry( - kind="measured", metrics=self.good, record={"holdout_gap_days": gap} + kind="measured", metrics=self.good, record={"period": period} ).validation - self.assertEqual(validation.tier, expected, gap) + self.assertEqual(validation.configurations["c"].holdout_gap_days, gap) + self.assertEqual(validation.tier, expected, period) def test_derived_values_need_no_holdout(self): """ @@ -353,6 +445,7 @@ def test_derived_values_need_no_holdout(self): """ validation = _entry(kind="derived", metrics=self.good).validation self.assertEqual(validation.tier, Tier.VALIDATED) + self.assertIsNone(validation.configurations["c"].holdout_gap_days) def test_missing_required_grade_limits_entry(self): """ @@ -373,6 +466,24 @@ def test_missing_required_grade_limits_entry(self): validation.gaps, ("no configuration at the sample_size grade",) ) + def test_class_added_after_version_is_partial(self): + """ + Test that results under a version before a class's gates are not + validated. + """ + metrics = [ + {"name": "segment_recall", "value": 100}, + {"name": "track_offset_median", "value": 0}, + {"name": "epoch_p95", "value": 0}, + ] + for version, expected in ((5, Tier.PARTIAL), (6, Tier.VALIDATED)): + validation = _entry( + metrics=metrics, + cls="profiler", + record={"standard_version": version}, + ).validation + self.assertEqual(validation.tier, expected, version) + def test_grade_without_gates_invalid(self): """ Test that a configuration cannot use a grade its class does not have. diff --git a/tests/catalog/test_tilt_schedule.py b/tests/catalog/test_tilt_schedule.py index 8a62ff1b..6713ebe4 100644 --- a/tests/catalog/test_tilt_schedule.py +++ b/tests/catalog/test_tilt_schedule.py @@ -11,7 +11,9 @@ import numpy as np from pydantic import ValidationError -from tatc.catalog import TiltSchedule, get_entry, get_subsolar_latitude +from tatc.catalog import get_entry +from tatc.catalog.schemas import TiltSchedule +from tatc.utils import compute_subsolar_latitude from tatc.schemas import Attitude, AttitudeSchedule, GeneralPerturbationsOrbit from tatc.utils import VelocityFrame from tatc.utils.orbital import compute_argument_of_latitude @@ -23,7 +25,7 @@ MEASURED = { "kind": "measured", "source": "a test", - "platform": "pace", + "platforms": ["pace"], "period": "2026-10-04", } @@ -53,11 +55,13 @@ def test_solstices_and_equinox(self): Test that the subsolar latitude is the obliquity at the solstices and near zero at an equinox. """ - june = get_subsolar_latitude(datetime(2026, 6, 21, 12, tzinfo=timezone.utc)) - december = get_subsolar_latitude( + june = compute_subsolar_latitude(datetime(2026, 6, 21, 12, tzinfo=timezone.utc)) + december = compute_subsolar_latitude( datetime(2026, 12, 21, 12, tzinfo=timezone.utc) ) - march = get_subsolar_latitude(datetime(2026, 3, 20, 15, tzinfo=timezone.utc)) + march = compute_subsolar_latitude( + datetime(2026, 3, 20, 15, tzinfo=timezone.utc) + ) self.assertAlmostEqual(june, 23.44, delta=0.01) self.assertAlmostEqual(december, -23.44, delta=0.01) self.assertAlmostEqual(march, 0, delta=0.01) @@ -98,7 +102,7 @@ def test_offset_alternates_by_day(self): noon = datetime(day.year, day.month, day.day, 12, tzinfo=timezone.utc) self.assertAlmostEqual( self.schedule.get_switch_latitude(day), - get_subsolar_latitude(noon) + offset, + compute_subsolar_latitude(noon) + offset, ) def test_profile_changes_after_ascending_node(self): @@ -280,7 +284,7 @@ def test_schedule_is_fitted_and_digested(self): self.assertTrue(configuration.is_fitted) changed = configuration.model_copy( update={ - "attitude_schedule": configuration.attitude_schedule.model_copy( + "tilt_schedule": configuration.tilt_schedule.model_copy( update={"odd_day_offset": 5.0} ) } diff --git a/tests/catalog/test_tmi_fixture.py b/tests/catalog/test_tmi_fixture.py index ee2e667a..69bbbbf3 100644 --- a/tests/catalog/test_tmi_fixture.py +++ b/tests/catalog/test_tmi_fixture.py @@ -17,7 +17,8 @@ import pandas as pd from tatc.analysis import collect_observations, compute_sample_sizes -from tatc.catalog import get_entry, get_gates +from tatc.catalog import get_entry +from tatc.catalog.standard import get_gates from tatc.catalog.metrics import summarize from tatc.schemas import CircularOrbit, GeneralPerturbationsOrbit, Point @@ -76,7 +77,7 @@ def build(self, orbit): Gets the configuration's satellite on an orbit. """ return self.entry.to_satellite( - orbit, self.key, time_step=SCAN_PERIOD, platform=PLATFORM + orbit, configuration=self.key, time_step=SCAN_PERIOD, platform=PLATFORM ) diff --git a/tests/tradespace/test_constellations.py b/tests/tradespace/test_constellations.py index ca71b6e5..bd3fe8ba 100644 --- a/tests/tradespace/test_constellations.py +++ b/tests/tradespace/test_constellations.py @@ -5,13 +5,14 @@ """ import unittest -from datetime import datetime, time, timezone +from datetime import datetime, time, timedelta, timezone import numpy as np import tatc.tradespace from tatc.schemas import ( + AttitudeSchedule, CircularOrbit, Instrument, MOGConstellation, @@ -246,6 +247,24 @@ def test_catalog_payloads(self): time_step=30, )[0] self.assertEqual(len(both.instruments), 2) + with self.assertRaisesRegex(ValueError, "different attitudes"): + build_constellation( + design.layout, + ["atms", "oco2:glint"], + epoch=EPOCH, + altitude=830e3, + time_step=30, + ) + tilted = build_constellation( + design.layout, + "oci", + epoch=EPOCH, + altitude=830e3, + time_step=30, + start=EPOCH, + end=EPOCH + timedelta(days=2), + )[0] + self.assertIsInstance(tilted.attitude, AttitudeSchedule) custom = build_constellation( design.layout, lambda name, orbit: Satellite(name=name, orbit=orbit, instruments=[IMAGER]), diff --git a/validation/catalog/compare_swath_time_steps.py b/validation/catalog/compare_swath_time_steps.py index ec8b0d1f..88cdb241 100644 --- a/validation/catalog/compare_swath_time_steps.py +++ b/validation/catalog/compare_swath_time_steps.py @@ -76,7 +76,7 @@ def get_swath(entry, key, orbit, platform, day, start, step, swept): """Gets the swath of a configuration over a segment at a time step.""" satellite = entry.to_satellite( orbit, - key, + configuration=key, time_step=step, platform=platform, start=day, @@ -95,8 +95,10 @@ def get_swath(entry, key, orbit, platform, day, start, step, swept): start + timedelta(seconds=step * (k + 0.5)) for k in range(int(round(DURATION / step))) ] - grouping = str(entry.configurations[key].grouping) - index = None if grouping.endswith("union") else 0 + configuration = entry.configurations[key] + index = ( + None if configuration.grouping == "union" else configuration.instrument_index + ) track = compute_ground_track(satellite, times, instrument_index=index) return None if track.empty else track.geometry.iloc[0] diff --git a/validation/catalog/earthcare_io.py b/validation/catalog/earthcare_io.py index aac5c714..97586191 100644 --- a/validation/catalog/earthcare_io.py +++ b/validation/catalog/earthcare_io.py @@ -24,7 +24,6 @@ import pandas as pd import requests -import tatc from tatc.analysis import collect_observations from tatc.catalog.metrics import summarize from tatc.schemas import Point @@ -32,13 +31,12 @@ TO_GEODETIC, RemoteFile, ecef, - get_holdout_gap, get_with_retries, normalize, recompute_passes, up, update_fixture, - update_record, + write_record, ) CATALOGUE = "https://catalog.maap.eo.esa.int/catalogue/collections" @@ -334,7 +332,6 @@ def validate_profiler( orbit, tle, day: datetime, - fit_day: datetime, record_path: pathlib.Path, fixture_path: pathlib.Path, source: str, @@ -359,7 +356,7 @@ def validate_profiler( } ) satellite = entry.to_satellite( - orbit, configuration, time_step=TIME_STEPS[0], platform=platform + orbit, configuration=configuration, time_step=TIME_STEPS[0], platform=platform ) offsets = track_offsets(satellite, sample) results = {"track_offset_median": float(np.median(offsets))} @@ -371,7 +368,7 @@ def validate_profiler( by_step = {} for time_step in TIME_STEPS: satellite = entry.to_satellite( - orbit, configuration, time_step=time_step, platform=platform + orbit, configuration=configuration, time_step=time_step, platform=platform ) differences = find_epochs(satellite, sample) found = np.isfinite(differences) @@ -403,32 +400,26 @@ def validate_profiler( fixture_path, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) satellite = entry.to_satellite( - orbit, configuration, time_step=TIME_STEPS[0], platform=platform + orbit, configuration=configuration, time_step=TIME_STEPS[0], platform=platform ) - update_record( + write_record( record_path, - entry.id, + entry, configuration, - { - "digest": entry.configurations[configuration].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source, - "reference": reference, - "period": f"{day:%Y-%m-%d}", - "platform": platform, - "holdout_gap_days": get_holdout_gap(day, fit_day), - "metrics": [ - {"name": name, "value": float(results[name])} - for name in ( - "segment_recall", - "track_offset_median", - "epoch_p95", - "epoch_median", - ) - ], - "fixture_metrics": recompute_passes(satellite, 0, day, passes), - }, + source=source, + reference=reference, + period=f"{day:%Y-%m-%d}", + platforms=[platform], + metrics=[ + {"name": name, "value": float(results[name])} + for name in ( + "segment_recall", + "track_offset_median", + "epoch_p95", + "epoch_median", + ) + ], + fixture_metrics=recompute_passes(satellite, 0, day, passes), ) print(f"wrote {record_path} and {fixture_path}") return results diff --git a/validation/catalog/gesdisc_scanner.py b/validation/catalog/gesdisc_scanner.py index 083c9258..47b2867d 100644 --- a/validation/catalog/gesdisc_scanner.py +++ b/validation/catalog/gesdisc_scanner.py @@ -25,7 +25,6 @@ from skyfield.framelib import itrs from skyfield.positionlib import Geocentric -import tatc from tatc.catalog.metrics import summarize from tatc.generation import generate_points_fibonacci_lattice from tatc.constants import timescale @@ -36,14 +35,13 @@ compute_view_tangents, ) from validation_io import ( - add_transfer_metrics, + write_transfer, TO_GEODETIC, RemoteFile, build_grid, compute_published_errors, compute_spacing_ratios, ecef, - get_holdout_gap, get_with_retries, in_lattice_cells, normalize, @@ -53,7 +51,7 @@ score_swath_area, up, update_fixture, - update_record, + write_record, login_earthdata, ) @@ -727,7 +725,6 @@ class Setup: source: str reference: str published_reference: str - fit_day: datetime time_steps: tuple[float, ...] pass_radius: float point_spacing: float = 500e3 @@ -753,7 +750,7 @@ def validate_beams( print( f"published dimensions: {within:.1f}% within 3%, largest error {largest:.2f}%" ) - satellite = entry.to_satellite(orbit, setup.beams, platform=platform) + satellite = entry.to_satellite(orbit, configuration=setup.beams, platform=platform) names = [instrument.name for instrument in satellite.instruments] index = names.index(setup.size_instrument) pixels = measure_pixels( @@ -774,10 +771,11 @@ def validate_beams( if not write: return if platform != setup.platform: - add_transfer_metrics( + write_transfer( setup.record_path, setup.beams, - f"{platform}, {day:%Y-%m-%d}", + platform, + f"{day:%Y-%m-%d}", { "pixel_position_median": median, "pixel_position_p95": p95, @@ -800,33 +798,27 @@ def validate_beams( spacing=rows[picks], spacing_seconds=(times[picks] - pd.Timestamp(day)).total_seconds().to_numpy(), ) - update_record( + write_record( setup.record_path, - setup.entry_id, + entry, setup.beams, - { - "digest": entry.configurations[setup.beams].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": setup.source, - "reference": setup.published_reference, - "period": f"{day:%Y-%m-%d}", - "platform": setup.platform, - "holdout_gap_days": get_holdout_gap(day, setup.fit_day), - "metrics": [ - {"name": "sample_size_within_3pct", "value": within}, - {"name": "sample_size_largest_error", "value": largest}, - {"name": "pixel_position_median", "value": median}, - {"name": "pixel_position_p95", "value": p95}, - {"name": "spacing_along_ratio_median", "value": along}, - {"name": "spacing_cross_ratio_median", "value": cross}, - ], - "fixture_metrics": { - "sample_size_within_3pct": within, - "pixel_position_median": summarize(reduced[:, 2])["median"], - "spacing_along_ratio_median": fixture_along, - "spacing_cross_ratio_median": fixture_cross, - }, + source=setup.source, + reference=setup.published_reference, + period=f"{day:%Y-%m-%d}", + platforms=[setup.platform], + metrics=[ + {"name": "sample_size_within_3pct", "value": within}, + {"name": "sample_size_largest_error", "value": largest}, + {"name": "pixel_position_median", "value": median}, + {"name": "pixel_position_p95", "value": p95}, + {"name": "spacing_along_ratio_median", "value": along}, + {"name": "spacing_cross_ratio_median", "value": cross}, + ], + fixture_metrics={ + "sample_size_within_3pct": within, + "pixel_position_median": summarize(reduced[:, 2])["median"], + "spacing_along_ratio_median": fixture_along, + "spacing_cross_ratio_median": fixture_cross, }, ) @@ -844,7 +836,7 @@ def satellite_for(time_step: float): # the period of the day, for a configuration that schedules its attitude return entry.to_satellite( orbit, - setup.swath, + configuration=setup.swath, time_step=time_step, platform=platform, start=day, @@ -876,10 +868,11 @@ def satellite_for(time_step: float): if not write: return if platform != setup.platform: - add_transfer_metrics( + write_transfer( setup.record_path, setup.swath, - f"{platform}, {day:%Y-%m-%d}", + platform, + f"{day:%Y-%m-%d}", {name: float(results[name]) for name in GATED}, ) return @@ -901,29 +894,23 @@ def satellite_for(time_step: float): day=np.array(day.isoformat()), passes=passes, ) - update_record( + write_record( setup.record_path, - setup.entry_id, + entry, setup.swath, - { - "digest": entry.configurations[setup.swath].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": setup.source, - "reference": setup.reference, - "period": f"{day:%Y-%m-%d}", - "platform": setup.platform, - "holdout_gap_days": get_holdout_gap(day, setup.fit_day), - "metrics": [ - {"name": name, "value": float(results[name])} - for name in ( - "pass_recall", - "pass_precision", - "epoch_p95", - "swath_width_median", - "footprint_iou_median", - ) - ], - "fixture_metrics": recompute_passes(satellite, 0, day, passes), - }, + source=setup.source, + reference=setup.reference, + period=f"{day:%Y-%m-%d}", + platforms=[setup.platform], + metrics=[ + {"name": name, "value": float(results[name])} + for name in ( + "pass_recall", + "pass_precision", + "epoch_p95", + "swath_width_median", + "footprint_iou_median", + ) + ], + fixture_metrics=recompute_passes(satellite, 0, day, passes), ) diff --git a/validation/catalog/validate_catalog_abi.py b/validation/catalog/validate_catalog_abi.py index c25025a5..4422f61b 100644 --- a/validation/catalog/validate_catalog_abi.py +++ b/validation/catalog/validate_catalog_abi.py @@ -14,7 +14,6 @@ """ import concurrent.futures -import json import pathlib import sys import xml.etree.ElementTree as ET @@ -25,9 +24,8 @@ import xarray as xr from skyfield.framelib import itrs -import tatc from tatc.analysis import collect_observations -from tatc.catalog import STANDARD_VERSION, get_entry +from tatc.catalog import get_entry from tatc.catalog.metrics import compute_product_limit_error from tatc.constants import timescale from tatc.schemas import GeneralPerturbationsOrbit, Point @@ -37,6 +35,7 @@ RECORDS, FIXTURES, source_of, + write_record, ) RECORD_PATH = RECORDS / "abi.json" @@ -158,11 +157,9 @@ def main(directory: pathlib.Path) -> None: entry = get_entry("abi") orbit = GeneralPerturbationsOrbit.from_tle(list(TLE)) common = { - "evidence": "rerun", - "tatc_version": tatc.__version__, "source": source_of(__file__), "period": f"{TIME:%Y-%m-%dT%H:%MZ}", - "platform": "goes-19", + "platforms": ["goes-19"], } fixture = {"tle": np.array(TLE), "time": np.array(TIME.isoformat())} records = {} @@ -176,11 +173,10 @@ def main(directory: pathlib.Path) -> None: picks = rng.choice(np.flatnonzero(on_grid & imaged), SAMPLES, replace=False) lat, lon = latitude.flat[picks], longitude.flat[picks] zenith = compute_zenith(orbit, lat, lon) - satellite = entry.to_satellite(orbit, "full_disk", platform="goes-19") + satellite = entry.to_satellite(orbit, configuration="full_disk", platform="goes-19") observed, elevation = predict(satellite, lat, lon) records["full_disk"] = { **common, - "digest": entry.configurations["full_disk"].digest, "reference": "ABI-L2-ACMF clear sky mask, every 8th pixel", "metrics": [ {"name": "imaged_pixels_observed", "value": 100 * float(observed.mean())}, @@ -223,11 +219,10 @@ def main(directory: pathlib.Path) -> None: ) lat, lon = latitude.flat[picks], longitude.flat[picks] picked_zenith, picked_good = zenith.flat[picks], good.flat[picks] - satellite = entry.to_satellite(orbit, key, platform="goes-19") + satellite = entry.to_satellite(orbit, configuration=key, platform="goes-19") observed, _ = predict(satellite, lat, lon) records[key] = { **common, - "digest": entry.configurations[key].digest, "reference": f"{product} {variable} and quality flags", "metrics": [ { @@ -255,13 +250,8 @@ def main(directory: pathlib.Path) -> None: FIXTURE_PATH.parent.mkdir(parents=True, exist_ok=True) np.savez_compressed(FIXTURE_PATH, **add_earth_orientation(fixture)) - RECORD_PATH.parent.mkdir(parents=True, exist_ok=True) - record = { - "entry_id": "abi", - "standard_version": STANDARD_VERSION, - "configurations": records, - } - RECORD_PATH.write_text(json.dumps(record, indent=2) + "\n", encoding="utf-8") + for key, results in records.items(): + write_record(RECORD_PATH, entry, key, **results) if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_ahi.py b/validation/catalog/validate_catalog_ahi.py index ae50c158..a14c9a99 100644 --- a/validation/catalog/validate_catalog_ahi.py +++ b/validation/catalog/validate_catalog_ahi.py @@ -26,19 +26,18 @@ import xarray as xr from skyfield.framelib import itrs -import tatc from tatc.analysis import collect_observations -from tatc.catalog import STANDARD_VERSION, get_entry +from tatc.catalog import get_entry from tatc.catalog.metrics import compute_product_limit_error from tatc.constants import timescale from tatc.schemas import GeneralPerturbationsOrbit, Point from tatc.utils import compute_field_of_regard from validation_io import ( add_earth_orientation, - get_holdout_gap, RECORDS, FIXTURES, source_of, + write_record, ) RECORD_PATH = RECORDS / "ahi.json" @@ -195,11 +194,9 @@ def validate(directory: pathlib.Path, write: bool) -> None: orbit = GeneralPerturbationsOrbit.from_tle(list(TLE)) position = satellite_position(orbit) common = { - "evidence": "rerun", - "tatc_version": tatc.__version__, "source": source_of(__file__), "period": f"{TIME:%Y-%m-%dT%H:%MZ}", - "platform": "himawari-9", + "platforms": ["himawari-9"], } fixture = {"tle": np.array(TLE), "time": np.array(TIME.isoformat())} records = {} @@ -209,12 +206,13 @@ def validate(directory: pathlib.Path, write: bool) -> None: download("CMSK", TIME, directory), "CloudMask", position, 8 ) picks = rng.choice(np.flatnonzero(imaged), SAMPLES, replace=False) - satellite = entry.to_satellite(orbit, "full_disk", platform="himawari-9") + satellite = entry.to_satellite( + orbit, configuration="full_disk", platform="himawari-9" + ) observed, elevation = predict(satellite, lat[picks], lon[picks]) error = np.abs(elevation - (90 - zenith[picks])) records["full_disk"] = { **common, - "digest": entry.configurations["full_disk"].digest, "reference": "AHI-CMSK cloud mask, every 8th pixel", "metrics": [ {"name": "imaged_pixels_observed", "value": 100 * float(observed.mean())}, @@ -241,15 +239,13 @@ def validate(directory: pathlib.Path, write: bool) -> None: picks = rng.choice( np.flatnonzero(np.abs(zenith - bound) <= 5), SAMPLES, replace=False ) - satellite = entry.to_satellite(orbit, key, platform="himawari-9") + satellite = entry.to_satellite(orbit, configuration=key, platform="himawari-9") observed, _ = predict(satellite, lat[picks], lon[picks]) picked_zenith = zenith[picks] records[key] = { **common, - "digest": entry.configurations[key].digest, "reference": "AHI-CHGT cloud top height, the greatest local zenith angle " "at which it is retrieved", - "holdout_gap_days": get_holdout_gap(TIME, FIT_TIME), "metrics": [ { "name": "product_limit", @@ -274,12 +270,8 @@ def validate(directory: pathlib.Path, write: bool) -> None: return FIXTURE_PATH.parent.mkdir(parents=True, exist_ok=True) np.savez_compressed(FIXTURE_PATH, **add_earth_orientation(fixture)) - record = { - "entry_id": "ahi", - "standard_version": STANDARD_VERSION, - "configurations": records, - } - RECORD_PATH.write_text(json.dumps(record, indent=2) + "\n", encoding="utf-8") + for key, results in records.items(): + write_record(RECORD_PATH, entry, key, **results) print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") diff --git a/validation/catalog/validate_catalog_airs.py b/validation/catalog/validate_catalog_airs.py index 4f17632c..5f0d1655 100644 --- a/validation/catalog/validate_catalog_airs.py +++ b/validation/catalog/validate_catalog_airs.py @@ -48,7 +48,6 @@ source_of, ) -FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # the public element set of `validate_catalog_modis.py` for Aqua, with an epoch after # the days of data AQUA_ELEMENTS = ( @@ -101,7 +100,6 @@ def read_airs(_product, url: str, session, day: datetime, _directory) -> dict: reference="AIRSAQIRL1B version 8.0 (footprint positions and times)", published_reference="Footprints published by the AIRS project; footprint " "positions of AIRSAQIRL1B version 8.0", - fit_day=FIT_DAY, time_steps=(SCAN_PERIOD, 32, 128), pass_radius=30, point_spacing=200e3, diff --git a/validation/catalog/validate_catalog_amsr2.py b/validation/catalog/validate_catalog_amsr2.py index 3e1ce98e..07a26ff8 100644 --- a/validation/catalog/validate_catalog_amsr2.py +++ b/validation/catalog/validate_catalog_amsr2.py @@ -45,26 +45,25 @@ import numpy as np import pandas as pd import requests -from pyproj import Geod, Transformer +from pyproj import Geod from scipy.spatial import cKDTree from shapely import contains_xy, prepare -import tatc from tatc.analysis import ( collect_observations, compute_ground_track, compute_sample_sizes, ) -from tatc.catalog import STANDARD_VERSION, get_entry +from tatc.catalog import get_entry from tatc.catalog.metrics import compute_mask_iou, compute_pass_scores, summarize from tatc.generation import generate_points_fibonacci_lattice from tatc.schemas import CircularOrbit, GeneralPerturbationsOrbit, Point import validation_io +from validation_io import TO_GEODETIC, ecef, normalize, up RECORD_PATH = validation_io.RECORDS / "amsr2.json" FIXTURE_PATH = validation_io.FIXTURES / "amsr2.npz" -FIT_DAY = datetime(2026, 9, 26, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data ELEMENTS = { "2026-09-26": ( @@ -103,8 +102,6 @@ FIXTURE_SPACING_SAMPLES = 100 GEOD = Geod(ellps="WGS84") -TO_ECEF = Transformer.from_crs("EPSG:4979", "EPSG:4978", always_xy=True) -TO_GEODETIC = Transformer.from_crs("EPSG:4978", "EPSG:4979", always_xy=True) def load_day(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: @@ -168,26 +165,6 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: return dict(np.load(cache)) -def ecef(lon, lat, height=0.0) -> np.ndarray: - """Gets the Earth-fixed position (m) of geodetic coordinates.""" - return np.stack( - TO_ECEF.transform(lon, lat, np.broadcast_to(height, np.shape(lon))), axis=-1 - ) - - -def up(lon, lat) -> np.ndarray: - """Gets the geodetic up unit vector.""" - lon, lat = np.radians(lon), np.radians(lat) - return np.stack( - [np.cos(lat) * np.cos(lon), np.cos(lat) * np.sin(lon), np.sin(lat)], axis=-1 - ) - - -def normalize(x: np.ndarray) -> np.ndarray: - """Gets unit vectors along the last axis.""" - return x / np.linalg.norm(x, axis=-1, keepdims=True) - - class Reference: """A day of AMSR2 scans, with what is derived from them.""" @@ -454,7 +431,10 @@ def score_published_footprints(entry) -> tuple[float, float]: epoch=PUBLISHED_EPOCH, ) satellite = entry.to_satellite( - orbit, SAMPLE_CONFIGURATION, time_step=SCAN_PERIOD, platform="gcom-w" + orbit, + configuration=SAMPLE_CONFIGURATION, + time_step=SCAN_PERIOD, + platform="gcom-w", ) names = [instrument.name for instrument in satellite.instruments] time = PUBLISHED_EPOCH + timedelta(minutes=10) @@ -545,21 +525,6 @@ def update_fixture(**arrays) -> None: validation_io.update_fixture(FIXTURE_PATH, **arrays) -def update_record(key: str, configuration: dict) -> None: - """Writes the results of a configuration to the record, keeping the others.""" - record = {"entry_id": "amsr2", "configurations": {}} - if RECORD_PATH.exists(): - record = json.loads(RECORD_PATH.read_text(encoding="utf-8")) - record["standard_version"] = STANDARD_VERSION - record["configurations"][key] = configuration - RECORD_PATH.write_text(json.dumps(record, indent=2) + "\n", encoding="utf-8") - - -def get_holdout_gap(day: datetime) -> int | None: - """Gets the days from the fit to a day, to which the standard applies its gap.""" - return None if day == FIT_DAY else abs((day - FIT_DAY).days) - - def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> None: """Scores the sample size configuration, and writes its results if requested.""" within, largest = score_published_footprints(entry) @@ -571,7 +536,10 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non {"name": "sample_size_largest_error", "value": largest}, ] satellite = entry.to_satellite( - orbit, SAMPLE_CONFIGURATION, time_step=SCAN_PERIOD, platform="gcom-w" + orbit, + configuration=SAMPLE_CONFIGURATION, + time_step=SCAN_PERIOD, + platform="gcom-w", ) names = [instrument.name for instrument in satellite.instruments] rng = np.random.default_rng(2) @@ -606,25 +574,19 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non spacing=np.concatenate(reduced), spacing_instruments=np.concatenate(indices), ) - update_record( + validation_io.write_record( + RECORD_PATH, + entry, SAMPLE_CONFIGURATION, - { - "digest": entry.configurations[SAMPLE_CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": validation_io.source_of(__file__), - "reference": "Footprints of JAXA's AMSR2 channel set; spacing of " - "GPM_1CGCOMW1AMSR2 version 08", - "period": f"{day:%Y-%m-%d}", - "platform": "gcom-w", - # the angles were not fitted to the published footprints, and the - # spacing is measured on this day - "holdout_gap_days": get_holdout_gap(day), - "metrics": metrics, - "fixture_metrics": { - "sample_size_within_3pct": within, - **fixture_metrics, - }, + source=validation_io.source_of(__file__), + reference="Footprints of JAXA's AMSR2 channel set; spacing of " + "GPM_1CGCOMW1AMSR2 version 08", + period=f"{day:%Y-%m-%d}", + platforms=["gcom-w"], + metrics=metrics, + fixture_metrics={ + "sample_size_within_3pct": within, + **fixture_metrics, }, ) @@ -663,22 +625,18 @@ def write_fixture_and_record(day, tle, entry, orbit, results, table) -> None: "footprint_iou_median", ) ] - update_record( + validation_io.write_record( + RECORD_PATH, + entry, "swath", - { - "digest": entry.configurations["swath"].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": validation_io.source_of(__file__), - "reference": "GPM_1CGCOMW1AMSR2 version 08", - "period": f"{day:%Y-%m-%d}", - "platform": "gcom-w", - "holdout_gap_days": get_holdout_gap(day), - "metrics": metrics, - "fixture_metrics": { - "passes_found": 100 * float(np.isfinite(differences).mean()), - "epoch_p95": summarize(differences)["p95"], - }, + source=validation_io.source_of(__file__), + reference="GPM_1CGCOMW1AMSR2 version 08", + period=f"{day:%Y-%m-%d}", + platforms=["gcom-w"], + metrics=metrics, + fixture_metrics={ + "passes_found": 100 * float(np.isfinite(differences).mean()), + "epoch_p95": summarize(differences)["p95"], }, ) diff --git a/validation/catalog/validate_catalog_amsua.py b/validation/catalog/validate_catalog_amsua.py index c83b286c..8c93fc25 100644 --- a/validation/catalog/validate_catalog_amsua.py +++ b/validation/catalog/validate_catalog_amsua.py @@ -48,7 +48,6 @@ source_of, ) -FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # the public element set of `validate_catalog_modis.py` for Aqua, with an epoch after # the day of data ELEMENTS = { @@ -132,7 +131,6 @@ def read_amsua(_product, url: str, session, day: datetime, directory) -> dict: reference="AIRABRAD version 005 (footprint positions and times)", published_reference="Footprint published in the AIRABRAD documentation; " "footprint positions of AIRABRAD version 005", - fit_day=FIT_DAY, time_steps=(SCAN_PERIOD, 32, 128), pass_radius=80, point_spacing=500e3, diff --git a/validation/catalog/validate_catalog_ascat.py b/validation/catalog/validate_catalog_ascat.py index 02c4e591..af96280f 100644 --- a/validation/catalog/validate_catalog_ascat.py +++ b/validation/catalog/validate_catalog_ascat.py @@ -53,7 +53,6 @@ from shapely.ops import unary_union from skyfield.framelib import itrs -import tatc from tatc.analysis import compute_ground_track from tatc.catalog import get_entry from tatc.catalog.metrics import compute_mask_iou @@ -63,7 +62,6 @@ from validation_io import ( TO_GEODETIC, ecef, - get_holdout_gap, get_with_retries, match_passes, normalize, @@ -72,7 +70,7 @@ recompute_passes, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -85,7 +83,6 @@ SHORT_NAME = "ASCATC-L2-25km" NORAD_ID = 43689 -FIT_DAY = datetime(2026, 10, 5, tzinfo=timezone.utc) PLATFORM = "metop-c" CONFIGURATION = "swaths" # element sets of the fitting day, and public element sets from CelesTrak, with @@ -503,22 +500,16 @@ def satellite_for(time_step: float): update_fixture( FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=fixture ) - update_record( + write_record( RECORD_PATH, - "ascat", + entry, CONFIGURATION, - { - "digest": entry.configurations[CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": f"{SHORT_NAME} (wind vector cell positions and row times)", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": metrics, - "fixture_metrics": recompute_passes(satellite, None, day, fixture), - }, + source=source_of(__file__), + reference=f"{SHORT_NAME} (wind vector cell positions and row times)", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=metrics, + fixture_metrics=recompute_passes(satellite, None, day, fixture), ) print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") diff --git a/validation/catalog/validate_catalog_atlas.py b/validation/catalog/validate_catalog_atlas.py index 059411a6..fe610c60 100644 --- a/validation/catalog/validate_catalog_atlas.py +++ b/validation/catalog/validate_catalog_atlas.py @@ -45,7 +45,6 @@ from pyproj import Geod from skyfield.api import wgs84 -import tatc from tatc.analysis import collect_observations from tatc.catalog import get_entry from tatc.catalog.metrics import summarize @@ -53,10 +52,9 @@ from tatc.schemas import GeneralPerturbationsOrbit, Point from validation_io import ( RemoteFile, - get_holdout_gap, read_element_set_file, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -67,7 +65,6 @@ RECORD_PATH = RECORDS / "atlas.json" FIXTURE_PATH = FIXTURES / "atlas.npz" -FIT_DAY = datetime(2026, 10, 1, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs a few days after each day of data; # the first is that of `ValidateLidarICESat2` ELEMENTS = { @@ -238,7 +235,7 @@ def score_segments(entry, orbit, segments: pd.DataFrame, day: datetime) -> dict: results = {} for time_step in TIME_STEPS: satellite = entry.to_satellite( - orbit, CONFIGURATION, time_step=time_step, platform="icesat-2" + orbit, configuration=CONFIGURATION, time_step=time_step, platform="icesat-2" ) differences = find_epochs(satellite, sample) found = np.isfinite(differences) @@ -349,7 +346,7 @@ def main() -> None: if not arguments.write: return satellite = entry.to_satellite( - orbit, CONFIGURATION, time_step=TIME_STEPS[0], platform="icesat-2" + orbit, configuration=CONFIGURATION, time_step=TIME_STEPS[0], platform="icesat-2" ) rng = np.random.default_rng(2) reduced = passes[rng.choice(len(passes), FIXTURE_SEGMENTS, replace=False)] @@ -368,33 +365,27 @@ def main() -> None: FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=reduced ) found = np.isfinite(fixture_differences) - update_record( + write_record( RECORD_PATH, - "atlas", + entry, CONFIGURATION, - { - "digest": entry.configurations[CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "ATL08QL version 007 (land segments south of 60 deg S)", - "period": f"{day:%Y-%m-%d}", - "platform": "icesat-2", - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - { - "name": name, - "value": values[name], - "scope": f"time step {time_step} s", - } - for time_step, values in results.items() - for name in ("segment_recall", "epoch_p95", "epoch_median") - ] - + [{"name": "beam_spacing_error_median", "value": spacing}], - "fixture_metrics": { - "passes_found": 100 * float(found.mean()), - "epoch_p95": float(summarize(fixture_differences[found])["p95"]), - }, + source=source_of(__file__), + reference="ATL08QL version 007 (land segments south of 60 deg S)", + period=f"{day:%Y-%m-%d}", + platforms=["icesat-2"], + metrics=[ + { + "name": name, + "value": values[name], + "scope": f"time step {time_step} s", + } + for time_step, values in results.items() + for name in ("segment_recall", "epoch_p95", "epoch_median") + ] + + [{"name": "beam_spacing_error_median", "value": spacing}], + fixture_metrics={ + "passes_found": 100 * float(found.mean()), + "epoch_p95": float(summarize(fixture_differences[found])["p95"]), }, ) print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") diff --git a/validation/catalog/validate_catalog_atlid.py b/validation/catalog/validate_catalog_atlid.py index 432c8b77..96308ec8 100644 --- a/validation/catalog/validate_catalog_atlid.py +++ b/validation/catalog/validate_catalog_atlid.py @@ -49,7 +49,6 @@ RECORD_PATH = RECORDS / "atlid.json" FIXTURE_PATH = FIXTURES / "atlid.npz" NORAD_ID = 59908 -FIT_DAY = datetime(2026, 9, 27, tzinfo=timezone.utc) ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "earthcare_2026-09-27.3le" PLATFORM = "earthcare" CONFIGURATION = "profile" @@ -102,7 +101,6 @@ def main() -> None: orbit, tle, day, - FIT_DAY, RECORD_PATH, FIXTURE_PATH, source_of(__file__), diff --git a/validation/catalog/validate_catalog_atms.py b/validation/catalog/validate_catalog_atms.py index 5d88f83d..a1e20de0 100644 --- a/validation/catalog/validate_catalog_atms.py +++ b/validation/catalog/validate_catalog_atms.py @@ -42,26 +42,22 @@ from scipy.spatial import cKDTree from skyfield.api import wgs84 -import tatc from tatc.catalog import get_entry from tatc.catalog.metrics import summarize from tatc.generation import generate_points_fibonacci_lattice from tatc.schemas import GeneralPerturbationsOrbit import gesdisc_scanner from validation_io import ( + ARCHIVES, + Archive, TO_GEODETIC, - add_transfer_metrics, - use_archive, + write_transfer, build_grid, compute_published_errors, compute_spacing_ratios, ecef, - fetch, - get_holdout_gap, iet_to_utc, in_lattice_cells, - list_keys, - load_element_set, normalize, recompute_passes, score_passes, @@ -69,7 +65,7 @@ score_swath_area, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -85,12 +81,7 @@ ) RECORD_PATH = RECORDS / "atms.json" -# the days to which each platform's angles were fitted, and its configurations -# (swath, beams) and fixture -FIT_DAYS = { - "noaa-20": datetime(2026, 10, 2, tzinfo=timezone.utc), - "noaa-21": datetime(2026, 11, 5, tzinfo=timezone.utc), -} +# the configurations of each platform's fit and its fixture CONFIGURATIONS = { "noaa-20": ("swath_noaa_20", "beams_noaa_20", FIXTURES / "atms_noaa_20.npz"), "noaa-21": ("swath_noaa_21", "beams_noaa_21", FIXTURES / "atms_noaa_21.npz"), @@ -127,28 +118,29 @@ class Run: """ What a run tests: the configurations of the swath and beams, the platform whose - data they are tested on, the fixture, the day of the fit, and whether the results - are a transfer to a platform on which the configurations were not fitted. + data they are tested on, the fixture, and whether the results are a transfer to + a platform on which the configurations were not fitted. """ platform: str swath: str beams: str fixture_path: pathlib.Path - fit_day: datetime transfer: bool -def load_day(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: +def load_day( + day: datetime, directory: pathlib.Path, archive: Archive +) -> dict[str, np.ndarray]: """Downloads and reduces the geolocation of a day, or loads it from a cache.""" path = directory / f"atms_gatmo_{day:%Y%m%d}.npz" if not path.exists(): def read(key): - with h5py.File(io.BytesIO(fetch(key))) as f: + with h5py.File(io.BytesIO(archive.fetch(key))) as f: return {k: f["All_Data/ATMS-SDR-GEO_All/" + k][:] for k in FIELDS} - keys = list_keys(f"ATMS-SDR-GEO/{day:%Y/%m/%d}/") + keys = archive.list_keys(f"ATMS-SDR-GEO/{day:%Y/%m/%d}/") with concurrent.futures.ThreadPoolExecutor(8) as pool: granules = list(pool.map(read, keys)) np.savez_compressed( @@ -419,7 +411,9 @@ def validate_beams(day, tle, entry, orbit, reference, write: bool, run: Run) -> print( f"published dimensions: {within:.1f}% within 3%, largest error {largest:.2f}%" ) - satellite = entry.to_satellite(orbit, run.beams, platform=run.platform) + satellite = entry.to_satellite( + orbit, configuration=run.beams, platform=run.platform + ) names = [instrument.name for instrument in satellite.instruments] index = names.index(SIZE_INSTRUMENT) pixels = measure_pixels(reference, satellite, index) @@ -434,10 +428,11 @@ def validate_beams(day, tle, entry, orbit, reference, write: bool, run: Run) -> if not write: return if run.transfer: - add_transfer_metrics( + write_transfer( RECORD_PATH, run.beams, - f"{run.platform}, {day:%Y-%m-%d}", + run.platform, + f"{day:%Y-%m-%d}", { "pixel_position_median": median, "pixel_position_p95": p95, @@ -460,34 +455,28 @@ def validate_beams(day, tle, entry, orbit, reference, write: bool, run: Run) -> spacing=rows[picks], spacing_seconds=(times[picks] - pd.Timestamp(day)).total_seconds().to_numpy(), ) - update_record( + write_record( RECORD_PATH, - "atms", + entry, run.beams, - { - "digest": entry.configurations[run.beams].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Footprints of the TC PRIMED documentation; beam centers of " - "the ATMS SDR geolocation", - "period": f"{day:%Y-%m-%d}", - "platform": run.platform, - "holdout_gap_days": get_holdout_gap(day, run.fit_day), - "metrics": [ - {"name": "sample_size_within_3pct", "value": within}, - {"name": "sample_size_largest_error", "value": largest}, - {"name": "pixel_position_median", "value": median}, - {"name": "pixel_position_p95", "value": p95}, - {"name": "spacing_along_ratio_median", "value": along}, - {"name": "spacing_cross_ratio_median", "value": cross}, - ], - "fixture_metrics": { - "sample_size_within_3pct": within, - "pixel_position_median": summarize(reduced[:, 2])["median"], - "spacing_along_ratio_median": fixture_along, - "spacing_cross_ratio_median": fixture_cross, - }, + source=source_of(__file__), + reference="Footprints of the TC PRIMED documentation; beam centers of " + "the ATMS SDR geolocation", + period=f"{day:%Y-%m-%d}", + platforms=[run.platform], + metrics=[ + {"name": "sample_size_within_3pct", "value": within}, + {"name": "sample_size_largest_error", "value": largest}, + {"name": "pixel_position_median", "value": median}, + {"name": "pixel_position_p95", "value": p95}, + {"name": "spacing_along_ratio_median", "value": along}, + {"name": "spacing_cross_ratio_median", "value": cross}, + ], + fixture_metrics={ + "sample_size_within_3pct": within, + "pixel_position_median": summarize(reduced[:, 2])["median"], + "spacing_along_ratio_median": fixture_along, + "spacing_cross_ratio_median": fixture_cross, }, ) @@ -497,7 +486,7 @@ def validate_swath(day, tle, entry, orbit, reference, write: bool, run: Run) -> def satellite_for(time_step: float): return entry.to_satellite( - orbit, run.swath, time_step=time_step, platform=run.platform + orbit, configuration=run.swath, time_step=time_step, platform=run.platform ) satellite = satellite_for(SCAN_PERIOD) @@ -519,10 +508,11 @@ def satellite_for(time_step: float): if not write: return if run.transfer: - add_transfer_metrics( + write_transfer( RECORD_PATH, run.swath, - f"{run.platform}, {day:%Y-%m-%d}", + run.platform, + f"{day:%Y-%m-%d}", {name: results[name] for name in GATED}, ) return @@ -542,31 +532,25 @@ def satellite_for(time_step: float): day=np.array(day.isoformat()), passes=passes, ) - update_record( + write_record( RECORD_PATH, - "atms", + entry, run.swath, - { - "digest": entry.configurations[run.swath].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "ATMS SDR geolocation", - "period": f"{day:%Y-%m-%d}", - "platform": run.platform, - "holdout_gap_days": get_holdout_gap(day, run.fit_day), - "metrics": [ - {"name": name, "value": float(results[name])} - for name in ( - "pass_recall", - "pass_precision", - "epoch_p95", - "swath_width_median", - "footprint_iou_median", - ) - ], - "fixture_metrics": recompute_passes(satellite, 0, day, passes), - }, + source=source_of(__file__), + reference="ATMS SDR geolocation", + period=f"{day:%Y-%m-%d}", + platforms=[run.platform], + metrics=[ + {"name": name, "value": float(results[name])} + for name in ( + "pass_recall", + "pass_precision", + "epoch_p95", + "swath_width_median", + "footprint_iou_median", + ) + ], + fixture_metrics=recompute_passes(satellite, 0, day, passes), ) @@ -584,14 +568,14 @@ def main() -> None: arguments.directory.mkdir(parents=True, exist_ok=True) day = datetime.fromisoformat(arguments.day).replace(tzinfo=timezone.utc) - prefix = use_archive(arguments.platform) + archive = ARCHIVES[arguments.platform] directory = ( arguments.directory if arguments.platform == FIT_PLATFORM - else arguments.directory / prefix + else arguments.directory / archive.prefix ) directory.mkdir(parents=True, exist_ok=True) - reference = Reference(load_day(day, directory)) + reference = Reference(load_day(day, directory, archive)) if arguments.fit: fit(day, reference) return @@ -599,10 +583,9 @@ def main() -> None: run = Run( arguments.platform, *CONFIGURATIONS[fitted], - FIT_DAYS[fitted], fitted != arguments.platform, ) - tle = load_element_set(day, directory) + tle = archive.load_element_set(day, directory) orbit = GeneralPerturbationsOrbit.from_tle(tle) entry = get_entry("atms") print( diff --git a/validation/catalog/validate_catalog_avhrr.py b/validation/catalog/validate_catalog_avhrr.py index 48e3d536..64be9905 100644 --- a/validation/catalog/validate_catalog_avhrr.py +++ b/validation/catalog/validate_catalog_avhrr.py @@ -63,7 +63,6 @@ ) NORAD_ID = 43689 -FIT_DAY = datetime(2026, 11, 5, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data ELEMENTS = { "2026-11-05": ( @@ -160,7 +159,6 @@ def read_avhrr(_product, url: str, session, day: datetime, _directory) -> dict: reference="AVHRRF_MC-STAR-L2P version 2.80 (sample positions and times)", published_reference="Footprint published by the NWP SAF; sample positions of " "AVHRRF_MC-STAR-L2P version 2.80", - fit_day=FIT_DAY, time_steps=(10, 30, 120), pass_radius=40, point_spacing=200e3, diff --git a/validation/catalog/validate_catalog_bbr.py b/validation/catalog/validate_catalog_bbr.py index df9a1816..e036ac0a 100644 --- a/validation/catalog/validate_catalog_bbr.py +++ b/validation/catalog/validate_catalog_bbr.py @@ -35,7 +35,6 @@ import numpy as np import pandas as pd -import tatc from tatc.catalog import get_entry from tatc.generation import generate_points_fibonacci_lattice from tatc.schemas import GeneralPerturbationsOrbit @@ -50,13 +49,12 @@ ) from validation_io import ( build_grid, - get_holdout_gap, read_element_set_file, recompute_passes, score_passes, score_swath_area, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -66,7 +64,6 @@ RECORD_PATH = RECORDS / "bbr.json" FIXTURE_PATH = FIXTURES / "bbr.npz" NORAD_ID = 59908 -FIT_DAY = datetime(2026, 9, 27, tzinfo=timezone.utc) ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "earthcare_2026-09-27.3le" PLATFORM = "earthcare" CONFIGURATION = "views" @@ -132,7 +129,7 @@ def validate(day, tle, entry, orbit, references, write: bool) -> None: def satellite_for(time_step: float): return entry.to_satellite( - orbit, CONFIGURATION, time_step=time_step, platform=PLATFORM + orbit, configuration=CONFIGURATION, time_step=time_step, platform=PLATFORM ) satellite = satellite_for(TIME_STEPS[0]) @@ -195,23 +192,17 @@ def satellite_for(time_step: float): FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) nadir = list(VIEWS).index("NADIR") - update_record( + write_record( RECORD_PATH, - "bbr", + entry, CONFIGURATION, - { - "digest": entry.configurations[CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": f"{PRODUCT} (pixel positions of the shortwave band, every " - "second line)", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": metrics, - "fixture_metrics": recompute_passes(satellite, nadir, day, passes), - }, + source=source_of(__file__), + reference=f"{PRODUCT} (pixel positions of the shortwave band, every " + "second line)", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=metrics, + fixture_metrics=recompute_passes(satellite, nadir, day, passes), ) print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") diff --git a/validation/catalog/validate_catalog_ceres.py b/validation/catalog/validate_catalog_ceres.py index 6bb1c431..6cbf9b5d 100644 --- a/validation/catalog/validate_catalog_ceres.py +++ b/validation/catalog/validate_catalog_ceres.py @@ -39,17 +39,15 @@ from tatc.schemas import GeneralPerturbationsOrbit from gesdisc_scanner import Reference, Setup, fit, fit_yaw, validate_swath from validation_io import ( + ARCHIVES, TO_GEODETIC, get_with_retries, - load_element_set, - use_archive, RECORDS, FIXTURES, source_of, login_earthdata, ) -FIT_DAY = datetime(2026, 8, 25, tzinfo=timezone.utc) SHORT_NAME, VERSION = "CER_ES8_NOAA20-FM6", "Edition1" RECORD_SAMPLES, SAMPLE_PERIOD, RECORD_PERIOD = 660, 0.01, 6.6 # the samples of the first Earth sweep of each record; the second sweeps in the @@ -197,7 +195,6 @@ def table(name: str) -> np.ndarray: reference="CER_ES8_NOAA20-FM6 Edition1 (footprint positions, projected to the " "ellipsoid, and times)", published_reference="", - fit_day=FIT_DAY, time_steps=(RECORD_PERIOD, 30, 120), pass_radius=60, point_spacing=200e3, @@ -230,8 +227,7 @@ def main() -> None: offsets = reference.beam_seconds - reference.seconds[:, np.newaxis] print(f"footprint times from the sweep's middle: {offsets[0, [0, -1]]}") return - use_archive("noaa-20") - tle = load_element_set(day, arguments.directory) + tle = ARCHIVES["noaa-20"].load_element_set(day, arguments.directory) print(f"element set: {tle[0][:32]}", flush=True) orbit = GeneralPerturbationsOrbit.from_tle(tle) validate_swath( diff --git a/validation/catalog/validate_catalog_cpr.py b/validation/catalog/validate_catalog_cpr.py index 878f61c9..2e2a7c5f 100644 --- a/validation/catalog/validate_catalog_cpr.py +++ b/validation/catalog/validate_catalog_cpr.py @@ -48,7 +48,6 @@ RECORD_PATH = RECORDS / "cpr.json" FIXTURE_PATH = FIXTURES / "cpr.npz" NORAD_ID = 59908 -FIT_DAY = datetime(2026, 9, 27, tzinfo=timezone.utc) ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "earthcare_2026-09-27.3le" PLATFORM = "earthcare" CONFIGURATION = "nadir" @@ -99,7 +98,6 @@ def main() -> None: orbit, tle, day, - FIT_DAY, RECORD_PATH, FIXTURE_PATH, source_of(__file__), diff --git a/validation/catalog/validate_catalog_cris.py b/validation/catalog/validate_catalog_cris.py index d0ac6fdf..e7348f9f 100644 --- a/validation/catalog/validate_catalog_cris.py +++ b/validation/catalog/validate_catalog_cris.py @@ -44,24 +44,20 @@ from scipy.spatial import cKDTree from skyfield.api import wgs84 -import tatc import validation_io from tatc.catalog import get_entry from tatc.catalog.metrics import summarize from tatc.generation import generate_points_fibonacci_lattice from tatc.schemas import GeneralPerturbationsOrbit from validation_io import ( - add_transfer_metrics, - use_archive, + ARCHIVES, + Archive, + write_transfer, build_grid, compute_published_errors, ecef, - fetch, - get_holdout_gap, iet_to_utc, in_lattice_cells, - list_keys, - load_element_set, normalize, recompute_passes, score_passes, @@ -69,7 +65,7 @@ score_swath_area, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -86,7 +82,6 @@ RECORD_PATH = RECORDS / "cris.json" FIXTURE_PATH = FIXTURES / "cris.npz" -FIT_DAY = datetime(2026, 10, 2, tzinfo=timezone.utc) FIELDS = ( "StartTime", "MidTime", @@ -126,16 +121,18 @@ FOV_DIAMETER = 0.963 -def load_day(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: +def load_day( + day: datetime, directory: pathlib.Path, archive: Archive +) -> dict[str, np.ndarray]: """Downloads and reduces the geolocation of a day, or loads it from a cache.""" path = directory / f"cris_gcrso_{day:%Y%m%d}.npz" if not path.exists(): def read(key): - with h5py.File(io.BytesIO(fetch(key))) as f: + with h5py.File(io.BytesIO(archive.fetch(key))) as f: return {k: f["All_Data/CrIS-SDR-GEO_All/" + k][:] for k in FIELDS} - keys = list_keys(f"CrIS-SDR-GEO/{day:%Y/%m/%d}/") + keys = archive.list_keys(f"CrIS-SDR-GEO/{day:%Y/%m/%d}/") with concurrent.futures.ThreadPoolExecutor(16) as pool: granules = list(pool.map(read, keys)) np.savez_compressed( @@ -362,7 +359,7 @@ def validate_pixels( print( f"published dimensions: {within:.1f}% within 3%, largest error {largest:.2f}%" ) - satellite = entry.to_satellite(orbit, PIXELS, platform=platform) + satellite = entry.to_satellite(orbit, configuration=PIXELS, platform=platform) pixels = measure_pixels(reference, satellite) median = summarize(pixels[:, 3])["median"] p95 = summarize(pixels[:, 3])["p95"] @@ -375,10 +372,11 @@ def validate_pixels( if not write: return if platform != FIT_PLATFORM: - add_transfer_metrics( + write_transfer( RECORD_PATH, PIXELS, - f"{platform}, {day:%Y-%m-%d}", + platform, + f"{day:%Y-%m-%d}", { "pixel_position_median": median, "pixel_position_p95": p95, @@ -390,34 +388,28 @@ def validate_pixels( update_fixture( FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), pixels=reduced ) - update_record( + write_record( RECORD_PATH, - "cris", + entry, PIXELS, - { - "digest": entry.configurations[PIXELS].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Footprints published by the NWP SAF; fields of view of the " - "CrIS SDR geolocation", - "period": f"{day:%Y-%m-%d}", - "platform": "noaa-20", - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": "sample_size_within_3pct", "value": within}, - {"name": "sample_size_largest_error", "value": largest}, - {"name": "pixel_position_median", "value": median}, - {"name": "pixel_position_p95", "value": p95}, - { - "name": "pixel_position_central_median", - "value": float(np.median(central[:, 3])), - }, - ], - "fixture_metrics": { - "sample_size_within_3pct": within, - "pixel_position_median": summarize(reduced[:, 3])["median"], + source=source_of(__file__), + reference="Footprints published by the NWP SAF; fields of view of the " + "CrIS SDR geolocation", + period=f"{day:%Y-%m-%d}", + platforms=["noaa-20"], + metrics=[ + {"name": "sample_size_within_3pct", "value": within}, + {"name": "sample_size_largest_error", "value": largest}, + {"name": "pixel_position_median", "value": median}, + {"name": "pixel_position_p95", "value": p95}, + { + "name": "pixel_position_central_median", + "value": float(np.median(central[:, 3])), }, + ], + fixture_metrics={ + "sample_size_within_3pct": within, + "pixel_position_median": summarize(reduced[:, 3])["median"], }, ) @@ -428,7 +420,9 @@ def validate_swath( """Scores the swath configuration, and writes its results if requested.""" def satellite_for(time_step: float): - return entry.to_satellite(orbit, SWATH, time_step=time_step, platform=platform) + return entry.to_satellite( + orbit, configuration=SWATH, time_step=time_step, platform=platform + ) satellite = satellite_for(SCAN_PERIOD) points = generate_points_fibonacci_lattice(500e3) @@ -449,10 +443,11 @@ def satellite_for(time_step: float): if not write: return if platform != FIT_PLATFORM: - add_transfer_metrics( + write_transfer( RECORD_PATH, SWATH, - f"{platform}, {day:%Y-%m-%d}", + platform, + f"{day:%Y-%m-%d}", {name: results[name] for name in GATED}, ) return @@ -469,35 +464,31 @@ def satellite_for(time_step: float): update_fixture( FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) - update_record( + write_record( RECORD_PATH, - "cris", + entry, SWATH, - { - "digest": entry.configurations[SWATH].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "CrIS SDR geolocation", - "period": f"{day:%Y-%m-%d}", - "platform": "noaa-20", - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": name, "value": float(results[name])} - for name in ( - "pass_recall", - "pass_precision", - "epoch_p95", - "swath_width_median", - "footprint_iou_median", - ) - ], - "fixture_metrics": recompute_passes(satellite, 0, day, passes), - }, + source=source_of(__file__), + reference="CrIS SDR geolocation", + period=f"{day:%Y-%m-%d}", + platforms=["noaa-20"], + metrics=[ + {"name": name, "value": float(results[name])} + for name in ( + "pass_recall", + "pass_precision", + "epoch_p95", + "swath_width_median", + "footprint_iou_median", + ) + ], + fixture_metrics=recompute_passes(satellite, 0, day, passes), ) -def load_fit_hours(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: +def load_fit_hours( + day: datetime, directory: pathlib.Path, archive: Archive +) -> dict[str, np.ndarray]: """ Downloads the geolocation, with the spacecraft's position and velocity, of the hours of a day that the fit measures, or loads it from a cache. @@ -507,12 +498,12 @@ def load_fit_hours(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarr if not path.exists(): def read(key): - with h5py.File(io.BytesIO(fetch(key))) as f: + with h5py.File(io.BytesIO(archive.fetch(key))) as f: return {k: f["All_Data/CrIS-SDR-GEO_All/" + k][:] for k in FIT_FIELDS} keys = [ k - for k in list_keys(f"CrIS-SDR-GEO/{day:%Y/%m/%d}/") + for k in archive.list_keys(f"CrIS-SDR-GEO/{day:%Y/%m/%d}/") if first <= int(k.split("_t")[1][:2]) < last ] with concurrent.futures.ThreadPoolExecutor(16) as pool: @@ -624,20 +615,19 @@ def main() -> None: day = datetime.fromisoformat(arguments.day).replace(tzinfo=timezone.utc) if arguments.fit: - use_archive(arguments.platform) - fit(load_fit_hours(day, arguments.directory)) + fit(load_fit_hours(day, arguments.directory, ARCHIVES[arguments.platform])) return - prefix = use_archive(arguments.platform) + archive = ARCHIVES[arguments.platform] directory = ( arguments.directory if arguments.platform == FIT_PLATFORM - else arguments.directory / prefix + else arguments.directory / archive.prefix ) directory.mkdir(parents=True, exist_ok=True) - tle = load_element_set(day, directory) + tle = archive.load_element_set(day, directory) orbit = GeneralPerturbationsOrbit.from_tle(tle) entry = get_entry("cris") - reference = Reference(load_day(day, directory)) + reference = Reference(load_day(day, directory, archive)) print( f"{arguments.day}: {tle[0][:32]}; {len(reference.time)} scans, " f"{len(reference.gaps)} gaps over a minute", diff --git a/validation/catalog/validate_catalog_csar.py b/validation/catalog/validate_catalog_csar.py index 5a7bcaac..5b903396 100644 --- a/validation/catalog/validate_catalog_csar.py +++ b/validation/catalog/validate_catalog_csar.py @@ -45,7 +45,6 @@ from shapely.geometry import Polygon from shapely.ops import unary_union -import tatc from tatc.analysis import collect_observations, compute_ground_track from tatc.catalog import get_entry from tatc.catalog.metrics import summarize @@ -53,10 +52,9 @@ from tatc.schemas import GeneralPerturbationsOrbit, Point, PointedInstrument from tatc.utils import compute_argument_of_latitude, compute_projected_ray_position from validation_io import ( - add_transfer_metrics, + write_transfer, TO_GEODETIC, ecef, - get_holdout_gap, get_with_retries, in_lattice_cells, match_passes, @@ -67,7 +65,7 @@ recompute_passes, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -81,7 +79,6 @@ STAC_URL = "https://planetarycomputer.microsoft.com/api/stac/v1/search" TOKEN_URL = "https://planetarycomputer.microsoft.com/api/sas/v1/token/sentinel-1-grd" -FIT_DAY = datetime(2026, 10, 2, tzinfo=timezone.utc) PLATFORM = FIT_PLATFORM = "sentinel-1c" # sibling platforms, on which results are reported as a transfer, with public element # sets from CelesTrak, with epochs after each day of data @@ -637,7 +634,9 @@ def validate_mode(key, day, tle, entry, orbit, products, write) -> None: print(f"--- {key}: {len(chosen)} products", flush=True) def satellite_for(time_step: float): - return entry.to_satellite(orbit, key, time_step=time_step, platform=PLATFORM) + return entry.to_satellite( + orbit, configuration=key, time_step=time_step, platform=PLATFORM + ) satellite = satellite_for(TIME_STEPS[0]) instrument = satellite.instruments[0] @@ -690,10 +689,11 @@ def satellite_for(time_step: float): if not write: return if PLATFORM != FIT_PLATFORM: - add_transfer_metrics( + write_transfer( RECORD_PATH, key, - f"{PLATFORM}, {day:%Y-%m-%d}", + PLATFORM, + f"{day:%Y-%m-%d}", { metric["name"] + ( @@ -720,23 +720,17 @@ def satellite_for(time_step: float): f"passes_{key}": fixture, }, ) - update_record( + write_record( RECORD_PATH, - "csar", + entry, key, - { - "digest": entry.configurations[key].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Geolocation grids and restituted orbits of the annotations " - + "of Sentinel-1 Level-1 GRD products", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": metrics, - "fixture_metrics": recompute_passes(satellite, 0, day, fixture), - }, + source=source_of(__file__), + reference="Geolocation grids and restituted orbits of the annotations " + + "of Sentinel-1 Level-1 GRD products", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=metrics, + fixture_metrics=recompute_passes(satellite, 0, day, fixture), ) print(f"wrote {key} to {RECORD_PATH}") diff --git a/validation/catalog/validate_catalog_dpr.py b/validation/catalog/validate_catalog_dpr.py index b2fff8d4..6a2afac8 100644 --- a/validation/catalog/validate_catalog_dpr.py +++ b/validation/catalog/validate_catalog_dpr.py @@ -49,7 +49,6 @@ ) NORAD_ID = 39574 -FIT_DAY = datetime(2026, 10, 3, tzinfo=timezone.utc) # the element set of `ValidateConicalGMI` for the day of the fit, and a public element # set from CelesTrak, with an epoch after the day of data, for a later held-out day ELEMENTS = { @@ -95,7 +94,6 @@ reference="GPM_2ADPR version 08 (beam positions of the full swath)", published_reference="Footprints of the TC PRIMED documentation; beam positions " "of GPM_2ADPR version 08", - fit_day=FIT_DAY, time_steps=(10, 30, 120), pass_radius=10, point_spacing=100e3, diff --git a/validation/catalog/validate_catalog_earthcare_msi.py b/validation/catalog/validate_catalog_earthcare_msi.py index ce51105a..21865114 100644 --- a/validation/catalog/validate_catalog_earthcare_msi.py +++ b/validation/catalog/validate_catalog_earthcare_msi.py @@ -47,7 +47,6 @@ from validate_catalog_atlid import read_atlid NORAD_ID = 59908 -FIT_DAY = datetime(2026, 9, 27, tzinfo=timezone.utc) ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "earthcare_2026-09-27.3le" PRODUCT = "MSI_RGR_1C" # the product's grid has 384 columns, of which 12 to 368 hold the imaged pixels and @@ -77,7 +76,6 @@ reference=f"{PRODUCT} (pixel positions of every fourth orbit, every eighth line), " "with spacecraft positions of ATL_NOM_1B", published_reference="", - fit_day=FIT_DAY, time_steps=(10, 30, 120), pass_radius=20, point_spacing=100e3, diff --git a/validation/catalog/validate_catalog_ecostress.py b/validation/catalog/validate_catalog_ecostress.py index 76d84f86..23810499 100644 --- a/validation/catalog/validate_catalog_ecostress.py +++ b/validation/catalog/validate_catalog_ecostress.py @@ -60,7 +60,6 @@ login_earthdata, ) -FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data ELEMENTS = { "2026-11-07": ( @@ -173,7 +172,6 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict: reference="ECO_L1B_GEO version 002 (sample positions and times of every fourth " "sweep, in blocks of eight consecutive scenes of every 32)", published_reference="", - fit_day=FIT_DAY, time_steps=(10, 30, 120), pass_radius=20, point_spacing=100e3, diff --git a/validation/catalog/validate_catalog_emit.py b/validation/catalog/validate_catalog_emit.py index 3dba53f3..12097328 100644 --- a/validation/catalog/validate_catalog_emit.py +++ b/validation/catalog/validate_catalog_emit.py @@ -40,7 +40,6 @@ import h5py import numpy as np -import tatc from tatc.analysis import compute_ground_track from tatc.catalog import get_entry from tatc.catalog.metrics import summarize @@ -51,10 +50,9 @@ from validation_io import ( TO_GEODETIC, RemoteFile, - get_holdout_gap, recompute_passes, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -63,7 +61,6 @@ RECORD_PATH = RECORDS / "emit.json" FIXTURE_PATH = FIXTURES / "emit.npz" -FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) PLATFORM = "iss" CONFIGURATION = "swath" # public element sets from CelesTrak, with epochs after each day of data @@ -275,34 +272,26 @@ def satellite_for(time_step): update_fixture( FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) - update_record( + write_record( RECORD_PATH, - "emit", + entry, CONFIGURATION, - { - "digest": entry.configurations[CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "EMITL1BRAD version 002, observation geometry (pixel " - "positions and line times of every 16th line)", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": name, "value": float(results[name])} - for name in ( - "pass_recall", - "epoch_p95", - "epoch_median", - "swath_width_median", - "footprint_iou_median", - ) - ], - "fixture_metrics": recompute_passes( - satellite_for(TIME_STEPS[0]), 0, day, passes - ), - }, + source=source_of(__file__), + reference="EMITL1BRAD version 002, observation geometry (pixel " + "positions and line times of every 16th line)", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=[ + {"name": name, "value": float(results[name])} + for name in ( + "pass_recall", + "epoch_p95", + "epoch_median", + "swath_width_median", + "footprint_iou_median", + ) + ], + fixture_metrics=recompute_passes(satellite_for(TIME_STEPS[0]), 0, day, passes), ) print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") diff --git a/validation/catalog/validate_catalog_gedi.py b/validation/catalog/validate_catalog_gedi.py index 6f4d047b..5bc6e3ca 100644 --- a/validation/catalog/validate_catalog_gedi.py +++ b/validation/catalog/validate_catalog_gedi.py @@ -44,7 +44,6 @@ from pyproj import Geod from skyfield.api import wgs84 -import tatc from tatc.analysis import collect_observations from tatc.catalog import get_entry from tatc.catalog.metrics import summarize @@ -54,12 +53,11 @@ from validation_io import ( RemoteFile, ecef, - get_holdout_gap, get_with_retries, read_element_set_file, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -71,7 +69,6 @@ FIXTURE_PATH = FIXTURES / "gedi.npz" ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "iss_2026-04-01.3le" NORAD_ID = 25544 -FIT_DAY = datetime(2026, 5, 1, tzinfo=timezone.utc) PLATFORM = "iss" CONFIGURATION = "beams" SHORT_NAME, VERSION = "GEDI01_B", "003" @@ -310,7 +307,7 @@ def score_shots(entry, orbit, shots: pd.DataFrame, day: datetime): results = {} for time_step in TIME_STEPS: satellite = entry.to_satellite( - orbit, CONFIGURATION, time_step=time_step, platform=PLATFORM + orbit, configuration=CONFIGURATION, time_step=time_step, platform=PLATFORM ) differences = find_epochs(satellite, sample) found = np.isfinite(differences) @@ -391,7 +388,7 @@ def main() -> None: if not arguments.write: return satellite = entry.to_satellite( - orbit, CONFIGURATION, time_step=TIME_STEPS[0], platform=PLATFORM + orbit, configuration=CONFIGURATION, time_step=TIME_STEPS[0], platform=PLATFORM ) rng = np.random.default_rng(2) reduced = passes[rng.choice(len(passes), FIXTURE_SHOTS, replace=False)] @@ -410,34 +407,28 @@ def main() -> None: FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=reduced ) found = np.isfinite(fixture_differences) - update_record( + write_record( RECORD_PATH, - "gedi", + entry, CONFIGURATION, - { - "digest": entry.configurations[CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": f"{SHORT_NAME} version {VERSION} (every 200th shot, where " - "the beams' center lies within 1 deg of nadir)", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - { - "name": name, - "value": values[name], - "scope": f"time step {time_step} s", - } - for time_step, values in results.items() - for name in ("segment_recall", "epoch_p95", "epoch_median") - ] - + [{"name": "beam_spacing_error_median", "value": spacing}], - "fixture_metrics": { - "passes_found": 100 * float(found.mean()), - "epoch_p95": float(summarize(fixture_differences[found])["p95"]), - }, + source=source_of(__file__), + reference=f"{SHORT_NAME} version {VERSION} (every 200th shot, where " + "the beams' center lies within 1 deg of nadir)", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=[ + { + "name": name, + "value": values[name], + "scope": f"time step {time_step} s", + } + for time_step, values in results.items() + for name in ("segment_recall", "epoch_p95", "epoch_median") + ] + + [{"name": "beam_spacing_error_median", "value": spacing}], + fixture_metrics={ + "passes_found": 100 * float(found.mean()), + "epoch_p95": float(summarize(fixture_differences[found])["p95"]), }, ) print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") diff --git a/validation/catalog/validate_catalog_gmi.py b/validation/catalog/validate_catalog_gmi.py index 39315bcc..f8e2da5b 100644 --- a/validation/catalog/validate_catalog_gmi.py +++ b/validation/catalog/validate_catalog_gmi.py @@ -47,27 +47,25 @@ import numpy as np import pandas as pd import requests -from pyproj import Geod, Transformer +from pyproj import Geod from scipy.spatial import cKDTree from shapely import contains_xy, prepare -import tatc from tatc.analysis import ( collect_observations, compute_ground_track, compute_sample_sizes, ) -from tatc.catalog import STANDARD_VERSION, get_entry +from tatc.catalog import get_entry from tatc.catalog.metrics import compute_mask_iou, compute_pass_scores, summarize -from tatc.constants import EARTH_ROTATION_RATE from tatc.generation import generate_points_fibonacci_lattice from tatc.schemas import CircularOrbit, GeneralPerturbationsOrbit, Point import validation_io +from validation_io import TO_GEODETIC, ecef, normalize, up RECORD_PATH = validation_io.RECORDS / "gmi.json" FIXTURE_PATH = validation_io.FIXTURES / "gmi.npz" -FIT_DAY = datetime(2026, 10, 3, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs just after each day of data ELEMENTS = { "2026-10-03": ( @@ -110,8 +108,6 @@ FIXTURE_SPACING_SAMPLES = 100 GEOD = Geod(ellps="WGS84") -TO_ECEF = Transformer.from_crs("EPSG:4979", "EPSG:4978", always_xy=True) -TO_GEODETIC = Transformer.from_crs("EPSG:4978", "EPSG:4979", always_xy=True) def load_day(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: @@ -174,33 +170,6 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict[str, np.ndarray]: return dict(np.load(cache)) -def ecef(lon, lat, height=0.0) -> np.ndarray: - """Gets the Earth-fixed position (m) of geodetic coordinates.""" - return np.stack( - TO_ECEF.transform(lon, lat, np.broadcast_to(height, np.shape(lon))), axis=-1 - ) - - -def up(lon, lat) -> np.ndarray: - """Gets the geodetic up unit vector.""" - lon, lat = np.radians(lon), np.radians(lat) - return np.stack( - [np.cos(lat) * np.cos(lon), np.cos(lat) * np.sin(lon), np.sin(lat)], axis=-1 - ) - - -def normalize(x: np.ndarray) -> np.ndarray: - """Gets unit vectors along the last axis.""" - return x / np.linalg.norm(x, axis=-1, keepdims=True) - - -def inertial_velocity(position: np.ndarray, velocity: np.ndarray) -> np.ndarray: - """Gets the inertial velocity, expressed in Earth-fixed coordinates.""" - return velocity + EARTH_ROTATION_RATE * np.stack( - [-position[..., 1], position[..., 0], np.zeros(position.shape[:-1])], axis=-1 - ) - - class Reference: """A day of GMI scans, with what is derived from them for each feed.""" @@ -456,7 +425,10 @@ def score_published_footprints(entry) -> tuple[float, float]: epoch=PUBLISHED_EPOCH, ) satellite = entry.to_satellite( - orbit, SAMPLE_CONFIGURATION, time_step=SCAN_PERIOD, platform="gpm" + orbit, + configuration=SAMPLE_CONFIGURATION, + time_step=SCAN_PERIOD, + platform="gpm", ) names = [instrument.name for instrument in satellite.instruments] time = PUBLISHED_EPOCH + timedelta(minutes=10) @@ -547,21 +519,6 @@ def update_fixture(**arrays) -> None: validation_io.update_fixture(FIXTURE_PATH, **arrays) -def update_record(key: str, configuration: dict) -> None: - """Writes the results of a configuration to the record, keeping the others.""" - record = {"entry_id": "gmi", "configurations": {}} - if RECORD_PATH.exists(): - record = json.loads(RECORD_PATH.read_text(encoding="utf-8")) - record["standard_version"] = STANDARD_VERSION - record["configurations"][key] = configuration - RECORD_PATH.write_text(json.dumps(record, indent=2) + "\n", encoding="utf-8") - - -def get_holdout_gap(day: datetime) -> int | None: - """Gets the days from the fit to a day, to which the standard applies its gap.""" - return None if day == FIT_DAY else abs((day - FIT_DAY).days) - - def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> None: """Scores the sample size configuration, and writes its results if requested.""" within, largest = score_published_footprints(entry) @@ -573,7 +530,7 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non {"name": "sample_size_largest_error", "value": largest}, ] satellite = entry.to_satellite( - orbit, SAMPLE_CONFIGURATION, time_step=SCAN_PERIOD, platform="gpm" + orbit, configuration=SAMPLE_CONFIGURATION, time_step=SCAN_PERIOD, platform="gpm" ) names = [instrument.name for instrument in satellite.instruments] rng = np.random.default_rng(2) @@ -608,25 +565,19 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non spacing=np.concatenate(reduced), spacing_instruments=np.concatenate(indices), ) - update_record( + validation_io.write_record( + RECORD_PATH, + entry, SAMPLE_CONFIGURATION, - { - "digest": entry.configurations[SAMPLE_CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": validation_io.source_of(__file__), - "reference": "Footprints of the GMI L1B ATBD and TC PRIMED; spacing of " - "GPM_1CGPMGMI version 08", - "period": f"{day:%Y-%m-%d}", - "platform": "gpm", - # the fitted angles were not fitted to the published footprints, and the - # spacing is measured on this day - "holdout_gap_days": get_holdout_gap(day), - "metrics": metrics, - "fixture_metrics": { - "sample_size_within_3pct": within, - **fixture_metrics, - }, + source=validation_io.source_of(__file__), + reference="Footprints of the GMI L1B ATBD and TC PRIMED; spacing of " + "GPM_1CGPMGMI version 08", + period=f"{day:%Y-%m-%d}", + platforms=["gpm"], + metrics=metrics, + fixture_metrics={ + "sample_size_within_3pct": within, + **fixture_metrics, }, ) @@ -676,22 +627,18 @@ def write_fixture_and_record(day, tle, entry, orbit, results, fixtures) -> None: metrics.append( {"name": name, "value": float(results[feed][name]), "scope": feed} ) - update_record( + validation_io.write_record( + RECORD_PATH, + entry, "feeds", - { - "digest": entry.configurations["feeds"].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": validation_io.source_of(__file__), - "reference": "GPM_1CGPMGMI version 08", - "period": f"{day:%Y-%m-%d}", - "platform": "gpm", - "holdout_gap_days": get_holdout_gap(day), - "metrics": metrics, - "fixture_metrics": { - "passes_found": 100 * float(np.isfinite(differences).mean()), - "epoch_p95": summarize(differences)["p95"], - }, + source=validation_io.source_of(__file__), + reference="GPM_1CGPMGMI version 08", + period=f"{day:%Y-%m-%d}", + platforms=["gpm"], + metrics=metrics, + fixture_metrics={ + "passes_found": 100 * float(np.isfinite(differences).mean()), + "epoch_p95": summarize(differences)["p95"], }, ) diff --git a/validation/catalog/validate_catalog_harp2.py b/validation/catalog/validate_catalog_harp2.py index 85480b37..441c2ae8 100644 --- a/validation/catalog/validate_catalog_harp2.py +++ b/validation/catalog/validate_catalog_harp2.py @@ -51,7 +51,6 @@ source_of, ) -FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data PACE_ELEMENTS = ( "1 58928U 24025A 26313.27483190 .00000501 00000+0 10091-3 0 9993", @@ -113,7 +112,6 @@ def read_harp2(_product, url: str, session, day: datetime, _directory) -> dict: reference="PACE_HARP2_L1B_SCI version 4 (positions and times of the near-nadir " "view)", published_reference="", - fit_day=FIT_DAY, time_steps=(10, 30, 120), pass_radius=20, point_spacing=200e3, diff --git a/validation/catalog/validate_catalog_iasi.py b/validation/catalog/validate_catalog_iasi.py index b2af639b..59e1ae5d 100644 --- a/validation/catalog/validate_catalog_iasi.py +++ b/validation/catalog/validate_catalog_iasi.py @@ -52,7 +52,6 @@ from scipy.spatial import cKDTree from skyfield.framelib import itrs -import tatc from tatc.catalog import get_entry from tatc.catalog.metrics import summarize from tatc.generation import generate_points_fibonacci_lattice @@ -63,7 +62,6 @@ compute_published_errors, compute_spacing_ratios, ecef, - get_holdout_gap, in_lattice_cells, normalize, predict_passes, @@ -73,7 +71,7 @@ score_swath_area, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -84,7 +82,6 @@ FIXTURE_PATH = FIXTURES / "iasi.npz" PRODUCT = "IASI_SST_METOP_B-OSISAF-L2P-v1.0" -FIT_DAY = datetime(2026, 10, 3, tzinfo=timezone.utc) PLATFORM = "metop-b" ELEMENT_SET = [ "1 38771U 12049A 26311.29297005 .00000108 00000+0 68954-4 0 9993", @@ -510,7 +507,7 @@ def validate_pixels(day, tle, entry, orbit, reference, write) -> None: f"published dimensions: {within:.1f}% within 3%, largest error {largest:.2f}%", flush=True, ) - satellite = entry.to_satellite(orbit, PIXELS, platform=PLATFORM) + satellite = entry.to_satellite(orbit, configuration=PIXELS, platform=PLATFORM) pixels = measure_pixels(reference, satellite, day) median = summarize(pixels[:, 2])["median"] p95 = summarize(pixels[:, 2])["p95"] @@ -540,34 +537,28 @@ def validate_pixels(day, tle, entry, orbit, reference, write) -> None: spacing=rows[picks], spacing_seconds=(times[picks] - pd.Timestamp(day)).total_seconds().to_numpy(), ) - update_record( + write_record( RECORD_PATH, - "iasi", + entry, PIXELS, - { - "digest": entry.configurations[PIXELS].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Published footprints; pixel positions of the OSI SAF IASI " - "sea surface temperature product", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": "sample_size_within_3pct", "value": within}, - {"name": "sample_size_largest_error", "value": largest}, - {"name": "pixel_position_median", "value": median}, - {"name": "pixel_position_p95", "value": p95}, - {"name": "spacing_along_ratio_median", "value": along}, - {"name": "spacing_cross_ratio_median", "value": cross}, - ], - "fixture_metrics": { - "sample_size_within_3pct": within, - "pixel_position_median": summarize(reduced[:, 2])["median"], - "spacing_along_ratio_median": fixture_along, - "spacing_cross_ratio_median": fixture_cross, - }, + source=source_of(__file__), + reference="Published footprints; pixel positions of the OSI SAF IASI " + "sea surface temperature product", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=[ + {"name": "sample_size_within_3pct", "value": within}, + {"name": "sample_size_largest_error", "value": largest}, + {"name": "pixel_position_median", "value": median}, + {"name": "pixel_position_p95", "value": p95}, + {"name": "spacing_along_ratio_median", "value": along}, + {"name": "spacing_cross_ratio_median", "value": cross}, + ], + fixture_metrics={ + "sample_size_within_3pct": within, + "pixel_position_median": summarize(reduced[:, 2])["median"], + "spacing_along_ratio_median": fixture_along, + "spacing_cross_ratio_median": fixture_cross, }, ) @@ -576,7 +567,9 @@ def validate_swath(day, tle, entry, orbit, reference, write) -> None: """Scores the swath configuration, and writes its results if requested.""" def satellite_for(time_step: float): - return entry.to_satellite(orbit, SWATH, time_step=time_step, platform=PLATFORM) + return entry.to_satellite( + orbit, configuration=SWATH, time_step=time_step, platform=PLATFORM + ) satellite = satellite_for(SCAN_PERIOD) points = generate_points_fibonacci_lattice(POINT_SPACING) @@ -619,25 +612,17 @@ def satellite_for(time_step: float): "swath_width_median", "footprint_iou_median", ) - update_record( + write_record( RECORD_PATH, - "iasi", + entry, SWATH, - { - "digest": entry.configurations[SWATH].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Pixel positions of the OSI SAF IASI sea surface temperature " - "product", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": name, "value": float(results[name])} for name in gated - ], - "fixture_metrics": recompute_passes(satellite, 0, day, passes), - }, + source=source_of(__file__), + reference="Pixel positions of the OSI SAF IASI sea surface temperature " + "product", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=[{"name": name, "value": float(results[name])} for name in gated], + fixture_metrics=recompute_passes(satellite, 0, day, passes), ) diff --git a/validation/catalog/validate_catalog_karin.py b/validation/catalog/validate_catalog_karin.py index ab6de516..2051171c 100644 --- a/validation/catalog/validate_catalog_karin.py +++ b/validation/catalog/validate_catalog_karin.py @@ -44,7 +44,6 @@ from shapely.ops import unary_union from skyfield.framelib import itrs -import tatc from tatc.analysis import compute_ground_track from tatc.catalog import get_entry from tatc.catalog.metrics import compute_mask_iou @@ -54,14 +53,13 @@ from validation_io import ( TO_GEODETIC, ecef, - get_holdout_gap, normalize, predict_passes, match_passes, recompute_passes, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -71,7 +69,6 @@ RECORD_PATH = RECORDS / "karin.json" FIXTURE_PATH = FIXTURES / "karin.npz" -FIT_DAY = datetime(2026, 10, 1, tzinfo=timezone.utc) PLATFORM = "swot" CONFIGURATION = "swaths" # public element sets from CelesTrak, with epochs after each day of data (that of the @@ -452,22 +449,16 @@ def satellite_for(time_step: float): update_fixture( FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=fixture ) - update_record( + write_record( RECORD_PATH, - "karin", + entry, CONFIGURATION, - { - "digest": entry.configurations[CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "SWOT_L2_LR_SSH_BASIC_D (good-quality pixels and line times)", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": metrics, - "fixture_metrics": recompute_passes(satellite, None, day, fixture), - }, + source=source_of(__file__), + reference="SWOT_L2_LR_SSH_BASIC_D (good-quality pixels and line times)", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=metrics, + fixture_metrics=recompute_passes(satellite, None, day, fixture), ) print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") diff --git a/validation/catalog/validate_catalog_lsar.py b/validation/catalog/validate_catalog_lsar.py index 501060ac..43db3211 100644 --- a/validation/catalog/validate_catalog_lsar.py +++ b/validation/catalog/validate_catalog_lsar.py @@ -52,7 +52,6 @@ from pyproj import Transformer from shapely.ops import unary_union -import tatc from tatc.analysis import compute_ground_track from tatc.catalog import get_entry from tatc.catalog.metrics import compute_pass_scores, summarize @@ -69,7 +68,6 @@ ) from validation_io import ( ecef, - get_holdout_gap, match_passes, predict_passes, read_element_set_file, @@ -77,7 +75,7 @@ transform_geometry, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -89,7 +87,6 @@ FIXTURE_PATH = FIXTURES / "lsar.npz" SEARCH_URL = "https://api.daac.asf.alaska.edu/services/search/param" -FIT_DAY = datetime(2026, 10, 2, tzinfo=timezone.utc) PLATFORM = "nisar" # public element sets from CelesTrak, with epochs after each day of data (that of the # fit day is the one of ValidateSARNISAR) @@ -522,7 +519,9 @@ def measure(key, day, entry, orbit, catalog, products) -> dict | None: return None def satellite_for(time_step: float): - return entry.to_satellite(orbit, key, time_step=time_step, platform=PLATFORM) + return entry.to_satellite( + orbit, configuration=key, time_step=time_step, platform=PLATFORM + ) satellite = satellite_for(TIME_STEPS[0]) edges = score_edges(chosen, orbit, day, satellite.instruments[0]) @@ -649,26 +648,19 @@ def write_results(key, results, tles, entry, metrics) -> None: f"passes_{key}": fixture, }, ) - gaps = [get_holdout_gap(day, FIT_DAY) for day in days] - update_record( + write_record( RECORD_PATH, - "lsar", + entry, key, - { - "digest": entry.configurations[key].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Geolocation grids, orbits, and bounding polygons of NISAR " - "Level 1 RSLC products", - "period": ", ".join(f"{day:%Y-%m-%d}" for day in days), - "platform": PLATFORM, - "holdout_gap_days": None if None in gaps else min(gaps), - "metrics": metrics, - "fixture_metrics": recompute_passes( - results[days[0]]["satellite"], 0, fixture_day, fixture - ), - }, + source=source_of(__file__), + reference="Geolocation grids, orbits, and bounding polygons of NISAR " + "Level 1 RSLC products", + period=", ".join(f"{day:%Y-%m-%d}" for day in days), + platforms=[PLATFORM], + metrics=metrics, + fixture_metrics=recompute_passes( + results[days[0]]["satellite"], 0, fixture_day, fixture + ), ) print(f"wrote {key} to {RECORD_PATH}") diff --git a/validation/catalog/validate_catalog_mhs.py b/validation/catalog/validate_catalog_mhs.py index c3c31d8c..c285f350 100644 --- a/validation/catalog/validate_catalog_mhs.py +++ b/validation/catalog/validate_catalog_mhs.py @@ -50,7 +50,6 @@ ) NORAD_ID = 43689 -FIT_DAY = datetime(2026, 11, 5, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data ELEMENTS = { "2026-11-05": ( @@ -108,7 +107,6 @@ reference="GPM_1CMETOPCMHS version 08 (beam positions)", published_reference="Footprints of the TC PRIMED documentation; beam positions " "of GPM_1CMETOPCMHS version 08", - fit_day=FIT_DAY, time_steps=(SCAN_PERIOD, 32, 128), pass_radius=60, point_spacing=500e3, diff --git a/validation/catalog/validate_catalog_modis.py b/validation/catalog/validate_catalog_modis.py index 17b100dd..25ac19cd 100644 --- a/validation/catalog/validate_catalog_modis.py +++ b/validation/catalog/validate_catalog_modis.py @@ -56,7 +56,6 @@ from skyfield.positionlib import Geocentric from skyfield.units import Distance, Velocity -import tatc from tatc.catalog import get_entry from tatc.catalog.metrics import summarize from tatc.generation import generate_points_fibonacci_lattice @@ -66,12 +65,11 @@ from validation_io import ( TO_GEODETIC, RemoteFile, - add_transfer_metrics, + write_transfer, build_grid, compute_published_errors, compute_spacing_ratios, ecef, - get_holdout_gap, in_lattice_cells, match_passes, normalize, @@ -81,7 +79,7 @@ score_swath_area, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -91,7 +89,6 @@ RECORD_PATH = RECORDS / "modis.json" FIXTURE_PATH = FIXTURES / "modis.npz" -FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) FIT_PLATFORM = "terra" PRODUCTS = {"terra": "MOD03", "aqua": "MYD03"} # element sets with epochs about two days after the day of data @@ -431,7 +428,7 @@ def validate_pixels(day, tle, entry, orbit, reference, platform, write) -> None: print( f"published dimensions: {within:.1f}% within 3%, largest error {largest:.2f}%" ) - satellite = entry.to_satellite(orbit, PIXELS, platform=platform) + satellite = entry.to_satellite(orbit, configuration=PIXELS, platform=platform) pixels = measure_pixels(reference, satellite, day) median = summarize(pixels[:, 4])["median"] p95 = summarize(pixels[:, 4])["p95"] @@ -446,10 +443,11 @@ def validate_pixels(day, tle, entry, orbit, reference, platform, write) -> None: if not write: return if platform != FIT_PLATFORM: - add_transfer_metrics( + write_transfer( RECORD_PATH, PIXELS, - f"{platform}, {day:%Y-%m-%d}", + platform, + f"{day:%Y-%m-%d}", { "pixel_position_median": median, "pixel_position_p95": p95, @@ -472,33 +470,27 @@ def validate_pixels(day, tle, entry, orbit, reference, platform, write) -> None: spacing=rows[picks], spacing_seconds=(times[picks] - pd.Timestamp(day)).total_seconds().to_numpy(), ) - update_record( + write_record( RECORD_PATH, - "modis", + entry, PIXELS, - { - "digest": entry.configurations[PIXELS].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Footprints published by NASA LAADS; MOD03 geolocation", - "period": f"{day:%Y-%m-%d}", - "platform": platform, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": "sample_size_within_3pct", "value": within}, - {"name": "sample_size_largest_error", "value": largest}, - {"name": "pixel_position_median", "value": median}, - {"name": "pixel_position_p95", "value": p95}, - {"name": "spacing_along_ratio_median", "value": along}, - {"name": "spacing_cross_ratio_median", "value": cross}, - ], - "fixture_metrics": { - "sample_size_within_3pct": within, - "pixel_position_median": summarize(reduced[:, 4])["median"], - "spacing_along_ratio_median": fixture_along, - "spacing_cross_ratio_median": fixture_cross, - }, + source=source_of(__file__), + reference="Footprints published by NASA LAADS; MOD03 geolocation", + period=f"{day:%Y-%m-%d}", + platforms=[platform], + metrics=[ + {"name": "sample_size_within_3pct", "value": within}, + {"name": "sample_size_largest_error", "value": largest}, + {"name": "pixel_position_median", "value": median}, + {"name": "pixel_position_p95", "value": p95}, + {"name": "spacing_along_ratio_median", "value": along}, + {"name": "spacing_cross_ratio_median", "value": cross}, + ], + fixture_metrics={ + "sample_size_within_3pct": within, + "pixel_position_median": summarize(reduced[:, 4])["median"], + "spacing_along_ratio_median": fixture_along, + "spacing_cross_ratio_median": fixture_cross, }, ) @@ -507,7 +499,9 @@ def validate_swath(day, tle, entry, orbit, reference, platform, write) -> None: """Scores the swath configuration, and writes its results if requested.""" def satellite_for(time_step: float): - return entry.to_satellite(orbit, SWATH, time_step=time_step, platform=platform) + return entry.to_satellite( + orbit, configuration=SWATH, time_step=time_step, platform=platform + ) satellite = satellite_for(SCAN_PERIOD) points = generate_points_fibonacci_lattice(500e3) @@ -548,10 +542,11 @@ def satellite_for(time_step: float): "footprint_iou_median", ) if platform != FIT_PLATFORM: - add_transfer_metrics( + write_transfer( RECORD_PATH, SWATH, - f"{platform}, {day:%Y-%m-%d}", + platform, + f"{day:%Y-%m-%d}", {name: results[name] for name in gated}, ) return @@ -568,24 +563,16 @@ def satellite_for(time_step: float): update_fixture( FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) - update_record( + write_record( RECORD_PATH, - "modis", + entry, SWATH, - { - "digest": entry.configurations[SWATH].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "MOD03 geolocation", - "period": f"{day:%Y-%m-%d}", - "platform": platform, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": name, "value": float(results[name])} for name in gated - ], - "fixture_metrics": recompute_passes(satellite, 0, day, passes), - }, + source=source_of(__file__), + reference="MOD03 geolocation", + period=f"{day:%Y-%m-%d}", + platforms=[platform], + metrics=[{"name": name, "value": float(results[name])} for name in gated], + fixture_metrics=recompute_passes(satellite, 0, day, passes), ) diff --git a/validation/catalog/validate_catalog_msi.py b/validation/catalog/validate_catalog_msi.py index cd2b6416..7ae54d1f 100644 --- a/validation/catalog/validate_catalog_msi.py +++ b/validation/catalog/validate_catalog_msi.py @@ -43,7 +43,6 @@ from shapely.ops import unary_union from skyfield.framelib import itrs -import tatc from tatc.analysis import collect_observations, compute_ground_track from tatc.catalog import get_entry from tatc.catalog.metrics import summarize @@ -53,7 +52,6 @@ from validation_io import ( TO_GEODETIC, ecef, - get_holdout_gap, get_with_retries, match_passes, normalize, @@ -63,7 +61,7 @@ recompute_passes, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -77,7 +75,6 @@ STAC_URL = "https://planetarycomputer.microsoft.com/api/stac/v1/search" TOKEN_URL = "https://planetarycomputer.microsoft.com/api/sas/v1/token/sentinel-2-l2a" -FIT_DAY = datetime(2026, 10, 3, tzinfo=timezone.utc) PLATFORMS = { "sentinel-2a": ("Sentinel-2A", 40697), "sentinel-2b": ("Sentinel-2B", 42063), @@ -843,7 +840,7 @@ def validate(day, tles, entry, orbits, tiles, datatakes, sections, reference, wr def satellite_for(platform: str, time_step: float): return entry.to_satellite( - orbits[platform], KEY, time_step=time_step, platform=platform + orbits[platform], configuration=KEY, time_step=time_step, platform=platform ) metrics = [] @@ -907,25 +904,19 @@ def satellite_for(platform: str, time_step: float): day=np.array(day.isoformat()), passes=fixture, ) - update_record( + write_record( RECORD_PATH, - "msi", + entry, KEY, - { - "digest": entry.configurations[KEY].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Valid data footprints of Sentinel-2 Level-2A tiles; viewing " - + "angle grids and GPS ephemerides of their metadata", - "period": f"{day:%Y-%m-%d}", - "platform": ", ".join(sorted(PLATFORMS)), - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": metrics, - "fixture_metrics": recompute_passes( - satellite_for(FIXTURE_PLATFORM, TIME_STEPS[0]), 0, day, fixture - ), - }, + source=source_of(__file__), + reference="Valid data footprints of Sentinel-2 Level-2A tiles; viewing " + + "angle grids and GPS ephemerides of their metadata", + period=f"{day:%Y-%m-%d}", + platforms=sorted(PLATFORMS), + metrics=metrics, + fixture_metrics=recompute_passes( + satellite_for(FIXTURE_PLATFORM, TIME_STEPS[0]), 0, day, fixture + ), ) print(f"wrote {RECORD_PATH}") diff --git a/validation/catalog/validate_catalog_oci.py b/validation/catalog/validate_catalog_oci.py index 5e2bcf2e..968c5291 100644 --- a/validation/catalog/validate_catalog_oci.py +++ b/validation/catalog/validate_catalog_oci.py @@ -42,7 +42,8 @@ import numpy as np import pandas as pd -from tatc.catalog import get_entry, get_subsolar_latitude +from tatc.catalog import get_entry +from tatc.utils import compute_subsolar_latitude from tatc.schemas import GeneralPerturbationsOrbit from gesdisc_scanner import Product, Reference, Setup, load_day, validate_swath from validation_io import ( @@ -60,7 +61,6 @@ # the angles are fitted to 2026-10-04, and the schedule of the tilt's change to # 2026-08-15 through 2026-10-08, the last day of fitting data -FIT_DAY = datetime(2026, 10, 8, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data ELEMENTS = { "2026-11-04": ( @@ -139,7 +139,6 @@ def read_oci(_product, url: str, session, day: datetime, _directory) -> dict: source=source_of(__file__), reference="PACE_OCI_L1B_SCI version 3 (sample positions and times)", published_reference="", - fit_day=FIT_DAY, time_steps=(10, 30, 120), pass_radius=40, point_spacing=200e3, @@ -259,7 +258,7 @@ def find_switch_granules(day: datetime) -> list[str]: Finds the granules of a day that cross latitudes within 12 deg of the subsolar latitude, where the tilt changes to fore. """ - subsolar = get_subsolar_latitude(day + timedelta(hours=12)) + subsolar = compute_subsolar_latitude(day + timedelta(hours=12)) items = get_with_retries( "https://cmr.earthdata.nasa.gov/search/granules.umm_json", params={ @@ -372,7 +371,9 @@ def fit_switches(first: datetime, last: datetime, directory: pathlib.Path) -> No daily = switches.groupby("day").lat.median() subsolar = np.array( [ - get_subsolar_latitude(datetime.combine(d, time(12), tzinfo=timezone.utc)) + compute_subsolar_latitude( + datetime.combine(d, time(12), tzinfo=timezone.utc) + ) for d in daily.index ] ) diff --git a/validation/catalog/validate_catalog_oco2.py b/validation/catalog/validate_catalog_oco2.py index 464989b5..f54f4f20 100644 --- a/validation/catalog/validate_catalog_oco2.py +++ b/validation/catalog/validate_catalog_oco2.py @@ -42,7 +42,6 @@ from skyfield.framelib import itrs from skyfield.units import Distance -import tatc from tatc.analysis import collect_observations, compute_ground_track from tatc.catalog import get_entry from tatc.catalog.metrics import summarize @@ -54,18 +53,16 @@ TO_GEODETIC, RemoteFile, ecef, - get_holdout_gap, recompute_passes, transform_geometry, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, ) -FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data OCO2_ELEMENTS = ( "1 40059U 14035A 26313.25381781 .00000489 00000+0 11850-3 0 9999", @@ -251,7 +248,9 @@ def validate_mode(day, tle, orbit, mode: int, reference: Reference, write: bool) entry = get_entry("oco2") def satellite_for(time_step): - return entry.to_satellite(orbit, key, time_step=time_step, platform="oco-2") + return entry.to_satellite( + orbit, configuration=key, time_step=time_step, platform="oco-2" + ) rng = np.random.default_rng(1) frames = rng.choice(len(reference.time), SAMPLE, replace=False) @@ -294,34 +293,26 @@ def satellite_for(time_step): update_fixture( fixture, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) - update_record( + write_record( RECORD_PATH, - "oco2", + entry, key, - { - "digest": entry.configurations[key].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": f"OCO2_L1B_Science version 11.2 (sounding positions and " - f"times, {key} orbits)", - "period": f"{day:%Y-%m-%d}", - "platform": "oco-2", - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": name, "value": float(results[name])} - for name in ( - "pass_recall", - "epoch_p95", - "epoch_median", - "swath_width_median", - "footprint_iou_median", - ) - ], - "fixture_metrics": recompute_passes( - satellite_for(TIME_STEPS[0]), 0, day, passes - ), - }, + source=source_of(__file__), + reference=f"OCO2_L1B_Science version 11.2 (sounding positions and " + f"times, {key} orbits)", + period=f"{day:%Y-%m-%d}", + platforms=["oco-2"], + metrics=[ + {"name": name, "value": float(results[name])} + for name in ( + "pass_recall", + "epoch_p95", + "epoch_median", + "swath_width_median", + "footprint_iou_median", + ) + ], + fixture_metrics=recompute_passes(satellite_for(TIME_STEPS[0]), 0, day, passes), ) print(f"wrote {RECORD_PATH} and {fixture}") diff --git a/validation/catalog/validate_catalog_olci.py b/validation/catalog/validate_catalog_olci.py index 56602d51..5902b085 100644 --- a/validation/catalog/validate_catalog_olci.py +++ b/validation/catalog/validate_catalog_olci.py @@ -58,7 +58,6 @@ source_of, ) -FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data ELEMENTS = { "2026-11-04": ( @@ -163,7 +162,6 @@ def read(name: str, fields: tuple[str, ...]) -> dict: source=source_of(__file__), reference="S3A_OL_1_EFR (tie point positions and times)", published_reference="", - fit_day=FIT_DAY, time_steps=(10, 30, 120), pass_radius=40, point_spacing=200e3, diff --git a/validation/catalog/validate_catalog_oli.py b/validation/catalog/validate_catalog_oli.py index d1e519b9..60202711 100644 --- a/validation/catalog/validate_catalog_oli.py +++ b/validation/catalog/validate_catalog_oli.py @@ -46,7 +46,6 @@ from shapely.ops import unary_union from skyfield.framelib import itrs -import tatc from tatc.analysis import collect_observations, compute_ground_track from tatc.catalog import get_entry from tatc.catalog.metrics import summarize @@ -54,9 +53,8 @@ from tatc.schemas import GeneralPerturbationsOrbit, Point from validation_io import ( TO_GEODETIC, - add_transfer_metrics, + write_transfer, ecef, - get_holdout_gap, get_with_retries, match_passes, normalize, @@ -65,7 +63,7 @@ recompute_passes, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -80,7 +78,6 @@ "https://planetarycomputer.microsoft.com/api/sas/v1/token/landsat-c2-l2" ) -FIT_DAY = datetime(2026, 11, 5, tzinfo=timezone.utc) FIT_PLATFORM = "landsat-9" PLATFORMS = {"landsat-8": "LANDSAT_8", "landsat-9": "LANDSAT_9"} _OCTOBER = { @@ -672,7 +669,9 @@ def validate( """Scores the configuration, and writes its results if requested.""" def satellite_for(time_step: float): - return entry.to_satellite(orbit, KEY, time_step=time_step, platform=platform) + return entry.to_satellite( + orbit, configuration=KEY, time_step=time_step, platform=platform + ) satellite = satellite_for(TIME_STEPS[0]) intervals = get_intervals(scenes) @@ -716,10 +715,11 @@ def satellite_for(time_step: float): "footprint_iou_p5", ) if platform != FIT_PLATFORM: - add_transfer_metrics( + write_transfer( RECORD_PATH, KEY, - f"{platform}, {day:%Y-%m-%d}", + platform, + f"{day:%Y-%m-%d}", {name: results[name] for name in names}, ) return @@ -738,25 +738,17 @@ def satellite_for(time_step: float): update_fixture( FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=fixture ) - update_record( + write_record( RECORD_PATH, - "oli", + entry, KEY, - { - "digest": entry.configurations[KEY].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "USGS Landsat Collection 2 scene footprints and center times; " - + "angle coefficient files of Level-2 products", - "period": f"{day:%Y-%m-%d}", - "platform": platform, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": name, "value": float(results[name])} for name in names - ], - "fixture_metrics": recompute_passes(satellite, 0, day, fixture), - }, + source=source_of(__file__), + reference="USGS Landsat Collection 2 scene footprints and center times; " + + "angle coefficient files of Level-2 products", + period=f"{day:%Y-%m-%d}", + platforms=[platform], + metrics=[{"name": name, "value": float(results[name])} for name in names], + fixture_metrics=recompute_passes(satellite, 0, day, fixture), ) print(f"wrote {RECORD_PATH}") diff --git a/validation/catalog/validate_catalog_omps.py b/validation/catalog/validate_catalog_omps.py index 5af4e2c8..47929bcb 100644 --- a/validation/catalog/validate_catalog_omps.py +++ b/validation/catalog/validate_catalog_omps.py @@ -23,6 +23,7 @@ import argparse import concurrent.futures +import functools import io import pathlib from datetime import datetime, timezone @@ -34,12 +35,10 @@ from tatc.schemas import GeneralPerturbationsOrbit from gesdisc_scanner import Reference, Setup, fit, fit_yaw, validate_swath from validation_io import ( + ARCHIVES, + Archive, TO_GEODETIC, - fetch, iet_to_utc, - list_keys, - load_element_set, - use_archive, RECORDS, FIXTURES, source_of, @@ -47,24 +46,19 @@ GROUP = "All_Data/OMPS-TC-GEO_All/" LINE_STRIDE, SAMPLE_STRIDE = 2, 4 -# the day to which each platform's angles were fitted, and its configuration and -# fixture -FIT_DAYS = { - "noaa-20": datetime(2026, 10, 1, tzinfo=timezone.utc), - "noaa-21": datetime(2026, 10, 1, tzinfo=timezone.utc), -} +# the configuration of each platform's fit and its fixture CONFIGURATIONS = { "noaa-21": ("swath_noaa_21", FIXTURES / "omps_nm_noaa_21.npz"), "noaa-20": ("swath_noaa_20", FIXTURES / "omps_nm_noaa_20.npz"), } -def read_granule(key: str) -> dict | None: +def read_granule(archive: Archive, key: str) -> dict | None: """ Reads a granule's lines: their middle times, the positions of their samples, the spacecraft's position, and their quality flags. """ - with h5py.File(io.BytesIO(fetch(key))) as f: + with h5py.File(io.BytesIO(archive.fetch(key))) as f: g = f[GROUP] samples = int(g["NumberOfIFOVs"][0]) if samples <= 0 or len(g["MidTime"]) == 0: @@ -80,13 +74,17 @@ def read_granule(key: str) -> dict | None: } -def load_day(day: datetime, directory: pathlib.Path, prefix: str) -> dict: +def load_day(day: datetime, directory: pathlib.Path, archive: Archive) -> dict: """Downloads and reduces the geolocation of a day, or loads it from a cache.""" - path = directory / f"{prefix}_omps_gotco_{day:%Y%m%d}.npz" + path = directory / f"{archive.prefix}_omps_gotco_{day:%Y%m%d}.npz" if not path.exists(): - keys = list_keys(f"OMPS-TC-GEO/{day:%Y/%m/%d}/") + keys = archive.list_keys(f"OMPS-TC-GEO/{day:%Y/%m/%d}/") with concurrent.futures.ThreadPoolExecutor(8) as pool: - parts = [p for p in pool.map(read_granule, keys) if p is not None] + parts = [ + p + for p in pool.map(functools.partial(read_granule, archive), keys) + if p is not None + ] samples = {int(p["samples"][0]) for p in parts} if len(samples) != 1: raise ValueError(f"granules differ in their number of samples: {samples}") @@ -98,9 +96,11 @@ def load_day(day: datetime, directory: pathlib.Path, prefix: str) -> dict: return dict(np.load(path)) -def load_reference(day: datetime, directory: pathlib.Path, prefix: str) -> Reference: +def load_reference( + day: datetime, directory: pathlib.Path, archive: Archive +) -> Reference: """Loads a reduced day as a reference of scans.""" - raw = load_day(day, directory, prefix) + raw = load_day(day, directory, archive) seconds = (iet_to_utc(raw["mid_iet"]) - day).total_seconds().to_numpy() sc_lon, sc_lat, sc_alt = TO_GEODETIC.transform(*raw["position"].T) samples = int(raw["samples"][0]) @@ -137,7 +137,6 @@ def make_setup(platform: str) -> Setup: reference="OMPS-TC-GEO (sample positions and times), NOAA Open Data " "Dissemination", published_reference="", - fit_day=FIT_DAYS[platform], time_steps=(10, 30, 120), pass_radius=40, point_spacing=200e3, @@ -149,14 +148,14 @@ def main() -> None: parser = argparse.ArgumentParser(description=__doc__) parser.add_argument("directory", type=pathlib.Path) parser.add_argument("day") - parser.add_argument("--platform", default="noaa-21", choices=sorted(FIT_DAYS)) + parser.add_argument("--platform", default="noaa-21", choices=sorted(CONFIGURATIONS)) parser.add_argument("--fit", action="store_true") parser.add_argument("--write", action="store_true") arguments = parser.parse_args() arguments.directory.mkdir(parents=True, exist_ok=True) - prefix = use_archive(arguments.platform) + archive = ARCHIVES[arguments.platform] day = datetime.fromisoformat(arguments.day).replace(tzinfo=timezone.utc) - reference = load_reference(day, arguments.directory, prefix) + reference = load_reference(day, arguments.directory, archive) print( f"{arguments.day} ({arguments.platform}): {len(reference.time)} lines from " f"{reference.time[0]}, {reference.pixels} samples, {len(reference.gaps)} gaps " @@ -168,7 +167,7 @@ def main() -> None: fit(reference, frame) fit_yaw(reference, frame) return - tle = load_element_set(day, arguments.directory) + tle = archive.load_element_set(day, arguments.directory) print(f"element set: {tle[0][:32]}", flush=True) orbit = GeneralPerturbationsOrbit.from_tle(tle) setup = make_setup(arguments.platform) diff --git a/validation/catalog/validate_catalog_poseidon4.py b/validation/catalog/validate_catalog_poseidon4.py index c879a2cb..14c4999b 100644 --- a/validation/catalog/validate_catalog_poseidon4.py +++ b/validation/catalog/validate_catalog_poseidon4.py @@ -33,7 +33,6 @@ from pyproj import Geod from skyfield.api import wgs84 -import tatc from tatc.analysis import collect_observations from tatc.catalog.metrics import summarize from tatc.catalog import get_entry @@ -41,11 +40,11 @@ from tatc.schemas import GeneralPerturbationsOrbit, Point from validation_io import ( RemoteFile, - add_transfer_metrics, + write_transfer, get_with_retries, recompute_passes, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -229,10 +228,11 @@ def main() -> None: if not arguments.write: return if platform != "sentinel-6a": - add_transfer_metrics( + write_transfer( RECORD_PATH, "nadir", - f"{platform}, {day:%Y-%m-%d}", + platform, + f"{day:%Y-%m-%d}", { name: results[name] for name in ("segment_recall", "track_offset_median", "epoch_p95") @@ -255,29 +255,24 @@ def main() -> None: satellite = entry.to_satellite( orbit, time_step=TIME_STEPS[0], platform="sentinel-6a" ) - update_record( + write_record( RECORD_PATH, - "poseidon4", + entry, "nadir", - { - "digest": entry.configurations["nadir"].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": f"{SHORT_NAMES[platform]} (1 Hz measurement positions and times)", - "period": f"{day:%Y-%m-%d}", - "platform": "sentinel-6a", - "metrics": [ - {"name": name, "value": float(results[name])} - for name in ( - "segment_recall", - "track_offset_median", - "epoch_p95", - "epoch_median", - ) - ], - "fixture_metrics": recompute_passes(satellite, 0, day, passes), - }, + source=source_of(__file__), + reference=f"{SHORT_NAMES[platform]} (1 Hz measurement positions and times)", + period=f"{day:%Y-%m-%d}", + platforms=["sentinel-6a"], + metrics=[ + {"name": name, "value": float(results[name])} + for name in ( + "segment_recall", + "track_offset_median", + "epoch_p95", + "epoch_median", + ) + ], + fixture_metrics=recompute_passes(satellite, 0, day, passes), ) print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") diff --git a/validation/catalog/validate_catalog_smap.py b/validation/catalog/validate_catalog_smap.py index 5925813a..dbd41e8e 100644 --- a/validation/catalog/validate_catalog_smap.py +++ b/validation/catalog/validate_catalog_smap.py @@ -50,7 +50,6 @@ from scipy.spatial import cKDTree from shapely import contains_xy, prepare -import tatc from tatc.analysis import ( collect_observations, compute_ground_track, @@ -65,14 +64,13 @@ TO_GEODETIC, build_grid, ecef, - get_holdout_gap, in_lattice_cells, normalize, read_element_set_file, recompute_passes, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -84,7 +82,6 @@ FIXTURE_PATH = FIXTURES / "smap_radiometer.npz" ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "smap_2026-09-20.3le" -FIT_DAY = datetime(2026, 10, 24, tzinfo=timezone.utc) PLATFORM = "smap" NORAD_ID = 40376 CONFIGURATION = "looks" @@ -494,7 +491,10 @@ def score_published_footprints(entry) -> tuple[float, float]: epoch=PUBLISHED_EPOCH, ) satellite = entry.to_satellite( - orbit, SAMPLE_CONFIGURATION, time_step=SCAN_PERIOD, platform=PLATFORM + orbit, + configuration=SAMPLE_CONFIGURATION, + time_step=SCAN_PERIOD, + platform=PLATFORM, ) time = PUBLISHED_EPOCH + timedelta(minutes=10) target = satellite.get_instrument(0).compute_footprint_center( @@ -585,7 +585,10 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non f"published dimensions: {within:.1f}% within 3%, largest error {largest:.2f}%" ) satellite = entry.to_satellite( - orbit, SAMPLE_CONFIGURATION, time_step=SCAN_PERIOD, platform=PLATFORM + orbit, + configuration=SAMPLE_CONFIGURATION, + time_step=SCAN_PERIOD, + platform=PLATFORM, ) rows = measure_spacing(reference) arc, between = compute_spacing_ratios(day, satellite, rows) @@ -606,31 +609,25 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non footprints=np.array([row[1:] for row in PUBLISHED_FOOTPRINTS], dtype=float), spacing=picks, ) - update_record( + write_record( RECORD_PATH, - "smap_radiometer", + entry, SAMPLE_CONFIGURATION, - { - "digest": entry.configurations[SAMPLE_CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Footprints of Piepmeier et al. (2017) and the JPL SMAP " - "specifications; spacing of SPL1BTB", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": "sample_size_within_3pct", "value": within}, - {"name": "sample_size_largest_error", "value": largest}, - {"name": "spacing_arc_ratio_median", "value": arc}, - {"name": "spacing_scan_ratio_median", "value": between}, - ], - "fixture_metrics": { - "sample_size_within_3pct": within, - "spacing_arc_ratio_median": fixture_arc, - "spacing_scan_ratio_median": fixture_between, - }, + source=source_of(__file__), + reference="Footprints of Piepmeier et al. (2017) and the JPL SMAP " + "specifications; spacing of SPL1BTB", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=[ + {"name": "sample_size_within_3pct", "value": within}, + {"name": "sample_size_largest_error", "value": largest}, + {"name": "spacing_arc_ratio_median", "value": arc}, + {"name": "spacing_scan_ratio_median", "value": between}, + ], + fixture_metrics={ + "sample_size_within_3pct": within, + "spacing_arc_ratio_median": fixture_arc, + "spacing_scan_ratio_median": fixture_between, }, ) @@ -763,22 +760,16 @@ def satellite_for(time_step: float): "footprint_iou_median", ) ] - update_record( + write_record( RECORD_PATH, - "smap_radiometer", + entry, CONFIGURATION, - { - "digest": entry.configurations[CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "SPL1BTB (footprint positions and times)", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": metrics, - "fixture_metrics": recompute_passes(satellite, 0, day, fixture), - }, + source=source_of(__file__), + reference="SPL1BTB (footprint positions and times)", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=metrics, + fixture_metrics=recompute_passes(satellite, 0, day, fixture), ) print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") diff --git a/validation/catalog/validate_catalog_spexone.py b/validation/catalog/validate_catalog_spexone.py index 736ba2f0..a8ca9f73 100644 --- a/validation/catalog/validate_catalog_spexone.py +++ b/validation/catalog/validate_catalog_spexone.py @@ -55,7 +55,6 @@ login_earthdata, ) -FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) # public element sets from CelesTrak, with epochs after each day of data PACE_ELEMENTS = ( "1 58928U 24025A 26313.27483190 .00000501 00000+0 10091-3 0 9993", @@ -123,7 +122,6 @@ def read_navigation(url: str, session, day: datetime) -> tuple[np.ndarray, np.nd reference="PACE_SPEXONE_L1C_SCI version 4 (positions of bins and times of the " "nadir view)", published_reference="", - fit_day=FIT_DAY, time_steps=(10, 30, 120), pass_radius=10, point_spacing=100e3, diff --git a/validation/catalog/validate_catalog_ssmis.py b/validation/catalog/validate_catalog_ssmis.py index e78be715..60e5eef4 100644 --- a/validation/catalog/validate_catalog_ssmis.py +++ b/validation/catalog/validate_catalog_ssmis.py @@ -34,7 +34,6 @@ from pyproj import Geod from scipy.spatial import cKDTree -import tatc from tatc.catalog import get_entry from tatc.generation import generate_points_fibonacci_lattice from tatc.schemas import GeneralPerturbationsOrbit @@ -43,14 +42,13 @@ TO_GEODETIC, build_grid, ecef, - get_holdout_gap, normalize, recompute_passes, score_passes, score_swath_area, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -58,7 +56,6 @@ RECORD_PATH = RECORDS / "ssmis.json" FIXTURE_PATH = FIXTURES / "ssmis.npz" -FIT_DAY = datetime(2026, 10, 4, tzinfo=timezone.utc) PLATFORM = "dmsp-f18" CONFIGURATION = "swath" # public element sets from CelesTrak, with epochs after each day of data @@ -240,7 +237,7 @@ def main() -> None: def satellite_for(time_step: float): return entry.to_satellite( - orbit, CONFIGURATION, time_step=time_step, platform=PLATFORM + orbit, configuration=CONFIGURATION, time_step=time_step, platform=PLATFORM ) satellite = satellite_for(SCAN_PERIOD) @@ -279,31 +276,25 @@ def satellite_for(time_step: float): update_fixture( FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) - update_record( + write_record( RECORD_PATH, - "ssmis", + entry, CONFIGURATION, - { - "digest": entry.configurations[CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "GPM_1CF18SSMIS version 08 (positions of the S1 samples)", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": name, "value": float(results[name])} - for name in ( - "pass_recall", - "pass_precision", - "epoch_p95", - "swath_width_median", - "footprint_iou_median", - ) - ], - "fixture_metrics": recompute_passes(satellite, 0, day, passes), - }, + source=source_of(__file__), + reference="GPM_1CF18SSMIS version 08 (positions of the S1 samples)", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=[ + {"name": name, "value": float(results[name])} + for name in ( + "pass_recall", + "pass_precision", + "epoch_p95", + "swath_width_median", + "footprint_iou_median", + ) + ], + fixture_metrics=recompute_passes(satellite, 0, day, passes), ) print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") diff --git a/validation/catalog/validate_catalog_tempo.py b/validation/catalog/validate_catalog_tempo.py index 7fa80061..361e6cf0 100644 --- a/validation/catalog/validate_catalog_tempo.py +++ b/validation/catalog/validate_catalog_tempo.py @@ -42,9 +42,8 @@ from skyfield.framelib import itrs from skyfield.positionlib import Geocentric -import tatc from tatc.analysis import collect_observations -from tatc.catalog import STANDARD_VERSION, get_entry +from tatc.catalog import get_entry from tatc.catalog.metrics import compute_mask_iou from tatc.constants import timescale from tatc.schemas import GeneralPerturbationsOrbit, Point @@ -53,19 +52,18 @@ RemoteFile, add_earth_orientation, ecef, - get_holdout_gap, get_with_retries, up, RECORDS, FIXTURES, source_of, login_earthdata, + write_record, ) RECORD_PATH = RECORDS / "tempo.json" FIXTURE_PATH = FIXTURES / "tempo.npz" SHORT_NAME, VERSION = "TEMPO_RAD_L1", "V04" -FIT_DAY = datetime(2026, 10, 6, tzinfo=timezone.utc) PLATFORM = "intelsat-40e" CONFIGURATION = "field_of_regard" # public element sets from CelesTrak, with epochs after each day of data @@ -395,40 +393,32 @@ def validate(day, tle, scan, write) -> None: ), ) fixture_predicted = predict_grid(satellite, track, lon[sample], lat[sample]) - record = { - "entry_id": "tempo", - "standard_version": STANDARD_VERSION, - "configurations": { - CONFIGURATION: { - "digest": entry.configurations[CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": f"{SHORT_NAME} {VERSION} (outer corners of the outermost " - "pixels of a full scan, ultraviolet band)", - "period": f"{time:%Y-%m-%dT%H:%MZ}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": "field_of_regard_iou", "value": float(iou)}, - { - "name": "imaged_area_predicted", - "value": results["observed_predicted"], - }, - { - "name": "predicted_area_imaged", - "value": results["predicted_observed"], - }, - {"name": "collect_observations_agreement", "value": agreement}, - ], - "fixture_metrics": { - "points_agreeing": 100 - * float(np.mean(fixture_predicted == fixture[:, 2].astype(bool))) - }, - } + write_record( + RECORD_PATH, + entry, + CONFIGURATION, + source=source_of(__file__), + reference=f"{SHORT_NAME} {VERSION} (outer corners of the outermost " + "pixels of a full scan, ultraviolet band)", + period=f"{time:%Y-%m-%dT%H:%MZ}", + platforms=[PLATFORM], + metrics=[ + {"name": "field_of_regard_iou", "value": float(iou)}, + { + "name": "imaged_area_predicted", + "value": results["observed_predicted"], + }, + { + "name": "predicted_area_imaged", + "value": results["predicted_observed"], + }, + {"name": "collect_observations_agreement", "value": agreement}, + ], + fixture_metrics={ + "points_agreeing": 100 + * float(np.mean(fixture_predicted == fixture[:, 2].astype(bool))) }, - } - RECORD_PATH.write_text(json.dumps(record, indent=2) + "\n", encoding="utf-8") + ) print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") diff --git a/validation/catalog/validate_catalog_tmi.py b/validation/catalog/validate_catalog_tmi.py index cadfb955..e29399bc 100644 --- a/validation/catalog/validate_catalog_tmi.py +++ b/validation/catalog/validate_catalog_tmi.py @@ -43,7 +43,6 @@ from pyproj import Geod from scipy.spatial import cKDTree -import tatc from tatc.analysis import compute_sample_sizes from tatc.catalog import get_entry from tatc.generation import generate_points_fibonacci_lattice @@ -56,7 +55,6 @@ build_grid, compute_spacing_ratios, ecef, - get_holdout_gap, normalize, read_element_set_file, recompute_passes, @@ -66,12 +64,12 @@ to_observations, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, ) -from validate_catalog_trmm_pr import ELEMENT_SET_FILE, FIT_DAY, NORAD_ID +from validate_catalog_trmm_pr import ELEMENT_SET_FILE, NORAD_ID RECORD_PATH = RECORDS / "tmi.json" FIXTURE_PATH = FIXTURES / "tmi.npz" @@ -341,7 +339,10 @@ def compute_published_errors(entry) -> np.ndarray: altitude=altitude * 1e3, inclination=inclination, epoch=PUBLISHED_EPOCH ) satellite = entry.to_satellite( - orbit, SAMPLE_CONFIGURATION, time_step=SCAN_PERIOD, platform=PLATFORM + orbit, + configuration=SAMPLE_CONFIGURATION, + time_step=SCAN_PERIOD, + platform=PLATFORM, ) names = [instrument.name for instrument in satellite.instruments] time = PUBLISHED_EPOCH + timedelta(minutes=10) @@ -377,7 +378,10 @@ def validate_sample_sizes(day, tle, entry, orbit, references, write: bool) -> No {"name": "sample_size_largest_error", "value": largest}, ] satellite = entry.to_satellite( - orbit, SAMPLE_CONFIGURATION, time_step=SCAN_PERIOD, platform=PLATFORM + orbit, + configuration=SAMPLE_CONFIGURATION, + time_step=SCAN_PERIOD, + platform=PLATFORM, ) rng = np.random.default_rng(2) fixture_metrics = {"sample_size_within_3pct": within} @@ -409,23 +413,17 @@ def validate_sample_sizes(day, tle, entry, orbit, references, write: bool) -> No update_fixture( FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), **reduced ) - update_record( + write_record( RECORD_PATH, - "tmi", + entry, SAMPLE_CONFIGURATION, - { - "digest": entry.configurations[SAMPLE_CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Footprints of the TC PRIMED documentation; spacing of " - "GPM_1CTRMMTMI version 08", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": metrics, - "fixture_metrics": fixture_metrics, - }, + source=source_of(__file__), + reference="Footprints of the TC PRIMED documentation; spacing of " + "GPM_1CTRMMTMI version 08", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=metrics, + fixture_metrics=fixture_metrics, ) @@ -437,7 +435,7 @@ def validate_swath(day, tle, entry, orbit, references, write: bool) -> None: def satellite_for(time_step: float): return entry.to_satellite( - orbit, CONFIGURATION, time_step=time_step, platform=PLATFORM + orbit, configuration=CONFIGURATION, time_step=time_step, platform=PLATFORM ) satellite = satellite_for(SCAN_PERIOD) @@ -496,23 +494,17 @@ def satellite_for(time_step: float): update_fixture( FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) - update_record( + write_record( RECORD_PATH, - "tmi", + entry, CONFIGURATION, - { - "digest": entry.configurations[CONFIGURATION].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "GPM_1CTRMMTMI version 08 (positions of the S1, S2, and S3 " - "samples)", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": metrics, - "fixture_metrics": recompute_passes(satellite, 0, day, passes), - }, + source=source_of(__file__), + reference="GPM_1CTRMMTMI version 08 (positions of the S1, S2, and S3 " + "samples)", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=metrics, + fixture_metrics=recompute_passes(satellite, 0, day, passes), ) diff --git a/validation/catalog/validate_catalog_trmm_pr.py b/validation/catalog/validate_catalog_trmm_pr.py index 25f97cc0..8e5d2a41 100644 --- a/validation/catalog/validate_catalog_trmm_pr.py +++ b/validation/catalog/validate_catalog_trmm_pr.py @@ -50,7 +50,6 @@ ) NORAD_ID = 25063 -FIT_DAY = datetime(2013, 6, 1, tzinfo=timezone.utc) ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "trmm_2013-05-20.3le" PRODUCT = Product( short_name="GPM_2APR", @@ -82,7 +81,6 @@ reference="GPM_2APR version 07 (beam positions of the full swath)", published_reference="Footprints of the TC PRIMED documentation; beam positions " "of GPM_2APR version 07", - fit_day=FIT_DAY, time_steps=(10, 30, 120), pass_radius=10, point_spacing=100e3, diff --git a/validation/catalog/validate_catalog_tropomi.py b/validation/catalog/validate_catalog_tropomi.py index 2232fdad..cd3b5314 100644 --- a/validation/catalog/validate_catalog_tropomi.py +++ b/validation/catalog/validate_catalog_tropomi.py @@ -41,7 +41,6 @@ import pandas as pd from scipy.spatial import cKDTree -import tatc from tatc.catalog import get_entry from tatc.generation import generate_points_fibonacci_lattice from tatc.schemas import GeneralPerturbationsOrbit @@ -50,7 +49,6 @@ RemoteFile, build_grid, ecef, - get_holdout_gap, get_with_retries, in_lattice_cells, match_passes, @@ -60,7 +58,7 @@ score_swath_area, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -71,7 +69,6 @@ BUCKET = "https://meeo-s5p.s3.amazonaws.com/" PREFIX = "NRTI/L2__AER_AI/" -FIT_DAY = datetime(2026, 10, 5, tzinfo=timezone.utc) PLATFORM = "sentinel-5p" ELEMENT_SETS = { "2026-11-04": [ @@ -477,7 +474,9 @@ def validate(day, tle, entry, orbit, reference, write) -> None: """Scores the configuration, and writes its results if requested.""" def satellite_for(time_step: float): - return entry.to_satellite(orbit, KEY, time_step=time_step, platform=PLATFORM) + return entry.to_satellite( + orbit, configuration=KEY, time_step=time_step, platform=PLATFORM + ) satellite = satellite_for(ANALYSIS_TIME_STEP) points = generate_points_fibonacci_lattice(POINT_SPACING) @@ -516,24 +515,16 @@ def satellite_for(time_step: float): "swath_width_median", "footprint_iou_median", ) - update_record( + write_record( RECORD_PATH, - "tropomi", + entry, KEY, - { - "digest": entry.configurations[KEY].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Sentinel-5P TROPOMI aerosol index product (near real time)", - "period": f"{day:%Y-%m-%d}", - "platform": PLATFORM, - "holdout_gap_days": get_holdout_gap(day, FIT_DAY), - "metrics": [ - {"name": name, "value": float(results[name])} for name in names - ], - "fixture_metrics": recompute_passes(satellite, None, day, passes), - }, + source=source_of(__file__), + reference="Sentinel-5P TROPOMI aerosol index product (near real time)", + period=f"{day:%Y-%m-%d}", + platforms=[PLATFORM], + metrics=[{"name": name, "value": float(results[name])} for name in names], + fixture_metrics=recompute_passes(satellite, None, day, passes), ) print(f"wrote {RECORD_PATH}") diff --git a/validation/catalog/validate_catalog_viirs.py b/validation/catalog/validate_catalog_viirs.py index e11d6aa1..7b6421a3 100644 --- a/validation/catalog/validate_catalog_viirs.py +++ b/validation/catalog/validate_catalog_viirs.py @@ -45,26 +45,22 @@ import pandas as pd from scipy.spatial import cKDTree -import tatc from tatc.catalog import get_entry from tatc.catalog.metrics import summarize from tatc.generation import generate_points_fibonacci_lattice from tatc.schemas import GeneralPerturbationsOrbit import gesdisc_scanner -import validation_io from validation_io import ( - add_transfer_metrics, - use_archive, + ARCHIVES, + Archive, + write_transfer, TO_GEODETIC, RemoteFile, build_grid, compute_published_errors, compute_spacing_ratios, ecef, - get_holdout_gap, iet_to_utc, - list_keys, - load_element_set, normalize, recompute_passes, score_passes, @@ -72,7 +68,7 @@ score_swath_area, up, update_fixture, - update_record, + write_record, RECORDS, FIXTURES, source_of, @@ -88,12 +84,7 @@ ) RECORD_PATH = RECORDS / "viirs.json" -# the days to which each platform's angles were fitted, and its configurations -# (swath, and zones if any) and fixture -FIT_DAYS = { - "noaa-20": datetime(2026, 10, 2, tzinfo=timezone.utc), - "noaa-21": datetime(2026, 11, 5, tzinfo=timezone.utc), -} +# the configurations of each platform's fit and its fixture CONFIGURATIONS = { "noaa-20": ("swath_noaa_20", "zones_noaa_20", FIXTURES / "viirs_noaa_20.npz"), "noaa-21": ("swath_noaa_21", None, FIXTURES / "viirs_noaa_21.npz"), @@ -120,21 +111,20 @@ class Run: """ What a run tests: the configurations of the swath and zones (if any), the platform - whose data they are tested on, the fixture, the day of the fit, and whether the - results are a transfer to a platform on which the configurations were not fitted. + whose data they are tested on, the fixture, and whether the results are a + transfer to a platform on which the configurations were not fitted. """ platform: str swath: str zones: str | None fixture_path: pathlib.Path - fit_day: datetime transfer: bool -def open_granule(key: str) -> h5py.File: +def open_granule(url: str) -> h5py.File: """Opens a remote granule, first getting the metadata at its start and end.""" - remote = RemoteFile(validation_io.BUCKET + key) + remote = RemoteFile(url) remote.fetch(0, remote.block_size) remote.fetch( (remote.size - 2**19) // remote.block_size * remote.block_size, remote.size @@ -142,9 +132,9 @@ def open_granule(key: str) -> h5py.File: return h5py.File(remote) -def read_scans(key: str) -> dict: +def read_scans(url: str) -> dict: """Reads the scans and outline of a granule.""" - with open_granule(key) as f: + with open_granule(url) as f: granule = f[GRANULE] return { "gring_lat": granule.attrs["G-Ring_Latitude"].ravel(), @@ -157,9 +147,9 @@ def read_scans(key: str) -> dict: } -def read_pixels(key: str) -> dict: +def read_pixels(url: str) -> dict: """Reads a sample of the pixels of a granule.""" - with open_granule(key) as f: + with open_granule(url) as f: lat, lon, height = ( f[GEO + field][:].reshape(N_SCANS, N_DETECTORS, N_SAMPLES) for field in ("Latitude", "Longitude", "Height") @@ -175,15 +165,18 @@ def read_pixels(key: str) -> dict: } -def load_day(day: datetime, directory: pathlib.Path) -> tuple[dict, dict]: +def load_day( + day: datetime, directory: pathlib.Path, archive: Archive +) -> tuple[dict, dict]: """Downloads and reduces the geolocation of a day, or loads it from a cache.""" scans_path = directory / f"viirs_gmtco_scans_{day:%Y%m%d}.npz" pixels_path = directory / f"viirs_gmtco_pixels_{day:%Y%m%d}.npz" if not (scans_path.exists() and pixels_path.exists()): - keys = list_keys(f"VIIRS-MOD-GEO-TC/{day:%Y/%m/%d}/") + keys = archive.list_keys(f"VIIRS-MOD-GEO-TC/{day:%Y/%m/%d}/") + urls = [archive.url + key for key in keys] with concurrent.futures.ThreadPoolExecutor(8) as pool: - scans = list(pool.map(read_scans, keys)) - pixels = list(pool.map(read_pixels, keys[::PIXEL_GRANULES])) + scans = list(pool.map(read_scans, urls)) + pixels = list(pool.map(read_pixels, urls[::PIXEL_GRANULES])) np.savez_compressed( scans_path, **{field: np.stack([s[field] for s in scans]) for field in scans[0]}, @@ -490,7 +483,9 @@ def validate_zones(day, tle, entry, orbit, reference, write: bool, run: Run) -> print( f"published dimensions: {within:.1f}% within 3%, largest error {largest:.2f}%" ) - satellite = entry.to_satellite(orbit, run.zones, platform=run.platform) + satellite = entry.to_satellite( + orbit, configuration=run.zones, platform=run.platform + ) names = np.array([instrument.name for instrument in satellite.instruments]) pixels = measure_pixels(reference, satellite) median, p95 = (summarize(pixels[:, 3])[key] for key in ("median", "p95")) @@ -503,10 +498,11 @@ def validate_zones(day, tle, entry, orbit, reference, write: bool, run: Run) -> if not write: return if run.transfer: - add_transfer_metrics( + write_transfer( RECORD_PATH, run.zones, - f"{run.platform}, {day:%Y-%m-%d}", + run.platform, + f"{day:%Y-%m-%d}", { "pixel_position_median": median, "pixel_position_p95": p95, @@ -529,34 +525,28 @@ def validate_zones(day, tle, entry, orbit, reference, write: bool, run: Run) -> spacing=rows[picks], spacing_seconds=(times[picks] - pd.Timestamp(day)).total_seconds().to_numpy(), ) - update_record( + write_record( RECORD_PATH, - "viirs", + entry, run.zones, - { - "digest": entry.configurations[run.zones].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "Footprints published by NOAA/CIMSS; samples of the VIIRS " - "moderate-resolution geolocation", - "period": f"{day:%Y-%m-%d}", - "platform": run.platform, - "holdout_gap_days": get_holdout_gap(day, run.fit_day), - "metrics": [ - {"name": "sample_size_within_3pct", "value": within}, - {"name": "sample_size_largest_error", "value": largest}, - {"name": "pixel_position_median", "value": median}, - {"name": "pixel_position_p95", "value": p95}, - {"name": "spacing_along_ratio_median", "value": along}, - {"name": "spacing_cross_ratio_median", "value": cross}, - ], - "fixture_metrics": { - "sample_size_within_3pct": within, - "pixel_position_median": summarize(reduced[:, 3])["median"], - "spacing_along_ratio_median": fixture_along, - "spacing_cross_ratio_median": fixture_cross, - }, + source=source_of(__file__), + reference="Footprints published by NOAA/CIMSS; samples of the VIIRS " + "moderate-resolution geolocation", + period=f"{day:%Y-%m-%d}", + platforms=[run.platform], + metrics=[ + {"name": "sample_size_within_3pct", "value": within}, + {"name": "sample_size_largest_error", "value": largest}, + {"name": "pixel_position_median", "value": median}, + {"name": "pixel_position_p95", "value": p95}, + {"name": "spacing_along_ratio_median", "value": along}, + {"name": "spacing_cross_ratio_median", "value": cross}, + ], + fixture_metrics={ + "sample_size_within_3pct": within, + "pixel_position_median": summarize(reduced[:, 3])["median"], + "spacing_along_ratio_median": fixture_along, + "spacing_cross_ratio_median": fixture_cross, }, ) @@ -566,7 +556,7 @@ def validate_swath(day, tle, entry, orbit, reference, write: bool, run: Run) -> def satellite_for(time_step: float): return entry.to_satellite( - orbit, run.swath, time_step=time_step, platform=run.platform + orbit, configuration=run.swath, time_step=time_step, platform=run.platform ) satellite = satellite_for(reference.scan_period) @@ -594,10 +584,11 @@ def satellite_for(time_step: float): if not write: return if run.transfer: - add_transfer_metrics( + write_transfer( RECORD_PATH, run.swath, - f"{run.platform}, {day:%Y-%m-%d}", + run.platform, + f"{day:%Y-%m-%d}", {name: results[name] for name in GATED}, ) return @@ -618,31 +609,25 @@ def satellite_for(time_step: float): passes=passes, scan_period=np.array(reference.scan_period), ) - update_record( + write_record( RECORD_PATH, - "viirs", + entry, run.swath, - { - "digest": entry.configurations[run.swath].digest, - "evidence": "rerun", - "tatc_version": tatc.__version__, - "source": source_of(__file__), - "reference": "VIIRS moderate-resolution geolocation", - "period": f"{day:%Y-%m-%d}", - "platform": run.platform, - "holdout_gap_days": get_holdout_gap(day, run.fit_day), - "metrics": [ - {"name": name, "value": float(results[name])} - for name in ( - "pass_recall", - "pass_precision", - "epoch_p95", - "swath_width_median", - "footprint_iou_median", - ) - ], - "fixture_metrics": recompute_passes(satellite, 0, day, passes), - }, + source=source_of(__file__), + reference="VIIRS moderate-resolution geolocation", + period=f"{day:%Y-%m-%d}", + platforms=[run.platform], + metrics=[ + {"name": name, "value": float(results[name])} + for name in ( + "pass_recall", + "pass_precision", + "epoch_p95", + "swath_width_median", + "footprint_iou_median", + ) + ], + fixture_metrics=recompute_passes(satellite, 0, day, passes), ) @@ -660,14 +645,14 @@ def main() -> None: arguments.directory.mkdir(parents=True, exist_ok=True) day = datetime.fromisoformat(arguments.day).replace(tzinfo=timezone.utc) - prefix = use_archive(arguments.platform) + archive = ARCHIVES[arguments.platform] directory = ( arguments.directory if arguments.platform == FIT_PLATFORM - else arguments.directory / prefix + else arguments.directory / archive.prefix ) directory.mkdir(parents=True, exist_ok=True) - reference = Reference(*load_day(day, directory)) + reference = Reference(*load_day(day, directory, archive)) if arguments.fit: fit(day, reference) return @@ -675,10 +660,9 @@ def main() -> None: run = Run( arguments.platform, *CONFIGURATIONS[fitted], - FIT_DAYS[fitted], fitted != arguments.platform, ) - tle = load_element_set(day, directory) + tle = archive.load_element_set(day, directory) orbit = GeneralPerturbationsOrbit.from_tle(tle) entry = get_entry("viirs") print( diff --git a/validation/catalog/validate_catalog_virs.py b/validation/catalog/validate_catalog_virs.py index eecb961c..c76bf120 100644 --- a/validation/catalog/validate_catalog_virs.py +++ b/validation/catalog/validate_catalog_virs.py @@ -57,7 +57,7 @@ FIXTURES, source_of, ) -from validate_catalog_trmm_pr import ELEMENT_SET_FILE, FIT_DAY, NORAD_ID +from validate_catalog_trmm_pr import ELEMENT_SET_FILE, NORAD_ID from validate_catalog_trmm_pr import PRODUCT as PR_PRODUCT SAMPLES = 261 @@ -117,7 +117,6 @@ def read_virs(_product, url: str, session, day: datetime, _directory) -> dict: "GPM_2APR version 07", published_reference="Footprint of the TRMM Version 7 README of GES DISC; sample " "positions of GPM_1BVIRS version 08", - fit_day=FIT_DAY, time_steps=(10, 30, 120), pass_radius=40, point_spacing=200e3, diff --git a/validation/catalog/validation_io.py b/validation/catalog/validation_io.py index bfea86af..b0eccf71 100644 --- a/validation/catalog/validation_io.py +++ b/validation/catalog/validation_io.py @@ -1,11 +1,13 @@ """ -Helpers shared by the scripts that validate catalog entries against NOAA-20 data: -reading the public archive, geometry, and scoring through public TAT-C methods. +Helpers shared by the scripts that validate catalog entries: reading the public +archives of the JPSS satellites, geometry, scoring through public TAT-C methods, +and writing validation records and test fixtures. @author: Paul T. Grogan """ import concurrent.futures +import dataclasses import io import json import pathlib @@ -29,19 +31,14 @@ compute_ground_track, compute_sample_sizes, ) -from tatc.catalog import STANDARD_VERSION +import tatc +from tatc.catalog import STANDARD_VERSION, InstrumentEntry +from tatc.catalog.schemas import ConfigurationRecord, Transfer, ValidationRecord from tatc.catalog.metrics import compute_mask_iou, compute_pass_scores, summarize from tatc.constants import EARTH_ROTATION_RATE, timescale from tatc.schemas import CircularOrbit, Point from tatc.utils import VelocityFrame, compute_projected_ray_position -# the archives of the JPSS satellites on NOAA Open Data Dissemination, by platform -ARCHIVES = { - "noaa-20": ("https://noaa-nesdis-n20-pds.s3.amazonaws.com/", "n20"), - "noaa-21": ("https://noaa-nesdis-n21-pds.s3.amazonaws.com/", "n21"), -} -BUCKET, ARCHIVE_PREFIX = ARCHIVES["noaa-20"] - # where the scripts read element sets and write validation records and test fixtures REPOSITORY = pathlib.Path(__file__).resolve().parents[2] ELEMENT_SET_FOLDER = pathlib.Path(__file__).resolve().parent / "elements" @@ -127,28 +124,6 @@ def post_with_retries(url: str, body: dict) -> requests.Response: raise RuntimeError("unreachable") -def list_keys(prefix: str) -> list[str]: - """Lists the keys of all objects in the archive with a prefix.""" - keys, token = [], None - while True: - params = {"list-type": "2", "prefix": prefix} - if token: - params["continuation-token"] = token - listing = get_with_retries(BUCKET, params=params).text - keys += re.findall(r"(.*?)", listing) - match = re.search( - r"(.*?)", listing - ) - if match is None: - return keys - token = match.group(1) - - -def fetch(key: str) -> bytes: - """Downloads an object of the archive.""" - return get_with_retries(BUCKET + key).content - - class RemoteFile(io.RawIOBase): """A read-only file of a URL, downloaded on demand with range requests.""" @@ -213,29 +188,57 @@ def readinto(self, buffer): return count -def use_archive(platform: str) -> str: +@dataclasses.dataclass(frozen=True) +class Archive: """ - Selects the archive of a JPSS satellite (NOAA-20 by default) from which objects - and element sets are read. Gets the prefix that distinguishes its cached files. + The archive of a JPSS satellite on NOAA Open Data Dissemination, from which + objects and element sets are read, with the prefix that distinguishes its + cached files. """ - global BUCKET, ARCHIVE_PREFIX # pylint: disable=global-statement - BUCKET, ARCHIVE_PREFIX = ARCHIVES[platform] - return ARCHIVE_PREFIX + url: str + prefix: str -def load_element_set(day: datetime, directory: pathlib.Path) -> list[str]: - """Gets the operational element set with an epoch at the start of a day.""" - path = directory / f"{ARCHIVE_PREFIX}_tle_{day:%Y%m%d}.txt" - if not path.exists(): - key = next( - k - for k in list_keys(f"TLE-AUX/{day:%Y/%m/%d}/") - if f"Z_{day:%Y%m%d}000000Z_" in k - ) - with h5py.File(io.BytesIO(fetch(key))) as f: - text = bytes(f["All_Data/TLE-AUX_All/Dataset_Array_0"][:]).decode() - path.write_text(text.strip() + "\n", encoding="utf-8") - return path.read_text(encoding="utf-8").splitlines() + def list_keys(self, prefix: str) -> list[str]: + """Lists the keys of all objects in the archive with a prefix.""" + keys, token = [], None + while True: + params = {"list-type": "2", "prefix": prefix} + if token: + params["continuation-token"] = token + listing = get_with_retries(self.url, params=params).text + keys += re.findall(r"(.*?)", listing) + match = re.search( + r"(.*?)", listing + ) + if match is None: + return keys + token = match.group(1) + + def fetch(self, key: str) -> bytes: + """Downloads an object of the archive.""" + return get_with_retries(self.url + key).content + + def load_element_set(self, day: datetime, directory: pathlib.Path) -> list[str]: + """Gets the operational element set with an epoch at the start of a day.""" + path = directory / f"{self.prefix}_tle_{day:%Y%m%d}.txt" + if not path.exists(): + key = next( + k + for k in self.list_keys(f"TLE-AUX/{day:%Y/%m/%d}/") + if f"Z_{day:%Y%m%d}000000Z_" in k + ) + with h5py.File(io.BytesIO(self.fetch(key))) as f: + text = bytes(f["All_Data/TLE-AUX_All/Dataset_Array_0"][:]).decode() + path.write_text(text.strip() + "\n", encoding="utf-8") + return path.read_text(encoding="utf-8").splitlines() + + +# the archives of the JPSS satellites, by platform +ARCHIVES = { + "noaa-20": Archive("https://noaa-nesdis-n20-pds.s3.amazonaws.com/", "n20"), + "noaa-21": Archive("https://noaa-nesdis-n21-pds.s3.amazonaws.com/", "n21"), +} def read_element_set_file( @@ -389,11 +392,6 @@ def in_lattice_cells(cells, is_next_contiguous, points, neighbors=2) -> np.ndarr return inside -def get_holdout_gap(day: datetime, fit_day: datetime) -> int | None: - """Gets the days from the fit to a day, to which the standard applies its gap.""" - return None if day == fit_day else abs((day - fit_day).days) - - def to_observations(satellite, instruments, epochs, lon, lat) -> gpd.GeoDataFrame: """Builds observations of points by named instruments of a satellite.""" return gpd.GeoDataFrame( @@ -418,7 +416,7 @@ def compute_published_errors(entry, key: str, footprints) -> np.ndarray: orbit = CircularOrbit( altitude=altitude * 1e3, inclination=inclination, epoch=PUBLISHED_EPOCH ) - satellite = entry.to_satellite(orbit, key) + satellite = entry.to_satellite(orbit, configuration=key) time = PUBLISHED_EPOCH + timedelta(minutes=10) target = compute_projected_ray_position( orbit.to_gp_orbit().get_orbit_track(time), @@ -667,28 +665,70 @@ def update_fixture(path: pathlib.Path, **arrays) -> None: np.savez_compressed(path, **add_earth_orientation({**existing, **arrays}, arrays)) -def update_record(path: pathlib.Path, entry_id: str, key: str, results: dict) -> None: - """Writes the results of a configuration to a record, keeping the others.""" - record = {"entry_id": entry_id, "configurations": {}} +def _read_record(path: pathlib.Path, entry_id: str) -> dict: + """Reads a record, or starts one.""" if path.exists(): - record = json.loads(path.read_text(encoding="utf-8")) - record["standard_version"] = STANDARD_VERSION - record["configurations"][key] = results - path.write_text(json.dumps(record, indent=2) + "\n", encoding="utf-8") + return json.loads(path.read_text(encoding="utf-8")) + return {"entry_id": entry_id, "configurations": {}} + + +def _write_record(path: pathlib.Path, record: dict) -> None: + """Checks a record against its schema and writes it.""" + checked = ValidationRecord(**record).model_dump(mode="json", exclude_none=True) + path.write_text(json.dumps(checked, indent=2) + "\n", encoding="utf-8") + + +def write_record( + path: pathlib.Path, + entry: InstrumentEntry, + key: str, + *, + source: str, + reference: str, + period: str, + platforms: list[str], + metrics: list[dict], + fixture_metrics: dict[str, float] | None = None, +) -> None: + """ + Writes the results of a configuration to its entry's record, keeping those of + the others, with the configuration's digest and the versions of TAT-C and of + the standard. Its transfers are kept if the configuration is unchanged. + """ + record = _read_record(path, entry.id) + digest = entry.configurations[key].digest + previous = record["configurations"].get(key, {}) + record["configurations"][key] = ConfigurationRecord( + digest=digest, + standard_version=STANDARD_VERSION, + tatc_version=tatc.__version__, + source=source, + reference=reference, + period=period, + platforms=platforms, + metrics=metrics, + transfers=( + previous.get("transfers", {}) if previous.get("digest") == digest else {} + ), + fixture_metrics=fixture_metrics or {}, + ).model_dump(mode="json", exclude_none=True) + _write_record(path, record) -def add_transfer_metrics( - path: pathlib.Path, key: str, scope: str, values: dict[str, float] +def write_transfer( + path: pathlib.Path, + key: str, + platform: str, + period: str, + values: dict[str, float], ) -> None: """ - Adds results of a configuration on a platform on which it was not fitted. Their - names differ from those of the gates, so that they do not count as validation. + Writes the results of a configuration on a platform on which it was not + tested, which do not count toward its validation, to its record. """ record = json.loads(path.read_text(encoding="utf-8")) - metrics = record["configurations"][key]["metrics"] - metrics[:] = [m for m in metrics if m.get("scope") != scope] - metrics += [ - {"name": f"transfer_{name}", "value": float(value), "scope": scope} - for name, value in values.items() - ] - path.write_text(json.dumps(record, indent=2) + "\n", encoding="utf-8") + record["configurations"][key]["transfers"][platform] = Transfer( + period=period, + metrics=[{"name": name, "value": float(v)} for name, v in values.items()], + ).model_dump(mode="json", exclude_none=True) + _write_record(path, record) From 6aa29f7bd89d9fb788ce43075266b8c35a6c1c01 Mon Sep 17 00:00:00 2001 From: Paul Grogan Date: Sun, 15 Nov 2026 09:16:05 -0700 Subject: [PATCH 4/8] list every gap of an entry (missing grades and each configuration's, with evidence gaps apart from gates), build satellites from payloads (InstrumentPayload.to_satellite), write records and transfers by entry (refusing transfers to stale records, keeping scopes), key class versions by class, drop Configuration.is_fitted, and require a grouping only for several instruments --- CHANGELOG.md | 2 +- docs/api_reference/catalog.rst | 4 + docs/examples/UseInstrumentCatalog.ipynb | 4 +- docs/validation/catalog_page.py | 19 ++- src/tatc/catalog/schemas.py | 129 ++++++++++++------ src/tatc/catalog/standard.py | 38 +++--- src/tatc/tradespace/constellations.py | 7 +- tests/catalog/test_entries.py | 37 ++++- tests/catalog/test_standard.py | 22 +++ tests/catalog/test_tilt_schedule.py | 2 +- .../catalog/compare_swath_time_steps.py | 11 +- validation/catalog/earthcare_io.py | 4 +- validation/catalog/gesdisc_scanner.py | 15 +- validation/catalog/validate_catalog_abi.py | 4 +- validation/catalog/validate_catalog_ahi.py | 6 +- validation/catalog/validate_catalog_airs.py | 4 +- validation/catalog/validate_catalog_amsr2.py | 5 +- validation/catalog/validate_catalog_amsua.py | 4 +- validation/catalog/validate_catalog_ascat.py | 5 +- validation/catalog/validate_catalog_atlas.py | 5 +- validation/catalog/validate_catalog_atlid.py | 3 - validation/catalog/validate_catalog_atms.py | 18 +-- validation/catalog/validate_catalog_avhrr.py | 4 +- validation/catalog/validate_catalog_bbr.py | 5 +- validation/catalog/validate_catalog_ceres.py | 4 +- validation/catalog/validate_catalog_cpr.py | 3 - validation/catalog/validate_catalog_cris.py | 18 +-- validation/catalog/validate_catalog_csar.py | 19 +-- validation/catalog/validate_catalog_dpr.py | 4 +- .../catalog/validate_catalog_earthcare_msi.py | 4 +- .../catalog/validate_catalog_ecostress.py | 4 +- validation/catalog/validate_catalog_emit.py | 5 +- validation/catalog/validate_catalog_gedi.py | 5 +- validation/catalog/validate_catalog_gmi.py | 5 +- validation/catalog/validate_catalog_harp2.py | 4 +- validation/catalog/validate_catalog_iasi.py | 6 - validation/catalog/validate_catalog_karin.py | 5 +- validation/catalog/validate_catalog_lsar.py | 4 - validation/catalog/validate_catalog_mhs.py | 4 +- validation/catalog/validate_catalog_modis.py | 18 +-- validation/catalog/validate_catalog_msi.py | 4 - validation/catalog/validate_catalog_oci.py | 4 +- validation/catalog/validate_catalog_oco2.py | 5 +- validation/catalog/validate_catalog_olci.py | 4 +- validation/catalog/validate_catalog_oli.py | 10 +- validation/catalog/validate_catalog_omps.py | 4 +- .../catalog/validate_catalog_poseidon4.py | 12 +- validation/catalog/validate_catalog_smap.py | 6 +- .../catalog/validate_catalog_spexone.py | 4 +- validation/catalog/validate_catalog_ssmis.py | 5 +- validation/catalog/validate_catalog_tempo.py | 5 +- validation/catalog/validate_catalog_tmi.py | 6 +- .../catalog/validate_catalog_trmm_pr.py | 4 +- .../catalog/validate_catalog_tropomi.py | 4 - validation/catalog/validate_catalog_viirs.py | 18 +-- validation/catalog/validate_catalog_virs.py | 4 +- validation/catalog/validation_io.py | 65 ++++++--- 57 files changed, 305 insertions(+), 328 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index b098913c..3689a4e6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,7 +5,7 @@ Added a catalog of instruments from past and present missions, with a standard for validating them. Fixed instruments losing their fields when serialized. Instruments now reject unknown fields, which can break code that passes misspelled or unused arguments. Added: - - Module `catalog` of instruments from past and present missions (`get_entry`, `list_entries`, with the schemas of entries and records in `catalog.schemas` and the standard in `catalog.standard`), starting with GOES-R ABI, GPM GMI, GCOM-W AMSR2, ATMS, CrIS, VIIRS, MODIS, Landsat OLI, Sentinel-2 MSI, Sentinel-1 C-SAR, NISAR L-SAR, SWOT KaRIn, the SMAP radiometer, IASI, Sentinel-5P TROPOMI, GPM DPR, MHS, ICESat-2 ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, Sentinel-3 OLCI, PACE OCI, HARP2, and SPEXone, the OMPS Nadir Mapper, Himawari AHI, CERES, ECOSTRESS, OCO-2, the Sentinel-6 Poseidon-4 altimeter, Metop ASCAT, TEMPO, GEDI, EMIT, EarthCARE ATLID, BBR, CPR, and MSI, and TRMM PR, TMI, and VIRS. `InstrumentEntry.to_satellite` and `build` give an entry's instruments with the attitude they were validated with, and the `instrument_index` to analyze them with (`None` for the parts of one view); the platform modeled (`platform`) selects the configuration tested on it, and a grade (`grade`) one for its use (`select_configuration`). `catalog.build_payload` gives the instruments of several configurations (such as `"atms:swath_noaa_20"`) carried together, which must share an attitude. `InstrumentEntry.validation` gives its validation tier, computed from its results and the thresholds of the validation standard (`docs/validation/standard.rst`): each configuration's record states the version of the standard of its test, and the gap between the data of its fitted values and of its test (`holdout_gap_days`) is computed from the periods of each, which provenance and records state. GMI, ATMS, VIIRS, MODIS, OLI, MSI, KaRIn, TROPOMI, DPR, MHS, HARP2, SPEXone, Poseidon-4, ASCAT, TEMPO, TMI, VIRS, and EarthCARE's MSI are `validated`, each with stated limitations, and ABI, AMSR2, CrIS, C-SAR, L-SAR, the SMAP radiometer, IASI, ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, OLCI, OCI, OMPS, AHI, CERES, ECOSTRESS, OCO-2, GEDI, EMIT, ATLID, BBR, CPR, and TRMM PR are `partial` and list their gaps. Results on sibling satellites (NOAA-21, Metop-B, Aqua, Landsat 8, Sentinel-1D, Sentinel-6B) are recorded as transfers (`ConfigurationRecord.transfers`), which warn on use and do not count toward a tier; ATMS and VIIRS also have configurations fitted on NOAA-21, validated on held-out data, as NOAA-20's angles did not transfer. In an entry with configurations fitted on more than one platform (ATMS, VIIRS, and the OMPS Nadir Mapper), each configuration's name ends with its platform (`swath_noaa_20`, `swath_noaa_21`). Version 2 of the standard adds a lidar class, for ATLAS, version 3 an altimeter class, for Poseidon-4, version 4 a scatterometer class, for ASCAT, with the gates of the SAR class, version 5 a regional geostationary class, for TEMPO, whose gate is the intersection over union of the field of regard with the area a scan images, and version 6 a profiler class, for ATLID and CPR, with the gates of the altimeter class; none changes a threshold of an earlier version. Every pointed configuration with a view tailored to the time step is swept (`is_swept`), so its swaths do not depend on the time step; its records were rescored with swept swaths on the same held-out data, and MSI, TROPOMI, DPR, OCI's swath, and C-SAR's EW mode, whose tiers changed, were tested again on a later held-out day, with the rescored results stated in their limitations. The documentation lists the entries and their results on a page written from the catalog (`docs/validation/catalog_page.py`), and the example `UseInstrumentCatalog` shows their use. The OSSE examples `RunOSSEMonsoon` and `RunOSSEHurricane` take their ATMS and CrIS swaths from the catalog. The scripts that validate the entries and write their records are in `validation/catalog` of the repository, with the element sets they read. Each script of an entry with fitted values measures them with `--fit`, including those of CrIS, AMSR2, GMI, MODIS, and the SMAP radiometer, which their validation notebooks previously measured. + - Module `catalog` of instruments from past and present missions (`get_entry`, `list_entries`, with the schemas of entries and records in `catalog.schemas` and the standard in `catalog.standard`), starting with GOES-R ABI, GPM GMI, GCOM-W AMSR2, ATMS, CrIS, VIIRS, MODIS, Landsat OLI, Sentinel-2 MSI, Sentinel-1 C-SAR, NISAR L-SAR, SWOT KaRIn, the SMAP radiometer, IASI, Sentinel-5P TROPOMI, GPM DPR, MHS, ICESat-2 ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, Sentinel-3 OLCI, PACE OCI, HARP2, and SPEXone, the OMPS Nadir Mapper, Himawari AHI, CERES, ECOSTRESS, OCO-2, the Sentinel-6 Poseidon-4 altimeter, Metop ASCAT, TEMPO, GEDI, EMIT, EarthCARE ATLID, BBR, CPR, and MSI, and TRMM PR, TMI, and VIRS. `InstrumentEntry.to_satellite` and `build` give an entry's instruments with the attitude they were validated with, and `build` also the `instrument_index` to analyze them with (`None` for the parts of one view), with `to_satellite` of its payload; the platform modeled (`platform`) selects the configuration tested on it, and a grade (`grade`) one for its use (`select_configuration`). `catalog.build_payload` gives the instruments of several configurations (such as `"atms:swath_noaa_20"`) carried together, which must share an attitude. `InstrumentEntry.validation` gives its validation tier and every gap (`gaps`, including those of each configuration), computed from its results and the thresholds of the validation standard (`docs/validation/standard.rst`): each configuration's record states the version of the standard of its test, and the gap between the data of its fitted values and of its test (`holdout_gap_days`) is computed from the periods of each, which provenance and records state. GMI, ATMS, VIIRS, MODIS, OLI, MSI, KaRIn, TROPOMI, DPR, MHS, HARP2, SPEXone, Poseidon-4, ASCAT, TEMPO, TMI, VIRS, and EarthCARE's MSI are `validated`, each with stated limitations, and ABI, AMSR2, CrIS, C-SAR, L-SAR, the SMAP radiometer, IASI, ATLAS, AIRS, AMSU-A, AVHRR, SSMIS, OLCI, OCI, OMPS, AHI, CERES, ECOSTRESS, OCO-2, GEDI, EMIT, ATLID, BBR, CPR, and TRMM PR are `partial` and list their gaps. Results on sibling satellites (NOAA-21, Metop-B, Aqua, Landsat 8, Sentinel-1D, Sentinel-6B) are recorded as transfers (`ConfigurationRecord.transfers`), which warn on use and do not count toward a tier; ATMS and VIIRS also have configurations fitted on NOAA-21, validated on held-out data, as NOAA-20's angles did not transfer. In an entry with configurations fitted on more than one platform (ATMS, VIIRS, and the OMPS Nadir Mapper), each configuration's name ends with its platform (`swath_noaa_20`, `swath_noaa_21`). Version 2 of the standard adds a lidar class, for ATLAS, version 3 an altimeter class, for Poseidon-4, version 4 a scatterometer class, for ASCAT, with the gates of the SAR class, version 5 a regional geostationary class, for TEMPO, whose gate is the intersection over union of the field of regard with the area a scan images, and version 6 a profiler class, for ATLID and CPR, with the gates of the altimeter class; none changes a threshold of an earlier version. Every pointed configuration with a view tailored to the time step is swept (`is_swept`), so its swaths do not depend on the time step; its records were rescored with swept swaths on the same held-out data, and MSI, TROPOMI, DPR, OCI's swath, and C-SAR's EW mode, whose tiers changed, were tested again on a later held-out day, with the rescored results stated in their limitations. The documentation lists the entries and their results on a page written from the catalog (`docs/validation/catalog_page.py`), and the example `UseInstrumentCatalog` shows their use. The OSSE examples `RunOSSEMonsoon` and `RunOSSEHurricane` take their ATMS and CrIS swaths from the catalog. The scripts that validate the entries and write their records are in `validation/catalog` of the repository, with the element sets they read; a transfer is written only to the record of the configuration as cataloged. Each script of an entry with fitted values measures them with `--fit`, including those of CrIS, AMSR2, GMI, MODIS, and the SMAP radiometer, which their validation notebooks previously measured. - Class `catalog.schemas.TiltSchedule` and field `tilt_schedule` of catalog configurations, for an attitude that changes by day, as PACE's tilt does: `build` and `to_satellite` take the `start` and `end` of the analysis and give an `AttitudeSchedule` with an attitude for each day (UTC), blind while the tilt changes. Utility methods `compute_subsolar_latitude` and `compute_ascending_argument_of_latitude`. - Field `type` of a catalog configuration's `attitude` (`attitude`, `glint`, or `target`), which builds an `Attitude`, `GlintAttitude`, or `TargetAttitude`, as for OCO-2's glint mode. - Field `blind_intervals` of `Attitude`: intervals of argument of latitude in which a space system's instruments do not observe, for example while the body or a mechanism moves. Observations in them are not valid, so point observations, ground tracks (`valid_obs`, and the swaths of `compute_ground_track`), orbit tracks, and ground pixels omit them, and the periods and swaths of region observations end at them. Method `is_observing` of attitudes, schedules, and instruments. diff --git a/docs/api_reference/catalog.rst b/docs/api_reference/catalog.rst index 4e978684..9a3e6f93 100644 --- a/docs/api_reference/catalog.rst +++ b/docs/api_reference/catalog.rst @@ -19,6 +19,7 @@ Entries .. autopydantic_model:: tatc.catalog.InstrumentEntry .. autoclass:: tatc.catalog.InstrumentPayload + :members: Validation Status ----------------- @@ -26,10 +27,13 @@ Validation Status See :doc:`/validation/standard`. .. autoclass:: tatc.catalog.EntryValidation + :members: .. autoclass:: tatc.catalog.ConfigurationValidation + :members: .. autoclass:: tatc.catalog.GateResult + :members: .. autoclass:: tatc.catalog.Tier :members: diff --git a/docs/examples/UseInstrumentCatalog.ipynb b/docs/examples/UseInstrumentCatalog.ipynb index bf328f39..33797160 100644 --- a/docs/examples/UseInstrumentCatalog.ipynb +++ b/docs/examples/UseInstrumentCatalog.ipynb @@ -12,7 +12,7 @@ "Each entry also states how well it was tested. Its *tier* is computed from its results and the thresholds of the [validation standard](../validation/standard.rst):\n", "\n", "* `validated`: every test of the standard passed, with fitted values tested on data at least 30 days from their fitting data;\n", - "* `partial`: some tests failed or are missing, and the entry lists each gap;\n", + "* `partial`: some tests failed or are missing, and the entry lists each gap (`validation.gaps`);\n", "* `nominal`: published values only.\n", "\n", "Every entry, including a validated one, has limitations, listed with its configurations. The [instrument catalog](../validation/catalog.rst) lists the entries and their results." @@ -1241,7 +1241,7 @@ "source": [ "## Multiple Instruments\n", "\n", - "Some configurations have several instruments. `build` returns the instruments with the attitude and the `instrument_index` to analyze them with, without building a satellite: `None` for instruments that together form the swath, as TROPOMI's views, or the index of the view to analyze of alternative views, analyzed one at a time. Its `references` name the configuration built." + "Some configurations have several instruments. `build` returns the instruments with the attitude and the `instrument_index` to analyze them with, without building a satellite: `None` for instruments that together form the swath, as TROPOMI's views, or the index of the view to analyze of alternative views, analyzed one at a time. Its `references` name the configuration built, and its `to_satellite` builds a satellite that carries the instruments." ] }, { diff --git a/docs/validation/catalog_page.py b/docs/validation/catalog_page.py index 21a7e398..973741a6 100644 --- a/docs/validation/catalog_page.py +++ b/docs/validation/catalog_page.py @@ -221,15 +221,11 @@ def render_configuration(entry, key: str) -> str: f"Every result, including those not gated, is in the record " f"`{entry.id}.json <{REPOSITORY}{path}>`_.\n" ) - gated = {result.gate.metric for result in validation.gates} - gaps = [ - text - for text in validation.gaps - if not any(text.startswith(f"{metric}:") for metric in gated) - ] - if gaps: + if validation.evidence_gaps: parts.append("Other gaps:\n") - parts.append("\n".join(f"* {escape(text)}" for text in gaps) + "\n") + parts.append( + "\n".join(f"* {escape(text)}" for text in validation.evidence_gaps) + "\n" + ) if configuration.limitations: parts.append("Limitations:\n") parts.append( @@ -281,10 +277,13 @@ def render_entry(entry) -> str: ) + ".\n" ) - if validation.gaps: + if validation.missing_grades: parts.append( "Gaps of the entry:\n\n" - + "\n".join(f"* {escape(text)}" for text in validation.gaps) + + "\n".join( + f"* no configuration at the {grade.value} grade" + for grade in validation.missing_grades + ) + "\n" ) if entry.limitations: diff --git a/src/tatc/catalog/schemas.py b/src/tatc/catalog/schemas.py index c1663a4f..90fd7a50 100644 --- a/src/tatc/catalog/schemas.py +++ b/src/tatc/catalog/schemas.py @@ -503,11 +503,11 @@ class Configuration(_CatalogModel): description="The index of the instrument to analyze by default, of " + "`alternatives`.", ) - grouping: Literal["single", "union", "alternatives"] = Field( - default="single", + grouping: Literal["union", "alternatives"] | None = Field( + default=None, description="How multiple instruments relate: `union`, parts of one " + "view that are analyzed together; or `alternatives`, separately valid " - + "views that are analyzed one at a time.", + + "views that are analyzed one at a time. Only for multiple instruments.", ) limitations: tuple[str, ...] = Field( default=(), description="What this configuration does not represent." @@ -523,8 +523,8 @@ def _check_instruments(self) -> "Configuration": raise ValueError("instrument_index is out of range") if self.instrument_index and self.grouping != "alternatives": raise ValueError("only alternatives have an instrument_index") - if (self.grouping == "single") != (len(self.instruments) == 1): - raise ValueError("grouping is `single` only for one instrument") + if (self.grouping is None) != (len(self.instruments) == 1): + raise ValueError("multiple instruments, and only they, need a grouping") self.make_attitude() if self.tilt_schedule is not None and { "pitch_angle", @@ -563,13 +563,6 @@ def _get_measured(self) -> list[Provenance]: provenance for provenance in provenances if provenance.kind == "measured" ] - @property - def is_fitted(self) -> bool: - """ - Whether any parameter was fitted to reference data. - """ - return bool(self._get_measured()) - def get_holdout_gap(self, period: str) -> int | None: """ Gets the days between the data to which values were fitted and the data @@ -740,31 +733,75 @@ def passed(self) -> bool | None: """ return None if self.value is None else self.gate.is_met(self.value) + @property + def gap(self) -> str | None: + """ + The gap, if the gate failed or was not tested. + """ + if self.value is None: + return f"{self.gate.metric}: not tested" + if not self.passed: + return ( + f"{self.gate.metric}: {self.value} fails the limit of " + f"{self.gate.limit}" + ) + return None + @dataclass(frozen=True) class ConfigurationValidation: """ - The validation status of a configuration. Its `holdout_gap_days` are the - days between the data to which its values were fitted and the data of its - test, or `None` if it has no fitted values or no test. + The validation status of a configuration: the results of its gates, and its + `evidence_gaps`, of its test rather than of a gate (such as a configuration + that changed after it was tested). Its `holdout_gap_days` are the days + between the data to which its values were fitted and the data of its test, + or `None` if it has no fitted values or no test. """ tier: Tier gates: tuple[GateResult, ...] - gaps: tuple[str, ...] + evidence_gaps: tuple[str, ...] record: ConfigurationRecord | None holdout_gap_days: int | None = None + @property + def gaps(self) -> tuple[str, ...]: + """ + Every gap: of failed gates, then of untested gates, then of evidence. + """ + return ( + *(r.gap for r in self.gates if r.passed is False), + *(r.gap for r in self.gates if r.passed is None), + *self.evidence_gaps, + ) + @dataclass(frozen=True) class EntryValidation: """ - The validation status of an entry, computed from its records and the standard. + The validation status of an entry, computed from its records and the + standard: of each configuration, and the grades of its class that no + configuration serves (`missing_grades`). """ tier: Tier configurations: dict[str, ConfigurationValidation] - gaps: tuple[str, ...] + missing_grades: tuple[Grade, ...] + + @property + def gaps(self) -> tuple[str, ...]: + """ + Every gap: of missing grades, then of each configuration, after its + identifier (such as `"swath: epoch_p95: not tested"`). + """ + return ( + *(f"no configuration at the {g.value} grade" for g in self.missing_grades), + *( + f"{key}: {gap}" + for key, validation in self.configurations.items() + for gap in validation.gaps + ), + ) @dataclass(frozen=True) @@ -785,6 +822,22 @@ class InstrumentPayload: """Whether a configuration was not tested on the platform modeled.""" limitations: tuple[str, ...] + def to_satellite(self, name: str, orbit: AllOrbits) -> Satellite: + """ + Builds a satellite that carries the instruments with their attitude. + Analyze it with the `instrument_index` of this payload. + + Args: + name (str): The satellite's name. + orbit (AllOrbits): The orbit. + + Returns: + Satellite: The satellite. + """ + return Satellite( + name=name, orbit=orbit, instruments=self.instruments, attitude=self.attitude + ) + class InstrumentEntry(_CatalogModel): """ @@ -872,17 +925,7 @@ def _evaluate_configuration(self, key: str) -> ConfigurationValidation: values = [m.value for m in record.metrics if m.name == gate.metric] worst = (max if gate.at_most else min)(values) if values else None results.append(GateResult(gate, worst)) - gaps = [ - f"{result.gate.metric}: {result.value} fails the limit of " - f"{result.gate.limit}" - for result in results - if result.passed is False - ] - gaps += [ - f"{result.gate.metric}: not tested" - for result in results - if result.passed is None - ] + gaps = [] if record.digest != configuration.digest: gaps.append("the configuration changed after it was tested") if not is_compatible(self.instrument_class, record.standard_version): @@ -896,8 +939,9 @@ def _evaluate_configuration(self, key: str) -> ConfigurationValidation: "fitted values are not tested on data at least " f"{MIN_HOLDOUT_GAP_DAYS} days from their fitting data" ) + passed = not gaps and all(result.passed for result in results) return ConfigurationValidation( - Tier.PARTIAL if gaps else Tier.VALIDATED, + Tier.VALIDATED if passed else Tier.PARTIAL, tuple(results), tuple(gaps), record, @@ -914,19 +958,19 @@ def validation(self) -> EntryValidation: configurations = { key: self._evaluate_configuration(key) for key in self.configurations } - gaps = [ - f"no configuration at the {grade.value} grade" + missing = tuple( + grade for grade in get_required_grades(self.instrument_class) if not any(c.serves(grade) for c in self.configurations.values()) - ] + ) tier = min((c.tier for c in configurations.values()), key=lambda t: t.rank) - if tier == Tier.VALIDATED and gaps: + if tier == Tier.VALIDATED and missing: tier = Tier.PARTIAL if tier == Tier.NOMINAL and any( c.tier != Tier.NOMINAL for c in configurations.values() ): tier = Tier.PARTIAL - return EntryValidation(tier, configurations, tuple(gaps)) + return EntryValidation(tier, configurations, missing) def select_configuration( self, @@ -1137,8 +1181,9 @@ def to_satellite( ) -> Satellite: """ Builds a satellite that carries the instruments of a configuration (see - `build`). Analyze it with the `instrument_index` of `build`, which is 0 - for a configuration of one instrument. + `build`). For several instruments, `build(...).to_satellite(name, orbit)` + also gives the `instrument_index` to analyze them with, which is 0 for + one instrument. Args: orbit (AllOrbits): The orbit. @@ -1160,7 +1205,7 @@ def to_satellite( Returns: Satellite: The satellite. """ - payload = self.build( + return self.build( configuration=configuration, grade=grade, orbit=orbit, @@ -1169,10 +1214,4 @@ def to_satellite( platform=platform, start=start, end=end, - ) - return Satellite( - name=self.name if name is None else name, - orbit=orbit, - instruments=payload.instruments, - attitude=payload.attitude, - ) + ).to_satellite(self.name if name is None else name, orbit) diff --git a/src/tatc/catalog/standard.py b/src/tatc/catalog/standard.py index 8c172f36..2f57450b 100644 --- a/src/tatc/catalog/standard.py +++ b/src/tatc/catalog/standard.py @@ -17,26 +17,11 @@ """The version of the thresholds in `get_gates`.""" _LAST_THRESHOLD_CHANGE = 1 -# the version of the standard that added each class's gates -_CLASS_VERSIONS = { - "cross_track": 1, - "pushbroom": 1, - "conical": 1, - "sar": 1, - "geostationary": 1, - "lidar": 2, - "altimeter": 3, - "scatterometer": 4, - "geostationary_regional": 5, - "profiler": 6, -} COMPATIBLE_VERSIONS = tuple(range(_LAST_THRESHOLD_CHANGE, STANDARD_VERSION + 1)) """ Versions whose results still apply, as no threshold changed after the first: -version 2 only added the lidar class, version 3 the altimeter class, version 4 -the scatterometer class, version 5 the regional geostationary class, and -version 6 the profiler class. +later versions only added classes (see `is_compatible`). """ MIN_HOLDOUT_GAP_DAYS = 30 @@ -60,6 +45,21 @@ class InstrumentClass(str, Enum): PROFILER = "profiler" +# the version of the standard that added each class's gates +_CLASS_VERSIONS: dict[InstrumentClass, int] = { + InstrumentClass.CROSS_TRACK: 1, + InstrumentClass.PUSHBROOM: 1, + InstrumentClass.CONICAL: 1, + InstrumentClass.SAR: 1, + InstrumentClass.GEOSTATIONARY: 1, + InstrumentClass.LIDAR: 2, + InstrumentClass.ALTIMETER: 3, + InstrumentClass.SCATTEROMETER: 4, + InstrumentClass.GEOSTATIONARY_REGIONAL: 5, + InstrumentClass.PROFILER: 6, +} + + class Grade(str, Enum): """ Enumeration of the uses for which a configuration is validated. @@ -231,7 +231,9 @@ def get_required_grades(instrument_class: InstrumentClass) -> tuple[Grade, ...]: def is_compatible(instrument_class: InstrumentClass, version: int) -> bool: """ Checks whether results tested under a version of the standard apply to a - class: the version is compatible and has the class's gates. + class: the version is compatible and has the class's gates. Version 2 added + the lidar class, 3 the altimeter class, 4 the scatterometer class, 5 the + regional geostationary class, and 6 the profiler class. Args: instrument_class (InstrumentClass): The class of the instrument. @@ -242,5 +244,5 @@ def is_compatible(instrument_class: InstrumentClass, version: int) -> bool: """ return ( version in COMPATIBLE_VERSIONS - and version >= _CLASS_VERSIONS[InstrumentClass(instrument_class).value] + and version >= _CLASS_VERSIONS[InstrumentClass(instrument_class)] ) diff --git a/src/tatc/tradespace/constellations.py b/src/tatc/tradespace/constellations.py index 18a11718..c1efc875 100644 --- a/src/tatc/tradespace/constellations.py +++ b/src/tatc/tradespace/constellations.py @@ -1177,12 +1177,9 @@ def _make_satellite( # pylint: disable=import-outside-toplevel from ..catalog import build_payload - built = build_payload( + return build_payload( payloads, orbit=orbit, time_step=time_step, start=start, end=end - ) - return Satellite( - name=name, orbit=orbit, instruments=built.instruments, attitude=built.attitude - ) + ).to_satellite(name, orbit) def _plane_orbits( diff --git a/tests/catalog/test_entries.py b/tests/catalog/test_entries.py index 094cdde7..914fb7a1 100644 --- a/tests/catalog/test_entries.py +++ b/tests/catalog/test_entries.py @@ -664,7 +664,10 @@ def test_grouping_needs_instruments(self): """ Test that one instrument cannot be a group, nor several ungrouped. """ - self.feeds["grouping"] = "single" + del self.feeds["grouping"] + self._assert_invalid() + self.feeds["grouping"] = "union" + self.feeds["instruments"] = self.feeds["instruments"][:1] self._assert_invalid() @@ -689,6 +692,10 @@ def test_payload(self): self.assertEqual(payload.references, ("gmi:feeds",)) self.assertFalse(payload.transferred) self.assertTrue(any("flies backward" in l for l in payload.limitations)) + satellite = payload.to_satellite("GPM", self.orbit) + self.assertEqual(satellite.name, "GPM") + self.assertEqual(satellite.instruments, payload.instruments) + self.assertEqual(satellite.attitude, payload.attitude) def test_tailored_field_of_view(self): """ @@ -873,7 +880,13 @@ def test_status(self): with self.subTest(entry_id): validation = get_entry(entry_id).validation self.assertEqual(validation.tier.value, tier) - self.assertEqual(list(validation.gaps), gaps) + self.assertEqual( + [ + f"no configuration at the {grade.value} grade" + for grade in validation.missing_grades + ], + gaps, + ) self.assertEqual(set(validation.configurations), set(configurations)) for key, (c_tier, holdout, c_gaps) in configurations.items(): configuration = validation.configurations[key] @@ -896,13 +909,31 @@ def test_atms_noaa21_models_yaw(self): for key in ("swath_noaa_20", "beams_noaa_20"): self.assertEqual(entry.configurations[key].attitude, {}, key) + def test_entry_lists_every_gap(self): + """ + Test that an entry's gaps include those of its configurations, after their + identifiers, so that a partial entry states why. + """ + validation = get_entry("lsar").validation + self.assertEqual(validation.tier.value, "partial") + self.assertEqual(validation.missing_grades, ()) + self.assertEqual( + list(validation.gaps), + [ + f"{key}: {gap}" + for key, configuration in validation.configurations.items() + for gap in configuration.gaps + ], + ) + self.assertTrue(validation.gaps) + def test_mhs_has_no_fitted_values(self): """ Test that the MHS entry, whose values are all published, needs no holdout. """ entry = get_entry("mhs") for configuration in entry.configurations.values(): - self.assertFalse(configuration.is_fitted) + self.assertIsNone(configuration.get_holdout_gap("2000-01-01")) def test_oco2_glint_builds_glint_attitude(self): """ diff --git a/tests/catalog/test_standard.py b/tests/catalog/test_standard.py index a718ab46..dffb81f6 100644 --- a/tests/catalog/test_standard.py +++ b/tests/catalog/test_standard.py @@ -197,6 +197,24 @@ def test_compatible_versions(self): is_compatible(InstrumentClass.CROSS_TRACK, STANDARD_VERSION + 1) ) + def test_every_class_is_defined(self): + """ + Test that every class has the version of the standard that added it and + gates at its required grades, so that adding a class misses neither. + """ + for instrument_class in InstrumentClass: + with self.subTest(instrument_class.value): + self.assertTrue( + any( + is_compatible(instrument_class, version) + for version in COMPATIBLE_VERSIONS + ) + ) + grades = get_required_grades(instrument_class) + self.assertIn(Grade.COVERAGE, grades) + for grade in grades: + self.assertTrue(get_gates(instrument_class, grade)) + def test_tier_rank(self): """ Test that tiers rank from weakest to strongest. @@ -350,6 +368,10 @@ def test_failed_gate_is_partial(self): self.assertEqual(validation.tier, Tier.PARTIAL) self.assertIs(validation.configurations["c"].gates[0].passed, False) self.assertIn("0.6", validation.configurations["c"].gaps[0]) + self.assertEqual(validation.configurations["c"].evidence_gaps, ()) + self.assertEqual( + validation.gaps, ("c: " + validation.configurations["c"].gaps[0],) + ) def test_gate_limit_inclusive(self): """ diff --git a/tests/catalog/test_tilt_schedule.py b/tests/catalog/test_tilt_schedule.py index 6713ebe4..f3aeeefb 100644 --- a/tests/catalog/test_tilt_schedule.py +++ b/tests/catalog/test_tilt_schedule.py @@ -281,7 +281,7 @@ def test_schedule_is_fitted_and_digested(self): that changing a value of the schedule changes the digest. """ configuration = self.entry.configurations["swath"] - self.assertTrue(configuration.is_fitted) + self.assertIsNotNone(configuration.get_holdout_gap("2000-01-01")) changed = configuration.model_copy( update={ "tilt_schedule": configuration.tilt_schedule.model_copy( diff --git a/validation/catalog/compare_swath_time_steps.py b/validation/catalog/compare_swath_time_steps.py index 88cdb241..661bec3a 100644 --- a/validation/catalog/compare_swath_time_steps.py +++ b/validation/catalog/compare_swath_time_steps.py @@ -74,14 +74,15 @@ def get_fixture( def get_swath(entry, key, orbit, platform, day, start, step, swept): """Gets the swath of a configuration over a segment at a time step.""" - satellite = entry.to_satellite( - orbit, + payload = entry.build( configuration=key, + orbit=orbit, time_step=step, platform=platform, start=day, end=day + timedelta(days=1), ) + satellite = payload.to_satellite(entry.name, orbit) if not swept: satellite = satellite.model_copy( update={ @@ -95,11 +96,9 @@ def get_swath(entry, key, orbit, platform, day, start, step, swept): start + timedelta(seconds=step * (k + 0.5)) for k in range(int(round(DURATION / step))) ] - configuration = entry.configurations[key] - index = ( - None if configuration.grouping == "union" else configuration.instrument_index + track = compute_ground_track( + satellite, times, instrument_index=payload.instrument_index ) - track = compute_ground_track(satellite, times, instrument_index=index) return None if track.empty else track.geometry.iloc[0] diff --git a/validation/catalog/earthcare_io.py b/validation/catalog/earthcare_io.py index 97586191..4f5864b0 100644 --- a/validation/catalog/earthcare_io.py +++ b/validation/catalog/earthcare_io.py @@ -332,7 +332,6 @@ def validate_profiler( orbit, tle, day: datetime, - record_path: pathlib.Path, fixture_path: pathlib.Path, source: str, reference: str, @@ -403,7 +402,6 @@ def validate_profiler( orbit, configuration=configuration, time_step=TIME_STEPS[0], platform=platform ) write_record( - record_path, entry, configuration, source=source, @@ -421,7 +419,7 @@ def validate_profiler( ], fixture_metrics=recompute_passes(satellite, 0, day, passes), ) - print(f"wrote {record_path} and {fixture_path}") + print(f"wrote {fixture_path}") return results diff --git a/validation/catalog/gesdisc_scanner.py b/validation/catalog/gesdisc_scanner.py index 47b2867d..682339cf 100644 --- a/validation/catalog/gesdisc_scanner.py +++ b/validation/catalog/gesdisc_scanner.py @@ -720,7 +720,6 @@ class Setup: beams: str size_instrument: str published_footprints: tuple - record_path: pathlib.Path fixture_path: pathlib.Path source: str reference: str @@ -772,11 +771,11 @@ def validate_beams( return if platform != setup.platform: write_transfer( - setup.record_path, + entry, setup.beams, platform, - f"{day:%Y-%m-%d}", - { + period=f"{day:%Y-%m-%d}", + metrics={ "pixel_position_median": median, "pixel_position_p95": p95, "spacing_along_ratio_median": along, @@ -799,7 +798,6 @@ def validate_beams( spacing_seconds=(times[picks] - pd.Timestamp(day)).total_seconds().to_numpy(), ) write_record( - setup.record_path, entry, setup.beams, source=setup.source, @@ -869,11 +867,11 @@ def satellite_for(time_step: float): return if platform != setup.platform: write_transfer( - setup.record_path, + entry, setup.swath, platform, - f"{day:%Y-%m-%d}", - {name: float(results[name]) for name in GATED}, + period=f"{day:%Y-%m-%d}", + metrics={name: float(results[name]) for name in GATED}, ) return rng = np.random.default_rng(1) @@ -895,7 +893,6 @@ def satellite_for(time_step: float): passes=passes, ) write_record( - setup.record_path, entry, setup.swath, source=setup.source, diff --git a/validation/catalog/validate_catalog_abi.py b/validation/catalog/validate_catalog_abi.py index 4422f61b..616839c7 100644 --- a/validation/catalog/validate_catalog_abi.py +++ b/validation/catalog/validate_catalog_abi.py @@ -32,13 +32,11 @@ from tatc.utils import compute_field_of_regard from validation_io import ( add_earth_orientation, - RECORDS, FIXTURES, source_of, write_record, ) -RECORD_PATH = RECORDS / "abi.json" FIXTURE_PATH = FIXTURES / "abi.npz" BUCKET = "https://noaa-goes19.s3.amazonaws.com/" @@ -251,7 +249,7 @@ def main(directory: pathlib.Path) -> None: FIXTURE_PATH.parent.mkdir(parents=True, exist_ok=True) np.savez_compressed(FIXTURE_PATH, **add_earth_orientation(fixture)) for key, results in records.items(): - write_record(RECORD_PATH, entry, key, **results) + write_record(entry, key, **results) if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_ahi.py b/validation/catalog/validate_catalog_ahi.py index a14c9a99..81434977 100644 --- a/validation/catalog/validate_catalog_ahi.py +++ b/validation/catalog/validate_catalog_ahi.py @@ -34,13 +34,11 @@ from tatc.utils import compute_field_of_regard from validation_io import ( add_earth_orientation, - RECORDS, FIXTURES, source_of, write_record, ) -RECORD_PATH = RECORDS / "ahi.json" FIXTURE_PATH = FIXTURES / "ahi.npz" BUCKET = "https://noaa-himawari9.s3.amazonaws.com/" @@ -271,8 +269,8 @@ def validate(directory: pathlib.Path, write: bool) -> None: FIXTURE_PATH.parent.mkdir(parents=True, exist_ok=True) np.savez_compressed(FIXTURE_PATH, **add_earth_orientation(fixture)) for key, results in records.items(): - write_record(RECORD_PATH, entry, key, **results) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + write_record(entry, key, **results) + print(f"wrote {FIXTURE_PATH}") def main() -> None: diff --git a/validation/catalog/validate_catalog_airs.py b/validation/catalog/validate_catalog_airs.py index 5f0d1655..2b2ba428 100644 --- a/validation/catalog/validate_catalog_airs.py +++ b/validation/catalog/validate_catalog_airs.py @@ -43,7 +43,6 @@ ) from validation_io import ( RemoteFile, - RECORDS, FIXTURES, source_of, ) @@ -94,7 +93,6 @@ def read_airs(_product, url: str, session, day: datetime, _directory) -> dict: beams="footprints", size_instrument="AIRS", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=RECORDS / "airs.json", fixture_path=FIXTURES / "airs.npz", source=source_of(__file__), reference="AIRSAQIRL1B version 8.0 (footprint positions and times)", @@ -140,7 +138,7 @@ def main() -> None: if not arguments.sample_sizes_only: validate_swath(SETUP, day, tle, entry, orbit, reference, arguments.write) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_amsr2.py b/validation/catalog/validate_catalog_amsr2.py index 07a26ff8..672950a1 100644 --- a/validation/catalog/validate_catalog_amsr2.py +++ b/validation/catalog/validate_catalog_amsr2.py @@ -61,7 +61,6 @@ import validation_io from validation_io import TO_GEODETIC, ecef, normalize, up -RECORD_PATH = validation_io.RECORDS / "amsr2.json" FIXTURE_PATH = validation_io.FIXTURES / "amsr2.npz" # public element sets from CelesTrak, with epochs after each day of data @@ -575,7 +574,6 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non spacing_instruments=np.concatenate(indices), ) validation_io.write_record( - RECORD_PATH, entry, SAMPLE_CONFIGURATION, source=validation_io.source_of(__file__), @@ -626,7 +624,6 @@ def write_fixture_and_record(day, tle, entry, orbit, results, table) -> None: ) ] validation_io.write_record( - RECORD_PATH, entry, "swath", source=validation_io.source_of(__file__), @@ -740,7 +737,7 @@ def satellite_for(time_step: float): if arguments.write: write_fixture_and_record(day, tle, entry, orbit, results, table) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_amsua.py b/validation/catalog/validate_catalog_amsua.py index 8c93fc25..49d7ce6c 100644 --- a/validation/catalog/validate_catalog_amsua.py +++ b/validation/catalog/validate_catalog_amsua.py @@ -43,7 +43,6 @@ ) from validation_io import ( get_with_retries, - RECORDS, FIXTURES, source_of, ) @@ -125,7 +124,6 @@ def read_amsua(_product, url: str, session, day: datetime, directory) -> dict: beams="footprints", size_instrument="AMSU-A", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=RECORDS / "amsua.json", fixture_path=FIXTURES / "amsua.npz", source=source_of(__file__), reference="AIRABRAD version 005 (footprint positions and times)", @@ -171,7 +169,7 @@ def main() -> None: if not arguments.sample_sizes_only: validate_swath(SETUP, day, tle, entry, orbit, reference, arguments.write) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_ascat.py b/validation/catalog/validate_catalog_ascat.py index af96280f..98d528ca 100644 --- a/validation/catalog/validate_catalog_ascat.py +++ b/validation/catalog/validate_catalog_ascat.py @@ -71,14 +71,12 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, login_earthdata, ) -RECORD_PATH = RECORDS / "ascat.json" FIXTURE_PATH = FIXTURES / "ascat.npz" SHORT_NAME = "ASCATC-L2-25km" @@ -501,7 +499,6 @@ def satellite_for(time_step: float): FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=fixture ) write_record( - RECORD_PATH, entry, CONFIGURATION, source=source_of(__file__), @@ -511,7 +508,7 @@ def satellite_for(time_step: float): metrics=metrics, fixture_metrics=recompute_passes(satellite, None, day, fixture), ) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") def main() -> None: diff --git a/validation/catalog/validate_catalog_atlas.py b/validation/catalog/validate_catalog_atlas.py index fe610c60..c596781a 100644 --- a/validation/catalog/validate_catalog_atlas.py +++ b/validation/catalog/validate_catalog_atlas.py @@ -55,14 +55,12 @@ read_element_set_file, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, login_earthdata, ) -RECORD_PATH = RECORDS / "atlas.json" FIXTURE_PATH = FIXTURES / "atlas.npz" # public element sets from CelesTrak, with epochs a few days after each day of data; @@ -366,7 +364,6 @@ def main() -> None: ) found = np.isfinite(fixture_differences) write_record( - RECORD_PATH, entry, CONFIGURATION, source=source_of(__file__), @@ -388,7 +385,7 @@ def main() -> None: "epoch_p95": float(summarize(fixture_differences[found])["p95"]), }, ) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_atlid.py b/validation/catalog/validate_catalog_atlid.py index 96308ec8..096610a4 100644 --- a/validation/catalog/validate_catalog_atlid.py +++ b/validation/catalog/validate_catalog_atlid.py @@ -40,13 +40,11 @@ from validation_io import ( ecef, read_element_set_file, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, ) -RECORD_PATH = RECORDS / "atlid.json" FIXTURE_PATH = FIXTURES / "atlid.npz" NORAD_ID = 59908 ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "earthcare_2026-09-27.3le" @@ -101,7 +99,6 @@ def main() -> None: orbit, tle, day, - RECORD_PATH, FIXTURE_PATH, source_of(__file__), "ATL_NOM_1B (profile positions and times)", diff --git a/validation/catalog/validate_catalog_atms.py b/validation/catalog/validate_catalog_atms.py index a1e20de0..ce424574 100644 --- a/validation/catalog/validate_catalog_atms.py +++ b/validation/catalog/validate_catalog_atms.py @@ -66,7 +66,6 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ) @@ -79,7 +78,6 @@ "swath_width_median", "footprint_iou_median", ) -RECORD_PATH = RECORDS / "atms.json" # the configurations of each platform's fit and its fixture CONFIGURATIONS = { @@ -429,11 +427,11 @@ def validate_beams(day, tle, entry, orbit, reference, write: bool, run: Run) -> return if run.transfer: write_transfer( - RECORD_PATH, + entry, run.beams, run.platform, - f"{day:%Y-%m-%d}", - { + period=f"{day:%Y-%m-%d}", + metrics={ "pixel_position_median": median, "pixel_position_p95": p95, "spacing_along_ratio_median": along, @@ -456,7 +454,6 @@ def validate_beams(day, tle, entry, orbit, reference, write: bool, run: Run) -> spacing_seconds=(times[picks] - pd.Timestamp(day)).total_seconds().to_numpy(), ) write_record( - RECORD_PATH, entry, run.beams, source=source_of(__file__), @@ -509,11 +506,11 @@ def satellite_for(time_step: float): return if run.transfer: write_transfer( - RECORD_PATH, + entry, run.swath, run.platform, - f"{day:%Y-%m-%d}", - {name: results[name] for name in GATED}, + period=f"{day:%Y-%m-%d}", + metrics={name: results[name] for name in GATED}, ) return rng = np.random.default_rng(1) @@ -533,7 +530,6 @@ def satellite_for(time_step: float): passes=passes, ) write_record( - RECORD_PATH, entry, run.swath, source=source_of(__file__), @@ -598,7 +594,7 @@ def main() -> None: if not arguments.sample_sizes_only: validate_swath(day, tle, entry, orbit, reference, arguments.write, run) if arguments.write: - print(f"wrote {RECORD_PATH} and {run.fixture_path}") + print(f"wrote {run.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_avhrr.py b/validation/catalog/validate_catalog_avhrr.py index 64be9905..d2c16465 100644 --- a/validation/catalog/validate_catalog_avhrr.py +++ b/validation/catalog/validate_catalog_avhrr.py @@ -56,7 +56,6 @@ from validation_io import ( RemoteFile, read_element_set_file, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, @@ -153,7 +152,6 @@ def read_avhrr(_product, url: str, session, day: datetime, _directory) -> dict: beams="pixels", size_instrument="AVHRR", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=RECORDS / "avhrr.json", fixture_path=FIXTURES / "avhrr.npz", source=source_of(__file__), reference="AVHRRF_MC-STAR-L2P version 2.80 (sample positions and times)", @@ -241,7 +239,7 @@ def main() -> None: arguments.platform, ) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_bbr.py b/validation/catalog/validate_catalog_bbr.py index e036ac0a..a6bd85b2 100644 --- a/validation/catalog/validate_catalog_bbr.py +++ b/validation/catalog/validate_catalog_bbr.py @@ -55,13 +55,11 @@ score_swath_area, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, ) -RECORD_PATH = RECORDS / "bbr.json" FIXTURE_PATH = FIXTURES / "bbr.npz" NORAD_ID = 59908 ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "earthcare_2026-09-27.3le" @@ -193,7 +191,6 @@ def satellite_for(time_step: float): ) nadir = list(VIEWS).index("NADIR") write_record( - RECORD_PATH, entry, CONFIGURATION, source=source_of(__file__), @@ -204,7 +201,7 @@ def satellite_for(time_step: float): metrics=metrics, fixture_metrics=recompute_passes(satellite, nadir, day, passes), ) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") def main() -> None: diff --git a/validation/catalog/validate_catalog_ceres.py b/validation/catalog/validate_catalog_ceres.py index 6cbf9b5d..8ac1d9f8 100644 --- a/validation/catalog/validate_catalog_ceres.py +++ b/validation/catalog/validate_catalog_ceres.py @@ -42,7 +42,6 @@ ARCHIVES, TO_GEODETIC, get_with_retries, - RECORDS, FIXTURES, source_of, login_earthdata, @@ -189,7 +188,6 @@ def table(name: str) -> np.ndarray: beams="", size_instrument="CERES", published_footprints=(), - record_path=RECORDS / "ceres.json", fixture_path=FIXTURES / "ceres.npz", source=source_of(__file__), reference="CER_ES8_NOAA20-FM6 Edition1 (footprint positions, projected to the " @@ -234,7 +232,7 @@ def main() -> None: SETUP, day, tle, get_entry("ceres"), orbit, reference, arguments.write ) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_cpr.py b/validation/catalog/validate_catalog_cpr.py index 2e2a7c5f..6ea3fb72 100644 --- a/validation/catalog/validate_catalog_cpr.py +++ b/validation/catalog/validate_catalog_cpr.py @@ -39,13 +39,11 @@ ) from validation_io import ( read_element_set_file, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, ) -RECORD_PATH = RECORDS / "cpr.json" FIXTURE_PATH = FIXTURES / "cpr.npz" NORAD_ID = 59908 ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "earthcare_2026-09-27.3le" @@ -98,7 +96,6 @@ def main() -> None: orbit, tle, day, - RECORD_PATH, FIXTURE_PATH, source_of(__file__), "CPR_NOM_1B (profile positions and times)", diff --git a/validation/catalog/validate_catalog_cris.py b/validation/catalog/validate_catalog_cris.py index e7348f9f..5fc0f5d1 100644 --- a/validation/catalog/validate_catalog_cris.py +++ b/validation/catalog/validate_catalog_cris.py @@ -66,7 +66,6 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ) @@ -79,7 +78,6 @@ "swath_width_median", "footprint_iou_median", ) -RECORD_PATH = RECORDS / "cris.json" FIXTURE_PATH = FIXTURES / "cris.npz" FIELDS = ( @@ -373,11 +371,11 @@ def validate_pixels( return if platform != FIT_PLATFORM: write_transfer( - RECORD_PATH, + entry, PIXELS, platform, - f"{day:%Y-%m-%d}", - { + period=f"{day:%Y-%m-%d}", + metrics={ "pixel_position_median": median, "pixel_position_p95": p95, }, @@ -389,7 +387,6 @@ def validate_pixels( FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), pixels=reduced ) write_record( - RECORD_PATH, entry, PIXELS, source=source_of(__file__), @@ -444,11 +441,11 @@ def satellite_for(time_step: float): return if platform != FIT_PLATFORM: write_transfer( - RECORD_PATH, + entry, SWATH, platform, - f"{day:%Y-%m-%d}", - {name: results[name] for name in GATED}, + period=f"{day:%Y-%m-%d}", + metrics={name: results[name] for name in GATED}, ) return rng = np.random.default_rng(1) @@ -465,7 +462,6 @@ def satellite_for(time_step: float): FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) write_record( - RECORD_PATH, entry, SWATH, source=source_of(__file__), @@ -641,7 +637,7 @@ def main() -> None: day, tle, entry, orbit, reference, arguments.write, arguments.platform ) if arguments.write: - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_csar.py b/validation/catalog/validate_catalog_csar.py index 5b903396..4007f52c 100644 --- a/validation/catalog/validate_catalog_csar.py +++ b/validation/catalog/validate_catalog_csar.py @@ -66,13 +66,11 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, ) -RECORD_PATH = RECORDS / "csar.json" FIXTURE_PATH = FIXTURES / "csar.npz" ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "sentinel_2026-08-12.3le" @@ -690,21 +688,12 @@ def satellite_for(time_step: float): return if PLATFORM != FIT_PLATFORM: write_transfer( - RECORD_PATH, + entry, key, PLATFORM, - f"{day:%Y-%m-%d}", - { - metric["name"] - + ( - "_" + metric["scope"].replace(" ", "_").replace(".", "_") - if "scope" in metric - else "" - ): metric["value"] - for metric in metrics - }, + period=f"{day:%Y-%m-%d}", + metrics=metrics, ) - print(f"added {key} transfer metrics to {RECORD_PATH}") return rng = np.random.default_rng(1) fixture = points[found][ @@ -721,7 +710,6 @@ def satellite_for(time_step: float): }, ) write_record( - RECORD_PATH, entry, key, source=source_of(__file__), @@ -732,7 +720,6 @@ def satellite_for(time_step: float): metrics=metrics, fixture_metrics=recompute_passes(satellite, 0, day, fixture), ) - print(f"wrote {key} to {RECORD_PATH}") def main() -> None: diff --git a/validation/catalog/validate_catalog_dpr.py b/validation/catalog/validate_catalog_dpr.py index 6a2afac8..4618a0dc 100644 --- a/validation/catalog/validate_catalog_dpr.py +++ b/validation/catalog/validate_catalog_dpr.py @@ -42,7 +42,6 @@ ) from validation_io import ( read_element_set_file, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, @@ -88,7 +87,6 @@ beams="beams", size_instrument="DPR", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=RECORDS / "dpr.json", fixture_path=FIXTURES / "dpr.npz", source=source_of(__file__), reference="GPM_2ADPR version 08 (beam positions of the full swath)", @@ -136,7 +134,7 @@ def main() -> None: if not arguments.sample_sizes_only: validate_swath(SETUP, day, tle, entry, orbit, reference, arguments.write) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_earthcare_msi.py b/validation/catalog/validate_catalog_earthcare_msi.py index 21865114..4d263732 100644 --- a/validation/catalog/validate_catalog_earthcare_msi.py +++ b/validation/catalog/validate_catalog_earthcare_msi.py @@ -39,7 +39,6 @@ from validation_io import ( TO_GEODETIC, read_element_set_file, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, @@ -70,7 +69,6 @@ beams="", size_instrument="", published_footprints=(), - record_path=RECORDS / "earthcare_msi.json", fixture_path=FIXTURES / "earthcare_msi.npz", source=source_of(__file__), reference=f"{PRODUCT} (pixel positions of every fourth orbit, every eighth line), " @@ -163,7 +161,7 @@ def main() -> None: entry = get_entry("earthcare_msi") validate_swath(SETUP, day, tle, entry, orbit, reference, arguments.write) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_ecostress.py b/validation/catalog/validate_catalog_ecostress.py index 23810499..d5334890 100644 --- a/validation/catalog/validate_catalog_ecostress.py +++ b/validation/catalog/validate_catalog_ecostress.py @@ -54,7 +54,6 @@ from validation_io import ( TO_GEODETIC, RemoteFile, - RECORDS, FIXTURES, source_of, login_earthdata, @@ -166,7 +165,6 @@ def load_day(day: datetime, directory: pathlib.Path) -> dict: beams="", size_instrument="ECOSTRESS", published_footprints=(), - record_path=RECORDS / "ecostress.json", fixture_path=FIXTURES / "ecostress.npz", source=source_of(__file__), reference="ECO_L1B_GEO version 002 (sample positions and times of every fourth " @@ -217,7 +215,7 @@ def main() -> None: SETUP, day, tle, get_entry("ecostress"), orbit, reference, arguments.write ) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_emit.py b/validation/catalog/validate_catalog_emit.py index 12097328..94b5dda0 100644 --- a/validation/catalog/validate_catalog_emit.py +++ b/validation/catalog/validate_catalog_emit.py @@ -53,13 +53,11 @@ recompute_passes, update_fixture, write_record, - RECORDS, FIXTURES, source_of, login_earthdata, ) -RECORD_PATH = RECORDS / "emit.json" FIXTURE_PATH = FIXTURES / "emit.npz" PLATFORM = "iss" CONFIGURATION = "swath" @@ -273,7 +271,6 @@ def satellite_for(time_step): FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) write_record( - RECORD_PATH, entry, CONFIGURATION, source=source_of(__file__), @@ -293,7 +290,7 @@ def satellite_for(time_step): ], fixture_metrics=recompute_passes(satellite_for(TIME_STEPS[0]), 0, day, passes), ) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") def main() -> None: diff --git a/validation/catalog/validate_catalog_gedi.py b/validation/catalog/validate_catalog_gedi.py index 5bc6e3ca..65d1bf91 100644 --- a/validation/catalog/validate_catalog_gedi.py +++ b/validation/catalog/validate_catalog_gedi.py @@ -58,14 +58,12 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, login_earthdata, ) -RECORD_PATH = RECORDS / "gedi.json" FIXTURE_PATH = FIXTURES / "gedi.npz" ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "iss_2026-04-01.3le" NORAD_ID = 25544 @@ -408,7 +406,6 @@ def main() -> None: ) found = np.isfinite(fixture_differences) write_record( - RECORD_PATH, entry, CONFIGURATION, source=source_of(__file__), @@ -431,7 +428,7 @@ def main() -> None: "epoch_p95": float(summarize(fixture_differences[found])["p95"]), }, ) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_gmi.py b/validation/catalog/validate_catalog_gmi.py index f8e2da5b..0696b3b4 100644 --- a/validation/catalog/validate_catalog_gmi.py +++ b/validation/catalog/validate_catalog_gmi.py @@ -63,7 +63,6 @@ import validation_io from validation_io import TO_GEODETIC, ecef, normalize, up -RECORD_PATH = validation_io.RECORDS / "gmi.json" FIXTURE_PATH = validation_io.FIXTURES / "gmi.npz" # public element sets from CelesTrak, with epochs just after each day of data @@ -566,7 +565,6 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non spacing_instruments=np.concatenate(indices), ) validation_io.write_record( - RECORD_PATH, entry, SAMPLE_CONFIGURATION, source=validation_io.source_of(__file__), @@ -628,7 +626,6 @@ def write_fixture_and_record(day, tle, entry, orbit, results, fixtures) -> None: {"name": name, "value": float(results[feed][name]), "scope": feed} ) validation_io.write_record( - RECORD_PATH, entry, "feeds", source=validation_io.source_of(__file__), @@ -751,7 +748,7 @@ def satellite_for(time_step: float): if arguments.write: write_fixture_and_record(day, tle, entry, orbit, results, fixtures) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_harp2.py b/validation/catalog/validate_catalog_harp2.py index 441c2ae8..a53ffe54 100644 --- a/validation/catalog/validate_catalog_harp2.py +++ b/validation/catalog/validate_catalog_harp2.py @@ -46,7 +46,6 @@ ) from validation_io import ( RemoteFile, - RECORDS, FIXTURES, source_of, ) @@ -106,7 +105,6 @@ def read_harp2(_product, url: str, session, day: datetime, _directory) -> dict: beams="", size_instrument="HARP2", published_footprints=(), - record_path=RECORDS / "harp2.json", fixture_path=FIXTURES / "harp2.npz", source=source_of(__file__), reference="PACE_HARP2_L1B_SCI version 4 (positions and times of the near-nadir " @@ -156,7 +154,7 @@ def main() -> None: SETUP, day, tle, get_entry("harp2"), orbit, reference, arguments.write ) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_iasi.py b/validation/catalog/validate_catalog_iasi.py index 59e1ae5d..3c8780d0 100644 --- a/validation/catalog/validate_catalog_iasi.py +++ b/validation/catalog/validate_catalog_iasi.py @@ -72,13 +72,11 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, login_earthdata, ) -RECORD_PATH = RECORDS / "iasi.json" FIXTURE_PATH = FIXTURES / "iasi.npz" PRODUCT = "IASI_SST_METOP_B-OSISAF-L2P-v1.0" @@ -538,7 +536,6 @@ def validate_pixels(day, tle, entry, orbit, reference, write) -> None: spacing_seconds=(times[picks] - pd.Timestamp(day)).total_seconds().to_numpy(), ) write_record( - RECORD_PATH, entry, PIXELS, source=source_of(__file__), @@ -613,7 +610,6 @@ def satellite_for(time_step: float): "footprint_iou_median", ) write_record( - RECORD_PATH, entry, SWATH, source=source_of(__file__), @@ -651,8 +647,6 @@ def main() -> None: entry = get_entry("iasi") validate_pixels(day, ELEMENT_SET, entry, orbit, reference, arguments.write) validate_swath(day, ELEMENT_SET, entry, orbit, reference, arguments.write) - if arguments.write: - print(f"wrote {RECORD_PATH}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_karin.py b/validation/catalog/validate_catalog_karin.py index 2051171c..a9d8120e 100644 --- a/validation/catalog/validate_catalog_karin.py +++ b/validation/catalog/validate_catalog_karin.py @@ -60,13 +60,11 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, login_earthdata, ) -RECORD_PATH = RECORDS / "karin.json" FIXTURE_PATH = FIXTURES / "karin.npz" PLATFORM = "swot" @@ -450,7 +448,6 @@ def satellite_for(time_step: float): FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=fixture ) write_record( - RECORD_PATH, entry, CONFIGURATION, source=source_of(__file__), @@ -460,7 +457,7 @@ def satellite_for(time_step: float): metrics=metrics, fixture_metrics=recompute_passes(satellite, None, day, fixture), ) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") def main() -> None: diff --git a/validation/catalog/validate_catalog_lsar.py b/validation/catalog/validate_catalog_lsar.py index 43db3211..7b22ef7a 100644 --- a/validation/catalog/validate_catalog_lsar.py +++ b/validation/catalog/validate_catalog_lsar.py @@ -76,14 +76,12 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, login_earthdata, ) -RECORD_PATH = RECORDS / "lsar.json" FIXTURE_PATH = FIXTURES / "lsar.npz" SEARCH_URL = "https://api.daac.asf.alaska.edu/services/search/param" @@ -649,7 +647,6 @@ def write_results(key, results, tles, entry, metrics) -> None: }, ) write_record( - RECORD_PATH, entry, key, source=source_of(__file__), @@ -662,7 +659,6 @@ def write_results(key, results, tles, entry, metrics) -> None: results[days[0]]["satellite"], 0, fixture_day, fixture ), ) - print(f"wrote {key} to {RECORD_PATH}") def main() -> None: diff --git a/validation/catalog/validate_catalog_mhs.py b/validation/catalog/validate_catalog_mhs.py index c285f350..387e534d 100644 --- a/validation/catalog/validate_catalog_mhs.py +++ b/validation/catalog/validate_catalog_mhs.py @@ -43,7 +43,6 @@ ) from validation_io import ( read_element_set_file, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, @@ -101,7 +100,6 @@ beams="beams", size_instrument="MHS", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=RECORDS / "mhs.json", fixture_path=FIXTURES / "mhs.npz", source=source_of(__file__), reference="GPM_1CMETOPCMHS version 08 (beam positions)", @@ -169,7 +167,7 @@ def main() -> None: arguments.platform, ) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_modis.py b/validation/catalog/validate_catalog_modis.py index 25ac19cd..eb637040 100644 --- a/validation/catalog/validate_catalog_modis.py +++ b/validation/catalog/validate_catalog_modis.py @@ -80,13 +80,11 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, login_earthdata, ) -RECORD_PATH = RECORDS / "modis.json" FIXTURE_PATH = FIXTURES / "modis.npz" FIT_PLATFORM = "terra" @@ -444,11 +442,11 @@ def validate_pixels(day, tle, entry, orbit, reference, platform, write) -> None: return if platform != FIT_PLATFORM: write_transfer( - RECORD_PATH, + entry, PIXELS, platform, - f"{day:%Y-%m-%d}", - { + period=f"{day:%Y-%m-%d}", + metrics={ "pixel_position_median": median, "pixel_position_p95": p95, "spacing_along_ratio_median": along, @@ -471,7 +469,6 @@ def validate_pixels(day, tle, entry, orbit, reference, platform, write) -> None: spacing_seconds=(times[picks] - pd.Timestamp(day)).total_seconds().to_numpy(), ) write_record( - RECORD_PATH, entry, PIXELS, source=source_of(__file__), @@ -543,11 +540,11 @@ def satellite_for(time_step: float): ) if platform != FIT_PLATFORM: write_transfer( - RECORD_PATH, + entry, SWATH, platform, - f"{day:%Y-%m-%d}", - {name: results[name] for name in gated}, + period=f"{day:%Y-%m-%d}", + metrics={name: results[name] for name in gated}, ) return rng = np.random.default_rng(1) @@ -564,7 +561,6 @@ def satellite_for(time_step: float): FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) write_record( - RECORD_PATH, entry, SWATH, source=source_of(__file__), @@ -684,8 +680,6 @@ def main() -> None: validate_swath( day, tle, entry, orbit, reference, arguments.platform, arguments.write ) - if arguments.write: - print(f"wrote {RECORD_PATH}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_msi.py b/validation/catalog/validate_catalog_msi.py index 7ae54d1f..d7e074d6 100644 --- a/validation/catalog/validate_catalog_msi.py +++ b/validation/catalog/validate_catalog_msi.py @@ -62,13 +62,11 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, ) -RECORD_PATH = RECORDS / "msi.json" FIXTURE_PATH = FIXTURES / "msi.npz" ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "sentinel_2026-08-12.3le" @@ -905,7 +903,6 @@ def satellite_for(platform: str, time_step: float): passes=fixture, ) write_record( - RECORD_PATH, entry, KEY, source=source_of(__file__), @@ -918,7 +915,6 @@ def satellite_for(platform: str, time_step: float): satellite_for(FIXTURE_PLATFORM, TIME_STEPS[0]), 0, day, fixture ), ) - print(f"wrote {RECORD_PATH}") def main() -> None: diff --git a/validation/catalog/validate_catalog_oci.py b/validation/catalog/validate_catalog_oci.py index 968c5291..4189882a 100644 --- a/validation/catalog/validate_catalog_oci.py +++ b/validation/catalog/validate_catalog_oci.py @@ -53,7 +53,6 @@ get_with_retries, normalize, up, - RECORDS, FIXTURES, source_of, login_earthdata, @@ -134,7 +133,6 @@ def read_oci(_product, url: str, session, day: datetime, _directory) -> dict: beams="", size_instrument="OCI", published_footprints=(), - record_path=RECORDS / "oci.json", fixture_path=FIXTURES / "oci.npz", source=source_of(__file__), reference="PACE_OCI_L1B_SCI version 3 (sample positions and times)", @@ -437,7 +435,7 @@ def main() -> None: entry = get_entry("oci") validate_swath(SETUP, day, tle, entry, orbit, reference, arguments.write) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_oco2.py b/validation/catalog/validate_catalog_oco2.py index f54f4f20..a2d959bc 100644 --- a/validation/catalog/validate_catalog_oco2.py +++ b/validation/catalog/validate_catalog_oco2.py @@ -58,7 +58,6 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ) @@ -100,7 +99,6 @@ def read_oco2(_product, url: str, session, day: datetime, _directory) -> dict: PRODUCT = Product(short_name="OCO2_L1B_Science", version="11.2", read=read_oco2) -RECORD_PATH = RECORDS / "oco2.json" TIME_STEPS = (10, 30, 120) SAMPLE = 1000 FIXTURE_PASSES = 60 @@ -294,7 +292,6 @@ def satellite_for(time_step): fixture, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) write_record( - RECORD_PATH, entry, key, source=source_of(__file__), @@ -314,7 +311,7 @@ def satellite_for(time_step): ], fixture_metrics=recompute_passes(satellite_for(TIME_STEPS[0]), 0, day, passes), ) - print(f"wrote {RECORD_PATH} and {fixture}") + print(f"wrote {fixture}") def load_reference(day: datetime, directory: pathlib.Path, mode: int) -> Reference: diff --git a/validation/catalog/validate_catalog_olci.py b/validation/catalog/validate_catalog_olci.py index 5902b085..4e7d459e 100644 --- a/validation/catalog/validate_catalog_olci.py +++ b/validation/catalog/validate_catalog_olci.py @@ -53,7 +53,6 @@ ecef, normalize, up, - RECORDS, FIXTURES, source_of, ) @@ -157,7 +156,6 @@ def read(name: str, fields: tuple[str, ...]) -> dict: beams="", size_instrument="OLCI", published_footprints=(), - record_path=RECORDS / "olci.json", fixture_path=FIXTURES / "olci.npz", source=source_of(__file__), reference="S3A_OL_1_EFR (tie point positions and times)", @@ -220,7 +218,7 @@ def main() -> None: entry = get_entry("olci") validate_swath(SETUP, day, tle, entry, orbit, reference, arguments.write) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_oli.py b/validation/catalog/validate_catalog_oli.py index 60202711..8087d52b 100644 --- a/validation/catalog/validate_catalog_oli.py +++ b/validation/catalog/validate_catalog_oli.py @@ -64,12 +64,10 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ) -RECORD_PATH = RECORDS / "oli.json" FIXTURE_PATH = FIXTURES / "oli.npz" SCENES_URL = "https://landsatlook.usgs.gov/stac-server/search" @@ -716,11 +714,11 @@ def satellite_for(time_step: float): ) if platform != FIT_PLATFORM: write_transfer( - RECORD_PATH, + entry, KEY, platform, - f"{day:%Y-%m-%d}", - {name: results[name] for name in names}, + period=f"{day:%Y-%m-%d}", + metrics={name: results[name] for name in names}, ) return rng = np.random.default_rng(1) @@ -739,7 +737,6 @@ def satellite_for(time_step: float): FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=fixture ) write_record( - RECORD_PATH, entry, KEY, source=source_of(__file__), @@ -750,7 +747,6 @@ def satellite_for(time_step: float): metrics=[{"name": name, "value": float(results[name])} for name in names], fixture_metrics=recompute_passes(satellite, 0, day, fixture), ) - print(f"wrote {RECORD_PATH}") def main() -> None: diff --git a/validation/catalog/validate_catalog_omps.py b/validation/catalog/validate_catalog_omps.py index 47929bcb..a31db140 100644 --- a/validation/catalog/validate_catalog_omps.py +++ b/validation/catalog/validate_catalog_omps.py @@ -39,7 +39,6 @@ Archive, TO_GEODETIC, iet_to_utc, - RECORDS, FIXTURES, source_of, ) @@ -131,7 +130,6 @@ def make_setup(platform: str) -> Setup: beams="", size_instrument="OMPS Nadir Mapper", published_footprints=(), - record_path=RECORDS / "omps_nm.json", fixture_path=fixture, source=source_of(__file__), reference="OMPS-TC-GEO (sample positions and times), NOAA Open Data " @@ -175,7 +173,7 @@ def main() -> None: setup, day, tle, get_entry("omps_nm"), orbit, reference, arguments.write ) if arguments.write: - print(f"wrote {setup.record_path} and {setup.fixture_path}") + print(f"wrote {setup.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_poseidon4.py b/validation/catalog/validate_catalog_poseidon4.py index 14c4999b..6fb5a9b5 100644 --- a/validation/catalog/validate_catalog_poseidon4.py +++ b/validation/catalog/validate_catalog_poseidon4.py @@ -45,13 +45,11 @@ recompute_passes, update_fixture, write_record, - RECORDS, FIXTURES, source_of, login_earthdata, ) -RECORD_PATH = RECORDS / "poseidon4.json" FIXTURE_PATH = FIXTURES / "poseidon4.npz" SHORT_NAMES = { "sentinel-6a": "JASON_CS_S6A_L2_ALT_LR_RED_OST_NRT_F", @@ -229,16 +227,15 @@ def main() -> None: return if platform != "sentinel-6a": write_transfer( - RECORD_PATH, + entry, "nadir", platform, - f"{day:%Y-%m-%d}", - { + period=f"{day:%Y-%m-%d}", + metrics={ name: results[name] for name in ("segment_recall", "track_offset_median", "epoch_p95") }, ) - print(f"wrote transfer metrics to {RECORD_PATH}") return picks = sample.iloc[rng.choice(len(sample), FIXTURE_PASSES, replace=False)] passes = np.stack( @@ -256,7 +253,6 @@ def main() -> None: orbit, time_step=TIME_STEPS[0], platform="sentinel-6a" ) write_record( - RECORD_PATH, entry, "nadir", source=source_of(__file__), @@ -274,7 +270,7 @@ def main() -> None: ], fixture_metrics=recompute_passes(satellite, 0, day, passes), ) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_smap.py b/validation/catalog/validate_catalog_smap.py index dbd41e8e..bbf54e9a 100644 --- a/validation/catalog/validate_catalog_smap.py +++ b/validation/catalog/validate_catalog_smap.py @@ -71,14 +71,12 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, login_earthdata, ) -RECORD_PATH = RECORDS / "smap_radiometer.json" FIXTURE_PATH = FIXTURES / "smap_radiometer.npz" ELEMENT_SET_FILE = ELEMENT_SET_FOLDER / "smap_2026-09-20.3le" @@ -610,7 +608,6 @@ def validate_sample_sizes(day, tle, entry, orbit, reference, write: bool) -> Non spacing=picks, ) write_record( - RECORD_PATH, entry, SAMPLE_CONFIGURATION, source=source_of(__file__), @@ -761,7 +758,6 @@ def satellite_for(time_step: float): ) ] write_record( - RECORD_PATH, entry, CONFIGURATION, source=source_of(__file__), @@ -771,7 +767,7 @@ def satellite_for(time_step: float): metrics=metrics, fixture_metrics=recompute_passes(satellite, 0, day, fixture), ) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_spexone.py b/validation/catalog/validate_catalog_spexone.py index a8ca9f73..64eb6195 100644 --- a/validation/catalog/validate_catalog_spexone.py +++ b/validation/catalog/validate_catalog_spexone.py @@ -49,7 +49,6 @@ from validation_io import ( TO_GEODETIC, RemoteFile, - RECORDS, FIXTURES, source_of, login_earthdata, @@ -116,7 +115,6 @@ def read_navigation(url: str, session, day: datetime) -> tuple[np.ndarray, np.nd beams="", size_instrument="SPEXone", published_footprints=(), - record_path=RECORDS / "spexone.json", fixture_path=FIXTURES / "spexone.npz", source=source_of(__file__), reference="PACE_SPEXONE_L1C_SCI version 4 (positions of bins and times of the " @@ -194,7 +192,7 @@ def main() -> None: SETUP, day, tle, get_entry("spexone"), orbit, reference, arguments.write ) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_ssmis.py b/validation/catalog/validate_catalog_ssmis.py index 60e5eef4..25ab9cef 100644 --- a/validation/catalog/validate_catalog_ssmis.py +++ b/validation/catalog/validate_catalog_ssmis.py @@ -49,12 +49,10 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ) -RECORD_PATH = RECORDS / "ssmis.json" FIXTURE_PATH = FIXTURES / "ssmis.npz" PLATFORM = "dmsp-f18" CONFIGURATION = "swath" @@ -277,7 +275,6 @@ def satellite_for(time_step: float): FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) write_record( - RECORD_PATH, entry, CONFIGURATION, source=source_of(__file__), @@ -296,7 +293,7 @@ def satellite_for(time_step: float): ], fixture_metrics=recompute_passes(satellite, 0, day, passes), ) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_tempo.py b/validation/catalog/validate_catalog_tempo.py index 361e6cf0..d894daea 100644 --- a/validation/catalog/validate_catalog_tempo.py +++ b/validation/catalog/validate_catalog_tempo.py @@ -54,14 +54,12 @@ ecef, get_with_retries, up, - RECORDS, FIXTURES, source_of, login_earthdata, write_record, ) -RECORD_PATH = RECORDS / "tempo.json" FIXTURE_PATH = FIXTURES / "tempo.npz" SHORT_NAME, VERSION = "TEMPO_RAD_L1", "V04" PLATFORM = "intelsat-40e" @@ -394,7 +392,6 @@ def validate(day, tle, scan, write) -> None: ) fixture_predicted = predict_grid(satellite, track, lon[sample], lat[sample]) write_record( - RECORD_PATH, entry, CONFIGURATION, source=source_of(__file__), @@ -419,7 +416,7 @@ def validate(day, tle, scan, write) -> None: * float(np.mean(fixture_predicted == fixture[:, 2].astype(bool))) }, ) - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") def main() -> None: diff --git a/validation/catalog/validate_catalog_tmi.py b/validation/catalog/validate_catalog_tmi.py index e29399bc..96be65c0 100644 --- a/validation/catalog/validate_catalog_tmi.py +++ b/validation/catalog/validate_catalog_tmi.py @@ -65,13 +65,11 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ) from validate_catalog_trmm_pr import ELEMENT_SET_FILE, NORAD_ID -RECORD_PATH = RECORDS / "tmi.json" FIXTURE_PATH = FIXTURES / "tmi.npz" PLATFORM = "trmm" CONFIGURATION = "feeds" @@ -414,7 +412,6 @@ def validate_sample_sizes(day, tle, entry, orbit, references, write: bool) -> No FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), **reduced ) write_record( - RECORD_PATH, entry, SAMPLE_CONFIGURATION, source=source_of(__file__), @@ -495,7 +492,6 @@ def satellite_for(time_step: float): FIXTURE_PATH, tle=np.array(tle), day=np.array(day.isoformat()), passes=passes ) write_record( - RECORD_PATH, entry, CONFIGURATION, source=source_of(__file__), @@ -538,7 +534,7 @@ def main() -> None: if not arguments.sample_sizes_only: validate_swath(day, tle, entry, orbit, references, arguments.write) if arguments.write: - print(f"wrote {RECORD_PATH} and {FIXTURE_PATH}") + print(f"wrote {FIXTURE_PATH}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_trmm_pr.py b/validation/catalog/validate_catalog_trmm_pr.py index 8e5d2a41..b4c44e3c 100644 --- a/validation/catalog/validate_catalog_trmm_pr.py +++ b/validation/catalog/validate_catalog_trmm_pr.py @@ -43,7 +43,6 @@ ) from validation_io import ( read_element_set_file, - RECORDS, FIXTURES, source_of, ELEMENT_SET_FOLDER, @@ -75,7 +74,6 @@ beams="beams", size_instrument="PR", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=RECORDS / "trmm_pr.json", fixture_path=FIXTURES / "trmm_pr.npz", source=source_of(__file__), reference="GPM_2APR version 07 (beam positions of the full swath)", @@ -119,7 +117,7 @@ def main() -> None: if not arguments.sample_sizes_only: validate_swath(SETUP, day, tle, entry, orbit, reference, arguments.write) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_tropomi.py b/validation/catalog/validate_catalog_tropomi.py index cd3b5314..53409744 100644 --- a/validation/catalog/validate_catalog_tropomi.py +++ b/validation/catalog/validate_catalog_tropomi.py @@ -59,12 +59,10 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ) -RECORD_PATH = RECORDS / "tropomi.json" FIXTURE_PATH = FIXTURES / "tropomi.npz" BUCKET = "https://meeo-s5p.s3.amazonaws.com/" @@ -516,7 +514,6 @@ def satellite_for(time_step: float): "footprint_iou_median", ) write_record( - RECORD_PATH, entry, KEY, source=source_of(__file__), @@ -526,7 +523,6 @@ def satellite_for(time_step: float): metrics=[{"name": name, "value": float(results[name])} for name in names], fixture_metrics=recompute_passes(satellite, None, day, passes), ) - print(f"wrote {RECORD_PATH}") def main() -> None: diff --git a/validation/catalog/validate_catalog_viirs.py b/validation/catalog/validate_catalog_viirs.py index 7b6421a3..c1a1d4f1 100644 --- a/validation/catalog/validate_catalog_viirs.py +++ b/validation/catalog/validate_catalog_viirs.py @@ -69,7 +69,6 @@ up, update_fixture, write_record, - RECORDS, FIXTURES, source_of, ) @@ -82,7 +81,6 @@ "swath_width_median", "footprint_iou_median", ) -RECORD_PATH = RECORDS / "viirs.json" # the configurations of each platform's fit and its fixture CONFIGURATIONS = { @@ -499,11 +497,11 @@ def validate_zones(day, tle, entry, orbit, reference, write: bool, run: Run) -> return if run.transfer: write_transfer( - RECORD_PATH, + entry, run.zones, run.platform, - f"{day:%Y-%m-%d}", - { + period=f"{day:%Y-%m-%d}", + metrics={ "pixel_position_median": median, "pixel_position_p95": p95, "spacing_along_ratio_median": along, @@ -526,7 +524,6 @@ def validate_zones(day, tle, entry, orbit, reference, write: bool, run: Run) -> spacing_seconds=(times[picks] - pd.Timestamp(day)).total_seconds().to_numpy(), ) write_record( - RECORD_PATH, entry, run.zones, source=source_of(__file__), @@ -585,11 +582,11 @@ def satellite_for(time_step: float): return if run.transfer: write_transfer( - RECORD_PATH, + entry, run.swath, run.platform, - f"{day:%Y-%m-%d}", - {name: results[name] for name in GATED}, + period=f"{day:%Y-%m-%d}", + metrics={name: results[name] for name in GATED}, ) return rng = np.random.default_rng(1) @@ -610,7 +607,6 @@ def satellite_for(time_step: float): scan_period=np.array(reference.scan_period), ) write_record( - RECORD_PATH, entry, run.swath, source=source_of(__file__), @@ -676,7 +672,7 @@ def main() -> None: if not arguments.sample_sizes_only: validate_swath(day, tle, entry, orbit, reference, arguments.write, run) if arguments.write: - print(f"wrote {RECORD_PATH} and {run.fixture_path}") + print(f"wrote {run.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validate_catalog_virs.py b/validation/catalog/validate_catalog_virs.py index c76bf120..f4079c6f 100644 --- a/validation/catalog/validate_catalog_virs.py +++ b/validation/catalog/validate_catalog_virs.py @@ -53,7 +53,6 @@ RemoteFile, ecef, read_element_set_file, - RECORDS, FIXTURES, source_of, ) @@ -110,7 +109,6 @@ def read_virs(_product, url: str, session, day: datetime, _directory) -> dict: beams="pixels", size_instrument="VIRS", published_footprints=PUBLISHED_FOOTPRINTS, - record_path=RECORDS / "virs.json", fixture_path=FIXTURES / "virs.npz", source=source_of(__file__), reference="GPM_1BVIRS version 08 (sample positions), with spacecraft positions of " @@ -204,7 +202,7 @@ def main() -> None: if not arguments.sample_sizes_only: validate_swath(SETUP, day, tle, entry, orbit, reference, arguments.write) if arguments.write: - print(f"wrote {SETUP.record_path} and {SETUP.fixture_path}") + print(f"wrote {SETUP.fixture_path}") if __name__ == "__main__": diff --git a/validation/catalog/validation_io.py b/validation/catalog/validation_io.py index b0eccf71..89bd50a7 100644 --- a/validation/catalog/validation_io.py +++ b/validation/catalog/validation_io.py @@ -665,21 +665,35 @@ def update_fixture(path: pathlib.Path, **arrays) -> None: np.savez_compressed(path, **add_earth_orientation({**existing, **arrays}, arrays)) -def _read_record(path: pathlib.Path, entry_id: str) -> dict: - """Reads a record, or starts one.""" +def _to_metrics(metrics: list[dict] | dict[str, float]) -> list[dict]: + """Gets metrics as records state them, from a mapping of names to values.""" + if isinstance(metrics, dict): + return [{"name": name, "value": float(v)} for name, v in metrics.items()] + return metrics + + +def _record_path(entry: InstrumentEntry) -> pathlib.Path: + """Gets the path of an entry's record.""" + return RECORDS / f"{entry.id}.json" + + +def _read_record(entry: InstrumentEntry) -> dict: + """Reads an entry's record, or starts one.""" + path = _record_path(entry) if path.exists(): return json.loads(path.read_text(encoding="utf-8")) - return {"entry_id": entry_id, "configurations": {}} + return {"entry_id": entry.id, "configurations": {}} -def _write_record(path: pathlib.Path, record: dict) -> None: - """Checks a record against its schema and writes it.""" +def _write_record(entry: InstrumentEntry, record: dict) -> None: + """Checks an entry's record against its schema and writes it.""" + path = _record_path(entry) checked = ValidationRecord(**record).model_dump(mode="json", exclude_none=True) path.write_text(json.dumps(checked, indent=2) + "\n", encoding="utf-8") + print(f"wrote {path}") def write_record( - path: pathlib.Path, entry: InstrumentEntry, key: str, *, @@ -687,15 +701,17 @@ def write_record( reference: str, period: str, platforms: list[str], - metrics: list[dict], + metrics: list[dict] | dict[str, float], fixture_metrics: dict[str, float] | None = None, ) -> None: """ Writes the results of a configuration to its entry's record, keeping those of the others, with the configuration's digest and the versions of TAT-C and of the standard. Its transfers are kept if the configuration is unchanged. + Metrics are records of `name`, `value`, and optionally `scope`, or a mapping + of names to values. """ - record = _read_record(path, entry.id) + record = _read_record(entry) digest = entry.configurations[key].digest previous = record["configurations"].get(key, {}) record["configurations"][key] = ConfigurationRecord( @@ -706,29 +722,40 @@ def write_record( reference=reference, period=period, platforms=platforms, - metrics=metrics, + metrics=_to_metrics(metrics), transfers=( previous.get("transfers", {}) if previous.get("digest") == digest else {} ), fixture_metrics=fixture_metrics or {}, ).model_dump(mode="json", exclude_none=True) - _write_record(path, record) + _write_record(entry, record) def write_transfer( - path: pathlib.Path, + entry: InstrumentEntry, key: str, platform: str, + *, period: str, - values: dict[str, float], + metrics: list[dict] | dict[str, float], ) -> None: """ Writes the results of a configuration on a platform on which it was not - tested, which do not count toward its validation, to its record. - """ - record = json.loads(path.read_text(encoding="utf-8")) - record["configurations"][key]["transfers"][platform] = Transfer( - period=period, - metrics=[{"name": name, "value": float(v)} for name, v in values.items()], + tested, which do not count toward its validation, to its record (with + metrics as for `write_record`). + + Raises: + ValueError: If the configuration has no record, or changed after it was + tested, as its next record would discard the transfer. + """ + record = _read_record(entry) + tested = record["configurations"].get(key) + if tested is None or tested["digest"] != entry.configurations[key].digest: + raise ValueError( + f"{entry.id}:{key} has no record of the configuration as cataloged; " + "write its record before its transfers" + ) + tested.setdefault("transfers", {})[platform] = Transfer( + period=period, metrics=_to_metrics(metrics) ).model_dump(mode="json", exclude_none=True) - _write_record(path, record) + _write_record(entry, record) From eaa0ffe425ffa47d04152eea39e7e800a1f38746 Mon Sep 17 00:00:00 2001 From: Paul Grogan Date: Sun, 15 Nov 2026 09:28:19 -0700 Subject: [PATCH 5/8] add xarray to the validation extra, which the ABI, AHI, and KaRIn scripts import --- pyproject.toml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/pyproject.toml b/pyproject.toml index 74108190..858e3a3d 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -123,7 +123,8 @@ validation = [ "netcdf4", "pyhdf", "requests", - "scipy" + "scipy", + "xarray" ] [tool.setuptools.dynamic] From 4d4d649136663c2b5359473e6c67eea7047b8f19 Mon Sep 17 00:00:00 2001 From: Paul Grogan Date: Sun, 15 Nov 2026 09:42:22 -0700 Subject: [PATCH 6/8] group the validation notebooks into folders by capability (orbits, instruments, coverage, limb_and_space, ground_systems, trade_studies), each with its own page, sharing one cache of downloads in docs/validation/data, with the element sets of the occultation and satellite-to-satellite notebooks in limb_and_space/elements --- CHANGELOG.md | 2 +- docs/examples/CollectOrbitGroundTrack.ipynb | 2 +- docs/examples/osse/RunOSSEHurricane.ipynb | 2 +- docs/examples/osse/RunOSSEMonsoon.ipynb | 4 +- .../ValidateCoincidenceGMIAMSR2.ipynb | 10 +-- .../ValidateFeaturesTCPRIMED.ipynb | 14 ++-- .../{ => coverage}/ValidateGridSMAP.ipynb | 6 +- .../ValidateRegionPolarSentinel1.ipynb | 6 +- .../ValidateRegionSentinel2.ipynb | 4 +- .../ValidateRevisitSentinel2.ipynb | 6 +- .../ValidateSamplingErrorIMERG.ipynb | 4 +- .../{ => coverage}/ValidateSolarLandsat.ipynb | 4 +- docs/validation/coverage/index.rst | 17 ++++ .../ValidateDopGNSS.ipynb | 10 +-- .../ValidateLatencyNOAA20.ipynb | 6 +- .../ValidateRadarNEXRAD.ipynb | 6 +- docs/validation/ground_systems/index.rst | 12 +++ docs/validation/index.rst | 77 +++-------------- .../ValidateConicalAMSR2.ipynb | 6 +- .../ValidateConicalGMI.ipynb | 6 +- .../ValidateDriftMODIS.ipynb | 6 +- .../ValidateImagerATMS.ipynb | 8 +- .../ValidateImagerCrIS.ipynb | 10 +-- .../ValidateImagerVIIRS.ipynb | 6 +- .../ValidateLidarICESat2.ipynb | 4 +- .../ValidatePointingOCO2.ipynb | 4 +- .../ValidatePushbroomMSI.ipynb | 4 +- .../{ => instruments}/ValidateSARNISAR.ipynb | 6 +- .../ValidateSARSentinel1.ipynb | 8 +- .../ValidateSampleSizes.ipynb | 4 +- .../{ => instruments}/ValidateSwathSWOT.ipynb | 4 +- .../{ => instruments}/ValidateTiltPACE.ipynb | 4 +- .../ValidateYawFlipGPM.ipynb | 4 +- docs/validation/instruments/index.rst | 24 ++++++ .../ValidateLimbMLS.ipynb | 8 +- .../ValidateLimbSABER.ipynb | 6 +- .../ValidateROCOSMIC2.ipynb | 18 ++-- .../ValidateROPlanetiQ.ipynb | 16 ++-- .../ValidateSpaceCOSMIC2.ipynb | 16 ++-- .../ValidateSpaceGRACEFO.ipynb | 10 +-- .../ValidateSpaceSOCRATES.ipynb | 6 +- .../elements}/cosmic2_2026-05-14.3le | 0 .../elements}/galileo_2026-05-14.3le | 0 .../elements}/glonass_2026-05-14.3le | 0 .../elements}/gps_2026-05-14.3le | 0 .../elements}/planetiq_2026-05-14.3le | 0 .../elements}/socrates_2026-10-25.tle | 0 docs/validation/limb_and_space/index.rst | 16 ++++ .../socrates_2026-10-25.csv | 0 .../ValidateConstellationIridium.ipynb | 4 +- .../ValidateMaintainedOrbitLandsat9.ipynb | 6 +- .../ValidateOrbitGeneration.ipynb | 6 +- .../{ => orbits}/ValidateOrbitISS.ipynb | 4 +- docs/validation/orbits/index.rst | 13 +++ docs/validation/standard.rst | 2 +- docs/validation/summary.rst | 84 +++++++++---------- .../ValidateCostVarianceNSOSA.ipynb | 0 docs/validation/trade_studies/index.rst | 10 +++ 58 files changed, 280 insertions(+), 245 deletions(-) rename docs/validation/{ => coverage}/ValidateCoincidenceGMIAMSR2.ipynb (99%) rename docs/validation/{ => coverage}/ValidateFeaturesTCPRIMED.ipynb (99%) rename docs/validation/{ => coverage}/ValidateGridSMAP.ipynb (99%) rename docs/validation/{ => coverage}/ValidateRegionPolarSentinel1.ipynb (99%) rename docs/validation/{ => coverage}/ValidateRegionSentinel2.ipynb (99%) rename docs/validation/{ => coverage}/ValidateRevisitSentinel2.ipynb (99%) rename docs/validation/{ => coverage}/ValidateSamplingErrorIMERG.ipynb (99%) rename docs/validation/{ => coverage}/ValidateSolarLandsat.ipynb (99%) create mode 100644 docs/validation/coverage/index.rst rename docs/validation/{ => ground_systems}/ValidateDopGNSS.ipynb (99%) rename docs/validation/{ => ground_systems}/ValidateLatencyNOAA20.ipynb (99%) rename docs/validation/{ => ground_systems}/ValidateRadarNEXRAD.ipynb (99%) create mode 100644 docs/validation/ground_systems/index.rst rename docs/validation/{ => instruments}/ValidateConicalAMSR2.ipynb (99%) rename docs/validation/{ => instruments}/ValidateConicalGMI.ipynb (99%) rename docs/validation/{ => instruments}/ValidateDriftMODIS.ipynb (99%) rename docs/validation/{ => instruments}/ValidateImagerATMS.ipynb (99%) rename docs/validation/{ => instruments}/ValidateImagerCrIS.ipynb (99%) rename docs/validation/{ => instruments}/ValidateImagerVIIRS.ipynb (99%) rename docs/validation/{ => instruments}/ValidateLidarICESat2.ipynb (99%) rename docs/validation/{ => instruments}/ValidatePointingOCO2.ipynb (99%) rename docs/validation/{ => instruments}/ValidatePushbroomMSI.ipynb (99%) rename docs/validation/{ => instruments}/ValidateSARNISAR.ipynb (99%) rename docs/validation/{ => instruments}/ValidateSARSentinel1.ipynb (99%) rename docs/validation/{ => instruments}/ValidateSampleSizes.ipynb (99%) rename docs/validation/{ => instruments}/ValidateSwathSWOT.ipynb (99%) rename docs/validation/{ => instruments}/ValidateTiltPACE.ipynb (99%) rename docs/validation/{ => instruments}/ValidateYawFlipGPM.ipynb (99%) create mode 100644 docs/validation/instruments/index.rst rename docs/validation/{ => limb_and_space}/ValidateLimbMLS.ipynb (99%) rename docs/validation/{ => limb_and_space}/ValidateLimbSABER.ipynb (99%) rename docs/validation/{ => limb_and_space}/ValidateROCOSMIC2.ipynb (99%) rename docs/validation/{ => limb_and_space}/ValidateROPlanetiQ.ipynb (99%) rename docs/validation/{ => limb_and_space}/ValidateSpaceCOSMIC2.ipynb (97%) rename docs/validation/{ => limb_and_space}/ValidateSpaceGRACEFO.ipynb (99%) rename docs/validation/{ => limb_and_space}/ValidateSpaceSOCRATES.ipynb (98%) rename docs/validation/{ => limb_and_space/elements}/cosmic2_2026-05-14.3le (100%) rename docs/validation/{ => limb_and_space/elements}/galileo_2026-05-14.3le (100%) rename docs/validation/{ => limb_and_space/elements}/glonass_2026-05-14.3le (100%) rename docs/validation/{ => limb_and_space/elements}/gps_2026-05-14.3le (100%) rename docs/validation/{ => limb_and_space/elements}/planetiq_2026-05-14.3le (100%) rename docs/validation/{ => limb_and_space/elements}/socrates_2026-10-25.tle (100%) create mode 100644 docs/validation/limb_and_space/index.rst rename docs/validation/{ => limb_and_space}/socrates_2026-10-25.csv (100%) rename docs/validation/{ => orbits}/ValidateConstellationIridium.ipynb (99%) rename docs/validation/{ => orbits}/ValidateMaintainedOrbitLandsat9.ipynb (99%) rename docs/validation/{ => orbits}/ValidateOrbitGeneration.ipynb (99%) rename docs/validation/{ => orbits}/ValidateOrbitISS.ipynb (99%) create mode 100644 docs/validation/orbits/index.rst rename docs/validation/{ => trade_studies}/ValidateCostVarianceNSOSA.ipynb (100%) create mode 100644 docs/validation/trade_studies/index.rst diff --git a/CHANGELOG.md b/CHANGELOG.md index 3689a4e6..208130b8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -50,7 +50,7 @@ Added: Changed: - The OSSE examples (`RunOSSEMonsoon`, `RunOSSEHurricane`) are in `docs/examples/osse`, and download the Nature Run to a `data` directory beside them. - - The validation notebooks are grouped by capability, as in the summary of their results. Notebook `ValidateGeostationaryGOES` is removed: the validation of the catalog's ABI entry tests the same products. The ATMS, CrIS, VIIRS, MODIS, AMSR2, GMI, NISAR, and Sentinel-1 notebooks no longer test the passes, epochs, and swath areas that the validation of the catalog's entries tests on held-out data. + - The validation notebooks are grouped by capability, as in the summary of their results, in folders of `docs/validation` (`orbits`, `instruments`, `coverage`, `limb_and_space`, `ground_systems`, and `trade_studies`), each with its own page; they share one cache of downloads (`docs/validation/data`), and the element sets of the occultation and satellite-to-satellite notebooks are in `limb_and_space/elements`. Notebook `ValidateGeostationaryGOES` is removed: the validation of the catalog's ABI entry tests the same products. The ATMS, CrIS, VIIRS, MODIS, AMSR2, GMI, NISAR, and Sentinel-1 notebooks no longer test the passes, epochs, and swath areas that the validation of the catalog's entries tests on held-out data. - Instruments reject unknown fields, rather than ignoring them: a misspelled field in the data of a `PointedInstrument` previously gave an `Instrument` with a field of regard of 180 degrees. - Dumping a `Satellite` or other system with a `PointedInstrument` or `ConicalInstrument` keeps the fields of its class, and loading the data restores it. Previously, these instruments were written and restored as a base `Instrument`, without a warning. Data written by earlier versions lacks these fields, so it still loads as an `Instrument`. - Dumping a space system with an `attitude` omits the `velocity_frame` of its instruments, which the attitude sets, so the data can be loaded. diff --git a/docs/examples/CollectOrbitGroundTrack.ipynb b/docs/examples/CollectOrbitGroundTrack.ipynb index 8df9b644..056a1be3 100644 --- a/docs/examples/CollectOrbitGroundTrack.ipynb +++ b/docs/examples/CollectOrbitGroundTrack.ipynb @@ -669,7 +669,7 @@ "source": [ "## Compare a Detailed VIIRS Model\n", "\n", - "The VIIRS instrument above is a simple model: a nadir `Instrument` whose field of regard spans a nominal 3,000 km swath, so that its footprint at each time is a circle around the sub-satellite point. The [VIIRS validation](../validation/ValidateImagerVIIRS.ipynb) fits a more detailed model to NOAA-20's geolocated pixels:\n", + "The VIIRS instrument above is a simple model: a nadir `Instrument` whose field of regard spans a nominal 3,000 km swath, so that its footprint at each time is a circle around the sub-satellite point. The [VIIRS validation](../validation/instruments/ValidateImagerVIIRS.ipynb) fits a more detailed model to NOAA-20's geolocated pixels:\n", "\n", "* **Scan extent.** VIIRS samples scan angles from -56.13 to +55.96 deg (positive to the left): a `PointedInstrument` whose cross-track field of view spans them, rolled 0.085 deg to the right.\n", "* **Scan geometry.** Each scan images 16 detector rows, which subtend a constant angle along track at every scan angle, so that scans grow longer toward the swath edges (the \"bow tie\" effect). `ViewGeometry.SCAN` represents this.\n", diff --git a/docs/examples/osse/RunOSSEHurricane.ipynb b/docs/examples/osse/RunOSSEHurricane.ipynb index 80776214..7477513d 100644 --- a/docs/examples/osse/RunOSSEHurricane.ipynb +++ b/docs/examples/osse/RunOSSEHurricane.ipynb @@ -9,7 +9,7 @@ "\n", "An observing system simulation experiment (OSSE) evaluates how well an observing system, real or planned, would observe a phenomenon, by sampling a high-resolution model simulation (the *nature run*) as the system would. This example is an OSSE of a **hurricane** in the 7-km [GEOS-5 Nature Run (G5NR)](https://gmao.gsfc.nasa.gov/global_mesoscale/7km-G5NR/). In late August of the Nature Run's second year, a simulated hurricane crosses the North Atlantic from near the Cape Verde Islands (about 15 N, 27 W on 20 August) to Nova Scotia (30 August). This example covers two days, 25 and 26 August, when the storm passes north of Puerto Rico and Hispaniola and begins to recurve to the north.\n", "\n", - "The observing systems are the same as in the [monsoon OSSE](RunOSSEMonsoon.ipynb): the atmospheric sounders on the current NOAA/NASA polar-orbiting satellites ([ATMS](../../validation/ValidateImagerATMS.ipynb) and [CrIS](../../validation/ValidateImagerCrIS.ipynb)) and two notional future sounders with finer resolution. Unlike the monsoon, whose features are scattered convective cells over land with a strong diurnal cycle, the features here are organized around one large storm over the ocean. Two kinds of features are defined:\n", + "The observing systems are the same as in the [monsoon OSSE](RunOSSEMonsoon.ipynb): the atmospheric sounders on the current NOAA/NASA polar-orbiting satellites ([ATMS](../../validation/instruments/ValidateImagerATMS.ipynb) and [CrIS](../../validation/instruments/ValidateImagerCrIS.ipynb)) and two notional future sounders with finer resolution. Unlike the monsoon, whose features are scattered convective cells over land with a strong diurnal cycle, the features here are organized around one large storm over the ocean. Two kinds of features are defined:\n", "\n", "* **cold cloud tops**, as in the monsoon OSSE, which outline the storm's central dense overcast and the convective cells of its rainbands; and\n", "* **heavy precipitation**, which outlines its eyewall and rainbands, where microwave sounders sense the rain and ice beneath the cloud tops.\n", diff --git a/docs/examples/osse/RunOSSEMonsoon.ipynb b/docs/examples/osse/RunOSSEMonsoon.ipynb index 9958f9f5..251929fb 100644 --- a/docs/examples/osse/RunOSSEMonsoon.ipynb +++ b/docs/examples/osse/RunOSSEMonsoon.ipynb @@ -7,7 +7,7 @@ "source": [ "# OSSE: North American Monsoon Convection\n", "\n", - "An observing system simulation experiment (OSSE) evaluates how well an observing system, real or planned, would observe a phenomenon, by sampling a high-resolution model simulation (the *nature run*) as the system would. This example is an OSSE of **convection during the North American Monsoon**. The nature run is the 7-km [GEOS-5 Nature Run (G5NR)](https://gmao.gsfc.nasa.gov/global_mesoscale/7km-G5NR/). The *features* of interest are patches of very cold cloud tops over the American Southwest. The observing systems are the atmospheric sounders on the current NOAA/NASA polar-orbiting satellites ([ATMS](../../validation/ValidateImagerATMS.ipynb) and [CrIS](../../validation/ValidateImagerCrIS.ipynb)) and two notional future sounders with finer resolution.\n", + "An observing system simulation experiment (OSSE) evaluates how well an observing system, real or planned, would observe a phenomenon, by sampling a high-resolution model simulation (the *nature run*) as the system would. This example is an OSSE of **convection during the North American Monsoon**. The nature run is the 7-km [GEOS-5 Nature Run (G5NR)](https://gmao.gsfc.nasa.gov/global_mesoscale/7km-G5NR/). The *features* of interest are patches of very cold cloud tops over the American Southwest. The observing systems are the atmospheric sounders on the current NOAA/NASA polar-orbiting satellites ([ATMS](../../validation/instruments/ValidateImagerATMS.ipynb) and [CrIS](../../validation/instruments/ValidateImagerCrIS.ipynb)) and two notional future sounders with finer resolution.\n", "\n", "The experiment asks two questions about each feature:\n", "\n", @@ -1179,7 +1179,7 @@ "\n", "**Platforms.** The current constellation of sounders is Suomi NPP, NOAA-20, and NOAA-21, three satellites in a sun-synchronous orbit with an ascending node of about 13:30 local time. Each carries both the Advanced Technology Microwave Sounder (ATMS) and the Cross-track Infrared Sounder (CrIS).\n", "\n", - "**Swaths.** The swaths of ATMS and CrIS come from TAT-C's [instrument catalog](../../validation/catalog.rst) (`tatc.catalog`), whose swath configurations of NOAA-20 (`swath_noaa_20` of ATMS and `swath` of CrIS) were tested against its data: each is a rectangular `PointedInstrument` spanning the scan positions measured in the validation notebooks ([ATMS](../../validation/ValidateImagerATMS.ipynb) and [CrIS](../../validation/ValidateImagerCrIS.ipynb)), with CrIS's scan plane tilted forward as measured, on a satellite whose attitude scans perpendicular to the inertial velocity (`VelocityFrame.INERTIAL`) rather than to the ground track. The catalog tailors the along-track field of view to the 30 s time step, so that consecutive footprints tile the swath. The configurations of NOAA-20 are used for all three satellites, so NOAA-21 and Suomi NPP are assumed identical to it.\n", + "**Swaths.** The swaths of ATMS and CrIS come from TAT-C's [instrument catalog](../../validation/catalog.rst) (`tatc.catalog`), whose swath configurations of NOAA-20 (`swath_noaa_20` of ATMS and `swath` of CrIS) were tested against its data: each is a rectangular `PointedInstrument` spanning the scan positions measured in the validation notebooks ([ATMS](../../validation/instruments/ValidateImagerATMS.ipynb) and [CrIS](../../validation/instruments/ValidateImagerCrIS.ipynb)), with CrIS's scan plane tilted forward as measured, on a satellite whose attitude scans perpendicular to the inertial velocity (`VelocityFrame.INERTIAL`) rather than to the ground track. The catalog tailors the along-track field of view to the 30 s time step, so that consecutive footprints tile the swath. The configurations of NOAA-20 are used for all three satellites, so NOAA-21 and Suomi NPP are assumed identical to it.\n", "\n", "**Resolution.** Each sensor has a horizontal resolution (the diameter of its footprint at nadir) and a sample spacing (the distance between the centers of neighboring footprints at nadir). A sensor cannot resolve detail finer than either its footprint or its sample spacing, so its *resolution element* is the larger of the two. ATMS oversamples (its 2.2 degree beams overlap at a 1.11 degree spacing), so its footprint limits it. CrIS undersamples slightly (its 0.963 degree views leave gaps at a 1.09 degree pitch), so its sample spacing limits it. The future sensors are assumed to sample in proportion to their footprints, in the same ratio as their heritage counterparts, so a future infrared sounder has as many more views per scan as its finer footprint requires.\n", "\n", diff --git a/docs/validation/ValidateCoincidenceGMIAMSR2.ipynb b/docs/validation/coverage/ValidateCoincidenceGMIAMSR2.ipynb similarity index 99% rename from docs/validation/ValidateCoincidenceGMIAMSR2.ipynb rename to docs/validation/coverage/ValidateCoincidenceGMIAMSR2.ipynb index 9474b363..3ac7c167 100644 --- a/docs/validation/ValidateCoincidenceGMIAMSR2.ipynb +++ b/docs/validation/coverage/ValidateCoincidenceGMIAMSR2.ipynb @@ -11,7 +11,7 @@ "\n", "TAT-C finds coincidences in two ways, both validated here against the instruments' recorded sample positions:\n", "\n", - "1. **Passes.** Does `collect_observations` predict the passes of each instrument over a global grid of points, the basis of the point coincidences? (The scan geometry of both instruments is validated in the [AMSR2](ValidateConicalAMSR2.ipynb) and [GMI](ValidateConicalGMI.ipynb) conical scanner notebooks.)\n", + "1. **Passes.** Does `collect_observations` predict the passes of each instrument over a global grid of points, the basis of the point coincidences? (The scan geometry of both instruments is validated in the [AMSR2](../instruments/ValidateConicalAMSR2.ipynb) and [GMI](../instruments/ValidateConicalGMI.ipynb) conical scanner notebooks.)\n", "2. **Coincident observations.** Does `find_coincident_observations` find the points observed by both instruments within 15 minutes, and the time difference between their observations?\n", "3. **Coincident ground track.** Does `find_coincident_ground_track` find the areas observed by both instruments within 15 minutes?" ] @@ -23,7 +23,7 @@ "source": [ "## Reference Data\n", "\n", - "The Level 1C products of both instruments (`GPM_1CGPMGMI` and `GPM_1CGCOMW1AMSR2`, version 8, from NASA's [GES DISC](https://disc.gsfc.nasa.gov/); free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account required) record the time of each scan and the position of each sample: 221 per scan for GMI's low-frequency feed (S1, 10 to 89 GHz) every 1.875 s, and 243 per scan for AMSR2's low-resolution samples (S1) every 1.5 s. The day's orbit files (16 for GMI and 15 for AMSR2) are downloaded once, and the scan times and sample positions are cached in local `data/gmi` and `data/amsr2` directories (shared with the conical scanner notebooks). GMI recorded the whole day; AMSR2's record has a gap of 3.3 hours, during which coincidences are not compared. GPM flew in its forward orientation (`SCorientation` 0) all day, as in the GMI notebook." + "The Level 1C products of both instruments (`GPM_1CGPMGMI` and `GPM_1CGCOMW1AMSR2`, version 8, from NASA's [GES DISC](https://disc.gsfc.nasa.gov/); free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account required) record the time of each scan and the position of each sample: 221 per scan for GMI's low-frequency feed (S1, 10 to 89 GHz) every 1.875 s, and 243 per scan for AMSR2's low-resolution samples (S1) every 1.5 s. The day's orbit files (16 for GMI and 15 for AMSR2) are downloaded once, and the scan times and sample positions are cached in local `../data/gmi` and `../data/amsr2` directories (shared with the conical scanner notebooks). GMI recorded the whole day; AMSR2's record has a gap of 3.3 hours, during which coincidences are not compared. GPM flew in its forward orientation (`SCorientation` 0) all day, as in the GMI notebook." ] }, { @@ -196,7 +196,7 @@ "\n", "data = {}\n", "for instrument, (short_name, directory, file_name, swaths) in PRODUCTS.items():\n", - " cache_file = Path(\"data\") / directory / file_name\n", + " cache_file = Path(\"../data\") / directory / file_name\n", " cache_file.parent.mkdir(parents=True, exist_ok=True)\n", " if not cache_file.exists():\n", " download(short_name, cache_file, swaths)\n", @@ -245,7 +245,7 @@ "\n", "The instruments are modeled with the `ConicalInstrument` parameters fitted in the conical scanner notebooks (cone angle, and the center and half-width of the scanned sector, relative to the inertial velocity, as neither spacecraft is yaw-steered), on orbits from published two-line element sets (TLEs). The TLE of GPM has an epoch 8 days after the analysis day (as in the GMI notebook), and is about 11 km ahead of GPM's recorded position along track, so GMI's predicted observations come about 1.5 s early; the AMSR2 TLE is within about 1 km.\n", "\n", - "The points form a Fibonacci lattice about 50 km apart, between 75 deg south and north (GMI's swath reaches about 70 deg). A point is observed on a pass when a sample lies within 8 km of it (about half the spacing of the samples along and between scans), at the time of the nearest sample; TAT-C's passes are those of `collect_observations` (at their `epoch`, when the scan crosses the point). Its run of about five minutes is cached in a local `data/coincidence` directory. Observed and predicted passes are paired by point within 60 s, outside the instruments' data gaps." + "The points form a Fibonacci lattice about 50 km apart, between 75 deg south and north (GMI's swath reaches about 70 deg). A point is observed on a pass when a sample lies within 8 km of it (about half the spacing of the samples along and between scans), at the time of the nearest sample; TAT-C's passes are those of `collect_observations` (at their `epoch`, when the scan crosses the point). Its run of about five minutes is cached in a local `../data/coincidence` directory. Observed and predicted passes are paired by point within 60 s, outside the instruments' data gaps." ] }, { @@ -455,7 +455,7 @@ "\n", "\n", "truth = {instrument: true_passes(d) for instrument, d in data.items()}\n", - "cache = Path(\"data\") / \"coincidence\" / f\"observations_{DAY:%Y%m%d}.pkl\"\n", + "cache = Path(\"../data\") / \"coincidence\" / f\"observations_{DAY:%Y%m%d}.pkl\"\n", "cache.parent.mkdir(parents=True, exist_ok=True)\n", "if not cache.exists():\n", " tic = time.perf_counter()\n", diff --git a/docs/validation/ValidateFeaturesTCPRIMED.ipynb b/docs/validation/coverage/ValidateFeaturesTCPRIMED.ipynb similarity index 99% rename from docs/validation/ValidateFeaturesTCPRIMED.ipynb rename to docs/validation/coverage/ValidateFeaturesTCPRIMED.ipynb index b3cf7c34..68a86827 100644 --- a/docs/validation/ValidateFeaturesTCPRIMED.ipynb +++ b/docs/validation/coverage/ValidateFeaturesTCPRIMED.ipynb @@ -11,7 +11,7 @@ "\n", "For every tropical cyclone, TC PRIMED collects the overpasses that cover enough of the storm from the passive microwave imagers and sounders of the Global Precipitation Measurement (GPM) constellation. Whether an overpass is kept is a geometric decision: it depends on how much of a circle around the storm's center the swath covers.\n", "\n", - "In TAT-C, `collect_feature_observations` collects observations of *features*: regions that exist for a period of time, such as the storms of a nature run in an observing system simulation experiment (OSSE; see the [hurricane OSSE example](../examples/osse/RunOSSEHurricane.ipynb)). Each observation is one satellite's view of the part of a feature inside its swath, together with the fraction of the feature's area viewed.\n", + "In TAT-C, `collect_feature_observations` collects observations of *features*: regions that exist for a period of time, such as the storms of a nature run in an observing system simulation experiment (OSSE; see the [hurricane OSSE example](../../examples/osse/RunOSSEHurricane.ipynb)). Each observation is one satellite's view of the part of a feature inside its swath, together with the fraction of the feature's area viewed.\n", "\n", "Here, the features are TC PRIMED's circles around each storm, at its best-track position. TAT-C reproduces TC PRIMED's selection of overpasses for the 13 Atlantic tropical cyclones of 2025, by 10 satellites carrying five sensors:\n", "* **Cross-track sounders:** ATMS on Suomi NPP, NOAA-20, and NOAA-21, and MHS on Metop-B and Metop-C.\n", @@ -49,7 +49,7 @@ "**Element sets.** The satellites' orbits are modeled with the history of their two-line element sets from [Space-Track.org](https://www.space-track.org/), which requires a free account and does not allow the data to be redistributed. To set this up:\n", "\n", "1. Download the element sets of the 10 satellites (NORAD catalog numbers 37849, 43013, 54234, 38771, 43689, 38337, 39574, 28054, 29522, and 35951) with epochs from 15 June to 8 November 2025, in three-line format. For example, use the query `https://www.space-track.org/basicspacedata/query/class/gp_history/NORAD_CAT_ID/37849,43013,54234,38337,39574,38771,43689,28054,29522,35951/EPOCH/2025-06-15--2025-11-08/orderby/NORAD_CAT_ID,EPOCH/format/3le`.\n", - "2. Save them as `data/orbits/tcprimed_2025_gp_history.tle`.\n", + "2. Save them as `../data/orbits/tcprimed_2025_gp_history.tle`.\n", "\n", "TAT-C propagates each time from the element set nearest to it." ] @@ -263,11 +263,11 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"tcprimed\"\n", + "DATA_DIR = Path(\"../data\") / \"tcprimed\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "BUCKET = \"https://noaa-nesdis-tcprimed-pds.s3.amazonaws.com/\"\n", "PREFIX = \"v01r01/final/2025/AL/\"\n", - "TLE_FILE = Path(\"data\") / \"orbits\" / \"tcprimed_2025_gp_history.tle\"\n", + "TLE_FILE = Path(\"../data\") / \"orbits\" / \"tcprimed_2025_gp_history.tle\"\n", "TRACKS_FILE, OVERPASSES_FILE = (\n", " DATA_DIR / \"tracks_2025_AL.csv\",\n", " DATA_DIR / \"overpasses_2025_AL.csv\",\n", @@ -680,7 +680,7 @@ "* for a cross-track scanner, the scan angle and the angle out of the scan plane (`compute_view_angles`); and\n", "* for a conical scanner, the cone angle and scan azimuth (`compute_cone_and_azimuth`).\n", "\n", - "This follows the companion notebooks ([ATMS](ValidateImagerATMS.ipynb), [AMSR2](ValidateConicalAMSR2.ipynb), and [GMI](ValidateConicalGMI.ipynb)). The scan center is the mean azimuth of the first and last samples of each scan. Scan times are given to the nearest second, which adds about 0.5 deg of scatter to the along-track angles." + "This follows the companion notebooks ([ATMS](../instruments/ValidateImagerATMS.ipynb), [AMSR2](../instruments/ValidateConicalAMSR2.ipynb), and [GMI](../instruments/ValidateConicalGMI.ipynb)). The scan center is the mean azimuth of the first and last samples of each scan. Scan times are given to the nearest second, which adds about 0.5 deg of scatter to the along-track angles." ] }, { @@ -1262,13 +1262,13 @@ "source": [ "**Cross-track sounders.**\n", "* **Scan angles:** the S1 samples of ATMS reach 52.65 to 52.72 deg left and 52.66 to 52.78 deg right of nadir (on the three satellites); those of MHS reach 49.45 deg left and 49.44 deg right.\n", - "* **ATMS:** its samples stay in the scan plane most closely in the inertial frame, with a standard deviation of the angle out of the plane of 0.2 to 0.6 deg (1.6 to 1.8 deg in the Earth-fixed frame). This matches the [ATMS validation](ValidateImagerATMS.ipynb).\n", + "* **ATMS:** its samples stay in the scan plane most closely in the inertial frame, with a standard deviation of the angle out of the plane of 0.2 to 0.6 deg (1.6 to 1.8 deg in the Earth-fixed frame). This matches the [ATMS validation](../instruments/ValidateImagerATMS.ipynb).\n", "* **MHS:** its samples stay in the plane most closely in the Earth-fixed frame (0.22 deg, against 1.6 to 1.7 deg inertial), because the Metop satellites are yaw steered.\n", "\n", "**Conical scanners.**\n", "* **Cone angles:** 47.63 deg for AMSR2, 48.52 deg for GMI, and 45.34 to 45.66 deg for SSMIS.\n", "* **Scan sectors:** +/-75.0 deg for AMSR2, +/-75.7 deg for GMI, and +/-70.8 to 70.9 deg for SSMIS, all looking forward. They are centered within 1.7 deg of the inertial velocity, with a scatter of the center of 0.01 to 0.04 deg (2 to 3 deg in the Earth-fixed frame), so none of these satellites is yaw steered.\n", - "* **GPM's orientation:** in 49% of GPM's overpasses, GMI's scans are centered behind the satellite. GPM periodically turns around and flies backward for weeks at a time (see the [GPM yaw flip validation](ValidateYawFlipGPM.ipynb)). Its orientation in each overpass gives an `AttitudeSchedule` of yaw angles (0 or 180 deg, in the inertial frame), with each flip placed midway between the last overpass in one orientation and the first in the other: backward until 20 July, forward until 7 September, backward until 22 October, and forward thereafter.\n", + "* **GPM's orientation:** in 49% of GPM's overpasses, GMI's scans are centered behind the satellite. GPM periodically turns around and flies backward for weeks at a time (see the [GPM yaw flip validation](../instruments/ValidateYawFlipGPM.ipynb)). Its orientation in each overpass gives an `AttitudeSchedule` of yaw angles (0 or 180 deg, in the inertial frame), with each flip placed midway between the last overpass in one orientation and the first in the other: backward until 20 July, forward until 7 September, backward until 22 October, and forward thereafter.\n", "\n", "Each sensor's S1 swath is therefore modeled as follows: a cross-track sensor is a `PointedInstrument` spanning the outermost samples, and a conical sensor is a `ConicalInstrument` with the measured cone and scan sector. Each flies on a satellite with the measured velocity frame (an inertial `Attitude` where needed, and the schedule for GPM)." ] diff --git a/docs/validation/ValidateGridSMAP.ipynb b/docs/validation/coverage/ValidateGridSMAP.ipynb similarity index 99% rename from docs/validation/ValidateGridSMAP.ipynb rename to docs/validation/coverage/ValidateGridSMAP.ipynb index 1864030f..b052d394 100644 --- a/docs/validation/ValidateGridSMAP.ipynb +++ b/docs/validation/coverage/ValidateGridSMAP.ipynb @@ -21,7 +21,7 @@ "source": [ "## Reference Data\n", "\n", - "SMAP's Level-1C brightness temperatures (`SPL1CTB`, version 6, from the [NSIDC DAAC](https://nsidc.org/data/smap); free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account required) are resampled to the 36 km global Equal-Area Scalable Earth grid (EASE-Grid 2.0), one file per half orbit, and record for each cell the time of the forward and aft looks (the weighted mean time of the footprints centered in it). The day's half orbits are downloaded once (keeping the latest version of each), and the look times are cached in a local `data/smap` directory.\n", + "SMAP's Level-1C brightness temperatures (`SPL1CTB`, version 6, from the [NSIDC DAAC](https://nsidc.org/data/smap); free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account required) are resampled to the 36 km global Equal-Area Scalable Earth grid (EASE-Grid 2.0), one file per half orbit, and record for each cell the time of the forward and aft looks (the weighted mean time of the footprints centered in it). The day's half orbits are downloaded once (keeping the latest version of each), and the look times are cached in a local `../data/smap` directory.\n", "\n", "The look times are converted to UTC from the seconds since J2000 (noon TT on 1 January 2000). The products' own UTC strings (`cell_tb_time_utc_fore` and `_aft`) add these seconds to noon UTC, and are 69.184 s late (the difference between TT and UTC). The archive lacks a few half orbits late in the day, whose times are excluded from the comparisons." ] @@ -59,7 +59,7 @@ "\n", "from tatc.constants import timescale\n", "\n", - "DATA_DIR = Path(\"data\") / \"smap\"\n", + "DATA_DIR = Path(\"../data\") / \"smap\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "DAY = datetime(2026, 10, 24, tzinfo=timezone.utc)\n", "CACHE_FILE = DATA_DIR / f\"smap_l1c_tb_{DAY:%Y%m%d}.npz\"\n", @@ -159,7 +159,7 @@ "source": [ "## Setup\n", "\n", - "SMAP is modeled as a `ConicalInstrument` scanning the full circle, with the cone angle of the median incidence angle of its looks at its mean altitude (on a spherical Earth), with an along-track field of view of 0.01 deg (so that each observation period spans the forward to the aft crossing of the circle), on an orbit from a published two-line element set (TLE) with an epoch about a day and a half after the analysis day. The points are the centers of every other cell of every other row of the EASE-Grid 2.0 (about 72 km apart), between about 81 deg south and 84 deg north. `collect_observations` reports each pass over a point as two observations, at the forward and aft crossings of the circle (`epoch`), which share the period during which the point lies inside the circle; its run of about half a minute is cached in `data/smap`." + "SMAP is modeled as a `ConicalInstrument` scanning the full circle, with the cone angle of the median incidence angle of its looks at its mean altitude (on a spherical Earth), with an along-track field of view of 0.01 deg (so that each observation period spans the forward to the aft crossing of the circle), on an orbit from a published two-line element set (TLE) with an epoch about a day and a half after the analysis day. The points are the centers of every other cell of every other row of the EASE-Grid 2.0 (about 72 km apart), between about 81 deg south and 84 deg north. `collect_observations` reports each pass over a point as two observations, at the forward and aft crossings of the circle (`epoch`), which share the period during which the point lies inside the circle; its run of about half a minute is cached in `../data/smap`." ] }, { diff --git a/docs/validation/ValidateRegionPolarSentinel1.ipynb b/docs/validation/coverage/ValidateRegionPolarSentinel1.ipynb similarity index 99% rename from docs/validation/ValidateRegionPolarSentinel1.ipynb rename to docs/validation/coverage/ValidateRegionPolarSentinel1.ipynb index 8331ed41..f40914bf 100644 --- a/docs/validation/ValidateRegionPolarSentinel1.ipynb +++ b/docs/validation/coverage/ValidateRegionPolarSentinel1.ipynb @@ -27,7 +27,7 @@ "source": [ "## Reference Data\n", "\n", - "The Sentinel-1 Level-1 Ground Range Detected (GRD) products of Sentinel-1C over the week are listed in the [Microsoft Planetary Computer](https://planetarycomputer.microsoft.com/dataset/sentinel-1-grd) catalog (no account required), with each product's mode, orbit, times, and footprint; the catalog search is cached in a local `data/sentinel1` directory. The EW and Interferometric Wide swath (IW) products are compared (a few stripmap products are not).\n", + "The Sentinel-1 Level-1 Ground Range Detected (GRD) products of Sentinel-1C over the week are listed in the [Microsoft Planetary Computer](https://planetarycomputer.microsoft.com/dataset/sentinel-1-grd) catalog (no account required), with each product's mode, orbit, times, and footprint; the catalog search is cached in a local `../data/sentinel1` directory. The EW and Interferometric Wide swath (IW) products are compared (a few stripmap products are not).\n", "\n", "The catalog footprints are polygons of the four corners of each product, with straight edges in longitude and latitude. Near the poles, a straight edge in longitude and latitude between corners tens of degrees of longitude apart lies far from the true edge of the product, which follows (nearly) a great circle toward the pole, so the footprints are redrawn with geodesic edges between their corners." ] @@ -66,7 +66,7 @@ "from pyproj import Geod\n", "from shapely.geometry import shape\n", "\n", - "DATA_DIR = Path(\"data\") / \"sentinel1\"\n", + "DATA_DIR = Path(\"../data\") / \"sentinel1\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "START = datetime(2026, 9, 29, tzinfo=timezone.utc)\n", "END = datetime(2026, 10, 6, tzinfo=timezone.utc)\n", @@ -139,7 +139,7 @@ "source": [ "## Setup\n", "\n", - "Sentinel-1C is modeled as in the [Sentinel-1 notebook](ValidateSARSentinel1.ipynb): a right-looking, rectangular `PointedInstrument` for each mode, with the roll angle and cross-track field of view fitted to the products there (EW: 28.95 deg and 23.56 deg; IW: 33.76 and 13.27 deg), oriented to the Earth-fixed velocity (the zero-Doppler geometry of SAR images). Sentinel-1 also steers its roll angle around the orbit to keep its slant range nearly constant, which the Sentinel-1 notebook fits as a satellite `Attitude` with a roll angle profile (by argument of latitude) for each mode; both the fixed roll angle and the roll steering are compared. `collect_region_observations` splits each region along the anti-meridian and the poles (`split_polygon`) before observing it, which should preserve its shape." + "Sentinel-1C is modeled as in the [Sentinel-1 notebook](../instruments/ValidateSARSentinel1.ipynb): a right-looking, rectangular `PointedInstrument` for each mode, with the roll angle and cross-track field of view fitted to the products there (EW: 28.95 deg and 23.56 deg; IW: 33.76 and 13.27 deg), oriented to the Earth-fixed velocity (the zero-Doppler geometry of SAR images). Sentinel-1 also steers its roll angle around the orbit to keep its slant range nearly constant, which the Sentinel-1 notebook fits as a satellite `Attitude` with a roll angle profile (by argument of latitude) for each mode; both the fixed roll angle and the roll steering are compared. `collect_region_observations` splits each region along the anti-meridian and the poles (`split_polygon`) before observing it, which should preserve its shape." ] }, { diff --git a/docs/validation/ValidateRegionSentinel2.ipynb b/docs/validation/coverage/ValidateRegionSentinel2.ipynb similarity index 99% rename from docs/validation/ValidateRegionSentinel2.ipynb rename to docs/validation/coverage/ValidateRegionSentinel2.ipynb index 988273a1..91bfd0ad 100644 --- a/docs/validation/ValidateRegionSentinel2.ipynb +++ b/docs/validation/coverage/ValidateRegionSentinel2.ipynb @@ -28,7 +28,7 @@ "source": [ "## Reference Data\n", "\n", - "The [Microsoft Planetary Computer](https://planetarycomputer.microsoft.com/dataset/sentinel-2-l2a) catalog of Sentinel-2 Level 2A products (anonymous access) is searched for every product whose valid data footprint intersects each region during the analysis period. Each product is a 110 km tile of one acquisition (datatake); the datatake identifies the satellite and the time at which the acquisition started (the catalog does not record the time each part of a region was imaged). An observed pass of a region is a datatake with at least one product intersecting it. The regions are the Natural Earth 1:110 million country polygons, whose coastlines are accurate to a few kilometers. Search results are cached in a local `data/sentinel2` directory.\n", + "The [Microsoft Planetary Computer](https://planetarycomputer.microsoft.com/dataset/sentinel-2-l2a) catalog of Sentinel-2 Level 2A products (anonymous access) is searched for every product whose valid data footprint intersects each region during the analysis period. Each product is a 110 km tile of one acquisition (datatake); the datatake identifies the satellite and the time at which the acquisition started (the catalog does not record the time each part of a region was imaged). An observed pass of a region is a datatake with at least one product intersecting it. The regions are the Natural Earth 1:110 million country polygons, whose coastlines are accurate to a few kilometers. Search results are cached in a local `../data/sentinel2` directory.\n", "\n", "The satellites are modeled with TLEs from [CelesTrak](https://celestrak.org/) whose epochs (4 October 2026) follow the end of the analysis period by 10 days; the revisit notebook finds that, propagated 20 days back, these TLEs are within 11 km (2B) and 3 km (2C) of the satellites' GPS positions." ] @@ -189,7 +189,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"sentinel2\"\n", + "DATA_DIR = Path(\"../data\") / \"sentinel2\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "START = datetime(2026, 9, 14, tzinfo=timezone.utc)\n", "END = datetime(2026, 9, 24, tzinfo=timezone.utc)\n", diff --git a/docs/validation/ValidateRevisitSentinel2.ipynb b/docs/validation/coverage/ValidateRevisitSentinel2.ipynb similarity index 99% rename from docs/validation/ValidateRevisitSentinel2.ipynb rename to docs/validation/coverage/ValidateRevisitSentinel2.ipynb index e59c3794..19b1f1f7 100644 --- a/docs/validation/ValidateRevisitSentinel2.ipynb +++ b/docs/validation/coverage/ValidateRevisitSentinel2.ipynb @@ -7,7 +7,7 @@ "source": [ "# Constellation Revisit Validation: Sentinel-2\n", "\n", - "The other validation notebooks compare TAT-C with observations over a single day. This notebook tests TAT-C's predictions over multiple days and multiple satellites: the passes, sample counts, and revisit periods of the three Copernicus [Sentinel-2](https://sentiwiki.copernicus.eu/web/s2-mission) satellites (2A, 2B, and 2C) over 20 days, from 14 September to 3 October 2026, or two of the constellation's 10-day repeat cycles. The Multispectral Instrument (MSI) is modeled as validated in the [Sentinel-2 MSI](ValidatePushbroomMSI.ipynb) notebook. The comparison asks four questions:\n", + "The other validation notebooks compare TAT-C with observations over a single day. This notebook tests TAT-C's predictions over multiple days and multiple satellites: the passes, sample counts, and revisit periods of the three Copernicus [Sentinel-2](https://sentiwiki.copernicus.eu/web/s2-mission) satellites (2A, 2B, and 2C) over 20 days, from 14 September to 3 October 2026, or two of the constellation's 10-day repeat cycles. The Multispectral Instrument (MSI) is modeled as validated in the [Sentinel-2 MSI](../instruments/ValidatePushbroomMSI.ipynb) notebook. The comparison asks four questions:\n", "\n", "1. **Orbit.** How does the accuracy of TAT-C's propagation of public two-line element (TLE) sets degrade over the 20 days before their epochs?\n", "2. **Passes.** Does `collect_multi_observations` predict the passes on which each satellite images points on land?\n", @@ -26,7 +26,7 @@ "\n", "The [Microsoft Planetary Computer](https://planetarycomputer.microsoft.com/dataset/sentinel-2-l2a) catalog of Sentinel-2 Level 2A products (anonymous access) is searched for every product whose valid data footprint contains a point of interest during the analysis period. Each product is a 110 km tile of one acquisition (datatake); the datatake identifies the satellite and the time at which the acquisition started (the catalog does not record the time each point was imaged). For the orbit test, the GPS ephemeris (in GPS time, 18 s ahead of UTC) of one datastrip per satellite every two days is read from the datastrip metadata.\n", "\n", - "The points of interest are those of a Fibonacci lattice with a typical spacing of 500 km that lie on land (in the Natural Earth 1:110 million land polygons) between 56 deg south and 82.8 deg north. The first run takes about 15 minutes; reduced data are cached in a local `data/sentinel2` directory.\n", + "The points of interest are those of a Fibonacci lattice with a typical spacing of 500 km that lie on land (in the Natural Earth 1:110 million land polygons) between 56 deg south and 82.8 deg north. The first run takes about 15 minutes; reduced data are cached in a local `../data/sentinel2` directory.\n", "\n", "The satellites are modeled with TLEs from [CelesTrak](https://celestrak.org/) whose epochs (4 October 2026, 11:20 to 12:20 UTC) follow the end of the analysis period by about half a day and its start by about 20 days." ] @@ -80,7 +80,7 @@ "\n", "from tatc.generation import generate_points_fibonacci_lattice\n", "\n", - "DATA_DIR = Path(\"data\") / \"sentinel2\"\n", + "DATA_DIR = Path(\"../data\") / \"sentinel2\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "START = datetime(2026, 9, 14, tzinfo=timezone.utc)\n", "END = datetime(2026, 10, 4, tzinfo=timezone.utc)\n", diff --git a/docs/validation/ValidateSamplingErrorIMERG.ipynb b/docs/validation/coverage/ValidateSamplingErrorIMERG.ipynb similarity index 99% rename from docs/validation/ValidateSamplingErrorIMERG.ipynb rename to docs/validation/coverage/ValidateSamplingErrorIMERG.ipynb index 8bd4a2ef..de09b9a4 100644 --- a/docs/validation/ValidateSamplingErrorIMERG.ipynb +++ b/docs/validation/coverage/ValidateSamplingErrorIMERG.ipynb @@ -26,7 +26,7 @@ "source": [ "## Reference Data\n", "\n", - "The IMERG Final Run half-hourly product ([`GPM_3IMERGHH`](https://disc.gsfc.nasa.gov/datasets/GPM_3IMERGHH_07/summary), version 07), distributed by the NASA Goddard Earth Sciences Data and Information Services Center (GES DISC), holds one file per half-hour with the precipitation rate (mm/h) of each 0.1 deg cell, averaged over the half-hour. Every fifth cell of the region in each direction (a 0.5 deg grid of 40 by 40 cells) is downloaded for every half-hour of June and July 2025 through the [OPeNDAP](https://opendap.earthdata.nasa.gov/) service, which subsets the files on the server (requiring a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package), and is cached in a local `data/imerg` directory (about 1 MB per month).\n", + "The IMERG Final Run half-hourly product ([`GPM_3IMERGHH`](https://disc.gsfc.nasa.gov/datasets/GPM_3IMERGHH_07/summary), version 07), distributed by the NASA Goddard Earth Sciences Data and Information Services Center (GES DISC), holds one file per half-hour with the precipitation rate (mm/h) of each 0.1 deg cell, averaged over the half-hour. Every fifth cell of the region in each direction (a 0.5 deg grid of 40 by 40 cells) is downloaded for every half-hour of June and July 2025 through the [OPeNDAP](https://opendap.earthdata.nasa.gov/) service, which subsets the files on the server (requiring a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package), and is cached in a local `../data/imerg` directory (about 1 MB per month).\n", "\n", "The times of the half-hours are taken from the file names (the start of each half-hour), as the time variable of the subsets returned by the service repeats some values." ] @@ -64,7 +64,7 @@ "import requests\n", "import xarray as xr\n", "\n", - "DATA_DIR = Path(\"data\") / \"imerg\"\n", + "DATA_DIR = Path(\"../data\") / \"imerg\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "COLLECTION = \"C2723754847-GES_DISC\" # GPM_3IMERGHH version 07\n", "LON, LAT = \"2750:5:2949\", \"800:5:999\" # every fifth 0.1 deg cell of 95 to 115 E and 10 S to 10 N\n", diff --git a/docs/validation/ValidateSolarLandsat.ipynb b/docs/validation/coverage/ValidateSolarLandsat.ipynb similarity index 99% rename from docs/validation/ValidateSolarLandsat.ipynb rename to docs/validation/coverage/ValidateSolarLandsat.ipynb index 9866fca6..e6b62e18 100644 --- a/docs/validation/ValidateSolarLandsat.ipynb +++ b/docs/validation/coverage/ValidateSolarLandsat.ipynb @@ -20,7 +20,7 @@ "source": [ "## Reference Data\n", "\n", - "The U.S. Geological Survey (USGS) [Landsat STAC catalog](https://landsatlook.usgs.gov/stac-server) (anonymous access) is searched for every Collection 2 Level-1 scene acquired during the analysis period. Each scene is a 185 km by 180 km frame of the Worldwide Reference System (WRS-2) with its footprint, its center time, and the solar elevation and azimuth at its center. Landsat acquires land and coastal areas by day and, on request, some areas at night (for example, thermal images of volcanoes and fires). The scene list (about 20 MB) is cached in a local `data/landsat` directory.\n", + "The U.S. Geological Survey (USGS) [Landsat STAC catalog](https://landsatlook.usgs.gov/stac-server) (anonymous access) is searched for every Collection 2 Level-1 scene acquired during the analysis period. Each scene is a 185 km by 180 km frame of the Worldwide Reference System (WRS-2) with its footprint, its center time, and the solar elevation and azimuth at its center. Landsat acquires land and coastal areas by day and, on request, some areas at night (for example, thermal images of volcanoes and fires). The scene list (about 20 MB) is cached in a local `../data/landsat` directory.\n", "\n", "The satellites are modeled with two-line element sets (TLEs) from [CelesTrak](https://celestrak.org/) with epochs of 4 October 2026 and OLI with its 185 km swath from a 705 km altitude." ] @@ -137,7 +137,7 @@ "from tatc.generation import generate_points_fibonacci_lattice\n", "from tatc.schemas import GeneralPerturbationsOrbit, Instrument, Point, Satellite\n", "\n", - "DATA_DIR = Path(\"data\") / \"landsat\"\n", + "DATA_DIR = Path(\"../data\") / \"landsat\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "START = datetime(2026, 9, 17, tzinfo=timezone.utc)\n", "END = datetime(2026, 10, 3, tzinfo=timezone.utc)\n", diff --git a/docs/validation/coverage/index.rst b/docs/validation/coverage/index.rst new file mode 100644 index 00000000..7dddf624 --- /dev/null +++ b/docs/validation/coverage/index.rst @@ -0,0 +1,17 @@ +================= +Coverage Analyses +================= + +These notebooks test revisit, regional and polar coverage, the observation of tropical cyclones, gridded statistics, sampling error, illumination, and coincident observations against the acquisitions and products of operational missions. Their headline results are collected in the :doc:`../summary`. + +.. toctree:: + :maxdepth: 1 + + ValidateRevisitSentinel2.ipynb + ValidateRegionSentinel2.ipynb + ValidateRegionPolarSentinel1.ipynb + ValidateFeaturesTCPRIMED.ipynb + ValidateGridSMAP.ipynb + ValidateSamplingErrorIMERG.ipynb + ValidateSolarLandsat.ipynb + ValidateCoincidenceGMIAMSR2.ipynb diff --git a/docs/validation/ValidateDopGNSS.ipynb b/docs/validation/ground_systems/ValidateDopGNSS.ipynb similarity index 99% rename from docs/validation/ValidateDopGNSS.ipynb rename to docs/validation/ground_systems/ValidateDopGNSS.ipynb index 732a91c8..67c608c8 100644 --- a/docs/validation/ValidateDopGNSS.ipynb +++ b/docs/validation/ground_systems/ValidateDopGNSS.ipynb @@ -13,7 +13,7 @@ "2. **DOP computation.** Does `compute_dop` reproduce the DOP computed independently from the satellites' broadcast ephemerides, for the same satellites and for the operational constellations as published in TLEs?\n", "3. **Tracked satellites.** How do TAT-C's visible satellites and DOP compare with the satellites the stations' receivers actually tracked?\n", "4. **Multi-GNSS clocks.** Receivers combining systems estimate a clock (or time offset) per system; how does this affect the DOP of combined constellations, and does `compute_dop` reproduce it with a clock per system?\n", - "5. **Walker designs.** Do Walker constellations generated by TAT-C provide the DOP of the operational Galileo and BeiDou constellations they model (see [Orbit and Constellation Generation](ValidateOrbitGeneration.ipynb))?" + "5. **Walker designs.** Do Walker constellations generated by TAT-C provide the DOP of the operational Galileo and BeiDou constellations they model (see [Orbit and Constellation Generation](../orbits/ValidateOrbitGeneration.ipynb))?" ] }, { @@ -29,7 +29,7 @@ "* the IGS **rapid orbits** of the GPS satellites (`IGS0OPSRAP`, SP3), accurate to a few centimeters, used to verify the broadcast ephemeris computation; and\n", "* the daily **observation files** (RINEX 3, 30 s, Hatanaka-compressed) of six stations, which record the satellites each receiver tracked; reading them requires the `hatanaka` package.\n", "\n", - "TLEs of the four constellations are retrieved from [CelesTrak](https://celestrak.org/) (epochs of 3 and 4 October 2026). All data are cached in local `data/gnss` and `data/orbits` directories (about 32 MB)." + "TLEs of the four constellations are retrieved from [CelesTrak](https://celestrak.org/) (epochs of 3 and 4 October 2026). All data are cached in local `../data/gnss` and `../data/orbits` directories (about 32 MB)." ] }, { @@ -69,8 +69,8 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"gnss\"\n", - "ORBIT_DIR = Path(\"data\") / \"orbits\"\n", + "DATA_DIR = Path(\"../data\") / \"gnss\"\n", + "ORBIT_DIR = Path(\"../data\") / \"orbits\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "ORBIT_DIR.mkdir(parents=True, exist_ok=True)\n", "DAY = datetime(2026, 10, 3, tzinfo=timezone.utc)\n", @@ -1638,7 +1638,7 @@ "\n", "## Test 5: Walker Designs\n", "\n", - "Galileo and BeiDou-3's medium Earth orbit (MEO) satellites follow Walker 24/3/1 patterns ([Orbit and Constellation Generation](ValidateOrbitGeneration.ipynb)). For each, a `WalkerConstellation` is fitted to the healthy satellites in nominal orbits (as in that notebook), and the DOP of its 24 satellites (`compute_dop`, 10 deg mask) is compared with that of the operational satellites closest to its slots." + "Galileo and BeiDou-3's medium Earth orbit (MEO) satellites follow Walker 24/3/1 patterns ([Orbit and Constellation Generation](../orbits/ValidateOrbitGeneration.ipynb)). For each, a `WalkerConstellation` is fitted to the healthy satellites in nominal orbits (as in that notebook), and the DOP of its 24 satellites (`compute_dop`, 10 deg mask) is compared with that of the operational satellites closest to its slots." ] }, { diff --git a/docs/validation/ValidateLatencyNOAA20.ipynb b/docs/validation/ground_systems/ValidateLatencyNOAA20.ipynb similarity index 99% rename from docs/validation/ValidateLatencyNOAA20.ipynb rename to docs/validation/ground_systems/ValidateLatencyNOAA20.ipynb index 95554ebb..5ef79cb8 100644 --- a/docs/validation/ValidateLatencyNOAA20.ipynb +++ b/docs/validation/ground_systems/ValidateLatencyNOAA20.ipynb @@ -21,7 +21,7 @@ "source": [ "## Reference Data\n", "\n", - "The Advanced Technology Microwave Sounder (ATMS) sensor data record (SDR) granules of NOAA-20 for 3 October 2026 are listed from NOAA's open data bucket on Amazon Web Services (`noaa-nesdis-n20-pds`, anonymous access; only file names are read). Each name gives the granule's observation start and end times (`_t`, `_e`, in UTC, about 32 s per granule) and creation time (`_c`). Granules observed on 3 October are listed from the folders of 3 and 4 October, since folders are organized by observation date. NOAA-20 is modeled with its CelesTrak two-line element (TLE) set (epoch 4 October 2026), cached in a local `data/orbits` directory." + "The Advanced Technology Microwave Sounder (ATMS) sensor data record (SDR) granules of NOAA-20 for 3 October 2026 are listed from NOAA's open data bucket on Amazon Web Services (`noaa-nesdis-n20-pds`, anonymous access; only file names are read). Each name gives the granule's observation start and end times (`_t`, `_e`, in UTC, about 32 s per granule) and creation time (`_c`). Granules observed on 3 October are listed from the folders of 3 and 4 October, since folders are organized by observation date. NOAA-20 is modeled with its CelesTrak two-line element (TLE) set (epoch 4 October 2026), cached in a local `../data/orbits` directory." ] }, { @@ -67,8 +67,8 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"latency\"\n", - "ORBIT_DIR = Path(\"data\") / \"orbits\"\n", + "DATA_DIR = Path(\"../data\") / \"latency\"\n", + "ORBIT_DIR = Path(\"../data\") / \"orbits\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "ORBIT_DIR.mkdir(parents=True, exist_ok=True)\n", "DAY = datetime(2026, 10, 3, tzinfo=timezone.utc)\n", diff --git a/docs/validation/ValidateRadarNEXRAD.ipynb b/docs/validation/ground_systems/ValidateRadarNEXRAD.ipynb similarity index 99% rename from docs/validation/ValidateRadarNEXRAD.ipynb rename to docs/validation/ground_systems/ValidateRadarNEXRAD.ipynb index 9300f0fc..24af0b3d 100644 --- a/docs/validation/ValidateRadarNEXRAD.ipynb +++ b/docs/validation/ground_systems/ValidateRadarNEXRAD.ipynb @@ -7,7 +7,7 @@ "source": [ "# Ground Radar Validation: NEXRAD\n", "\n", - "This notebook validates the ground-based radar analysis in TAT-C (`RadarStation`, `collect_radar_track`, and `compute_radar_track`, see the [Collect Radar Coverage](../examples/CollectRadarTrack.ipynb) example) against archived data from the same four NOAA NEXRAD (WSR-88D) weather radars used in the example: `KIWA` (Phoenix), `KFSX` (Flagstaff), `KYUX` (Yuma), and `KEMX` (Tucson).\n", + "This notebook validates the ground-based radar analysis in TAT-C (`RadarStation`, `collect_radar_track`, and `compute_radar_track`, see the [Collect Radar Coverage](../../examples/CollectRadarTrack.ipynb) example) against archived data from the same four NOAA NEXRAD (WSR-88D) weather radars used in the example: `KIWA` (Phoenix), `KFSX` (Flagstaff), `KYUX` (Yuma), and `KEMX` (Tucson).\n", "\n", "TAT-C's *projected track* for a radar is the area within which a target at a given height lies between the radar's lowest and highest observed elevation angles (the lowest and highest scanned beam centers, extended by half the beam width) and within its maximum range, optionally reduced by an azimuthal terrain mask. The reference here is the area each radar actually sampled, reconstructed from its own archived volume scans. The comparison asks four questions:\n", "\n", @@ -31,7 +31,7 @@ "* **20 March 2026**: widespread stratiform (winter) rain, with the radars in clear-air VCP 35.\n", "* **29 September 2026**: late monsoon showers, with the radars in precipitation VCP 212.\n", "\n", - "Terrain blockage only needs the lowest few tilts, which come first in each file. Level II files are a sequence of independently compressed records of 120 radials each, so HTTP range requests download only the records needed. A sample of complete volumes provides the full scan strategy. The first run transfers about 3 GB and takes roughly 30 minutes; only reduced results are cached in a local `data/nexrad` directory, so later runs are fast.\n", + "Terrain blockage only needs the lowest few tilts, which come first in each file. Level II files are a sequence of independently compressed records of 120 radials each, so HTTP range requests download only the records needed. A sample of complete volumes provides the full scan strategy. The first run transfers about 3 GB and takes roughly 30 minutes; only reduced results are cached in a local `../data/nexrad` directory, so later runs are fast.\n", "\n", "The official station table, the [NCEI Historical Observing Metadata Repository NEXRAD list](https://www.ncei.noaa.gov/access/homr/file/nexrad-stations.txt), provides an independent source of station coordinates and elevations." ] @@ -67,7 +67,7 @@ "\n", "logging.getLogger(\"metpy.io.nexrad\").setLevel(logging.ERROR)\n", "\n", - "DATA_DIR = Path(\"data\") / \"nexrad\"\n", + "DATA_DIR = Path(\"../data\") / \"nexrad\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "BUCKET = \"https://unidata-nexrad-level2.s3.amazonaws.com/\"\n", "STATIONS = [\"KIWA\", \"KFSX\", \"KYUX\", \"KEMX\"]\n", diff --git a/docs/validation/ground_systems/index.rst b/docs/validation/ground_systems/index.rst new file mode 100644 index 00000000..8fcea750 --- /dev/null +++ b/docs/validation/ground_systems/index.rst @@ -0,0 +1,12 @@ +============================= +Ground Systems and Navigation +============================= + +These notebooks test ground radars against NEXRAD volume scans, downlink latency against the product granules of NOAA-20, and dilution of precision against GNSS broadcast ephemerides. Their headline results are collected in the :doc:`../summary`. + +.. toctree:: + :maxdepth: 1 + + ValidateRadarNEXRAD.ipynb + ValidateLatencyNOAA20.ipynb + ValidateDopGNSS.ipynb diff --git a/docs/validation/index.rst b/docs/validation/index.rst index 421534fa..5475a67e 100644 --- a/docs/validation/index.rst +++ b/docs/validation/index.rst @@ -11,77 +11,20 @@ The following compare TAT-C analysis results with reference data from operationa catalog standard -The notebooks below are grouped as in the :doc:`summary`. Those on instruments and pointing derive the configurations of several catalog entries and explain the modeling choices behind them; the entries' results on data held out from their fits are on the :doc:`catalog` page. +The validation notebooks are grouped by capability, as in the :doc:`summary`. Those on instruments and pointing derive the configurations of several catalog entries and explain the modeling choices behind them; the entries' results on data held out from their fits are on the :doc:`catalog` page. .. toctree:: - :maxdepth: 1 - :caption: Orbits and Propagation - - ValidateOrbitGeneration.ipynb - ValidateMaintainedOrbitLandsat9.ipynb - ValidateOrbitISS.ipynb - ValidateConstellationIridium.ipynb - -.. toctree:: - :maxdepth: 1 - :caption: Instruments and Pointing - - ValidateImagerATMS.ipynb - ValidateImagerCrIS.ipynb - ValidateImagerVIIRS.ipynb - ValidateDriftMODIS.ipynb - ValidatePushbroomMSI.ipynb - ValidateConicalAMSR2.ipynb - ValidateConicalGMI.ipynb - ValidateSARNISAR.ipynb - ValidateSARSentinel1.ipynb - ValidateSwathSWOT.ipynb - ValidateLidarICESat2.ipynb - ValidateTiltPACE.ipynb - ValidatePointingOCO2.ipynb - ValidateYawFlipGPM.ipynb - ValidateSampleSizes.ipynb - -.. toctree:: - :maxdepth: 1 - :caption: Coverage Analyses - - ValidateRevisitSentinel2.ipynb - ValidateRegionSentinel2.ipynb - ValidateRegionPolarSentinel1.ipynb - ValidateFeaturesTCPRIMED.ipynb - ValidateGridSMAP.ipynb - ValidateSamplingErrorIMERG.ipynb - ValidateSolarLandsat.ipynb - ValidateCoincidenceGMIAMSR2.ipynb - -.. toctree:: - :maxdepth: 1 - :caption: Limb, Occultation, and Satellite-to-Satellite - - ValidateLimbMLS.ipynb - ValidateLimbSABER.ipynb - ValidateROCOSMIC2.ipynb - ValidateROPlanetiQ.ipynb - ValidateSpaceCOSMIC2.ipynb - ValidateSpaceGRACEFO.ipynb - ValidateSpaceSOCRATES.ipynb - -.. toctree:: - :maxdepth: 1 - :caption: Ground Systems and Navigation - - ValidateRadarNEXRAD.ipynb - ValidateLatencyNOAA20.ipynb - ValidateDopGNSS.ipynb - -.. toctree:: - :maxdepth: 1 - :caption: Trade Studies + :maxdepth: 2 + :caption: Notebooks - ValidateCostVarianceNSOSA.ipynb + orbits/index + instruments/index + coverage/index + limb_and_space/index + ground_systems/index + trade_studies/index -These notebooks download reference data on first run, except ``ValidateSampleSizes``, which reuses the data of the imager and conical scanner notebooks, and ``ValidateSpaceCOSMIC2``, which reuses the data of ``ValidateROCOSMIC2``. ``ValidateSpaceSOCRATES`` includes a sample of a SOCRATES run (data from CelesTrak). ``ValidateCostVarianceNSOSA`` needs no data: its reference values are those published in the paper it reproduces. The MLS, NISAR, AMSR2, GMI, SWOT, ICESat-2, ECOSTRESS, PACE, MODIS, OCO-2, GPM, GRACE-FO, SMAP, and IMERG data require a free `NASA Earthdata Login `_ account, and the orbit histories of the Landsat 9, TC PRIMED, and GRACE-FO notebooks a free `Space-Track.org `_ account. The notebooks require additional dependencies, which can be installed via:: +These notebooks download reference data on first run, except ``ValidateSampleSizes``, which reuses the data of the imager and conical scanner notebooks, and ``ValidateSpaceCOSMIC2``, which reuses the data of ``ValidateROCOSMIC2``. All of them cache their downloads in one ``data`` directory in ``docs/validation``, which they share (for example, element sets retrieved from CelesTrak). ``ValidateSpaceSOCRATES`` includes a sample of a SOCRATES run (data from CelesTrak). ``ValidateCostVarianceNSOSA`` needs no data: its reference values are those published in the paper it reproduces. The MLS, NISAR, AMSR2, GMI, SWOT, ICESat-2, ECOSTRESS, PACE, MODIS, OCO-2, GPM, GRACE-FO, SMAP, and IMERG data require a free `NASA Earthdata Login `_ account, and the orbit histories of the Landsat 9, TC PRIMED, and GRACE-FO notebooks a free `Space-Track.org `_ account. The notebooks require additional dependencies, which can be installed via:: pip install tatc[validation] diff --git a/docs/validation/ValidateConicalAMSR2.ipynb b/docs/validation/instruments/ValidateConicalAMSR2.ipynb similarity index 99% rename from docs/validation/ValidateConicalAMSR2.ipynb rename to docs/validation/instruments/ValidateConicalAMSR2.ipynb index 1648d2e0..81478207 100644 --- a/docs/validation/ValidateConicalAMSR2.ipynb +++ b/docs/validation/instruments/ValidateConicalAMSR2.ipynb @@ -16,13 +16,13 @@ "3. **Footprints.** How do the footprints of the candidate TAT-C instruments compare with the scanned arc and swath?\n", "4. **Observations.** Does `collect_observations` predict which points AMSR2 observes in a day, and when?\n", "\n", - "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `amsr2` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_amsr2.py`; see the [instrument catalog](catalog.rst).\n", + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `amsr2` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_amsr2.py`; see the [instrument catalog](../catalog.rst).\n", "\n", "## Reference Data\n", "\n", "The NASA Global Precipitation Measurement (GPM) mission's Level 1C AMSR2 product ([`GPM_1CGCOMW1AMSR2`](https://disc.gsfc.nasa.gov/datasets/GPM_1CGCOMW1AMSR2_08/summary), version 08), derived from JAXA's Level 1B product and distributed by the NASA Goddard Earth Sciences Data and Information Services Center (GES DISC), holds one file per orbit (about 76 MB). For each of six groups of channels, it gives the geodetic latitude and longitude of every footprint, the scan time, and the spacecraft's geodetic position at each scan. This notebook uses the lowest-frequency group (`S1`, 10.65 GHz, 243 samples per scan), whose footprints span the same scan as the other channels.\n", "\n", - "All orbits on 26 September 2026 are downloaded (about 1.2 GB; this requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package) and reduced to a cache in a local `data/amsr2` directory, so later runs are fast.\n", + "All orbits on 26 September 2026 are downloaded (about 1.2 GB; this requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package) and reduced to a cache in a local `../data/amsr2` directory, so later runs are fast.\n", "\n", "GCOM-W is modeled with a TLE from [CelesTrak](https://celestrak.org/) whose epoch (4 October 2026, 07:07 UTC) follows the analysis day by about eight days." ] @@ -64,7 +64,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"amsr2\"\n", + "DATA_DIR = Path(\"../data\") / \"amsr2\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "DAY = datetime(2026, 9, 26, tzinfo=timezone.utc)\n", "TLE = [\n", diff --git a/docs/validation/ValidateConicalGMI.ipynb b/docs/validation/instruments/ValidateConicalGMI.ipynb similarity index 99% rename from docs/validation/ValidateConicalGMI.ipynb rename to docs/validation/instruments/ValidateConicalGMI.ipynb index 4834d3db..1ee1e2b6 100644 --- a/docs/validation/ValidateConicalGMI.ipynb +++ b/docs/validation/instruments/ValidateConicalGMI.ipynb @@ -18,7 +18,7 @@ "2. **Scan geometry.** What cone angles, scan sectors, and orientation describe GMI's two feeds?\n", "3. **Footprints.** Do the conical instruments' footprints and swath widths match the scanned arcs?\n", "\n", - "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of both feeds of the catalog's `gmi` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_gmi.py`; see the [instrument catalog](catalog.rst)." + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of both feeds of the catalog's `gmi` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_gmi.py`; see the [instrument catalog](../catalog.rst)." ] }, { @@ -30,7 +30,7 @@ "\n", "The GPM Level 1C GMI product ([`GPM_1CGPMGMI`](https://disc.gsfc.nasa.gov/datasets/GPM_1CGPMGMI_08/summary), version 08), distributed by the NASA Goddard Earth Sciences Data and Information Services Center (GES DISC), holds one file per orbit with, for each of two groups of channels (`S1`, low frequency, and `S2`, high frequency; 221 samples per scan), the geodetic latitude and longitude of every footprint, the scan time, and the spacecraft's geodetic position and flight orientation at each scan.\n", "\n", - "All orbits on 3 October 2026 are downloaded (requiring a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package) and reduced to a cache in a local `data/gmi` directory.\n", + "All orbits on 3 October 2026 are downloaded (requiring a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package) and reduced to a cache in a local `../data/gmi` directory.\n", "\n", "GPM is modeled with a TLE from [CelesTrak](https://celestrak.org/) whose epoch (4 October 2026, 13:00 UTC) follows the analysis day by up to about a day and a half." ] @@ -73,7 +73,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"gmi\"\n", + "DATA_DIR = Path(\"../data\") / \"gmi\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "DAY = datetime(2026, 10, 3, tzinfo=timezone.utc)\n", "TLE = [\n", diff --git a/docs/validation/ValidateDriftMODIS.ipynb b/docs/validation/instruments/ValidateDriftMODIS.ipynb similarity index 99% rename from docs/validation/ValidateDriftMODIS.ipynb rename to docs/validation/instruments/ValidateDriftMODIS.ipynb index fbfc8234..191720c5 100644 --- a/docs/validation/ValidateDriftMODIS.ipynb +++ b/docs/validation/instruments/ValidateDriftMODIS.ipynb @@ -15,7 +15,7 @@ "2. **Local time drift.** Does a TLE reproduce the drift of Terra's local time, and over what period?\n", "3. **Scan geometry.** What are MODIS's scan angles, velocity frame, and along-track extent, and does a scan-geometry view reproduce its pixels and scan footprints?\n", "\n", - "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `modis` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_modis.py`; see the [instrument catalog](catalog.rst)." + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `modis` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_modis.py`; see the [instrument catalog](../catalog.rst)." ] }, { @@ -30,7 +30,7 @@ "* all 289 granules of 4 October 2026 (about 20 MB each): the scan times and navigation, and the geolocation of the first and last detectors of every scan at every eighth frame;\n", "* the equator crossings from the attributes of one granule every 15 days from January 2018 (211 granules).\n", "\n", - "Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; the first run transfers about 6 GB and takes about 30 minutes, and the reduced data are cached in a local `data/modis` directory. Terra's orbit is taken from its TLE from [CelesTrak](https://celestrak.org/) (epoch 6 October 2026, 07:11 UTC)." + "Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; the first run transfers about 6 GB and takes about 30 minutes, and the reduced data are cached in a local `../data/modis` directory. Terra's orbit is taken from its TLE from [CelesTrak](https://celestrak.org/) (epoch 6 October 2026, 07:11 UTC)." ] }, { @@ -74,7 +74,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"modis\"\n", + "DATA_DIR = Path(\"../data\") / \"modis\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "DAY = datetime(2026, 10, 4, tzinfo=timezone.utc)\n", "FRAME_STEP = 8\n", diff --git a/docs/validation/ValidateImagerATMS.ipynb b/docs/validation/instruments/ValidateImagerATMS.ipynb similarity index 99% rename from docs/validation/ValidateImagerATMS.ipynb rename to docs/validation/instruments/ValidateImagerATMS.ipynb index d6e2c0dd..bf826d26 100644 --- a/docs/validation/ValidateImagerATMS.ipynb +++ b/docs/validation/instruments/ValidateImagerATMS.ipynb @@ -22,7 +22,7 @@ "4. **Swath width.** Does the field of regard reproduce the ATMS swath width (`field_of_regard_to_swath_width`)?\n", "5. **Footprint size.** How large are ATMS footprints (its horizontal resolution), and how do they grow toward the swath edge?\n", "\n", - "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `atms` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_atms.py`; see the [instrument catalog](catalog.rst).\n", + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `atms` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_atms.py`; see the [instrument catalog](../catalog.rst).\n", "\n", "A companion notebook, [Imager Validation: NOAA-20 VIIRS](ValidateImagerVIIRS.ipynb), repeats the exercise for a visible and infrared imager on the same spacecraft, and [Imager Validation: NOAA-20 CrIS](ValidateImagerCrIS.ipynb) for an infrared sounder." ] @@ -39,7 +39,7 @@ "* **ATMS SDR geolocation** (`ATMS-SDR-GEO`, files `GATMO_*`): one HDF5 file per 32 s granule of 12 scans. For each scan, it gives the start and middle times and the spacecraft's Earth-fixed position and velocity at the middle time. For each beam, it gives the geodetic latitude, longitude, and height of the beam center and the satellite zenith angle.\n", "* **Two-line elements** (`TLE-AUX`): the element sets used by the JPSS ground system, one per day with an epoch at 00:00 UTC.\n", "\n", - "One full day (2 October 2026; 2,700 granules, about 0.3 GB) is downloaded with `requests` and read with `h5py` (`pip install h5py`). The first run takes a few minutes; reduced arrays are cached in a local `data/jpss` directory, so later runs are fast." + "One full day (2 October 2026; 2,700 granules, about 0.3 GB) is downloaded with `requests` and read with `h5py` (`pip install h5py`). The first run takes a few minutes; reduced arrays are cached in a local `../data/jpss` directory, so later runs are fast." ] }, { @@ -89,7 +89,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"jpss\"\n", + "DATA_DIR = Path(\"../data\") / \"jpss\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "BUCKET = \"https://noaa-nesdis-n20-pds.s3.amazonaws.com/\"\n", "DAY = datetime(2026, 10, 2, tzinfo=timezone.utc)\n", @@ -1716,7 +1716,7 @@ "\n", "**Changes to TAT-C.** This validation led to the `velocity_frame` option and exposed two problems with the rectangular `PointedInstrument`, which have been fixed: rectangular footprint polygons for wide, elongated views were inaccurate (misplaced corners and too few points along the long sides), and `collect_observations` checked a pointed instrument's view only at the midpoint of each access period, missing up to 77% of observations for a view tailored to a scan period. It now checks the view at the time the view sweeps over the point and reports that time as the epoch.\n", "\n", - "**Footprint size.** TAT-C's viewing geometry gives the zenith angle and slant range of every pixel, from which the footprint of a beam of known width follows. ATMS's 2.2 deg beam has a 32 km footprint at nadir (confirming the nominal value), which grows to about 93 km (equivalent diameter) at the swath edge. Resolution therefore depends on where in the swath a feature is observed, which the [monsoon OSSE example](../examples/osse/RunOSSEMonsoon.ipynb) accounts for.\n" + "**Footprint size.** TAT-C's viewing geometry gives the zenith angle and slant range of every pixel, from which the footprint of a beam of known width follows. ATMS's 2.2 deg beam has a 32 km footprint at nadir (confirming the nominal value), which grows to about 93 km (equivalent diameter) at the swath edge. Resolution therefore depends on where in the swath a feature is observed, which the [monsoon OSSE example](../../examples/osse/RunOSSEMonsoon.ipynb) accounts for.\n" ] } ], diff --git a/docs/validation/ValidateImagerCrIS.ipynb b/docs/validation/instruments/ValidateImagerCrIS.ipynb similarity index 99% rename from docs/validation/ValidateImagerCrIS.ipynb rename to docs/validation/instruments/ValidateImagerCrIS.ipynb index e13fecbc..9643a9a3 100644 --- a/docs/validation/ValidateImagerCrIS.ipynb +++ b/docs/validation/instruments/ValidateImagerCrIS.ipynb @@ -14,9 +14,9 @@ "1. **Orbit.** Does TAT-C's propagation of the operational two-line element (TLE) set reproduce NOAA-20's position?\n", "2. **Scan geometry.** Which scan angles, array layout, and scan plane orientation reproduce the actual scan?\n", "3. **Geolocation.** How closely do TAT-C's pixel positions (`collect_ground_pixels`) match the reported FOV positions, and how much of the difference comes from scan timing and the rotation of the FOV array, which TAT-C does not model?\n", - "4. **Footprint size.** Does the satellite viewing geometry reproduce the reported zenith angles and ranges on which the footprint size depends, and how large are CrIS footprints and how do they grow toward the swath edge? Footprint size (horizontal resolution) is the figure of merit of the [monsoon OSSE example](../examples/osse/RunOSSEMonsoon.ipynb), whose CrIS swath comes from the catalog's `cris` entry, with a field of regard and scan plane tilt measured as here.\n", + "4. **Footprint size.** Does the satellite viewing geometry reproduce the reported zenith angles and ranges on which the footprint size depends, and how large are CrIS footprints and how do they grow toward the swath edge? Footprint size (horizontal resolution) is the figure of merit of the [monsoon OSSE example](../../examples/osse/RunOSSEMonsoon.ipynb), whose CrIS swath comes from the catalog's `cris` entry, with a field of regard and scan plane tilt measured as here.\n", "\n", - "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `cris` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_cris.py`; see the [instrument catalog](catalog.rst)." + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `cris` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_cris.py`; see the [instrument catalog](../catalog.rst)." ] }, { @@ -31,7 +31,7 @@ "* **CrIS SDR geolocation** (`CrIS-SDR-GEO`, files `GCRSO_*`): one HDF5 file per 32 s granule of four 8 s scans. For each scan, it gives the start and middle times and the spacecraft's Earth-fixed position and velocity at the middle time. For each of the 30 FORs, it gives the time, and for each of its nine FOVs, the geodetic latitude, longitude, and height of the FOV center, the satellite zenith angle, and the slant range.\n", "* **Two-line elements** (`TLE-AUX`): the element sets used by the JPSS ground system, one per day with an epoch at 00:00 UTC.\n", "\n", - "Two hours of one day (12:00 to 14:00 UTC on 2 October 2026; 225 granules, about 21 MB), more than the 101-minute orbit used in the swath test, are downloaded with `requests` and read with `h5py` (`pip install h5py`). Reduced arrays are cached in a local `data/jpss` directory, so later runs are fast." + "Two hours of one day (12:00 to 14:00 UTC on 2 October 2026; 225 granules, about 21 MB), more than the 101-minute orbit used in the swath test, are downloaded with `requests` and read with `h5py` (`pip install h5py`). Reduced arrays are cached in a local `../data/jpss` directory, so later runs are fast." ] }, { @@ -81,7 +81,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"jpss\"\n", + "DATA_DIR = Path(\"../data\") / \"jpss\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "BUCKET = \"https://noaa-nesdis-n20-pds.s3.amazonaws.com/\"\n", "DAY = datetime(2026, 10, 2, tzinfo=timezone.utc)\n", @@ -2047,7 +2047,7 @@ "source": [ "## Summary\n", "\n", - "The parameters fitted to the NOAA-20 CrIS data (the catalog's `cris` entry carries a field of regard and scan plane tilt measured in the same way, from which the [monsoon OSSE example](../examples/osse/RunOSSEMonsoon.ipynb) takes its CrIS swath):" + "The parameters fitted to the NOAA-20 CrIS data (the catalog's `cris` entry carries a field of regard and scan plane tilt measured in the same way, from which the [monsoon OSSE example](../../examples/osse/RunOSSEMonsoon.ipynb) takes its CrIS swath):" ] }, { diff --git a/docs/validation/ValidateImagerVIIRS.ipynb b/docs/validation/instruments/ValidateImagerVIIRS.ipynb similarity index 99% rename from docs/validation/ValidateImagerVIIRS.ipynb rename to docs/validation/instruments/ValidateImagerVIIRS.ipynb index 218c2611..e089ef03 100644 --- a/docs/validation/ValidateImagerVIIRS.ipynb +++ b/docs/validation/instruments/ValidateImagerVIIRS.ipynb @@ -16,7 +16,7 @@ "3. **Scan footprint.** Does a rectangular `PointedInstrument` view, tailored to one scan period, reproduce the ground footprint of a VIIRS scan, including its growth toward the swath edges (the \"bow tie\" effect)?\n", "4. **Swath width.** Does the field of regard reproduce the VIIRS swath width?\n", "\n", - "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `viirs` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_viirs.py`; see the [instrument catalog](catalog.rst)." + "Passes, observation epochs, swath widths, and swath intersection over union (IoU) of the catalog's `viirs` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_viirs.py`; see the [instrument catalog](../catalog.rst)." ] }, { @@ -31,7 +31,7 @@ "* **VIIRS terrain-corrected moderate-resolution geolocation** (`VIIRS-MOD-GEO-TC`, files `GMTCO_*`): one HDF5 file per granule of 48 scans (about 86 s). For each scan, it gives the start and middle times and the spacecraft's Earth-fixed position and velocity at the middle time; for each of the 768 x 3,200 pixels (48 scans of 16 detectors), the geodetic latitude, longitude, and terrain height; and, for the granule, a *G-ring*: the vertices of a polygon outlining the granule.\n", "* **Two-line elements** (`TLE-AUX`): the element sets used by the JPSS ground system, one per day with an epoch at 00:00 UTC.\n", "\n", - "One day (2 October 2026) has 1,013 granules totaling about 27 GB, so only parts of the files are downloaded, with HTTP range requests (read with `h5py`, `pip install h5py`): the scan metadata and G-ring of every granule, which sit at the start and end of each file (about 0.8 MB each), and the pixel latitudes, longitudes, and heights (about 7 MB) of every tenth granule. The first run transfers about 1.5 GB and takes several minutes; reduced arrays are cached in a local `data/jpss` directory, so later runs are fast." + "One day (2 October 2026) has 1,013 granules totaling about 27 GB, so only parts of the files are downloaded, with HTTP range requests (read with `h5py`, `pip install h5py`): the scan metadata and G-ring of every granule, which sit at the start and end of each file (about 0.8 MB each), and the pixel latitudes, longitudes, and heights (about 7 MB) of every tenth granule. The first run transfers about 1.5 GB and takes several minutes; reduced arrays are cached in a local `../data/jpss` directory, so later runs are fast." ] }, { @@ -81,7 +81,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"jpss\"\n", + "DATA_DIR = Path(\"../data\") / \"jpss\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "BUCKET = \"https://noaa-nesdis-n20-pds.s3.amazonaws.com/\"\n", "DAY = datetime(2026, 10, 2, tzinfo=timezone.utc)\n", diff --git a/docs/validation/ValidateLidarICESat2.ipynb b/docs/validation/instruments/ValidateLidarICESat2.ipynb similarity index 99% rename from docs/validation/ValidateLidarICESat2.ipynb rename to docs/validation/instruments/ValidateLidarICESat2.ipynb index f782ea02..166d8424 100644 --- a/docs/validation/ValidateLidarICESat2.ipynb +++ b/docs/validation/instruments/ValidateLidarICESat2.ipynb @@ -21,7 +21,7 @@ "source": [ "## Reference Data\n", "\n", - "The ATLAS/ICESat-2 Land and Vegetation Height Quick Look product (ATL08QL, version 7) from the [National Snow and Ice Data Center](https://nsidc.org/data/icesat-2) (NSIDC), available within days of acquisition, reports heights for 100 m segments of each beam over land, with their locations and times. Each file covers one of 14 regions of an orbit; its orbit information includes the RGT, the time and longitude at which the orbit crosses the equator northward (ascending node), and the spacecraft orientation. Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; only the needed variables are read, with HTTP range requests. The first run takes about 15 minutes; reduced data are cached in a local `data/icesat2` directory.\n", + "The ATLAS/ICESat-2 Land and Vegetation Height Quick Look product (ATL08QL, version 7) from the [National Snow and Ice Data Center](https://nsidc.org/data/icesat-2) (NSIDC), available within days of acquisition, reports heights for 100 m segments of each beam over land, with their locations and times. Each file covers one of 14 regions of an orbit; its orbit information includes the RGT, the time and longitude at which the orbit crosses the equator northward (ascending node), and the spacecraft orientation. Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; only the needed variables are read, with HTTP range requests. The first run takes about 15 minutes; reduced data are cached in a local `../data/icesat2` directory.\n", "\n", "ICESat-2 is modeled with a TLE from [CelesTrak](https://celestrak.org/) whose epoch (4 October 2026, 13:41 UTC) follows the analysis period by 2 to 13 days." ] @@ -75,7 +75,7 @@ "from tatc.constants import EARTH_MEAN_RADIUS, timescale\n", "from tatc.schemas import GeneralPerturbationsOrbit, Point, PointedInstrument, Satellite\n", "\n", - "DATA_DIR = Path(\"data\") / \"icesat2\"\n", + "DATA_DIR = Path(\"../data\") / \"icesat2\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "START = datetime(2026, 9, 21, tzinfo=timezone.utc)\n", "END = datetime(2026, 10, 3, tzinfo=timezone.utc)\n", diff --git a/docs/validation/ValidatePointingOCO2.ipynb b/docs/validation/instruments/ValidatePointingOCO2.ipynb similarity index 99% rename from docs/validation/ValidatePointingOCO2.ipynb rename to docs/validation/instruments/ValidatePointingOCO2.ipynb index d99df60b..63edc719 100644 --- a/docs/validation/ValidatePointingOCO2.ipynb +++ b/docs/validation/instruments/ValidatePointingOCO2.ipynb @@ -32,7 +32,7 @@ "source": [ "## Reference Data\n", "\n", - "The OCO-2 Level 1B science product (`OCO2_L1B_Science`, version 11.2) from the [Goddard Earth Sciences Data and Information Services Center](https://disc.gsfc.nasa.gov/) (GES DISC) provides one HDF5 file per orbit and mode (the mode is named in the file name: `GL` for glint, `ND` for nadir, `TG` for target, and `XS` for short special segments), with, for each frame, its time, the spacecraft's inertial position and velocity and attitude angles, and the glint spot location, and, for each of its eight soundings, the geodetic location, view and solar angles. The files of 14 to 30 September 2026 (358 files) are reduced with HTTP range requests (read with `h5py`) to every tenth frame (every 3.3 s). Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; the first run takes about 20 minutes, and the reduced data are cached in a local `data/oco2` directory. OCO-2's orbit is taken from its TLE from [CelesTrak](https://celestrak.org/) (epoch 6 October 2026, 06:18 UTC)." + "The OCO-2 Level 1B science product (`OCO2_L1B_Science`, version 11.2) from the [Goddard Earth Sciences Data and Information Services Center](https://disc.gsfc.nasa.gov/) (GES DISC) provides one HDF5 file per orbit and mode (the mode is named in the file name: `GL` for glint, `ND` for nadir, `TG` for target, and `XS` for short special segments), with, for each frame, its time, the spacecraft's inertial position and velocity and attitude angles, and the glint spot location, and, for each of its eight soundings, the geodetic location, view and solar angles. The files of 14 to 30 September 2026 (358 files) are reduced with HTTP range requests (read with `h5py`) to every tenth frame (every 3.3 s). Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; the first run takes about 20 minutes, and the reduced data are cached in a local `../data/oco2` directory. OCO-2's orbit is taken from its TLE from [CelesTrak](https://celestrak.org/) (epoch 6 October 2026, 06:18 UTC)." ] }, { @@ -135,7 +135,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"oco2\"\n", + "DATA_DIR = Path(\"../data\") / \"oco2\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "FRAME_STEP = 10\n", "TLE = [\n", diff --git a/docs/validation/ValidatePushbroomMSI.ipynb b/docs/validation/instruments/ValidatePushbroomMSI.ipynb similarity index 99% rename from docs/validation/ValidatePushbroomMSI.ipynb rename to docs/validation/instruments/ValidatePushbroomMSI.ipynb index 8ba02538..7b9b6999 100644 --- a/docs/validation/ValidatePushbroomMSI.ipynb +++ b/docs/validation/instruments/ValidatePushbroomMSI.ipynb @@ -30,7 +30,7 @@ "* the **datastrip metadata**: the sensing start and stop times of each datastrip (read from the start of the file, for all datastrips) and, for one long acquisition per satellite, the satellite's Earth-fixed position and velocity from its GPS receiver at 1 s intervals (in GPS time, 18 s ahead of UTC);\n", "* the **tile metadata** of every fifth tile of those acquisitions: for each band and detector module, the viewing zenith and azimuth angles (the direction from the ground to the satellite) on a 5 km grid. The red band (B04) is used.\n", "\n", - "The first run downloads about 0.5 GB and takes several minutes; reduced data are cached in a local `data/sentinel2` directory.\n", + "The first run downloads about 0.5 GB and takes several minutes; reduced data are cached in a local `../data/sentinel2` directory.\n", "\n", "The satellites are modeled with TLEs from [CelesTrak](https://celestrak.org/) whose epochs (4 October 2026, 11:20 to 12:20 UTC) follow the analysis day by up to about a day and a half." ] @@ -128,7 +128,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"sentinel2\"\n", + "DATA_DIR = Path(\"../data\") / \"sentinel2\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "DAY = datetime(2026, 10, 3, tzinfo=timezone.utc)\n", "STAC = \"https://planetarycomputer.microsoft.com/api/stac/v1/search\"\n", diff --git a/docs/validation/ValidateSARNISAR.ipynb b/docs/validation/instruments/ValidateSARNISAR.ipynb similarity index 99% rename from docs/validation/ValidateSARNISAR.ipynb rename to docs/validation/instruments/ValidateSARNISAR.ipynb index f7e2f202..88a72149 100644 --- a/docs/validation/ValidateSARNISAR.ipynb +++ b/docs/validation/instruments/ValidateSARNISAR.ipynb @@ -17,7 +17,7 @@ "2. **Imaging geometry.** What look direction, look angles, and imaging plane do NISAR's products describe, and which TAT-C roll angle, field of view, and velocity frame reproduce them?\n", "3. **Swath edges.** How closely do the edges of TAT-C's view match the near-range and far-range edges of NISAR's images?\n", "\n", - "Passes, swath edges, swath intersection over union (IoU), and observation epochs of the catalog's `lsar` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_lsar.py`; see the [instrument catalog](catalog.rst)." + "Passes, swath edges, swath intersection over union (IoU), and observation epochs of the catalog's `lsar` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_lsar.py`; see the [instrument catalog](../catalog.rst)." ] }, { @@ -33,7 +33,7 @@ "* `metadata/orbit`: the spacecraft's Earth-fixed position and velocity (from the medium-precision orbit ephemeris) at 10 s intervals;\n", "* `metadata/geolocationGrid`: for a grid of zero-Doppler times and slant ranges, and for a set of heights above the WGS 84 ellipsoid, the geodetic longitude and latitude of the imaged point, and the incidence and elevation (look) angles.\n", "\n", - "The ASF search API (no account required) lists all RSLC products acquired on 2 October 2026 with their footprints and times. Downloading files requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; only metadata are downloaded (about 0.1 MB per product, and about 10 MB for each of a sample of products), with HTTP range requests read by `h5py`. The first run takes a few minutes; reduced arrays are cached in a local `data/nisar` directory.\n", + "The ASF search API (no account required) lists all RSLC products acquired on 2 October 2026 with their footprints and times. Downloading files requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; only metadata are downloaded (about 0.1 MB per product, and about 10 MB for each of a sample of products), with HTTP range requests read by `h5py`. The first run takes a few minutes; reduced arrays are cached in a local `../data/nisar` directory.\n", "\n", "NISAR is modeled with a TLE from [CelesTrak](https://celestrak.org/) whose epoch (3 October 2026, 22:16 UTC) follows the analysis day by up to two days." ] @@ -187,7 +187,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"nisar\"\n", + "DATA_DIR = Path(\"../data\") / \"nisar\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "DAY = datetime(2026, 10, 2, tzinfo=timezone.utc)\n", "SEARCH = \"https://api.daac.asf.alaska.edu/services/search/param\"\n", diff --git a/docs/validation/ValidateSARSentinel1.ipynb b/docs/validation/instruments/ValidateSARSentinel1.ipynb similarity index 99% rename from docs/validation/ValidateSARSentinel1.ipynb rename to docs/validation/instruments/ValidateSARSentinel1.ipynb index 4f6283ea..425d1c08 100644 --- a/docs/validation/ValidateSARSentinel1.ipynb +++ b/docs/validation/instruments/ValidateSARSentinel1.ipynb @@ -17,7 +17,7 @@ "2. **Imaging geometry.** What look direction, look angles, and imaging plane do the products describe, and which TAT-C roll angle, field of view, and velocity frame reproduce them?\n", "3. **Swath edges.** How closely do the edges of TAT-C's view match the near-range and far-range edges of the images?\n", "4. **Product footprints.** Does `compute_ground_track` reproduce the footprints of all the products acquired in a day?\n", - "5. **Observation times.** Does `collect_observations` predict when Sentinel-1C images a point? This test has moved from this notebook: passes, swath edges, swath intersection over union (IoU), and observation epochs of the catalog's `csar` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_csar.py`; see the [instrument catalog](catalog.rst).\n", + "5. **Observation times.** Does `collect_observations` predict when Sentinel-1C images a point? This test has moved from this notebook: passes, swath edges, swath intersection over union (IoU), and observation epochs of the catalog's `csar` entry are tested on data held out from its fit by `validation/catalog/validate_catalog_csar.py`; see the [instrument catalog](../catalog.rst).\n", "6. **Roll steering.** Does a satellite attitude whose roll angle varies around the orbit (an `Attitude` with a `roll_angle_profile`) reproduce Sentinel-1's roll steering?" ] }, @@ -34,7 +34,7 @@ "* the spacecraft's Earth-fixed position and velocity (from the restituted orbit) at 10 s intervals; and\n", "* a geolocation grid of 7 lines by 21 samples spanning the image, with the zero-Doppler (azimuth) time, slant range time, geodetic latitude, longitude, and height (on the WGS 84 ellipsoid), and incidence and elevation angles of each point.\n", "\n", - "All IW and EW products acquired by Sentinel-1C on 2 October 2026 are used (the few Stripmap products, in six different beams, are excluded). The first run downloads about 0.5 GB and takes a few minutes; reduced arrays are cached in a local `data/sentinel1` directory.\n", + "All IW and EW products acquired by Sentinel-1C on 2 October 2026 are used (the few Stripmap products, in six different beams, are excluded). The first run downloads about 0.5 GB and takes a few minutes; reduced arrays are cached in a local `../data/sentinel1` directory.\n", "\n", "Sentinel-1C is modeled with a TLE from [CelesTrak](https://celestrak.org/) whose epoch (2 October 2026, 18:57 UTC) falls within the analysis day." ] @@ -120,7 +120,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"sentinel1\"\n", + "DATA_DIR = Path(\"../data\") / \"sentinel1\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "DAY = datetime(2026, 10, 2, tzinfo=timezone.utc)\n", "STAC = \"https://planetarycomputer.microsoft.com/api/stac/v1/search\"\n", @@ -1600,7 +1600,7 @@ "| 2. Imaging geometry | right-looking; images in the plane perpendicular to the *Earth-fixed* velocity (inertial: up to 2.3 deg); IW roll 33.8 deg and field of view 13.3 deg, EW 29.0 and 23.6 deg; roll steering varies look angles by up to 2.5 deg |\n", "| 3. Swath edges | 3 km along track and 14 to 20 km across track (95th percentile) with the Earth-fixed frame; 24 to 41 km along track with the inertial frame |\n", "| 4. Product footprints (`compute_ground_track`) | IoU 0.93 (IW) and 0.96 (EW), median, for all 499 products |\n", - "| 5. Observation times (`collect_observations`) | tested by the catalog's validation of the `csar` entry (see the [instrument catalog](catalog.rst)) |\n", + "| 5. Observation times (`collect_observations`) | tested by the catalog's validation of the `csar` entry (see the [instrument catalog](../catalog.rst)) |\n", "| 6. Roll steering (`Attitude` with a `roll_angle_profile`) | swath edges within 6 to 7 km across track (95th percentile), instead of 14 to 20 km with a fixed roll angle; footprint IoU 5th percentile 0.92 (IW) and 0.94 (EW) |\n", "\n", "**Velocity frame.** As for NISAR, Sentinel-1's zero-Doppler images lie in the plane perpendicular to the Earth-fixed velocity, which TAT-C's default `VelocityFrame.EARTH_FIXED` reproduces; the inertial frame would displace swath edges by up to 41 km along track.\n", diff --git a/docs/validation/ValidateSampleSizes.ipynb b/docs/validation/instruments/ValidateSampleSizes.ipynb similarity index 99% rename from docs/validation/ValidateSampleSizes.ipynb rename to docs/validation/instruments/ValidateSampleSizes.ipynb index 1692ce2f..70341697 100644 --- a/docs/validation/ValidateSampleSizes.ipynb +++ b/docs/validation/instruments/ValidateSampleSizes.ipynb @@ -30,7 +30,7 @@ "source": [ "## Reference Data\n", "\n", - "This notebook reuses the geolocation products downloaded (and cached in `data/`) by the companion notebooks, which must be run first:\n", + "This notebook reuses the geolocation products downloaded (and cached in `../data/`) by the companion notebooks, which must be run first:\n", "\n", "* **ATMS** ([ATMS validation](ValidateImagerATMS.ipynb)): the center of each of the 96 beams of every scan of 2 October 2026 (`GATMO`), with the NOAA-20 two-line element set (TLE) of that day.\n", "* **VIIRS** ([VIIRS validation](ValidateImagerVIIRS.ipynb)): the moderate-resolution (M-band) geolocation (`GMTCO`) of every tenth granule of the same day: all 3,200 samples of the two center detectors of each granule's middle scan, and detectors 1, 8, 9, and 16 of every scan at every eighth sample.\n", @@ -75,7 +75,7 @@ "import numpy as np\n", "import pandas as pd\n", "\n", - "DATA_DIR = Path(\"data\")\n", + "DATA_DIR = Path(\"../data\")\n", "FILES = {\n", " \"ATMS geolocation (ValidateImagerATMS)\": DATA_DIR\n", " / \"jpss\"\n", diff --git a/docs/validation/ValidateSwathSWOT.ipynb b/docs/validation/instruments/ValidateSwathSWOT.ipynb similarity index 99% rename from docs/validation/ValidateSwathSWOT.ipynb rename to docs/validation/instruments/ValidateSwathSWOT.ipynb index 63df9057..48c08653 100644 --- a/docs/validation/ValidateSwathSWOT.ipynb +++ b/docs/validation/instruments/ValidateSwathSWOT.ipynb @@ -20,7 +20,7 @@ "source": [ "## Reference Data\n", "\n", - "The SWOT Level 2 KaRIn Low Rate Sea Surface Height product (Basic, version D) is distributed by the [Physical Oceanography Distributed Active Archive Center](https://podaac.jpl.nasa.gov/SWOT) (PO.DAAC); downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package. Each file covers one half-orbit pass on a grid of 69 pixels, 2 km apart across track (34 on either side of the ground track), with a line every 2 km along track and the time at which each line was observed. The grid is fixed to the pass's reference ground track (it is identical in every cycle), on which SWOT is maintained to within about 1 km. Pixels with good-quality sea surface heights (quality flag 0) show where KaRIn observes over the ocean. One file every two days and the same pass in two consecutive cycles (12 files, about 110 MB) are cached in a local `data/swot` directory.\n", + "The SWOT Level 2 KaRIn Low Rate Sea Surface Height product (Basic, version D) is distributed by the [Physical Oceanography Distributed Active Archive Center](https://podaac.jpl.nasa.gov/SWOT) (PO.DAAC); downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package. Each file covers one half-orbit pass on a grid of 69 pixels, 2 km apart across track (34 on either side of the ground track), with a line every 2 km along track and the time at which each line was observed. The grid is fixed to the pass's reference ground track (it is identical in every cycle), on which SWOT is maintained to within about 1 km. Pixels with good-quality sea surface heights (quality flag 0) show where KaRIn observes over the ocean. One file every two days and the same pass in two consecutive cycles (12 files, about 110 MB) are cached in a local `../data/swot` directory.\n", "\n", "SWOT is modeled with a TLE from [CelesTrak](https://celestrak.org/) whose epoch (4 October 2026, 14:22 UTC) follows the analysis period by 3 to 25 days." ] @@ -254,7 +254,7 @@ "from tatc.constants import EARTH_MEAN_RADIUS, timescale\n", "from tatc.schemas import GeneralPerturbationsOrbit, Point, PointedInstrument, Satellite\n", "\n", - "DATA_DIR = Path(\"data\") / \"swot\"\n", + "DATA_DIR = Path(\"../data\") / \"swot\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "START = datetime(2026, 9, 9, tzinfo=timezone.utc)\n", "END = datetime(2026, 10, 2, tzinfo=timezone.utc)\n", diff --git a/docs/validation/ValidateTiltPACE.ipynb b/docs/validation/instruments/ValidateTiltPACE.ipynb similarity index 99% rename from docs/validation/ValidateTiltPACE.ipynb rename to docs/validation/instruments/ValidateTiltPACE.ipynb index 22075494..271fcb0f 100644 --- a/docs/validation/ValidateTiltPACE.ipynb +++ b/docs/validation/instruments/ValidateTiltPACE.ipynb @@ -25,7 +25,7 @@ "source": [ "## Reference Data\n", "\n", - "The OCI Level-1B product (`PACE_OCI_L1B_SCI`, version 3) from the [NASA Ocean Biology Distributed Active Archive Center](https://oceancolor.gsfc.nasa.gov/) (OB.DAAC) provides one netCDF file per 5-minute granule of about 1,709 scans, each with its time, the telescope's tilt angle, the spacecraft's Earth-fixed position and velocity, and, for each of 1,272 pixels across the scan, the scan angle and the terrain-corrected geodetic latitude, longitude, and terrain height. The granules of two days (4 and 5 October 2026, about 280 granules of 1.3 to 1.9 GB each) are reduced with HTTP range requests (read with `h5py`, `pip install h5py`): the time and tilt of every scan, the navigation data of every tenth scan, and the pixel geolocation of every tenth scan and every eighth pixel. Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; the first run transfers about 5 GB and takes about 30 minutes, and the reduced data (about 60 MB) are cached in a local `data/pace` directory.\n", + "The OCI Level-1B product (`PACE_OCI_L1B_SCI`, version 3) from the [NASA Ocean Biology Distributed Active Archive Center](https://oceancolor.gsfc.nasa.gov/) (OB.DAAC) provides one netCDF file per 5-minute granule of about 1,709 scans, each with its time, the telescope's tilt angle, the spacecraft's Earth-fixed position and velocity, and, for each of 1,272 pixels across the scan, the scan angle and the terrain-corrected geodetic latitude, longitude, and terrain height. The granules of two days (4 and 5 October 2026, about 280 granules of 1.3 to 1.9 GB each) are reduced with HTTP range requests (read with `h5py`, `pip install h5py`): the time and tilt of every scan, the navigation data of every tenth scan, and the pixel geolocation of every tenth scan and every eighth pixel. Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; the first run transfers about 5 GB and takes about 30 minutes, and the reduced data (about 60 MB) are cached in a local `../data/pace` directory.\n", "\n", "PACE's orbit is taken from its TLE from [CelesTrak](https://celestrak.org/) (epoch 5 October 2026, 19:09 UTC)." ] @@ -73,7 +73,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"pace\"\n", + "DATA_DIR = Path(\"../data\") / \"pace\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "START = datetime(2026, 10, 4, tzinfo=timezone.utc)\n", "END = datetime(2026, 10, 6, tzinfo=timezone.utc)\n", diff --git a/docs/validation/ValidateYawFlipGPM.ipynb b/docs/validation/instruments/ValidateYawFlipGPM.ipynb similarity index 99% rename from docs/validation/ValidateYawFlipGPM.ipynb rename to docs/validation/instruments/ValidateYawFlipGPM.ipynb index d290730e..12719405 100644 --- a/docs/validation/ValidateYawFlipGPM.ipynb +++ b/docs/validation/instruments/ValidateYawFlipGPM.ipynb @@ -32,7 +32,7 @@ "* **Ku-band radar profiles** (`GPM_2AKu`): for each scan (every 0.6 s), its time, the spacecraft's Earth-fixed position, velocity, and attitude, its orientation (0 or 180 deg), and the geodetic latitude and longitude of each of the 49 beam positions at the surface;\n", "* **GMI brightness temperatures** (`GPM_1CGPMGMI`): for each scan of the low-frequency channels (S1, every 1.875 s), its time and orientation and the latitude and longitude of each of its 221 pixels.\n", "\n", - "The 232 orbits of 10 to 24 September 2026, across the yaw flip of 17 September, are reduced with HTTP range requests (read with `h5py`) to every fifth radar scan and every third GMI scan. Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; the first run takes about an hour, and the reduced data are cached in a local `data/gpm` directory. GPM's orbit is taken from its TLE from [CelesTrak](https://celestrak.org/) (epoch 6 October 2026, 06:57 UTC)." + "The 232 orbits of 10 to 24 September 2026, across the yaw flip of 17 September, are reduced with HTTP range requests (read with `h5py`) to every fifth radar scan and every third GMI scan. Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package; the first run takes about an hour, and the reduced data are cached in a local `../data/gpm` directory. GPM's orbit is taken from its TLE from [CelesTrak](https://celestrak.org/) (epoch 6 October 2026, 06:57 UTC)." ] }, { @@ -76,7 +76,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"gpm\"\n", + "DATA_DIR = Path(\"../data\") / \"gpm\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "START, END = \"2026-09-10T00:00:00Z\", \"2026-09-24T23:59:59Z\"\n", "EPOCH = pd.Timestamp(\"2000-01-01\", tz=\"UTC\")\n", diff --git a/docs/validation/instruments/index.rst b/docs/validation/instruments/index.rst new file mode 100644 index 00000000..e506f507 --- /dev/null +++ b/docs/validation/instruments/index.rst @@ -0,0 +1,24 @@ +======================== +Instruments and Pointing +======================== + +These notebooks test the models of scanners, pushbrooms, conical scanners, synthetic aperture radars, altimeters, and lidars, and of the pointing of their platforms, against the geolocated samples of operational instruments. Several derive the configurations of catalog entries and explain the modeling choices behind them; the entries' results on data held out from their fits are on the :doc:`../catalog` page. Their headline results are collected in the :doc:`../summary`. + +.. toctree:: + :maxdepth: 1 + + ValidateImagerATMS.ipynb + ValidateImagerCrIS.ipynb + ValidateImagerVIIRS.ipynb + ValidateDriftMODIS.ipynb + ValidatePushbroomMSI.ipynb + ValidateConicalAMSR2.ipynb + ValidateConicalGMI.ipynb + ValidateSARNISAR.ipynb + ValidateSARSentinel1.ipynb + ValidateSwathSWOT.ipynb + ValidateLidarICESat2.ipynb + ValidateTiltPACE.ipynb + ValidatePointingOCO2.ipynb + ValidateYawFlipGPM.ipynb + ValidateSampleSizes.ipynb diff --git a/docs/validation/ValidateLimbMLS.ipynb b/docs/validation/limb_and_space/ValidateLimbMLS.ipynb similarity index 99% rename from docs/validation/ValidateLimbMLS.ipynb rename to docs/validation/limb_and_space/ValidateLimbMLS.ipynb index 7871f8c2..2db5a6fe 100644 --- a/docs/validation/ValidateLimbMLS.ipynb +++ b/docs/validation/limb_and_space/ValidateLimbMLS.ipynb @@ -7,7 +7,7 @@ "source": [ "# Limb Sounding Validation: Aura MLS\n", "\n", - "This notebook validates the limb sounding analysis in TAT-C (`collect_limb_observations`, see the [Limb Sounding Observations](../examples/CollectLimb.ipynb) example) against an operational mission: the [Microwave Limb Sounder (MLS)](https://mls.jpl.nasa.gov/) aboard NASA's Aura spacecraft. MLS views forward along the flight direction and scans its antenna upward through the atmosphere roughly every 25 seconds, so it exercises a forward-looking (`scan_azimuth = 0`), upward-scanning configuration.\n", + "This notebook validates the limb sounding analysis in TAT-C (`collect_limb_observations`, see the [Limb Sounding Observations](../../examples/CollectLimb.ipynb) example) against an operational mission: the [Microwave Limb Sounder (MLS)](https://mls.jpl.nasa.gov/) aboard NASA's Aura spacecraft. MLS views forward along the flight direction and scans its antenna upward through the atmosphere roughly every 25 seconds, so it exercises a forward-looking (`scan_azimuth = 0`), upward-scanning configuration.\n", "\n", "The comparison uses one full day of MLS data (14 August 2026) and asks four questions, from the most isolated component to the end-to-end result:\n", "\n", @@ -31,7 +31,7 @@ "* [ML1OA](https://disc.gsfc.nasa.gov/datasets/ML1OA_006/summary) (Level 1B orbit/attitude): for every *major frame* (MAF; one vertical scan) and every *minor frame* (MIF; about 1/6 s) within it, the spacecraft's geodetic position and the GHz radiometer's tangent point geodetic latitude, longitude, and altitude. This is the direct reference for individual sampled points.\n", "* [ML2T](https://disc.gsfc.nasa.gov/datasets/ML2T_006/summary) (Level 2 temperature): the location and time of each retrieved vertical profile (about 3,500 per day). This is the reference for TAT-C's representative `position` per scan.\n", "\n", - "Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` and `netCDF4` packages (`pip install earthaccess netCDF4`). The Level 1B file is about 260 MB. Files are cached in a local `data` directory and only downloaded once." + "Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` and `netCDF4` packages (`pip install earthaccess netCDF4`). The Level 1B file is about 260 MB. Files are cached in a local `../data` directory and only downloaded once." ] }, { @@ -52,7 +52,7 @@ "\n", "import earthaccess\n", "\n", - "DATA_DIR = Path(\"data\")\n", + "DATA_DIR = Path(\"../data\")\n", "DATA_DIR.mkdir(exist_ok=True)\n", "L1BOA_FILE = DATA_DIR / \"MLS-Aura_L1BOA_v06-03-c01_2026d226.h5\"\n", "L2_FILE = DATA_DIR / \"MLS-Aura_L2GP-Temperature_v06-03-c01_2026d226.he5\"\n", @@ -806,7 +806,7 @@ "\n", "TAT-C scans are now started at each nominal MLS major frame start time and compared sample by sample with the MLS scan in the same major frame. Two configurations are tested:\n", "\n", - "* **Example configuration:** the settings of the [example notebook](../examples/CollectLimb.ipynb) (a standard pressure grid from 1000 to 0.01 hPa, roughly 0 to 80 km, swept in 25 s).\n", + "* **Example configuration:** the settings of the [example notebook](../../examples/CollectLimb.ipynb) (a standard pressure grid from 1000 to 0.01 hPa, roughly 0 to 80 km, swept in 25 s).\n", "* **Matched configuration:** 11 evenly spaced elevations between the bottom and top of the median MLS scan (about 1 to 92 km), swept in the measured upward sweep duration (about 20.5 s).\n", "\n", "Per-sample times are taken from `_sample_limb_scan`, the routine `collect_limb_observations` uses for each scan, since the public output reports times only for each scan's start, end, and representative point. The representative `position` and `time` are taken from `collect_limb_observations` itself." diff --git a/docs/validation/ValidateLimbSABER.ipynb b/docs/validation/limb_and_space/ValidateLimbSABER.ipynb similarity index 99% rename from docs/validation/ValidateLimbSABER.ipynb rename to docs/validation/limb_and_space/ValidateLimbSABER.ipynb index f40f6bc3..d8df9915 100644 --- a/docs/validation/ValidateLimbSABER.ipynb +++ b/docs/validation/limb_and_space/ValidateLimbSABER.ipynb @@ -7,7 +7,7 @@ "source": [ "# Limb Sounding Validation: TIMED SABER\n", "\n", - "This notebook validates the limb sounding analysis in TAT-C (`collect_limb_observations`, see the [Limb Sounding Observations](../examples/CollectLimb.ipynb) example) against the [Sounding of the Atmosphere using Broadband Emission Radiometry (SABER)](https://saber.gats-inc.com/) instrument aboard NASA's Thermosphere Ionosphere Mesosphere Energetics and Dynamics (TIMED) spacecraft.\n", + "This notebook validates the limb sounding analysis in TAT-C (`collect_limb_observations`, see the [Limb Sounding Observations](../../examples/CollectLimb.ipynb) example) against the [Sounding of the Atmosphere using Broadband Emission Radiometry (SABER)](https://saber.gats-inc.com/) instrument aboard NASA's Thermosphere Ionosphere Mesosphere Energetics and Dynamics (TIMED) spacecraft.\n", "\n", "SABER complements the [Aura MLS validation](ValidateLimbMLS.ipynb) in two ways. It looks sideways, perpendicular to the flight direction (`scan_azimuth = 90`), rather than forward. And it alternates upward and downward vertical scans, exercising both `ScanDirection` options.\n", "\n", @@ -30,7 +30,7 @@ "\n", "Two details of the format matter here. First, `time` counts milliseconds from midnight of the orbit's *start* date, so it exceeds 24 hours for events after midnight in an orbit that spans two days. Second, levels are stored top-down, so samples of upward scans appear in reverse chronological order.\n", "\n", - "The 16 orbits overlapping 21 September 2026 (about 90 MB) are downloaded to a local `data` directory, if not already present. Reading the files requires the `netCDF4` package (`pip install netCDF4`)." + "The 16 orbits overlapping 21 September 2026 (about 90 MB) are downloaded to a local `../data` directory, if not already present. Reading the files requires the `netCDF4` package (`pip install netCDF4`)." ] }, { @@ -51,7 +51,7 @@ "\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\")\n", + "DATA_DIR = Path(\"../data\")\n", "DATA_DIR.mkdir(exist_ok=True)\n", "SABER_URL = \"https://data.gats-inc.com/saber/Version2_0/Level2A/2026\"\n", "saber_files = [\n", diff --git a/docs/validation/ValidateROCOSMIC2.ipynb b/docs/validation/limb_and_space/ValidateROCOSMIC2.ipynb similarity index 99% rename from docs/validation/ValidateROCOSMIC2.ipynb rename to docs/validation/limb_and_space/ValidateROCOSMIC2.ipynb index 530162ae..f8d6d028 100644 --- a/docs/validation/ValidateROCOSMIC2.ipynb +++ b/docs/validation/limb_and_space/ValidateROCOSMIC2.ipynb @@ -7,7 +7,7 @@ "source": [ "# Radio Occultation Validation: COSMIC-2\n", "\n", - "This notebook validates the radio occultation (RO) analysis in TAT-C (`collect_ro_observations`, see the [GNSS Radio Occultation](../examples/CollectRO.ipynb) example) against the [COSMIC-2](https://www.cosmic.ucar.edu/what-we-do/cosmic-2) constellation receiving GPS, GLONASS, and Galileo signals on 14 May 2026. TAT-C models each occultation with the straight line between receiver and transmitter (refraction is not modeled) and reports the line's tangent point, its point of minimum WGS 84 geodetic altitude, the convention used to geolocate operationally processed RO profiles.\n", + "This notebook validates the radio occultation (RO) analysis in TAT-C (`collect_ro_observations`, see the [GNSS Radio Occultation](../../examples/CollectRO.ipynb) example) against the [COSMIC-2](https://www.cosmic.ucar.edu/what-we-do/cosmic-2) constellation receiving GPS, GLONASS, and Galileo signals on 14 May 2026. TAT-C models each occultation with the straight line between receiver and transmitter (refraction is not modeled) and reports the line's tangent point, its point of minimum WGS 84 geodetic altitude, the convention used to geolocate operationally processed RO profiles.\n", "\n", "`collect_ro_observations` is run end to end with published orbits for the day, and its predictions are compared with every GPS, GLONASS, and Galileo occultation COSMIC-2 recorded, separately for each constellation:\n", "\n", @@ -28,7 +28,7 @@ "\n", "GNSS RO data from several missions and processing centers are available in the [AWS Registry of Open Data](https://registry.opendata.aws/gnss-ro-opendata/) (no account required), with a metadata database that the [`awsgnssroutils`](https://pypi.org/project/awsgnssroutils/) package can query (`pip install awsgnssroutils netCDF4`). This notebook uses UCAR's COSMIC-2 processing for 14 May 2026 (the most recent complete day with data files when this analysis was performed). The database lists every occultation recorded that day, with its receiver, transmitter, and rising or setting flag, and each occultation's **calibratedPhase** (Level 1A) file records the receiver and transmitter positions in Earth-centered, Earth-fixed coordinates, sampled at 100 Hz (transmitter positions at the time of signal transmission).\n", "\n", - "Of the 5,710 COSMIC-2 occultations that day, 2,445 from GPS, 1,598 from GLONASS, and 1,061 from Galileo have a retrieval (that is, passed UCAR's processing). A seeded random sample of 200 from each constellation is used to identify the satellites and check their orbits (Test 1) and to check TAT-C's timing and location against the recorded positions (Test 4); their Level 1A files (about 1.3 GB) are downloaded once to a local `data/ro` directory." + "Of the 5,710 COSMIC-2 occultations that day, 2,445 from GPS, 1,598 from GLONASS, and 1,061 from Galileo have a retrieval (that is, passed UCAR's processing). A seeded random sample of 200 from each constellation is used to identify the satellites and check their orbits (Test 1) and to check TAT-C's timing and location against the recorded positions (Test 4); their Level 1A files (about 1.3 GB) are downloaded once to a local `../data/ro` directory." ] }, { @@ -69,7 +69,7 @@ "\n", "CONSTELLATIONS = {\"G\": \"GPS\", \"R\": \"GLONASS\", \"E\": \"Galileo\"}\n", "\n", - "DATA_DIR = os.path.join(\"data\", \"ro\")\n", + "DATA_DIR = os.path.join(\"..\", \"data\", \"ro\")\n", "rodb = RODatabaseClient(\n", " metadata_root=os.path.join(DATA_DIR, \"metadata\"), version=\"v1.1\"\n", ")\n", @@ -108,7 +108,7 @@ "source": [ "## Test 1: Orbits\n", "\n", - "`collect_ro_observations` needs orbits for the day: two-line element sets (TLEs) for the GPS, GLONASS, Galileo, and COSMIC-2 satellites, included with this notebook as `gps_2026-05-14.3le`, `glonass_2026-05-14.3le`, `galileo_2026-05-14.3le`, and `cosmic2_2026-05-14.3le`. The files cover the operational satellites of each constellation (and all COSMIC-2 satellites), with epochs around the day: 11 to 16 May for GPS, 7 to 21 May for GLONASS, and 13 to 16 May for Galileo and COSMIC-2.\n", + "`collect_ro_observations` needs orbits for the day: two-line element sets (TLEs) for the GPS, GLONASS, Galileo, and COSMIC-2 satellites, included with this notebook as `elements/gps_2026-05-14.3le`, `elements/glonass_2026-05-14.3le`, `elements/galileo_2026-05-14.3le`, and `elements/cosmic2_2026-05-14.3le`. The files cover the operational satellites of each constellation (and all COSMIC-2 satellites), with epochs around the day: 11 to 16 May for GPS, 7 to 21 May for GLONASS, and 13 to 16 May for Galileo and COSMIC-2.\n", "\n", "Transmitters are identified in RO data by their PRN code (or GLONASS slot number), which TLEs do not carry, and individual element sets can be poor (for example, around a maneuver). Each receiver and transmitter is therefore matched to the satellite whose element sets best reproduce the positions recorded in the sampled Level 1A files (at the start, middle, and end of each occultation), with the satellites of all three constellations as candidates. Every element set of the matched satellite is then checked against those positions, and any set more than 20 km away is excluded; a transmitter whose element sets all fail this check is left out. The identification, like the other time-consuming steps below, runs in parallel worker processes (with `joblib`)." ] @@ -345,10 +345,10 @@ "tle_lines = [\n", " line.rstrip()\n", " for path in [\n", - " \"gps_2026-05-14.3le\",\n", - " \"glonass_2026-05-14.3le\",\n", - " \"galileo_2026-05-14.3le\",\n", - " \"cosmic2_2026-05-14.3le\",\n", + " \"elements/gps_2026-05-14.3le\",\n", + " \"elements/glonass_2026-05-14.3le\",\n", + " \"elements/galileo_2026-05-14.3le\",\n", + " \"elements/cosmic2_2026-05-14.3le\",\n", " ]\n", " for line in open(path)\n", " if line.strip()\n", @@ -699,7 +699,7 @@ "\n", "## Test 2: Predicted and Observed Occultations\n", "\n", - "`collect_ro_observations` is run for each receiver against all 77 identified transmitters (32 GPS, 19 GLONASS, and 26 Galileo satellites) over the day, with a 1 s `time_step` and otherwise default settings (including the default `max_yaw` of 65 deg), as one parallel task per receiver-transmitter combination. The run takes about a minute, and its results are cached in `data/ro`. Predictions and observations are paired one to one by receiver, transmitter, and time at -80 km, within 60 s." + "`collect_ro_observations` is run for each receiver against all 77 identified transmitters (32 GPS, 19 GLONASS, and 26 Galileo satellites) over the day, with a 1 s `time_step` and otherwise default settings (including the default `max_yaw` of 65 deg), as one parallel task per receiver-transmitter combination. The run takes about a minute, and its results are cached in `../data/ro`. Predictions and observations are paired one to one by receiver, transmitter, and time at -80 km, within 60 s." ] }, { diff --git a/docs/validation/ValidateROPlanetiQ.ipynb b/docs/validation/limb_and_space/ValidateROPlanetiQ.ipynb similarity index 99% rename from docs/validation/ValidateROPlanetiQ.ipynb rename to docs/validation/limb_and_space/ValidateROPlanetiQ.ipynb index a3787d17..2e615ff6 100644 --- a/docs/validation/ValidateROPlanetiQ.ipynb +++ b/docs/validation/limb_and_space/ValidateROPlanetiQ.ipynb @@ -26,7 +26,7 @@ "\n", "GNSS RO data from several missions and processing centers are available in the [AWS Registry of Open Data](https://registry.opendata.aws/gnss-ro-opendata/) (no account required), with a metadata database that the [`awsgnssroutils`](https://pypi.org/project/awsgnssroutils/) package can query (`pip install awsgnssroutils netCDF4`). This notebook uses UCAR's PlanetiQ processing for 14 May 2026, the same day as the COSMIC-2 validation. The database lists every occultation recorded that day, with its receiver, transmitter, and rising or setting flag, and each occultation's **calibratedPhase** (Level 1A) file records the receiver and transmitter positions in Earth-centered, Earth-fixed coordinates, sampled at 100 Hz (transmitter positions at the time of signal transmission).\n", "\n", - "Of the 5,425 PlanetiQ occultations that day, 1,334 from GPS, 1,032 from GLONASS, and 1,326 from Galileo have a retrieval (that is, passed UCAR's processing); PlanetiQ also tracks BeiDou, which is not included here. A seeded random sample of 200 from each constellation is used to identify the satellites and check their orbits (Test 1) and to check TAT-C's timing and location against the recorded positions (Test 4); their Level 1A files (about 1.4 GB) are downloaded once to a local `data/ro` directory (shared with the COSMIC-2 notebook)." + "Of the 5,425 PlanetiQ occultations that day, 1,334 from GPS, 1,032 from GLONASS, and 1,326 from Galileo have a retrieval (that is, passed UCAR's processing); PlanetiQ also tracks BeiDou, which is not included here. A seeded random sample of 200 from each constellation is used to identify the satellites and check their orbits (Test 1) and to check TAT-C's timing and location against the recorded positions (Test 4); their Level 1A files (about 1.4 GB) are downloaded once to a local `../data/ro` directory (shared with the COSMIC-2 notebook)." ] }, { @@ -67,7 +67,7 @@ "\n", "CONSTELLATIONS = {\"G\": \"GPS\", \"R\": \"GLONASS\", \"E\": \"Galileo\"}\n", "\n", - "DATA_DIR = os.path.join(\"data\", \"ro\")\n", + "DATA_DIR = os.path.join(\"..\", \"data\", \"ro\")\n", "rodb = RODatabaseClient(\n", " metadata_root=os.path.join(DATA_DIR, \"metadata\"), version=\"v1.1\"\n", ")\n", @@ -108,7 +108,7 @@ "source": [ "## Test 1: Orbits\n", "\n", - "`collect_ro_observations` needs orbits for the day: two-line element sets (TLEs) for the GPS, GLONASS, and Galileo satellites, shared with the COSMIC-2 notebook as `gps_2026-05-14.3le`, `glonass_2026-05-14.3le`, and `galileo_2026-05-14.3le`, and for the GNOMES satellites, included with this notebook as `planetiq_2026-05-14.3le`, which includes GNOMES-1 and GNOMES-3 as additional candidates for the identification below.\n", + "`collect_ro_observations` needs orbits for the day: two-line element sets (TLEs) for the GPS, GLONASS, and Galileo satellites, shared with the COSMIC-2 notebook as `elements/gps_2026-05-14.3le`, `elements/glonass_2026-05-14.3le`, and `elements/galileo_2026-05-14.3le`, and for the GNOMES satellites, included with this notebook as `elements/planetiq_2026-05-14.3le`, which includes GNOMES-1 and GNOMES-3 as additional candidates for the identification below.\n", "\n", "Transmitters are identified in RO data by their PRN code (or GLONASS slot number), which TLEs do not carry, and individual element sets can be poor (for example, around a maneuver). Each receiver and transmitter is therefore matched to the satellite whose element sets best reproduce the positions recorded in the sampled Level 1A files (at the start, middle, and end of each occultation), with the satellites of all three constellations as candidates. Every element set of the matched satellite is then checked against those positions, and any set more than 20 km away is excluded; a transmitter whose element sets all fail this check is left out. The identification, like the other time-consuming steps below, runs in parallel worker processes (with `joblib`)." ] @@ -332,10 +332,10 @@ "tle_lines = [\n", " line.rstrip()\n", " for path in [\n", - " \"gps_2026-05-14.3le\",\n", - " \"glonass_2026-05-14.3le\",\n", - " \"galileo_2026-05-14.3le\",\n", - " \"planetiq_2026-05-14.3le\",\n", + " \"elements/gps_2026-05-14.3le\",\n", + " \"elements/glonass_2026-05-14.3le\",\n", + " \"elements/galileo_2026-05-14.3le\",\n", + " \"elements/planetiq_2026-05-14.3le\",\n", " ]\n", " for line in open(path)\n", " if line.strip()\n", @@ -686,7 +686,7 @@ "\n", "## Test 2: Predicted and Observed Occultations\n", "\n", - "`collect_ro_observations` is run for each receiver against all 71 identified transmitters (26 GPS, 19 GLONASS, and 26 Galileo satellites) over the day, with a 1 s `time_step`, a `max_yaw` of 85 deg to cover all of PlanetiQ's observed yaw angles, and otherwise default settings, as one parallel task per receiver-transmitter combination. The run takes under a minute, and its results are cached in `data/ro`. Predictions and observations are paired one to one by receiver, transmitter, and time at -80 km, within 60 s." + "`collect_ro_observations` is run for each receiver against all 71 identified transmitters (26 GPS, 19 GLONASS, and 26 Galileo satellites) over the day, with a 1 s `time_step`, a `max_yaw` of 85 deg to cover all of PlanetiQ's observed yaw angles, and otherwise default settings, as one parallel task per receiver-transmitter combination. The run takes under a minute, and its results are cached in `../data/ro`. Predictions and observations are paired one to one by receiver, transmitter, and time at -80 km, within 60 s." ] }, { diff --git a/docs/validation/ValidateSpaceCOSMIC2.ipynb b/docs/validation/limb_and_space/ValidateSpaceCOSMIC2.ipynb similarity index 97% rename from docs/validation/ValidateSpaceCOSMIC2.ipynb rename to docs/validation/limb_and_space/ValidateSpaceCOSMIC2.ipynb index bbdf9578..4ef27ce1 100644 --- a/docs/validation/ValidateSpaceCOSMIC2.ipynb +++ b/docs/validation/limb_and_space/ValidateSpaceCOSMIC2.ipynb @@ -7,7 +7,7 @@ "source": [ "# Satellite-to-Satellite Validation: COSMIC-2\n", "\n", - "This notebook validates TAT-C's satellite-to-satellite analysis (`collect_space_observations`, see the [Space-Based Coverage](../examples/CollectSpace.ipynb) example) against the radio occultations recorded by the [COSMIC-2](https://www.cosmic.ucar.edu/what-we-do/cosmic-2) constellation on 14 May 2026. `collect_space_observations` finds the periods when one satellite can observe another, as by a sensor or a radio link, subject to the slant range and to the Earth's occlusion of the straight line of sight between them: its minimum WGS 84 geodetic altitude must be at least `min_grazing_altitude`.\n", + "This notebook validates TAT-C's satellite-to-satellite analysis (`collect_space_observations`, see the [Space-Based Coverage](../../examples/CollectSpace.ipynb) example) against the radio occultations recorded by the [COSMIC-2](https://www.cosmic.ucar.edu/what-we-do/cosmic-2) constellation on 14 May 2026. `collect_space_observations` finds the periods when one satellite can observe another, as by a sensor or a radio link, subject to the slant range and to the Earth's occlusion of the straight line of sight between them: its minimum WGS 84 geodetic altitude must be at least `min_grazing_altitude`.\n", "\n", "A radio occultation (RO) is such an occlusion event. As a GNSS satellite sets behind the Earth as seen from a receiver in low Earth orbit (or rises from behind it), the line of sight between them sweeps down (or up) through the atmosphere, which the receiver profiles from the bending of the signal. TAT-C's RO analysis (`collect_ro_observations`, validated in [Radio Occultation Validation: COSMIC-2](ValidateROCOSMIC2.ipynb)) reports each occultation at the time the straight line reaches its `sample_elevation`, by default -80 km (refraction is not modeled). With `min_grazing_altitude` set to the same -80 km, each window of `collect_space_observations` from a receiver to a transmitter should therefore start with a rising occultation and end with a setting one. The satellites' recorded positions provide an independent truth for the occlusion constraint, the search for window edges, and the analysis of many pairs of satellites at once:\n", "\n", @@ -24,7 +24,7 @@ "source": [ "## Reference Data\n", "\n", - "This notebook reuses the data downloaded (and cached in `data/ro`) by the [COSMIC-2 RO validation](ValidateROCOSMIC2.ipynb), which must be run first: the [AWS Registry of Open Data](https://registry.opendata.aws/gnss-ro-opendata/) metadata database, which lists the 5,710 occultations COSMIC-2 recorded on 14 May 2026 with their receiver, transmitter, and rising or setting flag, and the **calibratedPhase** (Level 1A) files of the same seeded random sample of 200 occultations from each constellation (GPS, GLONASS, and Galileo), which record the receiver and transmitter positions at 100 Hz. The orbits are the two-line element sets (TLEs) included with that notebook (`gps_2026-05-14.3le`, `glonass_2026-05-14.3le`, `galileo_2026-05-14.3le`, and `cosmic2_2026-05-14.3le`)." + "This notebook reuses the data downloaded (and cached in `../data/ro`) by the [COSMIC-2 RO validation](ValidateROCOSMIC2.ipynb), which must be run first: the [AWS Registry of Open Data](https://registry.opendata.aws/gnss-ro-opendata/) metadata database, which lists the 5,710 occultations COSMIC-2 recorded on 14 May 2026 with their receiver, transmitter, and rising or setting flag, and the **calibratedPhase** (Level 1A) files of the same seeded random sample of 200 occultations from each constellation (GPS, GLONASS, and Galileo), which record the receiver and transmitter positions at 100 Hz. The orbits are the two-line element sets (TLEs) included with that notebook (`elements/gps_2026-05-14.3le`, `elements/glonass_2026-05-14.3le`, `elements/galileo_2026-05-14.3le`, and `elements/cosmic2_2026-05-14.3le`)." ] }, { @@ -56,7 +56,7 @@ "\n", "CONSTELLATIONS = {\"G\": \"GPS\", \"R\": \"GLONASS\", \"E\": \"Galileo\"}\n", "\n", - "DATA_DIR = os.path.join(\"data\", \"ro\")\n", + "DATA_DIR = os.path.join(\"..\", \"data\", \"ro\")\n", "if not os.path.isdir(os.path.join(DATA_DIR, \"metadata\")):\n", " raise FileNotFoundError(\n", " \"run ValidateROCOSMIC2 first, to download the COSMIC-2 occultation database\"\n", @@ -241,10 +241,10 @@ "tle_lines = [\n", " line.rstrip()\n", " for path in [\n", - " \"gps_2026-05-14.3le\",\n", - " \"glonass_2026-05-14.3le\",\n", - " \"galileo_2026-05-14.3le\",\n", - " \"cosmic2_2026-05-14.3le\",\n", + " \"elements/gps_2026-05-14.3le\",\n", + " \"elements/glonass_2026-05-14.3le\",\n", + " \"elements/galileo_2026-05-14.3le\",\n", + " \"elements/cosmic2_2026-05-14.3le\",\n", " ]\n", " for line in open(path)\n", " if line.strip()\n", @@ -1125,7 +1125,7 @@ "source": [ "## Test 3: Consistency with the RO Analysis\n", "\n", - "`collect_ro_observations` is run for the same receivers and transmitters with a 1 s `time_step` and a `max_yaw` of 90 deg, which removes the receiver antenna's yaw limit, so that it reports every occultation the geometry allows. It finds each RO observation's arc from its tangent point track, samples the arc every second within an elevation range (by default -200 to 60 km), and interpolates the time at -80 km (`time`); `collect_space_observations` instead finds the window edges directly, from the minimum altitude of the line of sight. Each RO `time` is paired with the nearest window edge of the same receiver and transmitter within 1 s. The run takes about a minute and a half in parallel worker processes, and its results are cached in `data/ro`." + "`collect_ro_observations` is run for the same receivers and transmitters with a 1 s `time_step` and a `max_yaw` of 90 deg, which removes the receiver antenna's yaw limit, so that it reports every occultation the geometry allows. It finds each RO observation's arc from its tangent point track, samples the arc every second within an elevation range (by default -200 to 60 km), and interpolates the time at -80 km (`time`); `collect_space_observations` instead finds the window edges directly, from the minimum altitude of the line of sight. Each RO `time` is paired with the nearest window edge of the same receiver and transmitter within 1 s. The run takes about a minute and a half in parallel worker processes, and its results are cached in `../data/ro`." ] }, { diff --git a/docs/validation/ValidateSpaceGRACEFO.ipynb b/docs/validation/limb_and_space/ValidateSpaceGRACEFO.ipynb similarity index 99% rename from docs/validation/ValidateSpaceGRACEFO.ipynb rename to docs/validation/limb_and_space/ValidateSpaceGRACEFO.ipynb index 9ef1097b..466f4487 100644 --- a/docs/validation/ValidateSpaceGRACEFO.ipynb +++ b/docs/validation/limb_and_space/ValidateSpaceGRACEFO.ipynb @@ -7,7 +7,7 @@ "source": [ "# Satellite-to-Satellite Validation: GRACE-FO\n", "\n", - "This notebook validates TAT-C's satellite-to-satellite analysis (`collect_space_observations`, see the [Space-Based Coverage](../examples/CollectSpace.ipynb) example) against the precise orbits of the two [GRACE-FO](https://gracefo.jpl.nasa.gov/) satellites over a week, 17 to 23 September 2026. The satellites follow each other in the same near-polar orbit, at an altitude of about 490 km and roughly 175 to 180 km apart, so the line of sight between them is always clear of the Earth, but its length and its minimum altitude vary around each orbit. A companion notebook, [Satellite-to-Satellite Validation: COSMIC-2](ValidateSpaceCOSMIC2.ipynb), validates the Earth's occlusion of the line of sight against radio occultations; this one validates the slant range constraints (`min_range` and `max_range`) and the occlusion constraint at an altitude well above the surface (`min_grazing_altitude`), and the orbit track positions they depend on:\n", + "This notebook validates TAT-C's satellite-to-satellite analysis (`collect_space_observations`, see the [Space-Based Coverage](../../examples/CollectSpace.ipynb) example) against the precise orbits of the two [GRACE-FO](https://gracefo.jpl.nasa.gov/) satellites over a week, 17 to 23 September 2026. The satellites follow each other in the same near-polar orbit, at an altitude of about 490 km and roughly 175 to 180 km apart, so the line of sight between them is always clear of the Earth, but its length and its minimum altitude vary around each orbit. A companion notebook, [Satellite-to-Satellite Validation: COSMIC-2](ValidateSpaceCOSMIC2.ipynb), validates the Earth's occlusion of the line of sight against radio occultations; this one validates the slant range constraints (`min_range` and `max_range`) and the occlusion constraint at an altitude well above the surface (`min_grazing_altitude`), and the orbit track positions they depend on:\n", "\n", "1. **Orbits.** How closely do published orbits, as propagated by TAT-C (`collect_orbit_track` in Earth-fixed coordinates), reproduce each satellite's precise orbit?\n", "2. **Range.** How accurately does TAT-C compute the range between the satellites?\n", @@ -22,7 +22,7 @@ "source": [ "## Reference Data\n", "\n", - "The GRACE-FO Level-1B data (`GRACEFO_L1B_ASCII_GRAV_JPL_RL04`, from [PO.DAAC](https://podaac.jpl.nasa.gov/), free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account required) include each satellite's precise orbit (**GNV1B**), determined from its GPS receiver to a few centimeters: Earth-fixed positions and velocities every second, time-tagged in GPS seconds since 1 January 2000, 12:00. The daily archives (about 140 MB each) are downloaded once, and only the orbits of both satellites (GRACE-FO 1, identifier C, and GRACE-FO 2, identifier D) are kept, in a local `data/gracefo` directory.\n", + "The GRACE-FO Level-1B data (`GRACEFO_L1B_ASCII_GRAV_JPL_RL04`, from [PO.DAAC](https://podaac.jpl.nasa.gov/), free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account required) include each satellite's precise orbit (**GNV1B**), determined from its GPS receiver to a few centimeters: Earth-fixed positions and velocities every second, time-tagged in GPS seconds since 1 January 2000, 12:00. The daily archives (about 140 MB each) are downloaded once, and only the orbits of both satellites (GRACE-FO 1, identifier C, and GRACE-FO 2, identifier D) are kept, in a local `../data/gracefo` directory.\n", "\n", "TAT-C needs published orbits for the week: the two-line element sets (TLEs) of GRACE-FO 1 and 2 (NORAD 43476 and 43477), obtained from [Space-Track](https://www.space-track.org) (free account required) with the `gp_history` query\n", "\n", @@ -30,7 +30,7 @@ "https://www.space-track.org/basicspacedata/query/class/gp_history/NORAD_CAT_ID/43476,43477/EPOCH/2026-09-14--2026-10-02/orderby/NORAD_CAT_ID%20asc,EPOCH%20asc/format/3le\n", "```\n", "\n", - "and saved as `data/orbits/gracefo_gp_history.tle` (Space-Track's terms do not allow redistributing them, so the notebook raises an error if the file is missing). Element sets were published about every 6 to 8 hours (once a gap of 23 hours), for both satellites within about 25 s of each other. The week starts after a change in both satellites' mean motion on 15 to 17 September, apparently a maneuver." + "and saved as `../data/orbits/gracefo_gp_history.tle` (Space-Track's terms do not allow redistributing them, so the notebook raises an error if the file is missing). Element sets were published about every 6 to 8 hours (once a gap of 23 hours), for both satellites within about 25 s of each other. The week starts after a change in both satellites' mean motion on 15 to 17 September, apparently a maneuver." ] }, { @@ -64,9 +64,9 @@ "import numpy as np\n", "import pandas as pd\n", "\n", - "DATA_DIR = Path(\"data\") / \"gracefo\"\n", + "DATA_DIR = Path(\"../data\") / \"gracefo\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", - "TLE_FILE = Path(\"data\") / \"orbits\" / \"gracefo_gp_history.tle\"\n", + "TLE_FILE = Path(\"../data\") / \"orbits\" / \"gracefo_gp_history.tle\"\n", "if not TLE_FILE.exists():\n", " raise FileNotFoundError(\n", " f\"download the GRACE-FO element sets from Space-Track to {TLE_FILE} (see above)\"\n", diff --git a/docs/validation/ValidateSpaceSOCRATES.ipynb b/docs/validation/limb_and_space/ValidateSpaceSOCRATES.ipynb similarity index 98% rename from docs/validation/ValidateSpaceSOCRATES.ipynb rename to docs/validation/limb_and_space/ValidateSpaceSOCRATES.ipynb index dbd19c5f..14722ce9 100644 --- a/docs/validation/ValidateSpaceSOCRATES.ipynb +++ b/docs/validation/limb_and_space/ValidateSpaceSOCRATES.ipynb @@ -20,7 +20,7 @@ "source": [ "## Reference Data\n", "\n", - "SOCRATES publishes only its current run (three runs a day). The run of 25 October 2026 (06:00 UTC) listed 195,380 close approaches within 5 km over the following week, each with the two objects, the time and range of closest approach (`TCA` and `TCA_RANGE`), their relative speed, and the days from each object's element set epoch to the closest approach (`DSE_1` and `DSE_2`, to 0.001 day), which identify the element sets used. CelesTrak's element sets of active satellites, downloaded the same day, match those epochs (within 60 s) for both objects of 79,845 approaches. A seeded random sample of 100 of them in each of five relative speed bands (0 to 0.1, 0.1 to 1, 1 to 5, 5 to 10, and 10 to 16 km/s), and the element sets of their 732 satellites, are included with this notebook (`socrates_2026-10-25.csv` and `socrates_2026-10-25.tle`, data from CelesTrak). If a newer SOCRATES run (`sort-minRange.csv`) and active element sets (`active.tle`, `gp.php?GROUP=active&FORMAT=tle`) are saved in a local `data/socrates` directory, the notebook draws a new sample from them.\n", + "SOCRATES publishes only its current run (three runs a day). The run of 25 October 2026 (06:00 UTC) listed 195,380 close approaches within 5 km over the following week, each with the two objects, the time and range of closest approach (`TCA` and `TCA_RANGE`), their relative speed, and the days from each object's element set epoch to the closest approach (`DSE_1` and `DSE_2`, to 0.001 day), which identify the element sets used. CelesTrak's element sets of active satellites, downloaded the same day, match those epochs (within 60 s) for both objects of 79,845 approaches. A seeded random sample of 100 of them in each of five relative speed bands (0 to 0.1, 0.1 to 1, 1 to 5, 5 to 10, and 10 to 16 km/s), and the element sets of their 732 satellites, are included with this notebook (`socrates_2026-10-25.csv` and `elements/socrates_2026-10-25.tle`, data from CelesTrak). If a newer SOCRATES run (`sort-minRange.csv`) and active element sets (`active.tle`, `gp.php?GROUP=active&FORMAT=tle`) are saved in a local `../data/socrates` directory, the notebook draws a new sample from them.\n", "\n", "The approaches of the slowest band are between satellites flying in formation or nearly the same orbit, such as Starlink satellites of the same orbital shell, whose range changes slowly and repeatedly around the orbit; the fastest are between satellites in crossing orbits." ] @@ -151,9 +151,9 @@ "import pandas as pd\n", "\n", "SAMPLE_FILE = Path(\"socrates_2026-10-25.csv\")\n", - "TLE_FILE = Path(\"socrates_2026-10-25.tle\")\n", + "TLE_FILE = Path(\"elements/socrates_2026-10-25.tle\")\n", "SNAPSHOT_DIR = (\n", - " Path(\"data\") / \"socrates\"\n", + " Path(\"../data\") / \"socrates\"\n", ") # optional: a fresh SOCRATES run and active element sets\n", "BANDS = [-0.01, 0.1, 1, 5, 10, 16] # km/s, relative speed bands\n", "LABELS = [\n", diff --git a/docs/validation/cosmic2_2026-05-14.3le b/docs/validation/limb_and_space/elements/cosmic2_2026-05-14.3le similarity index 100% rename from docs/validation/cosmic2_2026-05-14.3le rename to docs/validation/limb_and_space/elements/cosmic2_2026-05-14.3le diff --git a/docs/validation/galileo_2026-05-14.3le b/docs/validation/limb_and_space/elements/galileo_2026-05-14.3le similarity index 100% rename from docs/validation/galileo_2026-05-14.3le rename to docs/validation/limb_and_space/elements/galileo_2026-05-14.3le diff --git a/docs/validation/glonass_2026-05-14.3le b/docs/validation/limb_and_space/elements/glonass_2026-05-14.3le similarity index 100% rename from docs/validation/glonass_2026-05-14.3le rename to docs/validation/limb_and_space/elements/glonass_2026-05-14.3le diff --git a/docs/validation/gps_2026-05-14.3le b/docs/validation/limb_and_space/elements/gps_2026-05-14.3le similarity index 100% rename from docs/validation/gps_2026-05-14.3le rename to docs/validation/limb_and_space/elements/gps_2026-05-14.3le diff --git a/docs/validation/planetiq_2026-05-14.3le b/docs/validation/limb_and_space/elements/planetiq_2026-05-14.3le similarity index 100% rename from docs/validation/planetiq_2026-05-14.3le rename to docs/validation/limb_and_space/elements/planetiq_2026-05-14.3le diff --git a/docs/validation/socrates_2026-10-25.tle b/docs/validation/limb_and_space/elements/socrates_2026-10-25.tle similarity index 100% rename from docs/validation/socrates_2026-10-25.tle rename to docs/validation/limb_and_space/elements/socrates_2026-10-25.tle diff --git a/docs/validation/limb_and_space/index.rst b/docs/validation/limb_and_space/index.rst new file mode 100644 index 00000000..8c8371ab --- /dev/null +++ b/docs/validation/limb_and_space/index.rst @@ -0,0 +1,16 @@ +============================================= +Limb, Occultation, and Satellite-to-Satellite +============================================= + +These notebooks test the limb sounding, radio occultation, and satellite-to-satellite analyses against Aura MLS and TIMED SABER, the occultations of COSMIC-2 and PlanetiQ, the precise orbits of GRACE-FO, and the close approaches predicted by SOCRATES. The element sets they read are in the ``elements`` folder beside them. Their headline results are collected in the :doc:`../summary`. + +.. toctree:: + :maxdepth: 1 + + ValidateLimbMLS.ipynb + ValidateLimbSABER.ipynb + ValidateROCOSMIC2.ipynb + ValidateROPlanetiQ.ipynb + ValidateSpaceCOSMIC2.ipynb + ValidateSpaceGRACEFO.ipynb + ValidateSpaceSOCRATES.ipynb diff --git a/docs/validation/socrates_2026-10-25.csv b/docs/validation/limb_and_space/socrates_2026-10-25.csv similarity index 100% rename from docs/validation/socrates_2026-10-25.csv rename to docs/validation/limb_and_space/socrates_2026-10-25.csv diff --git a/docs/validation/ValidateConstellationIridium.ipynb b/docs/validation/orbits/ValidateConstellationIridium.ipynb similarity index 99% rename from docs/validation/ValidateConstellationIridium.ipynb rename to docs/validation/orbits/ValidateConstellationIridium.ipynb index f77f4550..1c7f9a72 100644 --- a/docs/validation/ValidateConstellationIridium.ipynb +++ b/docs/validation/orbits/ValidateConstellationIridium.ipynb @@ -20,7 +20,7 @@ "source": [ "## Reference Data\n", "\n", - "Two-line element (TLE) sets of the Iridium NEXT satellites are retrieved from [CelesTrak](https://celestrak.org/) (epochs of 3 and 4 October 2026) and cached in a local `data/orbits` directory. The operational satellites are those at the operational altitude (mean motion within 0.02 revolutions per day of the median); the others are spares or satellites being raised or lowered. The analysis period is 12 hours from 00:00 UTC on 4 October 2026." + "Two-line element (TLE) sets of the Iridium NEXT satellites are retrieved from [CelesTrak](https://celestrak.org/) (epochs of 3 and 4 October 2026) and cached in a local `../data/orbits` directory. The operational satellites are those at the operational altitude (mean motion within 0.02 revolutions per day of the median); the others are spares or satellites being raised or lowered. The analysis period is 12 hours from 00:00 UTC on 4 October 2026." ] }, { @@ -168,7 +168,7 @@ "from tatc.schemas.space.walker import WalkerConfiguration\n", "from tatc.utils import compute_field_of_regard\n", "\n", - "ORBIT_DIR = Path(\"data\") / \"orbits\"\n", + "ORBIT_DIR = Path(\"../data\") / \"orbits\"\n", "ORBIT_DIR.mkdir(parents=True, exist_ok=True)\n", "START = datetime(2026, 10, 4, tzinfo=timezone.utc)\n", "END = START + timedelta(hours=12)\n", diff --git a/docs/validation/ValidateMaintainedOrbitLandsat9.ipynb b/docs/validation/orbits/ValidateMaintainedOrbitLandsat9.ipynb similarity index 99% rename from docs/validation/ValidateMaintainedOrbitLandsat9.ipynb rename to docs/validation/orbits/ValidateMaintainedOrbitLandsat9.ipynb index 34bf3f88..95fe0421 100644 --- a/docs/validation/ValidateMaintainedOrbitLandsat9.ipynb +++ b/docs/validation/orbits/ValidateMaintainedOrbitLandsat9.ipynb @@ -21,7 +21,7 @@ "source": [ "## Reference Data\n", "\n", - "The history of Landsat 9's general perturbations element sets (2,046 TLEs from 1 March 2025 to 5 October 2026) is retrieved from [Space-Track.org](https://www.space-track.org/) (`gp_history` class for catalog number 49260), which requires a free account; its user agreement restricts the redistribution of these data, so they are not included with TAT-C. To run this notebook, save the history in three-line format as `data/orbits/landsat9_gp_history.tle`, for example from the query:\n", + "The history of Landsat 9's general perturbations element sets (2,046 TLEs from 1 March 2025 to 5 October 2026) is retrieved from [Space-Track.org](https://www.space-track.org/) (`gp_history` class for catalog number 49260), which requires a free account; its user agreement restricts the redistribution of these data, so they are not included with TAT-C. To run this notebook, save the history in three-line format as `../data/orbits/landsat9_gp_history.tle`, for example from the query:\n", "\n", "`https://www.space-track.org/basicspacedata/query/class/gp_history/NORAD_CAT_ID/49260/EPOCH/2025-03-01--2026-10-05/orderby/EPOCH%20asc/format/3le`\n", "\n", @@ -73,7 +73,7 @@ "from tatc.generation import generate_points_fibonacci_lattice\n", "from tatc.schemas import GeneralPerturbationsOrbit, Instrument, Point, Satellite\n", "\n", - "HISTORY_FILE = Path(\"data\") / \"orbits\" / \"landsat9_gp_history.tle\"\n", + "HISTORY_FILE = Path(\"../data\") / \"orbits\" / \"landsat9_gp_history.tle\"\n", "if not HISTORY_FILE.exists():\n", " raise FileNotFoundError(\n", " f\"Save the Landsat 9 TLE history from Space-Track.org as {HISTORY_FILE} (see above).\"\n", @@ -901,7 +901,7 @@ "| 2. Propagation | direct SGP4 propagation diverges within months (with or without drag); repeating the first cycle of 16 mean solar days (detected or declared) keeps the ground track within 3 km and the timing within 50 s |\n", "| 3. Observations | 99.4% of observations predicted by both repeat-based propagations, with epoch errors of 16 s (median) |\n", "\n", - "**Maintained orbits.** Over 19 months, Landsat 9 stays on its ground track and at its local time through routine maneuvers. A single TLE propagated directly cannot represent this, but repeating its first repeat cycle does: propagated as a maintained orbit (`remove_drag=True`) with the detected (`repeat_cycle=\"auto\"`) or declared (`repeat_cycle=timedelta(days=16)`) repeat cycle, it reproduces Landsat 9's ground track (within 3 km), timing (within a minute), and observations over the whole period. Declaring the repeat cycle is needed for orbits whose repeat cycle cannot be detected from a TLE, such as the 91-day repeat cycle of [ICESat-2](ValidateLidarICESat2.ipynb)." + "**Maintained orbits.** Over 19 months, Landsat 9 stays on its ground track and at its local time through routine maneuvers. A single TLE propagated directly cannot represent this, but repeating its first repeat cycle does: propagated as a maintained orbit (`remove_drag=True`) with the detected (`repeat_cycle=\"auto\"`) or declared (`repeat_cycle=timedelta(days=16)`) repeat cycle, it reproduces Landsat 9's ground track (within 3 km), timing (within a minute), and observations over the whole period. Declaring the repeat cycle is needed for orbits whose repeat cycle cannot be detected from a TLE, such as the 91-day repeat cycle of [ICESat-2](../instruments/ValidateLidarICESat2.ipynb)." ] } ], diff --git a/docs/validation/ValidateOrbitGeneration.ipynb b/docs/validation/orbits/ValidateOrbitGeneration.ipynb similarity index 99% rename from docs/validation/ValidateOrbitGeneration.ipynb rename to docs/validation/orbits/ValidateOrbitGeneration.ipynb index 555cbbcc..b67f6776 100644 --- a/docs/validation/ValidateOrbitGeneration.ipynb +++ b/docs/validation/orbits/ValidateOrbitGeneration.ipynb @@ -24,7 +24,7 @@ "source": [ "## Reference Data\n", "\n", - "TLEs of operational satellites are retrieved from [CelesTrak](https://celestrak.org/) for groups of satellites (weather, Earth resources, Galileo, BeiDou, GLONASS, GPS, OneWeb, GOES) and by name (Meridian, EKS, QZSS), with epochs of 3 and 4 October 2026, and cached in a local `data/orbits` directory. Mean elements are evaluated at 12:00 UTC on 4 October 2026, by SGP4 propagation of each TLE." + "TLEs of operational satellites are retrieved from [CelesTrak](https://celestrak.org/) for groups of satellites (weather, Earth resources, Galileo, BeiDou, GLONASS, GPS, OneWeb, GOES) and by name (Meridian, EKS, QZSS), with epochs of 3 and 4 October 2026, and cached in a local `../data/orbits` directory. Mean elements are evaluated at 12:00 UTC on 4 October 2026, by SGP4 propagation of each TLE." ] }, { @@ -70,7 +70,7 @@ "import pandas as pd\n", "import requests\n", "\n", - "DATA_DIR = Path(\"data\") / \"orbits\"\n", + "DATA_DIR = Path(\"../data\") / \"orbits\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "T = datetime(2026, 10, 4, 12, tzinfo=timezone.utc)\n", "CELESTRAK = \"https://celestrak.org/NORAD/elements/gp.php\"\n", @@ -1201,7 +1201,7 @@ "source": [ "Galileo, BeiDou-3, and GLONASS are all Walker 24/3/1 constellations: every slot is occupied, the median satellite lies within 1 to 3 deg of its slot along the orbit (of 45 deg between slots), and the planes lie within 1 deg of the pattern's. The satellites far from any slot (the 90th percentile offsets of about 20 deg) are spares parked between slots: Galileo and BeiDou have 6 and 9 more satellites in their nominal orbits than slots. OneWeb is a Walker star constellation of 12 planes spaced over 180 deg: the 374 satellites in its nominal orbit (at 1,210 km) occupy 326 of 588 slots, within 1.7 deg (median) of them along the orbit (of 7.3 deg between slots). With 49 satellites per plane, the relative spacing F (2, here) shifts slots by less than a degree and is poorly determined. GPS is not a Walker constellation: its satellites lie 17 deg (median) from the slots of the closest 24/6/F pattern, of 90 deg between slots.\n", "\n", - "For the satellites in slots, the Walker constellations provide the same number of visible satellites as the operational constellations, within 0.1 (navigation constellations) and 0.4 (OneWeb) at every latitude. Even GPS agrees, because a daily average of visible satellites is insensitive to how they are phased; the dilution of precision, which depends on the instantaneous geometry, is tested in the [GNSS DOP](ValidateDopGNSS.ipynb) notebook.\n", + "For the satellites in slots, the Walker constellations provide the same number of visible satellites as the operational constellations, within 0.1 (navigation constellations) and 0.4 (OneWeb) at every latitude. Even GPS agrees, because a daily average of visible satellites is insensitive to how they are phased; the dilution of precision, which depends on the instantaneous geometry, is tested in the [GNSS DOP](../ground_systems/ValidateDopGNSS.ipynb) notebook.\n", "\n", "## Test 3: Train Constellations\n", "\n", diff --git a/docs/validation/ValidateOrbitISS.ipynb b/docs/validation/orbits/ValidateOrbitISS.ipynb similarity index 99% rename from docs/validation/ValidateOrbitISS.ipynb rename to docs/validation/orbits/ValidateOrbitISS.ipynb index 2e5a89df..b34f8544 100644 --- a/docs/validation/ValidateOrbitISS.ipynb +++ b/docs/validation/orbits/ValidateOrbitISS.ipynb @@ -23,7 +23,7 @@ "* The ECOSTRESS Level 1B attitude and ephemeris product (ECO_L1B_ATT, version 2) records the station's position, velocity, and attitude (in the J2000 inertial frame, every second, with times in seconds since J2000 in Terrestrial Time) for each orbit; one orbit in four from 4 September to 4 October 2026 is downloaded (about 40 MB). Downloading requires a free [NASA Earthdata Login](https://urs.earthdata.nasa.gov/) account and the `earthaccess` package.\n", "* The EMIT Level 1B radiance product (EMITL1BRAD, version 2) catalog (anonymous access) lists each scene acquired from 20 September to 2 October 2026 with its footprint, start and end times, and solar zenith angle.\n", "\n", - "Data are cached in a local `data/iss` directory. The ISS is modeled with a TLE from [CelesTrak](https://celestrak.org/) whose epoch is 4 October 2026, 12:43 UTC." + "Data are cached in a local `../data/iss` directory. The ISS is modeled with a TLE from [CelesTrak](https://celestrak.org/) whose epoch is 4 October 2026, 12:43 UTC." ] }, { @@ -83,7 +83,7 @@ " Satellite,\n", ")\n", "\n", - "DATA_DIR = Path(\"data\") / \"iss\"\n", + "DATA_DIR = Path(\"../data\") / \"iss\"\n", "DATA_DIR.mkdir(parents=True, exist_ok=True)\n", "START = datetime(2026, 9, 4, tzinfo=timezone.utc)\n", "END = datetime(2026, 10, 4, 12, tzinfo=timezone.utc)\n", diff --git a/docs/validation/orbits/index.rst b/docs/validation/orbits/index.rst new file mode 100644 index 00000000..55fa8818 --- /dev/null +++ b/docs/validation/orbits/index.rst @@ -0,0 +1,13 @@ +====================== +Orbits and Propagation +====================== + +These notebooks test the propagation of two-line element sets, maintained and drifting orbits, and the orbit and constellation generators, including streets of coverage, against recorded orbits and the element sets of operational satellites. Their headline results are collected in the :doc:`../summary`. + +.. toctree:: + :maxdepth: 1 + + ValidateOrbitGeneration.ipynb + ValidateMaintainedOrbitLandsat9.ipynb + ValidateOrbitISS.ipynb + ValidateConstellationIridium.ipynb diff --git a/docs/validation/standard.rst b/docs/validation/standard.rst index 70b0e686..e2c87de1 100644 --- a/docs/validation/standard.rst +++ b/docs/validation/standard.rst @@ -28,7 +28,7 @@ Versions - Adds the lidar class, for ICESat-2 ATLAS, whose beams fit none of the other classes. No threshold of version 1 changed, so results recorded under version 1 still apply. The lidar gates were drafted knowing an earlier result - (:doc:`ValidateLidarICESat2`: the central beam pair within about 2 km of the + (:doc:`instruments/ValidateLidarICESat2`: the central beam pair within about 2 km of the ground track over Antarctica, and 95% of beam segments within views about 4 km wide), and frozen before any data were analyzed for the catalog. * - 3 diff --git a/docs/validation/summary.rst b/docs/validation/summary.rst index e9965b76..6a5a19f3 100644 --- a/docs/validation/summary.rst +++ b/docs/validation/summary.rst @@ -29,30 +29,30 @@ Orbits and Propagation * - TLE propagation (`GeneralPerturbationsOrbit`) - Recorded or precise orbits of NOAA-20, Sentinel-1C, Sentinel-2, NISAR, Terra, GCOM-W, Aura, PACE, GRACE-FO - 0.5 to 1.7 km along track (95th percentile) within days of the TLE epoch, under 0.5 km across track and radially - (:doc:`ValidateImagerATMS`, :doc:`ValidatePushbroomMSI`, :doc:`ValidateSpaceGRACEFO`); errors grow with drag: - 29 km after 20 days for Sentinel-2A (:doc:`ValidateRevisitSentinel2`), 300 km after 26 days for GPM - (:doc:`ValidateYawFlipGPM`), and about 250 km per day before the ISS's last reboost (:doc:`ValidateOrbitISS`) + (:doc:`instruments/ValidateImagerATMS`, :doc:`instruments/ValidatePushbroomMSI`, :doc:`limb_and_space/ValidateSpaceGRACEFO`); errors grow with drag: + 29 km after 20 days for Sentinel-2A (:doc:`coverage/ValidateRevisitSentinel2`), 300 km after 26 days for GPM + (:doc:`instruments/ValidateYawFlipGPM`), and about 250 km per day before the ISS's last reboost (:doc:`orbits/ValidateOrbitISS`) * - Maintained orbits (`remove_drag`, `repeat_cycle`) - Landsat 9 element set history, 19 months - Repeating the first 16-day cycle keeps the ground track within 3 km and the timing within 50 s, and predicts - 99.4% of 8,241 observations; direct propagation diverges within months (:doc:`ValidateMaintainedOrbitLandsat9`) + 99.4% of 8,241 observations; direct propagation diverges within months (:doc:`orbits/ValidateMaintainedOrbitLandsat9`) * - Repeat cycles (`get_repeat_cycle`) - SWOT, OCO-2, ICESat-2 - - SWOT's 20.86-day cycle within 3.1 s (:doc:`ValidateSwathSWOT`); OCO-2's 16 days (:doc:`ValidatePointingOCO2`); - ICESat-2's 91 days not detected, but refined to within 25 s when declared (:doc:`ValidateLidarICESat2`) + - SWOT's 20.86-day cycle within 3.1 s (:doc:`instruments/ValidateSwathSWOT`); OCO-2's 16 days (:doc:`instruments/ValidatePointingOCO2`); + ICESat-2's 91 days not detected, but refined to within 25 s when declared (:doc:`instruments/ValidateLidarICESat2`) * - Drifting orbits - Terra, since its inclination adjustments ended - A single TLE reproduces the local time drift (39.5 vs. 37.3 minutes per year) within 0.3 minutes over three - months, but departs by 4.4 minutes after a year (:doc:`ValidateDriftMODIS`) + months, but departs by 4.4 minutes after a year (:doc:`instruments/ValidateDriftMODIS`) * - Orbit generators (`SunSynchronousOrbit`, `WalkerConstellation`, `TrainConstellation`, `MolniyaOrbit`, `TundraOrbit`, `GeosynchronousOrbit`) - 13 sun-synchronous missions; Galileo, BeiDou-3, GLONASS, OneWeb; Sentinel-2, Landsat, NOAA-20/21; Meridian, EKS, QZSS, GOES - Ascending node within 0.02 minutes of local time; Walker slots within 1 to 3 deg; trains within 29 to 45 km; - Molniya apogee drift under 0.07 deg per day; Tundra apogee latitudes within 0.03 deg (:doc:`ValidateOrbitGeneration`) + Molniya apogee drift under 0.07 deg per day; Tundra apogee latitudes within 0.03 deg (:doc:`orbits/ValidateOrbitGeneration`) * - Streets of coverage (`SOCConstellation`) - Iridium - - Reproduces Iridium's 6 planes of 11 satellites and its continuous coverage (:doc:`ValidateConstellationIridium`) + - Reproduces Iridium's 6 planes of 11 satellites and its continuous coverage (:doc:`orbits/ValidateConstellationIridium`) Instruments and Pointing ======================== @@ -83,11 +83,11 @@ Instruments and Pointing On sibling satellites, as transfers, MHS and AVHRR on Metop-B passed every swath test, while NOAA-20's angles on NOAA-21 placed ATMS's pixels within 10.5 km and VIIRS's swath width within 21 km (median); fitted on NOAA-21, with ATMS's scan rotated 0.93 deg, ATMS's pixels were within 3.2 km and the swath widths of ATMS and - VIIRS within 1.2 and 2.8 km (median) on held-out data (:doc:`catalog`; :doc:`ValidateImagerATMS`, :doc:`ValidateImagerVIIRS`, :doc:`ValidateDriftMODIS`). CrIS's + VIIRS within 1.2 and 2.8 km (median) on held-out data (:doc:`catalog`; :doc:`instruments/ValidateImagerATMS`, :doc:`instruments/ValidateImagerVIIRS`, :doc:`instruments/ValidateDriftMODIS`). CrIS's footprint centers within 0.7 km (95th percentile) only with a computation per field of regard written in the notebook, and within 19 km (central field of view) and 43 km (all) at the 95th percentile with public methods, which observe a scan at one instant and do not rotate - the array of fields of view (:doc:`ValidateImagerCrIS`). On held-out data, CERES (first sweep of each + the array of fields of view (:doc:`instruments/ValidateImagerCrIS`). On held-out data, CERES (first sweep of each record) predicted 99.6% of observed passes, with 99.4% of predicted passes observed, epochs within 0.29 s (95th percentile), and swath IoU 0.999, but swath width within 7.9 km (median), its edges 60 deg from nadir; ECOSTRESS, with fitted yaw and pitch and its view centered in TAT-C's frame, had 98.4% of predicted passes observed, @@ -102,7 +102,7 @@ Instruments and Pointing - On held-out data, 99.8% or more of passes predicted; swath width within 0.1 to 2.0 km and swath IoU 0.99 or more (median); epochs within 1.3 s (OLI), 2.1 s (TROPOMI), and 2.6 s (MSI, one view) at the 95th percentile (:doc:`catalog`). MSI's epochs within - 0.26 s (95th percentile) with a view per detector module and a geocentric nadir (:doc:`ValidatePushbroomMSI`). + 0.26 s (95th percentile) with a view per detector module and a geocentric nadir (:doc:`instruments/ValidatePushbroomMSI`). OLCI, a single view rolled 12.7 deg away from the sun, on held-out tie points: 99.8% of passes predicted, epochs within 0.13 s (95th percentile), and swath IoU 0.990, but swath width within 9.9 km (:doc:`catalog`). On held-out data, HARP2 (near-nadir view) and SPEXone predicted 99.99 and 99.86% of passes, with epochs within @@ -123,9 +123,9 @@ Instruments and Pointing set, swath IoU 0.963 to 0.978, but still 97.5 to 98.6% of passes predicted (:doc:`catalog`) * - Conical scanners (`ConicalInstrument`) - GCOM-W AMSR2, GPM GMI, SMAP radiometer, DMSP F18 SSMIS, TRMM TMI - - AMSR2: 99.95% of passes, epochs within 0.27 s (95th percentile) (:doc:`ValidateConicalAMSR2`); GMI: swath - width within 0.4 km (95th percentile) (:doc:`ValidateConicalGMI`); SMAP's forward and aft looks within 0.2 s - (median) (:doc:`ValidateGridSMAP`). On held-out AMSR2 data, 99.98% of passes predicted, + - AMSR2: 99.95% of passes, epochs within 0.27 s (95th percentile) (:doc:`instruments/ValidateConicalAMSR2`); GMI: swath + width within 0.4 km (95th percentile) (:doc:`instruments/ValidateConicalGMI`); SMAP's forward and aft looks within 0.2 s + (median) (:doc:`coverage/ValidateGridSMAP`). On held-out AMSR2 data, 99.98% of passes predicted, epochs within 0.79 s (95th percentile), swath width within 2.8 km, and swath IoU 0.998; on held-out GMI data, 99.93 to 100% of passes predicted with both feeds, epochs within 0.63 s (95th percentile), swath width within 0.25 km, and swath IoU 0.999; on held-out SMAP Level @@ -136,8 +136,8 @@ Instruments and Pointing 2.9 km, and swath IoU 0.995 or more (:doc:`catalog`) * - Side-looking SAR (`PointedInstrument` with roll, `roll_angle_profile`) - NISAR, Sentinel-1C - - NISAR's swath edges within 5 to 7 km across track (95th percentile) (:doc:`ValidateSARNISAR`); roll - steering profiles bring Sentinel-1C's within 6 to 7 km (:doc:`ValidateSARSentinel1`). + - NISAR's swath edges within 5 to 7 km across track (95th percentile) (:doc:`instruments/ValidateSARNISAR`); roll + steering profiles bring Sentinel-1C's within 6 to 7 km (:doc:`instruments/ValidateSARSentinel1`). On held-out Sentinel-1C data, IW's swath edges within 6.7 to 6.9 km (95th percentile), epochs within 0.43 s of zero-Doppler times, and swath IoU 0.974, but 98.98% of its passes predicted, the misses at the swath edges; EW, on a later held-out day, predicted 99.16% of passes, with edges within 7.6 to 9.5 km, epochs within @@ -150,7 +150,7 @@ Instruments and Pointing * - Wide-swath interferometer (two rolled instruments) - SWOT KaRIn - Every pixel 11 to 59 km from the ground track observed by the instrument on its side, none in the nadir gap; - epochs within 0.04 s after removing the orbit offset (:doc:`ValidateSwathSWOT`). On held-out data, with the + epochs within 0.04 s after removing the orbit offset (:doc:`instruments/ValidateSwathSWOT`). On held-out data, with the edges of good-quality heights (about 7.5 to 61 km from the ground track), 99.05% of passes predicted, edges within 3.0 km and epochs within 0.52 s (95th percentile), and swath IoU 0.993 (:doc:`catalog`) * - Scatterometer (two rolled instruments) @@ -160,7 +160,7 @@ Instruments and Pointing * - Narrow-beam lidar - ICESat-2 ATLAS, GEDI - Beams located within about 2 km with a TLE, so a view about 4 km wide predicts 95% of their observations - (:doc:`ValidateLidarICESat2`). With views about 4.9 km wide fitted over Antarctica, held-out data a month + (:doc:`instruments/ValidateLidarICESat2`). With views about 4.9 km wide fitted over Antarctica, held-out data a month later had every sampled segment within its pair's view and the pairs' spacing within 0.02 km, but epochs 5.5 s early (median) with an element set 4 days from the data, consistent with its along-track error; with an element set of the day, within 0.37 s (95th percentile) (:doc:`catalog`). @@ -190,17 +190,17 @@ Instruments and Pointing * - Tilted scanners (`pitch_angle_profile`), sun glint (`compute_glint_angle`) - PACE OCI - Pixels within 0.8 km near nadir and 9 km at the edges (median); epochs within 0.15 s (median) with a daily tilt - profile; glint angles within 0.26 deg (:doc:`ValidateTiltPACE`) + profile; glint angles within 0.26 deg (:doc:`instruments/ValidateTiltPACE`) * - Attitudes (`Attitude`, `AttitudeSchedule`, `TargetAttitude`, `GlintAttitude`) - OCO-2 modes, GPM yaw flips, ISS attitude (EMIT) - OCO-2 views within 1.5 km (glint), 2.1 km (nadir), and 5.5 km (target) median under one schedule - (:doc:`ValidatePointingOCO2`); GMI times relative to the radar within 0.6 s (median) across a yaw flip - (:doc:`ValidateYawFlipGPM`); EMIT epochs within 1.1 s (median) with the recorded ISS attitude - (:doc:`ValidateOrbitISS`) + (:doc:`instruments/ValidatePointingOCO2`); GMI times relative to the radar within 0.6 s (median) across a yaw flip + (:doc:`instruments/ValidateYawFlipGPM`); EMIT epochs within 1.1 s (median) with the recorded ISS attitude + (:doc:`orbits/ValidateOrbitISS`) * - Sample sizes (`compute_sample_sizes`) - ATMS, CrIS, VIIRS, MODIS, AMSR2, GMI - Sample spacing within 1% across track and 0.2 to 0.8% along track; 55 of 58 published footprint dimensions - within 3% (:doc:`ValidateSampleSizes`) + within 3% (:doc:`instruments/ValidateSampleSizes`) Coverage Analyses ================= @@ -215,34 +215,34 @@ Coverage Analyses * - Revisit (`collect_observations`, `aggregate_observations`, `reduce_observations`) - Sentinel-2A, 2B, and 2C acquisitions over 20 days - Every observed pass of 2B and 2C predicted; median 4 samples and 5.0-day mean revisit, observed and predicted; - samples equal at 88% of points (:doc:`ValidateRevisitSentinel2`) + samples equal at 88% of points (:doc:`coverage/ValidateRevisitSentinel2`) * - Regions (`collect_region_observations`) - Sentinel-2 over six countries; Sentinel-1C over polar regions - All 114 and all 210 acquired passes predicted, including regions around both poles and across the anti-meridian; sample counts and mean revisit equal to observed for five of six countries; swaths reach 87.58 deg - north (products: 87.57 deg) (:doc:`ValidateRegionSentinel2`, :doc:`ValidateRegionPolarSentinel1`) + north (products: 87.57 deg) (:doc:`coverage/ValidateRegionSentinel2`, :doc:`coverage/ValidateRegionPolarSentinel1`) * - Features (`collect_feature_observations`) - TC PRIMED tropical cyclone overpasses, 2025 Atlantic season, 10 satellites - All 1,433 archived overpasses predicted; viewed fraction within 0.2 percentage points (median) - (:doc:`ValidateFeaturesTCPRIMED`) + (:doc:`coverage/ValidateFeaturesTCPRIMED`) * - Gridded statistics (`grid_observations`) - SMAP radiometer, one day - Same number of passes at 90% of points; gridded samples within 2.4% and revisit equal (median) - (:doc:`ValidateGridSMAP`) + (:doc:`coverage/ValidateGridSMAP`) * - Illumination (`min_target_solar_elevation`, `omit_solar=False`) - Landsat 8 and 9 scenes - Solar elevation and azimuth within 0.025 and 0.06 deg, epochs within 0.7 s; a 5 deg minimum solar elevation - predicts 94 to 95% of acquisitions, 91 to 93% of predictions acquired (:doc:`ValidateSolarLandsat`) + predicts 94 to 95% of acquisitions, 91 to 93% of predictions acquired (:doc:`coverage/ValidateSolarLandsat`) * - Coincidences (`find_coincident_observations`, `find_coincident_ground_track`) - GMI and AMSR2 within 15 minutes - With `instantaneous=True`, 97.7% of true coincidences found and 99.9% of those found true, within 2.4 s (95th - percentile); 98.2% of coincident points within coincident footprints (:doc:`ValidateCoincidenceGMIAMSR2`) + percentile); 98.2% of coincident points within coincident footprints (:doc:`coverage/ValidateCoincidenceGMIAMSR2`) * - Sampling error (`estimate_sampling_error`) - IMERG half-hourly precipitation, Maritime Continent, July 2025; four constellation designs - With the statistics of June, errors of July's monthly means at 1,600 points as predicted (RMS standardized errors 1.02 to 1.05; 94 to 95% within 2 predicted standard deviations); designs ranked by an order of magnitude, as predicted; independent samples (`sigma / sqrt(n)`) overpredict dense sampling by up to 1.8 times - (:doc:`ValidateSamplingErrorIMERG`) + (:doc:`coverage/ValidateSamplingErrorIMERG`) Limb, Occultation, and Satellite-to-Satellite Analyses ====================================================== @@ -258,22 +258,22 @@ Limb, Occultation, and Satellite-to-Satellite Analyses - Aura MLS, TIMED SABER - MLS tangent points within 1.8 km (median) at matched times and altitudes; SABER scan sample times within 0.05 s (median); daily latitude ranges within 0.2 deg and equator local times within 0.02 h - (:doc:`ValidateLimbMLS`, :doc:`ValidateLimbSABER`) + (:doc:`limb_and_space/ValidateLimbMLS`, :doc:`limb_and_space/ValidateLimbSABER`) * - Radio occultation (`collect_ro_observations`) - COSMIC-2 and PlanetiQ, GPS, GLONASS, and Galileo - All 5,699 and 3,838 recorded occultations predicted with the correct direction; times within 0.23 to 0.30 s - (95th percentile); tangent points 0.30 to 0.39 km (median) from truth (:doc:`ValidateROCOSMIC2`, - :doc:`ValidateROPlanetiQ`) + (95th percentile); tangent points 0.30 to 0.39 km (median) from truth (:doc:`limb_and_space/ValidateROCOSMIC2`, + :doc:`limb_and_space/ValidateROPlanetiQ`) * - Earth occlusion (`collect_space_observations`) - COSMIC-2 occultations; GRACE-FO precise orbits - Window edges within 0.23 to 0.30 s (95th percentile) of recorded occultations and within 2 ms of - `collect_ro_observations`; all GRACE-FO occlusion edges predicted (:doc:`ValidateSpaceCOSMIC2`, - :doc:`ValidateSpaceGRACEFO`) + `collect_ro_observations`; all GRACE-FO occlusion edges predicted (:doc:`limb_and_space/ValidateSpaceCOSMIC2`, + :doc:`limb_and_space/ValidateSpaceGRACEFO`) * - Slant range (`collect_space_observations`) - GRACE-FO precise orbits; SOCRATES close approaches - Range between formation satellites within 21 m (standard deviation); closest approaches within 1 m and 0.3 ms (median) of SOCRATES; every window at least `min_duration` long found, down to 0.1 s - (:doc:`ValidateSpaceGRACEFO`, :doc:`ValidateSpaceSOCRATES`) + (:doc:`limb_and_space/ValidateSpaceGRACEFO`, :doc:`limb_and_space/ValidateSpaceSOCRATES`) Ground Systems and Navigation ============================= @@ -288,15 +288,15 @@ Ground Systems and Navigation * - Ground radar (`RadarStation`, `compute_terrain_mask`) - Four NEXRAD radars in Arizona, Level II volume scans - DEM terrain masks agree with observed blockage at 90 to 92% of azimuths; observable area IoU 0.77 to 0.92 per - station and 0.84 to 0.93 for the network (:doc:`ValidateRadarNEXRAD`) + station and 0.84 to 0.93 for the network (:doc:`ground_systems/ValidateRadarNEXRAD`) * - Downlink latency (`collect_downlinks`, `compute_latencies`) - NOAA-20 product granules - Mean latency 21 vs. 23 minutes, within 9 minutes per granule (95th percentile), the difference being processing - time (:doc:`ValidateLatencyNOAA20`) + time (:doc:`ground_systems/ValidateLatencyNOAA20`) * - Dilution of precision (`compute_dop`) - GPS, Galileo, BeiDou, and GLONASS broadcast ephemerides at six IGS stations - Within 0.01% (median) of an independent computation for the same satellites, including a clock per system - (:doc:`ValidateDopGNSS`) + (:doc:`ground_systems/ValidateDopGNSS`) Trade Studies ============= @@ -313,7 +313,7 @@ Trade Studies - With the published numbers of blocks and units, replicates with common random numbers reproduce the expected costs, standard deviations, and covariance of the constellations within their sampling error, and the probability that one costs more than the other (97.8%; 94.8% with independent draws); Table I's growth - factors reproduced (:doc:`ValidateCostVarianceNSOSA`) + factors reproduced (:doc:`trade_studies/ValidateCostVarianceNSOSA`) * - Production blocks and study periods (`DeploymentSchedule`, `SatelliteCost.block_size`) - Launch schedules and production blocks of the same study - Launches, production of later units, and developments of both blocks of the geostationary configuration @@ -321,7 +321,7 @@ Trade Studies configuration), the published numbers of developments and units of two of three configurations reproduced, and one constellation's expected cost; the third configuration's published numbers cannot be derived from its schedule, which costs the constellation that flies it 4% more than published and raises - the probability above to 99.9% (:doc:`ValidateCostVarianceNSOSA`) + the probability above to 99.9% (:doc:`trade_studies/ValidateCostVarianceNSOSA`) Modeling Guidance ================= diff --git a/docs/validation/ValidateCostVarianceNSOSA.ipynb b/docs/validation/trade_studies/ValidateCostVarianceNSOSA.ipynb similarity index 100% rename from docs/validation/ValidateCostVarianceNSOSA.ipynb rename to docs/validation/trade_studies/ValidateCostVarianceNSOSA.ipynb diff --git a/docs/validation/trade_studies/index.rst b/docs/validation/trade_studies/index.rst new file mode 100644 index 00000000..8901c9a6 --- /dev/null +++ b/docs/validation/trade_studies/index.rst @@ -0,0 +1,10 @@ +============= +Trade Studies +============= + +This notebook tests correlated cost risk, production blocks, and study periods against a published cost analysis of NSOSA constellations. Their headline results are collected in the :doc:`../summary`. + +.. toctree:: + :maxdepth: 1 + + ValidateCostVarianceNSOSA.ipynb From 186aebde9f9ab9a1cf695ed316c1c1adebd927a2 Mon Sep 17 00:00:00 2001 From: Paul Grogan Date: Sun, 15 Nov 2026 09:50:30 -0700 Subject: [PATCH 7/8] group the example notebooks into folders by topic (getting_started, coverage, limb_and_space, ground_systems, beside osse and tradespace), each with its own page, with the files they read beside them and the GNSS element sets of CollectRO in limb_and_space/elements --- CHANGELOG.md | 1 + .../AssessSamplingSufficiency.ipynb | 0 .../FindCoincidentObservations.ipynb | 0 .../{ => coverage}/GenerateRandomPoints.ipynb | 0 .../{ => coverage}/ghs_pop_2020_1deg.tif | Bin docs/examples/coverage/index.rst | 26 +++++++++++++++ .../CollectObservations.ipynb | 0 .../CollectOrbitGroundTrack.ipynb | 4 +-- .../ComputeCoverage.ipynb | 0 .../ComputeLatency.ipynb | 0 .../UseInstrumentCatalog.ipynb | 4 +-- docs/examples/getting_started/index.rst | 28 ++++++++++++++++ .../CollectPlatformTrack.ipynb | 2 +- .../CollectRadarTrack.ipynb | 0 .../{ => ground_systems}/ComputeDOP.ipynb | 2 +- docs/examples/ground_systems/index.rst | 24 ++++++++++++++ .../nexrad_phoenix_terrain_masks.json | 0 .../tempe_tower_terrain_mask.json | 0 docs/examples/index.rst | 30 +++++++----------- .../{ => limb_and_space}/CollectLimb.ipynb | 0 .../{ => limb_and_space}/CollectRO.ipynb | 10 +++--- .../{ => limb_and_space}/CollectSpace.ipynb | 0 .../{ => limb_and_space/elements}/bei_tle.dat | 0 .../{ => limb_and_space/elements}/gal_tle.dat | 0 .../{ => limb_and_space/elements}/glo_tle.dat | 0 .../{ => limb_and_space/elements}/gps_tle.dat | 0 docs/examples/limb_and_space/index.rst | 23 ++++++++++++++ .../ground_systems/ValidateRadarNEXRAD.ipynb | 2 +- .../limb_and_space/ValidateLimbMLS.ipynb | 4 +-- .../limb_and_space/ValidateLimbSABER.ipynb | 2 +- .../limb_and_space/ValidateROCOSMIC2.ipynb | 2 +- .../limb_and_space/ValidateSpaceCOSMIC2.ipynb | 2 +- .../limb_and_space/ValidateSpaceGRACEFO.ipynb | 2 +- tests/schemas/orbit/test_sun_synchronous.py | 2 +- 34 files changed, 133 insertions(+), 37 deletions(-) rename docs/examples/{ => coverage}/AssessSamplingSufficiency.ipynb (100%) rename docs/examples/{ => coverage}/FindCoincidentObservations.ipynb (100%) rename docs/examples/{ => coverage}/GenerateRandomPoints.ipynb (100%) rename docs/examples/{ => coverage}/ghs_pop_2020_1deg.tif (100%) create mode 100644 docs/examples/coverage/index.rst rename docs/examples/{ => getting_started}/CollectObservations.ipynb (100%) rename docs/examples/{ => getting_started}/CollectOrbitGroundTrack.ipynb (99%) rename docs/examples/{ => getting_started}/ComputeCoverage.ipynb (100%) rename docs/examples/{ => getting_started}/ComputeLatency.ipynb (100%) rename docs/examples/{ => getting_started}/UseInstrumentCatalog.ipynb (99%) create mode 100644 docs/examples/getting_started/index.rst rename docs/examples/{ => ground_systems}/CollectPlatformTrack.ipynb (99%) rename docs/examples/{ => ground_systems}/CollectRadarTrack.ipynb (100%) rename docs/examples/{ => ground_systems}/ComputeDOP.ipynb (99%) create mode 100644 docs/examples/ground_systems/index.rst rename docs/examples/{ => ground_systems}/nexrad_phoenix_terrain_masks.json (100%) rename docs/examples/{ => ground_systems}/tempe_tower_terrain_mask.json (100%) rename docs/examples/{ => limb_and_space}/CollectLimb.ipynb (100%) rename docs/examples/{ => limb_and_space}/CollectRO.ipynb (99%) rename docs/examples/{ => limb_and_space}/CollectSpace.ipynb (100%) rename docs/examples/{ => limb_and_space/elements}/bei_tle.dat (100%) rename docs/examples/{ => limb_and_space/elements}/gal_tle.dat (100%) rename docs/examples/{ => limb_and_space/elements}/glo_tle.dat (100%) rename docs/examples/{ => limb_and_space/elements}/gps_tle.dat (100%) create mode 100644 docs/examples/limb_and_space/index.rst diff --git a/CHANGELOG.md b/CHANGELOG.md index 208130b8..be59be57 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -50,6 +50,7 @@ Added: Changed: - The OSSE examples (`RunOSSEMonsoon`, `RunOSSEHurricane`) are in `docs/examples/osse`, and download the Nature Run to a `data` directory beside them. + - The example notebooks are grouped by topic in folders of `docs/examples` (`getting_started`, `coverage`, `limb_and_space`, and `ground_systems`, beside `osse` and `tradespace`), each with its own page, with the files they read beside them (the GNSS element sets of `CollectRO` in `limb_and_space/elements`). - The validation notebooks are grouped by capability, as in the summary of their results, in folders of `docs/validation` (`orbits`, `instruments`, `coverage`, `limb_and_space`, `ground_systems`, and `trade_studies`), each with its own page; they share one cache of downloads (`docs/validation/data`), and the element sets of the occultation and satellite-to-satellite notebooks are in `limb_and_space/elements`. Notebook `ValidateGeostationaryGOES` is removed: the validation of the catalog's ABI entry tests the same products. The ATMS, CrIS, VIIRS, MODIS, AMSR2, GMI, NISAR, and Sentinel-1 notebooks no longer test the passes, epochs, and swath areas that the validation of the catalog's entries tests on held-out data. - Instruments reject unknown fields, rather than ignoring them: a misspelled field in the data of a `PointedInstrument` previously gave an `Instrument` with a field of regard of 180 degrees. - Dumping a `Satellite` or other system with a `PointedInstrument` or `ConicalInstrument` keeps the fields of its class, and loading the data restores it. Previously, these instruments were written and restored as a base `Instrument`, without a warning. Data written by earlier versions lacks these fields, so it still loads as an `Instrument`. diff --git a/docs/examples/AssessSamplingSufficiency.ipynb b/docs/examples/coverage/AssessSamplingSufficiency.ipynb similarity index 100% rename from docs/examples/AssessSamplingSufficiency.ipynb rename to docs/examples/coverage/AssessSamplingSufficiency.ipynb diff --git a/docs/examples/FindCoincidentObservations.ipynb b/docs/examples/coverage/FindCoincidentObservations.ipynb similarity index 100% rename from docs/examples/FindCoincidentObservations.ipynb rename to docs/examples/coverage/FindCoincidentObservations.ipynb diff --git a/docs/examples/GenerateRandomPoints.ipynb b/docs/examples/coverage/GenerateRandomPoints.ipynb similarity index 100% rename from docs/examples/GenerateRandomPoints.ipynb rename to docs/examples/coverage/GenerateRandomPoints.ipynb diff --git a/docs/examples/ghs_pop_2020_1deg.tif b/docs/examples/coverage/ghs_pop_2020_1deg.tif similarity index 100% rename from docs/examples/ghs_pop_2020_1deg.tif rename to docs/examples/coverage/ghs_pop_2020_1deg.tif diff --git a/docs/examples/coverage/index.rst b/docs/examples/coverage/index.rst new file mode 100644 index 00000000..edbeb758 --- /dev/null +++ b/docs/examples/coverage/index.rst @@ -0,0 +1,26 @@ +================= +Coverage Analyses +================= + +These notebooks choose where to sample and analyze what observations +sample: + +#. :doc:`GenerateRandomPoints`: generate random points, uniformly or weighted + by a population grid, and find when an imaging satellite observes them. +#. :doc:`FindCoincidentObservations`: find when two or more satellites + observe the same place at nearly the same time, as points and as ground + tracks. +#. :doc:`AssessSamplingSufficiency`: assess whether a constellation samples a + varying field sufficiently, from the error of its estimates, its revisits, + and the times of day it sees, and test the estimates with a synthetic + nature run. + +The AssessSamplingSufficiency example also requires xarray +(``pip install xarray``) for its nature run. + +.. toctree:: + :hidden: + + GenerateRandomPoints.ipynb + FindCoincidentObservations.ipynb + AssessSamplingSufficiency.ipynb diff --git a/docs/examples/CollectObservations.ipynb b/docs/examples/getting_started/CollectObservations.ipynb similarity index 100% rename from docs/examples/CollectObservations.ipynb rename to docs/examples/getting_started/CollectObservations.ipynb diff --git a/docs/examples/CollectOrbitGroundTrack.ipynb b/docs/examples/getting_started/CollectOrbitGroundTrack.ipynb similarity index 99% rename from docs/examples/CollectOrbitGroundTrack.ipynb rename to docs/examples/getting_started/CollectOrbitGroundTrack.ipynb index 056a1be3..aa6270ab 100644 --- a/docs/examples/CollectOrbitGroundTrack.ipynb +++ b/docs/examples/getting_started/CollectOrbitGroundTrack.ipynb @@ -669,7 +669,7 @@ "source": [ "## Compare a Detailed VIIRS Model\n", "\n", - "The VIIRS instrument above is a simple model: a nadir `Instrument` whose field of regard spans a nominal 3,000 km swath, so that its footprint at each time is a circle around the sub-satellite point. The [VIIRS validation](../validation/instruments/ValidateImagerVIIRS.ipynb) fits a more detailed model to NOAA-20's geolocated pixels:\n", + "The VIIRS instrument above is a simple model: a nadir `Instrument` whose field of regard spans a nominal 3,000 km swath, so that its footprint at each time is a circle around the sub-satellite point. The [VIIRS validation](../../validation/instruments/ValidateImagerVIIRS.ipynb) fits a more detailed model to NOAA-20's geolocated pixels:\n", "\n", "* **Scan extent.** VIIRS samples scan angles from -56.13 to +55.96 deg (positive to the left): a `PointedInstrument` whose cross-track field of view spans them, rolled 0.085 deg to the right.\n", "* **Scan geometry.** Each scan images 16 detector rows, which subtend a constant angle along track at every scan angle, so that scans grow longer toward the swath edges (the \"bow tie\" effect). `ViewGeometry.SCAN` represents this.\n", @@ -1075,7 +1075,7 @@ "id": "fa6b9dd9", "metadata": {}, "source": [ - "Between the equator and 20 deg north, the detailed swath is about 45 km wider than the simple one at one scan period, because VIIRS's measured scan extent is wider than the field of regard of a nominal 3,000 km swath, and contains it entirely. At 2-minute steps, the simple model also misses the scalloped strips along each edge between its circular footprints. Each model suits a purpose: the simple field of regard is fast and adequate for coverage over long periods at coarse time steps, while the detailed model reproduces VIIRS's scans, their bow tie overlap, and their orientation, for analyses at the scale of individual scans (see the [instrument catalog](../validation/catalog.rst) for observation times and swath widths of the catalog's VIIRS entry compared with the instrument's data)." + "Between the equator and 20 deg north, the detailed swath is about 45 km wider than the simple one at one scan period, because VIIRS's measured scan extent is wider than the field of regard of a nominal 3,000 km swath, and contains it entirely. At 2-minute steps, the simple model also misses the scalloped strips along each edge between its circular footprints. Each model suits a purpose: the simple field of regard is fast and adequate for coverage over long periods at coarse time steps, while the detailed model reproduces VIIRS's scans, their bow tie overlap, and their orientation, for analyses at the scale of individual scans (see the [instrument catalog](../../validation/catalog.rst) for observation times and swath widths of the catalog's VIIRS entry compared with the instrument's data)." ] } ], diff --git a/docs/examples/ComputeCoverage.ipynb b/docs/examples/getting_started/ComputeCoverage.ipynb similarity index 100% rename from docs/examples/ComputeCoverage.ipynb rename to docs/examples/getting_started/ComputeCoverage.ipynb diff --git a/docs/examples/ComputeLatency.ipynb b/docs/examples/getting_started/ComputeLatency.ipynb similarity index 100% rename from docs/examples/ComputeLatency.ipynb rename to docs/examples/getting_started/ComputeLatency.ipynb diff --git a/docs/examples/UseInstrumentCatalog.ipynb b/docs/examples/getting_started/UseInstrumentCatalog.ipynb similarity index 99% rename from docs/examples/UseInstrumentCatalog.ipynb rename to docs/examples/getting_started/UseInstrumentCatalog.ipynb index 33797160..d2df660d 100644 --- a/docs/examples/UseInstrumentCatalog.ipynb +++ b/docs/examples/getting_started/UseInstrumentCatalog.ipynb @@ -9,13 +9,13 @@ "\n", "The `tatc.catalog` module holds instruments of past and present missions, in configurations that were compared with their data products. Rather than choosing a field of regard and attitude by hand, an analysis can take an entry's instruments with the attitude they were tested with.\n", "\n", - "Each entry also states how well it was tested. Its *tier* is computed from its results and the thresholds of the [validation standard](../validation/standard.rst):\n", + "Each entry also states how well it was tested. Its *tier* is computed from its results and the thresholds of the [validation standard](../../validation/standard.rst):\n", "\n", "* `validated`: every test of the standard passed, with fitted values tested on data at least 30 days from their fitting data;\n", "* `partial`: some tests failed or are missing, and the entry lists each gap (`validation.gaps`);\n", "* `nominal`: published values only.\n", "\n", - "Every entry, including a validated one, has limitations, listed with its configurations. The [instrument catalog](../validation/catalog.rst) lists the entries and their results." + "Every entry, including a validated one, has limitations, listed with its configurations. The [instrument catalog](../../validation/catalog.rst) lists the entries and their results." ] }, { diff --git a/docs/examples/getting_started/index.rst b/docs/examples/getting_started/index.rst new file mode 100644 index 00000000..45db8a0b --- /dev/null +++ b/docs/examples/getting_started/index.rst @@ -0,0 +1,28 @@ +=============== +Getting Started +=============== + +These notebooks introduce the analysis functions of TAT-C with one satellite, +NOAA-20, and its Visible Infrared Imaging Radiometer Suite (VIIRS). Read them +in order: + +#. :doc:`CollectObservations`: define a satellite and its instrument, and + collect its observations of a point. +#. :doc:`UseInstrumentCatalog`: take instruments of past and present missions + from the catalog, with the attitude they were tested with, and read how + well each was tested. +#. :doc:`CollectOrbitGroundTrack`: collect the orbit and ground track of a + satellite, with a requirement that targets be sunlit, and compare a + detailed model of VIIRS with the simple one. +#. :doc:`ComputeCoverage`: compute the coverage of a region of interest. +#. :doc:`ComputeLatency`: compute the latency of observations downlinked to + ground stations. + +.. toctree:: + :hidden: + + CollectObservations.ipynb + UseInstrumentCatalog.ipynb + CollectOrbitGroundTrack.ipynb + ComputeCoverage.ipynb + ComputeLatency.ipynb diff --git a/docs/examples/CollectPlatformTrack.ipynb b/docs/examples/ground_systems/CollectPlatformTrack.ipynb similarity index 99% rename from docs/examples/CollectPlatformTrack.ipynb rename to docs/examples/ground_systems/CollectPlatformTrack.ipynb index 48e05a06..24207b5e 100644 --- a/docs/examples/CollectPlatformTrack.ipynb +++ b/docs/examples/ground_systems/CollectPlatformTrack.ipynb @@ -9,7 +9,7 @@ "\n", "This example demonstrates how to use direct function calls of the low-level TAT-C library to collect the coverage footprints of instruments on fixed surface platforms, such as towers and tethered balloons, using the `SurfacePlatform` schema and the `collect_platform_track`/`compute_platform_track` analysis functions.\n", "\n", - "A fixed platform combines features of two other TAT-C observing systems. Like a ground-based radar (see the [Collect Radar Coverage](CollectRadarTrack.ipynb) example), it does not move in the Earth-fixed frame, so these functions report one static footprint per platform and instrument rather than a time series. Like a satellite (see the [Collect Orbit and Ground Track](CollectOrbitGroundTrack.ipynb) example), it hosts generic (`Instrument`) or pointed (`PointedInstrument`) instruments, whose views are projected onto a target elevation exactly as a satellite's ground track is.\n", + "A fixed platform combines features of two other TAT-C observing systems. Like a ground-based radar (see the [Collect Radar Coverage](CollectRadarTrack.ipynb) example), it does not move in the Earth-fixed frame, so these functions report one static footprint per platform and instrument rather than a time series. Like a satellite (see the [Collect Orbit and Ground Track](../getting_started/CollectOrbitGroundTrack.ipynb) example), it hosts generic (`Instrument`) or pointed (`PointedInstrument`) instruments, whose views are projected onto a target elevation exactly as a satellite's ground track is.\n", "\n", "The platforms in this example are hypothetical, sited around Phoenix, Arizona." ] diff --git a/docs/examples/CollectRadarTrack.ipynb b/docs/examples/ground_systems/CollectRadarTrack.ipynb similarity index 100% rename from docs/examples/CollectRadarTrack.ipynb rename to docs/examples/ground_systems/CollectRadarTrack.ipynb diff --git a/docs/examples/ComputeDOP.ipynb b/docs/examples/ground_systems/ComputeDOP.ipynb similarity index 99% rename from docs/examples/ComputeDOP.ipynb rename to docs/examples/ground_systems/ComputeDOP.ipynb index bbc1056f..a777a20b 100644 --- a/docs/examples/ComputeDOP.ipynb +++ b/docs/examples/ground_systems/ComputeDOP.ipynb @@ -523,7 +523,7 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "" + "" ] } ], diff --git a/docs/examples/ground_systems/index.rst b/docs/examples/ground_systems/index.rst new file mode 100644 index 00000000..7f7f207a --- /dev/null +++ b/docs/examples/ground_systems/index.rst @@ -0,0 +1,24 @@ +============================= +Ground Systems and Navigation +============================= + +These notebooks analyze observing systems on the surface and navigation +constellations: + +#. :doc:`CollectRadarTrack`: the coverage of ground-based radars (NEXRAD, + around Phoenix, Arizona), with masks of terrain blockage, and a comparison + of radar bands. +#. :doc:`CollectPlatformTrack`: the coverage of instruments on towers and + tethered balloons. +#. :doc:`ComputeDOP`: the dilution of precision of a GPS-like constellation + over a day, compared with STK. + +The masks of terrain blockage that the radar and platform examples read are +beside them. + +.. toctree:: + :hidden: + + CollectRadarTrack.ipynb + CollectPlatformTrack.ipynb + ComputeDOP.ipynb diff --git a/docs/examples/nexrad_phoenix_terrain_masks.json b/docs/examples/ground_systems/nexrad_phoenix_terrain_masks.json similarity index 100% rename from docs/examples/nexrad_phoenix_terrain_masks.json rename to docs/examples/ground_systems/nexrad_phoenix_terrain_masks.json diff --git a/docs/examples/tempe_tower_terrain_mask.json b/docs/examples/ground_systems/tempe_tower_terrain_mask.json similarity index 100% rename from docs/examples/tempe_tower_terrain_mask.json rename to docs/examples/ground_systems/tempe_tower_terrain_mask.json diff --git a/docs/examples/index.rst b/docs/examples/index.rst index 0ad624ba..28a87d9f 100644 --- a/docs/examples/index.rst +++ b/docs/examples/index.rst @@ -2,25 +2,15 @@ Examples ======== -The following provide examples of TAT-C use in a Jupyter notebook environment. +The following provide examples of TAT-C use in a Jupyter notebook environment, grouped by topic. Start with the getting started examples, which introduce the analysis functions with one satellite. .. toctree:: - :maxdepth: 1 - - CollectObservations.ipynb - UseInstrumentCatalog.ipynb - GenerateRandomPoints.ipynb - CollectOrbitGroundTrack.ipynb - CollectRadarTrack.ipynb - CollectPlatformTrack.ipynb - ComputeCoverage.ipynb - FindCoincidentObservations.ipynb - ComputeLatency.ipynb - ComputeDOP.ipynb - CollectRO.ipynb - CollectLimb.ipynb - CollectSpace.ipynb - AssessSamplingSufficiency.ipynb + :maxdepth: 2 + + getting_started/index + coverage/index + limb_and_space/index + ground_systems/index osse/index tradespace/index @@ -28,6 +18,10 @@ Note that running the above examples in a local Python environment requires addi pip install tatc[examples] -using the pip package manager. The AssessSamplingSufficiency example also requires xarray (``pip install xarray``) for its nature run. The trade space tutorial also requires:: +using the pip package manager. The observing system simulation experiments require:: + + pip install tatc[osse] + +and the trade space tutorial requires:: pip install tatc[tradespace] diff --git a/docs/examples/CollectLimb.ipynb b/docs/examples/limb_and_space/CollectLimb.ipynb similarity index 100% rename from docs/examples/CollectLimb.ipynb rename to docs/examples/limb_and_space/CollectLimb.ipynb diff --git a/docs/examples/CollectRO.ipynb b/docs/examples/limb_and_space/CollectRO.ipynb similarity index 99% rename from docs/examples/CollectRO.ipynb rename to docs/examples/limb_and_space/CollectRO.ipynb index 8d4bd937..60caf95f 100644 --- a/docs/examples/CollectRO.ipynb +++ b/docs/examples/limb_and_space/CollectRO.ipynb @@ -19,7 +19,7 @@ "\n", "Assume the transmitter (tx) and receiver (rx) have positions $x_{tx}$ and $x_{rx}$ and velocities $v_{tx}$ and $v_{rx}$, respectively, in a geocentric inertial frame. The transmitter has position $x_{rx,tx}=x_{tx}-x_{rx}$ and velocity $v_{rx,tx}=v_{tx}-v_{rx}$ relative to the receiver.\n", "\n", - "\n", + "\n", "\n", "The tangent point is the point on the line $x_{rx} + s\\hat{d}$, with $\\hat{d} = x_{rx,tx} / ||x_{rx,tx}||$, that has minimum geodetic altitude above the WGS 84 reference ellipsoid: the convention used to geolocate operationally processed GNSS-RO profiles. A first approximation is the point of minimum distance to the geocenter:\n", "\n", @@ -50,7 +50,7 @@ "\n", "is the unit normal to the receiver orbit plane.\n", "\n", - "" + "" ] }, { @@ -67,7 +67,7 @@ "\n", "is the relative transmitter position in the plane tangent to the receiver orbit.\n", "\n", - "" + "" ] }, { @@ -87,7 +87,7 @@ "\n", "$\\text{sgn} \\left( (x_{tp} - x_{tx}) \\cdot (x_{tp} - x_{rx}) \\right) < 0$\n", "\n", - "" + "" ] }, { @@ -182,7 +182,7 @@ "\n", "txs = []\n", "\n", - "for gnss_dat in [\"gps_tle.dat\", \"glo_tle.dat\", \"gal_tle.dat\", \"bei_tle.dat\"]:\n", + "for gnss_dat in [\"elements/gps_tle.dat\", \"elements/glo_tle.dat\", \"elements/gal_tle.dat\", \"elements/bei_tle.dat\"]:\n", " with open(gnss_dat, \"r\") as f:\n", " lines = f.read().splitlines()\n", " for i in range(0, len(lines), 3):\n", diff --git a/docs/examples/CollectSpace.ipynb b/docs/examples/limb_and_space/CollectSpace.ipynb similarity index 100% rename from docs/examples/CollectSpace.ipynb rename to docs/examples/limb_and_space/CollectSpace.ipynb diff --git a/docs/examples/bei_tle.dat b/docs/examples/limb_and_space/elements/bei_tle.dat similarity index 100% rename from docs/examples/bei_tle.dat rename to docs/examples/limb_and_space/elements/bei_tle.dat diff --git a/docs/examples/gal_tle.dat b/docs/examples/limb_and_space/elements/gal_tle.dat similarity index 100% rename from docs/examples/gal_tle.dat rename to docs/examples/limb_and_space/elements/gal_tle.dat diff --git a/docs/examples/glo_tle.dat b/docs/examples/limb_and_space/elements/glo_tle.dat similarity index 100% rename from docs/examples/glo_tle.dat rename to docs/examples/limb_and_space/elements/glo_tle.dat diff --git a/docs/examples/gps_tle.dat b/docs/examples/limb_and_space/elements/gps_tle.dat similarity index 100% rename from docs/examples/gps_tle.dat rename to docs/examples/limb_and_space/elements/gps_tle.dat diff --git a/docs/examples/limb_and_space/index.rst b/docs/examples/limb_and_space/index.rst new file mode 100644 index 00000000..1166ed27 --- /dev/null +++ b/docs/examples/limb_and_space/index.rst @@ -0,0 +1,23 @@ +============================================= +Limb, Occultation, and Satellite-to-Satellite +============================================= + +These notebooks analyze observations that look through the atmosphere or +across space rather than down at the surface. Each builds on the one before +it: + +#. :doc:`CollectRO`: GNSS radio occultations, at the tangent point between a + receiver and a transmitter. The element sets of the GNSS constellations + it reads are in the ``elements`` folder beside it. +#. :doc:`CollectLimb`: the tangent points of a limb sounder, which scans in + elevation from its own spacecraft. +#. :doc:`CollectSpace`: the periods when one satellite can observe another, + with the line of sight between them clear of the Earth, including + satellites observing geostationary ones. + +.. toctree:: + :hidden: + + CollectRO.ipynb + CollectLimb.ipynb + CollectSpace.ipynb diff --git a/docs/validation/ground_systems/ValidateRadarNEXRAD.ipynb b/docs/validation/ground_systems/ValidateRadarNEXRAD.ipynb index 24af0b3d..8a5e54b9 100644 --- a/docs/validation/ground_systems/ValidateRadarNEXRAD.ipynb +++ b/docs/validation/ground_systems/ValidateRadarNEXRAD.ipynb @@ -7,7 +7,7 @@ "source": [ "# Ground Radar Validation: NEXRAD\n", "\n", - "This notebook validates the ground-based radar analysis in TAT-C (`RadarStation`, `collect_radar_track`, and `compute_radar_track`, see the [Collect Radar Coverage](../../examples/CollectRadarTrack.ipynb) example) against archived data from the same four NOAA NEXRAD (WSR-88D) weather radars used in the example: `KIWA` (Phoenix), `KFSX` (Flagstaff), `KYUX` (Yuma), and `KEMX` (Tucson).\n", + "This notebook validates the ground-based radar analysis in TAT-C (`RadarStation`, `collect_radar_track`, and `compute_radar_track`, see the [Collect Radar Coverage](../../examples/ground_systems/CollectRadarTrack.ipynb) example) against archived data from the same four NOAA NEXRAD (WSR-88D) weather radars used in the example: `KIWA` (Phoenix), `KFSX` (Flagstaff), `KYUX` (Yuma), and `KEMX` (Tucson).\n", "\n", "TAT-C's *projected track* for a radar is the area within which a target at a given height lies between the radar's lowest and highest observed elevation angles (the lowest and highest scanned beam centers, extended by half the beam width) and within its maximum range, optionally reduced by an azimuthal terrain mask. The reference here is the area each radar actually sampled, reconstructed from its own archived volume scans. The comparison asks four questions:\n", "\n", diff --git a/docs/validation/limb_and_space/ValidateLimbMLS.ipynb b/docs/validation/limb_and_space/ValidateLimbMLS.ipynb index 2db5a6fe..4d2aeccd 100644 --- a/docs/validation/limb_and_space/ValidateLimbMLS.ipynb +++ b/docs/validation/limb_and_space/ValidateLimbMLS.ipynb @@ -7,7 +7,7 @@ "source": [ "# Limb Sounding Validation: Aura MLS\n", "\n", - "This notebook validates the limb sounding analysis in TAT-C (`collect_limb_observations`, see the [Limb Sounding Observations](../../examples/CollectLimb.ipynb) example) against an operational mission: the [Microwave Limb Sounder (MLS)](https://mls.jpl.nasa.gov/) aboard NASA's Aura spacecraft. MLS views forward along the flight direction and scans its antenna upward through the atmosphere roughly every 25 seconds, so it exercises a forward-looking (`scan_azimuth = 0`), upward-scanning configuration.\n", + "This notebook validates the limb sounding analysis in TAT-C (`collect_limb_observations`, see the [Limb Sounding Observations](../../examples/limb_and_space/CollectLimb.ipynb) example) against an operational mission: the [Microwave Limb Sounder (MLS)](https://mls.jpl.nasa.gov/) aboard NASA's Aura spacecraft. MLS views forward along the flight direction and scans its antenna upward through the atmosphere roughly every 25 seconds, so it exercises a forward-looking (`scan_azimuth = 0`), upward-scanning configuration.\n", "\n", "The comparison uses one full day of MLS data (14 August 2026) and asks four questions, from the most isolated component to the end-to-end result:\n", "\n", @@ -806,7 +806,7 @@ "\n", "TAT-C scans are now started at each nominal MLS major frame start time and compared sample by sample with the MLS scan in the same major frame. Two configurations are tested:\n", "\n", - "* **Example configuration:** the settings of the [example notebook](../../examples/CollectLimb.ipynb) (a standard pressure grid from 1000 to 0.01 hPa, roughly 0 to 80 km, swept in 25 s).\n", + "* **Example configuration:** the settings of the [example notebook](../../examples/limb_and_space/CollectLimb.ipynb) (a standard pressure grid from 1000 to 0.01 hPa, roughly 0 to 80 km, swept in 25 s).\n", "* **Matched configuration:** 11 evenly spaced elevations between the bottom and top of the median MLS scan (about 1 to 92 km), swept in the measured upward sweep duration (about 20.5 s).\n", "\n", "Per-sample times are taken from `_sample_limb_scan`, the routine `collect_limb_observations` uses for each scan, since the public output reports times only for each scan's start, end, and representative point. The representative `position` and `time` are taken from `collect_limb_observations` itself." diff --git a/docs/validation/limb_and_space/ValidateLimbSABER.ipynb b/docs/validation/limb_and_space/ValidateLimbSABER.ipynb index d8df9915..d4e9e57b 100644 --- a/docs/validation/limb_and_space/ValidateLimbSABER.ipynb +++ b/docs/validation/limb_and_space/ValidateLimbSABER.ipynb @@ -7,7 +7,7 @@ "source": [ "# Limb Sounding Validation: TIMED SABER\n", "\n", - "This notebook validates the limb sounding analysis in TAT-C (`collect_limb_observations`, see the [Limb Sounding Observations](../../examples/CollectLimb.ipynb) example) against the [Sounding of the Atmosphere using Broadband Emission Radiometry (SABER)](https://saber.gats-inc.com/) instrument aboard NASA's Thermosphere Ionosphere Mesosphere Energetics and Dynamics (TIMED) spacecraft.\n", + "This notebook validates the limb sounding analysis in TAT-C (`collect_limb_observations`, see the [Limb Sounding Observations](../../examples/limb_and_space/CollectLimb.ipynb) example) against the [Sounding of the Atmosphere using Broadband Emission Radiometry (SABER)](https://saber.gats-inc.com/) instrument aboard NASA's Thermosphere Ionosphere Mesosphere Energetics and Dynamics (TIMED) spacecraft.\n", "\n", "SABER complements the [Aura MLS validation](ValidateLimbMLS.ipynb) in two ways. It looks sideways, perpendicular to the flight direction (`scan_azimuth = 90`), rather than forward. And it alternates upward and downward vertical scans, exercising both `ScanDirection` options.\n", "\n", diff --git a/docs/validation/limb_and_space/ValidateROCOSMIC2.ipynb b/docs/validation/limb_and_space/ValidateROCOSMIC2.ipynb index f8d6d028..13a2e54b 100644 --- a/docs/validation/limb_and_space/ValidateROCOSMIC2.ipynb +++ b/docs/validation/limb_and_space/ValidateROCOSMIC2.ipynb @@ -7,7 +7,7 @@ "source": [ "# Radio Occultation Validation: COSMIC-2\n", "\n", - "This notebook validates the radio occultation (RO) analysis in TAT-C (`collect_ro_observations`, see the [GNSS Radio Occultation](../../examples/CollectRO.ipynb) example) against the [COSMIC-2](https://www.cosmic.ucar.edu/what-we-do/cosmic-2) constellation receiving GPS, GLONASS, and Galileo signals on 14 May 2026. TAT-C models each occultation with the straight line between receiver and transmitter (refraction is not modeled) and reports the line's tangent point, its point of minimum WGS 84 geodetic altitude, the convention used to geolocate operationally processed RO profiles.\n", + "This notebook validates the radio occultation (RO) analysis in TAT-C (`collect_ro_observations`, see the [GNSS Radio Occultation](../../examples/limb_and_space/CollectRO.ipynb) example) against the [COSMIC-2](https://www.cosmic.ucar.edu/what-we-do/cosmic-2) constellation receiving GPS, GLONASS, and Galileo signals on 14 May 2026. TAT-C models each occultation with the straight line between receiver and transmitter (refraction is not modeled) and reports the line's tangent point, its point of minimum WGS 84 geodetic altitude, the convention used to geolocate operationally processed RO profiles.\n", "\n", "`collect_ro_observations` is run end to end with published orbits for the day, and its predictions are compared with every GPS, GLONASS, and Galileo occultation COSMIC-2 recorded, separately for each constellation:\n", "\n", diff --git a/docs/validation/limb_and_space/ValidateSpaceCOSMIC2.ipynb b/docs/validation/limb_and_space/ValidateSpaceCOSMIC2.ipynb index 4ef27ce1..ab2b3d87 100644 --- a/docs/validation/limb_and_space/ValidateSpaceCOSMIC2.ipynb +++ b/docs/validation/limb_and_space/ValidateSpaceCOSMIC2.ipynb @@ -7,7 +7,7 @@ "source": [ "# Satellite-to-Satellite Validation: COSMIC-2\n", "\n", - "This notebook validates TAT-C's satellite-to-satellite analysis (`collect_space_observations`, see the [Space-Based Coverage](../../examples/CollectSpace.ipynb) example) against the radio occultations recorded by the [COSMIC-2](https://www.cosmic.ucar.edu/what-we-do/cosmic-2) constellation on 14 May 2026. `collect_space_observations` finds the periods when one satellite can observe another, as by a sensor or a radio link, subject to the slant range and to the Earth's occlusion of the straight line of sight between them: its minimum WGS 84 geodetic altitude must be at least `min_grazing_altitude`.\n", + "This notebook validates TAT-C's satellite-to-satellite analysis (`collect_space_observations`, see the [Space-Based Coverage](../../examples/limb_and_space/CollectSpace.ipynb) example) against the radio occultations recorded by the [COSMIC-2](https://www.cosmic.ucar.edu/what-we-do/cosmic-2) constellation on 14 May 2026. `collect_space_observations` finds the periods when one satellite can observe another, as by a sensor or a radio link, subject to the slant range and to the Earth's occlusion of the straight line of sight between them: its minimum WGS 84 geodetic altitude must be at least `min_grazing_altitude`.\n", "\n", "A radio occultation (RO) is such an occlusion event. As a GNSS satellite sets behind the Earth as seen from a receiver in low Earth orbit (or rises from behind it), the line of sight between them sweeps down (or up) through the atmosphere, which the receiver profiles from the bending of the signal. TAT-C's RO analysis (`collect_ro_observations`, validated in [Radio Occultation Validation: COSMIC-2](ValidateROCOSMIC2.ipynb)) reports each occultation at the time the straight line reaches its `sample_elevation`, by default -80 km (refraction is not modeled). With `min_grazing_altitude` set to the same -80 km, each window of `collect_space_observations` from a receiver to a transmitter should therefore start with a rising occultation and end with a setting one. The satellites' recorded positions provide an independent truth for the occlusion constraint, the search for window edges, and the analysis of many pairs of satellites at once:\n", "\n", diff --git a/docs/validation/limb_and_space/ValidateSpaceGRACEFO.ipynb b/docs/validation/limb_and_space/ValidateSpaceGRACEFO.ipynb index 466f4487..23180038 100644 --- a/docs/validation/limb_and_space/ValidateSpaceGRACEFO.ipynb +++ b/docs/validation/limb_and_space/ValidateSpaceGRACEFO.ipynb @@ -7,7 +7,7 @@ "source": [ "# Satellite-to-Satellite Validation: GRACE-FO\n", "\n", - "This notebook validates TAT-C's satellite-to-satellite analysis (`collect_space_observations`, see the [Space-Based Coverage](../../examples/CollectSpace.ipynb) example) against the precise orbits of the two [GRACE-FO](https://gracefo.jpl.nasa.gov/) satellites over a week, 17 to 23 September 2026. The satellites follow each other in the same near-polar orbit, at an altitude of about 490 km and roughly 175 to 180 km apart, so the line of sight between them is always clear of the Earth, but its length and its minimum altitude vary around each orbit. A companion notebook, [Satellite-to-Satellite Validation: COSMIC-2](ValidateSpaceCOSMIC2.ipynb), validates the Earth's occlusion of the line of sight against radio occultations; this one validates the slant range constraints (`min_range` and `max_range`) and the occlusion constraint at an altitude well above the surface (`min_grazing_altitude`), and the orbit track positions they depend on:\n", + "This notebook validates TAT-C's satellite-to-satellite analysis (`collect_space_observations`, see the [Space-Based Coverage](../../examples/limb_and_space/CollectSpace.ipynb) example) against the precise orbits of the two [GRACE-FO](https://gracefo.jpl.nasa.gov/) satellites over a week, 17 to 23 September 2026. The satellites follow each other in the same near-polar orbit, at an altitude of about 490 km and roughly 175 to 180 km apart, so the line of sight between them is always clear of the Earth, but its length and its minimum altitude vary around each orbit. A companion notebook, [Satellite-to-Satellite Validation: COSMIC-2](ValidateSpaceCOSMIC2.ipynb), validates the Earth's occlusion of the line of sight against radio occultations; this one validates the slant range constraints (`min_range` and `max_range`) and the occlusion constraint at an altitude well above the surface (`min_grazing_altitude`), and the orbit track positions they depend on:\n", "\n", "1. **Orbits.** How closely do published orbits, as propagated by TAT-C (`collect_orbit_track` in Earth-fixed coordinates), reproduce each satellite's precise orbit?\n", "2. **Range.** How accurately does TAT-C compute the range between the satellites?\n", diff --git a/tests/schemas/orbit/test_sun_synchronous.py b/tests/schemas/orbit/test_sun_synchronous.py index ae287cfd..745281d8 100644 --- a/tests/schemas/orbit/test_sun_synchronous.py +++ b/tests/schemas/orbit/test_sun_synchronous.py @@ -154,7 +154,7 @@ def test_get_right_ascension_ascending_node_matches_real_noaa20_tle(self): """ Test get_right_ascension_ascending_node against a real NOAA-20 two-line element set (the same TLE used in - docs/examples/ComputeCoverage.ipynb), rather than only a + docs/examples/getting_started/ComputeCoverage.ipynb), rather than only a synthetic/derived example. NOAA-20's documented local time of ascending node is 13:30 +/- 10 minutes (see eoPortal), which corresponds to a RAAN tolerance of about +/- 2.5 degrees (15 From 98f40fca104b2389a5171db2e137db74f63a4e29 Mon Sep 17 00:00:00 2001 From: Paul Grogan Date: Sun, 15 Nov 2026 09:58:49 -0700 Subject: [PATCH 8/8] describe what each metric of the validation standard measures and how, grouped by grade, and state that a gate takes the worst value over scopes --- docs/validation/standard.rst | 142 ++++++++++++++++++++++++++++++++++- 1 file changed, 141 insertions(+), 1 deletion(-) diff --git a/docs/validation/standard.rst b/docs/validation/standard.rst index e2c87de1..1177c3b9 100644 --- a/docs/validation/standard.rst +++ b/docs/validation/standard.rst @@ -109,7 +109,8 @@ Gates A configuration's grade states its use. Coverage and timing differ only in the epoch gate. Cross-track and conical instruments also need a configuration at the sample size grade. Orbit error against recorded positions is reported but not -gated, because it grades the element set rather than the instrument. +gated, because it grades the element set rather than the instrument. What each +metric measures, and how, is stated under `Metrics`_. Lidar, altimeter, and profiler gates are separate, because they observe narrow tracks rather than a swath. Profilers take the altimeter's gates, with the track @@ -241,6 +242,145 @@ to cover the step. Swept swaths changed no threshold. Records were rescored with them on the same held-out data, and configurations whose tier changed were tested again on a later held-out day (:doc:`summary`). +Metrics +======= + +Each metric compares a prediction made with public TAT-C methods and the entry's +values against reference data: the instrument's geolocated products, whose positions +and times are taken as true. The catalog's validation scripts compute the metrics, +with shared computations in :mod:`tatc.catalog.metrics`. Unit tests recompute them +from a reduced fixture of each record. A test may score several parts or conditions +separately (instruments, platforms, time steps, or the two edges of a swath); each +is recorded with its scope, and a gate takes the worst value over scopes. + +Coverage +-------- + +**Pass recall** and **pass precision** test whether TAT-C predicts the right +overpasses. Points are spread evenly over the Earth, a few hundred kilometers apart, +on a Fibonacci lattice. A point is observed on a pass when it lies inside the cells +formed by the product's geolocated samples, with one pass for each visit (samples +more than 20 minutes apart, or in another acquisition, belong to separate visits). +TAT-C predicts the observations of the same points over the same period with +:func:`~tatc.analysis.collect_observations`, leaving out the periods without data. +Each observed pass is matched with the nearest prediction for its point within 10 +minutes. + +* *Recall* is the share of observed passes that were predicted. A missed pass + means TAT-C would undercount coverage, so every class has this gate. +* *Precision* is the share of predicted passes that were observed. A predicted + pass that was not observed means TAT-C would overcount coverage. The gate applies + only to instruments that observe whatever is in view, not to those whose + acquisitions follow plans or whose products omit observations (see `Gates`_). + +**Swath width, median** tests the width of the predicted swath across track. At a +sample of scans, the width the instrument predicts (`get_swath_width`) at the +satellite's altitude at the time of the scan is compared with the width of the +data: + +* for cross-track scanners, the length of the scan line through the centers of + its samples, from one end to the other; +* for conical scanners, the chord between the first and last samples of the + scanned arc; +* for pushbroom imagers, the width of the valid data across track (of a tile or + through the center of a scene). + +The gate takes the median absolute difference, in km. + +**Swath edges, 95th percentile** tests the edges of side-looking swaths (SAR and +scatterometers), whose roll angle may vary around the orbit. At each line across +track of a product's geolocation grid, the rays at the near and far edges of the +view (the roll angle plus or minus half the field of view, at the time of the line) +are projected to the ground. The metric is the horizontal distance from each edge +of the line to its ray. The gate takes the 95th percentile, in km, at whichever of +the near and far edges is worse. + +**Footprint or swath IoU** tests the area covered, as the intersection over union +of the predicted and observed areas, weighted by area: 1 when they coincide, and 0 +when they are disjoint. The predicted area is the swath of +:func:`~tatc.analysis.compute_ground_track` over the same interval. + +* For global swaths (cross-track and conical scanners), the observed area is the + set of cells of a 0.1 deg grid inside the product's geolocation over one orbit. + Only cells within 300 km of the data, and away from the start and end of the + orbit, are compared, so the ends of the interval do not count as errors. +* For pushbroom imagers, SAR, and scatterometers, whose products are tiles, scenes, + or frames of an acquisition, the observed area is the union of a chunk of + consecutive products, cut at lines across the track in the middle of the first + and last product, so that the ragged ends of products do not count as errors. The + median is taken over the chunks; for SAR and scatterometers, so is the 5th + percentile, so that a few poor chunks cannot hide behind a good median. + +Each is scored at several time steps, as stated above, and gated at the lowest. + +**Segment recall** tests narrow tracks (lidar, altimeters, and profilers), the +counterpart of pass recall for views too narrow for a lattice of points. For a +sample of measurements (beam segments, altimeter measurements, or profiles), TAT-C +is asked with :func:`~tatc.analysis.collect_observations` whether the view of the +measurement's beam observes its location within 2 minutes of its time. The metric +is the share observed, at each time step, and the gate takes the lowest. For +ICESat-2, only measurements over Antarctica count, where the beams follow their +reference tracks rather than being pointed off them. + +**Beam spacing error, median** tests the distance across track between the beams of +a multi-beam lidar. Each segment's offset across track from the predicted ground +track is measured, and the median offset of each beam is taken in bins of 10 s. +In each bin, the distance between adjacent beams is compared with the distance +between the centers of their views on the ground. The gate takes the median +absolute difference, in km. As a difference of offsets, it leaves out errors of +the element set that move all beams together. + +**Track offset, median** tests where a narrow track lies. Each measurement's +distance across track is measured from the predicted track: the ground track for an +altimeter, and the track of the view's center (from `compute_footprint_center` +within 30 s of the measurement) for a profiler. The gate takes the median absolute +distance, in km. + +**Product limit of local zenith angle** tests the field of regard of geostationary +imagers that observe the Earth's disk. Their products state a bound of local zenith +angle beyond which retrievals are not of quantitative quality, and the field of +regard is set to that bound. A sample of retrieved pixels within 5 deg of the bound +is checked for whether TAT-C predicts each as observed. The metric is the larger of +the distances from the bound of the greatest zenith angle predicted as observed and +of the smallest predicted as not observed, in degrees: how far the predicted edge +lies from the product's. + +**Field of regard IoU with the area imaged in a scan** tests geostationary +instruments that scan a fixed region (TEMPO). The area imaged is the outline of the +outer corners of the outermost pixels of a full scan. On a grid of 0.05 deg around +it, each point is predicted as observed if it is in the field of view from the +satellite's position at the middle of the scan and above its horizon. The metric is +the intersection over union of the two areas, weighted by area. + +Timing +------ + +**Epoch, 95th percentile** tests when TAT-C predicts an observation. It is the +difference between the predicted time of observation of a point and the time the +reference shows the point was imaged, over matched passes or a sample of points. +The reference time is that of the instrument's own geolocation: the time of the +sample nearest the point (interpolated between the scans before and after it, for +scanners), the zero-Doppler time of the grid line for SAR, the imaging time of the +line for pushbroom imagers, and the time of the measurement for lidar, altimeters, +and profilers. The gate takes the 95th percentile of the absolute differences, in +seconds: up to 3 s at the coverage grade, and up to 1 s at the timing grade, for +uses that need the time of each observation. + +Sample size +----------- + +**Dimensions within 3%** tests the size of samples (footprints) on the ground. +Published footprint dimensions, along and across track at stated scan angles, are +compared with the sample sizes that `compute_sample_sizes` predicts for a satellite +in a circular orbit at the published altitude and inclination, observing at those +scan angles. Each footprint gives two dimensions, and the metric is the share whose +relative error is within 3%. + +**Pixel position, median** tests where samples fall within the swath. At a sample of +scans, the position that the instrument projects for each pixel at the middle of +the scan (`compute_projected_pixel_position`) is compared with the geolocated center +of the same sample in the product. The gate takes the median distance, in km. + Back-Test =========