Standardize Collective Client Calls

docs/source/client_api.rst

@@ -95,7 +95,7 @@ quickly navigate to each subsection:
 .. doxygenfunction:: PDCcont_create
    :project: PDC
 
-.. doxygenfunction:: PDCcont_create_col
+.. doxygenfunction:: PDCcont_create_coll
    :project: PDC
 
 .. doxygenfunction:: PDCcont_open

docs/source/using_pdc.rst

@@ -72,7 +72,7 @@ This is shown in the example below:
     pdcid_t cont_id = PDCcont_create("cont", cont_prop_id)
 
     // Collective container creation
-    pdcid_t cont_col_id = PDCcont_create_col("cont", cont_prop_id);
+    pdcid_t cont_col_id = PDCcont_create_coll("cont", cont_prop_id, MPI_COMM_WORLD);
 
 To open an existing container:
 
@@ -115,7 +115,7 @@ Below is an example of setting up an object property and creating objects:
     pdcid_t obj_id = PDCobj_create(cont_id, "obj", obj_prop_id);
 
     // Collective object creation
-    pdcid_t obj_col_id = PDCobj_create_col(cont_id, "obj", obj_prop_id, my_rank, comm);
+    pdcid_t obj_col_id = PDCobj_create_coll(cont_id, "obj", obj_prop_id, my_rank, comm);
 
 To open an existing object by name within a container:
 
@@ -141,7 +141,7 @@ Regions define logical subranges within a PDC object and are used to specify wha
 Transfers can be performed in three main modes:
 
 - Individually, with ``PDCregion_transfer_start()``
-- Collectively, with ``PDCregion_transfer_start_mpi()`` across MPI processes
+- Collectively, with ``PDCregion_transfer_start_coll()`` across MPI processes
 - In batches, with ``PDCregion_transfer_start_all()`` and ``PDCregion_transfer_wait_all()``
 
 Basic Region Transfer
@@ -177,7 +177,7 @@ If the transfer is intended to be performed collectively across MPI ranks, use:
 
 .. code-block:: C
 
-    PDCregion_transfer_start_mpi(xfer);
+    PDCregion_transfer_start_coll(transfer_request_id, comm);
 
 This function should be called by all processes participating in 
 the transfer and is useful for coordinated I/O in distributed 

examples/bdcats.c

@@ -103,7 +103,7 @@ main(int argc, char **argv)
 
         // open objects
 #ifdef ENABLE_MPI
-    obj_xx = PDCobj_open_col("obj-var-xx", pdc_id);
+    obj_xx = PDCobj_open_coll("obj-var-xx", pdc_id, MPI_COMM_WORLD);
 #else
     obj_xx   = PDCobj_open("obj-var-xx", pdc_id);
 #endif
@@ -112,7 +112,7 @@ main(int argc, char **argv)
         exit(-1);
     }
 #ifdef ENABLE_MPI
-    obj_yy = PDCobj_open_col("obj-var-yy", pdc_id);
+    obj_yy = PDCobj_open_coll("obj-var-yy", pdc_id, MPI_COMM_WORLD);
 #else
     obj_yy   = PDCobj_open("obj-var-xx", pdc_id);
 #endif
@@ -121,7 +121,7 @@ main(int argc, char **argv)
         exit(-1);
     }
 #ifdef ENABLE_MPI
-    obj_zz = PDCobj_open_col("obj-var-zz", pdc_id);
+    obj_zz = PDCobj_open_coll("obj-var-zz", pdc_id, MPI_COMM_WORLD);
 #else
     obj_zz   = PDCobj_open("obj-var-xx", pdc_id);
 #endif
@@ -130,7 +130,7 @@ main(int argc, char **argv)
         exit(-1);
     }
 #ifdef ENABLE_MPI
-    obj_pxx = PDCobj_open_col("obj-var-pxx", pdc_id);
+    obj_pxx = PDCobj_open_coll("obj-var-pxx", pdc_id, MPI_COMM_WORLD);
 #else
     obj_pxx  = PDCobj_open("obj-var-xx", pdc_id);
 #endif
@@ -139,7 +139,7 @@ main(int argc, char **argv)
         exit(-1);
     }
 #ifdef ENABLE_MPI
-    obj_pyy = PDCobj_open_col("obj-var-pyy", pdc_id);
+    obj_pyy = PDCobj_open_coll("obj-var-pyy", pdc_id, MPI_COMM_WORLD);
 #else
     obj_pyy  = PDCobj_open("obj-var-xx", pdc_id);
 #endif
