CRTM v3.2.0 release: integrate feature/btj_REL-3.2.0

.gitignore

@@ -1,12 +1,28 @@
 .DS_Store
 *.o
+*.mod
 *.tgz
 .ipynb*
 build
-fix/
+build*/
 **/Build/
+Testing/
+fix/
+__pycache__/
+*.pyc
 build.bash
 rebuild.bash
-.gitignore
 *~
 conductor/
+test-data-release/
+.claude/
+test/testinput/*.nc
+
+# Analysis artifacts. Working scripts, plots, coefficient tooling and session
+# notes live outside the git tree, under /home/ben/CRTM/release_wrap_*/ or
+# equivalent. Findings belong in a commit message or a docs/design note, not
+# in the repository as files.
+tools/
+*.png
+*.patch
+HANDOFF_*.md

CLAUDE.md

@@ -0,0 +1,92 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+CRTM (Community Radiative Transfer Model) v3.2.0 is a Fortran radiative transfer model for satellite data assimilation. It computes top-of-atmosphere radiances and brightness temperatures from atmospheric/surface states, and provides Jacobians (sensitivities) for data assimilation systems.
+
+## Build Commands
+
+```bash
+mkdir build && cd build
+cmake ..
+make -j8           # Adjust -j to your CPU count
+ctest -j8          # Run all tests in parallel
+```
+
+**CMake options:**
+- `-DCMAKE_BUILD_TYPE=DEBUG|RELEASE|RELWITHDEBINFO` (default: RELEASE)
+- `-DBUILD_SHARED_LIBS=ON|OFF` (default: ON, creates libcrtm.so)
+- `-DFIX_FILE_PATH=<path>` - Path to coefficient files (auto-downloads if not found)
+- `-DBUILD_TESTING=ON|OFF` (default: ON)
+- `-DOPENMP=ON|OFF` (default: ON)
+
+**Build outputs:**
+- Library: `build/lib/libcrtm.so` or `libcrtm.a`
+- Modules: `build/module/crtm/<compiler>/<version>/`
+- Test data: `build/test_data/` (downloaded automatically)
+
+## Running Tests
+
+```bash
+cd build
+ctest -j4                      # Run all tests in parallel
+ctest -VV -R <testname>        # Run specific test with verbose output
+ctest --output-on-failure      # Show output only for failed tests
+```
+
+Test exit codes: `STOP 0` = success, `STOP 1` = failure.
+
+## Code Architecture
+
+### Core Modules (src/)
+
+The four main CRTM entry points in order of complexity:
+1. **CRTM_Forward_Module** - Forward radiative transfer (atmosphere/surface → radiances)
+2. **CRTM_Tangent_Linear_Module** - Linearized forward model
+3. **CRTM_K_Matrix_Module** - Jacobian/sensitivity matrix calculations
+4. **CRTM_Adjoint_Module** - Adjoint (reverse mode) computations
+
+**CRTM_LifeCycle** handles initialization and finalization.
+
+### Component Libraries
+
+| Directory | Purpose |
+|-----------|---------|
+| Atmosphere/ | Atmospheric profiles (pressure, temperature, gases, clouds, aerosols) |
+| AtmAbsorption/ | Gas absorption (ODAS, ODPS, ODZeeman algorithms) |
+| AtmOptics/ | Atmospheric optical properties |
+| AtmScatter/ | Cloud, aerosol, and molecular scattering |
+| SfcOptics/ | Surface emissivity/reflectivity (MW_Land, MW_Water, IR_*, VIS_*) |
+| Surface/ | Surface type characterization |
+| Coefficients/ | Coefficient I/O (SpcCoeff, TauCoeff, CloudCoeff, AerosolCoeff, EmisCoeff) |
+| RTSolution/ | Radiative transfer solution structures |
+
+### File Naming Conventions
+
+- `*_Define.f90` - Derived type definitions
+- `*_TL.f90` - Tangent-linear routines
+- `*_AD.f90` - Adjoint routines
+- `*_Binary_IO.f90` / `*_netCDF_IO.f90` - Coefficient I/O
+
+### Test Structure (test/mains/)
+
+- **application/** - Large end-to-end tests (check_crtm.F90)
+- **regression/** - Functionality tests organized by mode:
+  - forward/, k_matrix/, adjoint/, tangent_linear/
+- **unit/** - Small-scope component tests
+
+## Requirements
+
+- Fortran 2008 compiler (GCC 5+, Intel 18+, Cray, NVHPC)
+- netCDF4/HDF5 (built with same Fortran compiler)
+- CMake 3.20+
+- git-lfs 2.10+
+
+## Key Technical Notes
+
+- Coefficient files support both legacy binary (.bin) and netCDF (.nc4) formats
+- OpenMP parallelization is enabled by default
+- Most modules have parallel TL/AD implementations for sensitivity calculations
+- Transmittance coefficient generation codes (TauProd/, TauRegress/) are not functional

CMakeLists.txt

@@ -1,13 +1,30 @@
 cmake_minimum_required(VERSION 3.20)
 
-project(crtm VERSION 3.1.4 LANGUAGES Fortran)
+project(crtm VERSION 3.2.0 LANGUAGES Fortran)
 
 option(OPENMP "Build crtm with OpenMP support" ON)
 option(FIX_FILE_PATH "Path to fix files (default: fix/)" OFF)
+# Long-running tests are registered only when this is ON, and carry the ctest
+# label "tier2" so they can also be selected with `ctest -L tier2` or excluded
+# with `ctest -LE tier2`. Their executables are always built, so compiler
+# coverage of those sources is never lost; only the ctest registration is gated.
+# Toggling this is therefore a reconfigure with no recompilation.
+option(BUILD_TIER2_TESTS "Register long-running (tier2) tests" OFF)
 
 list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake)
 set(CMAKE_DIRECTORY_LABELS ${PROJECT_NAME})
 
+# In-build binaries must always run the in-build libcrtm. With the linker's
+# default RUNPATH dtags, LD_LIBRARY_PATH takes precedence at load time, and a
+# spack environment carrying its own crtm package silently substitutes its
+# library: the test suite then executes a different CRTM release against this
+# build's module interfaces (observed as 230/235 failures with garbage
+# optional arguments when spack's crtm-3.1.2 shadowed an ifx build). Classic
+# RPATH outranks LD_LIBRARY_PATH, so force it.
+if(UNIX AND NOT APPLE)
+  add_link_options(LINKER:--disable-new-dtags)
+endif()
+
 # Include GNUInstallDirs to get the standard installation directory variables
 include(GNUInstallDirs)
 
@@ -58,20 +75,18 @@ include(GNUInstallDirs)
 
 ## Dependencies (unchanged from original)
 if(OPENMP)
-  find_package(OpenMP COMPONENTS Fortran)
-
-	# Check if OMP_NUM_THREADS is set in the environment
-	if(DEFINED ENV{OMP_NUM_THREADS})
-		set(OMP_NUM_THREADS $ENV{OMP_NUM_THREADS})
-	else()
-		# Set a default value if not set
-		set(OMP_NUM_THREADS "1")
-	endif()
-
-	# Export OMP_NUM_THREADS to the environment
-	set(ENV{OMP_NUM_THREADS} ${OMP_NUM_THREADS})
+  # REQUIRED: src/CMakeLists.txt links OpenMP::OpenMP_Fortran unconditionally
+  # when OPENMP=ON; without REQUIRED a missing OpenMP fails later at generate
+  # time with a cryptic "target not found" error.
+  find_package(OpenMP REQUIRED COMPONENTS Fortran)
 endif()
 
+# Enable portable Fortran source preprocessing across all supported compilers
+# (gfortran, ifort, ifx, flang, Cray, NVHPC, XL). This is the cross-compiler
+# replacement for hardcoded -cpp/-fpp flags and lets sources use #ifdef _OPENMP
+# guards regardless of file extension.
+set(CMAKE_Fortran_PREPROCESS ON)
+
 if(DEFINED ENV{NETCDF_PATH})
   list(APPEND CMAKE_PREFIX_PATH $ENV{NETCDF_PATH})
 elseif(DEFINED ENV{NETCDF})
@@ -107,12 +122,12 @@ write_basic_package_version_file(
 install(FILES 
               "${CMAKE_CURRENT_BINARY_DIR}/crtm-config.cmake"
               "${CMAKE_CURRENT_BINARY_DIR}/crtm-config-version.cmake"
-        DESTINATION ${CRTM_INSTALL_PREFIX}/cmake/${PROJECT_NAME})
+        DESTINATION ${CRTM_INSTALL_PREFIX}/lib/cmake/${PROJECT_NAME})
 
 # Install the export set for use with the install-tree (unchanged, with modified destination)
 install(EXPORT ${PROJECT_NAME}-config
 	FILE "${PROJECT_NAME}-targets.cmake"
-	DESTINATION ${CRTM_INSTALL_PREFIX}/cmake/${PROJECT_NAME})
+	DESTINATION ${CRTM_INSTALL_PREFIX}/lib/cmake/${PROJECT_NAME})
 
 # For build-tree linkage (unchanged from original)
 export(EXPORT ${PROJECT_NAME}-config