Merge branch 'next-major-release' into main

content/3d-main-window/Formations.md

@@ -97,9 +97,6 @@ Formation can be used to annotate the following plot types:
 - [Well Log Plots]({{< relref "welllogsandplots" >}})
 - [RFT Plots]({{< relref "rftplot" >}})
 - [PLT Plots]({{< relref "pltplot" >}})
-- [Well Allocation Plots]({{< relref "flow-diagnostics-plots" >}})
-
-![]({{< relref "" >}}images/3d-main-window/formOnPlot.PNG) MANGLER BILDE
 
 For RFT and PLT Plots, **Zonation/Formation Names** can be found in the plot's **Property Editor**. Tick "Show Formations" and choose the case with the desired formations. 
 

content/Calculated Data/AggregationOfGridCellValues.md

@@ -0,0 +1,22 @@
++++
+title = "Aggregation of Grid Cell Values"
+published = true
+weight = 20
++++
+
+### Calculate statistics for sum of mobile oil for an ensemble
+
+**Workflow description**
+
+- Import an ensemble of grid models with identical IJK into a **Grid Case Group**.
+- Create a view on one of the source grid models, and create a cell filter.
+- Create an expression for mobile oil `MOBILE_OIL := if(((SOIL-SOWCR) < 0.00), 0.00, PORV*(SOIL-SOWCR))`
+- Optionally select a subset of time steps
+- Create an expression to sum values for all visible cells `SUM_MOBILE_OIL := sum(MOBILE_OIL)` Use the result from the previous calculation as input to the variable, use `MOBILE_OIL` from the **Generated** category.
+- The individual values for each realization and time step is displayed as text in **Messages**. The statistics for each time step is displayed at the bottom.
+
+
+![image](https://github.com/OPM/ResInsight/assets/1793152/bf53a448-94ce-4fbb-850e-b912c060a6d4)
+
+See draft workflow with screenshots here:
+https://github.com/OPM/ResInsight/discussions/10913

content/3d-main-window/CaseGroupsAndStatistics.md → content/Calculated Data/CaseGroupsAndStatistics.md

@@ -2,13 +2,16 @@
 title = "Grid Case Groups and Statistics"
 published = true
 weight = 120
+aliases = [
+    "/3d-main-window/casegroupsandstatistics/"
+]
 +++
 
 ![]({{< relref "" >}}images/3d-main-window/GridCaseGroupTree.png)
 
 **Grid Case Group**'s are designed to make it easy to calculate statistics per cell and per time step 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 time step between the 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 time step. Grid calculations can optionally be used as a data source for computations.
 
 ## Creating Grid Case Groups
 
@@ -38,16 +41,33 @@ To reduce memory usage, project loading time etc. remember to delete the 3D View
 After creating a grid case group, an empty **Statistics Case** is created for you in the **Derived Statistics** folder of the **Grid Case Group**. 
 
 ### Setting Up and Calculate
-The properties of non-calculated and calculated **Statistics Case** is shown below:
 
-![]({{< relref "" >}}images/3d-main-window/StatisticsCaseProperties.png)  ![]({{< relref "" >}}images/3d-main-window/StatisticsCasePropertiesCalculated.png)
+**Settings for grid case property statistics**
+
+![]({{< relref "" >}}images/calculated-data/StatisticsCaseProperties.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 whether 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**.
+
+
+**Settings for grid cell calculations**
+
+![]({{< relref "" >}}images/calculated-data/StatisticsCaseGridCalculation.png  )  
+
+- **Data Source** --  Defines either a cell property or a grid calculation expression to be used as data source for the statistical calculations.
+- **Grid Calculation** -- List of all defined calculations in the project.
+- **Filter By View** -- Limit the calculation to visible cells in a selected view.
+
+Cell values in a selection of cells can be aggregated as described in [Aggregation of Grid Cell Values]({{< relref "aggregationofgridcellvalues" >}})
+
+**Settings for when statistics has been computed**
+
+![]({{< relref "" >}}images/calculated-data/StatisticsCaseGridAfterComputations.png )
+
 
 #### Percentile Methods
 

content/Calculated Data/CurveCalculator.md

@@ -13,6 +13,8 @@ The summary curve calculator is a tool to do calculations on a set of curves. Th
 
 The calculator can be run by pressing the calculator icon {{< image-in-text src="images/Calculator.svg" >}} in the menu bar, or by right-clicking on either a summary case or the summary plot collection.
 
+Expressions can be saved to a text file using the **Export Calculations** button. The default location for calculations can be set in **Preference->Import/Export**.
+
 More details on mathematical operations are described in [Calculator Expressions]({{< ref "CalculatorExpressions.md" >}})
 
 ## Calculation Settings

content/Calculated Data/DerivedResults.md

@@ -27,6 +27,10 @@ Transmissibility can be set or adjusted with multiple keywords in an Eclipse dat
 
 The TRANX, TRANY and TRANZ used in the simulation are divided by the ResInsight calculated transmissibilities and the resulting multiplicators are named **riMULTX**, **riMULTY** and **riMULTZ** respectively. The derived properties are listed under **Static** properties. The riMULT-properties are useful for quality checking consistence in user input for fault seal along a fault plane. 
 
+### Classification of Cells having NNCs
+
+The static result **riNncCells** use 1 to represent cells having a NNC and 0 for other cells.
+
 ### Directional Combined Results
 
 Cell properties with names ending in I, J, K, X, Y, or Z, and an optional "+" or "-" are combined into derived results post-fixed with IJK, or XYZ depending on their origin. (Eg. the static cell properties MULTX, MULTY, MULTZ, and their negatives are combined into the result MULTXYZ, while the dynamic cell properties FLRGASI, FLRGASJ, FLRGASK are combined to FLRGASIJK). 

content/Calculated Data/GridPropertyCalculator.md

@@ -10,7 +10,9 @@ aliases = [
 ![]({{< relref "" >}}images/3d-main-window/GridPropertyCalculatorMain.png)
 
 ResInsight offers a built-in property calculator for grid parameters. 
-The **Grid Property Calculator** enables arithmetic expressions to be parsed and calculated for visualization purposes.
+The **Grid Property Calculator** enables arithmetic expressions to be parsed and calculated for visualization purposes. The expression can be applied to one or multiple grid models, and the expression text can be stored to a file for later use.
+
+Expressions can be saved to a text file using the **Export Calculations** button. The default location for calculations can be set in **Preference->Import/Export**.
 
 More details on mathematical operations are described in [Calculator Expressions]({{< ref "CalculatorExpressions.md" >}})
 
@@ -62,3 +64,6 @@ The calculated result is accessable via **Property Editor** as **Type** ***Gener
 1. Access the calculated result in **Property Editor** as **Type** ***Generated*** **Result Property**
 
 ![]({{< relref "" >}}images/3d-main-window/GridPropertyCalculatorSolo.png)
+
+## Storage of Expressions to File
+Use **Import Calculations** and **Export Calculations** to store and load expressions to and from a file.

content/getting-started/download-and-install/_index.md

@@ -22,6 +22,8 @@ ResInsight is under continuous development targeting two major releases per year
 For an overview of some of its new and exciting features, see the following: 
 
 
+- [ ResInsight 2023.12 ]({{< ref "releasenotes_2023_12.md" >}})
+
 - [ ResInsight 2023.10 ]({{< ref "releasenotes_2023_10.md" >}})
 
 - [ ResInsight 2023.06 ]({{< ref "releasenotes_2023_06.md" >}})

content/getting-started/whats-new/releasenotes_2023_12.md

@@ -0,0 +1,37 @@
++++
+title = "What's New in 2023.12"
+published = true
+weight = 10
+hidden = true
++++
+
+## Grid Calculations
+
+- [Grid Property Calculations]({{< relref "gridpropertycalculator" >}}) can now be applied to multiple grid cases.
+- A grid calculation can be used as data source for [Grid Case Statistics]({{< relref "casegroupsandstatistics" >}}). The data source for statistics computations can either be a cell property or a grid calculation expression.
+- Time step selection is added to the **Grid Case Statistics** settings to reduce computation demand.
+- Expressions can be stored to a file and loaded from a file. This makes it possible to reuse expressions in multiple projects.
+
+## Aggregated Grid Calculations
+When using a aggregation expression like **sum** the resulting value will be available as a cell result (the single value is duplicated and displayed for all cells used in the calculation). If the calculation is applied to multiple grids, the aggregated value for each realization will be displayed in the **Messages** dialog. For each time step, the statistical values are also computed and displayed as text.
+
+[Aggregation of Grid Cell Values Example]({{< relref "aggregationofgridcellvalues" >}})
+
+## Summary Improvements
+- The summary plot editor has been reworked to make it easier to use and to make it more consistent with the generated plots. The preview plot title is removed, and preview curves are using multiple axes similar to other plots.
+- Space between curve icon and text in legend is increased to make it easier to read
+- Fixed missing curve legend when clicking on curves (Happens on some Linux distributions)
+- Added flag to optionally distribute a summary calculation to all cases
+- Summary expressions can be stored to a file and loaded from a file. This makes it possible to reuse expressions in multiple projects.
+
+## Automation of RFT PLots
+Multiple RFT plots can now be created using the **Create Multiple RFT Plots** menu item. The operation will create one plot for each RFT well.
+
+## Other improvements
+- Fixed a crash issue when using the summary toolbar
+- Fixed a crash when toggling on [Well Allocation Over Time]({{< relref "wellallocationovertimeplot" >}}) plot
+- Regression Analysis: Fixed crash after modifying the expression
+- Completion export: Exclude COMPDAT for deactivated laterals
+
+
+See [**Release Notes on GitHub**](https://github.com/OPM/ResInsight/releases/) for further details and information.

content/plot-window/EnsembleRftPlot.md

@@ -125,6 +125,23 @@ Example file  for well *OP_1*, i.e. *OP_1.obs*:
 305.000   3.000
 ```
 
+#### Observed pressure and error - multiple observations for a well
+If there are multiple observations for a well at different dates, the naming of the files include a measurement ID
+
+Example file *well_date_rft.txt*:
+```txt
+R_A2 2018-03-01 1
+R_A2 2019-03-01 2
+```
+
+Measurement ID is the last column. The corresponding observations files are named as follows, the measurement ID is appended to the well name.
+```txt
+R_A2_1.obs
+R_A2_1.txt
+R_A2_2.obs
+R_A2_2.txt
+```
+
 #### Reservoir zone name
 For a given well name, the file *\<well_name>.txt* is a data file containing five columns that specify its correlation with reservoir zones. 
 Each line of data must contain:
@@ -142,7 +159,7 @@ Example file for well *OP_1*, i.e. *OP_1.txt*:
 461288.683   5933415.029   1840.000   1635.492   LowerReek
 ```
 
-#### Well measurements
+#### Well measurements - date format 1
 The data file *well_date_rft.txt* contains well measurements. The file contains four columns for each well measurement:
 
 - Well Name
@@ -161,3 +178,21 @@ OP_4   01 01 2001   1
 WI_1   01 02 2000   1
 WI_3   01 03 2001   1
 ```
+
+#### Well measurements - date format 2
+The data file *well_date_rft.txt* contains well measurements. The file contains four columns for each well measurement:
+
+- Well Name
+- Date on the format \<YYYY-MM-DD>
+- Measurement index
+
+There can be multiple measurement for each well.
+
+Example file *well_date_rft.txt*:
+```txt
+R_A2 2018-03-01 1
+R_A2 2019-03-01 2
+R_A6 2018-11-07 1
+R_A6 2018-11-07 2
+R_A6 2018-11-07 3
+```

content/plot-window/RftPlot.md

@@ -12,17 +12,21 @@ An RFT (_Repeated Formation Tester_) plot is a special well plot for comparing o
 ## Create New RFT Plot
 There are several ways to create new RFT Plots.
 
-**From the Project Tree in the Plot Main Window**
-
-- Select right-click command **New RFT Plot** for _Well Path_ node or _RFT Plots_ node.
-
-**From the Project Tree in the 3D Main Window**
-
-- Select right-click command **New RFT plot** for a simulation well.
-
-**From a 3D view**
-
-- Right-click a simulation well select **Well Plots -> New RFT Plot**.
+- From the Project Tree in the Plot Main Window
+  - Select right-click command **New RFT Plot** for _Well Path_ node or _RFT Plots_ node.
+- From the Project Tree in the 3D Main Window
+  - Select right-click command **New RFT plot** for a simulation well.
+- From a 3D view
+  - Right-click a simulation well select **Well Plots -> New RFT Plot**.
+
+## Create Multiple RFT Plots
+ResInsight can automate the creation of multiple plots based on an already exising RFT plot.
+
+Description of the workflow:
+- create a RFT plot for one well
+- on the right-click menu of this plot, select **Create Multiple RFT Plots**
+- a list of available wells is displayed, and the user can select the wells
+- click OK, and the plots for selected wells are created
 
 ## Import Observed RFT Data
 

docs/rips/PythonExamples/modeled_well_path.py

@@ -45,3 +45,28 @@
 )
 perforation.skin_factor = new_skin_factor
 perforation.update()
+
+# Optionally update the completion settings
+completions_settings = well_path.completion_settings()
+completions_settings.msw_roughness = 12.34
+completions_settings.msw_liner_diameter = 0.2222
+completions_settings.well_name_for_export = "file name"
+completions_settings.group_name_for_export = "msj"
+completions_settings.well_type_for_export = "GAS"
+completions_settings.update()  # Commit updates back to ResInsight
+
+# export completions
+cases = resinsight.project.cases()
+
+for case in cases:
+    print("Case name: ", case.name)
+    print("Case id: ", case.id)
+
+    case.export_well_path_completions(
+        time_step=0,
+        well_path_names=["Test Well-1 Y1"],
+        file_split="UNIFIED_FILE",
+        include_perforations=True,
+        # Replace the following with a valid path
+        custom_file_name="f:/scratch/2023-11-02/myfile.myext",
+    )

docs/source/conf.py

@@ -21,7 +21,7 @@
 # -- Project information -----------------------------------------------------
 
 project = 'ResInsight Python API - rips'
-copyright = '2021, Ceetron Solutions AS'
+copyright = 'Ceetron Solutions AS'
 author = 'Ceetron Solutions AS'
 
 # The full version, including alpha/beta/rc tags