@@ -148,7 +148,7 @@ main(int argc, char **argv)
         exit(-1);
     }
 #ifdef ENABLE_MPI
-    obj_pzz = PDCobj_open_col("obj-var-pzz", pdc_id);
+    obj_pzz = PDCobj_open_coll("obj-var-pzz", pdc_id, MPI_COMM_WORLD);
 #else
     obj_pzz  = PDCobj_open("obj-var-xx", pdc_id);
 #endif
@@ -157,7 +157,7 @@ main(int argc, char **argv)
         exit(-1);
     }
 #ifdef ENABLE_MPI
-    obj_id11 = PDCobj_open_col("id11", pdc_id);
+    obj_id11 = PDCobj_open_coll("id11", pdc_id, MPI_COMM_WORLD);
 #else
     obj_id11 = PDCobj_open("obj-var-xx", pdc_id);
 #endif
@@ -166,7 +166,7 @@ main(int argc, char **argv)
         exit(-1);
     }
 #ifdef ENABLE_MPI
-    obj_id22 = PDCobj_open_col("id22", pdc_id);
+    obj_id22 = PDCobj_open_coll("id22", pdc_id, MPI_COMM_WORLD);
 #else
     obj_id22 = PDCobj_open("obj-var-xx", pdc_id);
 #endif

examples/bdcats_batch.c

@@ -175,7 +175,7 @@ main(int argc, char **argv)
     for (i = 0; i < timestep; ++i) {
         sprintf(obj_name, "obj-var-xx %" PRIu64 "", i);
 #ifdef ENABLE_MPI
-        obj_xx[i] = PDCobj_open_col(obj_name, pdc_id);
+        obj_xx[i] = PDCobj_open_coll(obj_name, pdc_id, MPI_COMM_WORLD);
 #else
         obj_xx[i]   = PDCobj_open(obj_name, pdc_id);
 #endif
@@ -185,7 +185,7 @@ main(int argc, char **argv)
         }
         sprintf(obj_name, "obj-var-yy %" PRIu64 "", i);
 #ifdef ENABLE_MPI
-        obj_yy[i] = PDCobj_open_col(obj_name, pdc_id);
+        obj_yy[i] = PDCobj_open_coll(obj_name, pdc_id, MPI_COMM_WORLD);
 #else
         obj_yy[i]   = PDCobj_open(obj_name, pdc_id);
 #endif
@@ -195,7 +195,7 @@ main(int argc, char **argv)
         }
         sprintf(obj_name, "obj-var-zz %" PRIu64 "", i);
 #ifdef ENABLE_MPI
-        obj_zz[i] = PDCobj_open_col(obj_name, pdc_id);
+        obj_zz[i] = PDCobj_open_coll(obj_name, pdc_id, MPI_COMM_WORLD);
 #else
         obj_zz[i]   = PDCobj_open(obj_name, pdc_id);
 #endif
@@ -205,7 +205,7 @@ main(int argc, char **argv)
         }
         sprintf(obj_name, "obj-var-pxx %" PRIu64 "", i);
 #ifdef ENABLE_MPI
-        obj_pxx[i] = PDCobj_open_col(obj_name, pdc_id);
+        obj_pxx[i] = PDCobj_open_coll(obj_name, pdc_id, MPI_COMM_WORLD);
 #else
         obj_pxx[i]  = PDCobj_open(obj_name, pdc_id);
 #endif
@@ -215,7 +215,7 @@ main(int argc, char **argv)
         }
         sprintf(obj_name, "obj-var-pyy %" PRIu64 "", i);
 #ifdef ENABLE_MPI
-        obj_pyy[i] = PDCobj_open_col(obj_name, pdc_id);
+        obj_pyy[i] = PDCobj_open_coll(obj_name, pdc_id, MPI_COMM_WORLD);
 #else
         obj_pyy[i]  = PDCobj_open(obj_name, pdc_id);
 #endif
@@ -225,7 +225,7 @@ main(int argc, char **argv)
         }
         sprintf(obj_name, "obj-var-pzz %" PRIu64 "", i);
 #ifdef ENABLE_MPI
-        obj_pzz[i] = PDCobj_open_col(obj_name, pdc_id);
+        obj_pzz[i] = PDCobj_open_coll(obj_name, pdc_id, MPI_COMM_WORLD);
 #else
         obj_pzz[i]  = PDCobj_open(obj_name, pdc_id);
 #endif
