Annotation of /MITgcm_contrib/gael/comm/course-idma2016/guidelines/iap-idma-instructions


---- downloading matlab toolboxes ----

1) create a directory called `iap-idma' and two subdirectories
   called `iap-idma/matlab' and `iap-idma/release1'

2) open a web browser and download the following two files:
     ftp://mit.ecco-group.org/ecco_for_las/version_4/checkpoints/gcmfaces_20160114.tar.gz
     ftp://mit.ecco-group.org/ecco_for_las/version_4/checkpoints/c65r_MITprof.tar.gz

3) move these two files to the idma directory and uncompress them.

4) the iap-idma directory should now contain two subdirectories
   named `gcmfaces' and `c65r_MITprof'. Rename c65r_MITprof as `MITprof'.

notes : 
- disk space requirement ~ 800M (plus session specific items that will be added later)
- 2011 or later matlab version is needed (for native netcdf implementation)
- for session 1 you only need MITprof but gcmfaces will come 
  handy later so your might as well download both right away

---- for session #1 ----

1) see 'downloading matlab toolboxes'

2) download idma_float_plot.m, idma_box_subset.m, and idma_box_mean.m from 
     http://mitgcm.org/viewvc/MITgcm/MITgcm_contrib/gael/comm/course-idma2016/matlab/

3) move these files to the iap-idma/matlab directory   

4) using you favorite ftp client (e.g. fetch in iOS, secureFX in MS-windows, 
   or wget in LINUX) to download the following directory:
      ftp://mit.ecco-group.org/ecco_for_las/version_4/release1/MITprof_release1
   
5) move MITprof_release1 to the iap-idma/release1 directory

6) start matlab, go to the iap-idma directory, and type:
   addpath matlab/
   [p]=idma_float_plot('4900828');
   box_l=[-180 -140]; box_L=[-10 10]-30; box_D=[0 300];
   [prof_T,prof_Testim,prof_Tweight]=idma_box_subset(box_l,box_L,box_D);
   [boxmean,tim,dep]=idma_box_mean(prof_T,prof_Tweight);
   figureL; pcolor(tim,-dep,boxmean); colorbar;

notes :
- disk space requirement ~ 6.4G
- idma_float_plot.m and idma_box_subset.m both add the 
  iap-idma/MITprof/ and its subdirectories to the matlab path
- idma_box_subset is the most time consuming of the three
  scripts and may take ~3 minutes

----- for session #2 -----

1) see 'downloading matlab toolboxes'
   note: make sure to use gcmfaces_20160114.tar.gz or the up to date version of
         gcmfaces from CVS (rather than c65r_MITprof.tar.gz or earlier versions).
2) download the m_map plotting toolbox (use the 'zip archive' link) from 
      https://www.eoas.ubc.ca/~rich/map.html 
   unzip and move it to iap-idma/
2) using you favorite ftp client (e.g. fetch in iOS, secureFX in MS-windows,
   or wget in LINUX) to download the following directory (145M):
      ftp://mit.ecco-group.org/ecco_for_las/version_4/release1/nctiles_grid
   and move it to iap-idma/
3) using you favorite ftp client (e.g. fetch in iOS, secureFX in MS-windows,
   or wget in LINUX) to download the following directory (14G):
      ftp://mit.ecco-group.org/ecco_for_las/version_4/release1/nctiles_climatology
   and move it to iap-idma/release1/
4) start matlab, go to the iap-idma directory, and type:
      p = genpath([pwd filesep 'gcmfaces/']); addpath(p);
      p = genpath([pwd filesep 'MITprof/']); addpath(p);
      p = genpath([pwd filesep 'm_map/']); addpath(p); 
      grid_load;%load ECCO v4 grid into mygrid
      gcmfaces_global;%declare mygrid as global
      disp(mygrid);%displays grid variables
      diags=example_transports;%computes transports (takes ~ 2 minutes)
      example_transports_disp(diags);%display results 
   then proceed as explained in section 5 of gcmfaces/gcmfaces.pdf
   to use diags_driver.m and diags_display.m (takes ~ 5 minutes)
