Simulator programs and utilities for automatic differentiation.
Go to file
Bård Skaflestad f482e89e48 Defer searching for opm-parser
The "opm-parser" module is expected to become dependent upon the ERT
library.  Defer searching for the parser module until we've
established whether or not ERT is availble.

Suggested by: @andlaus
2014-03-11 20:09:09 +01:00
cmake Defer searching for opm-parser 2014-03-11 20:09:09 +01:00
debian add debian packaging 2013-10-22 13:02:12 +02:00
doc/doxygen Fix minor issues pointed out by bska. 2013-09-23 13:02:56 +02:00
examples use the SimulatorTimer which is based on opm-parser's TimeMap 2014-02-27 11:56:33 +01:00
m4 Compatibility module for dunecontrol-driven clients 2013-08-14 22:47:24 +02:00
opm/autodiff Using well_controls_well_is_open() function 2014-03-04 14:49:54 +01:00
redhat make packaging compatible with EL5 2013-10-30 17:52:37 +01:00
tests Reverting some const_casting, that was introduced with no real reason 2014-02-05 21:24:38 +01:00
.gitignore Ignore autosave files from Vim. 2013-05-14 17:45:20 +02:00
CMakeLists_files.cmake Merged upstream/master 2014-01-29 15:25:21 +01:00
CMakeLists.txt Added sim_fibo_ad_test, running two identical simulations with the SPE1 case 2013-11-26 12:55:41 +01:00
configure Search for directory containing build scripts 2013-08-16 23:55:44 +02:00
CTestConfig.cmake Import CMake support from OPM-Core 2013-05-15 10:24:52 +02:00
dune.module Reduce version to 0.9. 2013-10-25 14:56:54 +02:00
README.md Updated to address points raised by bska. 2013-09-24 13:44:32 +02:00

Open Porous Media Automatic Differentiation Library

CONTENT

opm-autodiff contains a small library for automatic differentiation built on the Eigen linear algebra package. It also contains some experimental solver and simulator prototypes demonstrating how it can be used. The most important parts are:

  • AutoDiffBlock.hpp (class for AD on vectorized data with sparse jacobians)
  • AutoDiffHelpers.hpp (various utilities to simplify writing solvers)
  • sim_fibo_ad.cpp (prototype fully implicit black-oil simulator)

LICENSE

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

PLATFORMS

The opm-autodiff 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.

REQUIREMENTS

opm-autodiff requires opm-core, and all its requirements (see opm-core/README). In addition, opm-autodiff requires Eigen, version 3.1 (has not been tested with later versions).

DOWNLOADING

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

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

BUILDING

See build instructions in opm-core/README, or at http://opm-project.org/download.php.

DOCUMENTATION

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. The class AutoDiffBlock is the most important and most well-documented.

REPORTING ISSUES

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

https://github.com/OPM/opm-autodiff/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-core -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.