mirror of
https://github.com/OPM/ResInsight.git
synced 2025-02-25 18:55:39 -06:00
User Doc : Split out RegressionTestSystem
This commit is contained in:
parent
8f44ba33be
commit
69facd54a4
@ -10,47 +10,4 @@ Parameter|Description
|
||||
`-regressiontest <folder>` | Run a regression test on all sub-folders starting with `TestCase*` of the given folder. **RegressionTest.rip** files in the sub-folders will be opened and snapshots of all the views is written to the sub-sub-folder **RegTestGeneratedImages**. Then difference images is generated in the sub-sub-folder **RegTestDiffImages** based on the images in sub-sub-folder **RegTestBaseImages**. The results are presented in **ResInsightRegressionTestReport.html** that is written in the given folder.
|
||||
`-updateregressiontestbase <folder>` | For all sub-folders starting with `TestCase*`, copy the images in the sub-sub-folder **RegTestGeneratedImages** to the sub-sub-folder **RegTestBaseImages** after deleting **RegTestBaseImages** completely.
|
||||
|
||||
## Regression test system
|
||||
|
||||
A regression tool for QA is build into ResInsight. This tool will do the following:
|
||||
|
||||
1. Scan a directory for sub directories containing a RegressionTest.rip files.
|
||||
2. Each found project file will be opened, and all views in this project will be exported as snapshot images to file.
|
||||
3. When snapshot images from all projects are completed, difference images based on generated and QA-approved images are computed.
|
||||
4. Based on these three sets of images, an HTML report is created and automatically displayed.
|
||||
|
||||
### Starting regression tests
|
||||
|
||||
To be able to run regression tests you need the *compare* tool from the ImageMagic suite.
|
||||
|
||||
You can start the tests either from the command line or from the ResInsight Gui.
|
||||
From the ResInsight Gui select : **Debug -> Regression Test Dialog**
|
||||
|
||||

|
||||
|
||||
The **Application Working Folder** is basically the path to the executable of the image compare utility used, even though the CWD of Resinsight is temporarily changed to this path during execution.
|
||||
|
||||
### Creating regression tests
|
||||
|
||||
An example of the folder structure is shown below:
|
||||
|
||||
```
|
||||
RegressionTestFolder/
|
||||
TestCase1/
|
||||
RegressionTest.rip
|
||||
RegTestBaseImages/
|
||||
RegTestDiffImages/
|
||||
RegTestGeneratedImages/
|
||||
TestCase2/
|
||||
...
|
||||
```
|
||||
|
||||
To create regression tests you need to do the following:
|
||||
|
||||
1. Create a root directory containing one directory for each testcase.
|
||||
2. In each of the Test Case folders create a Resinsight project file called RegressionTest.rip.
|
||||
3. Run the regression test for the first time, and thereby creating images that can be used as Base images.
|
||||
4. Rename the generated RegTestGeneratedImages/ folder to RegTestBaseImages/
|
||||
|
||||
Now you are all set to test new releases of ResInsight towards your own Regression tests.
|
||||
|
||||
See also the [Regression Test System ](RegressionTestSystem.md) for a more in-depth explanation.
|
44
Documentation/UsersGuide/RegressionTestSystem.md
Normal file
44
Documentation/UsersGuide/RegressionTestSystem.md
Normal file
@ -0,0 +1,44 @@
|
||||
|
||||
## Regression test system
|
||||
|
||||
A regression tool for QA is build into ResInsight. This tool will do the following:
|
||||
|
||||
1. Scan a directory for sub directories containing a RegressionTest.rip files.
|
||||
2. Each found project file will be opened, and all views in this project will be exported as snapshot images to file.
|
||||
3. When snapshot images from all projects are completed, difference images based on generated and QA-approved images are computed.
|
||||
4. Based on these three sets of images, an HTML report is created and automatically displayed.
|
||||
|
||||
### Starting regression tests
|
||||
|
||||
To be able to run regression tests you need the *compare* tool from the ImageMagic suite.
|
||||
|
||||
You can start the tests either from the command line or from the ResInsight Gui.
|
||||
From the ResInsight Gui select : **Debug -> Regression Test Dialog**
|
||||
|
||||

|
||||
|
||||
The **Application Working Folder** is basically the path to the executable of the image compare utility used, even though the CWD of Resinsight is temporarily changed to this path during execution.
|
||||
|
||||
### Creating regression tests
|
||||
|
||||
An example of the folder structure is shown below:
|
||||
|
||||
```
|
||||
RegressionTestFolder/
|
||||
TestCase1/
|
||||
RegressionTest.rip
|
||||
RegTestBaseImages/
|
||||
RegTestDiffImages/
|
||||
RegTestGeneratedImages/
|
||||
TestCase2/
|
||||
...
|
||||
```
|
||||
|
||||
To create regression tests you need to do the following:
|
||||
|
||||
1. Create a root directory containing one directory for each testcase.
|
||||
2. In each of the Test Case folders create a Resinsight project file called RegressionTest.rip.
|
||||
3. Run the regression test for the first time, and thereby creating images that can be used as Base images.
|
||||
4. Rename the generated RegTestGeneratedImages/ folder to RegTestBaseImages/
|
||||
|
||||
Now you are all set to test new releases of ResInsight towards your own Regression tests.
|
@ -14,11 +14,18 @@ information and the corresponding cell property data sets.
|
||||
ResInsight also have support for extensive processing of the data sets through an interface to octave, and
|
||||
can also export modified cell property data sets to single Eclipse input files.
|
||||
|
||||
### Contents
|
||||
|
||||
- [ 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)
|
||||
- [ Octave Interface Reference](OctaveInterfaceReference.md)
|
||||
|
||||
### Appendix
|
||||
|
||||
- [ Octave Interface Reference](OctaveInterfaceReference.md)
|
||||
- [ Regression Test System ](RegressionTestSystem.md)
|
||||
- [ Command Line Arguments](CommandLineParameters.md)
|
||||
|
||||
|
||||
|
BIN
Documentation/UsersGuide/images/CaseProperties.png
Normal file
BIN
Documentation/UsersGuide/images/CaseProperties.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 4.9 KiB |
BIN
Documentation/UsersGuide/images/TopLink.png
Normal file
BIN
Documentation/UsersGuide/images/TopLink.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 554 B |
Loading…
Reference in New Issue
Block a user