diff --git a/docbook/kst/saving-chapter.docbook b/docbook/kst/saving-chapter.docbook index 3782e9b7..e04c082f 100644 --- a/docbook/kst/saving-chapter.docbook +++ b/docbook/kst/saving-chapter.docbook @@ -1,269 +1,324 @@ Saving and Printing &kst; provides various methods of saving and exporting data and plots. These methods are described below. - Saving Sessions: saves a capture of the entire &kst; session for future use. + Saving and loading Sessions: A capture of the entire &kst; session can be saved for future use. Exporting vectors: export one or more Vectors to an ASCII file. Printing tabs: Send one or more of the current tabs to a printer. Exporting tabs: Save one or more plots to an image file. Copy tab: :copy an image of the current tab to the clipbard for pasting in an other application. - -Saving Plot Definitions + +Saving Sessions -A plot definition is essentially a capture of a &kst; session. It contains all the plots, data objects, and plot layouts -that are present at the time of saving. + Selecting Save or Save As from the File menu will save the state of the current kst session. By default, these session files have the extentions .kst. If this session file is opened later, the state of kst, including the loading of all data files, and the saving of all plots will be returned to the state when it was saved. + -To save a plot definition, simply select Save or Save As... -(depending on whether or not you wish to save to a new file) from the File menu. Browse to -the location you wish to save the plot definition, enter a filename, and click Save. -The plot definition will be saved as a *.kst file. + Session files are loaded by: + + + + Selecting Open from the File menu. + + + + + Selecting one of the session files in the Recent Sessions submenu in the File menu. + + + + + + Selecting one of the sessions listed at the bottom of the File menu. + + + + + + using the commend line. For example: + kst2 sessionfile.kst + + + + + + + There are a few details to be aware of with sessions files: + + + + + + + Data read from data source files are not embedded in the kst session file. Instead, the file name and frame ranges are stored, and when the session is loaded, the data files are re-loaded from disk. If the the data source files have been moved or deleted, then loading will fail. If the contents of the data source files have changed, then the data loaded will be whatever is now in the data file. + + + + + + Vectors which have been created from numpy arrays through the python interface are embedded in the data file, so reloading the session reloads the vectors that have been copied through pyKst. + + + + + + The undo stack is cleared when a session file is loaded. + + + + + + When a session file is loaded, the current session is cleared. + + + + Exporting Vectors and Plots Vectors and plots in &kst; can be exported to files. This can be useful, for example, in capturing plots of live data or using generated vectors in a different application. Exporting Vectors To export or save a vector to a file, select Save Vectors to Disk... from the File menu. The vector will be saved as an ASCII data file. The single column of the file will contain the elements of the selected vector. See below for an example of an exported vector. 3776 5380 5245 2942 1861 2424 2520 1868 1736 1736 1174 499 Exporting Plots To export a &kst; plot to a graphics file, select Export to Graphics File... from the File menu. The following dialog box will appear. Export to Graphics File Export to Graphics File The following settings and options are available when saving: Save location The path to the graphics file. Enter a location manually, or click the button to right of the text box to browse to a location. File Format The format to use for the saved graphics file. PNG is suggested if you are not sure which format to use. Size Select the dimensions, in pixels, of the graphic. Check the Square option if you wish for the length and width of the graphic to be equal. Windows Select whether to export only the plots in the current window, or all plots. If All is selected, one graphics file will be created for each window, each with filename file_n.fmt, where file is the filename specified in Save location, n is an index number assigned to each window, and fmt is an extension representing the selected file format. Autosave Check this option if you want &kst; to automatically save the plot to the specified file on a specified time interval. Save interval The time interval used to perform autosave, in seconds. Click Save Once to immediately perform a save with the specified options and settings. Click Close to close the dialog box (autosave will still be performed at the specified intervals, if selected). Printing To print all the plots in the current window, select Print... from the File menu. A standard &kde; print dialog will be displayed. Some &kst;-specific options can be set by clicking on the Options >> button, and selecting the Kst Options tab. The options are: Append plot information to each page If selected, a footer showing page number, plot name and the date and time is printed on each page. Maintain aspect ratio If selected, the aspect ratio of the plots in the &kst; window is retained in the print output. If unselected, the plots are resized to fill the printed page in both directions. Print in monochrome If selected, the plot is printed in monochrome (black-and-white). If not, the colors of the on-screen plot are used. Curve width adjustment Adjusts the width of all curves in the printed output by this number of pixels relative to the width of the curve in the plot window. You can set a negative value to reduce the width of the curves in the print output.