126 lines
4.2 KiB
C++
126 lines
4.2 KiB
C++
/// \cond SKIP
|
|
/*!
|
|
Copyright 2012 SINTEF ICT, Applied Mathematics.
|
|
|
|
This file is part of the Open Porous Media project (OPM).
|
|
|
|
OPM is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
OPM is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with OPM. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
///\endcond
|
|
|
|
/// \page tutorial1 A simple cartesian grid
|
|
/// This tutorial explains how to construct a simple Cartesian grid,
|
|
/// and we will take a look at some output facilities.
|
|
|
|
/// \page tutorial1
|
|
/// \section commentedsource1 Program walk-through.
|
|
/// All headers from opm-core are found in the opm/core/ directory.
|
|
/// Some important headers are at the root, other headers are found
|
|
/// in subdirectories.
|
|
/// \snippet tutorial1.cpp including headers
|
|
|
|
/// \internal [including headers]
|
|
#ifdef HAVE_CONFIG_H
|
|
#include "config.h"
|
|
#endif
|
|
|
|
#include <opm/core/grid.h>
|
|
#include <opm/core/grid/GridManager.hpp>
|
|
#include <opm/core/io/vtk/writeVtkData.hpp>
|
|
#include <iostream>
|
|
#include <fstream>
|
|
#include <vector>
|
|
/// \internal [including headers]
|
|
/// \endinternal
|
|
|
|
// ----------------- Main program -----------------
|
|
|
|
int main()
|
|
try
|
|
{
|
|
/// \page tutorial1
|
|
/// We set the number of blocks in each direction.
|
|
/// \snippet tutorial1.cpp num blocks
|
|
/// \internal [num blocks]
|
|
int nx = 4;
|
|
int ny = 3;
|
|
int nz = 2;
|
|
/// \internal [num blocks]
|
|
/// \endinternal
|
|
/// The size of each block is 1m x 1m x 1m. The default units are always the
|
|
/// standard units (SI). But other units can easily be dealt with, see Opm::unit.
|
|
/// \snippet tutorial1.cpp dim
|
|
/// \internal [dim]
|
|
double dx = 1.0;
|
|
double dy = 1.0;
|
|
double dz = 1.0;
|
|
/// \internal [dim]
|
|
/// \endinternal
|
|
/// \page tutorial1
|
|
/// In opm-core, grid information is accessed via the UnstructuredGrid data structure.
|
|
/// This data structure has a pure C API, including helper functions to construct and
|
|
/// destroy the data structure. In this tutorial however, we will use Opm::GridManager,
|
|
/// which is a C++ class that wraps the UnstructuredGrid and takes care of
|
|
/// object lifetime issues.
|
|
/// One of the constructors of the class Opm::GridManager takes <code>nx, ny, nz, dx, dy, dz</code>
|
|
/// and construct the corresponding Cartesian grid.
|
|
/// \snippet tutorial1.cpp grid manager
|
|
/// \internal [grid manager]
|
|
Opm::GridManager grid(nx, ny, nz, dx, dy, dz);
|
|
/// \internal [grid manager]
|
|
/// \endinternal
|
|
/// \page tutorial1
|
|
/// We open an output file stream for the output
|
|
/// \snippet tutorial1.cpp output stream
|
|
/// \internal [output stream]
|
|
std::ofstream vtkfile("tutorial1.vtu");
|
|
/// \internal [output stream]
|
|
/// \endinternal
|
|
/// \page tutorial1
|
|
/// The Opm::writeVtkData() function writes a grid together with
|
|
/// data to a stream. Here, we just want to visualize the grid. We
|
|
/// construct an empty Opm::DataMap object, which we send to
|
|
/// Opm::writeVtkData() together with the grid
|
|
/// \snippet tutorial1.cpp data map
|
|
/// \internal [data map]
|
|
Opm::DataMap dm;
|
|
/// \internal [data map]
|
|
/// \endinternal
|
|
/// \page tutorial1
|
|
/// Call Opm::writeVtkData() to write the output file.
|
|
/// \snippet tutorial1.cpp write vtk
|
|
/// \internal [write vtk]
|
|
Opm::writeVtkData(*grid.c_grid(), dm, vtkfile);
|
|
/// \internal [write vtk]
|
|
/// \endinternal
|
|
}
|
|
catch (const std::exception &e) {
|
|
std::cerr << "Program threw an exception: " << e.what() << "\n";
|
|
throw;
|
|
}
|
|
|
|
/// \page tutorial1
|
|
/// We read the vtu output file in \a Paraview and obtain the following grid.
|
|
/// \image html tutorial1.png
|
|
|
|
/// \page tutorial1
|
|
/// \section completecode1 Complete source code:
|
|
/// \include tutorial1.cpp
|
|
|
|
/// \page tutorial1
|
|
/// \details
|
|
/// \section pythonscript1 Python script to generate figures:
|
|
/// \snippet generate_doc_figures.py tutorial1
|
|
|