Ignore:
Timestamp:
06/27/07 14:32:59 (17 years ago)
Author:
pinsard
Message:

saxon was replaced by xalan in makehtml.sh because of better results on callouts in HTML files produced for XML/DocBook files

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/SRC/Documentation/xmldoc/firststeps.html

    r194 r255  
    33<head> 
    44<meta name="generator" content= 
    5 "HTML Tidy for Mac OS X (vers 1 September 2005), see www.w3.org"> 
     5"HTML Tidy for Mac OS X (vers 1st December 2004), see www.w3.org"> 
    66<meta http-equiv="Content-Type" content= 
    77"text/html; charset=us-ascii"> 
    88<title>First steps with SAXO</title> 
    9 <link rel="stylesheet" href="style.css" type="text/css"> 
    10 <link rel="stylesheet" href="saxo.css" type="text/css"> 
    11 <meta name="generator" content="DocBook XSL Stylesheets V1.70.1"> 
     9<link href="style.css" rel="stylesheet" type="text/css"> 
     10<link href="saxo.css" rel="stylesheet" type="text/css"> 
     11<meta content="DocBook XSL Stylesheets V1.71.1" name="generator"> 
    1212<meta name="keywords" content="IDL, SAXO"> 
    1313</head> 
    … …  
    1818<div> 
    1919<div> 
    20 <h2 class="title"><a name="d0e3" id="d0e3"></a> First steps with 
    21 <span class="application">SAXO</span></h2> 
     20<h2 class="title"><a name="N10003" id="N10003"></a> First steps 
     21with <span class="application">SAXO</span></h2> 
    2222</div> 
    2323<div> 
    … …  
    2626<h3 class="author"><span class="firstname">S&eacute;bastien</span> 
    2727<span class="surname">Masson</span> <code class= 
    28 "email">&lt;<a href="mailto:Sebastien.Masson_at_locean-ipsl.upmc.fr">Sebastien.Masson_at_locean-ipsl.upmc.fr</a>&gt;</code></h3> 
     28"email">&lt;<a href="mailto:Sebastien.Masson_at_locean-ipsl.upmc.fr"> 
     29Sebastien.Masson_at_locean-ipsl.upmc.fr</a>&gt;</code></h3> 
    2930</div> 
    3031<div class="author"> 
    … …  
    4142<div> 
    4243<div class="revhistory"> 
    43 <table border="1" width="100%" summary="Revision history"> 
     44<table summary="Revision history" width="100%" border="1"> 
    4445<tr> 
    45 <th align="left" valign="top" colspan="2"><b>Revision 
     46<th colspan="2" valign="top" align="left"><b>Revision 
    4647History</b></th> 
    4748</tr> 
    … …  
    5152</tr> 
    5253<tr> 
    53 <td align="left" colspan="2">First draft</td> 
     54<td colspan="2" align="left">First draft</td> 
    5455</tr> 
    5556<tr> 
    … …  
    5859</tr> 
    5960<tr> 
    60 <td align="left" colspan="2">last Japanese version!</td> 
     61<td colspan="2" align="left">last Japanese version!</td> 
    6162</tr> 
    6263<tr> 
    … …  
    6566</tr> 
    6667<tr> 
    67 <td align="left" colspan="2">split with getsaxo</td> 
     68<td colspan="2" align="left">split with getsaxo</td> 
    6869</tr> 
    6970</table> 
    … …  
    188189         
    189190</pre> 
    190 <p>As an IDL session using <span class="application">SAXO</span> 
    191 must always start with <code class="prompt">idl&gt;</code> 
     191As an IDL session using <span class="application">SAXO</span> must 
     192always start with <code class="prompt">idl&gt;</code> 
    192193<strong class="userinput"><code><span><strong class= 
    193194"command">@init</strong></span></code></strong>, it could be 
    … …  
    197198<code class="filename">init.pro</code> will automatically been 
    198199executed when starting IDL. This can be done with the following 
    199 command:</p> 
     200command: 
    200201<div class="variablelist"> 
    201202<dl> 
    … …  
    245246   <code class="prompt">idl&gt;</code> <strong class= 
    246247"userinput"><code><span><strong class= 
    247 "command">n = 10</strong></span></code></strong>                                             <span class="co"><img src="images/callouts/1.png" 
    248 alt="(1)"></span> 
     248"command">n = 10</strong></span></code></strong> 
    249249   <code class="prompt">idl&gt;</code> <strong class= 
    250250"userinput"><code><span><strong class= 
    … …  
    260260</pre> 
    261261<div class="calloutlist"> 
    262 <table border="0" summary="Callout list"> 
     262<table summary="Callout list" border="0"> 
    263263<tr> 
    264 <td width="5%" valign="top" align="left"><img src= 
    265 "images/callouts/1.png" alt="1" border="0"></td> 
    266 <td valign="top" align="left"> 
     264<td align="left" valign="top" width="5%"><img border="0" alt="1" 
     265src="images/callouts/1.png"></td> 
     266<td align="left" valign="top"> 
    267267<p><span><strong class="command">findgen</strong></span> stands for 
    268268<span class="bold"><strong>f</strong></span>loat <span class= 
    … …  
    310310         
    311311</pre> 
    312 <p>Save the figure seen on the screen as a (real, not a screen 
    313 capture) postscript in only one command.</p> 
     312Save the figure seen on the screen as a (real, not a screen 
     313capture) postscript in only one command. 
    314314<div class="screenco"> 
    315315<pre class="screen"> 
    … …  
    320320  <code class="computeroutput">% Compiled module: PUTFILE.</code> 
    321321  <code class="computeroutput">% Compiled module: OPENPS.</code> 
    322   <code class= 
    323 "computeroutput">% Compiled module: XQUESTION.</code>                            <span class="co"><img src="images/callouts/1.png" 
    324 alt="(1)"></span> 
     322  <code class="computeroutput">% Compiled module: XQUESTION.</code> 
    325323  <code class= 
    326324"computeroutput">Name of the postscript file? (default answer is idl.ps)</code><strong class="userinput"><code>first_ps</code></strong> <img src="images/callouts/1.png" 
    … …  
    337335</pre> 
    338336<div class="calloutlist"> 
    339 <table border="0" summary="Callout list"> 
     337<table summary="Callout list" border="0"> 
    340338<tr> 
    341 <td width="5%" valign="top" align="left"><img src= 
    342 "images/callouts/1.png" alt="1" border="0"></td> 
    343 <td valign="top" align="left"> 
     339<td align="left" valign="top" width="5%"><img border="0" alt="1" 
     340src="images/callouts/1.png"></td> 
     341<td align="left" valign="top"> 
    344342<p><em><span class="remark">If needed, the name of the postscript 
    345343will automatically be completed with .ps. Just hit return, if you 
    … …  
    351349</div> 
    352350</div> 
    353 <p>Check that the &ldquo;<span class="quote"><code class= 
     351Check that the &ldquo;<span class="quote"><code class= 
    354352"filename">first_ps.ps</code></span>&rdquo; file is now existing 
    355 &hellip;</p> 
     353&hellip; 
    356354<pre class="screen"> 
    357355  <code class="prompt">idl&gt;</code> <strong class= 
    … …  
    435433         
    436434</pre> 
    437 <p><span><strong class="command">splot</strong></span> can be used 
    438 to setup the graphic environment (<code class="varname">!p</code>, 
     435<span><strong class="command">splot</strong></span> can be used to 
     436setup the graphic environment (<code class="varname">!p</code>, 
    439437<code class="varname">!x</code>, <code class="varname">!y</code>, 
    440438<code class="varname">!z</code> variables) needed by procedures 
    441 like <span><strong class="command">oplot</strong></span></p> 
     439like <span><strong class="command">oplot</strong></span> 
    442440<pre class="screen"> 
    443441  <code class="prompt">idl&gt;</code> <strong class= 
    … …  
    451449         
    452450</pre> 
    453 <p>Use the keyword small to produce multi plots figures.</p> 
     451Use the keyword small to produce multi plots figures. 
    454452<div class="screenco"> 
    455453<pre class="screen"> 
    456                                                            <span class="co"><img src="images/callouts/1.png" 
    457 alt="(1)"></span> 
    458454  <code class="prompt">idl&gt;</code> <strong class= 
    459455"userinput"><code><span><strong class= 
    460456"command">splot, y, y^2, title = 'y = x^2', psym = 2, small <span class="inlinemediaobject"><img src="images/callouts/1.png" 
    461 alt="1"></span> =</strong></span></code></strong><span class= 
    462 "co"><img src="images/callouts/1.png" alt="(1)"></span><span class= 
    463 "co"><img src="images/callouts/2.png" alt= 
    464 "(2)"></span><strong class="userinput"><code><span><strong class= 
    465 "command"> [1, 2, 1]</strong></span></code></strong> 
     457alt="1"></span> = [1, 2, 1]</strong></span></code></strong> 
    466458  <code class="prompt">idl&gt;</code> <strong class= 
    467459"userinput"><code><span><strong class= 
    … …  
    480472</pre> 
    481473<div class="calloutlist"> 
    482 <table border="0" summary="Callout list"> 
     474<table summary="Callout list" border="0"> 
    483475<tr> 
    484 <td width="5%" valign="top" align="left"><img src= 
    485 "images/callouts/1.png" alt="1" border="0"></td> 
    486 <td valign="top" align="left"> 
     476<td align="left" valign="top" width="5%"><img border="0" alt="1" 
     477src="images/callouts/1.png"></td> 
     478<td align="left" valign="top"> 
    487479<p>the <code class="computeroutput">small</code> keyword is a 3 
    488480elements vector which defines how we divide the page and in which 
    … …  
    493485</tr> 
    494486<tr> 
    495 <td width="5%" valign="top" align="left"><img src= 
    496 "images/callouts/2.png" alt="2" border="0"></td> 
    497 <td valign="top" align="left">you must put <code class= 
     487<td align="left" valign="top" width="5%"><img border="0" alt="2" 
     488src="images/callouts/2.png"></td> 
     489<td align="left" valign="top">you must put <code class= 
    498490"computeroutput">/noerase</code> otherwise the second plot will be 
    499491done in a new window.</td> 
    … …  
    513505</div> 
    514506<p>Following <span><strong class="command"><a href="#basic_splot" 
    515 title="2.2.1.&nbsp; splot  ">splot</a></strong></span> example, we 
     507title="2.2.1.&nbsp; splot">splot</a></strong></span> example, we 
    516508provide <span><strong class="command">scontour</strong></span> as a 
    517509"super <span><strong class="command">contour</strong></span>".</p> 
    … …  
    531523         
    532524</pre> 
    533 <p><span><strong class="command">scontour</strong></span> accepts 
    534 the same keywords as <span><strong class= 
     525<span><strong class="command">scontour</strong></span> accepts the 
     526same keywords as <span><strong class= 
    535527"command">contour</strong></span> (<code class= 
    536528"computeroutput">C_ANNOTATION=vector_of_strings, C_CHARSIZE=value, 
    … …  
    544536/PATH_DOUBLE, /XLOG, /YLOG, ZAXIS={0 | 1 | 2 | 3 | 4}</code>), 
    545537including the <a href="#gr_kwd">graphics keywords</a> (except 
    546 <code class="computeroutput">LINESTYLE, PSYM, SYMSIZE</code>).</p> 
     538<code class="computeroutput">LINESTYLE, PSYM, SYMSIZE</code>). 
    547539<p>It can therefore be customized <span class="emphasis"><em>as 
    548540much as you want</em></span>. See these short examples:</p> 
    … …  
    558550         
    559551</pre> 
    560 <p>It can be used in combination with contour to make more complex 
    561 plots:</p> 
     552It can be used in combination with contour to make more complex 
     553plots: 
    562554<div class="screenco"> 
    563555<pre class="screen"> 
    564                                                            <span class="co"><img src="images/callouts/1.png" 
    565 alt="(1)"></span> 
    566556  <code class="prompt">idl&gt;</code> <strong class= 
    567557"userinput"><code><span><strong class= 
    … …  
    582572</pre> 
    583573<div class="calloutlist"> 
    584 <table border="0" summary="Callout list"> 
     574<table summary="Callout list" border="0"> 
    585575<tr> 
    586 <td width="5%" valign="top" align="left"><img src= 
    587 "images/callouts/1.png" alt="1" border="0"></td> 
    588 <td valign="top" align="left"> 
     576<td align="left" valign="top" width="5%"><img border="0" alt="1" 
     577src="images/callouts/1.png"></td> 
     578<td align="left" valign="top"> 
    589579<p><span><strong class="command">rebin</strong></span> is used to 
    590580build an array containing an alternation of 1 and 0 in order to 
    … …  
    603593</div> 
    604594</div> 
    605 <p><span><strong class="command">scontour</strong></span> is 
     595<span><strong class="command">scontour</strong></span> is 
    606596compatible with the positioning method associated with the 
    607597<code class="computeroutput">small</code> keyword. See for example 
    608598the test file <a href="../../Tests/tst_basic.pro" target= 
    609 "_top"><code class="filename">tst_basic.pro</code></a>:</p> 
     599"_top"><code class="filename">tst_basic.pro</code></a>: 
    610600<pre class="screen"> 
    611601  <code class="prompt">idl&gt;</code> <strong class= 
    … …  
    647637           
    648638</pre> 
    649 <p>For more informations on <span><strong class= 
    650 "command">tvplus</strong></span>, try:</p> 
     639For more informations on <span><strong class= 
     640"command">tvplus</strong></span>, try: 
    651641<pre class="screen"> 
    652642  <code class="prompt">idl&gt;</code> <strong class= 
    … …  
    655645           
    656646</pre> 
    657 <p>To see the source code of <span><strong class= 
    658 "command">tvplus</strong></span>, try:</p> 
     647To see the source code of <span><strong class= 
     648"command">tvplus</strong></span>, try: 
    659649<pre class="screen"> 
    660650  <code class="prompt">idl&gt;</code> <strong class= 
    … …  
    686676<p><span><strong class="command">pltv</strong></span> is a mix 
    687677between <a href="#tvplus" title= 
    688 "2.2.3.&nbsp;  Quick look and explore 2D arrays: tvplus ">tvplus</a> 
     678"2.2.3.&nbsp; Quick look and explore 2D arrays: tvplus">tvplus</a> 
    689679and <a href="#plt" title= 
    690 "3.2.&nbsp; horizontal plots and maps  ">plt</a> and allow you to 
     680"3.2.&nbsp; horizontal plots and maps">plt</a> and allow you to 
    691681have formal quick look of 2D arrays.</p> 
    692682<pre class="screen"> 
    … …  
    761751           
    762752</pre> 
    763 <p>This <a href="../../Tests/tst_initlev.pro" target= 
     753This <a href="../../Tests/tst_initlev.pro" target= 
    764754"_top"><span><strong class= 
    765755"command">@tst_initlev</strong></span></a> command allows us to 
    766 define:</p> 
     756define: 
    767757<div class="itemizedlist"> 
    768758<ul type="disc"> 
    … …  
    842832           
    843833</pre> 
    844 <p>We provide other initialization methods/examples</p> 
     834We provide other initialization methods/examples 
    845835<div class="itemizedlist"> 
    846836<ul type="disc"> 
    … …  
    897887grids (glam[uv],gphi[uv], e[12][uvf]). Note that, when using a 
    898888simple <a href="#load_fromdata" title= 
    899 "3.1.1.&nbsp;  Easiest solution: load data grid (regular or not) directly from the data file. "> 
     889"3.1.1.&nbsp; Easiest solution: load data grid (regular or not) directly from the data file."> 
    900890grid definition from the data itself</a> (with <code class= 
    901891"filename">initncdf</code> or <code class= 
    … …  
    941931<a href="../../Tests/tst_plt.pro" target="_top">tst_plt</a>. After 
    942932loading any of the grid (for example with one of the <a href= 
    943 "#load_grid" title="3.1.&nbsp; Load the data grid  ">above 
     933"#load_grid" title="3.1.&nbsp; Load the data grid">above 
    944934examples</a>). Just try:</p> 
    945935<pre class="screen"> 
    … …  
    11461136"../../Tests/tst_pltz.pro" target="_top">tst_pltz</a>. After 
    11471137loading any of the grid (for example with one of the <a href= 
    1148 "#load_grid" title="3.1.&nbsp; Load the data grid  ">above 
     1138"#load_grid" title="3.1.&nbsp; Load the data grid">above 
    11491139examples</a>). Just try:</p> 
    11501140<pre class="screen"> 
    … …  
    13731363<a href="../../Tests/tst_pltt.pro" target="_top">tst_pltt</a>. 
    13741364After loading any of the grid (for example with one of the <a href= 
    1375 "#load_grid" title="3.1.&nbsp; Load the data grid  ">above 
     1365"#load_grid" title="3.1.&nbsp; Load the data grid">above 
    13761366examples</a>). Just try:</p> 
    13771367<pre class="screen"> 
Note: See TracChangeset for help on using the changeset viewer.