February 2023, NCAR.

User's guide: https://github.com/NCAR/Topo/wiki/User's-Guide

What's new in version 2.0.1:

*Command-line execution (e.g.):

./cube_to_target --grid_descriptor_file ne30pg3.nc  
         --intermediate_cs_name gmted2010_modis_bedmachine-ncube3000-220518.nc 
                 --output_grid ne30pg3 --smoothing_scale 100.0 
         --name_email_of_creator 'Peter Hjort Lauritzen, pel@ucar.edu'

 Note: if you get the error message

  No smoothed topo file specified
  Required argument not specified: 
  grid_descriptor_file

 you are probably using Intel compiler. Please use GNU as outlined in the User's guide.

*New improved source topography data (ice sheet regions)
 See https://github.com/NCAR/Topo/issues/10

*Internal iterative Laplacian smoother with "no leak" option
 See https://github.com/NCAR/Topo/issues/39

*Support for SCRIP and ESMF grid descriptor file formats

*Seamless support for variable resolution grids 
 (sub-grid-scale variables and smoothing seamlessly adapts to resolution changes)

*CESM compliant metadata on netCDF file

Please note important bug fix in tag NCAR_Topo_2_0_1

This software is partially documented in

Peter H. Lauritzen, Julio T. Bacmeister, Patrick Callaghan and Mark A. Taylor, 2015: 
NCAR Global Model Topography Generation Software for Unstructured Grids. 
Geosci. Model Dev., 8, 3975-3986, doi:10.5194/gmd-8-3975-2015

and updated by Julio Bacmeister/Peter Hjort Lauritzen for CESM2.2 support (internal smoothing, ridge finding algorithm, etc.) and variable resolution (Adam Herrington, Rene Wijngaard).

Overview of directories

bin_to_cube:

Bin high resolution elevation data (on regular lat-lon grid) onto cubed-sphere grid. Creates intermediate cubed-sphere data for cube_to_target. This is used to separate scales for SGH and SGH30.

Note: The user does not need bin_to_cube step unless wanting to change source dataset and/or intermediate cubed-sphere resolution.

cube_to_target:

Code to process elevation data and remap to target grid.

List namelist options: Execute ./cube_to_target --help

Software will produce plot.sh which can be used to produce NCL plots of topography data (source plot.sh)

Default interemdiate cubed-sphere data on Cheyenne is located at

/glade/p/cgd/amp/pel/topo/cubedata/gmted2010_modis_bedmachine-ncube3000-220518.nc

Example:

See cubed_to_target/ne30pg3.sh. Execute (on Cheyenne) with:

qcmd -l walltime=04:00:00 -- source ne30pg3.sh

Fast regression tests:

source regr_test1.sh     -fast version of ne30pg3.sh but using ncube=540 
                  intermediate cubed-sphere grid data
source regr_test2.sh     -low resolution variable resolution test using ncube=540 
                  intermediate cubed-sphere grid data
source regr_test2_lap.sh -same as regr_test2.sh but using Laplacian smoother
source regr_test3.sh      low resolution test for lat-lon grid using ncube=540 
                  intermediate cubed-sphere grid data

regression-test-data:

Data used for regression tests in cubed_to_target. See above.

make_rll_grid_descriptor_file:

Code to make SCRIP grid descriptor files for regular latitude-longitude grids