Software-Design.md

@@ -63,9 +63,9 @@ In the following a table with all available properties is presented. All distanc
 || mode | enum | The modus operandi with which the printer should print. Not case-sensitive. Can be 'normalprinter' or name of concrete specialization in combination with the printers name(e.g. index_everest_d_v4_graphic_printer). | ✔ | normalprinter
 || brailletable  | relative filename | A file containing a brailletable mapping for the exporter. | ✔ | eurobraille.properties
 || floatingDot.support | true/false | The printers capability to print floating dots. | ✔ | false
-|| floatingDot.resolution | non-negative double | The minimum distance between two dot centres. | | 
+|| floatingDot.resolution | non-negative double | The minimum distance between two dot centres. | |
 || constraint.[top,left] | non-negative double | The printers base indentation of printing area.| ✔ | 0
-|| constraint.[width,height] | non-negative double | The printers hardware limitation of printing area.| | 
+|| constraint.[width,height] | non-negative double | The printers hardware limitation of printing area.| |
 || raster.constraint.[top,left] | non-negative double | Further raster constraints: border from top or left raster edge. Difference to 'printer.constraint': measured in full cells instead of mm.| ✔ | 0
 || raster.constraint.[width,height] | non-negative double | Further raster constraints: fixed char per line limit or line per page limit. Difference to 'printer.constraint': measured in full cells instead of mm.| |
 || raster.type | enum | The braille raster. Can be any of the following: '6-dot', '8-dot' | ✔ | 6-dot
@@ -82,6 +82,70 @@ In the following a table with all available properties is presented. All distanc
 || ... | ... | ... | ... | ... |
 
 
+## Input Data Parsing
+
+We aim to support the same input data in CSV files as [SVG-Plott](https://gitlab.hrz.tu-chemnitz.de/s9716248--tu-dresden.de/SVG-Plott) does.
+This includes unique csv patterns for:
+* Bar Charts
+* Categorical Bar Charts
+* Line/Scatter Plots
+
+At the moment of writing, the following patterns are supported:
+
+### Simple Bar Charts (no categories):
+
+  #### Vertical
+  `CsvParser.parse(CsvType.X_ALIGNED, CsvOrientation.VERTICAL) -> PointListContainer<PointList>`
+
+  |Column 1|Column 2|
+  |---|---|
+  |${Name_of_sample#1}|${Value_for_sample#1}|
+  |${Name_of_sample#2}|${Value_for_sample#2}|
+  |...|...|
+  |${Name_of_sample#n}|${Value_for_sample#n}|
+
+  [Example File](https://gitlab.hrz.tu-chemnitz.de/s9444737--tu-dresden.de/brailleplot/blob/master/src/main/resources/examples/csv/0_bar_chart.csv)
+
+
+### Categorical Bar Charts
+
+  #### Vertical
+  `CsvParser.parse(CsvType.X_ALIGNED_CATEGORIES, CsvOrientation.VERTICAL) -> CategoricalPointListContainer<PointList>`
+
+  |Column 1|Column 2|Column 3|...|Column n|
+  |---|---|---|---|---|
+  ||${Name_of_category#1}|${Name_of_category#2}|...|${Name_of_category#n}
+  |${Name_of_dataset#1}|${Value#1_for_dataset#1_in_category#1}|${Value#2_for_dataset#1_in_category#2}|...|${Value#n_for_dataset#1_in_category#n}|
+  |${Name_of_dataset#2}|${Value#1_for_dataset#2_in_category#1}|${Value#2_for_dataset#2_in_category#2}|...|${Value#n_for_dataset#2_in_category#n}|
+  |...|...|...|...|...|
+  |${Name_of_dataset#n}|${Value#1_for_dataset#n_in_category#1}|${Value#2_for_dataset#n_in_category#2}|...|${Value#n_for_dataset#n_in_category#n}|
+
+  [Example File](https://gitlab.hrz.tu-chemnitz.de/s9444737--tu-dresden.de/brailleplot/blob/master/src/main/resources/examples/csv/0_bar_chart_categorical_vertical.csv)
+
+### Scatter and Line Plots
+
+  #### Horizontal
+  `CsvParser.parse(CsvType.DOTS, CsvOrientation.HORIZONTAL) -> PointListContainer<PointList>`
+
+  |Column 1|Column 2|Column 3|...|Column n|
+  |---|---|---|---|---|
+  |${Name_of_dataset#1}|${XValue#1_for_dataset#1}|${XValue#2_for_dataset#1}|...|${XValue#n_for_dataset#1}
+  ||${YValue#1_for_dataset#1}|${YValue#2_for_dataset#1}|...|${YValue#n_for_dataset#1}
+  |${Name_of_dataset#2}|${XValue#1_for_dataset#2}|${XValue#2_for_dataset#2}|...|${XValue#n_for_dataset#2}
+  ||${YValue#1_for_dataset#2}|${YValue#2_for_dataset#2}|...|${YValue#n_for_dataset#2}
+  |...|...|...|...|...|
+  |${Name_of_dataset#n}|${XValue#1_for_dataset#n}|${XValue#2_for_dataset#n}|...|${XValue#n_for_dataset#n}
+  ||${YValue#1_for_dataset#n}|${YValue#2_for_dataset#n}|...|${YValue#n_for_dataset#n}
+
+
+  [Example File](https://gitlab.hrz.tu-chemnitz.de/s9444737--tu-dresden.de/brailleplot/blob/master/src/main/resources/examples/csv/1_scatter_plot.csv)
+
+* Global rules for all CSV patterns
+  * Each column has to be separated by the `,` character
+  * Values need to be of numerical type
+  * Fractional rational numbers (e.g. a float), to be escaped by placing the `"` character at the beginning and and on the end of that number (e.g. `"3,5"`)
+
+
 ## Rendering
 
 Would be nice to explain this thing a bit here...
\ No newline at end of file