src/OpenFOAM/interpolations/interpolationTable/interpolationTable.H

   1 /*---------------------------------------------------------------------------*\
   2   =========                 |
   3   \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   4    \\    /   O peration     |
   5     \\  /    A nd           | Copyright (C) 1991-2008 OpenCFD Ltd.
   6      \\/     M anipulation  |
   7 -------------------------------------------------------------------------------
   8 License
   9     This file is part of OpenFOAM.
  10
  11     OpenFOAM is free software; you can redistribute it and/or modify it
  12     under the terms of the GNU General Public License as published by the
  13     Free Software Foundation; either version 2 of the License, or (at your
  14     option) any later version.
  15
  16     OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
  17     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  18     FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  19     for more details.
  20
  21     You should have received a copy of the GNU General Public License
  22     along with OpenFOAM; if not, write to the Free Software Foundation,
  23     Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
  24
  25 Class
  26     Foam::interpolationTable
  27
  28 Description
  29     A list of times and values.
  30     The time values must be positive and monotonically increasing.
  31
  32     The handling of out-of-bounds values depends on the current setting
  33     of @a outOfBounds.
  34
  35     If @a REPEAT is chosen for the out-of-bounds handling, the final time
  36     value is treated as being equivalent to time=0 for the following periods.
  37
  38 Note
  39     - Accessing an empty list results in an error.
  40     - Accessing a list with a single element always returns the same value.
  41
  42 SourceFiles
  43     interpolationTable.C
  44
  45 \*---------------------------------------------------------------------------*/
  46
  47 #ifndef interpolationTable_H
  48 #define interpolationTable_H
  49
  50 #include "List.H"
  51 #include "Tuple2.H"
  52
  53 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
  54
  55 namespace Foam
  56 {
  57
  58 /*---------------------------------------------------------------------------*\
  59                     Class interpolationTable Declaration
  60 \*---------------------------------------------------------------------------*/
  61
  62 template<class Type>
  63 class interpolationTable
  64 :
  65     public List<Tuple2<scalar, Type> >
  66 {
  67 public:
  68
  69     // Public data types
  70
  71         //- Enumeration for handling out-of-bound values
  72         enum boundsHandling
  73         {
  74             ERROR,          /*!< Exit with a FatalError */
  75             WARN,           /*!< Issue warning and clamp value (default) */
  76             CLAMP,          /*!< Clamp value to the start/end value */
  77             REPEAT          /*!< Treat as a repeating list */
  78         };
  79
  80
  81 private:
  82
  83     // Private data
  84
  85         //- Enumeration for handling out-of-bound values
  86         boundsHandling boundsHandling_;
  87
  88         //- File name
  89         fileName fileName_;
  90
  91
  92     // Private Member Functions
  93
  94         //- Read the table of data from file
  95         void readTable();
  96
  97
  98 public:
  99
 100     // Constructors
 101
 102         //- Construct null
 103         interpolationTable();
 104
 105         //- Construct given the name of the file containing the table of data
 106         interpolationTable(const fileName& fn);
 107
 108         //- Construct by reading the fileName and boundsHandling from dictionary
 109         //  and read the table from that file.
 110         //  This is a specialised constructor used by patchFields
 111         interpolationTable(const dictionary& dict);
 112
 113         //- Construct copy
 114         interpolationTable(const interpolationTable& interpTable);
 115
 116
 117     // Member Functions
 118
 119         //- Return the out-of-bounds handling as a word
 120         word boundsHandlingToWord(const boundsHandling& bound) const;
 121
 122         //- Return the out-of-bounds handling as an enumeration
 123         boundsHandling wordToBoundsHandling(const word& bound) const;
 124
 125         //- Set the out-of-bounds handling from enum, return previous setting
 126         boundsHandling outOfBounds(const boundsHandling& bound);
 127
 128         //- Check that list is monotonically increasing
 129         //  Exit with a FatalError if there is a problem
 130         void check() const;
 131
 132         //- Write
 133         void write(Ostream& os) const;
 134
 135
 136     // Member Operators
 137
 138         //- Return an element of constant Tuple2<scalar, Type>
 139         const Tuple2<scalar, Type>& operator[](const label) const;
 140
 141         //- Return an interpolated value
 142         Type operator()(const scalar) const;
 143 };
 144
 145
 146 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 147
 148 } // End namespace Foam
 149
 150 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 151
 152 #ifdef NoRepository
 153 #   include "interpolationTable.C"
 154 #endif
 155
 156 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 157
 158 #endif
 159
 160 // ************************************************************************* //