/** * @file reading_sparse_layouts.cc * * @section LICENSE * * The MIT License * * @copyright Copyright (c) 2018-2020 TileDB, Inc. * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. * * @section DESCRIPTION * * When run, this program will create a simple 2D sparse array, write some data * to it, and read a slice of the data back in the layout of the user's choice * (passed as an argument to the program: "row", "col", or "global"). */ #include #include using namespace tiledb; // Name of array. std::string array_name("reading_sparse_layouts_array"); void create_array() { // Create a TileDB context. Context ctx; // Create domain Domain domain(ctx); domain.add_dimension(Dimension::create(ctx, "rows", {{1, 4}}, 2)) .add_dimension(Dimension::create(ctx, "cols", {{1, 4}}, 2)); // The array will be sparse. ArraySchema schema(ctx, TILEDB_SPARSE); schema.set_domain(domain).set_order({{TILEDB_ROW_MAJOR, TILEDB_ROW_MAJOR}}); // Add a single attribute "a" so each (i,j) cell can store an integer. schema.add_attribute(Attribute::create(ctx, "a")); // Create the (empty) array on disk. Array::create(array_name, schema); } void write_array() { Context ctx; // Prepare data for writing. std::vector coords_rows = {1, 1, 2, 1, 2, 2}; std::vector coords_cols = {1, 2, 2, 4, 3, 4}; std::vector data = {1, 2, 3, 4, 5, 6}; // Open the array for writing and create the query. Array array(ctx, array_name, TILEDB_WRITE); Query query(ctx, array); query.set_layout(TILEDB_GLOBAL_ORDER) .set_buffer("a", data) .set_buffer("rows", coords_rows) .set_buffer("cols", coords_cols); // Perform the write and close the array. query.submit(); query.finalize(); array.close(); } void read_array(tiledb_layout_t layout) { Context ctx; // Prepare the array for reading Array array(ctx, array_name, TILEDB_READ); // Print non-empty domain auto non_empty_domain = array.non_empty_domain(); std::cout << "Non-empty domain: "; std::cout << "[" << non_empty_domain[0].second.first << "," << non_empty_domain[0].second.second << "], [" << non_empty_domain[1].second.first << "," << non_empty_domain[1].second.second << "]\n"; // Slice only rows 1, 2 and cols 2, 3, 4 const std::vector subarray = {1, 2, 2, 4}; // Prepare buffers that will hold the results std::vector data(6); std::vector coords_rows(6); std::vector coords_cols(6); // Prepare the query Query query(ctx, array, TILEDB_READ); query.set_subarray(subarray) .set_layout(layout) .set_buffer("a", data) .set_buffer("rows", coords_rows) .set_buffer("cols", coords_cols); // Submit the query and close the array. query.submit(); array.close(); // Print out the results. auto result_num = (int)query.result_buffer_elements()["a"].second; for (int r = 0; r < result_num; r++) { int i = coords_rows[r]; int j = coords_cols[r]; int a = data[r]; std::cout << "Cell (" << i << ", " << j << ") has data " << a << "\n"; } } int main(int argc, char* argv[]) { Context ctx; // Create and write the array only if it does not exist if (Object::object(ctx, array_name).type() != Object::Type::Array) { create_array(); write_array(); } // Choose a layout (default is row-major) tiledb_layout_t layout = TILEDB_ROW_MAJOR; if (argc > 1) { if (argv[1] == std::string("row")) layout = TILEDB_ROW_MAJOR; else if (argv[1] == std::string("col")) layout = TILEDB_COL_MAJOR; else if (argv[1] == std::string("global")) layout = TILEDB_GLOBAL_ORDER; } read_array(layout); return 0; }