@@ -235,7 +235,7 @@ main(int argc, char **argv)
         }
         sprintf(obj_name, "id11 %" PRIu64 "", i);
 #ifdef ENABLE_MPI
-        obj_id11[i] = PDCobj_open_col(obj_name, pdc_id);
+        obj_id11[i] = PDCobj_open_coll(obj_name, pdc_id, MPI_COMM_WORLD);
 #else
         obj_id11[i] = PDCobj_open(obj_name, pdc_id);
 #endif
@@ -245,7 +245,7 @@ main(int argc, char **argv)
         }
         sprintf(obj_name, "id22 %" PRIu64 "", i);
 #ifdef ENABLE_MPI
-        obj_id22[i] = PDCobj_open_col(obj_name, pdc_id);
+        obj_id22[i] = PDCobj_open_coll(obj_name, pdc_id, MPI_COMM_WORLD);
 #else
         obj_id22[i] = PDCobj_open(obj_name, pdc_id);
 #endif

examples/haccio.c

@@ -75,7 +75,7 @@ create_pdc_object(pdcid_t pdc_id, pdcid_t cont_id, const char *obj_name, pdc_var
     PDCprop_set_obj_user_id(*obj_prop, getuid());
     PDCprop_set_obj_app_name(*obj_prop, "HACCIO");
 
-    pdcid_t obj_id = PDCobj_create_mpi(cont_id, obj_name, *obj_prop, 0, comm);
+    pdcid_t obj_id = PDCobj_create_coll(cont_id, obj_name, *obj_prop, 0, comm);
     if (obj_id == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-xx");
         exit(-1);
@@ -117,7 +117,7 @@ main(int argc, char **argv)
     cont_prop = PDCprop_create(PDC_CONT_CREATE, pdc_id);
 
     // create a container
-    cont_id = PDCcont_create_col("c1", cont_prop);
+    cont_id = PDCcont_create_coll("c1", cont_prop, MPI_COMM_WORLD);
 
     uint64_t offset = 0, offset_remote = mpi_rank * NUM_PARTICLES, mysize = NUM_PARTICLES;
 

examples/haccio_v2.c

@@ -76,7 +76,7 @@ create_pdc_object(pdcid_t pdc_id, pdcid_t cont_id, const char *obj_name, pdc_var
     PDCprop_set_obj_app_name(*obj_prop, "HACCIO");
     PDCprop_set_obj_consistency_semantics(*obj_prop, PDC_CONSISTENCY_POSIX);
 
-    pdcid_t obj_id = PDCobj_create_mpi(cont_id, obj_name, *obj_prop, 0, comm);
+    pdcid_t obj_id = PDCobj_create_coll(cont_id, obj_name, *obj_prop, 0, comm);
     if (obj_id == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-xx");
         exit(-1);
@@ -119,7 +119,7 @@ main(int argc, char **argv)
     cont_prop = PDCprop_create(PDC_CONT_CREATE, pdc_id);
 
     // create a container
-    cont_id = PDCcont_create_col("c1", cont_prop);
+    cont_id = PDCcont_create_coll("c1", cont_prop, MPI_COMM_WORLD);
 
     uint64_t offset = 0, offset_remote = mpi_rank * NUM_PARTICLES, mysize = NUM_PARTICLES;
 

examples/read_write_col_perf.c

@@ -171,7 +171,7 @@ main(int argc, char **argv)
         // create first object
         sprintf(obj_name1, "o1_%d", i);
 #ifdef ENABLE_MPI
-        obj1 = PDCobj_create_mpi(cont, obj_name1, obj_prop, 0, MPI_COMM_WORLD);
+        obj1 = PDCobj_create_coll(cont, obj_name1, obj_prop, 0, MPI_COMM_WORLD);
 #else
         obj1 = PDCobj_create(cont, obj_name1, obj_prop);
 #endif

examples/tileio.c

@@ -43,7 +43,7 @@ create_pdc_object(pdcid_t pdc_id, pdcid_t cont_id, const char *obj_name, pdcid_t
     PDCprop_set_obj_app_name(*obj_prop, "mpi-tile-io");
     PDCprop_set_obj_tags(*obj_prop, "tag0=1");
 
-    pdcid_t obj_id = PDCobj_create_mpi(cont_id, obj_name, *obj_prop, 0, g_mpi_comm);
+    pdcid_t obj_id = PDCobj_create_coll(cont_id, obj_name, *obj_prop, 0, g_mpi_comm);
     if (obj_id == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-xx");
         exit(-1);
@@ -112,7 +112,7 @@ main(int argc, char **argv)
 
     // Create containter
     cont_prop = PDCprop_create(PDC_CONT_CREATE, pdc_id);
-    cont_id   = PDCcont_create_col("c1", cont_prop);
+    cont_id   = PDCcont_create_coll("c1", cont_prop, MPI_COMM_WORLD);
 
     // Craete object (and its prop)
     obj_id = create_pdc_object(pdc_id, cont_id, "tile_io_obj", &obj_prop);

examples/tileio_v2.c

@@ -43,7 +43,7 @@ create_pdc_object(pdcid_t pdc_id, pdcid_t cont_id, const char *obj_name, pdcid_t
     PDCprop_set_obj_app_name(*obj_prop, "mpi-tile-io");
     PDCprop_set_obj_tags(*obj_prop, "tag0=1");
 
-    pdcid_t obj_id = PDCobj_create_mpi(cont_id, obj_name, *obj_prop, 0, g_mpi_comm);
+    pdcid_t obj_id = PDCobj_create_coll(cont_id, obj_name, *obj_prop, 0, g_mpi_comm);
     if (obj_id == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-xx");
         exit(-1);
@@ -115,7 +115,7 @@ main(int argc, char **argv)
     // Init PDC
     pdc_id    = PDCinit("pdc");
     cont_prop = PDCprop_create(PDC_CONT_CREATE, pdc_id);
-    cont_id   = PDCcont_create_col("c1", cont_prop);
+    cont_id   = PDCcont_create_coll("c1", cont_prop, MPI_COMM_WORLD);
     obj_id    = create_pdc_object(pdc_id, cont_id, "tile_io_obj", &obj_prop);
 
     // Create region

examples/vpicio.c

@@ -116,7 +116,7 @@ main(int argc, char **argv)
         return 1;
     }
     // create a container
-    cont_id = PDCcont_create_col("c1", cont_prop);
+    cont_id = PDCcont_create_coll("c1", cont_prop, MPI_COMM_WORLD);
     if (cont_id <= 0) {
         LOG_ERROR("Failed to create container");
         return 1;
@@ -152,44 +152,44 @@ main(int argc, char **argv)
     obj_prop_id22 = PDCprop_obj_dup(obj_prop_xx);
     PDCprop_set_obj_type(obj_prop_id22, PDC_INT);
 
-    obj_xx = PDCobj_create_mpi(cont_id, "obj-var-xx", obj_prop_xx, 0, comm);
+    obj_xx = PDCobj_create_coll(cont_id, "obj-var-xx", obj_prop_xx, 0, comm);
     if (obj_xx == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-xx");
         exit(-1);
     }
 
-    obj_yy = PDCobj_create_mpi(cont_id, "obj-var-yy", obj_prop_yy, 0, comm);
+    obj_yy = PDCobj_create_coll(cont_id, "obj-var-yy", obj_prop_yy, 0, comm);
     if (obj_yy == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-yy");
         exit(-1);
     }
-    obj_zz = PDCobj_create_mpi(cont_id, "obj-var-zz", obj_prop_zz, 0, comm);
+    obj_zz = PDCobj_create_coll(cont_id, "obj-var-zz", obj_prop_zz, 0, comm);
     if (obj_zz == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-zz");
         exit(-1);
     }
-    obj_pxx = PDCobj_create_mpi(cont_id, "obj-var-pxx", obj_prop_pxx, 0, comm);
+    obj_pxx = PDCobj_create_coll(cont_id, "obj-var-pxx", obj_prop_pxx, 0, comm);
     if (obj_pxx == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-pxx");
         exit(-1);
     }
-    obj_pyy = PDCobj_create_mpi(cont_id, "obj-var-pyy", obj_prop_pyy, 0, comm);
+    obj_pyy = PDCobj_create_coll(cont_id, "obj-var-pyy", obj_prop_pyy, 0, comm);
     if (obj_pyy == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-pyy");
         exit(-1);
     }
-    obj_pzz = PDCobj_create_mpi(cont_id, "obj-var-pzz", obj_prop_pzz, 0, comm);
+    obj_pzz = PDCobj_create_coll(cont_id, "obj-var-pzz", obj_prop_pzz, 0, comm);
     if (obj_pzz == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-pzz");
         exit(-1);
     }
 
-    obj_id11 = PDCobj_create_mpi(cont_id, "id11", obj_prop_id11, 0, comm);
+    obj_id11 = PDCobj_create_coll(cont_id, "id11", obj_prop_id11, 0, comm);
     if (obj_id11 == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj_id11");
         exit(-1);
     }
-    obj_id22 = PDCobj_create_mpi(cont_id, "id22", obj_prop_id22, 0, comm);
+    obj_id22 = PDCobj_create_coll(cont_id, "id22", obj_prop_id22, 0, comm);
     if (obj_id22 == 0) {
         LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj_id22");
         exit(-1);

examples/vpicio_batch.c

@@ -149,7 +149,7 @@ main(int argc, char **argv)
         return 1;
     }
     // create a container
-    cont_id = PDCcont_create_col("c1", cont_prop);
+    cont_id = PDCcont_create_coll("c1", cont_prop, MPI_COMM_WORLD);
     if (cont_id <= 0) {
         LOG_ERROR("Failed to create container");
         return 1;
@@ -250,49 +250,49 @@ main(int argc, char **argv)
 
     for (i = 0; i < timestamps; ++i) {
         sprintf(obj_name, "obj-var-xx %" PRIu64 "", i);
-        obj_xx[i] = PDCobj_create_mpi(cont_id, obj_name, obj_prop_xx, 0, comm);
+        obj_xx[i] = PDCobj_create_coll(cont_id, obj_name, obj_prop_xx, 0, comm);
         if (obj_xx[i] == 0) {
             LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-xx");
             exit(-1);
         }
         sprintf(obj_name, "obj-var-yy %" PRIu64 "", i);
-        obj_yy[i] = PDCobj_create_mpi(cont_id, obj_name, obj_prop_yy, 0, comm);
+        obj_yy[i] = PDCobj_create_coll(cont_id, obj_name, obj_prop_yy, 0, comm);
         if (obj_yy[i] == 0) {
             LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-yy");
             exit(-1);
         }
         sprintf(obj_name, "obj-var-zz %" PRIu64 "", i);
-        obj_zz[i] = PDCobj_create_mpi(cont_id, obj_name, obj_prop_zz, 0, comm);
+        obj_zz[i] = PDCobj_create_coll(cont_id, obj_name, obj_prop_zz, 0, comm);
         if (obj_zz[i] == 0) {
             LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-zz");
             exit(-1);
         }
         sprintf(obj_name, "obj-var-pxx %" PRIu64 "", i);
-        obj_pxx[i] = PDCobj_create_mpi(cont_id, obj_name, obj_prop_pxx, 0, comm);
+        obj_pxx[i] = PDCobj_create_coll(cont_id, obj_name, obj_prop_pxx, 0, comm);
         if (obj_pxx[i] == 0) {
             LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-pxx");
             exit(-1);
         }
         sprintf(obj_name, "obj-var-pyy %" PRIu64 "", i);
-        obj_pyy[i] = PDCobj_create_mpi(cont_id, obj_name, obj_prop_pyy, 0, comm);
+        obj_pyy[i] = PDCobj_create_coll(cont_id, obj_name, obj_prop_pyy, 0, comm);
         if (obj_pyy[i] == 0) {
             LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-pyy");
             exit(-1);
         }
         sprintf(obj_name, "obj-var-pzz %" PRIu64 "", i);
-        obj_pzz[i] = PDCobj_create_mpi(cont_id, obj_name, obj_prop_pzz, 0, comm);
+        obj_pzz[i] = PDCobj_create_coll(cont_id, obj_name, obj_prop_pzz, 0, comm);
         if (obj_pzz[i] == 0) {
             LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj-var-pzz");
             exit(-1);
         }
         sprintf(obj_name, "id11 %" PRIu64 "", i);
-        obj_id11[i] = PDCobj_create_mpi(cont_id, obj_name, obj_prop_id11, 0, comm);
+        obj_id11[i] = PDCobj_create_coll(cont_id, obj_name, obj_prop_id11, 0, comm);
         if (obj_id11[i] == 0) {
             LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj_id11");
             exit(-1);
         }
         sprintf(obj_name, "id22 %" PRIu64 "", i);
-        obj_id22[i] = PDCobj_create_mpi(cont_id, obj_name, obj_prop_id22, 0, comm);
+        obj_id22[i] = PDCobj_create_coll(cont_id, obj_name, obj_prop_id22, 0, comm);
         if (obj_id22[i] == 0) {
             LOG_ERROR("Error getting an object id of %s from server, exit...\n", "obj_id22");
             exit(-1);