add missing docs bp example src and output

src/docs/sphinx/t_conduit_docs_blueprint_examples_out.txt

@@ -0,0 +1,91 @@
+Running main() from gtest_main.cc
+[==========] Running 2 tests from 1 test case.
+[----------] Global test environment set-up.
+[----------] 2 tests from conduit_docs
+[ RUN      ] conduit_docs.blueprint_example_1
+[/Users/harrison37/Work/conduit/src/tests/docs/t_conduit_docs_blueprint_examples.cpp : 63]
+ blueprint_example_1
+mesh verify succeeded.
+
+{
+  "coords": 
+  {
+    "values": 
+    {
+      "valid": "true"
+    },
+    "valid": "true"
+  }
+}
+[/Users/harrison37/Work/conduit/src/tests/docs/t_conduit_docs_blueprint_examples.cpp : 81]
+ blueprint_example_1
+[       OK ] conduit_docs.blueprint_example_1 (1 ms)
+[ RUN      ] conduit_docs.blueprint_example_2
+[/Users/harrison37/Work/conduit/src/tests/docs/t_conduit_docs_blueprint_examples.cpp : 88]
+ blueprint_example_2
+example 'separate' mcarray 
+
+{
+  "x": [1.0, 1.0, 1.0, 1.0, 1.0],
+  "y": [2.0, 2.0, 2.0, 2.0, 2.0],
+  "z": [3.0, 3.0, 3.0, 3.0, 3.0]
+}
+
+{
+  "mem_spaces": 
+  {
+    "0x7f801ac03bd0": 
+    {
+      "path": "x",
+      "type": "alloced",
+      "bytes": 40
+    },
+    "0x7f801ac03ed0": 
+    {
+      "path": "y",
+      "type": "alloced",
+      "bytes": 40
+    },
+    "0x7f801ac03c00": 
+    {
+      "path": "z",
+      "type": "alloced",
+      "bytes": 40
+    }
+  },
+  "total_bytes": 120,
+  "total_bytes_compact": 120,
+  "total_bytes_alloced": 120,
+  "total_bytes_mmaped": 0
+}
+transformed to 'interleaved' mcarray 
+
+{
+  "x": {"dtype":"float64", "number_of_elements": 5, "offset": 0, "stride": 24, "element_bytes": 8, "endianness": "little", "value": [1.0, 1.0, 1.0, 1.0, 1.0]},
+  "y": {"dtype":"float64", "number_of_elements": 5, "offset": 8, "stride": 24, "element_bytes": 8, "endianness": "little", "value": [2.0, 2.0, 2.0, 2.0, 2.0]},
+  "z": {"dtype":"float64", "number_of_elements": 5, "offset": 16, "stride": 24, "element_bytes": 8, "endianness": "little", "value": [3.0, 3.0, 3.0, 3.0, 3.0]}
+}
+
+{
+  "mem_spaces": 
+  {
+    "0x7f801ac05b00": 
+    {
+      "path": "",
+      "type": "alloced",
+      "bytes": 136
+    }
+  },
+  "total_bytes": 360,
+  "total_bytes_compact": 120,
+  "total_bytes_alloced": 136,
+  "total_bytes_mmaped": 0
+}
+[/Users/harrison37/Work/conduit/src/tests/docs/t_conduit_docs_blueprint_examples.cpp : 118]
+ blueprint_example_2
+[       OK ] conduit_docs.blueprint_example_2 (0 ms)
+[----------] 2 tests from conduit_docs (1 ms total)
+
+[----------] Global test environment tear-down
+[==========] 2 tests from 1 test case ran. (1 ms total)
+[  PASSED  ] 2 tests.

src/tests/docs/t_conduit_docs_blueprint_examples.cpp

@@ -0,0 +1,120 @@
+//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~//
+// Copyright (c) 2014-2016, Lawrence Livermore National Security, LLC.
+// 
+// Produced at the Lawrence Livermore National Laboratory
+// 
+// LLNL-CODE-666778
+// 
+// All rights reserved.
+// 
+// This file is part of Conduit. 
+// 
+// For details, see: http://software.llnl.gov/conduit/.
+// 
+// Please also read conduit/LICENSE
+// 
+// Redistribution and use in source and binary forms, with or without 
+// modification, are permitted provided that the following conditions are met:
+// 
+// * Redistributions of source code must retain the above copyright notice, 
+//   this list of conditions and the disclaimer below.
+// 
+// * Redistributions in binary form must reproduce the above copyright notice,
+//   this list of conditions and the disclaimer (as noted below) in the
+//   documentation and/or other materials provided with the distribution.
+// 
+// * Neither the name of the LLNS/LLNL nor the names of its contributors may
+//   be used to endorse or promote products derived from this software without
+//   specific prior written permission.
+// 
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+// ARE DISCLAIMED. IN NO EVENT SHALL LAWRENCE LIVERMORE NATIONAL SECURITY,
+// LLC, THE U.S. DEPARTMENT OF ENERGY OR CONTRIBUTORS BE LIABLE FOR ANY
+// DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
+// DAMAGES  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+// OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+// HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 
+// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+// IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
+// POSSIBILITY OF SUCH DAMAGE.
+// 
+//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~//
+
+//-----------------------------------------------------------------------------
+///
+/// file: t_conduit_docs_blueprint_examples.cpp
+///
+//-----------------------------------------------------------------------------
+
+#include "conduit.hpp"
+#include "conduit_blueprint.hpp"
+#include "conduit_relay.hpp"
+
+#include <iostream>
+#include "gtest/gtest.h"
+using namespace conduit;
+
+//-----------------------------------------------------------------------------
+// 65-79
+TEST(conduit_docs, blueprint_example_1)
+{
+    CONDUIT_INFO("blueprint_example_1");
+
+    // setup our candidate and info nodes
+    Node n, info;
+
+    //create an example mesh
+    conduit::blueprint::mesh::examples::braid("tets",
+                                               5,5,5,
+                                               n);
+    // check if n conforms
+    if(conduit::blueprint::verify("mesh",n,info))
+        std::cout << "mesh verify succeeded." << std::endl;
+    else
+        std::cout << "mesh verify failed!" << std::endl;
+
+    // show some of the verify details
+    info["coordsets"].print();
+
+    CONDUIT_INFO("blueprint_example_1");
+}
+
+//-----------------------------------------------------------------------------
+// 90-110
+TEST(conduit_docs, blueprint_example_2)
+{
+    CONDUIT_INFO("blueprint_example_2");
+
+    // setup our candidate and info nodes
+    Node n, verify_info, mem_info;
+
+    // create an example mcarray
+    conduit::blueprint::mcarray::examples::xyz("separate",5,n);
+
+    std::cout << "example 'separate' mcarray " << std::endl;
+    n.print();
+    n.info(mem_info);
+    mem_info.print();
+
+    // check if n conforms
+    if(conduit::blueprint::verify("mcarray",n,verify_info))
+    {
+        // check if our mcarray has a specific memory layout 
+        if(!conduit::blueprint::mcarray::is_interleaved(n))
+        {
+            // copy data from n into the desired memory layout
+            Node xform;
+            conduit::blueprint::mcarray::to_interleaved(n,xform);
+
+            std::cout << "transformed to 'interleaved' mcarray " << std::endl;
+            xform.print_detailed();
+            xform.info(mem_info);
+            mem_info.print();
+        }
+    }
+
+    CONDUIT_INFO("blueprint_example_2");
+}
+