forked from ESMG/pyroms
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
83 lines (59 loc) · 2.89 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
Welcome to Pyroms!
Pyroms is a collection of tools to help with input and output files
from the Regional Ocean Modeling System (ROMS). It was originally
started by Rob Hetland as a googlecode project, then he morphed it
into octant, also at googlecode. Frederic Castruccio then created a
fork and renamed it back to pyroms. This version is still rather
rough around the edges.
Prerequisites
-------------
Meanwhile, you can prepare by installing Enthought Python
(http://www.enthought.com/) or by this collection of packages:
* Python itself. You will need a version that's at least 2.4 and
less than 3.0.
* numpy. Get a version that's reasonably new, don't count on the
version 1.0.1 that you found already on the system. How do you
tell the version? At the interactive prompt from python, type
"import numpy" then "numpy.__version__".
* scipy.
* matplotlib. This is a plotting package to reproduce the Matlab
plotting, complete with everything you might not like about
Matlab plotting. This also contains the gui tools, but it
depends on an underlying gui package, be that tk, wx, X11, or
qt. If it can't find any of them, it's time to install one.
* basemap from matplotlib. These are the map tools for Python,
complete with etopo2 in the examples directory (user beware).
* netCDF4 from Jeff Whitaker. This sits on top of the hdf5 and
netcdf4 libraries.
* ipython. Fred Castruccio recommends using "ipython --pylab" for
interactive fun. It preloads both numpy and the matplotlib
pylab package.
We may also add pyngl and pynio from NCAR to this list. Or ESMPy.
Or Python 3...
If you want a package manager for these bits, check out Anaconda.
Installing
----------
Pyroms is currently in three different packages, pyroms itself,
pyroms_toolbox, and bathy_smoother. We are in the process of creating
setup.py scripts for each, plus an examples directory.
For now,
cd pyroms_toolbox; python setup.py build --fcompiler=gnu95;
python setup.py install --prefix=xxx;
cd ..
The above may or may not need something along these lines:
setenv LDFLAGS '-L/usr/local/pkg/python/python-2.7.2/lib -shared'
cd bathy_smoother; python setup.py build;
python setup.py install --prefix=xxx;
cd ..
cd pyroms; check the paths in the install script and see if it runs...
If you needed the LDFLAGS above, you'll need to add it to the
install script too, at least for the build of scrip.
For creep.so:
cd pyroms_toolbox/pyroms_toolbox/Grid_HYCOM//makefile; make
Then move creep.so into a directory in your PYTHONPATH.
Running
-------
We have a gridid.txt file that's pointed to by the PYROMS_GRIDID_FILE
environment variable. If you are operating on files containing
sufficient grid information already, you won't need to use this.
An example is provided in the examples directory.