/*
  Copyright 2019-2020 Equinor ASA
  Copyright 2014 Andreas Lauser

  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/>.
*/

#include <opm/input/eclipse/EclipseState/Grid/SatfuncPropertyInitializers.hpp>

#include <opm/input/eclipse/EclipseState/Runspec.hpp>
#include <opm/input/eclipse/EclipseState/Tables/SgfnTable.hpp>
#include <opm/input/eclipse/EclipseState/Tables/SgofTable.hpp>
#include <opm/input/eclipse/EclipseState/Tables/SlgofTable.hpp>
#include <opm/input/eclipse/EclipseState/Tables/SgwfnTable.hpp>
#include <opm/input/eclipse/EclipseState/Tables/Sof2Table.hpp>
#include <opm/input/eclipse/EclipseState/Tables/Sof3Table.hpp>
#include <opm/input/eclipse/EclipseState/Tables/SwfnTable.hpp>
#include <opm/input/eclipse/EclipseState/Tables/SwofTable.hpp>
#include <opm/input/eclipse/EclipseState/Tables/GsfTable.hpp>
#include <opm/input/eclipse/EclipseState/Tables/WsfTable.hpp>
#include <opm/input/eclipse/EclipseState/Tables/Tabdims.hpp>
#include <opm/input/eclipse/EclipseState/Tables/TableColumn.hpp>
#include <opm/input/eclipse/EclipseState/Tables/TableContainer.hpp>
#include <opm/input/eclipse/EclipseState/Tables/TableManager.hpp>

#include <opm/input/eclipse/Utility/Functional.hpp>

#include <algorithm>
#include <array>
#include <cassert>
#include <exception>
#include <functional>
#include <iterator>
#include <memory>
#include <stdexcept>
#include <string>
#include <type_traits>
#include <utility>

#include <stddef.h>

// Note on deriving critical saturations: All table scanners are implemented
// in terms of std::lower_bound(begin, end, tolcrit, predicate) which returns
// the first position in [begin, end) for which
//
//     predicate(*iter, tolcrit)
//
// is false.  Using predicate = std::greater<>{} thus determines the first
// position in the sequence for which the elements is less than or equal to
// 'tolcrit'.  Similarly, a predicate equivalent to '<=' returns the first
// position for which the elements is strictly greater than 'tolcrit'.

namespace {

    using ::Opm::satfunc::RawTableEndPoints;

    /*
     * See the "Saturation Functions" chapter in the Eclipse Technical
     * Description; there are several alternative families of keywords which
     * can be used to enter relperm and capillary pressure tables.
     *
     * If SWOF and SGOF are specified in the deck it returns I
     * If SGWFN, SWFN, SGFN and SOF3 are specified in the deck it returns II
     * If keywords are missing or mixed, an error is given.
     */
    enum class SatfuncFamily { none = 0, I = 1, II = 2, III = 3 };

    SatfuncFamily
    getSaturationFunctionFamily(const Opm::TableManager& tm,
                                const Opm::Phases&       ph)
    {
        const auto wat    = ph.active(::Opm::Phase::WATER);
        const auto oil    = ph.active(::Opm::Phase::OIL);
        const auto gas    = ph.active(::Opm::Phase::GAS);

        const auto threeP = (gas + oil + wat) == 3;
        const auto twoP = (gas + oil + wat) == 2;

        if (! (twoP || threeP)) {
            // Single-phase run.  No family identified or needed.
            return SatfuncFamily::none;
        }

        const auto family1 =       // SGOF/SLGOF and/or SWOF
            (gas && ((tm.hasTables("SGOF") || !tm.getSgofletTable().empty()) || tm.hasTables("SLGOF"))) ||
            (wat && (tm.hasTables("SWOF") || !tm.getSwofletTable().empty()));
        // note: we allow for SOF2 to be part of family1 for threeP + solvent simulations.

        const auto family2 =      // SGFN, SOF{2,3}, SWFN, SGWFN
            (gas && (tm.hasTables("SGFN") || tm.hasTables("SGWFN"))) ||
            (oil && ((threeP && tm.hasTables("SOF3")) ||
                     (twoP && tm.hasTables("SOF2")))) ||
            (wat && tm.hasTables("SWFN"));

        const auto family3 = //WSF, GSF gas-water CO2STORE case
            tm.hasTables("GSF") &&
            tm.hasTables("WSF");

        if (gas && tm.hasTables("SGOF") && tm.hasTables("SLGOF")) {
            throw std::invalid_argument("Both SGOF and SLGOF have been specified but these tables are mutually exclusive!");
        }

        if (family1 && family2) {
            throw std::invalid_argument("Saturation families should not be mixed\n"
                                        "Use either SGOF (or SLGOF) and/or SWOF or SGFN/SWFN and SOF2/SOF3");
        }

        if (family3 && !(gas && wat)) {
            throw std::invalid_argument("Saturation family 3 should only be used for GAS and WATER case");
        }

        if (family1)
            return SatfuncFamily::I;

        if (family2)
            return SatfuncFamily::II;

        if (family3)
            return SatfuncFamily::III;

        throw std::invalid_argument {
            "Saturation functions must be specified using "
            "either family 1 or family 2 keywords\n"
            "Use either SGOF (or SLGOF) and/or SWOF or SGFN/SWFN or SGWFN and SOF2/SOF3"
        };
    }

