HOPS Topography Conditioning Package: HOST: maelstrom.harvard.edu (128.103.2.50) TAR FILES: pub/HOPS/Cond_Topo/cond_topo_3.5.tar.Z (48648:179712 bytes) pub/HOPS/Cond_Topo/cond_topo.ps.gz (71007:188461 bytes) pub/HOPS/Cond_Topo/color_plate.ps.gz (162004:736342 bytes) pub/HOPS/Cond_Topo/Ex_cond_topo_3.5.tar.gz (386641:1577984bytes) VERSION: 3.5 (August 14, 2001) ORIGIN: Harvard University, Cambridge Massachusetts Harvard Ocean Prediction System (HOPS) DEVELOPERS: Patrick J. Haley (haley@pacific.harvard.edu) Carlos J. Lozano (lozano@pacific.harvard.edu) LIBRARIES: (1) NetCDF, version 2.3.2 University Corporation for Atmospheric Research/UNIDATA http://www.unidata.ucar.edu/ (2) MATLAB, version 4 or higher MathWorks http://www.mathworks.com/ (3) NetCDF Toolbox, pick for compatibility with MATLAB Charles Denham http://crusty.er.usgs.gov/~cdenham ============ INTRODUCTION ============ This directory contains HOPS's topography conditioning package. This package sets is a series of MATLAB executable scripts designed to reduce the slope of the topography for use in the HOPS Primitive Equation model. These scripts are designed to only modify the topography in areas where the slope exceeds a user-specified value according to a user specified measure. For more details, refer to included User's guide. ============ Installation ============ This package is available over the INTERNET via anonymous FTP from maelstrom.harvard.edu (128.103.2.50). When connected, you will be in the FTP directory. To obtain this package, go to the directory "pub/HOPS/Cond_Topo" and get files: Readme.cond_topo This file. cond_topo_3.5.tar.Z Compressed tar file of the Cond_Topo package. cond_topo.ps.gz Compressed User's guide postscript file. color_plate.ps.gz Compressed color plate for the above. Ex_cond_topo_3.5.tar.gz Compressed tar file of the example. To install this package, simply go to the directory in which you want to put the Cond_Topo package and execute the following commands: zcat cond_topo_3.5.tar.Z | tar -pxvf - gzip -dc Ex_cond_topo_3.5.tar.gz | tar -pxvf - The tar file cond_topo_3.5.tar.Z contains the following files: cond_init.m cond_topo.m cond_write.m cond_loop.m cond_read.m date_stamp.m day_code.m extrem.m get_dim.m get_var.m get_var1.m gradt2u.m gridsread.m med_filt2D.m med_filt2Dd.m nestread.m new_topo.m nice.m num_read.m plot_curr_fac.m plot_topo.m plot_topo_diff.m plot_topo_new.m put_var.m put_var1.m redefcdf.m slopebound.m slopefac.m slopetest.m condition.in Contents.m UPDATES ================= Input Script File ================= There are several parameters that the User needs to determine and specify before running the scripts. These parameters are read from an input file supplied by the user. A sample of the input parameter data is provided in the file "condition.in". See the User's guide "cond_topo.ps" for more details. ========= Executing ========= First, a word of warning. If a domain need both a land mask and topographic conditioning, do the land masking first. The land mask is NOT needed by the conditioning scripts, but the netCDF file is better behaved if the land mask structures are already defined before the conditioning adds its structures. There are three basic scripts the user needs to use to run cond_topo: cond_init Prompts user for input file. Initializes work space. cond_topo Conditions the topography. cond_write Writes the results to the GRIDS topography file. The work is broken up like this to allow the user to examine the intermediate stages. For this purpose, four simple plotting scripts are included: plot_topo Plots the initial topography. plot_topo_new Plots the final topography. plot_topo_diff Plots the absolute difference between initial and final topographies plot_curr_fac Plots the current value of the slope factor. See the User's guide "cond_topo.ps" for more details. ======== Examples ======== ----------------- Massachusetts Bay ----------------- The tar file "Ex_cond_topo_3.5.tar.gz" contains an example which illustrates how the Cond_Topo package is used. The Example is in Massachusetts Bay. This is the example which was used for the figures in the User's guide. This example starts where the PE_mask example left off. The user should copy the file "grids_massbay.nc.orig" to the file "grids_massbay.nc". The user then starts up a Matlab session. Once in the session, the user proceeds as was recorded in cond_topo.log. First the cond_init script is run, with cond_dhoh_01.in being given as the input file name at the prompt. The user should then manually reset the slope bound (bound) to 2 and plot the current slope factor. The script cond_topo is then run to condition the topography. The results should be examined and if determined acceptable, the script cond_write is run to save the results to the GRIDS netCDF file. This example includes the following files: cond_dhoh_01.in Input file. cond_topo.log Echo of the run (plotting steps not shown). grids_massbay.nc.cond GRIDS netCDF file containing conditioned topography. grids_massbay.nc.orig GRIDS netCDF file containing original topography.