Updated: 7-14-04 (T.E.)
--------------------------------------
Latest code: POM2K
--------------------------------------
Greetings and welcome to the Princeton Ocean Model users group. 

This group has been established in order to advance the science/art of
numerical modelling as well as to foster communication among those using the
Princeton model. It is hoped that the resource materials described below as
well as others to be developed in the future will allow users to easily find
answers to frequently asked questions. Communication with your fellow users
should help to minimize duplication of effort and enhance opportunities for
productive collaboration.

######################  WEB ACCESS  ######################################

The URL address is:  http://www.aos.princeton.edu/WWWPUBLIC/htdocs.pom

To download files from the web: click on "Information for users"
then "Go to FTP site", click on file and use your browser "File-Save as".
On some computers you may point at file and use right mouse to select
"Save link as".
 
#########################  FTP ACCESS  ###################################

> ftp ftp.aos.princeton.edu
> username = anonymous
> password = your email
> cd pub/pom
> ls                     (to list the available files)
> get fname              (get files)
> quit


See the README file for list of codes available, see also contrib-code
for additional codes provided by users, and GRID-DATA for example codes
for generating curvilinear grid and initial conditions from data. 

#########################  MODEL VERSIONS ##############################

----- POM2K directory

Since 2002 users may consider using this code instead of pom98.f, 
in particular if they want to use netcdf format for analysis.
This version (by John Hunter, Univ. of Tasmania) is a cleaner (but longer)
code with considerable more in-code comments. Main addition is a NETCDF 
output (a MATLAB-netcdf plotting package is also included in this directory).
User's guide for this particular code is not available yet.

The original version of this code named "OzPOM" can be obtained also from:
 http://www.antcrc.utas.edu.au/~johunter/ozpom.html

----- POMgcs directory

Note: in 2004 we plan to release a cleaner version of this code (POM04).
General Coordinate version of pom which can use sigma or z-level. 
User's guide or support for this particular code is not available, but
this model is described in the paper: 

Mellor, G. L., S. Hakkinen, T. Ezer and R. Patchen, A generalization of
a sigma coordinate ocean model and an intercomparison of model vertical
grids, In: Ocean Forecasting: Conceptual Basis and Applications, N. Pinardi
and J. D. Woods (Eds.), Springer, 55-72, 2001.

Ezer & Mellor (2004) and Ezer (2004) papers published in Ocean Modelling
described further applications of the generalized model.  

----- POMmpi directory

MPI and HPF parallel versions of pom contributed by S. Piacsek (NRL). 
Version not supported by Princeton.

----- POMnb directory

A non-Boussinesq version of pom. Version not supported, but described by: 

Mellor, G. L. and T. Ezer, Sea level variations induced by heating and
cooling: An evaluation of the Boussinesq approximation in ocean models,
J. Geophys. Res., 100(C10), 20,565-20,577, 1995.

----- POMold directory

Older versions of the code (pmod.f, pom.f) and it's change log
(pmod.changes) are available for the convenience of long-time users.

 
###########  COMMUNICATION WITH OTHER USERS  ############################

Users can send emails to the entire users group (see link in main web page).
However, please check the FAQ, User's Guide and other sources before posting 
questions to the entire community. This service is aimed for questions
and announcements of general interest.

Users are also encouraged to contribute specialized codes for use within 
the model as well as for post-run analysis so we can avoid "reinventing 
the wheel". Please contact Tal Ezer (ezer@splash.princeton.edu) if you want 
to contribute a code which will be added to contrib-code directory.
Use of such codes comes with the understanding that anyone who subsequently 
copies and uses that code does so at his/her own risk and will properly 
acknowledge the contributor.
 
###########  HOW DO I START USING POM? ##################################

The codes provided here can run as is using fortran compilers such as 
f77, f90, g77, pgf77 etc. The pom2k code is set for two simple examples:
1. a channel flow over a seamount where all parameters are defined inside
the code and 2. a coastal case where ICs are read from a file. The latters 
example input file is generated by GRID-DATA/GRID.f. For particular 
applications one needs to set the model grid (Cartesian or curvilinear),
collect/specify his/her own data for bottom topography, temperature & 
salinity, surface wind and heat fluxes etc. and interpolate the data into
the model grid to create an initial condition and forcing files that will
be read by the model. The codes in GRID-DATA are useful tools to help
do such interpolations and generate an IC file. Remember that when a 
curvilinear or tilted grid is used, wind stress and model velocity vectors 
are not in the x-y directions and should be transformed accordingly. 
 

    Enjoy !!!!