A model of the wind-driven ocean circulation Version 1.0

More documents

Recommendations

Info

1 System requirements To run this ocean model and view its output on your Windows PC requires the following software packages to be installed: • cygwin (http://cygwin.com/) • netCDF (http://www.unidata.ucar.edu/software/netcdf/) • GMT (the ‘Generic Mapping Tools’, http://gmt.soest.hawaii.edu/) • GSview (http://www.cs.wisc.edu/~ghost/gsview/packages) • Ferret (http://ferret.pmel.noaa.gov/Ferret/) 2 How to get started 2.1 How to install the model • Using Windows, download the ZIP-compressed folder gyre.zip from http://www.palmod.uni-bremen.de/~apau/ • Do not open this folder, but save it, e.g. to the folder My Documents (Eigene Dateien) on the desktop of your PC. • Either right-click on the gyre.zip icon and extract all files directly to the folder My Documents, or use any other tool to extract all files from this ZIP-compressed folder. 2.2 Directory structure The gyre directory contains the following subdirectories (in the UNIX/LINUX world the term ‘directory’ is used for ‘folder’): doc gmt input output src tmp work documentation GMT scripts *.gmt for plotting input parameters *.in model output *.dat or *.nc Fortran 90 source code *.f90, if available temporary subdirectory for compiling and plotting executable program and (possibly) compile scripts 2
2.3 How to run the model To ‘run’ (execute) the model, double-click on the start cygwin.bat icon in the work directory. A cygwin window will appear. Type gyre.exe (or ./gyre.exe) on the command line and press return. The model will start, print the current values of the model parameters beta, taur and tau0 to the screen, run for a few seconds, print out the number of iterations n it took to reach an equilibrium solution and finish. 2.4 List of some useful UNIX/LINUX commands ls cd cd .. cp file1 file2 rm file man command pwd gv or ggv g95 or ifort list directory contents change directory to directory change directory one level up copy files and directories remove file(s) or directories format and display the on-line manual pages print name of current/working directory display ps files (may work for eps or pdf files as well) compile Fortran 90 source file 2.5 Some LINUX hints • Use the tab key to complete a command. • Use the up and down keys to scroll through the history of previous coomands. • To put ghostview (gv or ggv) or any editor (e.g. emacs) in the background, add ‘ &’ at the end of the command line. 2.6 How to view the results After running the gyre model, the output directory contains the following files: snapshot.dat in human-readable ASCII format, snapshot.nc in binary netCDF format. Both files contain the equilibrium solution for the wind-driven ocean circulation in terms of a horizontal streamfunction. The contents of the file snapshot.dat can be visualized using, e.g. ‘GMT’ (the ‘Generic Mapping Tools’, http://gmt.soest.hawaii.edu/) - see the GMT script gyre.gmt in the gmt directory. The contents of the file snapshot.nc can be visualized using, e.g. ‘ferret’: 3
Page 1: A model of the wind-driven ocean ci
Page 5 and 6: use snapshot1.nc use snapshot2.nc s

A model of the wind-driven ocean circulation Version 1.0

Create successful ePaper yourself

Delete template?

Save as template?