<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kalgebra;">
  <!ENTITY package "kdeedu">
  
  <!ENTITY commands SYSTEM "commands.docbook">
  
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % German "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
<title
>Das Handbuch zu &kalgebra;</title>

<authorgroup>
<author
><firstname
>Aleix</firstname
> <surname
>Pol</surname
> <affiliation
> <address
>&Aleix.Pol.mail;</address>
</affiliation>
</author>
<othercredit role="translator"
><firstname
>Burkhard</firstname
><surname
>Lück</surname
><affiliation
><address
><email
>lueck@hube-lueck.de</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2007</year>
<holder
>&Aleix.Pol;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>


<date
>2010-09-22</date>
<releaseinfo
>0.10 (&kde; 4.5)</releaseinfo>

<abstract>
<para
>&kalgebra; ist ein mathematisches Rechenprogramm auf der Grundlage der Sprache Content MathML, die die Struktur einer Formel beschreibt. Zurzeit kann &kalgebra; arithmetische und logische Operationen ausführen und zwei- sowie dreidimensionale Graphen darstellen. Kentnisse von MathML sind für die Arbeit mit &kalgebra; nicht erforderlich. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>graph</keyword>
<keyword
>Mathematik</keyword>
<keyword
>2D</keyword>
<keyword
>3D</keyword>
<keyword
>mathML</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction"
> 
<title
>Einführung</title
> 
<para
>&kalgebra; ist ein grafischen Mathematikprogramm auf der Basis von MathML. Es kann auch von Personen mit geringen Mathematikkenntnissen genutzt werden.</para
> 

<screenshot>
<screeninfo
>Hier sehen Sie ein Bildschirmfoto vom &kalgebra;-Hauptfenster</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kalgebra-main-window.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>&kalgebra;-Hauptfenster</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Das Hauptfenster von &kalgebra; besteht aus den Karteikarten <guilabel
>Konsole</guilabel
>, <guilabel
>2D-Graph</guilabel
>, <guilabel
>3D-Graph</guilabel
> und <guilabel
>Funktionen</guilabel
>. Darunter befindet sich ein Textfeld zur Eingabe von Funktionen oder Berechnungen. </para>

<para
>Gemeinsame Menüeinträge für die Karteikarten <guilabel
>Konsole</guilabel
>, <guilabel
>2D-Graph</guilabel
> und <guilabel
>3D-Graph</guilabel
>:</para>

<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>N</keycap
></keycombo
></shortcut
> <guimenu
>Sitzung</guimenu
><guimenuitem
>Neu</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Öffnet ein neues &kalgebra;-Hauptfenster</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>Q</keycap
></keycombo
></shortcut
> <guimenu
>Sitzung</guimenu
><guimenuitem
>Beenden</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Beendet das Programm.</para
></listitem>
</varlistentry>

</variablelist>

</chapter>

<chapter id="syntax">
<title
>Syntax</title>

<para
>Die Syntaxeingaben werden in die Sprache MathML übersetzt und in dieser Form programmintern weiter verarbeitet. Die Syntax folgt den üblichen und allgemein bekannten Regeln der Mathematik und ist der Syntax der Computeralgebrasysteme Maxima und Maple sehr ähnlich.</para>
<para
>Folgende Operatoren sind in dieser Version enthalten:</para>
<itemizedlist>
<listitem
><para
>+ - * / : Addition, Subtraktion, Multiplikation und Division.</para
> </listitem>
<listitem
><para
>^, ** : Potenzen, beide Schreibweisen und auch das Unicodezeichen  ² sind erlaubt. Potenzen können auch als Wurzel benutzt werden, zum Beispiel:  a**(1/b)</para
></listitem>
<listitem
><para
>-&gt; : lambda. Zur Kennzeichnung der beschränkten Variablen in einer Funktion.</para
></listitem>
<listitem
><para
>x=a..b : Einschränkung eines Wertebereichs (beschränkte Variable mit unterer und oberer Grenze). Die Variable x kann in diesem Beispiel nur Werte von a bis b annehmen.</para
></listitem>
<listitem
><para
>() : Klammern bestimmen den Vorrang einer auszuführenden Rechenoperation vor anderen in der Rechenreihenfolge.</para
></listitem>
<listitem
><para
>abc(parameter) : Funktionen. Beim Einlesen von Funktionen wird überprüft, ob „abc“ ein Operator ist. Wenn ja, dann wird es als Operator behandelt, ansonsten als benutzerdefinierte Funktion.</para
></listitem>
<listitem
><para
>:= : Definition des Wertes einer Variablen. Definitionen wie x:=3, x:=y sind möglich, auch wenn y noch nicht definiert ist, oder zum Beispiel umfang:=r->2*pi*r. </para
></listitem>
<listitem
><para
>? : Abschnittsweise definierte Bedingungen. Damit können bedingte Operationen in &kalgebra; definiert werden. Das Ergebnis einer abschnittsweise definierten Funktion ist der Ausdruck nach dem '?' der ersten wahre Bedingung. Trifft keine Bedingung zu, wird der Ausdruck nach dem letzten '?' ohne vorangestellte Bedingung zurückgegeben. Beispiel: piecewise { x=0 ? 0, x=1 ? x+1, ? x**2 } </para
></listitem>
<listitem
><para
>{ } : Damit werden MathML-Container definiert, die hauptsächlich bei abschnittsweise definierten Bedingungen verwendet werden. </para
></listitem>
<listitem
><para
>= &gt; &gt;= &lt; &lt;= : Vergleichsoperatoren für gleich, größer, größer oder gleich, kleiner und kleiner oder gleich.</para
></listitem>
</itemizedlist>
<para
>Mit diese MathML-ähnlichen Syntax kann mit Funktionen wie cos(), sin(), jeder beliebigen trigonometrischen Funktion, sum() oder product() gearbeitet werden. Sie können Funktionen wie plus(), mal() und jede beliebige Funktion mit Operator verwenden. Auch Boolesche Funktionen sind implementiert, Sie können zum Beispiel mit Ausdrücke wie or(1,0,0,0,0) arbeiten.</para>

