Add a tool for smoothing ocean topo before init

ocean/smooth_topo/CMakeLists.txt

@@ -11,7 +11,11 @@ message (STATUS "NETCDF_INCLUDES=${NETCDF_INCLUDES}")
 message (STATUS "NETCDF_LIBRARIES=${NETCDF_LIBRARIES}")
 
 include_directories(${NETCDF_INCLUDES})
+
 add_executable (ocean_smooth_topo_skip_land_ice smooth_topo_skip_land_ice.F90)
 target_link_libraries (ocean_smooth_topo_skip_land_ice ${NETCDF_LIBRARIES})
 
-install (TARGETS ocean_smooth_topo_skip_land_ice DESTINATION bin)
+add_executable (ocean_smooth_topo_before_init smooth_topo_before_init.F90)
+target_link_libraries (ocean_smooth_topo_before_init ${NETCDF_LIBRARIES})
+
+install (TARGETS ocean_smooth_topo_skip_land_ice ocean_smooth_topo_before_init DESTINATION bin)

ocean/smooth_topo/README

@@ -1,10 +1,18 @@
 Authors: Adrian Turner, Mat Maltrud
 
-A tool for smoothing bathymetry in an MPAS-Ocean initial condition with a
-Gaussian filter with a characteristic length scale (stdDeviation) and cut-off
-distance (distanceLimit). The smoothing is only applied if the original
-maxLevelCell is larger than a given threshold (minLevelForSmoothing). Smoothing
-is applied over a given number of iterations (numSmoothingPasses).
+Tools for smoothing bathymetry in an MPAS-Ocean with a Gaussian filter with a
+characteristic length scale (stdDeviation) and cut-off distance
+(distanceLimit). Smoothing is applied over a given number of iterations
+(numSmoothingPasses). The tools do not currently work on meshes without
+ice-shelf cavities.
+
+The smooth_topo_skip_land_ice tool can be applied to topography after an
+initial condition has been created.  The smoothing is only applied if the
+original maxLevelCell is deeper than a given threshold (minLevelForSmoothing)
+and ice-shelf cavities are ignored.
+
+The smooth_topo_before_init tool is used to smooth topography data on the MPAS
+mesh before an initial condition has been created.
 
 An example namelist file (smooth_depth_in) is:
 
@@ -17,3 +25,6 @@ An example namelist file (smooth_depth_in) is:
     numSmoothingPasses = 1
     minLevelForSmoothing = 5
 /
+
+The minLevelForSmoothing namelist option only applies to
+smooth_topo_skip_land_ice.