ENH: Add XdmfItemProperty to genericize properties attached to XdmfItems. Add...

ENH: Add XdmfItemProperty to genericize properties attached to XdmfItems.  Add a pure virtual getItemProperties() method
to XdmfItem to force children to implement a way to retrieve properties.

CMakeLists.txt

@@ -43,6 +43,7 @@ set(XdmfSources
 	XdmfGeometryType
 	XdmfGrid
 	XdmfItem
+	XdmfItemProperty
 	XdmfObject
 	XdmfTopology
 	XdmfTopologyType

XdmfArray.cpp

@@ -468,6 +468,16 @@ hid_t XdmfArray::getHDF5Type() const
 	return -1;
 }
 
+std::map<std::string, std::string> XdmfArray::getItemProperties() const
+{
+	std::map<std::string, std::string> arrayProperties;
+	arrayProperties["Format"] = "HDF";
+	arrayProperties["DataType"] = this->getType();
+	arrayProperties["Precision"] = this->getPrecision();
+	arrayProperties["Dimensions"] = this->getSize();
+	return arrayProperties;
+}
+
 unsigned int XdmfArray::getPrecision() const
 {
 	if(mHaveArray)

XdmfArray.hpp

@@ -92,6 +92,8 @@ public:
 	 */
 	virtual hid_t getHDF5Type() const;
 
+	std::map<std::string, std::string> getItemProperties() const;
+
 	/**
 	 * Get the precision, in bytes, of the data type of this array.
 	 *

XdmfAttribute.cpp

@@ -31,6 +31,15 @@ XdmfAttributeType XdmfAttribute::getAttributeType() const
 	return mAttributeType;
 }
 
+std::map<std::string, std::string> XdmfAttribute::getItemProperties() const
+{
+	std::map<std::string, std::string> attributeProperties;
+	attributeProperties["Name"] = mName;
+	mAttributeType.getProperties(attributeProperties);
+	mAttributeCenter.getProperties(attributeProperties);
+	return attributeProperties;
+}
+
 std::string XdmfAttribute::getName() const
 {
 	return mName;

XdmfAttribute.hpp

@@ -33,6 +33,8 @@ public:
 	 */
 	XdmfAttributeType getAttributeType() const;
 
+	std::map<std::string, std::string> getItemProperties() const;
+
 	/**
 	 * Get the name of the attribute.
 	 *

XdmfAttributeCenter.cpp

@@ -65,3 +65,8 @@ std::string XdmfAttributeCenter::getName() const
 {
 	return mName;
 }
+
+void XdmfAttributeCenter::getProperties(std::map<std::string, std::string> & collectedProperties) const
+{
+	collectedProperties["Center"] = this->mName;
+}

XdmfAttributeCenter.hpp

@@ -2,7 +2,7 @@
 #define XDMFATTRIBUTECENTER_HPP_
 
 // Includes
-#include <string>
+#include "XdmfItemProperty.hpp"
 
 /**
  * @brief Property describing where XdmfAttribute values are centered.
@@ -18,7 +18,7 @@
  * 	Edge
  * 	Node
  */
-class XdmfAttributeCenter {
+class XdmfAttributeCenter : public XdmfItemProperty {
 
 public:
 
@@ -30,12 +30,14 @@ public:
 	static XdmfAttributeCenter Node();
 
 	/**
-	 * Create the name of this attribute center.
+	 * Get the name of this attribute center.
 	 *
 	 * @return a string containing the name.
 	 */
 	std::string getName() const;
 
+	void getProperties(std::map<std::string, std::string> & collectedProperties) const;
+
 	/**
 	 * Compare two XdmfAttributeCenters for equality.
 	 *
@@ -55,7 +57,6 @@ public:
 	XdmfAttributeCenter(const XdmfAttributeCenter & attributeCenter);
 	XdmfAttributeCenter& operator=(const XdmfAttributeCenter & attributeCenter);
 
-
 protected:
 
 	/**

XdmfAttributeType.cpp

@@ -75,3 +75,8 @@ std::string XdmfAttributeType::getName() const
 {
 	return mName;
 }
+
+void XdmfAttributeType::getProperties(std::map<std::string, std::string> & collectedProperties) const
+{
+	collectedProperties["AttributeType"] = this->mName;
+}

XdmfAttributeType.hpp

@@ -2,7 +2,7 @@
 #define XDMFATTRIBUTETYPE_HPP_
 
 // Includes
-#include <string>
+#include "XdmfItemProperty.hpp"
 
 /**
  * @brief Property describing what types of values an XdmfAttribute contains.
@@ -20,7 +20,7 @@
  * 	Tensor6
  * 	GlobalId
  */
-class XdmfAttributeType {
+class XdmfAttributeType : public XdmfItemProperty {
 
 public:
 
@@ -40,6 +40,8 @@ public:
 	 */
 	std::string getName() const;
 
+	void getProperties(std::map<std::string, std::string> & collectedProperties) const;
+
 	/*
 	 * Compare two XdmfAttributeTypes for equality.
 	 *

XdmfDomain.cpp

@@ -44,6 +44,12 @@ boost::shared_ptr<const XdmfGrid> XdmfDomain::getGrid(unsigned int index) const
 	return mGrids[index];
 }
 
+std::map<std::string, std::string> XdmfDomain::getItemProperties() const
+{
+	std::map<std::string, std::string> domainProperties;
+	return domainProperties;
+}
+
 unsigned int XdmfDomain::getNumberOfGrids() const
 {
 	return mGrids.size();

XdmfDomain.hpp

@@ -37,12 +37,7 @@ public:
 	 */
 	boost::shared_ptr<const XdmfGrid> getGrid(unsigned int index) const;
 
-	/**
-	 * Insert a XdmfGrid into the domain.
-	 *
-	 * @param grid a shared pointer to an XdmfGrid to insert into the domain.
-	 */
-	void insert(boost::shared_ptr<XdmfGrid> grid);
+	std::map<std::string, std::string> getItemProperties() const;
 
 	/**
 	 * Get the number of XdmfGrids attached to this domain.
@@ -51,6 +46,13 @@ public:
 	 */
 	unsigned int getNumberOfGrids() const;
 
+	/**
+	 * Insert a XdmfGrid into the domain.
+	 *
+	 * @param grid a shared pointer to an XdmfGrid to insert into the domain.
+	 */
+	void insert(boost::shared_ptr<XdmfGrid> grid);
+
 	virtual void traverse(boost::shared_ptr<Loki::BaseVisitor> visitor);
 
 protected:

XdmfGeometry.cpp

@@ -25,6 +25,13 @@ XdmfGeometryType XdmfGeometry::getGeometryType() const
 	return mGeometryType;
 }
 
+std::map<std::string, std::string> XdmfGeometry::getItemProperties() const
+{
+	std::map<std::string, std::string> geometryProperties;
+	mGeometryType.getProperties(geometryProperties);
+	return geometryProperties;
+}
+
 void XdmfGeometry::setGeometryType(const XdmfGeometryType & geometryType)
 {
 	mGeometryType = geometryType;

XdmfGeometry.hpp

@@ -26,6 +26,8 @@ public:
 	 */
 	XdmfGeometryType getGeometryType() const;
 
+	std::map<std::string, std::string> getItemProperties() const;
+
 	/**
 	 * Set the XdmfGeometryType associated with this geometry.
 	 *

XdmfGeometryType.cpp

@@ -85,3 +85,8 @@ std::string XdmfGeometryType::getName() const
 {
 	return mName;
 }
+
+void XdmfGeometryType::getProperties(std::map<std::string, std::string> & collectedProperties) const
+{
+	collectedProperties["GeometryType"] = this->mName;
+}

XdmfGeometryType.hpp

@@ -2,7 +2,7 @@
 #define XDMFGEOMETRYTYPE_HPP_
 
 // Includes
-#include <string>
+#include "XdmfItemProperty.hpp"
 
 /**
  * @brief Property describing the types of coordinate values stored in an XdmfGeometry.
@@ -22,7 +22,7 @@
  * 	VXVY
  * 	Origin_DXDY
  */
-class XdmfGeometryType {
+class XdmfGeometryType : public XdmfItemProperty {
 
 public:
 
@@ -51,6 +51,8 @@ public:
 	 */
 	std::string getName() const;
 
+	void getProperties(std::map<std::string, std::string> & collectedProperties) const;
+
 	/*
 	 * Compare two XdmfGeometry types for equality.
 	 *

XdmfGrid.cpp

@@ -55,6 +55,13 @@ boost::shared_ptr<const XdmfGeometry> XdmfGrid::getGeometry() const
 	return mGeometry;
 }
 
+std::map<std::string, std::string> XdmfGrid::getItemProperties() const
+{
+	std::map<std::string, std::string> gridProperties;
+	gridProperties["Name"] = mName;
+	return gridProperties;
+}
+
 std::string XdmfGrid::getName() const
 {
 	return mName;

XdmfGrid.hpp

@@ -54,6 +54,8 @@ public:
 	 */
 	boost::shared_ptr<const XdmfGeometry> getGeometry() const;
 
+	std::map<std::string, std::string> getItemProperties() const;
+
 	/**
 	 * Get the name of the grid.
 	 *

XdmfItem.hpp

@@ -14,6 +14,7 @@ class XdmfVisitor;
 
 // Includes
 #include <loki/Visitor.h>
+#include <map>
 #include "XdmfObject.hpp"
 
 /**
@@ -28,6 +29,19 @@ class XdmfItem : public XdmfObject,
 public:
 
 	LOKI_DEFINE_VISITABLE_BASE()
+
+	/**
+	 * Get the key/value property pairs for this XdmfItem.  These are equivalent to attributes in XML parlance.
+	 *
+	 * @return a map of key/value properties associated with this XdmfItem.
+	 */
+	virtual std::map<std::string, std::string> getItemProperties() const = 0;
+
+	/**
+	 * Traverse this XdmfItem by passing the visitor to its children XdmfItems.
+	 *
+	 * @param a visitor to pass to this XdmfItem's children.
+	 */
 	virtual void traverse(boost::shared_ptr<Loki::BaseVisitor> visitor);
 
 protected:

XdmfItemProperty.cpp

+#include "XdmfItemProperty.hpp"
+
+XdmfItemProperty::XdmfItemProperty()
+{
+}
+
+XdmfItemProperty::~XdmfItemProperty()
+{
+}

XdmfItemProperty.hpp

+#ifndef XDMFITEMPROPERTY_HPP_
+#define XDMFITEMPROPERTY_HPP_
+
+// Includes
+#include <string>
+#include <map>
+#include "XdmfObject.hpp"
+
+/**
+ * @brief Represents a property attached to an XdmfItem.
+ *
+ * XdmfItems can have zero or more properties attached to them that describe a specific characteristic of that item.
+ * For instance, XdmfAttributes have both Type and Center Properties.
+ *
+ * This is an abstract base class to facilitate reading and writing of properties in a generic way.
+ */
+
+class XdmfItemProperty : public XdmfObject {
+
+public:
+
+	/**
+	 * Retrieve the key/value pairs that this XdmfItemProperty contains by inserting into the passed vector.
+	 *
+	 * @param a std::vector<std::pair<std::string, std::string> > to insert name / value pairs into.
+	 */
+	virtual void getProperties(std::map<std::string, std::string> & collectedProperties) const = 0;
+
+protected:
+
+	XdmfItemProperty();
+	virtual ~XdmfItemProperty();
+
+private:
+
+	XdmfItemProperty(const XdmfItemProperty&);  // Not implemented.
+	void operator=(const XdmfItemProperty&);  // Not implemented.
+
+};
+
+#endif /* XDMFITEMPROPERTY_HPP_ */