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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
|
//# TiledColumnStMan.cc: Storage manager for tables using tiled hypercubes
//# Copyright (C) 1995,1996,1997,1999,2000,2001,2003
//# Associated Universities, Inc. Washington DC, USA.
//#
//# This library is free software; you can redistribute it and/or modify it
//# under the terms of the GNU Library General Public License as published by
//# the Free Software Foundation; either version 2 of the License, or (at your
//# option) any later version.
//#
//# This library 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 Library General Public
//# License for more details.
//#
//# You should have received a copy of the GNU Library General Public License
//# along with this library; if not, write to the Free Software Foundation,
//# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA.
//#
//# Correspondence concerning AIPS++ should be addressed as follows:
//# Internet email: casa-feedback@nrao.edu.
//# Postal address: AIPS++ Project Office
//# National Radio Astronomy Observatory
//# 520 Edgemont Road
//# Charlottesville, VA 22903-2475 USA
#include <casacore/tables/DataMan/TiledColumnStMan.h>
#include <casacore/tables/DataMan/TSMColumn.h>
#include <casacore/tables/DataMan/TSMCube.h>
#include <casacore/tables/DataMan/TSMFile.h>
#include <casacore/tables/Tables/Table.h>
#include <casacore/tables/Tables/TableDesc.h>
#include <casacore/tables/Tables/ColumnDesc.h>
#include <casacore/casa/Arrays/Vector.h>
#include <casacore/casa/Arrays/IPosition.h>
#include <casacore/casa/Utilities/DataType.h>
#include <casacore/casa/BasicSL/String.h>
#include <casacore/casa/Utilities/BinarySearch.h>
#include <casacore/casa/IO/AipsIO.h>
#include <casacore/casa/IO/ArrayIO.h>
#include <casacore/tables/DataMan/DataManError.h>
namespace casacore { //# NAMESPACE CASACORE - BEGIN
//# Allocate an empty record to avoid reconstructing it over and over
//# again when addRow is called many times.
static Record emptyRecord;
TiledColumnStMan::TiledColumnStMan ()
: TiledStMan ()
{}
TiledColumnStMan::TiledColumnStMan (const String& hypercolumnName,
const IPosition& tileShape,
uInt64 maximumCacheSize)
: TiledStMan (hypercolumnName, maximumCacheSize),
tileShape_p (tileShape)
{}
TiledColumnStMan::TiledColumnStMan (const String& hypercolumnName,
const Record& spec)
: TiledStMan (hypercolumnName, 0)
{
if (spec.isDefined ("DEFAULTTILESHAPE")) {
tileShape_p = IPosition (spec.toArrayInt ("DEFAULTTILESHAPE"));
}
if (spec.isDefined ("MAXIMUMCACHESIZE")) {
setPersMaxCacheSize (spec.asInt64 ("MAXIMUMCACHESIZE"));
}
}
TiledColumnStMan::~TiledColumnStMan()
{}
DataManager* TiledColumnStMan::clone() const
{
TiledColumnStMan* smp = new TiledColumnStMan (hypercolumnName_p,
tileShape_p,
maximumCacheSize());
return smp;
}
DataManager* TiledColumnStMan::makeObject (const String& group,
const Record& spec)
{
TiledColumnStMan* smp = new TiledColumnStMan (group, spec);
return smp;
}
String TiledColumnStMan::dataManagerType() const
{
return "TiledColumnStMan";
}
Bool TiledColumnStMan::canAccessColumn () const
{
return True;
}
void TiledColumnStMan::create64 (rownr_t nrrow)
{
// Set up the various things.
setup(1);
// Create the one and single TSMFile object.
createFile (0);
// Create the hypercube object.
// Its shape is the cell shape plus an extensible last dimension.
// Check if the hypercube dimensionality is one extra.
if (nrdim_p != fixedCellShape_p.nelements() + 1) {
throw (TSMError ("TiledColumnStMan: hypercube dimensionality "
"has to be 1 + cell dimensionality"));
}
IPosition cubeShape (fixedCellShape_p);
cubeShape.resize (nrdim_p);
cubeShape(nrdim_p - 1) = 0;
cubeSet_p.resize (1);
cubeSet_p[0] = makeTSMCube (fileSet_p[0],
cubeShape, tileShape_p, emptyRecord);
// Add the rows for the given number of rows.
addRow64 (nrrow);
}
Bool TiledColumnStMan::flush (AipsIO&, Bool fsync)
{
// Flush the caches.
// Exit if nothing has changed.
if (! flushCaches (fsync)) {
return False;
}
// Create the header file and write data in it.
AipsIO* headerFile = headerFileCreate();
headerFile->putstart ("TiledColumnStMan", 1);
*headerFile << tileShape_p;
// Let the base class write its data; there is only one TSMCube to write.
headerFilePut (*headerFile, 1);
headerFile->putend();
headerFileClose (headerFile);
return True;
}
void TiledColumnStMan::readHeader (rownr_t tabNrrow, Bool firstTime)
{
// Open the header file and read data from it.
AipsIO* headerFile = headerFileOpen();
headerFile->getstart ("TiledColumnStMan");
*headerFile >> tileShape_p;
// Let the base class read and initialize its data.
headerFileGet (*headerFile, tabNrrow, firstTime, 1);
headerFile->getend();
headerFileClose (headerFile);
}
void TiledColumnStMan::setupCheck (const TableDesc& tableDesc,
const Vector<String>& dataNames) const
{
// The data columns may only contain arrays with the correct
// dimensionality, which should be one less than the hypercube
// dimensionality.
Int ndim = nrdim_p - 1;
for (uInt i=0; i<dataNames.nelements(); i++) {
const ColumnDesc& columnDesc = tableDesc.columnDesc (dataNames(i));
if (columnDesc.isScalar()) {
if (ndim != 0) {
throw (TSMError ("Using scalar column " + dataNames(i) +
" in TiledColumnStMan needs the hypercolumn"
" to be 1-dim"));
}
} else {
if (! columnDesc.isArray() || ndim != columnDesc.ndim()) {
throw (TSMError ("Dimensionality of column " + dataNames(i) +
" should be one less than hypercolumn"
" definition when used in TiledColumnStMan"));
}
// The data columns in a column hypercube must be fixed shape.
if ((columnDesc.options() & ColumnDesc::FixedShape)
!= ColumnDesc::FixedShape) {
throw (TSMError ("TiledColumnStMan needs array column " +
dataNames(i) + " to be FixedShape"));
}
}
}
// There shouldn't be ID columns.
if (idColSet_p.nelements() > 0) {
throw TSMError("ID columns cannot be used with TiledColumnStMan");
}
}
IPosition TiledColumnStMan::defaultTileShape() const
{
return tileShape_p;
}
void TiledColumnStMan::addRow64 (rownr_t nrow)
{
cubeSet_p[0]->extend (nrow, emptyRecord, coordColSet_p[nrdim_p - 1]);
nrrow_p += nrow;
setDataChanged();
}
TSMCube* TiledColumnStMan::getHypercube (rownr_t rownr)
{
// Check if the row number is correct.
if (rownr >= nrrow_p) {
throw (TSMError ("getHypercube: rownr is too high"));
}
return cubeSet_p[0];
}
TSMCube* TiledColumnStMan::getHypercube (rownr_t rownr, IPosition& position)
{
// Check if the row number is correct.
if (rownr >= nrrow_p) {
throw (TSMError ("getHypercube: rownr is too high"));
}
// The rownr is the position in the hypercube.
position.resize (0);
position = cubeSet_p[0]->cubeShape();
position(nrdim_p-1) = rownr;
return cubeSet_p[0];
}
} //# NAMESPACE CASACORE - END
|
