From 8e7733d3a584801facad32f6dcbd26dcff9d56fd Mon Sep 17 00:00:00 2001
From: tlbl <tlbl@dtu.dk>
Date: Tue, 12 Apr 2016 13:45:39 +0200
Subject: [PATCH] upgrade generate-spreadsheet.md

---
 docs/generate-spreadsheet.md | 29 +++++++++++++++++++++++------
 1 file changed, 23 insertions(+), 6 deletions(-)

diff --git a/docs/generate-spreadsheet.md b/docs/generate-spreadsheet.md
index 20256ea..44caf72 100644
--- a/docs/generate-spreadsheet.md
+++ b/docs/generate-spreadsheet.md
@@ -5,12 +5,29 @@ Introduction
 ------------
 
 This manual explains how to automatically generate the set of spreadsheets that
-define a DLB and are required as input to the pre-processor.
+defines a DLB and is required as input to the pre-processor.
 
 This tool comes handy in the following scenarios:
+* a DLB for a new turbine needs to be generated;
+* a different wind turbine class needs to be evaluated;
+* a new parameter needs to be included in the htc file;
+* different parameters variations are required, e.g. different wind speed range or different number of turbulent seed.
+
+The generator of the cases uses an input spreadsheet where the cases are defined
+in a more compact way. 
+The tool is based on the "tags" concept that is used for the genetaion of the htc files.
+
+Main spreatsheet
+----------------
+
+A main spreadsheet is used to defines all the DLC of the DLB. The file specifies the tags that are then required in the htc files.
+
+The file has:
+* a Main sheet where some wind turbines parameters are defined, the tags are initialized, and the definitions of turbulence and gusts are given.
+* a series of other sheets, each defining a DLC. In these sheets the tags that changes in that DLC are defined.
+
+The tags are devided into three possible different categories:
+* Constants (C). Constants are tags that do not change in a DLC, e.g. simulation time, output format, ...;
+* Variables (V). Variables are tags that define the number of cases in a DLC through their combinations, e.g. wind speed, number of turbilence seeds, wind direction, ..;
+* Functions (F). Functions are tags that depend on other tags through an expression, e.g. turbulence intensity, case name, ....
 
-    * a DLB for a new turbine needs to be generated;
-    * a different wind turbine class needs to be evaluated;
-    * a new parameter needs to be included in the htc file;
-    * different parameters variations are required, e.g. different wind speed
-    range or different number of turbulent seed.
\ No newline at end of file
-- 
GitLab