[347] | 1 | |
---|
[351] | 2 | |
---|
| 3 | = Get SAXO = |
---|
| 4 | [[PageOutline]] |
---|
| 5 | |
---|
[347] | 6 | |
---|
[351] | 7 | |
---|
| 8 | |
---|
| 9 | |
---|
| 10 | |
---|
| 11 | |
---|
[347] | 12 | |
---|
| 13 | |
---|
| 14 | |
---|
| 15 | |
---|
[351] | 16 | == Create SAXO environment == |
---|
[347] | 17 | |
---|
[351] | 18 | To simplify the explanation, we suppose that we install SAXO in your {{{${HOME}}}}. |
---|
[347] | 19 | We need to create 2 directories: |
---|
[351] | 20 | |
---|
| 21 | |
---|
| 22 | * {{{${HOME}/SAXO_DIR}}} that will contain the source files of SAXO. It should not be modified by the user to simplify later updates. |
---|
[347] | 23 | |
---|
[351] | 24 | |
---|
| 25 | |
---|
| 26 | * {{{${HOME}/My_IDL}}} that will contain user personal files (including modified SAXO files, if needed). |
---|
[347] | 27 | |
---|
[351] | 28 | |
---|
| 29 | |
---|
| 30 | |
---|
| 31 | |
---|
| 32 | {{{ |
---|
| 33 | #!html |
---|
| 34 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 35 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}</code></em></code></strong> |
---|
| 36 | <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> |
---|
[351] | 37 | </pre> |
---|
| 38 | }}} |
---|
| 39 | |
---|
| 40 | |
---|
[347] | 41 | |
---|
| 42 | |
---|
| 43 | |
---|
[351] | 44 | |
---|
| 45 | == Get SAXO files == |
---|
[347] | 46 | |
---|
| 47 | |
---|
| 48 | |
---|
[351] | 49 | |
---|
| 50 | === If you work at IDRIS, IPSL or LOCEAN === |
---|
[347] | 51 | |
---|
[351] | 52 | SAXO is already installed at |
---|
| 53 | |
---|
| 54 | |
---|
| 55 | * IDRIS, on {{{rhodes}}}: {{{/home/rech/eee/reee217/SAXO_DIR}}} |
---|
[347] | 56 | |
---|
[351] | 57 | |
---|
| 58 | |
---|
| 59 | * IPSL: {{{/home/smlod/SAXO_DIR}}} |
---|
[347] | 60 | |
---|
[351] | 61 | |
---|
| 62 | |
---|
| 63 | * LOCEAN: {{{/usr/home/smasson/SAXO_DIR}}} |
---|
[347] | 64 | |
---|
[351] | 65 | |
---|
| 66 | |
---|
| 67 | 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: |
---|
| 68 | |
---|
| 69 | '''IDRIS''' |
---|
| 70 | {{{ |
---|
| 71 | #!html |
---|
| 72 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 73 | <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> |
---|
| 74 | </pre> |
---|
[351] | 75 | }}} |
---|
| 76 | |
---|
| 77 | |
---|
| 78 | '''IPSL''' |
---|
| 79 | {{{ |
---|
| 80 | #!html |
---|
| 81 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 82 | <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> |
---|
| 83 | </pre> |
---|
[351] | 84 | }}} |
---|
| 85 | |
---|
| 86 | |
---|
| 87 | '''LOCEAN''' |
---|
| 88 | {{{ |
---|
| 89 | #!html |
---|
| 90 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 91 | <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> |
---|
| 92 | </pre> |
---|
[351] | 93 | }}} |
---|
| 94 | |
---|
| 95 | |
---|
| 96 | |
---|
| 97 | |
---|
| 98 | |
---|
[347] | 99 | |
---|
| 100 | |
---|
| 101 | |
---|
[351] | 102 | |
---|
| 103 | === If Subversion (svn) is installed on your machine === |
---|
| 104 | |
---|
[347] | 105 | |
---|
[351] | 106 | ==== Regular users ==== |
---|
| 107 | |
---|
| 108 | The ''complete'' latest revision (source + tests data files: 772 Mb) can be checked out with the following command executed in your ${HOME}: |
---|
| 109 | {{{ |
---|
| 110 | #!html |
---|
| 111 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 112 | <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> |
---|
[351] | 113 | </pre> |
---|
| 114 | }}} |
---|
| 115 | |
---|
| 116 | |
---|
| 117 | The latest revision of the ''source files'' (45 Mb) can be checked out with the following command: |
---|
| 118 | {{{ |
---|
| 119 | #!html |
---|
| 120 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 121 | <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> |
---|
[351] | 122 | </pre> |
---|
| 123 | }}} |
---|
| 124 | |
---|
| 125 | |
---|
| 126 | The latest revision of the ''NetCDF data files'' (728 Mb) used by the test programs can be checked out with the following command: |
---|
| 127 | {{{ |
---|
| 128 | #!html |
---|
| 129 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 130 | <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> |
---|
[351] | 131 | </pre> |
---|
| 132 | }}} |
---|
| 133 | |
---|
| 134 | |
---|
[347] | 135 | |
---|
[351] | 136 | |
---|
| 137 | ==== Contributors ==== |
---|
| 138 | |
---|
| 139 | ''Contributors'' should better use the following command (and replace login by their own login): |
---|
| 140 | {{{ |
---|
| 141 | #!html |
---|
| 142 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
| 143 | <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> |
---|
| 144 | </pre> |
---|
| 145 | }}} |
---|
| 146 | |
---|
| 147 | |
---|
| 148 | |
---|
[347] | 149 | |
---|
| 150 | |
---|
| 151 | |
---|
[351] | 152 | |
---|
| 153 | === Get SAXO from a tar file === |
---|
| 154 | |
---|
[347] | 155 | |
---|
[351] | 156 | ==== Get SAXO source files (5.8M Mb) ==== |
---|
[347] | 157 | |
---|
[351] | 158 | Create your {{{${HOME}/SAXO_DIR}}} directory ⊠|
---|
| 159 | {{{ |
---|
| 160 | #!html |
---|
| 161 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 162 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}</code></em></code></strong> |
---|
| 163 | <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> |
---|
| 164 | <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> |
---|
[351] | 165 | </pre> |
---|
| 166 | }}} |
---|
| 167 | |
---|
| 168 | |
---|
| 169 | ⊠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). |
---|
| 170 | |
---|
| 171 | |
---|
| 172 | This tar.gz file could also be downloaded with {{{wget}}} or {{{curl}}} |
---|
| 173 | |
---|
| 174 | '''wget''' |
---|
| 175 | {{{ |
---|
| 176 | #!html |
---|
| 177 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 178 | <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> |
---|
| 179 | </pre> |
---|
[351] | 180 | }}} |
---|
| 181 | |
---|
| 182 | |
---|
| 183 | '''curl''' |
---|
| 184 | {{{ |
---|
| 185 | #!html |
---|
| 186 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 187 | <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> |
---|
| 188 | </pre> |
---|
[351] | 189 | }}} |
---|
| 190 | |
---|
| 191 | |
---|
| 192 | |
---|
[347] | 193 | Untar the file |
---|
[351] | 194 | {{{ |
---|
| 195 | #!html |
---|
| 196 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 197 | <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> |
---|
| 198 | <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> |
---|
| 199 | <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> |
---|
[351] | 200 | </pre> |
---|
| 201 | }}} |
---|
| 202 | |
---|
[347] | 203 | |
---|
[351] | 204 | |
---|
[347] | 205 | |
---|
[351] | 206 | |
---|
| 207 | ==== Get SAXO tests data files (238M Mb) ==== |
---|
[347] | 208 | |
---|
[351] | 209 | 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 |
---|
| 210 | |
---|
| 211 | |
---|
| 212 | * {{{${HOME}/My_IDL}}}. This is the easiest solution but it could be inconvenient if your ${HOME} disk space is limited. |
---|
[347] | 213 | |
---|
[351] | 214 | |
---|
| 215 | |
---|
| 216 | * #xA; |
---|
| 217 | |
---|
| 218 | {{{ |
---|
| 219 | #!html |
---|
| 220 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 221 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}</code></em></code></strong> |
---|
[351] | 222 | <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> |
---|
| 223 | <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> |
---|
| 224 | </pre> |
---|
| 225 | }}} |
---|
| 226 | Download [http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_20060602.tar.gz SAXO_DATA_20060602.tar.gz] (238M Mb) |
---|
| 227 | or with {{{wget}}} or {{{curl}}} ⊠|
---|
| 228 | |
---|
| 229 | '''wget''' |
---|
| 230 | {{{ |
---|
| 231 | #!html |
---|
| 232 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 233 | <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> |
---|
| 234 | </pre> |
---|
[351] | 235 | }}} |
---|
| 236 | |
---|
| 237 | |
---|
| 238 | '''curl''' |
---|
| 239 | {{{ |
---|
| 240 | #!html |
---|
| 241 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 242 | <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> |
---|
| 243 | </pre> |
---|
[351] | 244 | }}} |
---|
| 245 | |
---|
| 246 | |
---|
| 247 | |
---|
| 248 | |
---|
| 249 | |
---|
| 250 | |
---|
[347] | 251 | |
---|
[351] | 252 | |
---|
| 253 | |
---|
| 254 | == Generate your init.pro file == |
---|
[347] | 255 | |
---|
[351] | 256 | 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. |
---|
| 257 | |
---|
| 258 | |
---|
| 259 | {{{ |
---|
| 260 | #!html |
---|
| 261 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 262 | <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> |
---|
| 263 | <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">idl</strong></span></code></strong> |
---|
| 264 | <code class="computeroutput">IDL Version 6.0, Mac OS X (darwin ppc m32). (c) 2003, Research Systems, Inc.</code> |
---|
| 265 | |
---|
| 266 | <code class="prompt">idl></code> <strong class="userinput"><code><span><strong class="command">buildinit</strong></span></code></strong> |
---|
| 267 | <code class="computeroutput">% Compiled module: BUILDINIT.</code> |
---|
[351] | 268 | </pre> |
---|
| 269 | }}} |
---|
| 270 | |
---|
| 271 | |
---|
[347] | 272 | You must then answer several questions: |
---|
| 273 | |
---|
[351] | 274 | |
---|
| 275 | |
---|
| 276 | * give the path of {{{${HOME}/My_IDL}}} |
---|
| 277 | |
---|
| 278 | |
---|
| 279 | * give the path of {{{${HOME}/SAXO_DIR}}} |
---|
| 280 | |
---|
| 281 | |
---|
| 282 | * compatibility with the old version: No (except if you want to use old programs) |
---|
| 283 | |
---|
| 284 | |
---|
| 285 | * give a default path for the data directory |
---|
| 286 | |
---|
| 287 | |
---|
| 288 | * give a default path for the postscript directory |
---|
| 289 | |
---|
| 290 | |
---|
| 291 | * give a default path for the images directory |
---|
| 292 | |
---|
| 293 | |
---|
| 294 | * give a default path for the animation directory |
---|
| 295 | |
---|
| 296 | |
---|
| 297 | * number of accessible printer and their configuration |
---|
| 298 | |
---|
| 299 | |
---|
| 300 | * default color table |
---|
| 301 | |
---|
| 302 | |
---|
| 303 | * default page orientation (portrait/landscape) |
---|
| 304 | |
---|
| 305 | |
---|
| 306 | * default page size |
---|
| 307 | |
---|
| 308 | |
---|
| 309 | * default window size |
---|
| 310 | |
---|
| 311 | |
---|
| 312 | * postscript archiving options |
---|
| 313 | |
---|
| 314 | |
---|
| 315 | * name of the init file ({{{init.pro}}}) |
---|
| 316 | |
---|
| 317 | |
---|
| 318 | |
---|
| 319 | |
---|
| 320 | {{{ |
---|
| 321 | #!html |
---|
| 322 | <pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen"> |
---|
[347] | 323 | <code class="computeroutput">% Compiled module: CW_FIELD.</code> |
---|
| 324 | <code class="computeroutput">% Compiled module: XMANAGER.</code> |
---|
| 325 | <code class="computeroutput">% Compiled module: LOADCT.</code> |
---|
| 326 | <code class="computeroutput">% Compiled module: FILEPATH.</code> |
---|
| 327 | <code class="computeroutput">% Compiled module: PATH_SEP.</code> |
---|
| 328 | <code class="computeroutput">% Compiled module: CW_FIELD.</code> |
---|
| 329 | <code class="computeroutput">% Compiled module: STRSPLIT.</code> |
---|
| 330 | <code class="computeroutput">% Compiled module: CW_FIELD.</code> |
---|
| 331 | <code class="computeroutput">% Compiled module: CW_FIELD.</code> |
---|
| 332 | <code class="computeroutput">% Compiled module: CW_FIELD.</code> |
---|
| 333 | <code class="prompt">idl></code> <strong class="userinput"><code><span><strong class="command">exit</strong></span></code></strong> |
---|
[351] | 334 | </pre> |
---|
| 335 | }}} |
---|
[347] | 336 | |
---|
[351] | 337 | |
---|
| 338 | There is an example of the kind of [idlfiles/init_example.pro init.pro] you should get. |
---|
| 339 | |
---|
| 340 | |
---|
| 341 | |
---|
| 342 | == After this == |
---|
| 343 | |
---|
[347] | 344 | You are now ready to do your |
---|
[351] | 345 | [wiki:FirstSteps First steps with SAXO]. |
---|
[347] | 346 | |
---|
[351] | 347 | |
---|
| 348 | |
---|