Return recent lines from a CESM or MOM6 run log.

component: 'cesm', 'ocn' (MOM6), 'atm', 'ice', 'rof', or 'all'. Searches case_dir and case_dir/run/ for log files. Returns the most recent match.

Scan all run logs in a CESM case for error indicators.

Searches for FATAL, ERROR, NaN, CFL violations, negative thickness, OOM, and similar. Returns a structured list of matches with filename, line number, and error type. Call classify_error() on the error text for probable cause and fix suggestions.

Classify a MOM6/CESM error message and return probable cause and fix suggestions.

Pass a snippet of error text (e.g. from find_errors output) and get back a structured diagnosis. Matches against a library of known MOM6 failure modes.

Read MOM_input and MOM_override parameter files for a CESM/MOM6 case.

Returns all parameters as KEY = VALUE pairs. Pass filter to show only parameters containing that substring (e.g. 'DT', 'OBC', 'SPONGE'). MOM_override values take precedence and are marked with [override].

Compare MOM_input parameters between two CESM/MOM6 cases.

Returns parameters that differ, with values from both cases side by side. Useful for diagnosing why two configurations behave differently.

Evaluate CFL stability condition for a MOM6 case.

Reads DT, DT_THERM, and resolution-related parameters from MOM_input. Compares against recommended safe values for the apparent resolution. Returns a stability assessment and flags potential violations.

Note: A full CFL check requires the actual grid file (dx, dy values). This tool uses MOM_input parameters as a proxy for a quick sanity check.

Suggest safe MOM6 timestep values (DT and DT_THERM) for a given grid resolution.

resolution_deg: approximate horizontal resolution in degrees (e.g. 0.1 for 1/10°). Returns recommended values with caveats about bathymetry and tidal forcing.

Read and parse the MOM6 diag_table from a CESM case.

Returns enabled diagnostics grouped by module/component. diag_table is typically in case_dir/run/ or case_dir/Buildconf/momconf/.

Suggest useful MOM6 diagnostics to add to diag_table based on a description of the problem.

symptoms: describe what you're investigating (e.g. 'temperature drift', 'OBC instability', 'CFL violations', 'tidal mixing', 'BGC', 'mixed layer too shallow').

Returns a list of recommended diagnostic fields grouped by relevance.

Search expert interview transcripts for scientific guidance on a question.

The knowledge base contains interviews with regional ocean modelling experts covering topics like: MOM6 configuration, OBC setup, tidal forcing, bathymetry, stability, BGC, grid design, known failure modes, and regional ocean dynamics.

Returns the top matching Q&A pairs from the expert interviews. top_k: number of results to return (default 5, max 10).

Look up expert guidance for a specific MOM6 parameter name.

Searches the interview knowledge base for mentions of the parameter, along with context about what it does, typical values, and pitfalls.

param_name: MOM6 parameter name (e.g. 'DT', 'MINIMUM_DEPTH', 'OBC_SEGMENTS', 'SPONGE', 'TIDES', 'KD_MAX', 'KHTH').