    std::vector<double>
    findMinWaterSaturation(const Opm::TableManager& tm,
                           const Opm::Phases&       ph)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::WATER))
            return std::vector<double>(num_tables, 0.0);

        const auto& swofTables = tm.getSwofTables();
        const auto& swofLetTables  = tm.getSwofletTable();
        const auto& swfnTables = tm.getSwfnTables();
        const auto& sgwfnTables = tm.getSgwfnTables();
        const auto& wsfTables = tm.getWsfTables();

        const auto famI = [&swofTables]( int i ) {
            return swofTables.getTable<Opm::SwofTable>( i ).getSwColumn().front();
        };

        const auto famI_let = [&swofLetTables]( int i ) {
            return swofLetTables[i].s1_residual;
        };

        const auto famII = [&swfnTables]( int i ) {
            return swfnTables.getTable<Opm::SwfnTable>( i ).getSwColumn().front();
        };
        const auto famII_sgwfn = [&sgwfnTables]( int i ) {
            return 1.0 - sgwfnTables.getTable<Opm::SgwfnTable>( i ).getSgColumn().back();
        };
        const auto famIII = [&wsfTables]( int i ) {
            return wsfTables.getTable<Opm::WsfTable>( i ).getSwColumn().front();
        };
        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( !swofTables.empty() )
                    return Opm::fun::map( famI, Opm::fun::iota( num_tables ) );
                else if ( !swofLetTables.empty() )
                    return Opm::fun::map( famI_let, Opm::fun::iota( num_tables ) );
                else
                    throw std::domain_error("Either SWOF or SWOFLET tables must be provided");

            case SatfuncFamily::II: 
                if( !swfnTables.empty() )
                    return map( famII, Opm::fun::iota( num_tables ) );
                else
                    return map( famII_sgwfn, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III: return map( famIII, Opm::fun::iota( num_tables ) );
            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    std::vector<double>
    findMaxWaterSaturation(const Opm::TableManager& tm,
                           const Opm::Phases&       ph)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::WATER))
            return std::vector<double>(num_tables, 0.0);

        const auto& swofTables = tm.getSwofTables();
        const auto& swofLetTables  = tm.getSwofletTable();
        const auto& swfnTables = tm.getSwfnTables();
        const auto& sgwfnTables = tm.getSgwfnTables();
        const auto& wsfTables = tm.getWsfTables();

        const auto famI = [&swofTables]( int i ) {
            return swofTables.getTable<Opm::SwofTable>( i ).getSwColumn().back();
        };

        const auto famI_let = [&swofLetTables]( int i ) {
            return 1.0 - swofLetTables[i].s2_residual;
        };

        const auto famII = [&swfnTables]( int i ) {
            return swfnTables.getTable<Opm::SwfnTable>( i ).getSwColumn().back();
        };
        const auto famII_sgwfn = [&sgwfnTables]( int i ) {
            return 1.0 - sgwfnTables.getTable<Opm::SgwfnTable>( i ).getSgColumn().front();
        };
        const auto famIII = [&wsfTables]( int i ) {
            return wsfTables.getTable<Opm::WsfTable>( i ).getSwColumn().back();
        };
        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( !swofTables.empty() )
                    return map( famI, Opm::fun::iota( num_tables ) );
                else if ( !swofLetTables.empty() )
                    return Opm::fun::map( famI_let, Opm::fun::iota( num_tables ) );
                else
                    throw std::domain_error("Either SWOF or SWOFLET tables must be provided");

            case SatfuncFamily::II:
                if( !swfnTables.empty() ) 
                    return map( famII, Opm::fun::iota( num_tables ) );
                else
                    return map( famII_sgwfn, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III: return map( famIII, Opm::fun::iota( num_tables ) );

            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    std::vector<double>
    findMinGasSaturation(const Opm::TableManager& tm,
                         const Opm::Phases&       ph)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::GAS))
            return std::vector<double>(num_tables, 0.0);

        const auto& sgofTables  = tm.getSgofTables();
        const auto& sgofLetTables  = tm.getSgofletTable();
        const auto& slgofTables = tm.getSlgofTables();
        const auto& sgfnTables = tm.getSgfnTables();
        const auto& sgwfnTables = tm.getSgwfnTables();
        const auto& gsfTables = tm.getGsfTables();

        const auto famI_sgof = [&sgofTables]( int i ) {
            return sgofTables.getTable<Opm::SgofTable>( i ).getSgColumn().front();
        };

        const auto famI_sgof_let = [&sgofLetTables]( int i ) {
            return sgofLetTables[i].s1_residual;
        };

        const auto famI_slgof = [&slgofTables]( int i ) {
            return 1.0 - slgofTables.getTable<Opm::SlgofTable>( i ).getSlColumn().back();
        };

        const auto famII = [&sgfnTables]( int i ) {
            return sgfnTables.getTable<Opm::SgfnTable>( i ).getSgColumn().front();
        };
        const auto famII_sgwfn = [&sgwfnTables]( int i ) {
            return sgwfnTables.getTable<Opm::SgwfnTable>( i ).getSgColumn().front();
        };
        const auto famIII = [&gsfTables]( int i ) {
            return gsfTables.getTable<Opm::GsfTable>( i ).getSgColumn().front();
        };
        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( sgofTables.empty() && sgofLetTables.empty() && slgofTables.empty() )
                    throw std::runtime_error( "Saturation keyword family I requires either sgof or slgof non-empty" );

                if( !sgofTables.empty() )
                    return Opm::fun::map( famI_sgof, Opm::fun::iota( num_tables ) );
                else if( !sgofLetTables.empty() )
                    return Opm::fun::map( famI_sgof_let, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famI_slgof, Opm::fun::iota( num_tables ) );

            case SatfuncFamily::II:
                if( !sgfnTables.empty() )
                    return Opm::fun::map( famII, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famII_sgwfn, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                return Opm::fun::map( famIII, Opm::fun::iota( num_tables ) );

            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    std::vector<double>
    findMaxGasSaturation(const Opm::TableManager& tm,
                         const Opm::Phases&       ph)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::GAS))
            return std::vector<double>(num_tables, 0.0);

        const auto& sgofTables  = tm.getSgofTables();
        const auto& sgofLetTables  = tm.getSgofletTable();
        const auto& swofLetTables  = tm.getSwofletTable();
        const auto& slgofTables = tm.getSlgofTables();
        const auto& sgfnTables = tm.getSgfnTables();
        const auto& sgwfnTables = tm.getSgwfnTables();
        const auto& gsfTables = tm.getGsfTables();

        const auto famI_sgof = [&sgofTables]( int i ) {
            return sgofTables.getTable<Opm::SgofTable>( i ).getSgColumn().back();
        };

        const auto famI_sgof_let = [&swofLetTables]( int i ) {
            // Assume this to be 1-swco
            return 1.0 - swofLetTables[i].s1_residual;
        };

        const auto famI_slgof = [&slgofTables]( int i ) {
            return 1.0 - slgofTables.getTable<Opm::SlgofTable>( i ).getSlColumn().front();
        };

        const auto famII = [&sgfnTables]( int i ) {
            return sgfnTables.getTable<Opm::SgfnTable>( i ).getSgColumn().back();
        };
        const auto famII_sgwfn = [&sgwfnTables]( int i ) {
            return sgwfnTables.getTable<Opm::SgwfnTable>( i ).getSgColumn().back();
        };
        const auto famIII = [&gsfTables]( int i ) {
            return gsfTables.getTable<Opm::GsfTable>( i ).getSgColumn().back();
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( sgofTables.empty() && sgofLetTables.empty() && slgofTables.empty() )
                    throw std::runtime_error( "Saturation keyword family I requires either sgof or slgof non-empty" );

                if( !sgofTables.empty() )
                    return Opm::fun::map( famI_sgof, Opm::fun::iota( num_tables ) );
                else if( !sgofLetTables.empty() )
                    return Opm::fun::map( famI_sgof_let, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famI_slgof, Opm::fun::iota( num_tables ) );

            case SatfuncFamily::II:
                if( !sgfnTables.empty() )
                    return Opm::fun::map( famII, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famII_sgwfn, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                return Opm::fun::map( famIII, Opm::fun::iota( num_tables ) );

            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    template <typename Predicate>
    auto crit_sat_index(const Opm::TableColumn& col,
                        const double            tolcrit,
                        Predicate&&             pred)
    {
        using SizeT = std::remove_const_t<
            std::remove_reference_t<decltype(col.size())>
        >;

        auto begin = col.begin();
        auto pos   = std::lower_bound(begin, col.end(), tolcrit,
                                      std::forward<Predicate>(pred));

        assert ((pos != col.end()) &&
                "Detected relative permeability function "
                "without immobile state");

        return static_cast<SizeT>(std::distance(begin, pos));
    }

    double crit_sat_increasing_KR(const Opm::TableColumn& sat,
                                  const Opm::TableColumn& kr,
                                  const double            tolcrit)
    {
        // First position for which Kr(S) > tolcrit.
        const auto i = crit_sat_index(kr, tolcrit,
            [](const double kr1, const double kr2)
        {
            // kr1 <= kr2.  Kr2 is 'tolcrit'.
            return ! (kr2 < kr1);
        });

        return sat[i - 1]; // Last saturation for which Kr(S) <= tolcrit
    }

    double crit_sat_decreasing_KR(const Opm::TableColumn& sat,
                                  const Opm::TableColumn& kr,
                                  const double            tolcrit)
    {
        // First position for which Kr(S) <= tolcrit.
        const auto i = crit_sat_index(kr, tolcrit, std::greater<>{});
        return sat[i];
    }

    /// Maximum water saturation for which Krw(Sw) <= tolcrit.
    ///
    /// Expected Table Format:
    ///    [Sw,  Krw(Sw), ...other...]
    ///
    ///    Krw increasing.
    template <typename T>
    double critical_water(const T& table, const double tolcrit)
    {
        return crit_sat_increasing_KR(table.getSwColumn(),
                                      table.getKrwColumn(), tolcrit);
    }

    /// Maximum water saturation for which Krgw(1-Sw) <= tolcrit.
    ///
    /// Expected Table Format:
    ///    [1-Sw,  Krgw(1-Sw), ...other...]
    ///
    ///    Krgw decreasing.
    double critical_water_sgwfn(const Opm::SgwfnTable& sgwfnTable, const double tolcrit)
    {
        const auto sg_at_crit_krgw =
            crit_sat_decreasing_KR(sgwfnTable.getSgColumn(),
                                      sgwfnTable.getKrgwColumn(), tolcrit);
        // Sw = 1 - Sg
        return 1.0 - sg_at_crit_krgw;
    }

    std::vector<double>
    findCriticalWater(const Opm::TableManager& tm,
                      const Opm::Phases&       ph,
                      const double             tolcrit)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::WATER))
            return std::vector<double>(num_tables, 0.0);

        const auto& swofTables = tm.getSwofTables();
        const auto& swofLetTables  = tm.getSwofletTable();
        const auto& swfnTables = tm.getSwfnTables();
        const auto& sgwfnTables = tm.getSgwfnTables();
        const auto& wsfTables = tm.getWsfTables();

        const auto famI = [&swofTables, tolcrit](const int i) -> double
        {
            return critical_water(swofTables.getTable<Opm::SwofTable>(i), tolcrit);
        };

        const auto famI_let = [&swofLetTables]( int i ) {
            return swofLetTables[i].s1_critical;
        };

        const auto famII = [&swfnTables, tolcrit](const int i) -> double
        {
            return critical_water(swfnTables.getTable<Opm::SwfnTable>(i), tolcrit);
        };
        const auto famII_sgwfn = [&sgwfnTables, tolcrit](const int i) -> double
        {
            return critical_water_sgwfn(sgwfnTables.getTable<Opm::SgwfnTable>(i), tolcrit);
        };
        const auto famIII = [&wsfTables, tolcrit](const int i) -> double
        {
            return critical_water(wsfTables.getTable<Opm::WsfTable>(i), tolcrit);
        };
        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( !swofTables.empty() )
                    return Opm::fun::map( famI, Opm::fun::iota( num_tables ) );
                else if ( !swofLetTables.empty() )
                    return Opm::fun::map( famI_let, Opm::fun::iota( num_tables ) );
                else
                    throw std::domain_error("Either SWOF or SWOFLET tables must be provided");

            case SatfuncFamily::II:
                if( !swfnTables.empty() )
                    return Opm::fun::map( famII, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famII_sgwfn, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III: return Opm::fun::map( famIII, Opm::fun::iota( num_tables ) );

            default: throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    /// Maximum gas saturation for which Krg(Sg) <= tolcrit.
    ///
    /// Expected Table Format:
    ///    [Sg,  Krg(Sg), ...other...]
    ///
    ///    Krg increasing.
    template <typename T>
    double critical_gas(const T& table, const double tolcrit)
    {
        return crit_sat_increasing_KR(table.getSgColumn(),
                                      table.getKrgColumn(), tolcrit);
    }

    /// Maximum gas saturation for which Krg(Sg) <= tolcrit.
    ///
    /// Table Format (Sl = So + Swco):
    ///    [Sl,  Krg(Sl),  Krog(Sl),  Pcgo(Sl)]
    ///
    ///    Krg decreasing,  Krog increasing,  Pcog not increasing.
    double critical_gas(const Opm::SlgofTable& slgofTable,
                        const double           tolcrit)
    {
        const auto sl_at_crit_gas =
            crit_sat_decreasing_KR(slgofTable.getSlColumn(),
                                   slgofTable.getKrgColumn(), tolcrit);

        // Sg = 1 - Sl
        return 1.0 - sl_at_crit_gas;
    }

    std::vector<double>
    findCriticalGas(const Opm::TableManager& tm,
                    const Opm::Phases&       ph,
                    const double             tolcrit)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::GAS))
            return std::vector<double>(num_tables, 0.0);

        const auto& sgfnTables = tm.getSgfnTables();
        const auto& sgwfnTables = tm.getSgwfnTables();
        const auto& sgofTables = tm.getSgofTables();
        const auto& sgofLetTables  = tm.getSgofletTable();
        const auto& slgofTables = tm.getSlgofTables();
        const auto& gsfTables = tm.getGsfTables();

        const auto famI_sgof = [&sgofTables, tolcrit](const int i) -> double
        {
            return critical_gas(sgofTables.getTable<Opm::SgofTable>(i), tolcrit);
        };

        const auto famI_sgof_let = [&sgofLetTables]( int i ) {
            return sgofLetTables[i].s1_critical;
        };

        const auto famI_slgof = [&slgofTables, tolcrit](const int i) -> double
        {
            return critical_gas(slgofTables.getTable<Opm::SlgofTable>(i), tolcrit);
        };

        const auto famII = [&sgfnTables, tolcrit](const int i) -> double
        {
            return critical_gas(sgfnTables.getTable<Opm::SgfnTable>(i), tolcrit);
        };

        const auto famII_sgwfn = [&sgwfnTables, tolcrit](const int i) -> double
        {
            return critical_gas(sgwfnTables.getTable<Opm::SgwfnTable>(i), tolcrit);
        };

        const auto famIII = [&gsfTables, tolcrit](const int i) -> double
        {
            return critical_gas(gsfTables.getTable<Opm::GsfTable>(i), tolcrit);
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( sgofTables.empty() && sgofLetTables.empty() && slgofTables.empty() )
                    throw std::runtime_error( "Saturation keyword family I requires either sgof or slgof non-empty" );

                if( !sgofTables.empty() )
                    return Opm::fun::map( famI_sgof, Opm::fun::iota( num_tables ) );
                else if( !sgofLetTables.empty() )
                    return Opm::fun::map( famI_sgof_let, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famI_slgof, Opm::fun::iota( num_tables ) );

            case SatfuncFamily::II:
                if( !sgfnTables.empty() )
                    return Opm::fun::map( famII, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famII_sgwfn, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                return Opm::fun::map( famIII, Opm::fun::iota( num_tables ) );

            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    /// Maximum oil saturation for which Krow(So) <= tolcrit.
    ///
    /// Table Format:
    ///    [Sw,  Krw(Sw),  Krow(Sw),  Pcow(Sw)]
    ///
    ///    Krw increasing,  Krow decreasing,  Pcow not increasing.
    double critical_oil_water(const Opm::SwofTable& swofTable,
                              const double          tolcrit)
    {
        const auto sw_at_crit_oil =
            crit_sat_decreasing_KR(swofTable.getSwColumn(),
                                   swofTable.getKrowColumn(), tolcrit);

        // So = 1 - Sw
        return 1.0 - sw_at_crit_oil;
    }

    /// Maximum oil saturation for which Kro(So) <= tolcrit.
    ///
    /// Table Format:
    ///    [So,  Kro(So)]
    ///
    ///    Kro increasing.
    double critical_oil(const Opm::Sof2Table& sof2Table,
                        const double          tolcrit)
    {
        return crit_sat_increasing_KR(sof2Table.getSoColumn(),
                                      sof2Table.getKroColumn(), tolcrit);
    }

    /// Maximum oil saturation for which Kro(So) <= tolcrit.
    ///
    /// Table Format:
    ///    [So,  Krow(So),  Krog(So)]
    ///
    ///    Krow increasing,  Krog increasing.
    double critical_oil(const Opm::Sof3Table&   sof3Table,
                        const Opm::TableColumn& col,
                        const double            tolcrit)
    {
        return crit_sat_increasing_KR(sof3Table.getSoColumn(), col, tolcrit);
    }

    std::vector<double>
    findCriticalOilWater(const Opm::TableManager& tm,
                         const Opm::Phases&       ph,
                         const double             tolcrit)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::OIL) ||
            ! ph.active(::Opm::Phase::WATER))
            return std::vector<double>(num_tables, 0.0);

        const auto& swofTables = tm.getSwofTables();
        const auto& swofLetTables  = tm.getSwofletTable();
        const auto& sof2Tables = tm.getSof2Tables();
        const auto& sof3Tables = tm.getSof3Tables();

        const auto famI = [&swofTables, tolcrit](const int i) -> double
        {
            return critical_oil_water(swofTables.getTable<Opm::SwofTable>(i), tolcrit);
        };

        const auto famI_let = [&swofLetTables]( int i ) {
            return swofLetTables[i].s2_critical;
        };

        const auto famII_2p = [&sof2Tables, tolcrit](const int i) -> double
        {
            return critical_oil(sof2Tables.getTable<Opm::Sof2Table>(i), tolcrit);
        };

        const auto famII_3p = [&sof3Tables, tolcrit](const int i) -> double
        {
            const auto& tb = sof3Tables.getTable<Opm::Sof3Table>(i);
            return critical_oil(tb, tb.getKrowColumn(), tolcrit);
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( !swofTables.empty() )
                    return Opm::fun::map( famI, Opm::fun::iota( num_tables ) );
                else if ( !swofLetTables.empty() )
                    return Opm::fun::map( famI_let, Opm::fun::iota( num_tables ) );
                else
                    throw std::domain_error("Either SWOF or SWOFLET tables must be provided");

            case SatfuncFamily::II:
                return ph.active(::Opm::Phase::GAS)
                    ? Opm::fun::map( famII_3p, Opm::fun::iota( num_tables ) )
                    : Opm::fun::map( famII_2p, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                throw std::domain_error("Saturation keyword family III is not applicable for a oil system");
            default: throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    /// Maximum oil saturation for which Krog(So) <= tolcrit.
    ///
    /// Table Format:
    ///    [Sg,  Krg(Sg),  Krog(Sg),  Pcgo(Sg)]
    ///
    ///    Krg increasing,  Krog decreasing,  Pcgo not decreasing.
    double critical_oil_gas(const Opm::SgofTable& sgofTable,
                            const double          tolcrit)
    {
        const auto sg_at_crit_oil =
            crit_sat_decreasing_KR(sgofTable.getSgColumn(),
                                   sgofTable.getKrogColumn(), tolcrit);

        // So = 1 - Sg
        return 1.0 - sg_at_crit_oil;
    }

    /// Maximum oil saturation for which Krog(So) <= tolcrit.
    ///
    /// Table Format (Sl = So + Swco):
    ///    [Sl,  Krg(Sl),  Krog(Sl),  Pcgo(Sl)]
    ///
    ///    Krg decreasing,  Krog increasing,  Pcgo not increasing.
    double critical_oil_gas(const Opm::SlgofTable& slgofTable,
                            const double           tolcrit)
    {
        return crit_sat_increasing_KR(slgofTable.getSlColumn(),
                                      slgofTable.getKrogColumn(), tolcrit);
    }

    std::vector<double>
    findCriticalOilGas(const Opm::TableManager&   tm,
                       const Opm::Phases&         ph,
                       const std::vector<double>& swco,
                       const double               tolcrit)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::OIL) ||
            ! ph.active(::Opm::Phase::GAS))
            return std::vector<double>(num_tables, 0.0);

        const auto& sgofTables = tm.getSgofTables();
        const auto& sgofLetTables  = tm.getSgofletTable();
        const auto& slgofTables = tm.getSlgofTables();
        const auto& sof2Tables = tm.getSof2Tables();
        const auto& sof3Tables = tm.getSof3Tables();

        const auto famI_sgof = [&sgofTables, &swco, tolcrit](const int i) -> double
        {
            return critical_oil_gas(sgofTables.getTable<Opm::SgofTable>(i), tolcrit) - swco[i];
        };

        const auto famI_sgof_let = [&sgofLetTables]( int i ) {
            return sgofLetTables[i].s2_critical;
        };

        const auto famI_slgof = [&slgofTables, &swco, tolcrit](const int i) -> double
        {
            return critical_oil_gas(slgofTables.getTable<Opm::SlgofTable>(i), tolcrit) - swco[i];
        };

        const auto famII_2p = [&sof2Tables, tolcrit](const int i) -> double
        {
            return critical_oil(sof2Tables.getTable<Opm::Sof2Table>(i), tolcrit);
        };

        const auto famII_3p = [&sof3Tables, tolcrit](const int i) -> double
        {
            const auto& tb = sof3Tables.getTable<Opm::Sof3Table>(i);
            return critical_oil(tb, tb.getKrogColumn(), tolcrit);
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( sgofTables.empty() && sgofLetTables.empty() && slgofTables.empty() )
                    throw std::runtime_error( "Saturation keyword family I requires either sgof or slgof non-empty" );

                if( !sgofTables.empty() )
                    return Opm::fun::map( famI_sgof, Opm::fun::iota( num_tables ) );
                else if( !sgofLetTables.empty() )
                    return Opm::fun::map( famI_sgof_let, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famI_slgof, Opm::fun::iota( num_tables ) );

            case SatfuncFamily::II:
                return ph.active(::Opm::Phase::WATER)
                    ? Opm::fun::map( famII_3p, Opm::fun::iota( num_tables ) )
                    : Opm::fun::map( famII_2p, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                throw std::domain_error("Saturation keyword family III is not applicable for a oil system");
            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    std::vector<double>
    findMaxKrg(const Opm::TableManager& tm,
               const Opm::Phases&       ph)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::GAS))
            return std::vector<double>(num_tables, 0.0);

        const auto& sgofTables = tm.getSgofTables();
        const auto& sgofLetTables  = tm.getSgofletTable();
        const auto& slgofTables = tm.getSlgofTables();
        const auto& sgfnTables = tm.getSgfnTables();
        const auto& sgwfnTables = tm.getSgwfnTables();
        const auto& gsfTables = tm.getGsfTables();

        const auto& famI_sgof = [&sgofTables]( int i ) {
            return sgofTables.getTable<Opm::SgofTable>( i ).getKrgColumn().back();
        };

        const auto& famI_sgof_let = [&sgofLetTables]( int i ) {
            return sgofLetTables[i].krt1_relperm;
        };

        const auto& famI_slgof = [&slgofTables]( int i ) {
            return slgofTables.getTable<Opm::SlgofTable>( i ).getKrgColumn().front();
        };

        const auto& famII = [&sgfnTables]( int i ) {
            return sgfnTables.getTable<Opm::SgfnTable>( i ).getKrgColumn().back();
        };

        const auto& famII_sgwfn = [&sgwfnTables]( int i ) {
            return sgwfnTables.getTable<Opm::SgwfnTable>( i ).getKrgColumn().back();
        };

        const auto& famIII = [&gsfTables]( int i ) {
            return gsfTables.getTable<Opm::GsfTable>( i ).getKrgColumn().back();
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( sgofTables.empty() && sgofLetTables.empty() && slgofTables.empty() )
                    throw std::runtime_error( "Saturation keyword family I requires either sgof or slgof non-empty" );
                if( !sgofTables.empty() )
                    return Opm::fun::map( famI_sgof, Opm::fun::iota( num_tables ) );
                else if( !sgofLetTables.empty() )
                    return Opm::fun::map( famI_sgof_let, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famI_slgof, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::II:
                if( !sgfnTables.empty() )
                    return Opm::fun::map( famII, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famII_sgwfn, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                return Opm::fun::map( famIII, Opm::fun::iota( num_tables ) );
            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    std::vector<double>
    findKrgr(const Opm::TableManager& tm,
             const Opm::Phases&       ph,
             const RawTableEndPoints& ep)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::GAS))
            return std::vector<double>(num_tables, 0.0);

        const auto& sgofTables = tm.getSgofTables();
        const auto& sgofLetTables  = tm.getSgofletTable();
        const auto& slgofTables = tm.getSlgofTables();
        const auto& sgfnTables = tm.getSgfnTables();
        const auto& sgwfnTables = tm.getSgwfnTables();
        const auto& gsfTables = tm.getGsfTables();

        auto sr = std::vector<double>(num_tables, 0.0);
        if (ph.active(Opm::Phase::OIL)) {
            // G/O or G/O/W system
            for (auto tblID = 0*num_tables; tblID < num_tables; ++tblID) {
                sr[tblID] = 1.0 - (ep.critical.oil_in_gas[tblID] +
                                   ep.connate .water     [tblID]);
            }
        }
        else {
            // G/W system
            for (auto tblID = 0*num_tables; tblID < num_tables; ++tblID) {
                sr[tblID] = 1.0 - ep.critical.water[tblID];
            }
        }

        const auto famI_sgof = [&sgofTables, &sr](const int i) -> double
        {
            const auto& sgof = sgofTables.getTable<Opm::SgofTable>(i);
            const auto  ix   = sgof.getSgColumn().lookup(sr[i]);

            return sgof.getKrgColumn().eval(ix);
        };

        const auto famI_sgof_let = [&sgofLetTables](const int i) -> double
        {
            return sgofLetTables[i].krt1_relperm;
        };

        const auto famI_slgof = [&slgofTables, &sr](const int i) -> double
        {
            const auto& slgof = slgofTables.getTable<Opm::SlgofTable>(i);
            const auto  ix    = slgof.getSlColumn().lookup(1.0 - sr[i]); // Sg -> Sl

            return slgof.getKrgColumn().eval(ix);
        };

        const auto famII = [&sgfnTables, &sr](const int i) -> double
        {
            const auto& sgfn = sgfnTables.getTable<Opm::SgfnTable>(i);
            const auto  ix   = sgfn.getSgColumn().lookup(sr[i]);

            return sgfn.getKrgColumn().eval(ix);
        };

        const auto famII_sgwfn = [&sgwfnTables, &sr](const int i) -> double
        {
            const auto& sgwfn = sgwfnTables.getTable<Opm::SgwfnTable>(i);
            const auto  ix   = sgwfn.getSgColumn().lookup(sr[i]);

            return sgwfn.getKrgColumn().eval(ix);
        };

        const auto famIII = [&gsfTables, &sr](const int i) -> double
        {
            const auto& gsf = gsfTables.getTable<Opm::GsfTable>(i);
            const auto  ix   = gsf.getSgColumn().lookup(sr[i]);

            return gsf.getKrgColumn().eval(ix);
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( sgofTables.empty() && sgofLetTables.empty() && slgofTables.empty() )
                    throw std::runtime_error( "Saturation keyword family I requires either sgof or slgof non-empty" );
                if( !sgofTables.empty() )
                    return Opm::fun::map( famI_sgof, Opm::fun::iota( num_tables ) );
                else if( !sgofLetTables.empty() )
                    return Opm::fun::map( famI_sgof_let, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famI_slgof, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::II:
                if( !sgfnTables.empty() )
                    return Opm::fun::map( famII, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famII_sgwfn, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                return Opm::fun::map( famIII, Opm::fun::iota( num_tables ) );
            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    std::vector<double>
    findKrwr(const Opm::TableManager& tm,
             const Opm::Phases&       ph,
             const RawTableEndPoints& ep)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::WATER))
            return std::vector<double>(num_tables, 0.0);

        const auto& swofTables = tm.getSwofTables();
        const auto& swofLetTables  = tm.getSwofletTable();
        const auto& swfnTables = tm.getSwfnTables();
        const auto& sgwfnTables = tm.getSgwfnTables();
        const auto& wsfTables = tm.getWsfTables();

        auto sr = std::vector<double>(num_tables, 0.0);
        if (ph.active(Opm::Phase::OIL)) {
            // O/W or G/O/W system
            for (auto tblID = 0*num_tables; tblID < num_tables; ++tblID) {
                sr[tblID] = 1.0 - (ep.critical.oil_in_water[tblID] +
                                   ep.connate .gas         [tblID]);
            }
        }
        else {
            // G/W system
            for (auto tblID = 0*num_tables; tblID < num_tables; ++tblID) {
                sr[tblID] = 1.0 - ep.critical.gas[tblID];
            }
        }

        const auto& famI = [&swofTables, &sr](const int i) -> double
        {
            const auto& swof = swofTables.getTable<Opm::SwofTable>(i);
            const auto  ix   = swof.getSwColumn().lookup(sr[i]);

            return swof.getKrwColumn().eval(ix);
        };

        const auto& famI_let = [&swofLetTables](const int i) -> double
        {
            return swofLetTables[i].krt1_relperm;
        };

        const auto& famII = [&swfnTables, &sr](const int i) -> double
        {
            const auto& swfn = swfnTables.getTable<Opm::SwfnTable>(i);
            const auto  ix   = swfn.getSwColumn().lookup(sr[i]);

            return swfn.getKrwColumn().eval(ix);
        };

        const auto& famII_sgwfn = [&sgwfnTables, &sr](const int i) -> double
        {
            const auto& sgwfn = sgwfnTables.getTable<Opm::SgwfnTable>(i);
            const auto  ix   = sgwfn.getSgColumn().lookup(1. - sr[i]);

            return sgwfn.getKrgwColumn().eval(ix);
        };

        const auto& famIII = [&wsfTables, &sr](const int i) -> double
        {
            const auto& wsf = wsfTables.getTable<Opm::WsfTable>(i);
            const auto  ix   = wsf.getSwColumn().lookup(sr[i]);

            return wsf.getKrwColumn().eval(ix);
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( !swofTables.empty() )
                    return Opm::fun::map( famI, Opm::fun::iota( num_tables ) );
                else if( !swofLetTables.empty() )
                    return Opm::fun::map( famI_let, Opm::fun::iota( num_tables ) );
                else
                    throw std::domain_error("Either SWOF or SWOFLET tables must be provided");

            case SatfuncFamily::II:
                if( !swfnTables.empty() )
                    return Opm::fun::map( famII, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famII_sgwfn, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                return Opm::fun::map( famIII, Opm::fun::iota( num_tables ) );
            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    std::vector<double>
    findKrorw(const Opm::TableManager& tm,
              const Opm::Phases&       ph,
              const RawTableEndPoints& ep)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::OIL) ||
            ! ph.active(::Opm::Phase::WATER))
            return std::vector<double>(num_tables, 0.0);

        const auto& swofTables = tm.getSwofTables();
        const auto& swofLetTables  = tm.getSwofletTable();
        const auto& sof2Tables = tm.getSof2Tables();
        const auto& sof3Tables = tm.getSof3Tables();

        const auto famI = [&swofTables, &ep](const int i) -> double
        {
            const auto& swof = swofTables.getTable<Opm::SwofTable>(i);
            const auto  sr   = ep.critical.water[i] + ep.connate.gas[i];
            const auto  ix   = swof.getSwColumn().lookup(sr);

            return swof.getKrowColumn().eval(ix);
        };

        const auto famI_let = [&swofLetTables](const int i) -> double
        {
            return swofLetTables[i].krt2_relperm;
        };

        const auto famII_3p = [&sof3Tables, &ep](const int i) -> double
        {
            const auto& sof3 = sof3Tables.getTable<Opm::Sof3Table>(i);
            const auto  sr   = 1.0 - ep.critical.water[i] - ep.connate.gas[i];
            const auto  ix   = sof3.getSoColumn().lookup(sr);

            return sof3.getKrowColumn().eval(ix);
        };

        const auto famII_2p = [&sof2Tables, &ep](const int i) -> double
        {
            const auto& sof2 = sof2Tables.getTable<Opm::Sof2Table>(i);
            const auto  sr   = 1.0 - ep.critical.water[i] - ep.connate.gas[i];
            const auto  ix   = sof2.getSoColumn().lookup(sr);

            return sof2.getKroColumn().eval(ix);
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if ( !swofTables.empty() )
                    return Opm::fun::map( famI, Opm::fun::iota( num_tables ) );
                else if ( !swofLetTables.empty() )
                    return Opm::fun::map( famI_let, Opm::fun::iota( num_tables ) );
                else
                    throw std::domain_error("Either SWOF or SWOFLET tables must be provided");

            case SatfuncFamily::II:
                return ph.active(::Opm::Phase::GAS)
                    ? Opm::fun::map( famII_3p, Opm::fun::iota( num_tables ) )
                    : Opm::fun::map( famII_2p, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                throw std::domain_error("Saturation keyword family III is not applicable for a oil system");
            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    std::vector<double>
    findKrorg(const Opm::TableManager& tm,
              const Opm::Phases&       ph,
              const RawTableEndPoints& ep)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::OIL) ||
            ! ph.active(::Opm::Phase::GAS))
            return std::vector<double>(num_tables, 0.0);

        const auto& sgofTables = tm.getSgofTables();
        const auto& sgofLetTables = tm.getSgofletTable();
        const auto& slgofTables = tm.getSlgofTables();
        const auto& sof2Tables = tm.getSof2Tables();
        const auto& sof3Tables = tm.getSof3Tables();

        const auto famI_sgof = [&sgofTables, &ep](const int i) -> double
        {
            const auto& sgof = sgofTables.getTable<Opm::SgofTable>(i);
            const auto  ix   = sgof.getSgColumn().lookup(ep.critical.gas[i]);

            // So = 1 - Sgcr - Swl
            return sgof.getKrogColumn().eval(ix);
        };

        const auto famI_sgof_let = [&sgofLetTables](const int i) -> double
        {
            return sgofLetTables[i].krt2_relperm;
        };

        const auto famI_slgof = [&slgofTables, &ep](const int i) -> double
        {
            const auto& slgof = slgofTables.getTable<Opm::SlgofTable>(i);
            const auto  ix    = slgof.getSlColumn().lookup(1.0 - ep.critical.gas[i]);

            return slgof.getKrogColumn().eval(ix);
        };

        const auto famII_3p = [&sof3Tables, &ep](const int i) -> double
        {
            const auto& sof3 = sof3Tables.getTable<Opm::Sof3Table>(i);
            const auto  sr   = 1.0 - ep.critical.gas[i] - ep.connate.water[i];
            const auto  ix   = sof3.getSoColumn().lookup(sr);

            return sof3.getKrogColumn().eval(ix);
        };

        const auto famII_2p = [&sof2Tables, &ep](const int i) -> double
        {
            const auto& sof2 = sof2Tables.getTable<Opm::Sof2Table>(i);
            const auto  sr   = 1.0 - ep.critical.gas[i] - ep.connate.water[i];
            const auto  ix   = sof2.getSoColumn().lookup(sr);

            return sof2.getKroColumn().eval(ix);
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( sgofTables.empty() && sgofLetTables.empty() && slgofTables.empty() )
                    throw std::runtime_error( "Saturation keyword family I requires either sgof or slgof non-empty" );
                if( !sgofTables.empty() )
                    return Opm::fun::map( famI_sgof, Opm::fun::iota( num_tables ) );
                else if( !sgofLetTables.empty() )
                    return Opm::fun::map( famI_sgof_let, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famI_slgof, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::II:
                return ph.active(::Opm::Phase::WATER)
                    ? Opm::fun::map( famII_3p, Opm::fun::iota( num_tables ) )
                    : Opm::fun::map( famII_2p, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                throw std::domain_error("Saturation keyword family III is not applicable for a oil system");
            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    /* find the maximum output values of the water-oil system. the maximum oil
     * relperm is possibly wrong because we have two oil relperms in a threephase
     * system. the documentation is very ambiguos here, though: it says that the
     * oil relperm at the maximum oil saturation is scaled according to maximum
     * specified the KRO keyword. the first part of the statement points at
     * scaling the resultant threephase oil relperm, but then the gas saturation
     * is not taken into account which means that some twophase quantity must be
     * scaled.
     */
    std::vector<double>
    findMaxPcog(const Opm::TableManager& tm,
                const Opm::Phases&       ph)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (!ph.active(::Opm::Phase::GAS))
            return std::vector<double>(num_tables, 0.0);

        const auto& sgofTables = tm.getSgofTables();
        const auto& sgofLetTables = tm.getSgofletTable();
        const auto& slgofTables = tm.getSlgofTables();
        const auto& sgfnTables = tm.getSgfnTables();
        const auto& sgwfnTables = tm.getSgwfnTables();
        const auto& gsfTables = tm.getGsfTables();

        const auto& famI_sgof = [&sgofTables]( int i ) {
            return sgofTables.getTable<Opm::SgofTable>( i ).getPcogColumn().back();
        };

        const auto& famI_sgof_let = [&sgofLetTables]( int i ) {
            return sgofLetTables[i].pct_pc;
        };

        const auto& famI_slgof = [&slgofTables]( int i ) {
            return slgofTables.getTable<Opm::SlgofTable>( i ).getPcogColumn().front();
        };

        const auto& famII = [&sgfnTables]( int i ) {
            return sgfnTables.getTable<Opm::SgfnTable>( i ).getPcogColumn().back();
        };

        const auto& famII_sgwfn = [&sgwfnTables]( int i ) {
            return sgwfnTables.getTable<Opm::SgwfnTable>( i ).getPcgwColumn().back();
        };

        const auto& famIII = [&gsfTables]( int i ) {
            return gsfTables.getTable<Opm::GsfTable>( i ).getPcgwColumn().back();
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( sgofTables.empty() && sgofLetTables.empty() && slgofTables.empty() )
                    throw std::runtime_error( "Saturation keyword family I requires either sgof or slgof non-empty" );
                if( !sgofTables.empty() )
                    return Opm::fun::map( famI_sgof, Opm::fun::iota( num_tables ) );
                else if( !sgofLetTables.empty() )
                    return Opm::fun::map( famI_sgof_let, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famI_slgof, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::II:
                if( !sgfnTables.empty() )
                    return Opm::fun::map( famII, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famII_sgwfn, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                return Opm::fun::map( famIII, Opm::fun::iota( num_tables ) );
            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    std::vector<double>
    findMaxPcow(const Opm::TableManager& tm,
                const Opm::Phases&       ph)
    {
        const auto num_tables  = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::WATER) ||
            ! ph.active(::Opm::Phase::OIL))
            return std::vector<double>(num_tables, 0.0);

        const auto& swofTables = tm.getSwofTables();
        const auto& swofLetTables = tm.getSwofletTable();
        const auto& swfnTables = tm.getSwfnTables();

        const auto& famI = [&swofTables]( int i ) {
            return swofTables.getTable<Opm::SwofTable>( i ).getPcowColumn().front();
        };

        const auto& famI_let = [&swofLetTables]( int i ) {
            return swofLetTables[i].pct_pc;
        };

        const auto& famII = [&swfnTables]( int i ) {
            return swfnTables.getTable<Opm::SwfnTable>( i ).getPcowColumn().front();
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if (!swofTables.empty())
                    return Opm::fun::map( famI, Opm::fun::iota( num_tables ) );
                else if (!swofLetTables.empty())
                    return Opm::fun::map( famI_let, Opm::fun::iota( num_tables ) );
                else
                    throw std::domain_error("Either SWOF or SWOFLET tables must be provided");

            case SatfuncFamily::II:
                return Opm::fun::map( famII, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                return std::vector<double>(num_tables, 0.0);
            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    std::vector<double>
    findMaxKro(const Opm::TableManager& tm,
               const Opm::Phases&       ph)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::OIL))
            return std::vector<double>(num_tables, 0.0);

        const auto wat = ph.active(::Opm::Phase::WATER);

        const auto& other_f1   = wat ? tm.getSwofTables() : tm.getSgofTables();
        const auto& wat_f1_let   = tm.getSwofletTable();
        const auto& gas_f1_let   = tm.getSgofletTable();
        const auto& sof2Tables = tm.getSof2Tables();
        const auto& sof3Tables = tm.getSof3Tables();

        const auto& famI = [&other_f1,wat]( int i ) {
            // In O/W/G runs this relies on Krog(Sg=0) == Krow(Sw=Swco),
            // meaning that the first entry in the KRO column--in each
            // saturation region--is equal in keywords SGOF and SWOF.
            return wat
                ? other_f1.getTable<Opm::SwofTable>( i ).getKrowColumn().front()
                : other_f1.getTable<Opm::SgofTable>( i ).getKrogColumn().front();
        };

        const auto& famI_let_wat = [&wat_f1_let]( int i ) {
            // In O/W/G runs this relies on Krog(Sg=0) == Krow(Sw=Swco),
            // meaning that in each region krt2_relperm is equal for SGOFLET and SWOFLET.
            return wat_f1_let[i].krt2_relperm;
        };

        const auto& famI_let_gas = [&gas_f1_let]( int i ) {
            // In O/W/G runs this relies on Krog(Sg=0) == Krow(Sw=Swco),
            // meaning that in each region krt2_relperm is equal for SGOFLET and SWOFLET.
            return gas_f1_let[i].krt2_relperm;
        };

        const auto& famII_2p = [&sof2Tables]( int i ) {
            return sof2Tables.getTable<Opm::Sof2Table>( i ).getKroColumn().back();
        };

        const auto& famII_3p = [&sof3Tables]( int i ) {
            return sof3Tables.getTable<Opm::Sof3Table>( i ).getKrowColumn().back();
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if ( !other_f1.empty() )
                    return Opm::fun::map( famI, Opm::fun::iota( num_tables ) );
                else if ( !wat_f1_let.empty() )
                    return Opm::fun::map( famI_let_wat, Opm::fun::iota( num_tables ) );
                else if ( !gas_f1_let.empty() )
                    return Opm::fun::map( famI_let_gas, Opm::fun::iota( num_tables ) );
                else
                    throw std::domain_error("Valid family I tables must be provided");

            case SatfuncFamily::II:
                return ph.active(::Opm::Phase::GAS) && ph.active(::Opm::Phase::WATER)
                    ? Opm::fun::map( famII_3p, Opm::fun::iota( num_tables ) )
                    : Opm::fun::map( famII_2p, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                throw std::domain_error("Saturation keyword family III is not applicable for a oil system");
            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    std::vector<double>
    findMaxKrw(const Opm::TableManager& tm,
               const Opm::Phases&       ph)
    {
        const auto num_tables = tm.getTabdims().getNumSatTables();

        if (! ph.active(::Opm::Phase::WATER))
            return std::vector<double>(num_tables, 0.0);

        const auto& swofTables = tm.getSwofTables();
        const auto& swofLetTables  = tm.getSwofletTable();
        const auto& swfnTables = tm.getSwfnTables();
        const auto& sgwfnTables = tm.getSgwfnTables();
        const auto& wsfTables = tm.getWsfTables();

        const auto& famI = [&swofTables]( int i ) {
            return swofTables.getTable<Opm::SwofTable>( i ).getKrwColumn().back();
        };

        const auto& famI_let = [&swofLetTables]( int i ) {
            return swofLetTables[i].krt1_relperm;
        };

        const auto& famII = [&swfnTables]( int i ) {
            return swfnTables.getTable<Opm::SwfnTable>( i ).getKrwColumn().back();
        };

        const auto& famII_sgwfn = [&sgwfnTables]( int i ) {
            return sgwfnTables.getTable<Opm::SgwfnTable>( i ).getKrgwColumn().front();
        };

        const auto& famIII = [&wsfTables]( int i ) {
            return wsfTables.getTable<Opm::WsfTable>( i ).getKrwColumn().back();
        };

        switch( getSaturationFunctionFamily( tm, ph ) ) {
            case SatfuncFamily::I:
                if( !swofTables.empty() )
                    return Opm::fun::map( famI, Opm::fun::iota( num_tables ) );
                else if( !swofLetTables.empty() )
                    return Opm::fun::map( famI_let, Opm::fun::iota( num_tables ) );
                else
                    throw std::domain_error("Either SWOF or SWOFLET tables must be provided");
            case SatfuncFamily::II:
                if( !swfnTables.empty() )
                    return Opm::fun::map( famII, Opm::fun::iota( num_tables ) );
                else
                    return Opm::fun::map( famII_sgwfn, Opm::fun::iota( num_tables ) );
            case SatfuncFamily::III:
                return Opm::fun::map( famIII, Opm::fun::iota( num_tables ) );
            default:
                throw std::domain_error("No valid saturation keyword family specified");
        }
    }

    double selectValue(const Opm::TableContainer& depthTables,
                       int tableIdx,
                       const std::string& columnName,
                       double cellDepth,
                       double fallbackValue,
                       bool useOneMinusTableValue)
    {
        if( tableIdx < 0 ) return fallbackValue;

        const auto& table = depthTables.getTable( tableIdx );

        if( tableIdx >= int( depthTables.size() ) )
            throw std::invalid_argument("Not enough tables!");

        // evaluate the table at the cell depth
        const double value = table.evaluate( columnName, cellDepth );

        // a column can be fully defaulted. In this case, eval() returns a NaN
        // and we have to use the data from saturation tables
        if( !std::isfinite( value ) ) return fallbackValue;
        if( useOneMinusTableValue ) return 1 - value;
        return value;
    }

    void checkSatRegions(const std::size_t  cellIdx,
                         const int          satfunc,
                         const int          endfunc,
                         const std::string& satregname)
    {
        if ((satfunc < 0) || (endfunc < 0)) {
            throw std::invalid_argument {
                "Region Index Out of Bounds in Active Cell "
                + std::to_string(cellIdx) + ". " + satregname + " = "
                + std::to_string(satfunc + 1) + ", ENDNUM = "
                + std::to_string(endfunc + 1)
            };
        }
    }

    std::vector<double>
    satnumApply(size_t size,
                const std::string& columnName,
                const std::vector< double >& fallbackValues,
                const Opm::TableManager& tableManager,
                const std::vector<double>& cell_depth,
                const std::vector<int>& satnum_data,
                const std::vector<int>& endnum_data,
                bool useOneMinusTableValue)
    {
        std::vector< double > values( size, 0 );

        // Actually assign the defaults. If the ENPVD keyword was specified in the deck,
        // this currently cannot be done because we would need the Z-coordinate of the
        // cell and we would need to know how the simulator wants to interpolate between
        // sampling points. Both of these are outside the scope of opm-parser, so we just
        // assign a NaN in this case...
        const bool useEnptvd = tableManager.useEnptvd();
        const auto& enptvdTables = tableManager.getEnptvdTables();
        for( size_t cellIdx = 0; cellIdx < values.size(); cellIdx++ ) {
            int satTableIdx = satnum_data[cellIdx] - 1;
            int endNum = endnum_data[cellIdx] - 1;

            // Active cell better have {SAT,END}NUM > 0.
            checkSatRegions(cellIdx, satTableIdx, endNum, "SATNUM");

            values[cellIdx] = selectValue(enptvdTables,
                                          (useEnptvd && endNum >= 0) ? endNum : -1,
                                          columnName,
                                          cell_depth[cellIdx],
                                          fallbackValues[ satTableIdx ],
                                          useOneMinusTableValue);
        }

        return values;
    }

    std::vector<double>
    imbnumApply(size_t size,
                const std::string& columnName,
                const std::vector< double >& fallBackValues,
                const Opm::TableManager& tableManager,
                const std::vector<double>& cell_depth,
                const std::vector<int>& imbnum_data,
                const std::vector<int>& endnum_data,
                bool useOneMinusTableValue )
    {
        std::vector< double > values( size, 0 );

        // Actually assign the defaults. if the ENPVD keyword was specified in the deck,
        // this currently cannot be done because we would need the Z-coordinate of the
        // cell and we would need to know how the simulator wants to interpolate between
        // sampling points. Both of these are outside the scope of opm-parser, so we just
        // assign a NaN in this case...
        const bool useImptvd = tableManager.useImptvd();
        const Opm::TableContainer& imptvdTables = tableManager.getImptvdTables();
        for( size_t cellIdx = 0; cellIdx < values.size(); cellIdx++ ) {
            int imbTableIdx = imbnum_data[ cellIdx ] - 1;
            int endNum = endnum_data[ cellIdx ] - 1;

            // Active cell better have {IMB,END}NUM > 0.
            checkSatRegions(cellIdx, imbTableIdx, endNum, "IMBNUM");

            values[cellIdx] = selectValue(imptvdTables,
                                          (useImptvd && endNum >= 0) ? endNum : -1,
                                          columnName,
                                          cell_depth[cellIdx],
                                          fallBackValues[imbTableIdx],
                                          useOneMinusTableValue);
        }

        return values;
    }

    std::vector<double>
    SGLEndpoint(const Opm::TableManager&   tableManager,
                const Opm::Phases&         /* phases */,
                const RawTableEndPoints&   ep,
                const std::vector<double>& cell_depth,
                const std::vector<int>&    satnum,
                const std::vector<int>&    endnum)
    {
        return satnumApply(cell_depth.size(), "SGCO", ep.connate.gas,
                           tableManager, cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    ISGLEndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         /* phases */,
                 const RawTableEndPoints&   ep,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    imbnum,
                 const std::vector<int>&    endnum)
    {
        return imbnumApply(cell_depth.size(), "SGCO", ep.connate.gas,
                           tableManager, cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    SGUEndpoint(const Opm::TableManager&   tableManager,
                const Opm::Phases&         /* phases */,
                const RawTableEndPoints&   ep,
                const std::vector<double>& cell_depth,
                const std::vector<int>&    satnum,
                const std::vector<int>&    endnum)
    {
        return satnumApply(cell_depth.size(), "SGMAX", ep.maximum.gas,
                           tableManager, cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    ISGUEndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         /* phases */,
                 const RawTableEndPoints&   ep,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    imbnum,
                 const std::vector<int>&    endnum)
    {
        return imbnumApply(cell_depth.size(), "SGMAX", ep.maximum.gas,
                           tableManager, cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    SWLEndpoint(const Opm::TableManager&   tableManager,
                const Opm::Phases&         /* phases */,
                const RawTableEndPoints&   ep,
                const std::vector<double>& cell_depth,
                const std::vector<int>&    satnum,
                const std::vector<int>&    endnum)
    {
        return satnumApply(cell_depth.size(), "SWCO", ep.connate.water,
                           tableManager, cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    ISWLEndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         /* phases */,
                 const RawTableEndPoints&   ep,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    imbnum,
                 const std::vector<int>&    endnum)
    {
        return imbnumApply(cell_depth.size(), "SWCO", ep.connate.water,
                           tableManager, cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    SWUEndpoint(const Opm::TableManager&   tableManager,
                const Opm::Phases&         /* phases */,
                const RawTableEndPoints&   ep,
                const std::vector<double>& cell_depth,
                const std::vector<int>&    satnum,
                const std::vector<int>&    endnum)
    {
        return satnumApply(cell_depth.size(), "SWMAX", ep.maximum.water,
                           tableManager, cell_depth, satnum, endnum, true);
    }

    std::vector<double>
    ISWUEndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         /* phases */,
                 const RawTableEndPoints&   ep,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    imbnum,
                 const std::vector<int>&    endnum)
    {
        return imbnumApply(cell_depth.size(), "SWMAX", ep.maximum.water,
                           tableManager, cell_depth, imbnum, endnum, true);
    }

    std::vector<double>
    SGCREndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         /* phases */,
                 const RawTableEndPoints&   ep,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    satnum,
                 const std::vector<int>&    endnum)
    {
        return satnumApply(cell_depth.size(), "SGCRIT", ep.critical.gas,
                           tableManager, cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    ISGCREndpoint(const Opm::TableManager&   tableManager,
                  const Opm::Phases&         /* phases */,
                  const RawTableEndPoints&   ep,
                  const std::vector<double>& cell_depth,
                  const std::vector<int>&    imbnum,
                  const std::vector<int>&    endnum)
    {
        return imbnumApply(cell_depth.size(), "SGCRIT", ep.critical.gas,
                           tableManager, cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    SOWCREndpoint(const Opm::TableManager&   tableManager,
                  const Opm::Phases&         /* phases */,
                  const RawTableEndPoints&   ep,
                  const std::vector<double>& cell_depth,
                  const std::vector<int>&    satnum,
                  const std::vector<int>&    endnum)
    {
        return satnumApply(cell_depth.size(), "SOWCRIT", ep.critical.oil_in_water,
                           tableManager, cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    ISOWCREndpoint(const Opm::TableManager&   tableManager,
                   const Opm::Phases&         /* phases */,
                   const RawTableEndPoints&   ep,
                   const std::vector<double>& cell_depth,
                   const std::vector<int>&    imbnum,
                   const std::vector<int>&    endnum)
    {
        return imbnumApply(cell_depth.size(), "SOWCRIT", ep.critical.oil_in_water,
                           tableManager, cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    SOGCREndpoint(const Opm::TableManager&   tableManager,
                  const Opm::Phases&         /* phases */,
                  const RawTableEndPoints&   ep,
                  const std::vector<double>& cell_depth,
                  const std::vector<int>&    satnum,
                  const std::vector<int>&    endnum)
    {
        return satnumApply(cell_depth.size(), "SOGCRIT", ep.critical.oil_in_gas,
                           tableManager, cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    ISOGCREndpoint(const Opm::TableManager&   tableManager,
                   const Opm::Phases&         /* phases */,
                   const RawTableEndPoints&   ep,
                   const std::vector<double>& cell_depth,
                   const std::vector<int>&    imbnum,
                   const std::vector<int>&    endnum)
    {
        return imbnumApply(cell_depth.size(), "SOGCRIT", ep.critical.oil_in_gas,
                           tableManager, cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    SWCREndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         /* phases */,
                 const RawTableEndPoints&   ep,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    satnum,
                 const std::vector<int>&    endnum)
    {
        return satnumApply(cell_depth.size(), "SWCRIT", ep.critical.water,
                           tableManager, cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    ISWCREndpoint(const Opm::TableManager&   tableManager,
                  const Opm::Phases&         /* phases */,
                  const RawTableEndPoints&   ep,
                  const std::vector<double>& cell_depth,
                  const std::vector<int>&    imbnum,
                  const std::vector<int>&    endnum)
    {
        return imbnumApply(cell_depth.size(), "SWCRIT", ep.critical.water,
                           tableManager, cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    PCWEndpoint(const Opm::TableManager&   tableManager,
                const Opm::Phases&         phases,
                const RawTableEndPoints&   /* ep */,
                const std::vector<double>& cell_depth,
                const std::vector<int>&    satnum,
                const std::vector<int>&    endnum)
    {
        const auto max_pcow = findMaxPcow(tableManager, phases);
        return satnumApply(cell_depth.size(), "PCW", max_pcow, tableManager,
                           cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    IPCWEndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         phases,
                 const RawTableEndPoints&   /* ep */,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    imbnum,
                 const std::vector<int>&    endnum)
    {
        const auto max_pcow = findMaxPcow(tableManager, phases);
        return imbnumApply(cell_depth.size(), "IPCW", max_pcow, tableManager,
                           cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    PCGEndpoint(const Opm::TableManager&   tableManager,
                const Opm::Phases&         phases,
                const RawTableEndPoints&   /* ep */,
                const std::vector<double>& cell_depth,
                const std::vector<int>&    satnum,
                const std::vector<int>&    imbnum)
    {
        const auto max_pcog = findMaxPcog(tableManager, phases);
        return satnumApply(cell_depth.size(), "PCG", max_pcog, tableManager,
                           cell_depth, satnum, imbnum, false );
    }

    std::vector<double>
    IPCGEndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         phases,
                 const RawTableEndPoints&   /* ep */,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    imbnum,
                 const std::vector<int>&    endnum)
    {
        const auto max_pcog = findMaxPcog(tableManager, phases);
        return imbnumApply(cell_depth.size(), "IPCG", max_pcog, tableManager,
                           cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    KRWEndpoint(const Opm::TableManager&   tableManager,
                const Opm::Phases&         phases,
                const RawTableEndPoints&   /* ep */,
                const std::vector<double>& cell_depth,
                const std::vector<int>&    satnum,
                const std::vector<int>&    endnum)
    {
        const auto max_krw = findMaxKrw(tableManager, phases);
        return satnumApply(cell_depth.size(), "KRW", max_krw, tableManager,
                           cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    IKRWEndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         phases,
                 const RawTableEndPoints&   /* ep */,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    imbnum,
                 const std::vector<int>&    endnum)
    {
        const auto max_krw = findMaxKrw(tableManager, phases);
        return imbnumApply(cell_depth.size(), "IKRW", max_krw, tableManager,
                           cell_depth, imbnum, endnum, false );
    }

    std::vector<double>
    KRWREndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         phases,
                 const RawTableEndPoints&   ep,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    satnum,
                 const std::vector<int>&    endnum)
    {
        const auto krwr = findKrwr(tableManager, phases, ep);
        return satnumApply(cell_depth.size(), "KRWR", krwr, tableManager,
                           cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    IKRWREndpoint(const Opm::TableManager&   tableManager,
                  const Opm::Phases&         phases,
                  const RawTableEndPoints&   ep,
                  const std::vector<double>& cell_depth,
                  const std::vector<int>&    imbnum,
                  const std::vector<int>&    endnum)
    {
        const auto krwr = findKrwr(tableManager, phases, ep);
        return imbnumApply(cell_depth.size(), "IKRWR", krwr, tableManager,
                           cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    KROEndpoint(const Opm::TableManager&   tableManager,
                const Opm::Phases&         phases,
                const RawTableEndPoints&   /* ep */,
                const std::vector<double>& cell_depth,
                const std::vector<int>&    satnum,
                const std::vector<int>&    endnum)
    {
        const auto max_kro = findMaxKro(tableManager, phases);
        return satnumApply(cell_depth.size(), "KRO", max_kro, tableManager,
                           cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    IKROEndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         phases,
                 const RawTableEndPoints&   /* ep */,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    imbnum,
                 const std::vector<int>&    endnum)
    {
        const auto max_kro = findMaxKro(tableManager, phases);
        return imbnumApply(cell_depth.size(), "IKRO", max_kro, tableManager,
                           cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    KRORWEndpoint(const Opm::TableManager&   tableManager,
                  const Opm::Phases&         phases,
                  const RawTableEndPoints&   ep,
                  const std::vector<double>& cell_depth,
                  const std::vector<int>&    satnum,
                  const std::vector<int>&    endnum)
    {
        const auto krorw = findKrorw(tableManager, phases, ep);
        return satnumApply(cell_depth.size(), "KRORW", krorw, tableManager,
                           cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    IKRORWEndpoint(const Opm::TableManager&   tableManager,
                   const Opm::Phases&         phases,
                   const RawTableEndPoints&   ep,
                   const std::vector<double>& cell_depth,
                   const std::vector<int>&    imbnum,
                   const std::vector<int>&    endnum)
    {
        const auto krorw = findKrorw(tableManager, phases, ep);
        return imbnumApply(cell_depth.size(), "IKRORW", krorw, tableManager,
                           cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    KRORGEndpoint(const Opm::TableManager&   tableManager,
                  const Opm::Phases&         phases,
                  const RawTableEndPoints&   ep,
                  const std::vector<double>& cell_depth,
                  const std::vector<int>&    satnum,
                  const std::vector<int>&    endnum)
    {
        const auto krorg = findKrorg(tableManager, phases, ep);
        return satnumApply(cell_depth.size(), "KRORG", krorg, tableManager,
                           cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    IKRORGEndpoint(const Opm::TableManager&   tableManager,
                   const Opm::Phases&         phases,
                   const RawTableEndPoints&   ep,
                   const std::vector<double>& cell_depth,
                   const std::vector<int>&    imbnum,
                   const std::vector<int>&    endnum)
    {
        const auto krorg = findKrorg(tableManager, phases, ep);
        return imbnumApply(cell_depth.size(), "IKRORG", krorg, tableManager,
                           cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    KRGEndpoint(const Opm::TableManager&   tableManager,
                const Opm::Phases&         phases,
                const RawTableEndPoints&   /* ep */,
                const std::vector<double>& cell_depth,
                const std::vector<int>&    satnum,
                const std::vector<int>&    endnum)
    {
        const auto max_krg = findMaxKrg(tableManager, phases);
        return satnumApply(cell_depth.size(), "KRG", max_krg, tableManager,
                           cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    IKRGEndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         phases,
                 const RawTableEndPoints&   /* ep */,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    imbnum,
                 const std::vector<int>&    endnum)
    {
        const auto max_krg = findMaxKrg(tableManager, phases);
        return imbnumApply(cell_depth.size(), "IKRG", max_krg, tableManager,
                           cell_depth, imbnum, endnum, false);
    }

    std::vector<double>
    KRGREndpoint(const Opm::TableManager&   tableManager,
                 const Opm::Phases&         phases,
                 const RawTableEndPoints&   ep,
                 const std::vector<double>& cell_depth,
                 const std::vector<int>&    satnum,
                 const std::vector<int>&    endnum)
    {
        const auto krgr = findKrgr(tableManager, phases, ep);
        return satnumApply(cell_depth.size(), "KRGR", krgr, tableManager,
                           cell_depth, satnum, endnum, false);
    }

    std::vector<double>
    IKRGREndpoint(const Opm::TableManager&   tableManager,
                  const Opm::Phases&         phases,
                  const RawTableEndPoints&   ep,
                  const std::vector<double>& cell_depth,
                  const std::vector<int>&    imbnum,
                  const std::vector<int>&    endnum)
    {
        const auto krgr = findKrgr(tableManager, phases, ep);
        return imbnumApply(cell_depth.size(), "IKRGR", krgr, tableManager,
                           cell_depth, imbnum, endnum, false);
    }
} // namespace Anonymous


Opm::satfunc::RawTableEndPoints
Opm::satfunc::getRawTableEndpoints(const Opm::TableManager& tm,
                                   const Opm::Phases&       phases,
                                   const double             tolcrit)
{
    RawTableEndPoints ep;

    ep.connate.gas   = findMinGasSaturation(tm, phases);
    ep.connate.water = findMinWaterSaturation(tm, phases);

    ep.critical.oil_in_gas   = findCriticalOilGas(tm, phases, ep.connate.water, tolcrit);
    ep.critical.oil_in_water = findCriticalOilWater(tm, phases, tolcrit);
    ep.critical.gas          = findCriticalGas(tm, phases, tolcrit);
    ep.critical.water        = findCriticalWater(tm, phases, tolcrit);

    ep.maximum.gas   = findMaxGasSaturation(tm, phases);
    ep.maximum.water = findMaxWaterSaturation(tm, phases);

    return ep;
}

Opm::satfunc::RawFunctionValues
Opm::satfunc::getRawFunctionValues(const Opm::TableManager& tm,
                                   const Opm::Phases&       phases,
                                   const RawTableEndPoints& ep)
{
    RawFunctionValues fval;

    fval.kro.max = findMaxKro(tm, phases);
    fval.kro.rg  = findKrorg(tm, phases, ep);
    fval.kro.rw  = findKrorw(tm, phases, ep);

    fval.krg.max = findMaxKrg(tm, phases);
    fval.krg.r   = findKrgr(tm, phases, ep);

    fval.krw.max = findMaxKrw(tm, phases);
    fval.krw.r   = findKrwr(tm, phases, ep);

    fval.pc.g = findMaxPcog(tm, phases);
    fval.pc.w = findMaxPcow(tm, phases);

    return fval;
}

std::vector<double>
Opm::satfunc::init(const std::string&         keyword,
                   const TableManager&        tables,
                   const Phases&              phases,
                   const RawTableEndPoints&   ep,
                   const std::vector<double>& cell_depth,
                   const std::vector<int>&    num,
                   const std::vector<int>&    endnum)
{
    using func_type = decltype(&IKRGEndpoint);

#define dirfunc(base, func) \
    {base, func}, \
    {base "X", func}, {base "X-", func},  \
    {base "Y", func}, {base "Y-", func},  \
    {base "Z", func}, {base "Z-", func}

    static const std::map<std::string, func_type> func_table = {
        // Drainage                      Imbibition
        {"SGLPC", SGLEndpoint},          {"ISGLPC", ISGLEndpoint},
        {"SWLPC", SWLEndpoint},          {"ISWLPC", ISWLEndpoint},

        dirfunc("SGL",   SGLEndpoint),   dirfunc("ISGL",   ISGLEndpoint),
        dirfunc("SGU",   SGUEndpoint),   dirfunc("ISGU",   ISGUEndpoint),
        dirfunc("SWL",   SWLEndpoint),   dirfunc("ISWL",   ISWLEndpoint),
        dirfunc("SWU",   SWUEndpoint),   dirfunc("ISWU",   ISWUEndpoint),

        dirfunc("SGCR",  SGCREndpoint),  dirfunc("ISGCR",  ISGCREndpoint),
        dirfunc("SOGCR", SOGCREndpoint), dirfunc("ISOGCR", ISOGCREndpoint),
        dirfunc("SOWCR", SOWCREndpoint), dirfunc("ISOWCR", ISOWCREndpoint),
        dirfunc("SWCR",  SWCREndpoint),  dirfunc("ISWCR",  ISWCREndpoint),

        {"PCG", PCGEndpoint},            {"IPCG", IPCGEndpoint},
        {"PCW", PCWEndpoint},            {"IPCW", IPCWEndpoint},

        dirfunc("KRG",   KRGEndpoint),   dirfunc("IKRG",   IKRGEndpoint),
        dirfunc("KRGR",  KRGREndpoint),  dirfunc("IKRGR",  IKRGREndpoint),
        dirfunc("KRO",   KROEndpoint),   dirfunc("IKRO",   IKROEndpoint),
        dirfunc("KRORW", KRORWEndpoint), dirfunc("IKRORW", IKRORWEndpoint),
        dirfunc("KRORG", KRORGEndpoint), dirfunc("IKRORG", IKRORGEndpoint),
        dirfunc("KRW",   KRWEndpoint),   dirfunc("IKRW",   IKRWEndpoint),
        dirfunc("KRWR",  KRWREndpoint),  dirfunc("IKRWR",  IKRWREndpoint),
    };

#undef dirfunc

    auto func = func_table.find(keyword);
    if (func == func_table.end())
        throw std::invalid_argument {
            "Unsupported saturation function scaling '"
            + keyword + '\''
        };

    return func->second(tables, phases, ep, cell_depth, num, endnum);
}
