diff --git a/Water quality calibration/readme.md b/Water quality calibration/readme.md
index 85f3e73dc9ab62abe97c414e3d8d086dbacc41d1..7c4a25330a6c598938a15b5fae1c0d8e6908d803 100644
--- a/Water quality calibration/readme.md	
+++ b/Water quality calibration/readme.md	
@@ -3,12 +3,28 @@
 check_column_names_res1d.ipnyb:
 - quick code to access res1d files to see what names the result files for specific reach or node names have
 
+optimization_prep:
+- contains the optimization preparation to create the 
+- uses a gaussian filter to smooth the data and cross correlation to consider errors in the hydrological model
 
+water-quality-optimization:
+- input is amodel file, the results files and the excel files defined below
+- script that contains the automatic optimization of the MIKE+ model
 
 
 
 # The following excel files need to be saved in the folder where the .sqlite file is saved:
 
+calibration_event_times.xlsx
+- gives the preperation script input on which times are used
+- The excel file contains sensor in the first header line, the kind of column in the second header line and the event as the first column. Rows without values in times are ignored
+- all event rows should contain the timeframes for the comparison in the calibration
+
+sensor_positions.xlsx:
+- This table defines for each concentration sensor where it is positioned whithin the model
+- It also contains a the position and name of a discharge sensor, which is used to adjust the time shift later
+- Note that chainages are only approximate. You should use a chainage that is available in the result files. Check the hd results files wit hthe given script beforehand
+
 event_dict.xlsx:
 - this excel file contains information if multiple events are simulated together
 - if you are doing this: Simplay write under event the single events and under result file the result file name in which the event is included
@@ -36,6 +52,7 @@ optim_parts.xlsx:
 
 reference.csv:
 - created by the optimization_prepr.ipnyb to get the sensor data for comparison
+- if the prep is not wanted you can also create this fiel directly