Git commit f52cfa6dcc415cc36a9e4cc16366f0cb7dbcaeda by Garvit Khatri.
Committed on 11/08/2015 at 12:16.
Pushed by garvitkhatri into branch 'integrate-cantor'.

Adding documentation for CAS Worksheets

M  +171  -1    doc/index.docbook
M  +4    -1    src/backend/cantorWorksheet/VariableParser.cpp
M  +1    -0    src/kdefrontend/LabPlot.cpp

http://commits.kde.org/labplot/f52cfa6dcc415cc36a9e4cc16366f0cb7dbcaeda

diff --git a/doc/index.docbook b/doc/index.docbook
index e11bd3b..3da7f95 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -34,6 +34,13 @@
                        <address><email>[email protected]</email></address>
                </affiliation>
        </author>
+       <author>
+               <firstname>Garvit</firstname>
+               <surname>Khatri</surname>
+               <affiliation>
+                       <address><email>[email protected]</email></address>
+               </affiliation>
+       </author>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
@@ -90,6 +97,10 @@ Features:
 <listitem><para>Definition of mathematical formulas is supported by 
syntax-highlighting and completion and by the list of thematicaly grouped 
mathematical and physical constants and functions</para></listitem>
 <listitem><para>Analysis of plotted data is supported by many zooming and 
navigation features</para></listitem>
 <listitem><para>Linear and non-linear fits to data, several fit-models are 
predefined and custom models with arbitrary number of parameters can be 
provided</para></listitem>
+<listitem><para>Supports many CAS backends like Maxima, Python, KAlgebra, 
Sage</para></listitem>
+<listitem><para>Nice Worksheet view for evaluating 
expressions</para></listitem>
+<listitem><para>Easy plugin based structure to add different 
Backends</para></listitem>
+<listitem><para>Plugin based assistant dialogs for common tasks (like 
integrating a function or entering a matrix)</para></listitem>
 </itemizedlist>
 </para>
 
@@ -287,6 +298,158 @@ The results shown on the worksheet can be exported to 
different formats via the
 </para>
 </sect1>
 
+<sect1 id="CASworksheet">
+<title>CAS Worksheet</title>
+<para>
+The CAS worksheet is, besides the <link linkend="worksheet">worksheet</link>, 
the third central part of the application and provides an area to you use your 
favorite mathematical applications from within an elegant &kde;-integrated 
Worksheet Interface.
+</para>
+<para>
+  &LabPlot; offers you several choices for the backends you wish to use with 
it. The choice to make depends on what you want to achieve.
+</para>
+<para>
+<screenshot><mediaobject><imageobject>
+      <imagedata fileref="worksheet.png" format="PNG"/>
+</imageobject></mediaobject></screenshot>
+</para>
+<para>
+  Currently the following backends are available:
+  <variablelist>
+    <varlistentry>
+      <term>Sage:</term>
+      <listitem>
+       <para>
+         Sage is a free open-source mathematics software system licensed under 
the GPL.
+         It combines the power of many existing open-source packages, within a 
common Python-based interface.
+         See <ulink url="http://sagemath.org";>http://sagemath.org</ulink> for 
more information.
+       </para>
+       </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term>Maxima:</term>
+      <listitem>
+       <para>
+         Maxima is a system for the manipulation of symbolic and numeric 
expressions,
+         including differentiation, integration, Taylor series, Laplace 
transforms,
+         ordinary differential equations, systems of linear equations, 
polynomials, sets,
+         lists, vectors, matrices, and tensors. Maxima yields high-precision 
numeric results
+         by using exact fractions, arbitrary precision integers, and variable 
precision
+         floating point numbers. Maxima can plot functions and data in two and 
three dimensions.
+         See <ulink 
url="http://maxima.sourceforge.net";>http://maxima.sourceforge.net</ulink> for 
more information.
+       </para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term>R:</term>
+      <listitem>
+       <para>
+         R is a language and environment for statistical computing and 
graphics, similar to the S language and environment.
+         It provides a wide variety of statistical (linear and nonlinear 
modelling,
+         classical statistical tests, time-series analysis, classification, 
clustering, ...)
+         and graphical techniques, and is highly extensible. The S language is 
often the
+         vehicle of choice for research in statistical methodology,
+         and R provides an open-source route to this.
+         See <ulink 
url="http://www.r-project.org";>http://www.r-project.org</ulink> for more 
information.
+       </para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term>&kalgebra;:</term>
+      <listitem>
+       <para>
+         &kalgebra; is a MathML-based graph calculator, that ships with &kde; 
Education project.
+         See <ulink 
url="http://edu.kde.org/kalgebra/";>http://edu.kde.org/kalgebra/</ulink> for 
more information.
+         </para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term>Qalculate!:</term>
+      <listitem>
+  <para>
+    Qalculate! is not your regular software replication of the cheapest
+    available calculator. Qalculate! aims to make full use of the superior
+    interface, power and flexibility of modern computers. The center of
+    attention in Qalculate! is the expression entry. Instead of entering each
+    number in a mathematical expression separately, you can directly write the
+    whole expression and later modify it. The interpretation of expressions is
+    flexible and fault tolerant, and if you nevertheless do something wrong,
+    Qalculate! will tell you so. Not fully solvable expressions are however not
+    errors. Qalculate! will simplify as far as it can and answer with an
+    expression. In addition to numbers and arithmetic operators, an expression
+    may contain any combination of variables, units, and functions.
+    See <ulink 
url="http://qalculate.sourceforge.net/";>http://qalculate.sourceforge.net/</ulink>
 for more information.
