EarthMesh: A Multi-Scale Unstructured Mesh Generation Tool for Earth System Models
Abstract. Variable-resolution meshes (VRMs) on unstructured grids direct resolution to regions where local processes need finer representation, but producing solver-ready meshes across Earth system model (ESM) components remains difficult. Existing tools typically focus on a single component, leaving users to write post-processing scripts for each solver. Here we present EarthMesh, a workflow for generating triangular and dual-polygonal meshes on the sphere and preparing them for atmospheric, oceanic, and land-surface models. EarthMesh starts with an icosahedral triangular mesh, refines cells using user-defined regions, physical criteria such as land cover types and leaf area index (LAI), or both, and reconstructs conforming transition rows while keeping vertex valence between 5 and 7. A modified spring-dynamics optimization reduces the number of obtuse triangles within transition areas. Model-specific drivers then produce the input files required by MPAS-A, FVCOM, and CoLM2024. In idealized MPAS-A baroclinic-wave and FVCOM geostrophic-eddy tests, the VRMs reproduce the fine-scale structures of uniform high-resolution runs within the refined regions, without spurious signals at the transition zones, while using about 8 % and 44–47 % of the high-resolution cell count, respectively. In a CoLM2024 runoff experiment over the eastern United States, refinement driven by LAI variability and land-cover diversity improves monthly runoff skill over 55 % of the domain (62 % for uniform refinement) with 28 % of the high-resolution cells. These results provide practical guidance on transition width, refinement criteria, and dual-mesh construction for different ESM components.