These are release notes for opm-output.

opm-output is the output library within OPM and contains the following

The library is distributed under the GNU General Public License, version 3 or later (GPLv3+).

The opm-output module is designed to run on Linux platforms. It is also regularly run on Mac OS X. No efforts have been made to ensure that the code will compile and run on windows platforms.

sudo apt-get install -y build-essential cmake cmake-data util-linux

sudo apt-get install -y doxygen ghostscript texlive-latex-recommended pgf

sudo apt-get install -y git-core

sudo apt-get install -y libboost-all-dev

sudo apt-get install python-software-properties

sudo add-apt-repository -y ppa:opm/ppa sudo apt-get update

sudo apt-get install -y libtinyxml-dev

IMPORTANT: if you install this (binary) version of ERT, you will get the 2015.04 release version. That is only compatible with the 2015.04 release version of OPM! If you are building OPM from source you should use the latest master branches of both ERT and OPM.

sudo apt-get install ert.ecl

Note: You should compile the OPM modules using the same toolchain that was used to build DUNE. Otherwise, you can get strange ABI errors.

sudo zypper ar http://download.opensuse.org/repositories/science/openSUSE_12.3/science.repo

sudo zypper in boost-devel tinyxml-devel

sudo zypper in gcc gcc-c++ cmake git doxygen

git sudo zypper ar http://www.opm-project.org/packages/current/opensuse/12/opm.repo sudo zypper in zlib-devel ert.ecl-devel

(to remove the repository, run sudo zypper removerepo "Open Porous Media Initiative")

sudo yum install make gcc-c++ cmake28 util-linux

sudo yum install doxygen ghostscript texlive

sudo yum install git

sudo yum install boost-devel

sudo yum install tinyxml-devel sudo yum-config-manager --add-repo
http://www.opm-project.org/packages/current/redhat/6/opm.repo sudo yum install libsuperlu3 ert.ecl-devel

You can build opm-output with Apple Xcode 4.6 or later, Ruby 1.9 or later and the Homebrew port system:

brew tap homebrew/science brew tap opm/opm

caffeinate brew install ert.ecl caffeinate brew install --with-c++11 boost tinyxml

For a read-only download: git clone git://github.com/OPM/opm-output.git

If you want to contribute, fork OPM/opm-output on github.

There are two ways to build the opm-output library.

1. As a stand-alone library. In this setup we recommend creating an entirely separate directory outside the directory containing the source code and doing the build from that separate directory (termed "the build directory"). This configuration is sometimes referred to as an "out-of-source build".

As an example, consider the following layout in which "opm-output" refers to the directory containing the package source code as downloaded from GitHub

workspace
  |
  +-- build
  |
  +-- opm-output
  |     |
  |     +-- ...
  |     |
  |     +-- opm
  |     |
  |     +-- ...

We will configure a release-type (optimised) build using traditional Unix Makefiles within the "build" directory. The following command configures the build

cd path/to/build
cmake ../opm-output -DCMAKE_BUILD_TYPE=Release

If you want to debug the library you should specify the build type "Debug" instead of "Release" in the command above. This will disable optimizations and make it easier to step through the code.

Building the software then amounts to typing

make

in the top-level "build" directory; i.e., the directory from which we invoked the "cmake" utility. On a multi-core computer system you may want to build the software in parallel (make(1)'s "job-server" mode) in order to reduce the total amount of time needed to complete the build. To do so, replace the above "make" command with

make -j N

or, possibly,

nice -20 make -j N

in which "N" is an integer that should typically not exceed the number of cores in the system.

Once the library has been built, it can be installed in a central, system-wide location (often in "/usr/local") through the command

sudo make install

2. As a dune module.

• Put the opm-output directory in the same directory as the other dune modules to be built (e.g. dune-commmon, dune-grid). Note that for Ubuntu you can install Dune from the ppa as outlined above.
• Run dunecontrol as normal. For more information on the dune build system, see http://www.dune-project.org/doc/installation-notes.html

Efforts have been made to document the code with Doxygen. In order to build the documentation, enter the command

make doc

in the topmost directory.

Issues can be reported in the Git issue tracker online at:

http://github.com/OPM/opm-output/issues

To help diagnose build errors, please provide a link to a build log together with the issue description.

You can capture such a log from the build using the `script' utility, e.g.:

LOGFILE=$(date +%Y%m%d-%H%M-)build.log ;
cmake -E cmake_echo_color --cyan --bold "Log file: $LOGFILE" ;
script -q $LOGFILE -c 'cmake ../opm-output -DCMAKE_BUILD_TYPE=Debug' &&
script -q $LOGFILE -a -c 'ionice nice make -j 4 -l 3' ||
cat CMakeCache.txt CMakeFiles/CMake*.log >> $LOGFILE

The resulting file can be uploaded to for instance gist.github.com.