User Doc : 2. pass Grid Case Grous and Statistics

Documentation/UsersGuide/CaseGroupsAndStatistics.md

@@ -1,16 +1,74 @@
 
-## Multiple realizations and statistics
+## Grid Case Groups and Statistics
 
-ResInsight features efficient support for management of large collection of realizations. 
-To import a set of realizations, select **File->Import->Create Grid Case Group from Files**.
-An import dialog is opened, an a set of cases can be imported from multiple folders.
+![](images/GridCaseGroupTree.png)
 
-*NOTE:* The search for Eclipse cases will be executed recursively for the specified folders.
+**Grid Case Group**'s are designed to make it easy to calculate statistics per cell and per timestep of a large number of Eclipse simulation Cases with identical Grids (often labeled *realizations*).
+ 
+If you have several Eclipse simulations with different input parameters available, you can put all the realizations into a Grid Case Group and easily calculate each of the cells mean value, range and max/min values at each timestep between the realizations.
 
-Clicking the **Ok** button will import all cases into ResInsight, and they can be inspected one by one. To reduce the number of views, only a view for the first case is automatically created. Select *New view** from the context menu of a case to create a 3D view of the case.
+### Creating Grid Case Groups
+#### From files
+The easiest way to create a **Grid Case Group** is to use the Import command:
+**File->Import->Create Grid Case Group from Files**
+
+An import dialog is opened: 
+![](images/CreateGridCaseGroupFromFileDialog.png) 
+
+1. Add one or more search folders to the list on the left.
+2. The *.EGRID or *.GRID files found in these directories and sub directories are shown in the list to the right.
+3. If you want to remove EGRID files from the list, select them and press the **Remove** button.
+4. When you are ready, press the **OK** button.
+
+ResInsight then creates a **Grid Case Group** for you, and populates its **Source Cases** with the Cases you selected. Then the first of those Cases are read completely, while the others are just scanned to verify that the Grids match and to detect changes in the Active Cells layout.
+
+This makes it quite fast to lo ad even a quite large number of realizations.
+
+#### Manually
+
+A Grid Case Group can be created from the context menu available when right clicking a Result Case, Input Case or a different Grid Case Group. **Source Cases** can then be added by using the mouse to *drag and drop* cases with equal grids into the **Grid Case Group**'s **Sorce Case** folder.
+This is useful if you want to create statistics based only on a subset of the source cases in an already created **Grid Case Group**.
+
+**Drag and Drop** of cases will normally copy the cases to the new destination, but moving them is possible by pressing and holding the **Shift** key while dropping.
+
+### Viewing special Source Cases
+To reduce the number of views, only a view for the first case is created automatically. If you want to inspect the results of a particular source case, right click the case and select **New view** from the context menu. A new 3D View will the be created on that particular case.
+
+*TIP:* To reduce memory usage, project loading time etc. it is vise to delete the 3D Views you do not need. 3D Views use a lot of system resources. 
 
 ### Statistics ##
-After creating a grid case group, an empty statistics object is created. Select the properties to evaluate statistics for, and push **Compute** to start the computation of statistics. This can take a while for large models.
-When the computation is complete, a view is automatically created containing the resulting generated statistics properties. Interaction with these generated properties are identical to interaction with other properties read from file.
+After creating a grid case group, an empty **Statistics Case** is created for you in the **Derived Statistics** folder of the **Grid Case Group**. The properties of an uncalculated and a calculated  **Statistics Case** is shown below:
 
+![](images/StatisticsCaseProperties.png)  ![](images/StatisticsCasePropertiesCalculated.png)
+
+- **Compute**: Starts to calculate requested statistical Properties.
+- **Edit** : Deletes the calculated results, and makes the controls to edit the setup available.
+- **Summary of calculation setup** : Summarizes what to calculate 
+- **Properties to consider**: These options makes it possible to select what Eclipse properties to include in the Statistical calculations. Adding variables increase the memory usage and the computational time.
+- **Percentile Setup**: Selects wether to calculate percentiles, what method and what percentile levels should be used. Turning this off speeds up the calculations.
+- **Well Data Source Case**: This option selects which set of **Simulation Wells** to be shown along with the statistical results. You can select one of the **Source Cases**.
+ 
+##### Percentile Methods
+
+Three Percentile methods are implemented:
+
+- **Interpolated Observation**
+The values are sorted, and the two observations representing the probabilities closest to the percentile are interpolated to find the value for the percentile. This is the default method.
+- **Nearest Observation**
+The values are sorted, and the first observation representing a probability higher or equal to the percentile probability is selected as the value for the percentile. This method is by some considered to be statistically more puristic.
+- **Histogram based estimate**
+A histogram is created and the percentile is calculated based on the histogram. This method will be faster when having a large number of realisations, because no value sorting is involved. You would however need several hundred realisations before this method should be considered.
+
+#### Viewing the results
+When the computation is complete, you have to create a 3D View on the **Statistics Case** to view the results. Use the Context menu available by right clicking the **Statistics Case** to create it.
+
+#### Adding Statistics Cases
 A new statistical calculation can be created by activating the context menu for **Derived Statistic->New Statistics Case**.
+
+
+
+
+
+
+
+

Documentation/UsersGuide/GettingStarted.md

@@ -61,11 +61,9 @@ This is a Case type that belongs to a *Grid Case Group* and makes statistical ca
 
 A **Grid Case Group** is a group of **Result Cases** whith identical grids, but generally different active cells, initial values and results. These cases are called *Source Cases*. 
 
-The purpose of a Grid Case group is to make it easy to calculate statistics across the source cases. If you have done several Eclipse simulations with different input parameters, you can put all the results into a Grid Case Group and easily calculate the cells mean value, range and max/min values at each timestep.
+The purpose of a Grid Case group is to make it easy to calculate statistics across the source cases both for static and dynamic Eclipse Properties. 
 
-A Grid Case Group can be created from a selection of binary files, or manually by assigning cases using the user interface of ResInsight.
-
-See also [ Multiple realizations and statistics ](CaseGroupsAndStatistics.md).
+See [ Multiple realizations and statistics ](CaseGroupsAndStatistics.md) for more on this.
 
 ### Importing data
 

Documentation/UsersGuide/UsersGuide.md

@@ -16,6 +16,7 @@ can also export modified cell property data sets to single Eclipse input files.
 
 - [ Getting Started ](GettingStarted.md)
 - [ Working with 3D Views ](ReservoirViews.md)
+- [ *Todo:* Well paths ]()
 - [ Multiple realizations and statistics ](CaseGroupsAndStatistics.md)
 - [ Octave Interface](OctaveInterface.md)
 - [ Command Line Arguments](CommandLineParameters.md)