</chapter>

<chapter id="using-console">
<title
>Arbeiten auf der Konsole</title>
<para
>Die Konsole in &kalgebra; dient als Rechner. Rechts finden Sie eine Liste der definierten Variablen. Durch Doppelklicken öffnen Sie einen Dialog, in dem Sie den Wert der Variablen ändern können. Jedesmal wenn Sie einen Ausdruck eingeben, wird dessen Ergebnis in der Variable namens „ans“ gepeichert.</para>

<para
>Beispiele:</para>
<itemizedlist>
<listitem
><para
>sin(pi)</para
></listitem>
<listitem
><para
>k:=33</para
></listitem>
<listitem
><para
>sum(k*x : x=0..10)</para
></listitem>
<listitem
><para
>f:=p->p*k</para
></listitem>
<listitem
><para
>f(pi)</para
></listitem>
</itemizedlist>

<para
>Menüeinträge:</para>

<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>L</keycap
></keycombo
></shortcut
> <guimenu
>Konsole</guimenu
><guimenuitem
>Skript laden</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Führt alle Anweisungen in der Skriptdatei nacheinander aus. Damit können Sie zum Beispiel mathematische Funktionen aus Bibliotheken oder Ihre vorher erstellte Arbeit wieder laden.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>G</keycap
></keycombo
></shortcut
> <guimenu
>Konsole</guimenu
><guimenuitem
>Skript speichern</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Speichert alle Anweisungen, die seit Beginn der Sitzung eingegeben wurden, in eine Datei. Diese Textdatei kann dann zum Beispiel mit einem Editor wie Kate korrigiert oder bearbeitet werden.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>S</keycap
></keycombo
></shortcut
> <guimenu
>Konsole</guimenu
><guimenuitem
>Protokoll speichern</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Speichert das Protokoll mit allen Ergebnissen in einer HTML-Datei, um sie ausdrucken oder weiterzugeben.</para
></listitem>
</varlistentry>

</variablelist>

</chapter>

<chapter id="two-D-graphs">
<title
>2D-Graphen</title>
<para
>Um einen neuen 2D-Graphen in &kalgebra; einzugeben, wechseln Sie zur Karteikarte <guilabel
>2D-Graph</guilabel
>. Klicken Sie dann auf den Karteireiter <guilabel
>Hinzufügen</guilabel
> und geben Sie im Textfeld oben die neue Funktion ein. </para>

<sect1 id="two-D-syntax">
<title
>Syntax</title>
<para
>Eine Funktion des Typs f(x) können Sie direkt so eingeben. Für Funktionen des Tpys f(y) oder für polare Funktionen müssen Sie y-> und q-> als die gebundenen Variablen hinzufügen.</para>

<para
>Beispiele:</para>
<itemizedlist>
<listitem
><para
>sin(x)</para
></listitem>
<listitem
><para
>x²</para
></listitem>
<listitem
><para
>y->sin(y)</para
></listitem>
<listitem
><para
>q->3*sin(7*q)</para
></listitem>
<listitem
><para
>t->vector{sin t, t**2}</para
></listitem>
</itemizedlist>
<para
>Wenn Sie eine Funktion eingegeben haben, klicken Sie auf den Knopf <guibutton
>OK</guibutton
>, um den Graphen der Funktion im Hauptfenster anzuzeigen.</para>

</sect1>