1	gforget	1.1
2			---- downloading matlab toolboxes ----
3
4	gforget	1.3	1) create a directory called `iap-idma' and two subdirectories
5			called `iap-idma/matlab' and `iap-idma/release1'
6	gforget	1.1
7	gforget	1.2	2) open a web browser and download the following two files:
8	gforget	1.6	ftp://mit.ecco-group.org/ecco_for_las/version_4/checkpoints/gcmfaces_20160114.tar.gz
9			ftp://mit.ecco-group.org/ecco_for_las/version_4/checkpoints/c65r_MITprof.tar.gz
10	gforget	1.1
11	gforget	1.2	3) move these two files to the idma directory and uncompress them.
12	gforget	1.1
13	gforget	1.3	4) the iap-idma directory should now contain two subdirectories
14	gforget	1.6	named `gcmfaces' and `c65r_MITprof'. Rename c65r_MITprof as `MITprof'.
15	gforget	1.1
16			notes :
17	gforget	1.2	- disk space requirement ~ 800M (plus session specific items that will be added later)
18			- 2011 or later matlab version is needed (for native netcdf implementation)
19			- for session 1 you only need MITprof but gcmfaces will come
20			handy later so your might as well download both right away
21	gforget	1.1
22			---- for session #1 ----
23
24	gforget	1.2	1) see 'downloading matlab toolboxes'
25	gforget	1.1
26	gforget	1.2	2) download idma_float_plot.m, idma_box_subset.m, and idma_box_mean.m from
27			http://mitgcm.org/viewvc/MITgcm/MITgcm_contrib/gael/comm/course-idma2016/matlab/
28	gforget	1.1
29	gforget	1.2	3) move these files to the iap-idma/matlab directory
30	gforget	1.1
31	gforget	1.2	4) using you favorite ftp client (e.g. fetch in iOS, secureFX in MS-windows,
32			or wget in LINUX) to download the following directory:
33			ftp://mit.ecco-group.org/ecco_for_las/version_4/release1/MITprof_release1
34
35	gforget	1.3	5) move MITprof_release1 to the iap-idma/release1 directory
36	gforget	1.1
37	gforget	1.2	6) start matlab, go to the iap-idma directory, and type:
38	gforget	1.1	addpath matlab/
39	gforget	1.2	[p]=idma_float_plot('4900828');
40	gforget	1.5	box_l=[-180 -140]; box_L=[-10 10]-30; box_D=[0 300];
41			[prof_T,prof_Testim,prof_Tweight]=idma_box_subset(box_l,box_L,box_D);
42			[boxmean,tim,dep]=idma_box_mean(prof_T,prof_Tweight);
43			figureL; pcolor(tim,-dep,boxmean); colorbar;
44	gforget	1.1
45			notes :
46	gforget	1.4	- disk space requirement ~ 6.4G
47	gforget	1.2	- idma_float_plot.m and idma_box_subset.m both add the
48			iap-idma/MITprof/ and its subdirectories to the matlab path
49	gforget	1.4	- idma_box_subset is the most time consuming of the three
50			scripts and may take ~3 minutes
51	gforget	1.1
52	gforget	1.6	----- for session #2 -----
53
54			1) see 'downloading matlab toolboxes'
55			note: make sure to use gcmfaces_20160114.tar.gz or the up to date version of
56			gcmfaces from CVS (rather than c65r_MITprof.tar.gz or earlier versions).
57			2) download the m_map plotting toolbox (use the 'zip archive' link) from
58			https://www.eoas.ubc.ca/~rich/map.html
59			unzip and move it to iap-idma/
60			2) using you favorite ftp client (e.g. fetch in iOS, secureFX in MS-windows,
61			or wget in LINUX) to download the following directory (145M):
62			ftp://mit.ecco-group.org/ecco_for_las/version_4/release1/nctiles_grid
63			and move it to iap-idma/
64			3) using you favorite ftp client (e.g. fetch in iOS, secureFX in MS-windows,
65			or wget in LINUX) to download the following directory (14G):
66			ftp://mit.ecco-group.org/ecco_for_las/version_4/release1/nctiles_climatology
67			and move it to iap-idma/release1/
68			4) start matlab, go to the iap-idma directory, and type:
69			p = genpath([pwd filesep 'gcmfaces/']); addpath(p);
70			p = genpath([pwd filesep 'MITprof/']); addpath(p);
71			p = genpath([pwd filesep 'm_map/']); addpath(p);
72			grid_load;%load ECCO v4 grid into mygrid
73			gcmfaces_global;%declare mygrid as global
74			disp(mygrid);%displays grid variables
75			diags=example_transports;%computes transports (takes ~ 2 minutes)
76			example_transports_disp(diags);%display results
77			then proceed as explained in section 5 of gcmfaces/gcmfaces.pdf
78			to use diags_driver.m and diags_display.m (takes ~ 5 minutes)