forked from Fellypao/scidavis-handbook
-
Notifications
You must be signed in to change notification settings - Fork 1
/
reference.html
332 lines (332 loc) · 25.8 KB
/
reference.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Chapter 5. Command Reference</title>
<link rel="stylesheet" type="text/css" href="scidavis.css">
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<meta name="keywords" content="Qt, SciDAVis, Data, Analysis, Plotting">
<link rel="home" href="index.html" title="The SciDAVis Handbook">
<link rel="up" href="index.html" title="The SciDAVis Handbook">
<link rel="prev" href="sec-python.html" title="Python">
<link rel="next" href="sec-edit-menu.html" title="The Edit Menu">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">Chapter 5. Command Reference</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="sec-python.html">Prev</a> </td>
<th width="60%" align="center"> </th>
<td width="20%" align="right"> <a accesskey="n" href="sec-edit-menu.html">Next</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="chapter">
<div class="titlepage"><div><div><h1 class="title">
<a name="reference"></a>Chapter 5. Command Reference</h1></div></div></div>
<div class="toc">
<p><b>Table of Contents</b></p>
<dl class="toc">
<dt><span class="sect1"><a href="reference.html#sec-file-menu">The File Menu</a></span></dt>
<dt><span class="sect1"><a href="sec-edit-menu.html">The Edit Menu</a></span></dt>
<dt><span class="sect1"><a href="sec-view-menu.html">The View Menu</a></span></dt>
<dt><span class="sect1"><a href="sec-graph-menu.html">The Graph Menu</a></span></dt>
<dt><span class="sect1"><a href="sec-plot-menu.html">The Plot Menu</a></span></dt>
<dt><span class="sect1"><a href="sec-plot3d-menu.html">The Plot 3D menu</a></span></dt>
<dt><span class="sect1"><a href="sec-tools-menu.html">The Tools Menu</a></span></dt>
<dt><span class="sect1"><a href="sec-analysis-menu.html">The Analysis Menu</a></span></dt>
<dd><dl>
<dt><span class="sect2"><a href="sec-analysis-menu.html#sec-analysis-tables-menu">Commands for the analysis of data in tables</a></span></dt>
<dt><span class="sect2"><a href="sec-analysis-menu.html#sec-analysis-plots-menu">Commands for the analysis of curves in plots</a></span></dt>
</dl></dd>
<dt><span class="sect1"><a href="sec-table-menu.html">The Table Menu</a></span></dt>
<dt><span class="sect1"><a href="sec-matrix-menu.html">The Matrix Menu</a></span></dt>
<dt><span class="sect1"><a href="sec-format-menu.html">The Format Menu</a></span></dt>
<dt><span class="sect1"><a href="sec-windows-menu.html">The Window Menu</a></span></dt>
<dt><span class="sect1"><a href="sec-help-menu.html">The Help Menu</a></span></dt>
</dl>
</div>
<p>
The active items in the menus depend on the active window in the project. If the active window is a spreadsheet, then all the items linked to table functions are enabled and the others are automatically disabled.
</p>
<div class="sect1">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="sec-file-menu"></a>The File Menu</h2></div></div></div>
<p>These commands can also be done by clicking on the <span class="emphasis"><em>New Project</em></span> icon from the <a class="link" href="toolbars.html#sec-file-toolbar" title="The File Toolbar">File toolbar</a>. In order to make this toolbar visible, use the <a class="link" href="sec-view-menu.html#aff-toolbars-cmd"><span class="command"><strong>Toolbars</strong></span> command</a> from the <a class="link" href="sec-view-menu.html" title="The View Menu">View menu</a>.</p>
<div class="variablelist"><dl class="variablelist">
<dt>
<a name="new-cmd"></a><span class="term">File→ New →</span>
</dt>
<dd><div class="variablelist"><dl class="variablelist">
<dt>
<a name="new-project-cmd"></a><span class="term"><span class="command"><strong>New→New Project</strong></span> (<span class="keycode">CTRL+N</span>)</span>
</dt>
<dd>
<p>Creates a new SciDAVis project file. The project is the main container of SciDAVis, it can include tables, plots and notes. These objects can be organized in folders. If a project is open and saved, it will be closed. If a project is open is not saved, a dialog will be open to ask if the current project has to be saved. The new project will only contain an empty table.</p>
<p>These commands can also be done by clicking on the <span class="emphasis"><em>New Project</em></span> icon from the <a class="link" href="toolbars.html#sec-file-toolbar" title="The File Toolbar">File toolbar</a>. In order to make this toolbar visible, use the <a class="link" href="sec-view-menu.html#aff-toolbars-cmd"><span class="command"><strong>Toolbars</strong></span> command</a> from the <a class="link" href="sec-view-menu.html" title="The View Menu">View menu</a>.</p>
</dd>
<dt>
<a name="new-table-cmd"></a><span class="term"><span class="command"><strong>New→New Table</strong></span> (<span class="keycode">CTRL+T</span>)</span>
</dt>
<dd>
<a class="indexterm" name="idp1397051748"></a><p>Creates a new spreadsheet into the project. This empty table will have 30 rows and 2 columns. This number of rows and columns can be changed with the <a class="link" href="sec-table-menu.html#table-dimensions-cmd"><span class="command"><strong>Dimensions</strong></span> command</a> of the <a class="link" href="sec-table-menu.html" title="The Table Menu">Table menu</a>.</p>
<div class="informalfigure">
<a name="fig-new-table"></a><div class="mediaobject"><img src="pics/new-table.png"></div>
</div>
<p>The properties of each column (format of numbers, width, etc) can be modified by the commands of the <a class="link" href="sec-table-menu.html" title="The Table Menu">Table menu</a>. See the <a class="link" href="general-concepts.html#sec-intro-table" title="Tables">table section</a> for more details. There are then many different ways to insert data inside a table: they can be entered one by one, copied and pasted from another software like a spreadsheet, imported from a text file (see <a class="link" href="reference.html#import-ascii-cmd"><span class="command"><strong>Import Ascii</strong></span> command</a>), or filled with the result of a function as explained in the section <a class="link" href="using.html#sec-table-function-plot" title="Filling of a table with the values of a function.">Filling of a table with the values of a function</a>.</p>
</dd>
<dt>
<a name="new-matrix-cmd"></a><span class="term"><span class="command"><strong>New→New Matrix</strong></span> (<span class="keycode">CTRL+M</span>)</span>
</dt>
<dd>
<a class="indexterm" name="idp1397059172"></a><p>Creates a new Matrix into the project. The empty matrix will have 32x32 cells, these dimensions can be changed by the <a class="link" href="sec-matrix-menu.html#matrix-dimensions-cmd"><span class="command"><strong>Dimensions</strong></span> command</a> of the <a class="link" href="sec-matrix-menu.html" title="The Matrix Menu">Matrix menu</a>. The default coordinates are ranging between 1 and 10 for x and y.</p>
<div class="informalfigure">
<a name="fig-new-matrix"></a><div class="mediaobject"><img src="pics/new-matrix.png"></div>
</div>
<p>See the <a class="link" href="general-concepts.html#sec-intro-matrix" title="Matrix">matrix section</a> for more details.</p>
</dd>
<dt>
<a name="new-note-cmd"></a><span class="term"><span class="command"><strong>New→New Note/Script</strong></span> (<span class="keycode">CTRL+ALT+N</span>)</span>
</dt>
<dd>
<p>Creates a new note window in the project. A note is a simple text window which can be used to add comments to the current project.</p>
<div class="informalfigure">
<a name="fig-new-note"></a><div class="mediaobject"><img src="pics/new-note1.png"></div>
</div>
<p>This object is also used to store the scripts in python which can be used to perform complex operations with SciDAVis. See the <a class="link" href="general-concepts.html#sec-intro-note" title="Note">note section</a> and the <a class="link" href="sec-python.html" title="Python">python scripting section</a>for more details. It can also be used as a calculator.</p>
</dd>
<dt>
<a name="new-graph-cmd"></a><span class="term"><span class="command"><strong>New→New Graph</strong></span> (<span class="keycode">CTRL+G</span>)</span>
</dt>
<dd>
<a class="indexterm" name="idp1397066308"></a><p>Creates a new empty 2D plot in the project. This default graph is just a framework in which you can add curves from the columns of a table with the <a class="link" href="sec-graph-menu.html#add-remove-curve-cmd"><span class="command"><strong>Add/Remove Curve</strong></span> command</a> or define a mathematical expression with the <a class="link" href="sec-graph-menu.html#add-function-cmd"><span class="command"><strong>Add Function</strong></span> command</a> (to access to these command, use the <a class="link" href="sec-graph-menu.html" title="The Graph Menu">Graph menu</a> or do a right click).</p>
<div class="informalfigure">
<a name="fig-new-graph"></a><div class="mediaobject"><img src="pics/new-graph.png"></div>
</div>
<p>The graph will be created with the display parameters selected in the <a class="link" href="sec-edit-menu.html#preferences-cmd"><span class="command"><strong>Preferences</strong></span> command</a> (<a class="link" href="sec-edit-menu.html" title="The Edit Menu">Edit menu</a>).</p>
</dd>
<dt>
<a name="new-function-plot-cmd"></a><span class="term"><span class="command"><strong>New→New Function Plot</strong></span> (<span class="keycode">CTRL+F</span>)</span>
</dt>
<dd>
<p>Opens a dialog allowing to create a plot by specifying an analytical function. See the <a class="link" href="using.html#sec-2d-plot-from-function" title="2D plot from function.">2D plot section</a> of the tutorial for a general overview of this function.</p>
<div class="figure">
<a name="fig-new-function-plot-dialog"></a><p class="title"><b>Figure 5.1. The <span class="command">New→New Function Plot</span> dialog box.</b></p>
<div class="figure-contents"><div class="mediaobject"><img src="pics/new-function-plot.png" alt="The New→New Function Plot dialog box."></div></div>
</div>
<br class="figure-break"><p>This function can be defined in cartesian, parametric or polar coordinates, see the <a class="link" href="sec-graph-menu.html#add-function-cmd"><span class="command"><strong>Add Function</strong></span> command</a> for more details.</p>
</dd>
<dt>
<a name="new-surface-3d-plot-cmd"></a><span class="term"><span class="command"><strong>New→New 3D Surface Plot</strong></span> (<span class="keycode">CTRL+ALT+Z</span>)</span>
</dt>
<dd>
<a class="indexterm" name="idp1397082332"></a><p>Opens a dialog allowing to create a 3D plot by specifying an analytical function. See the <a class="link" href="sec-3d-plots.html#sec-3d-plot-function" title="Direct 3D plot from a function">3D plot section</a> of the tutorial for more detail on this function. The only available coordinate system is the cartesian one: z=f(x,y).</p>
<div class="figure">
<a name="fig-define-surface-plot-dialog"></a><p class="title"><b>Figure 5.2. The <span class="command">New→New 3D Surface Plot</span> dialog box.</b></p>
<div class="figure-contents"><div class="mediaobject"><img src="pics/define-surface-plot.png" alt="The New→New 3D Surface Plot dialog box."></div></div>
</div>
<br class="figure-break"><p>You can then enter the X, Y and Z scales.</p>
</dd>
</dl></div></dd>
<dt>
<a name="open-cmd"></a><span class="term">File → <span class="command"><strong>Open</strong></span> (<span class="keycode">CTRL+O</span>)</span>
</dt>
<dd>
<p>Opens an existing SciDAVis project file (default file extension <span class="emphasis"><em>.sciprj</em></span>). If your project has been save in a compressed format, you must select the <span class="emphasis"><em>.sciprj.gz</em></span> file format.</p>
<div class="figure">
<a name="fig-open-dialog"></a><p class="title"><b>Figure 5.3. The <span class="command">New→New 3D Surface Plot</span> dialog box.</b></p>
<div class="figure-contents"><div class="mediaobject"><img src="pics/open-dialog.png" alt="The New→New 3D Surface Plot dialog box."></div></div>
</div>
<br class="figure-break"><p>This command can also be used to open projects which have been built with the <span class="emphasis"><em>Qtiplot</em></span> software (extension <span class="emphasis"><em>.qti</em></span>) if the version used was below 0.9. By clicking on the <span class="emphasis"><em>Advanced</em></span> button, an additional option appears which allows to insert a project in another as a new folder.</p>
</dd>
<dt>
<a name="recent-projects-cmd"></a><span class="term">File→ <span class="command"><strong>Recent Projects</strong></span></span>
</dt>
<dd><p>Opens a list of the most recently used SciDAVis project files. You can open one of these files by selecting it from the list. If the file doesn't exist anymore an error message will pop-out and the file will be automatically deleted from the list.</p></dd>
<dt>
<a name="open-image-file-cmd"></a><span class="term">File→ <span class="command"><strong>Open image File</strong></span> (<span class="keycode">CTRL+I</span>)</span>
</dt>
<dd>
<p>This command loads an image file in a SciDAVis project. This image can be resized and then inserted in another 2D plot. It is in this case similar to the <a class="link" href="sec-graph-menu.html#add-image-cmd"><span class="command"><strong>Add Image</strong></span> command</a>. This image can also be used to generate an intensity matrix (see the <a class="link" href="reference.html#import-image-cmd"><span class="command"><strong>Import Image</strong></span> command</a>).</p>
<div class="figure">
<a name="fig-open-image-file"></a><p class="title"><b>Figure 5.4. The result of <span class="command">Open image File</span>.</b></p>
<div class="figure-contents"><div class="mediaobject"><img src="pics/open-image-file.png" alt="The result of Open image File."></div></div>
</div>
<br class="figure-break">
</dd>
<dt>
<a name="import-image-cmd"></a><span class="term">File→ <span class="command"><strong>Import Image</strong></span></span>
</dt>
<dd>
<p>With this command, an image is loaded in the SciDAVis project and converted to an intensity matrix. For each pixel, an intensity between 0 and 255 is computed from the intensities of the three colors red, green and blue.</p>
<div class="informalfigure">
<a name="fig-plot-intensity-matrix"></a><div class="mediaobject"><img src="pics/plot-intensity-matrix.png"></div>
</div>
<p>This example shows the 3D plot which has been drawn from the matrix obtained with the SciDAVis logo.</p>
</dd>
<dt>
<a name="save-project-cmd"></a><span class="term">File→ <span class="command"><strong>Save Project</strong></span> (<span class="keycode">CTRL+S</span>)</span>
</dt>
<dd>
<p>Saves the actual project. If the project hasn't been saved yet ("untitled" project), a dialog will open, allowing to save the project to a specific location.In a project file all settings and all plots are stored in ASCII format.</p>
<p>If the project include large tables, it may be usefull to save the project in a compressed file format. The free zlib library is used to build files in gzip formats ( .sciprj.gz ).</p>
</dd>
<dt>
<a name="save-project-as-cmd"></a><span class="term">File→ <span class="command"><strong>Save Project As</strong></span></span>
</dt>
<dd><p>Saves the actual project under a file name different from the current one.</p></dd>
<dt>
<a name="open-template-cmd"></a><span class="term">File → <span class="command"><strong>Open Template</strong></span></span>
</dt>
<dd>
<p>Opens an existing template SciDAVis file. There are four kinds of templates with different extensions for file names.</p>
<div class="informaltable"><table width="100%" border="1">
<colgroup>
<col align="center" class="entity">
<col align="center" class="extension">
<col align="justify" class="description">
</colgroup>
<thead><tr>
<th align="center">Entity</th>
<th align="center">Extension</th>
<th align="justify">Parameters saved</th>
</tr></thead>
<tbody>
<tr>
<td align="center">2D Plot</td>
<td align="center">.qpt</td>
<td align="justify">window and layers geometries, fonts and colors for labels and legends, etc. Style for curves is not kept.</td>
</tr>
<tr>
<td align="center">3D Plot</td>
<td align="center">.qst</td>
<td align="justify">window and layers geometries, fonts and colors for labels and legends, etc</td>
</tr>
<tr>
<td align="center">Table</td>
<td align="center">.qtt</td>
<td align="justify">number of row and columns</td>
</tr>
<tr>
<td align="center">Matrix</td>
<td align="center">.qmt</td>
<td align="justify">number of row and columns</td>
</tr>
</tbody>
</table></div>
<p>You just have to add curves with the <a class="link" href="sec-graph-menu.html#add-remove-curve-cmd"><span class="command"><strong>Add/Remove Curve</strong></span> command</a>, but the style used to draw the curves is not kept in the template. See the <a class="xref" href="using.html#sec-template-2d-plot" title="Working with templates">the section called “Working with templates”</a>.</p>
</dd>
<dt>
<a name="save-as-template-cmd"></a><span class="term">File → <span class="command"><strong>Save as Template</strong></span></span>
</dt>
<dd><p>Save the active object as a SciDAVis template file. In the case of plot template (.qpt file), the graphical parameters of the plot, together with the text labels (axis, etc) are restored, but the style used to draw the curves and the scales are not saved.</p></dd>
<dt>
<a name="export-graph-cmd"></a><span class="term">File → <span class="command"><strong>Export Graph</strong></span></span>
</dt>
<dd>
<p>The plot can be exported into several different image formats. You can define some parameters to customize your image file by checking the <span class="emphasis"><em>advanced options</em></span> button. Depending on the chosen image format, the available options are not the same.</p>
<div class="figure">
<a name="fig-export-graph"></a><p class="title"><b>Figure 5.5. The <span class="command">Export Graph→Current</span> dialog.</b></p>
<div class="figure-contents"><div class="mediaobject"><img src="pics/export-graph.png" alt="The Export Graph→Current dialog."></div></div>
</div>
<br class="figure-break"><p>For <span class="emphasis"><em>tif, bmp, pbm, jpeg, xbm, pgm, ppm</em></span> image formats, the quality of the image cannot be controlled, and these formats cannot handle transparency. Therefore, there is no need to check for advanced options.</p>
<p> For <span class="emphasis"><em>jpeg</em></span> and <span class="emphasis"><em>png</em></span>, Image Quality parameter ranges between 0 and 100% and defines the compression ratio. The higher it is, the best the quality is but the larger the file is.</p>
<div class="informalfigure">
<a name="fig-export-graph-bmp"></a><div class="mediaobject"><img src="pics/export-graph2.png"></div>
</div>
<p>For <span class="emphasis"><em>png</em></span>, <span class="emphasis"><em>tif</em></span> and <span class="emphasis"><em>xpm</em></span>, you can choose to use a transparent background.</p>
<p><a name="export-to-pdf-cmd"></a>For <span class="emphasis"><em>eps, ps</em></span> and <span class="emphasis"><em>pdf</em></span> file format, the option dialog is different. The parameters availables are: the size of the paper which is used to draw the plot, and the orientation of the paper sheet. You can choose to keep or not the aspect ratio of the plot, in the last case it will be adapted to the sheet size and orientation.</p>
<p>In addition, you can define the resolution. The default value is 84. If you increase this parameter, the quality of the graphic elements will be better (but the overall size of the plot will be unchanged).</p>
<div class="informalfigure">
<a name="fig-export-graph-eps"></a><div class="mediaobject"><img src="pics/export-graph1.png"></div>
</div>
<p>The last format which can be selected is the Scalable Vector Graphic format. With this format, the files can be modified in vector drawing software such as <a class="ulink" href="http://www.sodipodi.com/index.php3" target="_top">Sodipodi</a>, <a class="ulink" href="http://www.inkscape.org/" target="_top">Inkscape</a> or <a class="ulink" href="http://www.openoffice.org/" target="_top">OpenOffice Draw</a>. You can therefore build more complex images from the pristine SciDAVis plot.</p>
<div class="variablelist"><dl class="variablelist">
<dt>
<a name="export-graph-current-cmd"></a><span class="term"><span class="command"><strong>Export Graph→Current</strong></span> (<span class="keycode">ALT+G</span>)</span>
</dt>
<dd><p>Here you have the possibility to save the active plot under different image formats.</p></dd>
<dt>
<a name="export-graph-all-cmd"></a><span class="term"> <span class="command"><strong>Export Graph→All</strong></span> (<span class="keycode">ALT+X</span>)</span>
</dt>
<dd><p>Here you have the possibility to save all plots of the project under different image formats. In this case, you must choose a directory for the differents plots. Then one file will be created for each plot, the filename being based on the title of the corresponding window.</p></dd>
</dl></div>
</dd>
<dt>
<a name="print-cmd"></a><span class="term">File→ <span class="command"><strong>Print</strong></span> (<span class="keycode">CTRL+P</span>)</span>
</dt>
<dd>
<p>Prints the active plot. A print dialog is opened where you can select the printer, etc.</p>
<div class="figure">
<a name="fig-print-dialog-1"></a><p class="title"><b>Figure 5.6. The basic <span class="command">Print</span> dialog.</b></p>
<div class="figure-contents"><div class="mediaobject"><img src="pics/print-dialog-0.png" alt="The basic Print dialog."></div></div>
</div>
<br class="figure-break"><p>.</p>
<div class="informalfigure">
<a name="fig-print-dialog-2"></a><div class="mediaobject"><img src="pics/print-dialog-1.png"></div>
</div>
<p>If your printer can handle duplex printing and/or color printing, your can select the corresponding options in the <span class="emphasis"><em>options</em></span> tag of this dialog window.</p>
<div class="informalfigure">
<a name="fig-print-dialog-3"></a><div class="mediaobject"><img src="pics/print-dialog-2.png"></div>
</div>
<p>The properties button can be used to select the geometrics parameters of the printed output: paper size, margin, etc.</p>
<div class="informalfigure">
<a name="fig-print-dialog-4"></a><div class="mediaobject"><img src="pics/print-dialog.png"></div>
</div>
</dd>
<dt>
<a name="print-all-plots-cmd"></a><span class="term">File→ <span class="command"><strong>Print All Plots</strong></span></span>
</dt>
<dd><p>Prints all plots of the projects. A print dialog is opened where you can select the printer, different paper sizes, etc.</p></dd>
<dt>
<a name="export-ascii-cmd"></a><span class="term">File → <span class="command"><strong>Export Ascii</strong></span></span>
</dt>
<dd>
<a class="indexterm" name="idp1397150180"></a><p>Opens a dialog box allowing to save the data from the active spreadsheet to an ASCII file. You can save one selected table, or all the tables of the project. You can then choose the field separator which will be used by SciDAVis. If you check <span class="emphasis"><em>Export Selection</em></span>, only the selected cells will be saved; If not, the whole table will be exported, including the cells with no content.</p>
<div class="figure">
<a name="fig-export-ascii"></a><p class="title"><b>Figure 5.7. The <span class="command">Export Ascii</span> dialog.</b></p>
<div class="figure-contents"><div class="mediaobject"><img src="pics/export-ascii.png" alt="The Export Ascii dialog."></div></div>
</div>
<br class="figure-break"><p>When the options are selected, click on OK and a new dialog will be displayed to choose the file name. If you check the <span class="emphasis"><em>all</em></span> checkbox, the dialog box will ask for a folder and each table will be save in a file named from the title of the table windows.</p>
</dd>
<dt>
<a name="import-ascii-cmd"></a><span class="term">File → <span class="command"><strong>Import Ascii</strong></span></span>
</dt>
<dd>
<p>Imports one or more ASCII file into the project by creating a new spreadsheet storing the data from the file.</p>
<div class="figure">
<a name="fig-import-ascii"></a><p class="title"><b>Figure 5.8. The <span class="command">Import Ascii</span> dialog.</b></p>
<div class="figure-contents"><div class="mediaobject"><img src="pics/import-ascii.png" alt="The Import Ascii dialog."></div></div>
</div>
<br class="figure-break"><p>You can choose to put each data file in a separate table, or join all the data files in one table. There is no automatic analysis of the data. Therefore, by default, the data will be read as text. If you want to obtain directly numeric values, you can specify it in the <span class="emphasis"><em>numeric data</em></span> check box. You must then indicate the format of the numbers. The other possibility is to read data as text and then to specify the type and format of the different columns with the <a class="link" href="general-concepts.html#sec-intro-table" title="Tables">properties dialog of the tables</a>.</p>
<p>If you check the <span class="emphasis"><em>Remember the above options</em></span>, the selected parameters will be used as default values. They will be used if you read an ascii file directly from the command line (see the <a class="link" href="command-line-options.html" title="Command Line Parameters">Command line options</a> section for more details.</p>
</dd>
<dt>
<a name="quit-cmd"></a><span class="term">File → <span class="command"><strong>Quit</strong></span> (<span class="keycode">CTRL+Q</span>)</span>
</dt>
<dd><p>Closes the application. You will be asked wether you want to save your last changes or not.</p></dd>
</dl></div>
</div>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="sec-python.html">Prev</a> </td>
<td width="20%" align="center"> </td>
<td width="40%" align="right"> <a accesskey="n" href="sec-edit-menu.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Python </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
<td width="40%" align="right" valign="top"> The Edit Menu</td>
</tr>
</table>
</div>
</body>
</html>