|
Packit |
a4aae4 |
// -*- mode: c++; c-basic-offset:4 -*-
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
// This file is part of libdap, A C++ implementation of the OPeNDAP Data
|
|
Packit |
a4aae4 |
// Access Protocol.
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
// Copyright (c) 2013 OPeNDAP, Inc.
|
|
Packit |
a4aae4 |
// Author: James Gallagher <jgallagher@opendap.org>
|
|
Packit |
a4aae4 |
//
|
|
Packit |
a4aae4 |
// This library is free software; you can redistribute it and/or
|
|
Packit |
a4aae4 |
// modify it under the terms of the GNU Lesser General Public
|
|
Packit |
a4aae4 |
// License as published by the Free Software Foundation; either
|
|
Packit |
a4aae4 |
// version 2.1 of the License, or (at your option) any later version.
|
|
Packit |
a4aae4 |
//
|
|
Packit |
a4aae4 |
// This library is distributed in the hope that it will be useful,
|
|
Packit |
a4aae4 |
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
Packit |
a4aae4 |
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Packit |
a4aae4 |
// Lesser General Public License for more details.
|
|
Packit |
a4aae4 |
//
|
|
Packit |
a4aae4 |
// You should have received a copy of the GNU Lesser General Public
|
|
Packit |
a4aae4 |
// License along with this library; if not, write to the Free Software
|
|
Packit |
a4aae4 |
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
Packit |
a4aae4 |
//
|
|
Packit |
a4aae4 |
// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
#ifndef D4MAPS_H_
|
|
Packit |
a4aae4 |
#define D4MAPS_H_
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
#include <string>
|
|
Packit |
a4aae4 |
#include <vector>
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
using namespace std;
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
namespace libdap {
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
class Array;
|
|
Packit |
a4aae4 |
class XMLWriter;
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
/**
|
|
Packit |
a4aae4 |
* A 'Map' in DAP4 is an Array in the dataset that is used to provide the
|
|
Packit |
a4aae4 |
* domain values for a Coverage (aka a Grid). These Maps are a more
|
|
Packit |
a4aae4 |
* general case of the DAP2 'Map vectors' because a DAP4 Map can have N
|
|
Packit |
a4aae4 |
* dimensions.
|
|
Packit |
a4aae4 |
*
|
|
Packit |
a4aae4 |
* Because the Maps can be shared by any or all of the Arrays in a dataset,
|
|
Packit |
a4aae4 |
* they also correspond to the NetCDF/CF notion of a Shared Dimension.
|
|
Packit |
a4aae4 |
*
|
|
Packit |
a4aae4 |
* In this implementation of the D4Map, each Map has a name and two weak
|
|
Packit |
a4aae4 |
* pointers, one to the Array that holds the domain values and one to the
|
|
Packit |
a4aae4 |
* Array that uses the Map. Note that while Maps can be shared by Arrays,
|
|
Packit |
a4aae4 |
* each Array has it's own collection of these D4Map objects. This makes
|
|
Packit |
a4aae4 |
* processing constraints possible (because it is possible to write
|
|
Packit |
a4aae4 |
* different constraints for two arrays that share Maps).
|
|
Packit |
a4aae4 |
*/
|
|
Packit |
a4aae4 |
class D4Map {
|
|
Packit |
a4aae4 |
std::string d_name;
|
|
Packit |
a4aae4 |
Array *d_array; // the actual map data; weak pointer
|
|
Packit |
a4aae4 |
Array *d_parent; // what array holds this map; weak pointer
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
public:
|
|
Packit |
a4aae4 |
D4Map() : d_name(""), d_array(0), d_parent(0) { }
|
|
Packit |
a4aae4 |
D4Map(const string &name, Array *array, Array *parent = 0) : d_name(name), d_array(array), d_parent(parent) { }
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
virtual ~D4Map() { }
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
const string& name() const { return d_name; }
|
|
Packit |
a4aae4 |
void set_name(const string& name) { d_name = name; }
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
const Array* array() const { return d_array; }
|
|
Packit |
a4aae4 |
void set_array(Array* array) { d_array = array; }
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
/**
|
|
Packit |
a4aae4 |
* @brief The Array that holds this Map
|
|
Packit |
a4aae4 |
*/
|
|
Packit |
a4aae4 |
const Array* parent() const { return d_parent; }
|
|
Packit |
a4aae4 |
void set_parent(Array* parent) { d_parent = parent; }
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
virtual void print_dap4(XMLWriter &xml;;
|
|
Packit |
a4aae4 |
};
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
/**
|
|
Packit |
a4aae4 |
* The D4Maps object holds pointers to all of the Maps used by
|
|
Packit |
a4aae4 |
* a given Array.
|
|
Packit |
a4aae4 |
*/
|
|
Packit |
a4aae4 |
class D4Maps {
|
|
Packit |
a4aae4 |
public:
|
|
Packit |
a4aae4 |
typedef vector<D4Map*>::iterator D4MapsIter;
|
|
Packit |
a4aae4 |
typedef vector<D4Map*>::const_iterator D4MapsCIter;
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
private:
|
|
Packit |
a4aae4 |
vector<D4Map*> d_maps;
|
|
Packit |
a4aae4 |
Array *d_parent; // Array these Maps belong to; weak pointer
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
void m_duplicate(const D4Maps &maps) {
|
|
Packit |
a4aae4 |
d_parent = maps.d_parent;
|
|
Packit |
a4aae4 |
for (D4MapsCIter ci = maps.d_maps.begin(), ce = maps.d_maps.end(); ci != ce; ++ci) {
|
|
Packit |
a4aae4 |
d_maps.push_back(new D4Map(**ci));
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
public:
|
|
Packit |
a4aae4 |
D4Maps() {}
|
|
Packit |
a4aae4 |
D4Maps(Array* parent) : d_parent(parent) { }
|
|
Packit |
a4aae4 |
D4Maps(const D4Maps &maps) { m_duplicate(maps); }
|
|
Packit |
a4aae4 |
virtual ~D4Maps() {
|
|
Packit |
a4aae4 |
for (D4MapsIter i = d_maps.begin(), e = d_maps.end(); i != e; ++i)
|
|
Packit |
a4aae4 |
delete *i;
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
D4Maps &operator=(const D4Maps &rhs;;
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
/**
|
|
Packit |
a4aae4 |
* Add a map. This does not test for duplicate names or Array pointers;
|
|
Packit |
a4aae4 |
* It assumes that the caller has done that!
|
|
Packit |
a4aae4 |
*/
|
|
Packit |
a4aae4 |
void add_map(D4Map *map) {
|
|
Packit |
a4aae4 |
d_maps.push_back(map);
|
|
Packit |
a4aae4 |
// if the Map parent is not set, do so now
|
|
Packit |
a4aae4 |
if (!d_maps.back()->parent())
|
|
Packit |
a4aae4 |
d_maps.back()->set_parent(d_parent);
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
void remove_map(D4Map *map) {
|
|
Packit |
a4aae4 |
for (D4MapsIter i = d_maps.begin(), e = d_maps.end(); i != e; ++i) {
|
|
Packit |
a4aae4 |
/* && (*i)->parent() == map->parent() */
|
|
Packit |
a4aae4 |
// Don't test if the map->parent() matches - we only care about the name and array.
|
|
Packit |
a4aae4 |
// This method is intended for processing CE array slices that are edge cases and
|
|
Packit |
a4aae4 |
// is only called from code where we know map->parent() matches *i->parent().
|
|
Packit |
a4aae4 |
// jhrg 4/12/16
|
|
Packit |
a4aae4 |
if ((*i)->name() == map->name() && (*i)->array() == map->array()) {
|
|
Packit |
a4aae4 |
d_maps.erase(i);
|
|
Packit |
a4aae4 |
break;
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
D4Map* get_map(int i) { return d_maps.at(i); }
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
D4MapsIter map_begin() { return d_maps.begin(); }
|
|
Packit |
a4aae4 |
D4MapsIter map_end() { return d_maps.end(); }
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
int size() const { return d_maps.size(); }
|
|
Packit |
a4aae4 |
bool empty() const { return d_maps.empty(); }
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
virtual void print_dap4(XMLWriter &xml) {
|
|
Packit |
a4aae4 |
for (D4MapsIter i = d_maps.begin(), e = d_maps.end(); i != e; ++i)
|
|
Packit |
a4aae4 |
(*i)->print_dap4(xml);
|
|
Packit |
a4aae4 |
}
|
|
Packit |
a4aae4 |
};
|
|
Packit |
a4aae4 |
|
|
Packit |
a4aae4 |
} /* namespace libdap */
|
|
Packit |
a4aae4 |
#endif /* D4MAPS_H_ */
|