1 | = Get SAXO = |
---|
2 | [[PageOutline]] |
---|
3 | |
---|
4 | |
---|
5 | |
---|
6 | |
---|
7 | |
---|
8 | |
---|
9 | == Create SAXO environment == |
---|
10 | |
---|
11 | To simplify the explanation, we suppose that we install SAXO in your {{{${HOME}}}}. |
---|
12 | We need to create 2 directories: |
---|
13 | |
---|
14 | * {{{${HOME}/SAXO_DIR}}} that will contain the source files of SAXO. It should not be modified by the user to simplify later updates. |
---|
15 | |
---|
16 | * {{{${HOME}/My_IDL}}} that will contain user personal files (including modified SAXO files, if needed). |
---|
17 | {{{ |
---|
18 | #!html |
---|
19 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
20 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}</code></em></code></strong> |
---|
21 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">mkdir</strong></span> <em class="parameter"><code>My_IDL</code></em></code></strong> |
---|
22 | </pre> |
---|
23 | }}} |
---|
24 | |
---|
25 | == Get SAXO files == |
---|
26 | |
---|
27 | === If you work at IDRIS, IPSL or LOCEAN === |
---|
28 | SAXO is already installed at |
---|
29 | |
---|
30 | * IDRIS, on {{{rhodes}}}: {{{/home/rech/eee/reee217/SAXO_DIR}}} |
---|
31 | * IPSL: {{{/home/smlod/SAXO_DIR}}} |
---|
32 | * LOCEAN: {{{/usr/home/smasson/SAXO_DIR}}} |
---|
33 | If you can access one of theses directories, there is no need to re-install SAXO again! In that case, you only have to link {{{${HOME}/SAXO_DIR}}} to the appropriate directory: |
---|
34 | |
---|
35 | '''IDRIS'''{{{ |
---|
36 | #!html |
---|
37 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
38 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">ln</strong></span> <code class="option">-s</code> <em class="parameter"><code>/home/rech/eee/reee217/SAXO_DIR</code></em> <em class="parameter"><code>${HOME}/SAXO_DIR</code></em></code></strong> |
---|
39 | </pre> |
---|
40 | }}} |
---|
41 | |
---|
42 | '''IPSL'''{{{ |
---|
43 | #!html |
---|
44 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
45 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">ln</strong></span> <code class="option">-s</code> <em class="parameter"><code>/home/smlod/SAXO_DIR</code></em> <em class="parameter"><code>${HOME}/SAXO_DIR</code></em></code></strong> |
---|
46 | </pre> |
---|
47 | }}} |
---|
48 | |
---|
49 | '''LOCEAN'''{{{ |
---|
50 | #!html |
---|
51 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
52 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">ln</strong></span> <code class="option">-s</code> <em class="parameter"><code>/usr/home/smasson/SAXO_DIR</code></em> <em class="parameter"><code>${HOME}/SAXO_DIR</code></em></code></strong> |
---|
53 | </pre> |
---|
54 | }}} |
---|
55 | |
---|
56 | |
---|
57 | === If Subversion (svn) is installed on your machine === |
---|
58 | |
---|
59 | ==== Regular users ==== |
---|
60 | |
---|
61 | The ''complete'' latest revision (source + tests data files: 772 Mb) can be checked out with the following command executed in your ${HOME}: |
---|
62 | {{{ |
---|
63 | #!html |
---|
64 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
65 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">checkout</code> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/</code></em> <em class="parameter"><code>SAXO_DIR</code></em></code></strong> |
---|
66 | </pre> |
---|
67 | }}} |
---|
68 | |
---|
69 | The latest revision of the ''source files'' (44 Mb) can be checked out with the following command: |
---|
70 | {{{ |
---|
71 | #!html |
---|
72 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
73 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">checkout</code> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/SRC</code></em> <em class="parameter"><code>SAXO_DIR/SRC</code></em></code></strong> |
---|
74 | </pre> |
---|
75 | }}} |
---|
76 | |
---|
77 | The latest revision of the ''NetCDF data files'' (728 Mb) used by the test programs can be checked out with the following command: |
---|
78 | {{{ |
---|
79 | #!html |
---|
80 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
81 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">checkout</code> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA</code></em> <em class="parameter"><code>SAXO_DIR/DATA</code></em></code></strong> |
---|
82 | </pre> |
---|
83 | }}} |
---|
84 | |
---|
85 | ==== Contributors ==== |
---|
86 | ''Contributors'' should better use the following command (and replace login by their own login): |
---|
87 | {{{ |
---|
88 | #!html |
---|
89 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
90 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">checkout</code> <em class="parameter"><code>svn+ssh://<code class="replaceable">login</code>@forge.ipsl.jussieu.fr/ipsl/forge/projets/saxo/svn/trunk/</code></em> <em class="parameter"><code>SAXO_DIR</code></em></code></strong> |
---|
91 | </pre> |
---|
92 | }}} |
---|
93 | |
---|
94 | === Get SAXO from a tar file === |
---|
95 | |
---|
96 | ==== Get SAXO source files (5.8M Mb) ==== |
---|
97 | |
---|
98 | Create your {{{${HOME}/SAXO_DIR}}} directory ⊠|
---|
99 | {{{ |
---|
100 | #!html |
---|
101 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
102 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}</code></em></code></strong> |
---|
103 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">mkdir</strong></span> <em class="parameter"><code>SAXO_DIR</code></em></code></strong> |
---|
104 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>SAXO_DIR</code></em></code></strong> |
---|
105 | </pre> |
---|
106 | }}} |
---|
107 | |
---|
108 | ⊠and download it the latest version of the sources tar file: [http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20080321r339.tar.gz SAXO_SRC_20080321r339.tar.gz] (5.8M Mb). |
---|
109 | |
---|
110 | This tar.gz file could also be downloaded with {{{wget}}} or {{{curl}}} |
---|
111 | '''wget'''{{{ |
---|
112 | #!html |
---|
113 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
114 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">wget</strong></span> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20080321r339.tar.gz</code></em></code></strong> |
---|
115 | </pre> |
---|
116 | }}} |
---|
117 | |
---|
118 | '''curl'''{{{ |
---|
119 | #!html |
---|
120 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
121 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">curl</strong></span> <code class="option">-O</code> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20080321r339.tar.gz</code></em></code></strong> |
---|
122 | </pre> |
---|
123 | }}} |
---|
124 | |
---|
125 | |
---|
126 | Untar the file |
---|
127 | {{{ |
---|
128 | #!html |
---|
129 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
130 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}/SAXO_DIR</code></em></code></strong> |
---|
131 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">tar</strong></span> <code class="option">xvfz</code> <em class="parameter"><code>SAXO_SRC_20080321r339.tar.gz</code></em></code></strong> |
---|
132 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">rm</strong></span> <em class="parameter"><code>SAXO_SRC_20080321r339.tar.gz</code></em></code></strong> |
---|
133 | </pre> |
---|
134 | }}} |
---|
135 | |
---|
136 | ==== Get SAXO tests data files (238M Mb) ==== |
---|
137 | |
---|
138 | If you want to use the tests programs, you need to download the data tests files ({{{SAXO_DATA_20060602.tar.gz}}}), you may download theses files in |
---|
139 | |
---|
140 | * {{{${HOME}/My_IDL}}}. This is the easiest solution but it could be inconvenient if your ${HOME} disk space is limited. |
---|
141 | |
---|
142 | * any other directory of your choice. In that case, when using IDL, you will need to define the variable {{{iodir}}} to the directory you choose in order to let IDL find the data tests files. This can be done either through the {{{init.pro}}} file (see [#Create SAXO environment]) or directly within IDL with the following command: idl>iodir = '''''the chosen directory'''''. |
---|
143 | {{{ |
---|
144 | #!html |
---|
145 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
146 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}</code></em></code></strong> |
---|
147 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">mkdir</strong></span> <em class="parameter"><code><code class="replaceable">CHOSEN_DIR</code></code></em></code></strong> |
---|
148 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="replaceable">CHOSEN_DIR</code></code></em></code></strong> |
---|
149 | </pre> |
---|
150 | }}} |
---|
151 | |
---|
152 | Download [http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_20060602.tar.gz SAXO_DATA_20060602.tar.gz] (238M Mb) |
---|
153 | or with {{{wget}}} or {{{curl}}} ⊠|
---|
154 | |
---|
155 | '''wget'''{{{ |
---|
156 | #!html |
---|
157 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
158 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">wget</strong></span> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_20060602.tar.gz</code></em></code></strong> |
---|
159 | </pre> |
---|
160 | }}} |
---|
161 | |
---|
162 | '''curl'''{{{ |
---|
163 | #!html |
---|
164 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
165 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">curl</strong></span> <code class="option">-O</code> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_20060602.tar.gz</code></em></code></strong> |
---|
166 | </pre> |
---|
167 | }}} |
---|
168 | |
---|
169 | |
---|
170 | == Generate your init.pro file == |
---|
171 | |
---|
172 | To use SAXO, we need to build an IDL script that we usually call "{{{init.pro}}}". This file contains a set of IDL commands and default definitions (paths and variables of the common files) that are necessary to SAXO. Once it has been created, {{{init.pro}}} should the first executed command when starting IDL session. |
---|
173 | {{{ |
---|
174 | #!html |
---|
175 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
176 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}/SAXO_DIR/SRC</code></em></code></strong> |
---|
177 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">idl</strong></span></code></strong> |
---|
178 | <code class="computeroutput">IDL Version 6.0, Mac OS X (darwin ppc m32). (c) 2003, Research Systems, Inc.</code> |
---|
179 | |
---|
180 | <code class="prompt">idl></code> <strong class="userinput"><code><span><strong class="command">buildinit</strong></span></code></strong> |
---|
181 | <code class="computeroutput">% Compiled module: BUILDINIT.</code> |
---|
182 | </pre> |
---|
183 | }}} |
---|
184 | |
---|
185 | You must then answer several questions: |
---|
186 | |
---|
187 | * give the path of {{{${HOME}/My_IDL}}} |
---|
188 | * give the path of {{{${HOME}/SAXO_DIR}}} |
---|
189 | * compatibility with the old version: No (except if you want to use old programs) |
---|
190 | * give a default path for the data directory |
---|
191 | * give a default path for the postscript directory |
---|
192 | * give a default path for the images directory |
---|
193 | * give a default path for the animation directory |
---|
194 | * number of accessible printer and their configuration |
---|
195 | * default color table |
---|
196 | * default page orientation (portrait/landscape) |
---|
197 | * default page size |
---|
198 | * default window size |
---|
199 | * postscript archiving options |
---|
200 | * name of the init file ({{{init.pro}}}){{{ |
---|
201 | #!html |
---|
202 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
203 | <code class="computeroutput">% Compiled module: CW_FIELD.</code> |
---|
204 | <code class="computeroutput">% Compiled module: XMANAGER.</code> |
---|
205 | <code class="computeroutput">% Compiled module: LOADCT.</code> |
---|
206 | <code class="computeroutput">% Compiled module: FILEPATH.</code> |
---|
207 | <code class="computeroutput">% Compiled module: PATH_SEP.</code> |
---|
208 | <code class="computeroutput">% Compiled module: CW_FIELD.</code> |
---|
209 | <code class="computeroutput">% Compiled module: STRSPLIT.</code> |
---|
210 | <code class="computeroutput">% Compiled module: CW_FIELD.</code> |
---|
211 | <code class="computeroutput">% Compiled module: CW_FIELD.</code> |
---|
212 | <code class="computeroutput">% Compiled module: CW_FIELD.</code> |
---|
213 | <code class="prompt">idl></code> <strong class="userinput"><code><span><strong class="command">exit</strong></span></code></strong> |
---|
214 | </pre> |
---|
215 | }}} |
---|
216 | |
---|
217 | There is an example of the kind of [idlfiles/init_example.pro init.pro] you should get. |
---|
218 | |
---|
219 | == After this == |
---|
220 | |
---|
221 | You are now ready to do your |
---|
222 | [wiki:FirstSteps First steps with SAXO]. |
---|
223 | |
---|