+  </para>
+  </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term>Python2:</term>
+      <listitem>
+  <para>
+    Python is a remarkably powerful dynamic programming language that is used
+in a wide variety of application domains. There are several Python packages
+to scientific programming.
+  </para>
+  <para>Python is distributed under Python Software Foundation license (GPL 
compatible).
+    See the <ulink url="http://www.python.org/";>official website</ulink> for 
more information.
+  </para>
+  <note>
+    <para>
+      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.
+    </para>
+  </note>
+  <warning>
+    <para>
+      This backend supports Python 2 only.
+    </para>
+  </warning>
+  </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term>Scilab:</term>
+      <listitem>
+  <para>
+    Scilab is an free software, cross-platform numerical computational package
+    and a high-level, numerically oriented programming language.
+  </para>
+  <para>Scilab is distributed under CeCILL license (GPL compatible).
+    See <ulink url="http://www.scilab.org/";>http://www.scilab.org/</ulink> for 
more information.
+  </para>
+  <warning>
+    <para>
+      You need Scilab version 5.5 or higher to be installed in your system to 
make this backend usable.
+    </para>
+  </warning>
+  </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term>Octave:</term>
+      <listitem>
+  <para>
+    &GNU; Octave is a high-level language, primarily intended for numerical
+    computations. It provides a convenient command line interface for
+    solving linear and nonlinear problems numerically, and for performing other
+    numerical experiments using a language that is mostly compatible with 
<ulink url="http://www.mathworks.com/products/matlab/";>MATLAB</ulink>.
+    See <ulink 
url="http://www.gnu.org/software/octave/";>http://www.gnu.org/software/octave/</ulink>
 for more information.
+    </para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term>Lua:</term>
+      <listitem>
+  <para>
+    Lua is a fast and lightweight scripting language, with a simple procedural 
syntax. There are several libraries in Lua aimed at math and science.
+  </para>
+  <para>
+    See <ulink url="http://www.lua.org/";>http://www.lua.org/</ulink> for more 
information.
+  </para>
+  <para>
+    This backend supports <ulink url="http://luajit.org/";>luajit 2</ulink>.
+  </para>
+      </listitem>
+    </varlistentry>
+  </variablelist>
+</para>
+</sect1>
+
 
 <sect1 id="file_data_source">
 <title>File Data Source</title>
@@ -545,6 +708,13 @@ The menu is only available when a spreadsheet object is 
selected on the <guilabe
 </para>
 </sect1>
 
+<sect1 id="CASworksheet-menu">
+<title>The CAS Worksheet Menu</title>
+<para>
+This menu contains all the items that can also be found in the context menu 
(right mouse) of a CAS worksheet.
+The menu is only available when a worksheet object is selected on the 
<guilabel>Project Explorer</guilabel> panel.
+</para>
+</sect1>
 
 <sect1 id="settings-menu">
 <title>The Settings Menu</title>
@@ -1772,7 +1942,7 @@ bug-fixed packages are released regular and can be found 
there too.
 <title>Requirements</title>
 
 <para>
-In order to successfully use &LabPlot;, you need at least a standard &Qt; 4.7 
and &kde; installation and the &GNU; scientific library (GSL).
+In order to successfully use &LabPlot;, you need at least a standard &Qt; 5 
and &kde; KF5 installation, the &GNU; scientific library (GSL), &cantor; 
libcantor library.
 </para>
 
 <!-- <para>
diff --git a/src/backend/cantorWorksheet/VariableParser.cpp 
b/src/backend/cantorWorksheet/VariableParser.cpp
index 697fd7d..2f045a1 100644
--- a/src/backend/cantorWorksheet/VariableParser.cpp
+++ b/src/backend/cantorWorksheet/VariableParser.cpp
@@ -42,6 +42,9 @@ void VariableParser::init() {
        if(m_backendName.compare(QString("Python 3"), Qt::CaseInsensitive) == 
0) {
                return parsePythonValues();
        }
+       if(m_backendName.compare(QString("Python 2"), Qt::CaseInsensitive) == 
0) {
+               return parsePythonValues();
+       }
 }
 
 void VariableParser::parseMaximaValues() {
@@ -84,7 +87,7 @@ void VariableParser::parsePythonValues() {
                m_parsed = true;
                qDebug() << "Time taken to parse: " << t.elapsed();
        }
-       if(m_string.count(QString("(")) < 2 && m_string.count(QString("[")) == 
0) {
+       else if(m_string.count(QString("(")) < 2 && 
m_string.count(QString("[")) == 0) {
                m_string = m_string.replace(QString("("), QString(""));
                m_string = m_string.replace(QString(")"), QString(""));
                m_string = m_string.trimmed();
diff --git a/src/kdefrontend/LabPlot.cpp b/src/kdefrontend/LabPlot.cpp
index b43d55f..13e371d 100644
--- a/src/kdefrontend/LabPlot.cpp
+++ b/src/kdefrontend/LabPlot.cpp
@@ -53,6 +53,7 @@ int main (int argc, char *argv[]) {
        aboutData.addAuthor(i18n("Alexander Semke"), i18n("developer"), 
"[email protected]", 0);
        aboutData.addAuthor(i18n("Andreas Kainz"), i18n("icon designer"), 
"[email protected]", 0);
        aboutData.addCredit(i18n("Yuri Chornoivan"), i18n("Help on many 
questions about the KDE-infrastructure and translation related topics"), 
"[email protected]", 0);
+       aboutData.addCredit(i18n("Garvit Khatru"), i18n("Porting LabPlot2 to 
KF5 and Integration with LabPlot2"), "[email protected]", 0);
        KAboutData::setApplicationData(aboutData);
 
 
_______________________________________________
kde-doc-english mailing list
[email protected]
https://mail.kde.org/mailman/listinfo/kde-doc-english

Reply via email to