summaryrefslogtreecommitdiffstats log msg author committer range
path: root/rasodmg/dirtiling.hh
blob: 53e77d427a814201136ac79327816b0ecedd27e3 (plain)
 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136  /* * This file is part of rasdaman community. * * Rasdaman community 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. * * Rasdaman community 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 rasdaman community. If not, see . * * Copyright 2003, 2004, 2005, 2006, 2007, 2008, 2009 Peter Baumann / rasdaman GmbH. * * For more information please see * or contact Peter Baumann via . / /** * INCLUDE: dirtiling.hh * * MODULE: rasodmg * CLASS: r_Dir_Tiling * * COMMENTS: * None */ #ifndef _R_DIRTILING_HH_ #define _R_DIRTILING_HH_ // Include statements class r_Dir_Decompose; class r_Dir_Tiling; #include "rasodmg/tiling.hh" // Class definition //@ManMemo: Module: {\bf rasodmg} /*@Doc: This class implements the "Directional Tiling" tiling method. In this method the decomposition is done along certain directions of the multi-dimensional cube. The user uses {\tt r_Dir_Decompose} to inform the system on how the decomposition is done in each dimension. */ /** * \ingroup Rasodmgs */ class r_Dir_Tiling : public r_Dimension_Tiling { // ******************* PUBLIC SECTION ******************* public: /// Constants that specify if subtiling will occur inside the blocks enum SubTiling { WITHOUT_SUBTILING = 0, WITH_SUBTILING = 1, NUMBER = 2 }; /// read everything from encoded string /// e.g. "3;[0,2,4,5],[*],[0,10,15];100;NOSUBTILING" r_Dir_Tiling(const char* encoded) throw (r_Error); /// Class constructor r_Dir_Tiling(r_Dimension dims, const std::vector& decomp, r_Bytes ts = RMInit::clientTileSize, SubTiling sub = WITH_SUBTILING) throw (r_Error); /** The user has to give the number of dimensions of the space and the decomposition wanted for that space. Note that the number of elements of decomp must be the same as the number of dimensions of the space. See {\tt r_Dir_Decompose} for details on how to indicate a decomposition. SubTiling indicates if subtiling should occur inside the blocks specified by the user. Throws an exception when the decomp.size is not equal to the specified dimension. */ virtual ~r_Dir_Tiling(); virtual std::vector* compute_tiles(const r_Minterval& obj_domain, r_Bytes cell_size) const throw (r_Error); virtual bool is_compatible(const r_Minterval& obj_domain, r_Bytes type_len) const; virtual void print_status(std::ostream& os) const; virtual r_Tiling* clone() const; virtual r_Tiling_Scheme get_tiling_scheme() const; //@ManMemo: Module: {\bf raslib} /** Get a tilesize limit for a tilisize limit name */ static r_Dir_Tiling::SubTiling get_subtiling_from_name(const char* name); //@ManMemo: Module: {\bf raslib} /** Get a tilisize limit name for a tilesize limit */ static const char* get_name_from_subtiling(SubTiling st); static const char* description; protected: // data /// The decomposition to be used std::vector dim_decomp; /// If sub-tiling should occour SubTiling sub_tile; //@ManMemo: Module: {\bf raslib} /** The names of all subtiling types, to avoid redundant storage and inconsistencies. The variable name convention is the prefix subtiling_name_ followed by the name of the data format in lower case, i.e. for WITH_SUBTILING subtiling_name_withsubtiling. In addition there's an array of names all_subtiling_names where the subtiling can be used as index to get the name. */ static const char* subtiling_name_withoutsubtiling; static const char* subtiling_name_withsubtiling; static const char* all_subtiling_names[r_Dir_Tiling::NUMBER]; }; #endif