<sect1 id="two-D-features">
<title
>Eigenschaften</title>
<para
>Mehrere Graphen können in derselben Ansicht angezeigt werden. Wechseln Sie dazu auf die Karteikarte <guilabel
>Hinzufügen</guilabel
>. Jeder Graph kann in einer eigenen Farbe dargestellt werden.</para>

<para
>Die Ansicht kann mit dem Mausrad vergrößert oder verkleinert werden. Mit der linken Maustaste können Sie Bereiche in der Ansicht zur Vergrößerung auswählen. Mit den Pfeiltasten kann die Ansicht verschoben werden.</para>

<para
>Auf der Karteikarte <guilabel
>Liste</guilabel
> können Sie durch Klicken mit der &RMBn; auf eine Funktion ein Kontextmenü öffnen, um die Funktion auszublenden oder zu entfernen.</para>

<para
>Im Menü <guimenu
>2D-Graph</guimenu
> sind diese Einträge vorhanden:</para>
<itemizedlist>
<listitem
><para
>Gitternetzlinien enzeigen oder ausblenden</para
></listitem>
<listitem
><para
>Seitenverhältnis bei Größenänderung beibehalten</para
></listitem>
<listitem
><para
>Vergrößern (<keycombo action="simul"
>&Ctrl; <keycap
>+</keycap
></keycombo
>) und Verkleinern (<keycombo action="simul"
>&Ctrl; <keycap
>-</keycap
></keycombo
>) der Ansicht</para
></listitem>
<listitem
><para
>Den Graphen als Bilddatei speichern (<keycombo action="simul"
>&Ctrl; <keycap
>S</keycap
></keycombo
>) </para
></listitem>
<listitem
><para
>Ansicht wieder auf die Originalgröße zurücksetzen</para
></listitem>
<listitem
><para
>Auflösung des Graphen einstellen</para
></listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="three-D-graphs">
<title
>3D-Graphen</title>

<para
>Wechseln Sie zur Karteikarte <guilabel
>3D-Graph</guilabel
> und geben Sie im Textfeld unten eine Funktion ein. Zurzeit kann noch kein Funktionswert für die Z-Achse eingegeben werden. &kalgebra; erlaubt nur implizite 3D-Funktionen, die die Variable z als Funktion z=f(x,y) definieren, wie (x,y)->x*y, dabei ist z=x*y.</para>

<para
>Beispiele:</para>
<itemizedlist>
<listitem
><para
>sin(x)*sin(y)</para
></listitem>
<listitem
><para
>x/y</para
></listitem>
</itemizedlist>

<para
>Die Ansicht kann mit dem Mauszeiger verschoben und mit dem Mausrad vergrößert oder verkleinert werden. Mit der &LMBn; können Bereiche in der Ansicht zur Vergrößerung ausgewählt werden. </para>

<para
>Die Pfeiltasten links und rechts drehen die Grafik um die senkrechte Z-Achse, die Pfeiltasten auf und ab drehen die Grafik um die horizontale Achse der Ansicht.</para>

<para
>Im Menü <guimenu
>3D-Graph</guimenu
> sind diese Einträge vorhanden:</para>
<itemizedlist>
<listitem
><para
>Transparenz der Ansicht aktivieren/deaktivieren</para
></listitem>
<listitem
><para
>Den Graphen als Bilddatei speichern (<keycombo action="simul"
>&Ctrl; <keycap
>S</keycap
></keycombo
>) </para
></listitem>
<listitem
><para
>Ansicht wieder auf die Originalgröße zurücksetzen</para
></listitem>
<listitem
><para
>Anzeige der Grafik als Gitternetz aus Punkten, Linien oder als gefüllte Fläche mit einem Liniengitter. </para
></listitem>
</itemizedlist>


</chapter>

<chapter id="dictionary">
<title
>Funktionen</title>

<para
>Auf der Karteikarte <guilabel
>Funktionen</guilabel
> finden Sie eine Liste aller in &kalgebra; verfügbaren Operationen. Wählen Sie eine Funktion aus der Liste oder im Suchfeld, dann wird die Beschreibung, die Parameter und ein Beispiel dieser Funktion mit dem Graphen links angezeigt. </para>
</chapter>

&commands;

<chapter id="credits">
<title
>Danksagungen und Lizenz</title>

<itemizedlist>
<listitem
><para
>Program copyright 2005-2009 &Aleix.Pol;</para>
</listitem>
</itemizedlist>

<para
>Dokumentation Copyright 2007 &Aleix.Pol; &Aleix.Pol.mail; </para>

<para
>Übersetzung Burkhard Lück<email
>lueck@hube-lueck.de</email
></para
> 
&underFDL; &underGPL; </chapter>


<appendix id="installation">
<title
>Installation</title>

<sect1 id="getting-kapptemplate">
<title
>Woher Sie &kalgebra; erhalten</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Kompilierung und Installation</title>
&install.compile.documentation; </sect1>

</appendix>
&documentation.index; 
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
