From 47a4ebcf3b9ec0bbd8bf58e469f7f975f0ab85c9 Mon Sep 17 00:00:00 2001
From: Benjamin Franzke <benjaminfranzke@googlemail.com>
Date: Fri, 18 May 2012 17:01:05 +0200
Subject: document: Describe program abit

 - sed converter
 - octave get_products
 - matrix layout
---
 doc/document.asciidoc | 45 +++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 43 insertions(+), 2 deletions(-)

(limited to 'doc/document.asciidoc')

diff --git a/doc/document.asciidoc b/doc/document.asciidoc
index 55f5edd..91ab56e 100644
--- a/doc/document.asciidoc
+++ b/doc/document.asciidoc
@@ -25,8 +25,49 @@ Verfahren und Programme
 
 Zur Verarbeitung der Daten wurde das Programm Octave benutzt.
 Dieses ist eine Open-Source alternative zu MATLab.
-In dem Programm wurden die Daten in Form von Matriezen dagestellt.
-Das Script 'get_products.m' liest die Trainings- und Klasifikationsdatein.
+In dem Programm wurden die Daten in Form von Matrizen dagestellt.
+Das Script 'get_products.m' liest die Trainings- und Klasifikationsdatein
+die von einem sed script für die Benutzung in Octave vorbearbeitet wurden:
+
+[source,sh]
+----
+#!/bin/sed -f
+
+# Delete the header line, which is on line 1
+1d
+# Replace every | with a space
+s/|/ /g
+# Eliminate carrage return
+s/\r//
+----
+
+Das Octave-Script erstellt zwei Matrizen, je eine für die Preise und Quantitäten.
+Dabei hat jede Matrix 570 Spalten, jedes Produkt wird in einer eigenen Spalte gespeichert.
+Die Zeilennummer ist der index für den Tag.
+Damit ergibt sich eine Zeilengröße von 42 für die Quantitätsmatrix, und 56 für die Preismatrix,
+da diese zusätzlich die Klassifikationsdaten enthält:
+
+[source,octave]
+----
+include::../get_products.m[]
+----
+
+Die resultierende Matrix, die von allen implementierten Verfahren verwendet
+wird, hat folgendes Schema:
+
+.Preis-Matrix
+[latexmath]
+++++++++++++++++++++++++++++++++++++++++++++
+\[ P = 
+\begin{pmatrix}
+price_{day1,product1}  & price_{day1,product2}  & \cdots & price_{day1,product570} \\
+price_{day2,product1}  & price_{day2,product2}  & \cdots & price_{day2,product570} \\
+\vdots                 & \vdots                 & \ddots & \vdots \\
+price_{day56,product1} & price_{day56,product2} & \cdots & price_{day56,product570}
+\end{pmatrix}
+\]
+++++++++++++++++++++++++++++++++++++++++++++
+
 
 - Mittelwert
 - Lineare-Approximation (preis -> quantität)
-- 
cgit