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
