Contents of /MITgcm/verification/cpl_atm2d+ocn/atm2d_notes

This verifcation run is set up to run on two processers. The atmosphere and 
seaice run in the top directory; the ocean runs in a subdirectory rank_1.
This rank_1 directory must be created - with appropriate input files - prior
to running.

A sample script to execute the mpirun command is run_cpl. 

It is also possible to run the full coupled model on a single processor,
or to distribute the ocean to several nodes, with subdirectories rank_1 
to rank_n, although the atmosphere/seaice cannot be parallelized.
(additional documentation forthcoming)

-----------------------------------------------------------------

To build the atmospheric/seaice code:

The atmospheric code is located at:
http://mitgcm.org/cgi-bin/viewcvs.cgi/MITgcm_contrib/jscott/igsm/

Here, there is a source and include directory, and a makefile which builds
an atmospheric library LIBATM.a

To make the atmice executable, there is a script (which runs a makefile) 
in the verification exp. directory exe_atmice. This script first makes a 
ocean library LIB3DO.a from the build_atmice *.o files. The MITGCM 
options turn off pretty much everything except packages THSICE and ATM2D.

The ocean code should be built in build_ocn, and the mitgcmuv executable 
which results is used directly. There are no special options needed (except
the generic coupling option) in the ocean-only code.

Pickups (to get you started) for the GISS atmosphere are located at:
http://mitgcm.org/cgi-bin/viewcvs.cgi/MITgcm_contrib/jscott/igsm/pickup/
(these are fairly large and thus not included in input_atmice)

Support files for the GISS atmosphere (referenced in name.dat) are
in the tar ball:
http://mitgcm.org/cgi-bin/viewcvs.cgi/MITgcm_contrib/jscott/

This verification experiment was run with CLM off, i.e. using a simple bucket
model included in the GISS atmosphere. Support for using CLM with be 
forthcoming.

name.dat notes: 
---------------
These are output files, and must be not present before running:
    ocndata4atm = 'ocnd4a0001.01'
    plotfl   = 'plot0001.01'
    nwrfl    = 'nwr0001.01'
These are the atmos. pickups, which are continuously overwritten:
    file1    = 'pov10001.01.bin',
    file2    = 'pov20001.01.bin',
These support files are needed (in addition to some others):
    bgrghg_data = '../ATM2D_DATA/INIT/forcing/ghgdata.GISS.2005.dat'
    fprratio  = '../ATM2D_DATA/CLMDATA/pcp2lnd-data.001x046.txt'

There are many other options to the 2D atmosphere; further support forthcoming.

Questions: jscott@mit.edu
1	This verifcation run is set up to run on two processers. The atmosphere and
2	seaice run in the top directory; the ocean runs in a subdirectory rank_1.
3	This rank_1 directory must be created - with appropriate input files - prior
4	to running.
5
6	A sample script to execute the mpirun command is run_cpl.
7
8	It is also possible to run the full coupled model on a single processor,
9	or to distribute the ocean to several nodes, with subdirectories rank_1
10	to rank_n, although the atmosphere/seaice cannot be parallelized.
11	(additional documentation forthcoming)
12
13	-----------------------------------------------------------------
14
15	To build the atmospheric/seaice code:
16
17	The atmospheric code is located at:
18	http://mitgcm.org/cgi-bin/viewcvs.cgi/MITgcm_contrib/jscott/igsm/
19
20	Here, there is a source and include directory, and a makefile which builds
21	an atmospheric library LIBATM.a
22
23	To make the atmice executable, there is a script (which runs a makefile)
24	in the verification exp. directory exe_atmice. This script first makes a
25	ocean library LIB3DO.a from the build_atmice *.o files. The MITGCM
26	options turn off pretty much everything except packages THSICE and ATM2D.
27
28	The ocean code should be built in build_ocn, and the mitgcmuv executable
29	which results is used directly. There are no special options needed (except
30	the generic coupling option) in the ocean-only code.
31
32	Pickups (to get you started) for the GISS atmosphere are located at:
33	http://mitgcm.org/cgi-bin/viewcvs.cgi/MITgcm_contrib/jscott/igsm/pickup/
34	(these are fairly large and thus not included in input_atmice)
35
36	Support files for the GISS atmosphere (referenced in name.dat) are
37	in the tar ball:
38	http://mitgcm.org/cgi-bin/viewcvs.cgi/MITgcm_contrib/jscott/
39
40	This verification experiment was run with CLM off, i.e. using a simple bucket
41	model included in the GISS atmosphere. Support for using CLM with be
42	forthcoming.
43
44	name.dat notes:
45	---------------
46	These are output files, and must be not present before running:
47	ocndata4atm = 'ocnd4a0001.01'
48	plotfl = 'plot0001.01'
49	nwrfl = 'nwr0001.01'
50	These are the atmos. pickups, which are continuously overwritten:
51	file1 = 'pov10001.01.bin',
52	file2 = 'pov20001.01.bin',
53	These support files are needed (in addition to some others):
54	bgrghg_data = '../ATM2D_DATA/INIT/forcing/ghgdata.GISS.2005.dat'
55	fprratio = '../ATM2D_DATA/CLMDATA/pcp2lnd-data.001x046.txt'
56
57	There are many other options to the 2D atmosphere; further support forthcoming.
58
59	Questions: jscott@mit.edu