diff --git a/Documentation/UsersGuide/CommandLineParameters.md b/Documentation/UsersGuide/CommandLineParameters.md index 91b1fcd578..069813ca84 100644 --- a/Documentation/UsersGuide/CommandLineParameters.md +++ b/Documentation/UsersGuide/CommandLineParameters.md @@ -10,47 +10,4 @@ Parameter|Description `-regressiontest ` | 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 ` | 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** - -![](images/RegressionTestDialog.png) - -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. \ No newline at end of file diff --git a/Documentation/UsersGuide/RegressionTestSystem.md b/Documentation/UsersGuide/RegressionTestSystem.md new file mode 100644 index 0000000000..d8e7fe8356 --- /dev/null +++ b/Documentation/UsersGuide/RegressionTestSystem.md @@ -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** + +![](images/RegressionTestDialog.png) + +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. diff --git a/Documentation/UsersGuide/UsersGuide.md b/Documentation/UsersGuide/UsersGuide.md index 0ae015aec1..2c5633cf12 100644 --- a/Documentation/UsersGuide/UsersGuide.md +++ b/Documentation/UsersGuide/UsersGuide.md @@ -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) + diff --git a/Documentation/UsersGuide/images/CaseProperties.png b/Documentation/UsersGuide/images/CaseProperties.png new file mode 100644 index 0000000000..fe98659132 Binary files /dev/null and b/Documentation/UsersGuide/images/CaseProperties.png differ diff --git a/Documentation/UsersGuide/images/TopLink.png b/Documentation/UsersGuide/images/TopLink.png new file mode 100644 index 0000000000..be404c4ffd Binary files /dev/null and b/Documentation/UsersGuide/images/TopLink.png differ