diff --git a/doc/GraphicPostprocessing.tex b/doc/GraphicPostprocessing.tex index f619c0a4cb4f5043f626a896516a5eaedf85b373..752914acedb32aa89030e757b164785b24b5e39b 100644 --- a/doc/GraphicPostprocessing.tex +++ b/doc/GraphicPostprocessing.tex @@ -3,14 +3,9 @@ \def\iFM#1{\index{Frida!graphic file!#1 (PostScript macro)}\index{#1 (Frida PostScript macro)}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\section{Introduction to Graphics} +\section{Graphic files} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -The following notes describe how to post-process PostScript graphics files -generated by Frida, in order to obtain publication-grade figure. -These notes have grown out of an oral tutorial. -They will be gradually converted from slide-show format to written-manual style. - In Frida, two different methods are used to visualize data. For screen display in interactive sessions, Frida spawns a Gnuplot session. @@ -20,16 +15,12 @@ For saving graphics (command \T{gp}), Frida does \E{not} use Gnuplot's PostScript backend, but directly writes PostScript commands to a file. \index{PostScript!written by Frida}% -In the following, -the structure of this Frida-generated PostScript file is explained, -and it is shown how to embellish a plot by a few edits to this file. - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\section{Graphic formats, workflow} -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +In this chapter, +the structure of the Frida-generated PostScript file is explained, +and it is shown how to manually edit such files to obtain publication-grade graphics. %============================================================================== -\subsection{File formats} +\subsection{Graphic file formats} %============================================================================== Graphics can be stored in many different file formats. @@ -126,11 +117,11 @@ should be left in vector format throughout all postprocessing. %============================================================================== Within Frida, the commands \T{p} and \T{a} -\iFC{p} -\iFC{a} +\iFC{p}% +\iFC{a}% are used to plot data and curves. Commands starting with the letter \T{g} -\iFC{g\ldots} +\iFC{g\ldots}% allow to choose output windows, to set data ranges, and to modify other control parameters. Plot commands are sent from Frida to a Gnuplot process, @@ -141,14 +132,14 @@ Instead, Frida holds a complete copy of the graphics state and of all plotted data in memory. When the command \T{gp} or \T{gf} is issued, -\iFC{gp} -\iFC{gf} +\iFC{gp}% +\iFC{gf}% these data are used to generate a PostScript file \index{PostScript!written by Frida}% that contains essentially the same plot as the active Gnuplot window. The command \T{gp} saves a complete graphics file -\iFC{gp} +\iFC{gp}% as \url{l<number>.ps} in the preset graphics output directory (by default \url{~/gnew/}). For \url{number}, the lowest unused integer is chosen. @@ -156,7 +147,7 @@ The so obtained file can immediately be viewed, printed, and modified in a text editor. Alternatively, the command \T{gf} generates an incomplete graphic file \url{l<number>.psa} -\iFC{gf} +\iFC{gf}% that is lacking all macro definitions. Such a file is useful when when several Frida-generated plots shall be combined into one figure (\cref{Sconcat}). @@ -316,18 +307,6 @@ or to multiple of the expected final size, before being rasterized. \index{Raster graphics!conversion from vector format}% - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\section{Postprocessing Frida graphics}\label{SFridaPS} -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - -In \cref{SWorkflow} we saw \E{how} to modify a PostScript file in an -interactive edit session, -using a text editor and an image viewer side-by-side. -Let us now discuss \E{what} to modify in a Frida-generated PostScript graphic. -We start with a structural overview before we turn to single PostScript commands -that allow parameter changes or other modifications. - %============================================================================== \subsection{File structure} %============================================================================== @@ -406,8 +385,7 @@ in a comment block near the end of the setup section. %============================================================================== We now give a brief introduction to programming and plotting in PostScript, -and thereby provides a foundation for the following \cref{SFridaPS} about -editing Frida-generated PostScript code. +and thereby provide a foundation for the editing of Frida-generated PostScript code. PostScript was created around 1981, and got into wide-spread use thanks to consistent support by Apple diff --git a/doc/Introduction.tex b/doc/Introduction.tex index 64cc786dca20f1db0e58149686468503c626e81e..a382aad46cca8aa5cdf6e06d4158e6a27d586e99 100644 --- a/doc/Introduction.tex +++ b/doc/Introduction.tex @@ -2,8 +2,9 @@ \section{Introduction} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -Frida is a versatile data-analysis program. -From a command-line interface, it offers various methods to +Frida is a versatile data analysis program. +From a command line interface, +it offers numerous methods to visualize, manipulate and fit tabular data. Frida is especially designed for the analysis of spectral data, in particular from quasielastic neutron scattering (QENS). @@ -14,3 +15,6 @@ new features will be implemented occasionally, but development at large is stalled until a decision is taken which QENS software shall be institutionally supported at MLZ and partner institutes. + +This User Manual is a fragment: +A few topics are covered in depth, others are missing completely. diff --git a/doc/Title.tex b/doc/Title.tex index c0abf84c97b8b33caaa9d90ff01b4151baffd3ba..39ab8b20890cac287c75bd93e2833b95c3cb4411 100644 --- a/doc/Title.tex +++ b/doc/Title.tex @@ -12,7 +12,7 @@ {\bf Frida}\\[10mm] \huge {\bf User Manual}\\[10mm] -{\bf --- incomplete, work in progress ---}\\[10mm] +{\bf (incomplete preview, work in progress)}\\[10mm] \large Frida version \FridaVersionNumber\\ \today\\\vfill diff --git a/doc/UserManual.tex b/doc/UserManual.tex index 820a51829d88148f450f7e2cb4178623b3b6286a..7ce99637d1487637b5d8f78a180c4997f60aacc6 100644 --- a/doc/UserManual.tex +++ b/doc/UserManual.tex @@ -11,7 +11,7 @@ \def\E#1{\textsl{#1}} \def\T#1{\texttt{#1}} -\def\FridaVersionNumber{2.3.4d} +\def\FridaVersionNumber{2.3.5a} \begin{document} \flushbottom