Warning, /education/cantor/doc/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003 
0004   <!ENTITY latex "L<superscript>A</superscript>T<subscript>E</subscript>X">
0005   <!ENTITY % addindex "IGNORE">
0006   <!ENTITY % English "INCLUDE">
0007 ]>
0008 <book id="cantor" lang="&language;">
0009 
0010 <bookinfo>
0011 <title>The &cantor; Handbook</title>
0012 
0013 <authorgroup>
0014 <author>
0015 <personname>
0016 <firstname>Alexander</firstname>
0017 <surname>Rieder</surname>
0018 </personname>
0019 <email>alexanderrieder@gmail.com</email>
0020 </author>
0021 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0022 </authorgroup>
0023 
0024 <copyright>
0025 <year>2009</year>
0026 <holder>Alexander Rieder</holder>
0027 </copyright>
0028 <legalnotice>&FDLNotice;</legalnotice>
0029 
0030 <date>2023-11-29</date>
0031 <releaseinfo>Applications 23.08</releaseinfo>
0032 
0033 <abstract>
0034 <para>
0035 &cantor; is an application, aimed at providing a
0036 nice worksheet view to other Free Software Math packages.
0037 </para>
0038 </abstract>
0039 
0040 <keywordset>
0041 <keyword>KDE</keyword>
0042 <keyword>kdeedu</keyword>
0043 <keyword>mathematics</keyword>
0044 <keyword>math</keyword>
0045 <keyword>statistics</keyword>
0046 <keyword>Cantor</keyword>
0047 <keyword>Julia</keyword>
0048 <keyword>Lua</keyword>
0049 <keyword>Maxima</keyword>
0050 <keyword>Octave</keyword>
0051 <keyword>Python</keyword>
0052 <keyword>Qalculate</keyword>
0053 <keyword>R</keyword>
0054 <keyword>Sage</keyword>
0055 <keyword>Scilab</keyword>
0056 </keywordset>
0057 
0058 </bookinfo>
0059 
0060 <chapter id="introduction">
0061 <title>Introduction</title>
0062 
0063 <para>
0064 &cantor; is an application to allow you to you use your favorite
0065 mathematical applications from within an elegant &kde;-integrated
0066 Worksheet Interface. It provides dialogs to assist with common tasks
0067 and allows you to share your worksheets with others.
0068 </para>
0069 </chapter>
0070 
0071 <chapter id="using-kapp">
0072 <title>Using &cantor;</title>
0073 
0074 <para>
0075 Screenshot:
0076 <screenshot>
0077 <screeninfo>Here is a screenshot of &cantor;</screeninfo>
0078         <mediaobject>
0079           <imageobject>
0080             <imagedata fileref="screenshot.png" format="PNG"/>
0081           </imageobject>
0082           <textobject>
0083             <phrase>Screenshot</phrase>
0084           </textobject>
0085         </mediaobject>
0086 </screenshot>
0087 </para>
0088 
0089 
0090 <sect1 id="kapp-features">
0091 <title>&cantor; features</title>
0092 <itemizedlist>
0093   <listitem><para>Intuitive worksheet view for evaluating expressions.</para></listitem>
0094   <listitem><para>Results of graph plotting shown inside the worksheet.</para></listitem>
0095   <listitem><para>Easy plugin-based structure to allow different backends to be added.</para></listitem>
0096   <listitem><para>GetHotNewStuff integration to allow example worksheets to be downloaded (or uploaded).</para></listitem>
0097   <listitem><para>Mathematical formula typesetting using &latex;.</para></listitem>
0098   <listitem><para>Backend-aware syntax highlighting.</para></listitem>
0099   <listitem><para>Plugin-based assistant dialogs to help with common tasks, such as integrating a function, or entering a matrix.</para></listitem>
0100 </itemizedlist>
0101 </sect1>
0102 
0103 <sect1 id="backends">
0104 <title>The &cantor; backends</title>
0105 <para>
0106   &cantor; offers you several choices for the backends you wish to use with it.
0107   The choice to make depends on what you want to achieve.
0108 </para>
0109 <para>
0110   Currently the following backends are available:
0111   <variablelist>
0112     <varlistentry>
0113       <term>Sage:</term>
0114       <listitem>
0115         <para>
0116           Sage is a free open-source mathematics software system licensed under the GPL.
0117           It combines the power of many existing open-source packages, within a common Python-based interface.
0118           See <ulink url="https://sagemath.org">https://sagemath.org</ulink> for more information.
0119         </para>
0120         </listitem>
0121     </varlistentry>
0122     <varlistentry>
0123       <term>Maxima:</term>
0124       <listitem>
0125         <para>
0126           Maxima is a system for the manipulation of symbolic and numeric expressions,
0127           including differentiation, integration, Taylor series, Laplace transforms,
0128           ordinary differential equations, systems of linear equations, polynomials, sets,
0129           lists, vectors, matrices, and tensors. Maxima yields high-precision numeric results
0130           by using exact fractions, arbitrary precision integers, and variable precision
0131           floating point numbers. Maxima can plot functions and data in two and three dimensions.
0132           See <ulink url="http://maxima.sourceforge.net">http://maxima.sourceforge.net</ulink> for more information.
0133         </para>
0134       </listitem>
0135     </varlistentry>
0136     <varlistentry>
0137       <term>R:</term>
0138       <listitem>
0139         <para>
0140           R is a language and environment for statistical computing and graphics, similar to the S language and environment.
0141           It provides a wide variety of statistical (linear and nonlinear modelling,
0142           classical statistical tests, time-series analysis, classification, clustering, data science, ...)
0143           and graphical techniques, and is highly extensible. The S language is often the
0144           vehicle of choice for research in statistical methodology,
0145           and R provides an open-source route to this.
0146           See <ulink url="https://www.r-project.org">https://www.r-project.org</ulink> for more information.
0147         </para>
0148       </listitem>
0149     </varlistentry>
0150     <varlistentry>
0151       <term>Julia:</term>
0152       <listitem>
0153         <para>
0154     Julia is a high-level, high-performance, general-purpose dynamic programming
0155     language for technical computing, with syntax that is familiar to users of
0156     other technical computing environments. It provides a sophisticated
0157     compiler, distributed parallel execution, numerical accuracy, and an
0158     extensive mathematical function library.
0159           See <ulink url="https://julialang.org/">Julia website</ulink> for more information.
0160         </para>
0161       </listitem>
0162     </varlistentry>
0163     <varlistentry>
0164       <term>&kalgebra;:</term>
0165       <listitem>
0166         <para>
0167           &kalgebra; is a MathML-based graph calculator, that ships with &kde; Education project.
0168           See <ulink url="https://edu.kde.org/kalgebra/">https://edu.kde.org/kalgebra/</ulink> for more information.
0169           </para>
0170       </listitem>
0171     </varlistentry>
0172     <varlistentry>
0173       <term>Qalculate!:</term>
0174       <listitem>
0175   <para>
0176     Qalculate! is not your regular software replication of the cheapest
0177     available calculator. Qalculate! aims to make full use of the superior
0178     interface, power and flexibility of modern computers. The center of
0179     attention in Qalculate! is the expression entry. Instead of entering each
0180     number in a mathematical expression separately, you can directly write the
0181     whole expression and later modify it. The interpretation of expressions is
0182     flexible and fault tolerant, and if you nevertheless do something wrong,
0183     Qalculate! will tell you so. Not fully solvable expressions are however not
0184     errors. Qalculate! will simplify as far as it can and answer with an
0185     expression. In addition to numbers and arithmetic operators, an expression
0186     may contain any combination of variables, units, and functions.
0187     See <ulink url="https://qalculate.github.io/">https://qalculate.github.io/</ulink> for more information.
0188   </para>
0189   </listitem>
0190     </varlistentry>
0191     <varlistentry>
0192       <term>Python2 and Python3:</term>
0193       <listitem>
0194   <para>
0195     Python is a remarkably powerful dynamic programming language that is used
0196 in a wide variety of application domains. There are several Python packages
0197 to scientific programming.
0198   </para>
0199   <para>Python is distributed under Python Software Foundation license (GPL compatible).
0200     See the <ulink url="https://www.python.org/">official website</ulink> for more information.
0201   </para>
0202   <note>
0203     <para>
0204       This backend adds an additional item to the &cantor;'s main menu, <guimenu>Package</guimenu>. The only item of this menu is <menuchoice><guimenu>Package</guimenu><guimenuitem>Import Package</guimenuitem></menuchoice>. This item can be used to import Python packages to the worksheet.
0205     </para>
0206   </note>
0207     </listitem>
0208     </varlistentry>
0209     <varlistentry>
0210       <term>Scilab:</term>
0211       <listitem>
0212   <para>
0213     Scilab is an free software, cross-platform numerical computational package
0214     and a high-level, numerically oriented programming language.
0215   </para>
0216   <para>Scilab is distributed under CeCILL license (GPL compatible).
0217     See <ulink url="https://www.scilab.org/">https://www.scilab.org/</ulink> for more information.
0218   </para>
0219   <warning>
0220     <para>
0221       You need Scilab version 5.5 or higher to be installed in your system to make this backend usable.
0222     </para>
0223   </warning>
0224   </listitem>
0225     </varlistentry>
0226     <varlistentry>
0227       <term>Octave:</term>
0228       <listitem>
0229   <para>
0230     &GNU; Octave is a high-level language, primarily intended for numerical
0231     computations. It provides a convenient command line interface for
0232     solving linear and nonlinear problems numerically, and for performing other
0233     numerical experiments using a language that is mostly compatible with <ulink url="https://www.mathworks.com/products/matlab.html">MATLAB</ulink>.
0234     See <ulink url="https://octave.org/">https://octave.org/</ulink> for more information.
0235     </para>
0236       </listitem>
0237     </varlistentry>
0238     <varlistentry>
0239       <term>Lua:</term>
0240       <listitem>
0241   <para>
0242     Lua is a fast and lightweight scripting language, with a simple procedural syntax. There are several libraries in Lua aimed at math and science.
0243   </para>
0244   <para>
0245     See <ulink url="https://www.lua.org/">https://www.lua.org/</ulink> for more information.
0246   </para>
0247   <para>
0248     This backend supports <ulink url="https://luajit.org/">LuaJIT 2</ulink>.
0249   </para>
0250       </listitem>
0251     </varlistentry>
0252   </variablelist>
0253 </para>
0254 </sect1>
0255 
0256 <sect1 id="workspace">
0257 <title>The &cantor; Workspace</title>
0258 <para>
0259 <screenshot>
0260   <screeninfo>Screenshot of the &cantor; Workspace</screeninfo>
0261   <mediaobject>
0262     <imageobject>
0263       <imagedata fileref="screenshot.png" format="PNG"/>
0264     </imageobject>
0265     <textobject>
0266       <phrase>Screenshot of the &cantor; Workspace</phrase>
0267     </textobject>
0268   </mediaobject>
0269 </screenshot>
0270 </para>
0271 <para>
0272   The Worksheet interface of &cantor; consists of three parts:
0273   <orderedlist>
0274     <listitem><para>The tab bar, where you can switch through the open worksheets.</para></listitem>
0275     <listitem><para>A help panel, where help for a specific command is displayed if you enter <userinput>?? <replaceable>command</replaceable></userinput>, <userinput>describe(<replaceable>command</replaceable>)</userinput> or <userinput>example(<replaceable>command</replaceable>)</userinput> (<application>Maxima</application> backend).</para></listitem>
0276     <listitem><para>A Variable Manager panel where you can see the list of all available variables on the current worksheet. The Help and Variable Manager panels are shown as tabs on a sidebar of a &cantor; window. Variable manager can be used for Maxima (if enabled on <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &cantor;...</guimenuitem></menuchoice> <guilabel>Maxima</guilabel> page), &kalgebra;, Octave, Python2, Python3, Qalculate, and Scilab backends only.</para></listitem>
0277     <listitem><para>The worksheet itself.</para></listitem>
0278   </orderedlist>
0279 </para>
0280 <sect2 id="worksheet">
0281 <title>The Worksheet</title>
0282 <para>
0283   The worksheet is the basic area for working with &cantor;.  Using it, you can enter
0284   expressions, allow the backend to perform calculations, and look at the results.
0285   The commands the worksheets accept depend on the chosen backend, so you should
0286   learn the appropriate backend syntax (the <guibutton>Show Help</guibutton> button takes you there directly).
0287   If you know the command, but you need additional information, you can type "? <replaceable>command</replaceable>",
0288   and contextual help will appear on the right of the worksheet.
0289   If you want to see some example worksheets, you can go to <menuchoice><guimenu>File</guimenu><guimenuitem>Download Example Worksheets</guimenuitem></menuchoice> menu item, and download worksheets other users have published.
0290 </para>
0291 <para>
0292   To control each command entry of the worksheet you can use control buttons shown at the right part of the worksheet when hovering the entry field with a mouse cursor. There are three basic actions for each entry: <guilabel>Evaluate Entry</guilabel> to update the result of calculations for the entry, <guilabel>Drag Entry</guilabel> to move the entry at the other place of the current worksheet and <guilabel>Remove Entry</guilabel> to remove the entry from the current worksheet.
0293 </para>
0294 <para>
0295   Font settings and alignment of worksheet entries can be changed using a toolbar above the worksheet.
0296 </para>
0297 <sect3 id="worksheet-settings">
0298   <title>Settings</title>
0299   <para>
0300     The <guimenu>Settings</guimenu> menu allows you to change some settings of the appearance of your
0301     current worksheet.
0302   </para>
0303   <variablelist>
0304     <varlistentry>
0305       <term>Typeset using LaTeX</term>
0306       <listitem>
0307         <para>
0308           This setting changes the way results are presented to you. If enabled, it passes the result through
0309           the &latex; system, to produce visually appealing formulas. For example, <quote>3*x^2*sqrt(2)*x+2/3</quote> becomes
0310           <inlinemediaobject>
0311               <imageobject>
0312                 <imagedata fileref="latex_formula.png" format="PNG"/>
0313               </imageobject>
0314               <textobject><phrase>3*x^2*sqrt(2)*x+2/3</phrase></textobject>
0315           </inlinemediaobject>
0316         </para>
0317       </listitem>
0318     </varlistentry>
0319     <varlistentry>
0320       <term>Syntax Highlighting</term>
0321       <listitem>
0322         <para>
0323           Syntax Highlighting increases the readability of code, by highlighting
0324           keywords, or matching brackets in different colors.
0325         </para>
0326       </listitem>
0327     </varlistentry>
0328     <varlistentry>
0329       <term>Completion</term>
0330       <listitem>
0331         <para>
0332           When this is enabled, &cantor; will show you possible completions
0333           for the command you are currently typing when you press the Tab-key. If there is only one choice
0334           remaining, it will insert the rest of the command for you.
0335         </para>
0336       </listitem>
0337     </varlistentry>
0338   <varlistentry>
0339     <term>Line Numbers</term>
0340     <listitem>
0341       <para>
0342         This setting controls whether the different expressions should have a number in front.  This allows you
0343         to recall older results - in Maxima, for instance, this is done with the <quote>%O1</quote> command.
0344       </para>
0345     </listitem>
0346   </varlistentry>
0347   <varlistentry>
0348     <term>Animate Worksheet</term>
0349     <listitem>
0350       <para>
0351   This setting controls whether the different animations will be used to highlight changes on a worksheet.
0352       </para>
0353     </listitem>
0354   </varlistentry>
0355   <varlistentry>
0356     <term>Embedded Math</term>
0357     <listitem>
0358       <para>
0359   This setting controls whether rendering math expressions inside <literal>$$..$$</literal> in Text and &Markdown; entries is enabled by default (needs <application>pdflatex</application> installed).
0360       </para>
0361     </listitem>
0362   </varlistentry>
0363   </variablelist>
0364 </sect3>
0365 </sect2>
0366 </sect1>
0367 <sect1 id="assistant-dlgs">
0368 <title>The assistant dialogs</title>
0369 <para>
0370 There are several assistant dialogs implemented in &cantor; to alleviate some basic operations.
0371 </para>
0372 <para>
0373 These dialogs can be accessed using the main menu items. Each backend has its own assistant dialogs.
0374 </para>
0375 <sect2 id="create-matrix-dlg">
0376 <title>The Create Matrix dialog</title>
0377 <screenshot>
0378   <screeninfo>Screenshot of the &cantor; matrix creation dialog</screeninfo>
0379   <mediaobject>
0380     <imageobject>
0381       <imagedata fileref="create-dlg.png" format="PNG"/>
0382     </imageobject>
0383     <textobject>
0384       <phrase>Screenshot of the &cantor; matrix creation dialog</phrase>
0385     </textobject>
0386   </mediaobject>
0387 </screenshot>
0388 <para>
0389 This dialog can be used to input matrices. You can define matrix dimensions and its elements.
0390 </para>
0391 <para>
0392 It is possible to navigate between cells quickly during input using the &Tab; key.
0393 </para>
0394 </sect2>
0395 <sect2 id="compute-invert-dlg">
0396 <title>Matrix operation dialog</title>
0397 <screenshot>
0398   <screeninfo>Screenshot of the &cantor; matrix input dialog</screeninfo>
0399   <mediaobject>
0400     <imageobject>
0401       <imagedata fileref="matrix-dlg.png" format="PNG"/>
0402     </imageobject>
0403     <textobject>
0404       <phrase>Screenshot of the &cantor; matrix input dialog</phrase>
0405     </textobject>
0406   </mediaobject>
0407 </screenshot>
0408 <para>
0409 This dialog allows entering name of the matrix to compute its eigenvectors, eigenvalues or invert matrix. The default value (<userinput>%</userinput>) is used to refer to the previous result of calculation or input.
0410 </para>
0411 </sect2>
0412 <sect2 id="calculate-derivative-dlg">
0413 <title>Differentiation dialog</title>
0414 <screenshot>
0415   <screeninfo>Screenshot of the &cantor; differentiation dialog</screeninfo>
0416   <mediaobject>
0417     <imageobject>
0418       <imagedata fileref="differentiate-dlg.png" format="PNG"/>
0419     </imageobject>
0420     <textobject>
0421       <phrase>Screenshot of the &cantor; differentiation dialog</phrase>
0422     </textobject>
0423   </mediaobject>
0424 </screenshot>
0425 <para>
0426 This dialog allows entering expression of the function to differentiate, the name of the variable and the order of derivative.
0427 </para>
0428 </sect2>
0429 <sect2 id="calculate-integral-dlg">
0430 <title>Integration dialog</title>
0431 <screenshot>
0432   <screeninfo>Screenshot of the &cantor; integration dialog</screeninfo>
0433   <mediaobject>
0434     <imageobject>
0435       <imagedata fileref="integrate-dlg.png" format="PNG"/>
0436     </imageobject>
0437     <textobject>
0438       <phrase>Screenshot of the &cantor; integration dialog</phrase>
0439     </textobject>
0440   </mediaobject>
0441 </screenshot>
0442 <para>
0443 This dialog allows entering expression of the function to integrate, the name of the variable and the limits of integration (for the definite integral).
0444 </para>
0445 </sect2>
0446 <sect2 id="calculate-solve-dlg">
0447 <title>Solve equations dialog</title>
0448 <screenshot>
0449   <screeninfo>Screenshot of the &cantor; solve equation dialog</screeninfo>
0450   <mediaobject>
0451     <imageobject>
0452       <imagedata fileref="solve-equations-dlg.png" format="PNG"/>
0453     </imageobject>
0454     <textobject>
0455       <phrase>Screenshot of the &cantor; solve equation dialog</phrase>
0456     </textobject>
0457   </mediaobject>
0458 </screenshot>
0459 <para>
0460 This dialog allows entering equations to solve (each equation in a separate line) and the variables to determine (separated by the comma).
0461 </para>
0462 </sect2>
0463 <sect2 id="package-import-dlg">
0464 <title>Package import dialog</title>
0465 <screenshot>
0466   <screeninfo>Screenshot of the &cantor; package import dialog</screeninfo>
0467   <mediaobject>
0468     <imageobject>
0469       <imagedata fileref="import-dlg.png" format="PNG"/>
0470     </imageobject>
0471     <textobject>
0472       <phrase>Screenshot of the &cantor; package import dialog</phrase>
0473     </textobject>
0474   </mediaobject>
0475 </screenshot>
0476 <para>
0477 This dialog allows entering name of the package to import (&eg; <userinput>numpy</userinput> for Python).
0478 </para>
0479 </sect2>
0480 <sect2 id="plot-dlg">
0481 <title>Plot dialog</title>
0482 <screenshot>
0483   <screeninfo>Screenshot of the &cantor; plot dialog (Functions tab)</screeninfo>
0484   <mediaobject>
0485     <imageobject>
0486       <imagedata fileref="plot-dlg1.png" format="PNG"/>
0487     </imageobject>
0488     <textobject>
0489       <phrase>Screenshot of the &cantor; plot dialog (Functions tab)</phrase>
0490     </textobject>
0491   </mediaobject>
0492 </screenshot>
0493 <para>
0494 The options of this dialog are separated into two groups using tabs. The <guilabel>Functions</guilabel> tab allows entering functions to plot.
0495 </para>
0496 <para>
0497 To enter new function click on the <guibutton>Add</guibutton>. Double-click on the <guilabel>Title</guilabel> cell and enter the title, then double-click on the <guilabel>Expression</guilabel> cell and enter the function expression.
0498 </para>
0499 <screenshot>
0500   <screeninfo>Screenshot of the &cantor; plot dialog (Options tab)</screeninfo>
0501   <mediaobject>
0502     <imageobject>
0503       <imagedata fileref="plot-dlg2.png" format="PNG"/>
0504     </imageobject>
0505     <textobject>
0506       <phrase>Screenshot of the &cantor; plot dialog (Options tab)</phrase>
0507     </textobject>
0508   </mediaobject>
0509 </screenshot>
0510 <para>
0511 The <guilabel>Options</guilabel> tab is used to define plot and legend options. You can fine-tune almost every plot option to obtain the pleasant look of your figure.
0512 </para>
0513 </sect2>
0514 <sect2 id="plot2d-dlg">
0515 <title>Plot 2D dialog</title>
0516 <screenshot>
0517   <screeninfo>Screenshot of the &cantor; plot 2D dialog</screeninfo>
0518   <mediaobject>
0519     <imageobject>
0520       <imagedata fileref="plot2d-dlg.png" format="PNG"/>
0521     </imageobject>
0522     <textobject>
0523       <phrase>Screenshot of the &cantor; plot 2D dialog</phrase>
0524     </textobject>
0525   </mediaobject>
0526 </screenshot>
0527 <para>
0528 This dialog allows entering expression of the function, its variable and the limits for this variable.
0529 </para>
0530 </sect2>
0531 <sect2 id="plot3d-dlg">
0532 <title>Plot 3D dialog</title>
0533 <screenshot>
0534   <screeninfo>Screenshot of the &cantor; plot 3D dialog</screeninfo>
0535   <mediaobject>
0536     <imageobject>
0537       <imagedata fileref="plot3d-dlg.png" format="PNG"/>
0538     </imageobject>
0539     <textobject>
0540       <phrase>Screenshot of the &cantor; plot 3D dialog</phrase>
0541     </textobject>
0542   </mediaobject>
0543 </screenshot>
0544 <para>
0545 This dialog allows entering expression of the function, its variables and the limits for each variable.
0546 </para>
0547 </sect2>
0548 </sect1>
0549 </chapter>
0550 
0551 <chapter id="commands">
0552 <title>Command Reference</title>
0553 
0554 <sect1 id="kapp-mainwindow">
0555 <title>The main &cantor; window</title>
0556 
0557 <para>
0558 &cantor; has the common &kde; menu items, for more information read the <ulink url="help:/fundamentals/menus.html"
0559 >Menu</ulink> chapter of the &kde; Fundamentals.
0560 </para>
0561 
0562 <para>Below is the list of the additional or special menu items in &cantor;. Please note that some menus are only shown for backends that have corresponding implementation.
0563 </para>
0564 
0565 <sect2 id="file-menu">
0566 <title>The File Menu</title>
0567 <para>
0568 <variablelist>
0569 <varlistentry>
0570 <term><menuchoice>
0571 <shortcut>
0572 <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
0573 </shortcut>
0574 <guimenu>File</guimenu>
0575 <guimenuitem>New</guimenuitem>
0576 </menuchoice></term>
0577 <listitem><para><action>Creates a new worksheet with the default backend.</action></para></listitem>
0578 </varlistentry>
0579 <varlistentry>
0580 <term><menuchoice>
0581 <guimenu>File</guimenu>
0582 <guisubmenu>New</guisubmenu>
0583 <guimenuitem><replaceable>Backend</replaceable></guimenuitem>
0584 </menuchoice></term>
0585 <listitem><para><action>Creates a new worksheet with the chosen backend.</action></para></listitem>
0586 </varlistentry>
0587 <varlistentry>
0588 <term><menuchoice>
0589 <shortcut>
0590 <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
0591 </shortcut>
0592 <guimenu>File</guimenu>
0593 <guimenuitem>Open...</guimenuitem>
0594 </menuchoice></term>
0595 <listitem><para><action>Open a supported new worksheet with the file dialog.</action></para></listitem>
0596 </varlistentry>
0597 <varlistentry>
0598 <term><menuchoice>
0599 <guimenu>File</guimenu>
0600 <guisubmenu>Open Recent</guisubmenu>
0601 </menuchoice></term>
0602 <listitem><para><action>Choose a worksheet from a list of recently used files.</action></para></listitem>
0603 </varlistentry>
0604 <varlistentry>
0605 <term><menuchoice>
0606 <guimenu>File</guimenu>
0607 <guimenuitem>Download Example Worksheets</guimenuitem>
0608 </menuchoice></term>
0609 <listitem><para><action>Opens the dialog to download examples uploaded by other &cantor; users with
0610  <ulink url="https://userbase.kde.org/Special:MyLanguage/Glossary#Get_Hot_New_Stuff">GetHotNewStuff</ulink>.</action></para></listitem>
0611 </varlistentry>
0612 <varlistentry>
0613 <term><menuchoice>
0614 <guimenu>File</guimenu>
0615 <guimenuitem>Open Example</guimenuitem>
0616 </menuchoice></term>
0617 <listitem><para><action>Opens the dialog to choose an example to load.</action> The examples should be downloaded with <menuchoice><guimenu>File</guimenu>
0618 <guimenuitem>Download Example Worksheets</guimenuitem></menuchoice> beforehand.</para></listitem>
0619 </varlistentry>
0620 <varlistentry>
0621 <term><menuchoice>
0622 <guimenu>File</guimenu>
0623 <guimenuitem>Save Plain Text</guimenuitem>
0624 </menuchoice></term>
0625 <listitem><para><action>Allows saving the current worksheet as a plain text document.</action></para></listitem>
0626 </varlistentry>
0627 <varlistentry>
0628 <term><menuchoice>
0629 <guimenu>File</guimenu>
0630 <guimenuitem>Export to LaTeX</guimenuitem>
0631 </menuchoice></term>
0632 <listitem><para><action>Allows saving the current worksheet as a &latex; document.</action></para></listitem>
0633 </varlistentry>
0634 <varlistentry>
0635 <term><menuchoice>
0636 <guimenu>File</guimenu>
0637 <guimenuitem>Publish Worksheet</guimenuitem>
0638 </menuchoice></term>
0639 <listitem><para><action>Opens the dialog to publish your current worksheet and make it available to other &cantor; users through
0640  <ulink url="https://userbase.kde.org/Special:MyLanguage/Glossary#Get_Hot_New_Stuff">GetHotNewStuff</ulink>.</action></para></listitem>
0641 </varlistentry>
0642 <varlistentry>
0643 <term><menuchoice>
0644 <guimenu>File</guimenu>
0645 <guimenuitem>Run Script</guimenuitem>
0646 </menuchoice></term>
0647 <listitem><para><action>Allows to load and run the batch scripts for the current backend.</action></para></listitem>
0648 </varlistentry>
0649 </variablelist>
0650 </para>
0651 
0652 </sect2>
0653 
0654 <sect2 id="view-menu">
0655 <title>The View Menu</title>
0656 <para>
0657 <variablelist>
0658 <varlistentry>
0659 <term><menuchoice><guimenu>View</guimenu><guisubmenu>Panels</guisubmenu></menuchoice></term>
0660 <listitem><para>Allows you to toggle the visibility of some tabs in the sidebar. Choices are:
0661 <variablelist>
0662   <varlistentry>
0663   <term><guimenuitem>File Browser</guimenuitem></term>
0664   <listitem><para><action>Toggles</action> the visibility of the <guilabel>File Browser</guilabel> tab in the sidebar.</para></listitem>
0665   </varlistentry>
0666 
0667   <varlistentry>
0668   <term><guimenuitem>Help</guimenuitem></term>
0669   <listitem><para><action>Toggles</action> the visibility of the <guilabel>Help</guilabel> tab in the sidebar.</para></listitem>
0670   </varlistentry>
0671 
0672   <varlistentry>
0673   <term><guimenuitem>Variable Manager</guimenuitem></term>
0674   <listitem><para><action>Toggles</action> the visibility of the <guilabel>Variable Manager</guilabel> tab in the sidebar.</para></listitem>
0675   </varlistentry>
0676 </variablelist></para></listitem>
0677 </varlistentry>
0678 <varlistentry>
0679 <term><menuchoice>
0680 <shortcut>
0681 <keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>
0682 </shortcut>
0683 <guimenu>View</guimenu>
0684 <guimenuitem>Zoom In</guimenuitem>
0685 </menuchoice></term>
0686 <listitem><para><action>Zoom in</action> the current worksheet by 10%.</para></listitem>
0687 </varlistentry>
0688 <varlistentry>
0689 <term><menuchoice>
0690 <shortcut>
0691 <keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo>
0692 </shortcut>
0693 <guimenu>View</guimenu>
0694 <guimenuitem>Zoom Out</guimenuitem>
0695 </menuchoice></term>
0696 <listitem><para><action>Zoom out</action> the current worksheet by 10%.</para></listitem>
0697 </varlistentry>
0698 <varlistentry>
0699 <term><menuchoice>
0700 <guimenu>View</guimenu>
0701 <guimenuitem>Show Script Editor</guimenuitem>
0702 </menuchoice></term>
0703 <listitem><para><action>Opens the batch script editor window for the current backend.</action></para></listitem>
0704 </varlistentry>
0705 </variablelist>
0706 </para>
0707 </sect2>
0708 
0709 <sect2 id="worsheet-menu">
0710 <title>The Worksheet Menu</title>
0711 <para>
0712 <variablelist>
0713 <varlistentry>
0714 <term><menuchoice>
0715 <shortcut>
0716 <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>
0717 </shortcut>
0718 <guimenu>Worksheet</guimenu>
0719 <guimenuitem>Evaluate Worksheet</guimenuitem>
0720 </menuchoice></term>
0721 <listitem><para><action>Triggers</action> the evaluation of the whole worksheet.</para></listitem>
0722 </varlistentry>
0723 <varlistentry>
0724 <term><menuchoice>
0725 <shortcut>
0726 <keycombo action="simul">&Shift;&Enter;</keycombo>
0727 </shortcut>
0728 <guimenu>Worksheet</guimenu>
0729 <guimenuitem>Evaluate Entry</guimenuitem>
0730 </menuchoice></term>
0731 <listitem><para><action>Triggers</action> the current entry evaluation.</para></listitem>
0732 </varlistentry>
0733 <varlistentry>
0734 <term><menuchoice>
0735 <shortcut>
0736 <keycombo action="simul">&Ctrl;&Enter;</keycombo>
0737 </shortcut>
0738 <guimenu>Worksheet</guimenu>
0739 <guimenuitem>Insert Command Entry</guimenuitem>
0740 </menuchoice></term>
0741 <listitem><para><action>Inserts a new command entry below the current cursor position.</action></para></listitem>
0742 </varlistentry>
0743 <varlistentry>
0744 <term><menuchoice>
0745 <guimenu>Worksheet</guimenu>
0746 <guimenuitem>Insert Text Entry</guimenuitem>
0747 </menuchoice></term>
0748 <listitem><para><action>Inserts a new text entry below the current cursor position.</action></para></listitem>
0749 </varlistentry>
0750 <varlistentry>
0751 <term><menuchoice>
0752 <guimenu>Worksheet</guimenu>
0753 <guimenuitem>Insert Markdown Entry</guimenuitem>
0754 </menuchoice></term>
0755 <listitem><para><action>Inserts a &Markdown; entry below the current cursor position.</action>.</para></listitem>
0756 </varlistentry>
0757 <varlistentry>
0758 <term><menuchoice>
0759 <guimenu>Worksheet</guimenu>
0760 <guimenuitem>Insert LaTeX Entry</guimenuitem>
0761 </menuchoice></term>
0762 <listitem><para><action>Inserts a &latex; entry below the current cursor position.</action>.</para></listitem>
0763 </varlistentry>
0764 <varlistentry>
0765 <term><menuchoice>
0766 <guimenu>Worksheet</guimenu>
0767 <guimenuitem>Insert Image</guimenuitem>
0768 </menuchoice></term>
0769 <listitem><para><action>Inserts an image below the current cursor position.</action></para></listitem>
0770 </varlistentry>
0771 <varlistentry>
0772 <term><menuchoice>
0773 <guimenu>Worksheet</guimenu>
0774 <guimenuitem>Insert Page Break</guimenuitem>
0775 </menuchoice></term>
0776 <listitem><para><action>Inserts the page break below the current cursor position.</action></para></listitem>
0777 </varlistentry>
0778 <varlistentry>
0779 <term><menuchoice>
0780 <guimenu>Worksheet</guimenu>
0781 <guimenuitem>Collapse All Results</guimenuitem>
0782 </menuchoice></term>
0783 <listitem><para><action>Collapse all results of the command entry.</action></para></listitem>
0784 </varlistentry>
0785 <varlistentry>
0786 <term><menuchoice>
0787 <guimenu>Worksheet</guimenu>
0788 <guimenuitem>Expand All Results</guimenuitem>
0789 </menuchoice></term>
0790 <listitem><para><action>Expand all results of the command entry.</action></para></listitem>
0791 </varlistentry>
0792 <varlistentry>
0793 <term><menuchoice>
0794 <guimenu>Worksheet</guimenu>
0795 <guimenuitem>Remove All Results</guimenuitem>
0796 </menuchoice></term>
0797 <listitem><para><action>Remove all results of the command entry.</action></para></listitem>
0798 </varlistentry>
0799 <varlistentry>
0800 <term><menuchoice>
0801 <shortcut>
0802 <keycombo action="simul">&Shift;&Del;</keycombo>
0803 </shortcut>
0804 <guimenu>Worksheet</guimenu>
0805 <guimenuitem>Remove current Entry</guimenuitem>
0806 </menuchoice></term>
0807 <listitem><para><action>Removes</action> current entry from the worksheet.</para></listitem>
0808 </varlistentry>
0809 </variablelist>
0810 </para>
0811 </sect2>
0812 
0813 <sect2 id="linear-algebra-menu">
0814 <title>The Linear Algebra Menu</title>
0815 <para>
0816 <variablelist>
0817 <varlistentry>
0818 <term><menuchoice>
0819 <guimenu>Linear Algebra</guimenu>
0820 <guimenuitem>Create Matrix</guimenuitem>
0821 </menuchoice></term>
0822 <listitem><para><action>Opens</action> the <link linkend="create-matrix-dlg">matrix creation assistant dialog</link>.</para></listitem>
0823 </varlistentry>
0824 <varlistentry>
0825 <term><menuchoice>
0826 <guimenu>Linear Algebra</guimenu>
0827 <guimenuitem>Compute Eigenvalues</guimenuitem>
0828 </menuchoice></term>
0829 <listitem><para><action>Opens</action> the <link linkend="compute-invert-dlg">matrix name input assistant dialog</link> to compute its eigenvalues and dimensions of the multiplicities of the eigenvalues in the corresponding order.
0830 </para></listitem>
0831 </varlistentry>
0832 <varlistentry>
0833 <term><menuchoice>
0834 <guimenu>Linear Algebra</guimenu>
0835 <guimenuitem>Compute Eigenvectors</guimenuitem>
0836 </menuchoice></term>
0837 <listitem><para><action>Opens</action> the <link linkend="compute-invert-dlg">matrix name input assistant dialog</link> to compute its eigenvalues, dimensions of the multiplicities of the eigenvalues and eigenvectors in the corresponding order.
0838 </para></listitem>
0839 </varlistentry>
0840 <varlistentry>
0841 <term><menuchoice>
0842 <guimenu>Linear Algebra</guimenu>
0843 <guimenuitem>Invert Matrix</guimenuitem>
0844 </menuchoice></term>
0845 <listitem><para><action>Opens</action> the <link linkend="compute-invert-dlg">matrix name input assistant dialog</link> to find the inverse of the matrix.
0846 </para></listitem>
0847 </varlistentry>
0848 </variablelist>
0849 </para>
0850 </sect2>
0851 
0852 <sect2 id="calculate-menu">
0853 <title>The Calculate Menu</title>
0854 <para>
0855 <variablelist>
0856 <varlistentry>
0857 <term><menuchoice>
0858 <guimenu>Calculate</guimenu>
0859 <guimenuitem>Differentiate</guimenuitem>
0860 </menuchoice></term>
0861 <listitem><para><action>Opens</action> the <link linkend="calculate-derivative-dlg">differentiation parameters dialog</link>.
0862 </para></listitem>
0863 </varlistentry>
0864 <varlistentry>
0865 <term><menuchoice>
0866 <guimenu>Calculate</guimenu>
0867 <guimenuitem>Integrate</guimenuitem>
0868 </menuchoice></term>
0869 <listitem><para><action>Opens</action> the <link linkend="calculate-integral-dlg">integration parameters dialog</link>.
0870 </para></listitem>
0871 </varlistentry>
0872 <varlistentry>
0873 <term><menuchoice>
0874 <guimenu>Calculate</guimenu>
0875 <guimenuitem>Solve equations</guimenuitem>
0876 </menuchoice></term>
0877 <listitem><para><action>Opens</action> the <link linkend="calculate-solve-dlg">parameters input dialog</link> to solve linear and non-linear equations.
0878 </para></listitem>
0879 </varlistentry>
0880 </variablelist>
0881 </para>
0882 </sect2>
0883 
0884 <sect2 id="package-menu">
0885 <title>The Package Menu</title>
0886 <para>
0887 <variablelist>
0888 <varlistentry>
0889 <term><menuchoice>
0890 <guimenu>Package</guimenu>
0891 <guimenuitem>Import Package</guimenuitem>
0892 </menuchoice></term>
0893 <listitem><para><action>Opens</action> the <link linkend="package-import-dlg">package import dialog</link>.
0894 </para></listitem>
0895 </varlistentry>
0896 </variablelist>
0897 </para>
0898 </sect2>
0899 
0900 <sect2 id="plot-menu">
0901 <title>The Plot Menu</title>
0902 <para>
0903 <variablelist>
0904 <varlistentry>
0905 <term><menuchoice>
0906 <guimenu>Plot</guimenu>
0907 <guimenuitem>Plot</guimenuitem>
0908 </menuchoice></term>
0909 <listitem><para><action>Opens</action> the <link linkend="plot-dlg">plot parameters dialog</link>.
0910 </para></listitem>
0911 </varlistentry>
0912 <varlistentry>
0913 <term><menuchoice>
0914 <guimenu>Plot</guimenu>
0915 <guimenuitem>Plot 2D</guimenuitem>
0916 </menuchoice></term>
0917 <listitem><para><action>Opens</action> the <link linkend="plot2d-dlg">plot parameters dialog</link>.
0918 </para></listitem>
0919 </varlistentry>
0920 <varlistentry>
0921 <term><menuchoice>
0922 <guimenu>Plot</guimenu>
0923 <guimenuitem>Plot 3D</guimenuitem>
0924 </menuchoice></term>
0925 <listitem><para><action>Opens</action> the <link linkend="plot3d-dlg">plot parameters dialog</link>.
0926 </para></listitem>
0927 </varlistentry>
0928 </variablelist>
0929 </para>
0930 </sect2>
0931 
0932 <sect2 id="settings-help-menu">
0933 <title>The Settings and Help Menu</title>
0934 <para>
0935 &cantor; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
0936 menu items, for more information read the sections about the <ulink
0937 url="help:/fundamentals/menus.html#menus-settings">Settings Menu</ulink> and
0938 <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
0939 of the &kde; Fundamentals.
0940 </para>
0941 
0942 </sect2>
0943 
0944 </sect1>
0945 </chapter>
0946 
0947 <chapter id="faq">
0948 <title>Questions and Answers</title>
0949 
0950 <qandaset id="faqlist">
0951 <qandaentry>
0952   <question><para>The Menu Item <guimenuitem>Typeset using LaTeX</guimenuitem> is not available</para></question>
0953   <answer><para>Not every backend supports every option. Current version supports &latex; output for Maxima, Qalculate! and Sage backends.</para></answer>
0954 </qandaentry>
0955 <qandaentry>
0956   <question><para>I have installed Sage/Maxima or other supported CAS, but the appropriate backend does not appear.</para></question>
0957   <answer>
0958     <para>
0959       One possible explanation is that &cantor; did not correctly detect the location. Go to the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &cantor;...</guimenuitem></menuchoice> dialog and change
0960       the <guilabel>Path</guilabel> to the appropriate application on the backend's page.
0961     </para>
0962   </answer>
0963 </qandaentry>
0964 <qandaentry>
0965   <question><para>What a peculiar name - what does it have to do with mathematics?</para></question>
0966   <answer><para>&cantor; is named after the German mathematician <ulink url="https://en.wikipedia.org/wiki/Georg_Cantor">Georg Cantor</ulink>, the creator of set theory.</para></answer>
0967 </qandaentry>
0968 </qandaset>
0969 </chapter>
0970 
0971 <chapter id="credits">
0972 
0973 <title>Credits and License</title>
0974 
0975 <para>
0976 &cantor;
0977 </para>
0978 <para>
0979 Program copyright 2009-2011 Alexander Rieder <email>alexanderrieder@gmail.com</email>
0980 </para>
0981 
0982 <para>
0983 Documentation Copyright &copy; 2009-2011 Alexander Rieder <email>alexanderrieder@gmail.com</email>
0984 </para>
0985 
0986 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
0987 
0988 &underFDL;               <!-- FDL: do not remove -->
0989 &underGPL;               <!-- GPL License -->
0990 </chapter>
0991 
0992 &documentation.index;
0993 </book>
0994 
0995 <!--
0996 Local Variables:
0997 mode: xml
0998 sgml-minimize-attributes:nil
0999 sgml-general-insert-case:lower
1000 sgml-indent-step:0
1001 sgml-indent-data:nil
1002 End:
1003 
1004 vim:tabstop=2:shiftwidth=2:expandtab
1005 kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
1006 -->