Warning, /education/khipu/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   <!ENTITY khipu "<application>Khipu</application>">
0004   <!ENTITY analitza "<application>Analitza</application>">
0005   <!ENTITY % addindex "IGNORE">
0006   <!ENTITY % English "INCLUDE">
0007 ]>
0008 <book lang="&language;">
0009 <bookinfo>
0010 <title>The &khipu; Handbook</title>
0011 <authorgroup>
0012 <author>
0013 <personname>
0014       <firstname>This documentation was converted from the &kde; UserBase <ulink url=" https://userbase.kde.org/Khipu/Manual/Introduction">&khipu;/Manual</ulink> page.</firstname>
0015 <surname></surname>
0016 </personname>
0017       </author>
0019       </authorgroup>
0020 <legalnotice>&FDLNotice;</legalnotice>
0021 <date>2013-09-18</date>
0022       <releaseinfo>1.0</releaseinfo>
0023 <abstract>
0024 <para></para>
0025       </abstract>
0026       <keywordset>
0027 <keyword>KDE</keyword>
0028 </keywordset>
0029 </bookinfo>
0030 <!--userbase <timestamp>2013-09-18T20:20:52Z</timestamp>-->
0032 <!--userbase-content-->
0033 <chapter id="khipu-plotting-is-just-a-fun"><title>&khipu; Plotting is Just a Fun</title>
0034 <para>&khipu; is an advanced mathematical function plotter application.
0035 </para>
0036 <para>It is part of the <ulink url="http://edu.kde.org">&kde; Education Project</ulink> and a replacement of an earlier function plotting application &kmplot;.
0037 </para>
0038 <para>
0039 <screenshot>
0040 <screeninfo></screeninfo>
0041   <mediaobject>
0042     <imageobject>
0043       <imagedata fileref="khipu_space3d.png" format="PNG"/>
0044     </imageobject>
0045     <textobject>
0046       <phrase>&khipu; space-3D</phrase>
0047     </textobject>
0048     <caption>
0049       <para>&khipu; space-3D</para>
0050     </caption>
0051   </mediaobject>
0052 </screenshot>
0053 </para>
0054 <sect1 id="quick-start-guide"><title>Quick Start Guide</title>
0055 <sect2 id="idea-of-space"><title>Idea of Space</title> 
0056 <para>&khipu; uses an abstraction of <emphasis>space</emphasis> in order to save the plots requested by user. A space will have its name and corresponding description from which it can be identified by the user later in time. &khipu; has two types of spaces (2D and 3D). User can <emphasis>save the plot</emphasis> in either of the spaces depending on his/her wish. <emphasis>Every space will contain multiple plots</emphasis> of different colors, intervals and types.
0057 </para>
0058 </sect2>
0059 <sect2 id="how-to-plot-functions-in-khipu-"><title>How to plot functions in &khipu;?</title> 
0060 <para>
0061 <screenshot>
0062 <screeninfo></screeninfo>
0063   <mediaobject>
0064     <imageobject>
0065       <imagedata fileref="myfig1.png" format="PNG"/>
0066     </imageobject>
0067     <textobject>
0068       <phrase>&khipu;-Add Space 2D/3D</phrase>
0069     </textobject>
0070     <caption>
0071       <para>&khipu;-Add Space 2D/3D</para>
0072     </caption>
0073   </mediaobject>
0074 </screenshot>
0075 </para>
0076 <para>As mentioned above, &khipu; draws functions in Space. So, there are two ways of adding a Space in &khipu; based on the plot's dimension. When you are on the main window of &khipu; (Dashboard in terms of &khipu;'s terminology), you will see a <guilabel>Main Toolbar</guilabel> which contains buttons of <guilabel>Add Space 2D</guilabel> and <guilabel>Add Space 3D</guilabel>. User can select either of them depending on the function he/she wants to plot.
0077 </para>
0078 <para>
0079 <screenshot>
0080 <screeninfo></screeninfo>
0081   <mediaobject>
0082     <imageobject>
0083       <imagedata fileref="myfig2.png" format="PNG"/>
0084     </imageobject>
0085     <textobject>
0086       <phrase>&khipu; - Add Plot in Space</phrase>
0087     </textobject>
0088     <caption>
0089       <para>&khipu; - Add Plot in Space</para>
0090     </caption>
0091   </mediaobject>
0092 </screenshot>
0093 </para>
0094 <sect3 id="plots-represented-in-two-dimension"><title>Plots represented in 2-Dimension</title> 
0095 <para>When the user clicks on <guibutton>Add Space 2D</guibutton>, it will redirect to the 2D space UI. Then he/she needs to click on the <guilabel>green button</guilabel> which will let the user to add a plot. Then, user needs to select a plot's type (for example, click on <guilabel>Graph</guilabel> in Cartesian section if you want to plot a sine curve!) You can add a plot's name by checking the plot name's check box. Then, user has to <guilabel>add an appropriate equation</guilabel> (&analitza;-type equation) to see it's plot. If you don't want anything else, <emphasis>just hit &Enter;</emphasis>. You can even set the color of the plot by changing the option from the list of colors given below and set an appropriate interval for the arguments of the function.
0096 </para>
0097 <para>
0098 <screenshot>
0099 <screeninfo></screeninfo>
0100   <mediaobject>
0101     <imageobject>
0102       <imagedata fileref="myfig3.png" format="PNG"/>
0103     </imageobject>
0104     <textobject>
0105       <phrase>&khipu; - 2D-Graph example</phrase>
0106     </textobject>
0107     <caption>
0108       <para>&khipu; - 2D-Graph example</para>
0109     </caption>
0110   </mediaobject>
0111 </screenshot>
0112 </para>
0113 </sect3>
0114 <sect3 id="plots-represented-in-three-dimension"><title>Plots represented in 3-Dimension</title>
0115 <para>When the user clicks on <guibutton>Add Space 3D</guibutton>, it will redirect to the 3D space UI. Then he/she needs to click on the <guilabel>green button</guilabel> which will let the user to add a plot. Then user needs to select a plot's type (for example, click on <guilabel>Graph</guilabel> in Cartesian section if you want to plot a simple surface!) You can add a plot's name by checking the plot name's check box. Then, user has to <guilabel>add an appropriate equation</guilabel> (&analitza;-type equation) to see it's plot. If you don't want anything else, <emphasis>just hit &Enter;</emphasis>. You can even set the color of the plot by changing the option from the list of colors given below.
0116 </para>
0117 <para>
0118 <screenshot>
0119 <screeninfo></screeninfo>
0120   <mediaobject>
0121     <imageobject>
0122       <imagedata fileref="myfig4.png" format="PNG"/>
0123     </imageobject>
0124     <textobject>
0125       <phrase>&khipu; - Edit/Remove plots</phrase>
0126     </textobject>
0127     <caption>
0128       <para>&khipu; - Edit/Remove plots</para>
0129     </caption>
0130   </mediaobject>
0131 </screenshot>
0132 </para>
0133 </sect3>
0134 </sect2>
0135 <sect2 id="how-to-edit-remove-functions-from-khipu-"><title>How to edit/remove functions from &khipu;?</title> 
0136 <para>User can edit or/and remove the already added plots.
0137 </para>
0138 <sect3 id="editing-an-already-added-plot"><title>Editing an already added plot</title> 
0139 <para>You can edit a plot by just <emphasis>double-clicking on the plot's entry</emphasis> in the plots view or you can select the appropriate entry there and then click on the edit button shown below.
0140 </para>
0141 </sect3>
0142 <sect3 id="removing-a-plot"><title>Removing a plot</title> 
0143 <para>You can remove a plot by selecting a desired plot in the view and then click on the <guilabel>Remove</guilabel> button shown below.
0144 </para>
0145 </sect3>
0146 </sect2>
0147 </sect1>
0148 <sect1 id="playing-with-plot-dictionary"><title>Playing with Plot Dictionary</title>
0149 <sect2 id="what-is-a-plot-dictionary-"><title>What is a Plot Dictionary?</title> 
0150 <para>A plot dictionary is a kind of text file (<filename role="extension">.plots</filename>) which contains a name of a plot along with its equation. The basic idea of dictionary files is to add plots in &khipu; without actually typing big equations. User can add the plots based on its name using the dictionaries. We already have some predefined dictionaries which let a user enter some famous plots (&ie; curves and surfaces). User can even download the dictionaries using Internet.
0151 </para>
0152 <sect3 id="syntax"><title>Syntax</title> 
0153 <para>A syntax of a dictionary file follows &analitza; syntax. Every line in a file will contain a name and the corresponding equation.
0154 </para>
0155 <para>For example: A typical dictionary file would have lines as follows:
0156 </para>
0157 <itemizedlist>
0158 <listitem><para>sinus := x-&gt;sin x</para></listitem>
0159 <listitem><para>plane1 := (x, y, z)-&gt;(x+y+z)-1</para></listitem>
0160 </itemizedlist>
0161 </sect3>
0162 <sect3 id="adding-your-own-dictionary-file"><title>Adding your own dictionary file</title> 
0163 <para>The flexible &analitza; syntax would allow the user to create his/her own dictionary file! User needs to save a text file with <filename role="extension">.plots</filename> extension with correct plot name and equations in each line.
0164 </para>
0165 <para>
0166 <screenshot>
0167 <screeninfo></screeninfo>
0168   <mediaobject>
0169     <imageobject>
0170       <imagedata fileref="myfig5.png" format="PNG"/>
0171     </imageobject>
0172     <textobject>
0173       <phrase>&khipu; - Plot-Dictionary in main-toolbar</phrase>
0174     </textobject>
0175     <caption>
0176       <para>&khipu; - Plot-Dictionary in main-toolbar</para>
0177     </caption>
0178   </mediaobject>
0179 </screenshot>
0180 </para>
0181 </sect3>
0182 <sect3 id="lets-have-a-look-at-the-plots-of-the-dictionary-files"><title>Let's have a look at the plots of the Dictionary files</title>
0183 <para>
0184 <screenshot>
0185 <screeninfo></screeninfo>
0186   <mediaobject>
0187     <imageobject>
0188       <imagedata fileref="myfig6.png" format="PNG"/>
0189     </imageobject>
0190     <textobject>
0191       <phrase>&khipu; - Plot-Dictionary UI</phrase>
0192     </textobject>
0193     <caption>
0194       <para>&khipu; - Plot-Dictionary UI</para>
0195     </caption>
0196   </mediaobject>
0197 </screenshot>
0198 </para>
0199 <para>If you want to see how &khipu; uses dictionary, just hit <guilabel>Plot Dictionary</guilabel> tab shown on the main toolbar of &khipu;. Then switch to different names in the drop down box tagged by <emphasis>collection</emphasis>. Click on any of the plot's name and you will see a corresponding plot on the right side of the window.
0200 </para>
0201 <para>
0202 <screenshot>
0203 <screeninfo></screeninfo>
0204   <mediaobject>
0205     <imageobject>
0206       <imagedata fileref="myfig7.png" format="PNG"/>
0207     </imageobject>
0208     <textobject>
0209       <phrase>&khipu; - Plot-Dictionary UI</phrase>
0210     </textobject>
0211     <caption>
0212       <para>&khipu; - Plot-Dictionary UI</para>
0213     </caption>
0214   </mediaobject>
0215 </screenshot>
0216 </para>
0217 </sect3>
0218 </sect2>
0219 <sect2 id="adding-plots-from-the-dictionary"><title>Adding plots from the Dictionary</title>
0220 <para>
0221 <screenshot>
0222 <screeninfo></screeninfo>
0223   <mediaobject>
0224     <imageobject>
0225       <imagedata fileref="myfig8.png" format="PNG"/>
0226     </imageobject>
0227     <textobject>
0228       <phrase>&khipu; - Add plots from dictionary</phrase>
0229     </textobject>
0230     <caption>
0231       <para>&khipu; - Add plots from dictionary</para>
0232     </caption>
0233   </mediaobject>
0234 </screenshot>
0235 </para>
0236 <para>The main advantage of the dictionaries is to add the plots without typing big equations. For that, add any space in &khipu;. Then switch to the <guilabel>Add from Dictionary</guilabel> tab. You can add the dictionary file there according to your wish. You just need to double click on the name of the plot to add it in the current &khipu; Space.
0237 </para>
0238 <para>
0239 <screenshot>
0240 <screeninfo></screeninfo>
0241   <mediaobject>
0242     <imageobject>
0243       <imagedata fileref="myfig9.png" format="PNG"/>
0244     </imageobject>
0245     <textobject>
0246       <phrase>&khipu; - Import/Download dictionary</phrase>
0247     </textobject>
0248     <caption>
0249       <para>&khipu; - Import/Download dictionary</para>
0250     </caption>
0251   </mediaobject>
0252 </screenshot>
0253 </para>
0254 </sect2>
0255 <sect2 id="import-dictionary-file-from-a-local-disk"><title>Import Dictionary File from a local disk</title>
0256 <para>It is not that you can only add/see the plot from the predefined dictionaries available by &analitza;. You can even import any downloaded/manually created dictionary in &khipu; and can add the plots from it in &khipu; Space!
0257 </para>
0258 </sect2>
0259 <sect2 id="download-dictionary-file-from-the-internet"><title>Download Dictionary File from the Internet</title>
0260 <para>The use of <guilabel>Get Hot New Stuff API</guilabel> in &khipu; will allow the user to download these dictionary files from the web. In this way, a user can have a rich collection of dictionaries downloaded across the globe. You can achieve this by simply clicking on the <guilabel>Get Plot Dictionary Files</guilabel> from the Dictionary UI.
0261 </para>
0262 </sect2>
0263 <sect2 id="export-a-space-as-a-dictionary"><title>Export a space as a Dictionary</title>
0264 <para>
0265 <screenshot>
0266 <screeninfo></screeninfo>
0267   <mediaobject>
0268     <imageobject>
0269       <imagedata fileref="myfig11.png" format="PNG"/>
0270     </imageobject>
0271     <textobject>
0272       <phrase>&khipu; - Export a space as dictionary</phrase>
0273     </textobject>
0274     <caption>
0275       <para>&khipu; - Export a space as dictionary</para>
0276     </caption>
0277   </mediaobject>
0278 </screenshot>
0279 </para>
0280 <para>User can even export a whole space into the dictionary with the names and equations of the plots saved in that particular space. For this, you have to click on go <guilabel>Home</guilabel> and then click on the <emphasis>tool button</emphasis> on the space thumbnail which tells you about exporting the space in dictionary.
0281 </para>
0282 </sect2>
0283 </sect1>
0284 <sect1 id="khipu---beyond-just-plotting"><title>&khipu;: Beyond just plotting</title>
0285 <sect2 id="khipus-application-actions"><title>&khipu;'s Application Actions</title> 
0286 <para>One of the key advantage of &khipu; is to have <emphasis>some other useful functionaries</emphasis> to deal with the mathematical function's plotting apart from just plotting them. The various application actions and other features make &khipu; more user-friendly.
0287 </para>
0288 <sect3 id="new-open-save-saveas"><title>New/Open/Save/SaveAs</title>
0289 <para>The normal actions of New, Open, Save and SaveAs allow the users to work with different sessions and <emphasis>saving their work in persistence files (<filename role="extension">.khipu</filename> files)</emphasis> which he/she can open later in time. The persistence file follows a <emphasis>QJson file format</emphasis> which saves important information from the current session. This information includes name of spaces added, name and equations of the plots added in each space, plots' interval and their color.
0290 </para>
0291 </sect3>
0292 <sect3 id="save-plot-as-image"><title>Save Plot as Image</title>
0293 <para>In &khipu;, every space will have its corresponding image which contains the plots requested by the user. The space image can be saved (<acronym>PNG</acronym> file) into the local disk using this application action.
0294 </para>
0295 </sect3>
0296 <sect3 id="take-snapshot"><title>Take Snapshot</title>
0297 <para>You can even copy the space image into clipboard using this action.
0298 </para>
0299 </sect3>
0300 <sect3 id="want-to-see-only-a-graph-in-the-entire-screen-"><title>Want to see only a graph in the entire screen?</title>
0301 <para>The full screen option in &khipu; will allow the user to just only see the plot space. All the other docks and toolbars will be invisible while activating a full screen!
0302 </para>
0303 </sect3>
0304 <sect3 id="space-navigation"><title>Space Navigation</title>
0305 <para>
0306 <screenshot>
0307 <screeninfo></screeninfo>
0308   <mediaobject>
0309     <imageobject>
0310       <imagedata fileref="myfig12.png" format="PNG"/>
0311     </imageobject>
0312     <textobject>
0313       <phrase>&khipu; - Space Navigation Options</phrase>
0314     </textobject>
0315     <caption>
0316       <para>&khipu; - Space Navigation Options</para>
0317     </caption>
0318   </mediaobject>
0319 </screenshot>
0320 </para>
0321 <para>While a user is on any space (2D or 3D), he can switch to next/previous/first/last space in just one key stroke. The shortcuts for this are as follows:
0322 </para>
0323 <itemizedlist>
0324 <listitem><para>Navigate to the next space -&gt; &PgUp;</para></listitem>
0325 <listitem><para>Navigate to the previous space -&gt; &PgDn;</para></listitem>
0326 <listitem><para>Navigate to the first space -&gt; <keycombo>&Ctrl;&Home;</keycombo></para></listitem>
0327 <listitem><para>Navigate to the last space -&gt; <keycombo>&Ctrl;&End;</keycombo></para></listitem>
0328 </itemizedlist>
0329 </sect3>
0330 </sect2>
0331 <sect2 id="dashboard--all-the-work-available-on-the-hands"><title>Dashboard: All the work available on the hands</title>
0332 <para>
0333 <screenshot>
0334 <screeninfo></screeninfo>
0335   <mediaobject>
0336     <imageobject>
0337       <imagedata fileref="myfig13.png" format="PNG"/>
0338     </imageobject>
0339     <textobject>
0340       <phrase>&khipu; - Main Dashboard</phrase>
0341     </textobject>
0342     <caption>
0343       <para>&khipu; - Main Dashboard</para>
0344     </caption>
0345   </mediaobject>
0346 </screenshot>
0347 </para>
0348 <para>The main dashboard of &khipu; contains all the spaces created by the user with its thumbnail and space's name. So a user can know which space he/she wants to modify or see their plots.
0349 </para>
0350 </sect2>
0351 <sect2 id="space-filter-based-on-titledescription-and-dimension"><title>Space filter based on Title, Description and Dimension</title>
0352 <para>
0353 <screenshot>
0354 <screeninfo></screeninfo>
0355   <mediaobject>
0356     <imageobject>
0357       <imagedata fileref="myfig14.png" format="PNG"/>
0358     </imageobject>
0359     <textobject>
0360       <phrase>&khipu; - Space filter</phrase>
0361     </textobject>
0362     <caption>
0363       <para>&khipu; - Space filter</para>
0364     </caption>
0365   </mediaobject>
0366 </screenshot>
0367 </para>
0368 <para>The filter feature available on the dashboard will allow the user to filter the spaces based on their title and/or description. You can even filter the space based on the dimension chosen from the drop down box shown on the top-right corner on the Dashboard UI.
0369 </para>
0370 </sect2>
0371 <sect2 id="shortcuts-dock---an-easy-way-of-plotting"><title>Shortcuts Dock: An easy way of plotting</title>
0372 <para>
0373 <screenshot>
0374 <screeninfo></screeninfo>
0375   <mediaobject>
0376     <imageobject>
0377       <imagedata fileref="myfig15.png" format="PNG"/>
0378     </imageobject>
0379     <textobject>
0380       <phrase>&khipu; - Shortcuts Dock</phrase>
0381     </textobject>
0382     <caption>
0383       <para>&khipu; - Shortcuts Dock</para>
0384     </caption>
0385   </mediaobject>
0386 </screenshot>
0387 </para>
0388 <para>If a user wants to plot quickly without worrying about the spaces, the shortcuts dock will allow him/her to do so. For this, you need to type <keycap>S</keycap> and then select your plot type from that dock, type the equation, hit &Enter; and that's it!
0389 </para>
0390 </sect2>
0391 <sect2 id="zoom-in-out-and-rotations-in-the-plots-view"><title>Zoom In/out and Rotations in the plots view</title>
0392 <para>The 2D and 3D space have a functionality from which you can zoom-in and/or zoom-out the plot-space by just scrolling up/down respectively. The 3D space has a support of rotations and shadows which let a user analyse the 3D plots from different angles!
0393 </para>
0394 </sect2>
0395 </sect1>
0396 </chapter>
0397 <chapter id="credits-and-license"><title>Credits and License</title> 
0398 <sect1 id="program-copyright"><title>Program copyright</title>
0399 <para>Program copyright 2010-2012 Percy Camilo Trive&ntilde;o Aucahuasi
0400 </para>
0401 </sect1>
0402 <sect1 id="documentation-copyright"><title>Documentation copyright</title> 
0403 <para><note><para>Please add your name here if you contribute to the handbook. Please respect alphabetical order</para></note>
0404 </para>
0405 <para>Punit Mehta (punit9462 gmail.com)
0406 </para>
0407 </sect1>
0408 <sect1 id="licenses"><title>Licenses</title> 
0409 <para>This documentation is licensed under the terms of the <ulink url="https://userbase.kde.org/Special:myLanguage/KDE_UserBase_Wiki:Copyrights">&GNU; Free Documentation License</ulink>.
0410 </para>
0411 <para>This program is licensed under the terms of the <ulink url="https://www.gnu.org/licenses/old-licenses/gpl-2.0.txt">&GNU; General Public License</ulink>.
0412 </para>
0414 <!--userbase-content-->
0416 &underFDL;
0417 </sect1>
0418 </chapter>
0419 &documentation.index;
0420 </book>